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

# Bloedafname bevestigen

> Stappenplan: registreer een bloedafname in de Aniva API en stuur het monster naar de orderpipeline van het lab.

Gebruik deze handleiding om te bevestigen dat een bloedafname heeft plaatsgevonden. De bevestiging legt de labcodes (barcodes op de buisjes) van de fysieke kit vast en start de laborder-pipeline; de voortgang van de resultaten lees je vervolgens uit via [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md).

> [!WARNING]
>
> Bevestigen is **onomkeerbaar**. Zodra je een bloedafname hebt bevestigd, kunnen er geen wijzigingen meer —
> inclusief het toevoegen van panels — aan de afspraak worden aangebracht. Zorg ervoor dat alle panels zijn gekoppeld en
> alle gegevens kloppen voordat je verdergaat.

**1. Controleren of panels zijn toegevoegd**

Controleer voordat je bevestigt of alle benodigde testpanels aan de afspraak zijn toegevoegd. Na bevestiging kun je geen panels meer toevoegen.

Bekijk de handleiding [Een afspraak plannen](https://docs.anivahealth.com/nl/guides/schedule-appointment.md) voor instructies over het koppelen van panels.

Controleer het volgende voordat je verdergaat:

* Alle vereiste panels zijn gekoppeld aan de afspraak.
* De `profile_id` en `location_id` bij de afspraak kloppen.
* De patiënt heeft de bloedafname afgerond en de barcode van elk buisje ligt klaar.

**2. Bloedafname bevestigen**

Stuur een `POST`-verzoek naar `/api/v1/appointments/{id}/confirm` met de labcodes van de fysieke bloedafnamekit. Een veneuze bloedafname heeft één code die op elk buisje staat — stuur deze als `lab_code`. Een bloedafname in de apotheek heeft één code per microtainer — stuur deze als `lab_codes`, één item per code met de `panel_ids` die de microtainer bevat (uit `panels` van de afspraak); elke code wordt een eigen laboratoriumaanvraag. Losse biomarkers in een apotheek vullen eerst de vrije ruimte van de panel-microtainers. Stuur één item zonder `panel_ids` voor elke microtainer die ze apart nodig hebben.

> [!WARNING]
>
> Elke code moet de cijferreeks zijn die op het fysieke buisje staat dat aan de patiënt is gegeven. Gebruik geen andere identificatiecode — door een onjuiste code mislukt de laborder. Elke code wordt gevalideerd voordat er iets wordt weggeschreven; als er één wordt afgewezen, wordt er niets vastgelegd.

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

Een geslaagd verzoek geeft `200 OK` terug:

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

**3. Afspraakstatus controleren**

Haal na bevestiging de afspraak op om te controleren of de status is gewijzigd naar `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"
```

Zodra de afspraak `status: "blood_drawn"` toont, is de laborder-pipeline gestart. De afspraakstatus zelf blijft vanaf nu `blood_drawn`; meer gedetailleerde voortgang verderop in het proces is beschikbaar via specifieke endpoints: volg elk item in de inline `shipments`-array naar [Zending ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md) voor koerierevents over onderweg / bezorgd, en gebruik [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md) voor de voltooiing van de labresultaten (`status: "in_progress"` → `"completed"`).

## Wat er daarna gebeurt

Na bevestiging neemt de laborder-pipeline van Aniva het over:

1. Elke labcode wordt in het laboratorium gekoppeld aan de fysieke buisjes — de aanvraag van elk panel draagt de code van de eigen buisjes.
2. De panels die aan de afspraak zijn gekoppeld, bepalen welke tests worden uitgevoerd.
3. Zodra resultaten klaar zijn, worden ze gekoppeld aan het patiëntprofiel en verschijnen ze in
   [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md) — het top-level `status`-veld in het antwoord verandert
   van `in_progress` naar `completed` zodra elke inzending is afgesloten en één ervan heeft gerapporteerd.

Na bevestiging is er geen verdere actie meer nodig vanuit je integratie.

## Foutafhandeling

| Status | Oorzaak | Oplossing |
| - | - | - |
| `400 Bad Request` | Geen of beide van `lab_code` / `lab_codes` opgegeven, een code is niet-numeriek, of een code of panel komt dubbel voor. | Stuur precies één van beide, met de exacte numerieke codes van de fysieke buisjes. |
| `409 Conflict` | Een code kan niet worden gebruikt (al toegewezen, niet geregistreerd, hoort bij een thuistestkit, verkeerde kliniek), een panel heeft geen code, of de afspraak kan niet worden bevestigd. | Lees `reason` en `lab_code`; scan een ander buisje of controleer de status van de afspraak. |
| `403 Forbidden` | Je API-sleutel heeft geen toegang tot deze bewerking. | Neem contact op met Aniva om de rechten van je API-sleutel te controleren. |
| `404 Not Found` | De afspraak-ID bestaat niet of hoort niet bij je account. | Controleer of de afspraak-ID klopt. |


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