> ## 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äfta blodprovstagning

> Steg-för-steg-guide: registrera en blodprovstagning i Aniva API och skicka provet till flödet för labbeställningar.

Använd den här guiden för att bekräfta att en blodprovstagning har genomförts. Bekräftelsen registrerar labbkoderna (rörens streckkoder) från det fysiska kitet och startar flödet för laboratoriebeställningen; hur det går med resultaten läser du sedan via [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md).

> [!WARNING]
>
> Bekräftelsen är **oåterkallelig**. När du väl har bekräftat en blodprovstagning kan inga fler ändringar –
> inklusive att lägga till paneler – göras i bokningen. Se till att alla paneler är kopplade och
> att alla uppgifter stämmer innan du går vidare.

**1. Se till att paneler har lagts till**

Innan du bekräftar kontrollerar du att alla nödvändiga testpaneler har lagts till i bokningen. Du kan inte lägga till paneler efter bekräftelsen.

Läs guiden [Skapa en bokning](https://docs.anivahealth.com/sv/guides/schedule-appointment.md) för instruktioner om hur du lägger till paneler.

Kontrollera följande innan du fortsätter:

* Alla nödvändiga paneler är kopplade till bokningen.
* `profile_id` och `location_id` på bokningen stämmer.
* Patienten har genomfört blodprovstagningen och streckkoden för varje rör finns till hands.

**2. Bekräfta blodprovstagningen**

Skicka en `POST`-begäran till `/api/v1/appointments/{id}/confirm` med labbkoderna från det fysiska kitet för blodprovstagningen. En venös blodprovstagning har en kod tryckt på varje rör – skicka den som `lab_code`. En blodprovstagning på apotek har en kod per mikrorör – skicka dem som `lab_codes`, en post per kod med de `panel_ids` som mikroröret innehåller (från bokningens `panels`); varje kod blir en egen laboratorieremiss. Enskilda biomarkörer på ett apotek fyller först det lediga utrymmet i panelernas mikrorör. Skicka en post utan `panel_ids` för varje mikrorör som de behöver på egen hand.

> [!WARNING]
>
> Varje kod måste vara den numeriska strängen som är tryckt på det fysiska rör som lämnats till patienten. Byt inte ut den mot en annan identifierare – en felaktig kod gör att laboratoriebeställningen misslyckas. Varje kod valideras innan något skrivs; om en kod avvisas registreras 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 lyckad begäran returnerar `200 OK`:

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

**3. Kontrollera bokningsstatus**

Efter bekräftelsen hämtar du bokningen för att kontrollera att statusen har ändrats till `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 bokningen visar `status: "blood_drawn"` har flödet för laboratoriebeställningen startats. Själva bokningsstatusen förblir `blood_drawn` härifrån och framåt; mer detaljerade uppdateringar längre fram i flödet exponeras via dedikerade slutpunkter: följ varje post i den inbäddade arrayen `shipments` till [Hämta försändelse](https://docs.anivahealth.com/sv/api/shipments/get-shipment.md) för budhändelser om transport / leverans, och använd [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md) för att se när laboratorieresultaten är klara (`status: "in_progress"` → `"completed"`).

## Vad som händer sedan

Efter bekräftelsen tar Anivas flöde för laboratoriebeställningar över:

1. Varje labbkod matchas mot sina fysiska rör på laboratoriet – varje panels remiss har koden från sina egna rör.
2. Panelerna som är kopplade till bokningen avgör vilka tester som körs.
3. När resultaten är klara kopplas de till patientprofilen och visas i
   [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md) – svarets fält `status` på toppnivå ändras
   från `in_progress` till `completed` när varje inlämning har avslutats och en har rapporterat.

Ingen ytterligare åtgärd krävs från din integration efter bekräftelsen.

## Felhantering

| Status | Orsak | Lösning |
| - | - | - |
| `400 Bad Request` | Ingen eller båda av `lab_code` / `lab_codes` har angetts, en kod är inte numerisk, eller en kod eller panel upprepas. | Skicka exakt en av dem, med de exakta numeriska koderna från de fysiska rören. |
| `409 Conflict` | En kod kan inte användas (redan tilldelad, oregistrerad, tillhör ett hemtestkit, fel klinik), en panel saknar kod eller bokningen kan inte bekräftas. | Läs `reason` och `lab_code`; skanna ett annat rör eller kontrollera bokningens status. |
| `403 Forbidden` | Din API-nyckel har inte behörighet till den här åtgärden. | Kontakta Aniva för att bekräfta behörigheterna för din API-nyckel. |
| `404 Not Found` | Boknings-ID:t finns inte eller tillhör inte ditt konto. | Kontrollera att boknings-ID:t stämmer. |


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