> ## 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.

# Afegeix panells

> Afegeix panells d'anàlisi de sang a una cita

Afegeix un o més panells d'anàlisi de sang a una cita existent. Pots cridar aquest punt final diverses vegades per completar la selecció de panells abans de confirmar l'extracció de sang.

Requereix l'abast `appointments_schedule`.

> [!WARNING]
>
> No es poden afegir panells després de cridar [Confirma l'extracció de sang](https://docs.anivahealth.com/ca/api/appointments/confirm-blood-draw.md).
> Intentar afegir panells a una cita confirmada retorna `409 Conflict`.

En una extracció capil·lar (`draw_method: capillary`), l'extracció s'envasa en microtubs. Els panells van primer, per
ordre de reserva. Després, els biomarcadors individuals omplen l'espai lliure dels microtubs dels panells. Quan
necessiten més espai, obren microtubs nous. Els repartim de manera uniforme. Cada microtub admet com a màxim
150 µl de biomarcadors individuals. Si el conjunt resultant de panells incompleix aquesta regla, la crida retorna `400` amb
un missatge `error` i no s'afegeix cap panell.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la cita a la qual vols afegir panells.

### Paràmetres del cos

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

Matriu d'UUID de panells per afegir a la cita. Ha de contenir almenys un element.

## Resposta

Si té èxit, l'API retorna `200 OK` per confirmar que els panells s'han afegit.

**success** `boolean`

`true` quan els panells s'han afegit correctament a la cita.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — p. ex., `panel_ids` és buit o conté un UUID no vàlid — o, en una extracció capil·lar, els biomarcadors individuals ja no caben als seus microtubs. |
| `403` | Prohibit — la teva clau API no té accés a aquesta operació. |
| `404` | No s'ha trobat la cita o un o més panells. |
| `409` | Conflicte — els panells no es poden afegir un cop confirmada l'extracció de sang, o un panell és un kit de prova a casa (`error_name: "home_kit_appointment_mismatch_error"`). Demana un kit de prova a casa com a [comanda de kit de prova a casa](https://docs.anivahealth.com/ca/api/home-kit-orders/create-home-kit.md). |
| `500` | Error intern del servidor. |

### Panell de kit de prova a casa

Un kit de prova a casa s'envia al pacient i l'extracció no es fa en una cita. Si un panell de `panel_ids` és
un kit de prova a casa, la crida retorna `409` i no afegeix cap panell. El cos té aquests camps:

**error** `string`

Motiu llegible per humans.

**error\_name** `string`

Sempre `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

La cita a la qual no s'ha afegit el panell.

**panel\_id** `string`

El panell de kit de prova a casa.

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

El proveïdor del kit de prova a casa del panell, o `null` si es desconeix.

```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.