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

> Registrera att blodprovstagningen har genomförts och starta flödet för labbeställningen

Registrera att en blodprovstagning har genomförts och starta labbeställningsflödet. Skicka in labbkoderna (rörens streckkoder) från blodprovstagningskitet för att koppla de fysiska proverna till bokningen.

En blodprovstagning har sina koder på ett av två sätt:

* **En kod för hela blodprovstagningen** — en venös blodprovstagning, där samma streckkod är tryckt på varje provrör. Skicka den som `lab_code`.
* **En kod per mikrorör** — en kapillär blodprovstagning, där varje mikrorör har en egen streckkod. Skicka dem som `lab_codes`, en post per kod med de `panel_ids` som mikroröret innehåller. Varje kod blir en egen laboratorieremiss — streckkoden på röret är labbets ordernummer. En post utan `panel_ids` är en samlingspost för alla paneler som inte anges någon annanstans. En venös blodprovstagning har som mest en.

Skicka exakt en av de två. Varje kopplad panel måste hamna under exakt en kod (en egen post eller samlingsposten). Vid en venös blodprovstagning behöver enskilda biomarkörer samlingsposten. Vid en kapillär blodprovstagning anger du varje panel på koden för dess mikrorör. Enskilda biomarkörer fyller det lediga utrymmet i panelmikrorören och öppnar nya mikrorör bara när det behövs. Vi fördelar dem jämnt. Varje mikrorör rymmer högst 150 µl av dem. Skicka en post utan `panel_ids` för varje eget mikrorör de behöver, och inte fler. En kod som varken får någon panel eller biomarkör nekas med `409` och `reason: "panel_coverage"`. Varje kod valideras innan något skrivs; om någon kod inte kan användas eller om en panel inte täcks registreras ingenting, och svaret anger problemet.

Kräver scopet `appointments_schedule`, `appointments_manage` eller `appointments_operate`.

> [!WARNING]
>
> Den här åtgärden går inte att ångra. När du har bekräftat blodprovstagningen låses bokningen — inga
> ytterligare ändringar, inklusive att lägga till paneler, är möjliga.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen som ska bekräftas.

### Body-parametrar

**lab\_code** `string`

Numerisk labbkod tryckt på blodprovstagningskitet, när en kod täcker alla provrör. Kan inte
användas samtidigt som `lab_codes`.

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

Alla labbkoder för blodprovstagningen, i skanningsordning (minst en post). Kan inte användas samtidigt som `lab_code`. En
kod får bara förekomma en gång; en panel får bara anges i en post.

**labbkodspost**

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

Numerisk labbkod tryckt på provrören för dessa paneler.

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

De kopplade paneler vars provrör har den här koden — `panel_id`-värden från bokningens
`panels`. Utelämna fältet eller skicka `[]` för samlingsposten som täcker alla paneler som inte anges någon annanstans plus
de enskilda biomarkörerna. En venös blodprovstagning har som mest en samlingspost. Vid en kapillär blodprovstagning
innehåller en samlingspost bara enskilda biomarkörer, och du skickar en per mikrorör som de behöver.

## Svar

Om anropet lyckas returnerar API:et `200 OK` som bekräftar att labbeställningsflödet har startats.

**success** `boolean`

`true` när blodprovstagningen har registrerats och flödet för labbeställningar har startats.

**warning** `string`

Finns bara med när blodprovstagningen registrerades en annan dag än bokningsdagen. Vanliga nycklar
kan inte göra det – de får `409` med `reason: "appointment_not_today"`. Flytta bokningen till
dagen för blodprovstagningen och bekräfta sedan.

De registrerade koderna returneras som `lab_codes` i [Hämta bokning](https://docs.anivahealth.com/sv/api/appointments/get-appointment.md), och varje resultat och dokument i [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md) har den `lab_code` som det registrerades under.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel – varken eller båda av `lab_code` och `lab_codes` har angetts, en kod är inte numerisk, eller en kod eller panel upprepas. |
| `403` | Förbjudet – din API-nyckel saknar behörighet för den här åtgärden. |
| `404` | Bokningen hittades inte. |
| `409` | En kod kan inte användas (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), en panel lämnas utan kod, ett `panel_id` är inte kopplat, en venös blodprovstagning har två poster utan `panel_ids`, en kapillär blodprovstagning har fler poster än mikrorör eller fler poster utan `panel_ids` än mikrorör för enbart markörer, eller en kapillär kod matchar inte sina mikrorör (samtliga `panel_coverage`), en kod som registrerades före en återställning anger nu andra paneler (`remapped`) eller måste stanna kvar på den här blodprovstagningen eftersom labbet kan ha dess beställning (`sent_to_lab`, `order_in_flight`), en kod anger en panel som inte är planerad för bokningen (`unknown_panel`), eller så går bokningen inte att bekräfta (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` anger koden när en kod är felaktig. |
| `500` | Internt serverfel. |

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