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

> Leg vast dat er bloed is afgenomen en start de pipeline voor laborders

Leg vast dat een bloedafname is voltooid en start de pipeline voor laborders. Stuur de labcodes (barcodes op de buisjes) van de bloedafnameset mee om de fysieke monsters aan de afspraak te koppelen.

Een bloedafname gebruikt codes op een van twee manieren:

* **Eén code voor de hele bloedafname** — een veneuze bloedafname, waarbij dezelfde barcode op elk buisje staat gedrukt. Stuur deze als `lab_code`.
* **Eén code per microtainer** — een capillaire bloedafname, waarbij elke microtainer een eigen barcode heeft. Stuur ze als `lab_codes`, één item per code met de `panel_ids` die de microtainer bevat. Elke code wordt een eigen laboratoriumaanvraag — de barcode op het buisje is het ordernummer van het laboratorium. Een item zonder `panel_ids` is een vangnet voor elk panel dat niet elders is genoemd. Een veneuze bloedafname heeft er hoogstens één.

Stuur precies een van de twee. Elk gekoppeld panel moet onder precies één code vallen (een eigen item of het vangnet). Bij een veneuze bloedafname hebben à-la-carte biomarkers het vangnet nodig. Vermeld bij een capillaire bloedafname elk panel bij de code van zijn microtainer. À-la-carte biomarkers vullen de vrije ruimte van de panelmicrotainers en openen alleen nieuwe microtainers wanneer dat nodig is. We verdelen ze gelijkmatig. Elke microtainer bevat er maximaal 150 µl van. Stuur één item zonder `panel_ids` voor elke microtainer die ze zelf nodig hebben, en niet meer. Een code die zonder panel en zonder biomarker overblijft, wordt geweigerd met `409` en `reason: "panel_coverage"`. Elke code wordt gevalideerd voordat er iets wordt weggeschreven; als een code niet kan worden gebruikt of een panel ongedekt blijft, wordt er niets vastgelegd en vermeldt de response het probleem.

Vereist de scope `appointments_schedule`, `appointments_manage` of `appointments_operate`.

> [!WARNING]
>
> Deze actie is onomkeerbaar. Zodra je de bloedafname bevestigt, wordt de afspraak vergrendeld —
> verdere wijzigingen, waaronder het toevoegen van panels, zijn niet meer mogelijk.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de te bevestigen afspraak.

### Bodyparameters

**lab\_code** `string`

Numerieke labcode gedrukt op de bloedafnameset, wanneer één code alle buisjes dekt. Kan niet
samen met `lab_codes` worden gebruikt.

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

Alle labcodes van de bloedafname, in scanvolgorde (minstens één item). Kan niet samen met `lab_code` worden gebruikt. Een
code mag maar één keer voorkomen; een panel mag slechts bij één item worden genoemd.

**labcode-item**

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

Numerieke labcode gedrukt op de buisjes van deze panels.

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

De gekoppelde panels waarvan de buisjes deze code dragen — `panel_id`-waarden uit de
`panels` van de afspraak. Laat weg of stuur `[]` voor het vangnet dat elk niet elders genoemd panel plus
de à-la-carte biomarkers omvat. Een veneuze bloedafname heeft hoogstens één vangnet. Bij een capillaire bloedafname
bevat een vangnet alleen à-la-carte biomarkers, en stuur je er één per microtainer die ze nodig hebben.

## Respons

Bij succes geeft de API `200 OK` terug als bevestiging dat de pipeline voor laborders is gestart.

**success** `boolean`

`true` wanneer de bloedafname is geregistreerd en de pipeline voor de labopdracht is gestart.

**warning** `string`

Alleen aanwezig wanneer de bloedafname is geregistreerd op een andere dag dan de afspraakdag.
Gewone sleutels kunnen dit niet — die krijgen een `409` met `reason: "appointment_not_today"`.
Verzet de afspraak naar de dag van de bloedafname en bevestig daarna.

De geregistreerde codes worden teruggegeven als `lab_codes` bij [Afspraak ophalen](https://docs.anivahealth.com/nl/api/appointments/get-appointment.md), en elk resultaat en document bij [Resultaten ophalen](https://docs.anivahealth.com/nl/api/appointments/get-results.md) bevat de `lab_code` waaronder het is opgeslagen.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — `lab_code` en `lab_codes` zijn geen van beide of allebei opgegeven, een code is niet numeriek, of een code of panel komt dubbel voor. |
| `403` | Verboden — je API-sleutel heeft geen toegang tot deze bewerking. |
| `404` | Afspraak niet gevonden. |
| `409` | Een code kan niet worden gebruikt (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), een panel blijft zonder code, een `panel_id` is niet gekoppeld, een veneuze bloedafname heeft twee items zonder `panel_ids`, een capillaire bloedafname heeft meer items dan microtainers of meer items zonder `panel_ids` dan microtainers met alleen markers, of een capillaire code komt niet overeen met de bijbehorende microtainers (allemaal `panel_coverage`), een code die vóór een reset is geregistreerd noemt nu andere panels (`remapped`) of moet bij deze bloedafname blijven omdat het lab de opdracht al kan hebben (`sent_to_lab`, `order_in_flight`), een code noemt een panel dat niet voor de afspraak is gepland (`unknown_panel`), of de afspraak kan niet worden bevestigd (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` geeft de code aan wanneer een specifieke code de oorzaak is. |
| `500` | Interne serverfout. |

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