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

# Conferma prelievo di sangue

> Registra che il prelievo di sangue è stato effettuato e avvia la pipeline dell'ordine di laboratorio

Registra il completamento di un prelievo di sangue e avvia la pipeline degli ordini di laboratorio. Invia i codici di laboratorio (codici a barre delle provette) del kit di prelievo di sangue per collegare i campioni fisici all'appuntamento.

Un prelievo di sangue utilizza i propri codici in uno di questi due modi:

* **Un solo codice per l'intero prelievo** — un prelievo venoso, in cui lo stesso codice a barre è stampato su ogni provetta. Invialo come `lab_code`.
* **Un codice per microprovetta** — un prelievo capillare, in cui ogni microprovetta ha il proprio codice a barre. Inviali come `lab_codes`, una voce per codice con i `panel_ids` contenuti nella relativa microprovetta. Ogni codice diventa una richiesta di laboratorio separata — il codice a barre sulla provetta è il numero d'ordine del laboratorio. Una voce senza `panel_ids` funge da voce generica per tutti i pannelli non indicati altrove. Un prelievo venoso ne ha al massimo una.

Invia esattamente uno dei due. Ogni pannello collegato deve finire sotto un solo codice (la propria voce o la voce generica). In un prelievo venoso, i biomarcatori singoli richiedono la voce generica. In un prelievo capillare, indica ogni pannello sul codice della sua microprovetta. I biomarcatori singoli occupano lo spazio libero delle microprovette dei pannelli e richiedono nuove microprovette solo quando serve. Li distribuiamo in modo uniforme. Ogni microprovetta ne contiene al massimo 150 µl. Invia una voce senza `panel_ids` per ogni microprovetta dedicata che richiedono, e non di più. Un codice che resta senza alcun pannello e senza alcun biomarcatore viene rifiutato con `409` e `reason: "panel_coverage"`. Ogni codice viene validato prima di scrivere qualsiasi dato; se un codice non può essere utilizzato o un pannello rimane scoperto, non viene registrato nulla e la risposta indica il problema.

Richiede lo scope `appointments_schedule`, `appointments_manage` o `appointments_operate`.

> [!WARNING]
>
> Questa azione è irreversibile. Una volta confermato il prelievo di sangue, l'appuntamento viene bloccato — non
> sono più possibili modifiche, inclusa l'aggiunta di pannelli.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'appuntamento da confermare.

### Parametri del body

**lab\_code** `string`

Codice di laboratorio numerico stampato sul kit di prelievo di sangue, quando un solo codice copre tutte le provette. Reciprocamente
esclusivo con `lab_codes`.

**lab\_codes** `object[]`

Tutti i codici di laboratorio del prelievo di sangue, in ordine di scansione (almeno una voce). Reciprocamente esclusivo con `lab_code`. Un
codice può comparire una sola volta; un pannello può essere indicato in una sola voce.

**voce codice di laboratorio**

**lab\_code** `string` *required*

Codice di laboratorio numerico stampato sulle provette di questi pannelli.

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

I pannelli collegati le cui provette riportano questo codice — valori `panel_id` dal campo
`panels` dell'appuntamento. Ometti o invia `[]` per la voce generica che copre tutti i pannelli non indicati altrove più
i biomarcatori singoli. Un prelievo venoso ha al massimo una voce generica. In un prelievo capillare, una voce generica
contiene solo biomarcatori singoli e ne invii una per ogni microprovetta necessaria.

## Risposta

In caso di successo, l'API restituisce `200 OK` a conferma che la pipeline degli ordini di laboratorio è stata avviata.

**success** `boolean`

`true` quando il prelievo di sangue è stato registrato e la pipeline dell'ordine di laboratorio è stata avviata.

**warning** `string`

Presente solo quando il prelievo è stato registrato in un giorno diverso da quello dell'appuntamento. Le chiavi ordinarie
non possono farlo — ricevono un `409` con `reason: "appointment_not_today"`. Riprogramma
l'appuntamento al giorno del prelievo, poi conferma.

I codici registrati vengono restituiti come `lab_codes` in [Ottieni appuntamento](https://docs.anivahealth.com/it/api/appointments/get-appointment.md), e ogni risultato e documento in [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md) riporta il `lab_code` con cui è stato archiviato.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — né `lab_code` né `lab_codes` (oppure entrambi) sono stati forniti, un codice non è numerico, oppure un codice o un pannello è ripetuto. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione. |
| `404` | Appuntamento non trovato. |
| `409` | Un codice non può essere usato (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), un pannello resta senza codice, un `panel_id` non è associato, un prelievo venoso ha due voci senza `panel_ids`, un prelievo capillare ha più voci che microprovette o più voci senza `panel_ids` rispetto alle microprovette solo per marcatori, oppure un codice capillare non corrisponde alle sue microprovette (tutti `panel_coverage`), un codice registrato prima di un reset ora indica altri pannelli (`remapped`) o deve restare su questo prelievo perché il laboratorio può avere il relativo ordine (`sent_to_lab`, `order_in_flight`), un codice indica un pannello non previsto nell'appuntamento (`unknown_panel`), oppure l'appuntamento non è confermabile (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` indica il codice responsabile, quando presente. |
| `500` | Errore interno del server. |

```bash cURL (one code, every tube) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_code": "7642001234"
  }'
```

```bash cURL (one code per panel) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_codes": [
      { "lab_code": "7642001234", "panel_ids": ["f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"] },
      { "lab_code": "7642001235", "panel_ids": ["0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d"] }
    ]
  }'
```

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

```json 400 theme={null}
{
  "error": "lab_codes: Provide exactly one of `lab_code` or `lab_codes`"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```

```json 409 theme={null}
{
  "error": "This barcode has already been assigned to another patient. Please use a different tube.",
  "reason": "already_assigned",
  "lab_code": "7642001235"
}
```

```json 409 (capillary empty code) theme={null}
{
  "error": "Barcode 7642001236 carries no panel and no biomarker.",
  "reason": "panel_coverage",
  "lab_code": null
}
```

```json 409 (cancelled) theme={null}
{
  "error": "This appointment was cancelled, so a blood draw can’t be recorded for it. Reactivate the appointment first if this is a mistake.",
  "reason": "appointment_cancelled",
  "lab_code": "7642001234"
}
```

```json 409 (wrong day) theme={null}
{
  "error": "Recording a blood draw is only available on the appointment day (Oct 13, 2026). Reschedule the appointment to today, then confirm.",
  "reason": "appointment_not_today",
  "lab_code": null
}
```


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