> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Añadir paneles

> Añadir paneles de análisis de sangre a una cita

Añade uno o más paneles de análisis de sangre a una cita existente. Puedes llamar a este endpoint varias veces para completar la selección de paneles antes de confirmar la extracción de sangre.

Requiere el scope `appointments_schedule`.

> [!WARNING]
>
> No se pueden añadir paneles después de llamar a [Confirmar extracción de sangre](https://docs.anivahealth.com/es/api/appointments/confirm-blood-draw.md).
> Intentar añadir paneles a una cita confirmada devuelve `409 Conflict`.

En una extracción capilar (`draw_method: capillary`), la extracción se distribuye en microtainers. Los
paneles van primero, por orden de reserva. Después, los biomarcadores individuales llenan el espacio
libre de los microtainers de los paneles. Cuando necesitan más espacio, abren nuevos microtainers. Los
repartimos de forma uniforme. Cada microtainer admite como máximo 150 µl de biomarcadores individuales.
Si el conjunto resultante de paneles incumple esta regla, la llamada devuelve `400` con un mensaje
`error` y no se añade ningún panel.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita a la que se añadirán los paneles.

### Parámetros del cuerpo

**panel\_ids** `string[]` *required*

Array de UUID de paneles para añadir a la cita. Debe contener al menos un elemento.

## Respuesta

Si la operación tiene éxito, la API devuelve `200 OK` confirmando que se han añadido los paneles.

**success** `boolean`

`true` cuando los paneles se han añadido correctamente a la cita.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación — p. ej., `panel_ids` está vacío o contiene un UUID no válido — o, en una extracción capilar, los biomarcadores individuales ya no caben en sus microtainers. |
| `403` | Prohibido — tu clave de API no tiene acceso a esta operación. |
| `404` | No se ha encontrado la cita o uno o más paneles. |
| `409` | Conflicto — no se pueden añadir paneles después de confirmar la extracción de sangre, o un panel es un kit de prueba en casa (`error_name: "home_kit_appointment_mismatch_error"`). Pide un kit de prueba en casa como un [pedido de kit de prueba en casa](https://docs.anivahealth.com/es/api/home-kit-orders/create-home-kit.md). |
| `500` | Error interno del servidor. |

### Panel de kit de prueba en casa

Un kit de prueba en casa se envía al paciente y no requiere extracción en una cita. Si un panel en
`panel_ids` es un kit de prueba en casa, la llamada devuelve `409` y no añade ningún panel. El cuerpo
contiene estos campos:

**error** `string`

Motivo legible por humanos.

**error\_name** `string`

Siempre `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

La cita a la que no se añadió el panel.

**panel\_id** `string`

El panel de kit de prueba en casa.

**home\_kit\_provider** `string | null`

El proveedor del kit de prueba en casa del panel, o `null` si no se conoce.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.