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

> Guida passo passo: registra un prelievo di sangue nell'API di Aniva e invia il campione alla pipeline degli ordini di laboratorio.

Usa questa guida per confermare che un prelievo di sangue è stato effettuato. La conferma registra i codici di laboratorio (codici a barre delle provette) del kit fisico e avvia la pipeline dell'ordine di laboratorio; l'avanzamento dei risultati si legge poi da [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md).

> [!WARNING]
>
> La conferma è **irreversibile**. Una volta confermato un prelievo di sangue, non puoi più
> modificare l'appuntamento, nemmeno per aggiungere pannelli. Assicurati che tutti i pannelli siano
> associati e tutti i dettagli siano corretti prima di procedere.

**1. Assicurati che i pannelli siano aggiunti**

Prima di confermare, verifica che tutti i pannelli di esami necessari siano stati aggiunti all'appuntamento. Non puoi aggiungere pannelli dopo la conferma.

Consulta la guida [Prenota un appuntamento](https://docs.anivahealth.com/it/guides/schedule-appointment.md) per le istruzioni su come associare i pannelli.

Conferma quanto segue prima di continuare:

* Tutti i pannelli richiesti sono associati all'appuntamento.
* `profile_id` e `location_id` nell'appuntamento sono corretti.
* Il paziente ha completato il prelievo di sangue e il codice a barre di ogni provetta è a portata di mano.

**2. Conferma il prelievo di sangue**

Invia una richiesta `POST` a `/api/v1/appointments/{id}/confirm` con i codici di laboratorio del kit fisico per il prelievo di sangue. Un prelievo venoso ha un unico codice stampato su ogni provetta: invialo come `lab_code`. Un prelievo in farmacia ha un codice per ogni microprovetta: inviali come `lab_codes`, una voce per codice con i `panel_ids` contenuti nella sua microprovetta (presi da `panels` dell'appuntamento); ogni codice diventa una richiesta di laboratorio a sé stante. I singoli biomarcatori in farmacia occupano prima lo spazio libero delle microprovette dei pannelli. Invia una voce senza `panel_ids` per ogni microprovetta di cui hanno bisogno a parte.

> [!WARNING]
>
> Ogni codice deve essere la stringa numerica stampata sulla provetta fisica consegnata al paziente. Non sostituirlo con un altro identificativo: un codice errato farà fallire l'ordine di laboratorio. Ogni codice viene validato prima di scrivere qualsiasi dato; se uno viene rifiutato, non viene registrato nulla.

```bash cURL (venous draw, one code) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_code": "7642001234"
  }'
```

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

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      lab_codes: [
        { lab_code: '7642001234', panel_ids: ['f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d'] },
        { lab_code: '7642001235', panel_ids: ['0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d'] },
      ],
    }),
  }
);

const result = await response.json();
```

Una richiesta riuscita restituisce `200 OK`:

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

**3. Verifica lo stato dell'appuntamento**

Dopo la conferma, recupera l'appuntamento per verificare che il suo stato sia passato a `blood_drawn`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12 \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  }
);

const appointment = await response.json();
console.log(appointment.status); // "blood_drawn"
```

Quando l'appuntamento mostra `status: "blood_drawn"`, la pipeline dell'ordine di laboratorio è stata avviata. Da questo momento lo stato dell'appuntamento resta `blood_drawn`; l'avanzamento più dettagliato delle fasi successive è esposto tramite endpoint dedicati: segui ogni voce dell'array inline `shipments` su [Ottieni spedizione](https://docs.anivahealth.com/it/api/shipments/get-shipment.md) per gli eventi del corriere in transito / consegnato e usa [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md) per il completamento dei risultati di laboratorio (`status: "in_progress"` → `"completed"`).

## Cosa succede dopo

Dopo la conferma, entra in azione la pipeline dell'ordine di laboratorio di Aniva:

1. Ogni codice di laboratorio viene abbinato alle rispettive provette fisiche in laboratorio: la richiesta di ogni pannello riporta il codice delle proprie provette.
2. I pannelli associati all'appuntamento determinano quali esami vengono eseguiti.
3. Quando i risultati sono pronti, vengono associati al profilo del paziente e compaiono in
   [Ottieni risultati](https://docs.anivahealth.com/it/api/appointments/get-results.md): il campo `status` di primo livello della
   risposta passa da `in_progress` a `completed` una volta che ogni invio è chiuso e uno ha
   restituito i risultati.

Non serve nessun'altra azione da parte della tua integrazione dopo la conferma.

## Gestione degli errori

| Stato | Causa | Risoluzione |
| - | - | - |
| `400 Bad Request` | Manca sia `lab_code` sia `lab_codes` o sono presenti entrambi, un codice non è numerico oppure un codice o un pannello è ripetuto. | Invia esattamente uno dei due, con i codici numerici esatti delle provette fisiche. |
| `409 Conflict` | Un codice non può essere usato (già assegnato, non registrato, appartiene a un kit domiciliare, clinica errata), un pannello non ha codice o l'appuntamento non è confermabile. | Leggi `reason` e `lab_code`; scansiona un'altra provetta o controlla lo stato dell'appuntamento. |
| `403 Forbidden` | La tua chiave API non ha accesso a questa operazione. | Contatta Aniva per confermare i permessi della tua chiave API. |
| `404 Not Found` | L'ID dell'appuntamento non esiste o non appartiene al tuo account. | Verifica che l'ID dell'appuntamento sia corretto. |


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