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

> Guide étape par étape : enregistrer une prise de sang dans l'API Aniva et envoyer l'échantillon dans le flux de commande du laboratoire.

Utilise ce guide pour confirmer qu'une prise de sang a bien eu lieu. La confirmation enregistre les codes de laboratoire (codes-barres des tubes) du kit physique et déclenche le processus de commande au laboratoire ; l'avancement des résultats se lit ensuite dans [Obtenir les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md).

> [!WARNING]
>
> La confirmation est **irréversible**. Une fois que tu confirmes une prise de sang, aucune autre modification —
> y compris l'ajout de panels — ne peut être apportée au rendez-vous. Assure-toi que tous les panels sont associés et
> que tous les détails sont corrects avant de continuer.

**1. Vérifier que les panels sont ajoutés**

Avant de confirmer, vérifie que tous les panels d'analyse nécessaires ont été ajoutés au rendez-vous. Tu ne peux plus ajouter de panels après confirmation.

Consulte le guide [Planifier un rendez-vous](https://docs.anivahealth.com/fr/guides/schedule-appointment.md) pour savoir comment associer des panels.

Vérifie les points suivants avant de continuer :

* Tous les panels requis sont associés au rendez-vous.
* Les champs `profile_id` et `location_id` du rendez-vous sont corrects.
* Le patient a effectué la prise de sang et le code-barres de chaque tube est à portée de main.

**2. Confirmer la prise de sang**

Envoie une requête `POST` à `/api/v1/appointments/{id}/confirm` avec les codes de laboratoire du kit physique de prise de sang. Une prise de sang veineuse a un seul code imprimé sur chaque tube — envoie-le dans `lab_code`. Une prise de sang en pharmacie a un code par microtainer — envoie-les dans `lab_codes`, à raison d'une entrée par code avec les `panel_ids` que son microtainer contient (issus des `panels` du rendez-vous) ; chaque code devient sa propre demande d'analyse au laboratoire. Les biomarqueurs individuels en pharmacie remplissent d'abord l'espace libre des microtainers de panel. Envoie une entrée sans `panel_ids` pour chaque microtainer dont ils ont besoin à eux seuls.

> [!WARNING]
>
> Chaque code doit être la chaîne numérique imprimée sur le tube physique remis au patient. Ne le remplace pas par un autre identifiant — un code incorrect fera échouer la commande au laboratoire. Chaque code est validé avant toute écriture ; si l'un d'eux est rejeté, rien n'est enregistré.

```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();
```

Une requête réussie renvoie `200 OK` :

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

**3. Vérifier le statut du rendez-vous**

Après confirmation, récupère le rendez-vous pour vérifier que son statut est passé à `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"
```

Une fois que le rendez-vous affiche `status: "blood_drawn"`, le processus de commande au laboratoire est déclenché. Le statut du rendez-vous reste à `blood_drawn` à partir de ce moment ; le suivi plus fin en aval est exposé via des endpoints dédiés : suis chaque entrée du tableau `shipments` intégré dans [Obtenir une expédition](https://docs.anivahealth.com/fr/api/shipments/get-shipment.md) pour les événements en transit / livré du transporteur, et utilise [Obtenir les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md) pour la finalisation des résultats de laboratoire (`status: "in_progress"` → `"completed"`).

## Et ensuite

Après confirmation, le processus de commande au laboratoire d'Aniva prend le relais :

1. Chaque code de laboratoire est associé à ses tubes physiques au laboratoire — la demande de chaque panel porte le code figurant sur ses propres tubes.
2. Les panels associés au rendez-vous déterminent les analyses effectuées.
3. Lorsque les résultats sont prêts, ils sont associés au profil du patient et apparaissent dans
   [Obtenir les résultats](https://docs.anivahealth.com/fr/api/appointments/get-results.md) — le champ `status` de premier niveau de la réponse passe
   de `in_progress` à `completed` une fois que chaque demande est clôturée et qu'une a renvoyé des résultats.

Aucune autre action n'est requise de la part de ton intégration après confirmation.

## Gestion des erreurs

| Statut | Cause | Résolution |
| - | - | - |
| `400 Bad Request` | `lab_code` et `lab_codes` sont tous deux absents ou présents, un code n'est pas numérique, ou un code ou un panel est répété. | Envoie exactement l'un des deux, avec les codes numériques exacts des tubes physiques. |
| `409 Conflict` | Un code ne peut pas être utilisé (déjà attribué, non enregistré, appartient à un kit à domicile, mauvaise clinique), un panel n'a pas de code, ou le rendez-vous ne peut pas être confirmé. | Lis `reason` et `lab_code` ; scanne un autre tube ou vérifie le statut du rendez-vous. |
| `403 Forbidden` | Ta clé API n'a pas accès à cette opération. | Contacte Aniva pour confirmer les autorisations de ta clé API. |
| `404 Not Found` | L'ID du rendez-vous n'existe pas ou n'appartient pas à ton compte. | Vérifie que l'ID du rendez-vous est correct. |


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