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

# Bekræft blodprøvetagning

> Registrer, at blodprøven er taget, og udløs laboratorieordrens pipeline

Registrer, at en blodprøvetagning er gennemført, og start laboratorieordre-pipelinen. Indsend laboratoriekoderne (stregkoderne på prøveglassene) fra blodprøvetagningskittet for at knytte de fysiske prøver til tiden.

En blodprøvetagning har sine koder på en af to måder:

* **Én kode til hele blodprøvetagningen** — en venøs blodprøvetagning, hvor den samme stregkode er trykt på hvert prøveglas. Send den som `lab_code`.
* **Én kode pr. mikrorør** — en kapillær blodprøvetagning, hvor hvert mikrorør har sin egen stregkode. Send dem som `lab_codes`, én post pr. kode med de `panel_ids`, mikrorøret indeholder. Hver kode bliver sin egen laboratorierekvisition — stregkoden på prøveglasset er laboratoriets ordrenummer. En post uden `panel_ids` er en opsamlingspost for alle paneler, der ikke er nævnt andetsteds. En venøs blodprøvetagning har højst én.

Send præcis én af de to. Hvert tilknyttet panel skal ende under præcis én kode (sin egen post eller opsamlingsposten). Ved en venøs blodprøvetagning har à la carte-biomarkører brug for opsamlingsposten. Ved en kapillær blodprøvetagning angiver du hvert panel på koden for dets mikrorør. À la carte-biomarkører udfylder den ledige plads i panelmikrorørene og åbner kun nye mikrorør, når det er nødvendigt. Vi fordeler dem jævnt. Hvert mikrorør rummer højst 150 µl af dem. Send én post uden `panel_ids` for hvert mikrorør, de har brug for på egen hånd, og ikke flere. En kode, der ender uden panel og uden biomarkør, afvises med `409` og `reason: "panel_coverage"`. Hver kode valideres, før der skrives noget; hvis en kode ikke kan bruges, eller et panel ikke er dækket, registreres intet, og svaret angiver problemet.

Kræver scope `appointments_schedule`, `appointments_manage` eller `appointments_operate`.

> [!WARNING]
>
> Denne handling kan ikke fortrydes. Når du har bekræftet blodprøvetagningen, låses tiden — der
> kan ikke længere foretages ændringer, heller ikke tilføjelse af paneler.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unikt id (UUID) for den tid, der skal bekræftes.

### Body-parametre

**lab\_code** `string`

Numerisk laboratoriekode trykt på blodprøvetagningskittet, når én kode dækker alle prøveglas. Kan ikke bruges
sammen med `lab_codes`.

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

Alle laboratoriekoder fra blodprøvetagningen i scanningsrækkefølge (mindst én post). Kan ikke bruges sammen med `lab_code`. En
kode må kun forekomme én gang; et panel må kun nævnes i én post.

**Post for laboratoriekode**

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

Numerisk laboratoriekode trykt på prøveglassene for disse paneler.

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

De tilknyttede paneler, hvis prøveglas bærer denne kode — `panel_id`-værdier fra tidens
`panels`. Udelad eller send `[]` for opsamlingsposten, der dækker alle paneler, der ikke er nævnt andetsteds, samt
à la carte-biomarkørerne. En venøs blodprøvetagning har højst én opsamlingspost. Ved en kapillær blodprøvetagning
indeholder en opsamlingspost kun à la carte-biomarkører, og du sender én pr. mikrorør, de har brug for.

## Svar

Ved succes returnerer API'et `200 OK` som bekræftelse på, at laboratorieordre-pipelinen er startet.

**success** `boolean`

`true` når blodprøvetagningen er registreret, og laboratorieordrepipelinen er udløst.

**warning** `string`

Er kun med, når blodprøvetagningen blev registreret på en anden dag end dagen for tiden.
Almindelige nøgler kan ikke gøre dette — de får en `409` med `reason: "appointment_not_today"`.
Flyt tiden til dagen for blodprøvetagningen, og bekræft derefter.

De registrerede koder returneres som `lab_codes` på [Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md), og hvert resultat og dokument på [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) indeholder den `lab_code`, det blev registreret under.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — ingen af eller begge `lab_code` og `lab_codes` er angivet, en kode er ikke numerisk, eller en kode eller et panel gentages. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling. |
| `404` | Tiden blev ikke fundet. |
| `409` | En kode kan ikke bruges (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), et panel står uden en kode, et `panel_id` er ikke tilknyttet, en venøs blodprøvetagning har to poster uden `panel_ids`, en kapillær blodprøvetagning har flere poster end mikrotainere eller flere poster uden `panel_ids` end mikrotainere kun med markører, eller en kapillær kode matcher ikke sine mikrotainere (alle `panel_coverage`), en kode registreret før en nulstilling angiver nu andre paneler (`remapped`) eller skal blive på denne blodprøvetagning, fordi laboratoriet kan have dens ordre (`sent_to_lab`, `order_in_flight`), en kode angiver et panel, som ikke er planlagt på tiden (`unknown_panel`), eller tiden kan ikke bekræftes (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` angiver koden, når en kode er skyld i fejlen. |
| `500` | Intern serverfejl. |

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