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

> Trinnvis veiledning: registrer en blodprøvetaking i Aniva-API-et og send prøven til bestillingsflyten for laboratoriet.

Bruk denne veiledningen til å bekrefte at en blodprøvetaking har funnet sted. Bekreftelsen registrerer labkodene (strekkodene på prøverørene) fra det fysiske settet og starter bestillingsflyten til laboratoriet; fremdriften for resultatene leses deretter fra [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md).

> [!WARNING]
>
> Bekreftelse kan **ikke angres**. Når du først har bekreftet en blodprøvetaking, kan ingen flere endringer –
> inkludert å legge til paneler – gjøres på timen. Sørg for at alle paneler er lagt til og at
> alle detaljer er riktige før du fortsetter.

**1. Sørg for at paneler er lagt til**

Før du bekrefter, må du kontrollere at alle nødvendige testpaneler er lagt til i timen. Du kan ikke legge til paneler etter bekreftelsen.

Se veiledningen [Bestill en time](https://docs.anivahealth.com/no/guides/schedule-appointment.md) for instruksjoner om hvordan du legger til paneler.

Bekreft følgende før du fortsetter:

* Alle nødvendige paneler er lagt til i timen.
* `profile_id` og `location_id` på timen er riktige.
* Pasienten har gjennomført blodprøvetakingen, og strekkoden til hvert prøverør er tilgjengelig.

**2. Bekreft blodprøvetakingen**

Send en `POST`-forespørsel til `/api/v1/appointments/{id}/confirm` med labkodene fra det fysiske blodprøvetakingssettet. En venøs blodprøvetaking har én kode trykt på hvert prøverør – send den som `lab_code`. En blodprøvetaking på apotek har én kode per mikrorør – send dem som `lab_codes`, én oppføring per kode med de `panel_ids` som mikrorøret inneholder (fra timens `panels`); hver kode blir en egen laboratorierekvisisjon. Enkeltbiomarkører på apotek fyller først den ledige plassen i panelenes mikrorør. Send én oppføring uten `panel_ids` for hvert mikrorør de trenger for seg selv.

> [!WARNING]
>
> Hver kode må være tallstrengen som er trykt på det fysiske prøverøret som ble gitt til pasienten. Ikke bytt den ut med en annen identifikator – en feil kode fører til at laboratoriebestillingen feiler. Hver kode valideres før noe lagres; hvis én blir avvist, registreres ingenting.

```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ørsel returnerer `200 OK`:

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

**3. Kontroller timestatus**

Etter bekreftelsen henter du timen for å kontrollere at statusen er endret 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 timen viser `status: "blood_drawn"`, er bestillingsflyten til laboratoriet startet. Selve timestatusen forblir `blood_drawn` herfra; mer detaljert fremdrift videre vises via egne endepunkter: følg hver oppføring i den innebygde `shipments`-listen til [Hent forsendelse](https://docs.anivahealth.com/no/api/shipments/get-shipment.md) for hendelser om underveis / levert fra budet, og bruk [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md) for å se når laboratorieresultatene er klare (`status: "in_progress"` → `"completed"`).

## Hva skjer videre

Etter bekreftelsen tar Anivas bestillingsflyt til laboratoriet over:

1. Hver labkode kobles til de tilhørende fysiske prøverørene på laboratoriet – rekvisisjonen for hvert panel har koden som står på dets egne prøverør.
2. Panelene som er lagt til i timen, avgjør hvilke tester som utføres.
3. Når resultatene er klare, knyttes de til pasientprofilen og vises i
   [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md) – `status`-feltet på øverste nivå i svaret endres
   fra `in_progress` til `completed` så snart alle innsendinger er avsluttet og én har rapportert.

Det kreves ingen flere handlinger fra integrasjonen din etter bekreftelsen.

## Feilhåndtering

| Status | Årsak | Løsning |
| - | - | - |
| `400 Bad Request` | Ingen eller begge av `lab_code` / `lab_codes` er oppgitt, en kode er ikke-numerisk, eller en kode eller et panel gjentas. | Send nøyaktig én av de to, med de eksakte tallkodene fra de fysiske prøverørene. |
| `409 Conflict` | En kode kan ikke brukes (allerede tilordnet, uregistrert, tilhører et hjemmetestsett, feil klinikk), et panel mangler kode, eller timen kan ikke bekreftes. | Les `reason` og `lab_code`; skann et annet prøverør eller sjekk statusen for timen. |
| `403 Forbidden` | API-nøkkelen din har ikke tilgang til denne operasjonen. | Kontakt Aniva for å bekrefte rettighetene til API-nøkkelen din. |
| `404 Not Found` | Time-ID-en finnes ikke eller tilhører ikke kontoen din. | Sjekk at time-ID-en er riktig. |


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