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

# Bekreft blodprøvetaking

> Registrer at blodprøven er tatt, og utløs labbestillingsflyten

Registrer at en blodprøvetaking er fullført og start labbestillingsflyten. Send inn labkodene (strekkodene på prøverørene) fra prøvetakingssettet for å koble de fysiske prøvene til timen.

En blodprøvetaking har kodene sine på én av to måter:

* **Én kode for hele blodprøvetakingen** – en venøs blodprøvetaking, der den samme strekkoden er trykket på hvert prøverør. Send den som `lab_code`.
* **Én kode per mikrorør** – en kapillær blodprøvetaking, der hvert mikrorør har sin egen strekkode. Send dem som `lab_codes`, med én oppføring per kode og `panel_ids` som mikrorøret inneholder. Hver kode blir en egen rekvisisjon til laboratoriet – strekkoden på prøverøret er laboratoriets ordrenummer. En oppføring uten `panel_ids` er en samleoppføring for alle paneler som ikke er nevnt andre steder. En venøs blodprøvetaking har høyst én.

Send nøyaktig én av de to. Hvert tilknyttet panel må havne under nøyaktig én kode (sin egen oppføring eller samleoppføringen). Ved en venøs blodprøvetaking trenger enkeltbiomarkører samleoppføringen. Ved en kapillær blodprøvetaking oppgir du hvert panel på koden til det tilhørende mikrorøret. Enkeltbiomarkører fyller den ledige plassen i panelmikrorørene og tar i bruk nye mikrorør bare når det trengs. Vi fordeler dem jevnt. Hvert mikrorør rommer maksimalt 150 µl av dem. Send én oppføring uten `panel_ids` for hvert mikrorør de trenger for seg selv, og ikke flere. En kode som ender opp uten noe panel og uten noen biomarkør, avvises med `409` og `reason: "panel_coverage"`. Hver kode valideres før noe skrives; hvis en kode ikke kan brukes eller et panel ikke er dekket, registreres ingenting og svaret oppgir problemet.

Krever tilgangsomfanget `appointments_schedule`, `appointments_manage` eller `appointments_operate`.

> [!WARNING]
>
> Denne handlingen kan ikke angres. Når du har bekreftet blodprøvetakingen, er timen låst – ingen
> flere endringer er mulige, heller ikke å legge til paneler.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for timen som skal bekreftes.

### Body-parametere

**lab\_code** `string`

Numerisk labkode trykket på prøvetakingssettet når én kode dekker alle prøverør. Kan ikke
brukes sammen med `lab_codes`.

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

Alle labkodene fra blodprøvetakingen, i skannerekkefølge (minst én oppføring). Kan ikke brukes sammen med `lab_code`. En
kode kan bare forekomme én gang; et panel kan bare oppgis på én oppføring.

**labkodeoppføring**

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

Numerisk labkode trykket på prøverørene for disse panelene.

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

De tilknyttede panelene der prøverørene har denne koden – `panel_id`-verdier fra timens
`panels`. Utelat eller send `[]` for samleoppføringen som dekker alle paneler som ikke er nevnt andre steder, pluss
enkeltbiomarkørene. En venøs blodprøvetaking har høyst én samleoppføring. Ved en kapillær blodprøvetaking
inneholder en samleoppføring bare enkeltbiomarkører, og du sender én per mikrorør de trenger.

## Respons

Når kallet lykkes, returnerer API-et `200 OK` som bekrefter at labbestillingsflyten er startet.

**success** `boolean`

`true` når blodprøvetakingen er registrert og bestillingsflyten til laboratoriet er utløst.

**warning** `string`

Bare med når blodprøvetakingen ble registrert på en annen dag enn timen. Vanlige nøkler
kan ikke gjøre dette — de får `409` med `reason: "appointment_not_today"`. Flytt
timen til dagen for blodprøvetakingen, og bekreft deretter.

De registrerte kodene returneres som `lab_codes` i [Hent time](https://docs.anivahealth.com/no/api/appointments/get-appointment.md), og hvert resultat og dokument i [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md) har med den `lab_code` det ble registrert under.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil — verken eller begge av `lab_code` og `lab_codes` er oppgitt, en kode er ikke numerisk, eller en kode eller et panel er gjentatt. |
| `403` | Ingen tilgang — API-nøkkelen din har ikke tilgang til denne operasjonen. |
| `404` | Timen ble ikke funnet. |
| `409` | En kode kan ikke brukes (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), et panel står uten kode, en `panel_id` er ikke knyttet til timen, en venøs blodprøvetaking har to oppføringer uten `panel_ids`, en kapillær blodprøvetaking har flere oppføringer enn mikrorør eller flere oppføringer uten `panel_ids` enn mikrorør kun for markører, eller en kapillærkode samsvarer ikke med mikrorørene sine (alle `panel_coverage`), en kode som ble registrert før en tilbakestilling oppgir nå andre paneler (`remapped`) eller må bli værende på denne blodprøvetakingen fordi laboratoriet kan ha bestillingen dens (`sent_to_lab`, `order_in_flight`), en kode oppgir et panel som ikke er planlagt for timen (`unknown_panel`), eller timen kan ikke bekreftes (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` angir koden der en kode er årsaken. |
| `500` | Intern serverfeil. |

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