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

# Confirmer la prise de sang

> Enregistrer que la prise de sang a été effectuée et déclencher le pipeline de commande de laboratoire

Enregistre qu'une prise de sang a été effectuée et déclenche le flux de commande laboratoire. Envoie les codes laboratoire (codes-barres des tubes) du kit de prise de sang pour lier les échantillons physiques au rendez-vous.

Une prise de sang porte ses codes de deux manières possibles :

* **Un code pour toute la prise de sang** — une prise de sang veineuse, où le même code-barres est imprimé sur chaque tube. Envoie-le dans `lab_code`.
* **Un code par microtube** — une prise de sang capillaire, où chaque microtube possède son propre code-barres. Envoie-les dans `lab_codes`, à raison d'une entrée par code avec les `panel_ids` que contient son microtube. Chaque code devient sa propre demande de laboratoire — le code-barres sur le tube correspond au numéro de commande du laboratoire. Une entrée sans `panel_ids` sert d'entrée générique pour tous les panels non mentionnés ailleurs. Une prise de sang veineuse en comporte au maximum une.

Envoie exactement l'un des deux. Chaque panel rattaché doit se retrouver sous exactement un code (sa propre entrée ou l'entrée générique). Pour une prise de sang veineuse, les biomarqueurs à la carte nécessitent l'entrée générique. Pour une prise de sang capillaire, indique chaque panel sur le code de son microtube. Les biomarqueurs à la carte occupent l'espace libre des microtubes des panels et n'utilisent de nouveaux microtubes qu'en cas de besoin. Nous les répartissons équitablement. Chaque microtube en contient au maximum 150 µl. Envoie une entrée sans `panel_ids` pour chaque microtube qui leur est propre, et pas davantage. Un code qui se retrouve sans panel ni biomarqueur est refusé avec `409` et `reason: "panel_coverage"`. Chaque code est validé avant toute écriture ; si un code ne peut pas être utilisé ou qu'un panel n'est pas couvert, rien n'est enregistré et la réponse indique le problème.

Nécessite le scope `appointments_schedule`, `appointments_manage` ou `appointments_operate`.

> [!WARNING]
>
> Cette action est irréversible. Une fois que tu confirmes la prise de sang, le rendez-vous est verrouillé — aucune
> modification supplémentaire, y compris l'ajout de panels, n'est possible.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) du rendez-vous à confirmer.

### Paramètres du corps

**lab\_code** `string`

Code laboratoire numérique imprimé sur le kit de prise de sang, lorsqu'un seul code couvre tous les tubes. Mutuellement
exclusif avec `lab_codes`.

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

Tous les codes laboratoire de la prise de sang, dans l'ordre de scan (au moins une entrée). Mutuellement exclusif avec `lab_code`. Un
code ne peut apparaître qu'une seule fois ; un panel ne peut être mentionné que sur une seule entrée.

**Entrée de code laboratoire**

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

Code laboratoire numérique imprimé sur les tubes de ces panels.

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

Les panels rattachés dont les tubes portent ce code — valeurs `panel_id` issues du champ `panels`
du rendez-vous. Omets ce champ ou envoie `[]` pour l'entrée générique couvrant tous les panels non mentionnés ailleurs ainsi que
les biomarqueurs à la carte. Une prise de sang veineuse comporte au maximum une entrée générique. Lors d'une prise de sang capillaire, une entrée générique
ne contient que des biomarqueurs à la carte, et tu en envoies une par microtube nécessaire.

## Réponse

En cas de succès, l'API renvoie `200 OK` confirmant que le flux de commande laboratoire a été déclenché.

**success** `boolean`

`true` lorsque la prise de sang a été enregistrée et que le pipeline de commande laboratoire a été déclenché.

**warning** `string`

Présent uniquement lorsque la prise de sang a été enregistrée un autre jour que celui du
rendez-vous. Les clés ordinaires ne peuvent pas le faire — elles reçoivent un `409` avec
`reason: "appointment_not_today"`. Replanifie le rendez-vous au jour de la prise de sang, puis
confirme.

Les codes enregistrés sont renvoyés sous `lab_codes` dans [Récupérer un rendez-vous](https://docs.anivahealth.com/fr/api/appointments/get-appointment.md), et chaque résultat et document dans [Récupérer les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md) porte le `lab_code` sous lequel il a été classé.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Erreur de validation — aucun ou les deux paramètres `lab_code` et `lab_codes` sont fournis, un code n'est pas numérique, ou un code ou un panel est répété. |
| `403` | Interdit — ta clé API n'a pas accès à cette opération. |
| `404` | Rendez-vous introuvable. |
| `409` | Un code ne peut pas être utilisé (`reason` : `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), un panel reste sans code, un `panel_id` n'est pas associé, une prise de sang veineuse comporte deux entrées sans `panel_ids`, une prise de sang capillaire comporte plus d'entrées que de microtubes ou plus d'entrées sans `panel_ids` que de microtubes pour marqueurs uniquement, ou un code capillaire ne correspond pas à ses microtubes (tous avec `panel_coverage`), un code enregistré avant une réinitialisation désigne désormais d'autres panels (`remapped`) ou doit rester sur cette prise de sang car le laboratoire peut déjà détenir sa commande (`sent_to_lab`, `order_in_flight`), un code désigne un panel qui n'est pas prévu sur le rendez-vous (`unknown_panel`), ou le rendez-vous ne peut pas être confirmé (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` indique le code en cause lorsqu'un code pose problème. |
| `500` | Erreur interne du serveur. |

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