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

# Aggiungi pannelli

> Aggiungi pannelli di esami del sangue a un appuntamento

Aggiungi uno o più pannelli di esami del sangue a un appuntamento esistente. Puoi chiamare questo endpoint più volte per comporre la selezione di pannelli prima di confermare il prelievo di sangue.

Richiede lo scope `appointments_schedule`.

> [!WARNING]
>
> Non è possibile aggiungere pannelli dopo aver chiamato [Conferma prelievo di sangue](https://docs.anivahealth.com/it/api/appointments/confirm-blood-draw.md).
> Il tentativo di aggiungere pannelli a un appuntamento confermato restituisce `409 Conflict`.

In un prelievo capillare (`draw_method: capillary`), il prelievo viene suddiviso in microtainer. I pannelli vanno per primi, in
ordine di prenotazione. I biomarcatori singoli riempiono poi lo spazio libero dei microtainer dei pannelli. Quando
hanno bisogno di più spazio, aprono nuovi microtainer. Li distribuiamo in modo uniforme. Ogni microtainer contiene al massimo
150 µl di biomarcatori singoli. Se il set di pannelli risultante viola questa regola, la chiamata restituisce `400` con
un messaggio `error` e non viene aggiunto alcun pannello.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'appuntamento a cui aggiungere i pannelli.

### Parametri del body

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

Array di UUID dei pannelli da aggiungere all'appuntamento. Deve contenere almeno un elemento.

## Risposta

In caso di successo, l'API restituisce `200 OK` a conferma che i pannelli sono stati aggiunti.

**success** `boolean`

`true` quando i pannelli sono stati aggiunti correttamente all'appuntamento.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — ad es. `panel_ids` è vuoto o contiene un UUID non valido — oppure, in un prelievo capillare, i biomarcatori singoli non entrano più nei rispettivi microtainer. |
| `403` | Forbidden — la tua chiave API non ha accesso a questa operazione. |
| `404` | Appuntamento o uno o più pannelli non trovati. |
| `409` | Conflict — non è possibile aggiungere pannelli dopo la conferma del prelievo di sangue, oppure un pannello è un kit domiciliare (`error_name: "home_kit_appointment_mismatch_error"`). Ordina un kit domiciliare come [ordine di kit domiciliare](https://docs.anivahealth.com/it/api/home-kit-orders/create-home-kit.md). |
| `500` | Errore interno del server. |

### Pannello kit domiciliare

Un kit domiciliare viene inviato al paziente e non prevede un prelievo durante un appuntamento. Se un pannello in `panel_ids` è
un kit domiciliare, la chiamata restituisce `409` e non aggiunge alcun pannello. Il body contiene questi campi:

**error** `string`

Motivo in formato leggibile.

**error\_name** `string`

Sempre `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

L'appuntamento a cui il pannello non è stato aggiunto.

**panel\_id** `string`

Il pannello kit domiciliare.

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

Il fornitore del kit domiciliare del pannello, oppure `null` quando non è noto.

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