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

# Potvrdit odběr krve

> Zaznamenat, že proběhl odběr krve, a spustit zpracování laboratorní objednávky

Zaznamenej dokončení odběru krve a spusť zpracování laboratorní objednávky. Odešli laboratorní kódy (čárové kódy zkumavek) z odběrové sady pro propojení fyzických vzorků s termínem.

Odběr krve má kódy jedním ze dvou způsobů:

* **Jeden kód pro celý odběr krve** — žilní odběr, kde je stejný čárový kód vytištěn na každé zkumavce. Pošli ho jako `lab_code`.
* **Jeden kód na mikrozkumavku** — kapilární odběr, kde má každá mikrozkumavka vlastní čárový kód. Pošli je jako `lab_codes`, jednu položku na kód s `panel_ids`, které daná mikrozkumavka obsahuje. Každý kód se stane samostatnou laboratorní žádankou — čárový kód na zkumavce je číslem objednávky laboratoře. Položka bez `panel_ids` je záchytná položka pro všechny panely neuvedené jinde. Žilní odběr má nejvýše jednu.

Pošli přesně jednu z těchto dvou možností. Každý připojený panel musí spadat přesně pod jeden kód (vlastní položku nebo záchytnou položku). U žilního odběru krve potřebují samostatné biomarkery záchytnou položku. U kapilárního odběru krve uveď každý panel u kódu jeho mikrozkumavky. Samostatné biomarkery vyplní volné místo v mikrozkumavkách panelů a nové mikrozkumavky otevřou jen v případě potřeby. Rozdělujeme je rovnoměrně. Každá mikrozkumavka jich pojme nejvýše 150 µl. Za každou mikrozkumavku, kterou potřebují samy pro sebe, pošli jednu položku bez `panel_ids`, a ne víc. Kód, na který nevyjde žádný panel ani biomarker, se odmítne s `409` a `reason: "panel_coverage"`. Každý kód se ověří dřív, než se cokoli zapíše; pokud některý kód nejde použít nebo zůstane panel nepokrytý, nic se nezaznamená a odpověď problém pojmenuje.

Vyžaduje scope `appointments_schedule`, `appointments_manage` nebo `appointments_operate`.

> [!WARNING]
>
> Tato akce je nevratná. Jakmile potvrdíš odběr krve, termín se uzamkne — žádné
> další úpravy, včetně přidávání panelů, už nebudou možné.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) termínu k potvrzení.

### Parametry těla

**lab\_code** `string`

Číselný laboratorní kód vytištěný na odběrové sadě, když jeden kód pokrývá všechny zkumavky.
Vzájemně se vylučuje s `lab_codes`.

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

Všechny laboratorní kódy odběru krve v pořadí skenování (alespoň jedna položka). Vzájemně se vylučuje s `lab_code`.
Kód se může objevit jen jednou; panel může být uveden jen u jedné položky.

**položka laboratorního kódu**

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

Číselný laboratorní kód vytištěný na zkumavkách těchto panelů.

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

Připojené panely, jejichž zkumavky nesou tento kód — hodnoty `panel_id` z `panels`
daného termínu. Vynech nebo pošli `[]` pro záchytnou položku pokrývající všechny panely
neuvedené jinde a samostatné biomarkery. Žilní odběr krve má nejvýše jednu záchytnou položku. U kapilárního
odběru krve obsahuje záchytná položka jen samostatné biomarkery a posíláš jednu na každou mikrozkumavku, kterou potřebují.

## Odpověď

Při úspěchu vrátí API `200 OK` potvrzující spuštění zpracování laboratorní objednávky.

**success** `boolean`

`true`, když byl odběr krve zaznamenán a bylo spuštěno zpracování laboratorní objednávky.

**warning** `string`

Vrací se pouze tehdy, když byl odběr krve zaznamenán v jiný den, než je den termínu. Běžné klíče
to neumožňují — dostanou `409` s `reason: "appointment_not_today"`. Přesuň termín na den odběru
krve a pak ho potvrď.

Zaznamenané kódy se vracejí jako `lab_codes` v [Získat termín](https://docs.anivahealth.com/cs/api/appointments/get-appointment.md) a každý výsledek i dokument v [Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md) obsahuje `lab_code`, pod kterým byl evidován.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — není zadán žádný nebo jsou zadány oba parametry `lab_code` i `lab_codes`, kód není číselný, nebo se kód či panel opakuje. |
| `403` | Zakázáno — tvůj API klíč nemá k této operaci přístup. |
| `404` | Termín nebyl nalezen. |
| `409` | Kód nelze použít (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), panel zůstává bez kódu, `panel_id` není připojen, žilní odběr krve má dva záznamy bez `panel_ids`, kapilární odběr krve má více záznamů než mikrozkumavek nebo více záznamů bez `panel_ids` než mikrozkumavek jen pro markery, nebo kapilární kód neodpovídá svým mikrozkumavkám (vše `panel_coverage`), kód zaznamenaný před resetem nyní uvádí jiné panely (`remapped`) nebo musí u tohoto odběru krve zůstat, protože laboratoř už může mít jeho objednávku (`sent_to_lab`, `order_in_flight`), kód uvádí panel, který na termínu není naplánován (`unknown_panel`), nebo termín nelze potvrdit (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` uvádí konkrétní kód, pokud je chyba v něm. |
| `500` | Interní chyba serveru. |

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