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

> Trin-for-trin-guide: registrer en blodprøvetagning i Anivas API, og send prøven til laboratoriets ordrepipeline.

Brug denne guide til at bekræfte, at en blodprøvetagning har fundet sted. Bekræftelsen registrerer laboratoriekoderne (stregkoderne på rørene) fra det fysiske kit og starter ordreflowet til laboratoriet; status på resultaterne læses derefter fra [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md).

> [!WARNING]
>
> Bekræftelsen kan **ikke fortrydes**. Når du først har bekræftet en blodprøvetagning, kan der ikke laves flere ændringer –
> heller ikke tilføjelse af paneler – på tiden. Sørg for, at alle paneler er tilknyttet, og at
> alle oplysninger er korrekte, før du fortsætter.

**1. Sørg for, at paneler er tilføjet**

Før du bekræfter, skal du tjekke, at alle nødvendige testpaneler er tilføjet til tiden. Du kan ikke tilføje paneler efter bekræftelsen.

Se guiden [Book en tid](https://docs.anivahealth.com/da/guides/schedule-appointment.md) for vejledning i at tilknytte paneler.

Bekræft følgende, før du fortsætter:

* Alle nødvendige paneler er tilknyttet tiden.
* `profile_id` og `location_id` på tiden er korrekte.
* Patienten har gennemført blodprøvetagningen, og stregkoden på hvert rør er ved hånden.

**2. Bekræft blodprøvetagningen**

Send en `POST`-forespørgsel til `/api/v1/appointments/{id}/confirm` med laboratoriekoderne fra det fysiske blodprøvetagningskit. En venøs blodprøvetagning har én kode trykt på hvert rør – send den som `lab_code`. En blodprøvetagning på apotek har én kode pr. microtainer – send dem som `lab_codes`, én post pr. kode med de `panel_ids`, som microtaineren indeholder (fra tidens `panels`); hver kode bliver sin egen laboratorierekvisition. Enkelte biomarkører på et apotek fylder først den ledige plads i panel-microtainerne. Send én post uden `panel_ids` for hver microtainer, de selv har brug for.

> [!WARNING]
>
> Hver kode skal være den talstreng, der er trykt på det fysiske rør, som udleveres til patienten. Brug ikke en anden identifikator – en forkert kode får laboratorieordren til at fejle. Hver kode valideres, før noget gemmes; hvis én afvises, registreres intet.

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

En vellykket forespørgsel returnerer `200 OK`:

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

**3. Tjek tidens status**

Hent tiden efter bekræftelsen for at tjekke, at dens status er ændret til `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"
```

Når tiden viser `status: "blood_drawn"`, er ordreflowet til laboratoriet startet. Selve tidens status forbliver `blood_drawn` herfra; mere detaljeret fremdrift i det videre forløb vises via dedikerede endpoints: følg hver post i det indlejrede `shipments`-array til [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) for kurerhændelser (undervejs / leveret), og brug [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) for færdiggørelse af laboratorieresultater (`status: "in_progress"` → `"completed"`).

## Hvad sker der bagefter

Efter bekræftelsen tager Anivas ordreflow til laboratoriet over:

1. Hver laboratoriekode matches med sine fysiske rør på laboratoriet – hvert panels rekvisition bærer koden fra dets egne rør.
2. De paneler, der er tilknyttet tiden, afgør, hvilke tests der køres.
3. Når resultaterne er klar, knyttes de til patientprofilen og vises i
   [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) – svarets øverste `status`-felt skifter
   fra `in_progress` til `completed`, når alle indsendelser er lukket, og én har rapporteret.

Der kræves ingen yderligere handling fra din integration efter bekræftelsen.

## Fejlhåndtering

| Status | Årsag | Løsning |
| - | - | - |
| `400 Bad Request` | Ingen af eller begge `lab_code` / `lab_codes` er angivet, en kode er ikke-numerisk, eller en kode eller et panel gentages. | Send præcis én af de to med de nøjagtige numeriske koder fra de fysiske prøveglas. |
| `409 Conflict` | En kode kan ikke bruges (allerede tildelt, uregistreret, tilhører et hjemmetestkit, forkert klinik), et panel har ingen kode, eller tiden kan ikke bekræftes. | Læs `reason` og `lab_code`; scan et andet prøveglas, eller tjek tidens status. |
| `403 Forbidden` | Din API-nøgle har ikke adgang til denne handling. | Kontakt Aniva for at bekræfte tilladelserne for din API-nøgle. |
| `404 Not Found` | Tidens ID findes ikke eller tilhører ikke din konto. | Tjek, at tidens ID er korrekt. |


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