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

# Vérvétel megerősítése

> A vérvétel elvégzésének rögzítése és a laborrendelési folyamat elindítása

Rögzítsd a vérvétel befejezését, és indítsd el a laborrendelési folyamatot. Küldd el a vérvételi készlet laborkódjait (csővonalkódjait), hogy a fizikai mintákat az időponthoz kapcsold.

Egy vérvétel kétféleképpen hordozza a kódjait:

* **Egyetlen kód a teljes vérvételhez** — vénás vérvétel, ahol minden csőre ugyanaz a vonalkód van nyomtatva. Küldd el `lab_code` néven.
* **Mikrocsövenként egy kód** — kapilláris vérvétel, ahol minden mikrocsőnek saját vonalkódja van. Küldd el őket `lab_codes` néven, kódonként egy bejegyzéssel, a mikrocsőben lévő `panel_ids` értékekkel. Minden kód külön laboratóriumi megrendeléssé válik — a csövön lévő vonalkód a laboratórium megrendelésszáma. A `panel_ids` nélküli bejegyzés gyűjtőbejegyzés minden olyan panelhez, amely máshol nincs megnevezve. Vénás vérvételnél ebből legfeljebb egy lehet.

Pontosan az egyiket küldd el a kettő közül. Minden csatolt panelnek pontosan egy kód alá kell kerülnie (a saját bejegyzése vagy a gyűjtőbejegyzés alá). Vénás vérvételnél az egyedi biomarkerekhez szükség van a gyűjtőbejegyzésre. Kapilláris vérvételnél minden panelt nevezz meg a mikrocsöve kódjánál. Az egyedi biomarkerek kitöltik a panel mikrocsöveinek szabad helyét, és csak szükség esetén nyitnak új mikrocsöveket. Egyenletesen osztjuk el őket. Minden mikrocsőbe legfeljebb 150 µl fér belőlük. Küldj egy `panel_ids` nélküli bejegyzést minden egyes olyan mikrocsőhöz, amelyre önállóan szükségük van, és nem többet. Ha egy kódhoz végül egyetlen panel és biomarker sem jut, `409` és `reason: "panel_coverage"` válasszal elutasítjuk. Minden kódot ellenőrzünk, mielőtt bármit kiírnánk; ha bármelyik kód nem használható, vagy egy panel lefedetlen marad, semmit nem rögzítünk, és a válasz megnevezi a problémát.

Az `appointments_schedule`, az `appointments_manage` vagy az `appointments_operate` scope szükséges hozzá.

> [!WARNING]
>
> Ez a művelet visszafordíthatatlan. Amint megerősíted a vérvételt, az időpont zárolódik — további
> módosítások, beleértve a panelek hozzáadását is, már nem lehetségesek.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

A megerősítendő időpont egyedi azonosítója (UUID).

### Törzsparaméterek

**lab\_code** `string`

A vérvételi készletre nyomtatott numerikus laborkód, amikor egy kód fedi le az összes csövet. A
`lab_codes` mezővel kölcsönösen kizárják egymást.

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

A vérvétel összes laborkódja, beolvasási sorrendben (legalább egy bejegyzés). A `lab_code` mezővel kölcsönösen kizárják egymást. Egy
kód csak egyszer szerepelhet; egy panel csak egy bejegyzésben nevezhető meg.

**laborkód-bejegyzés**

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

Ezeknek a paneleknek a csöveire nyomtatott numerikus laborkód.

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

Azok a csatolt panelek, amelyek csövei ezt a kódot viselik — `panel_id` értékek az időpont
`panels` listájából. Hagyd el, vagy küldj `[]` értéket a gyűjtőbejegyzéshez, amely minden máshol meg nem nevezett panelt, valamint
az egyedi biomarkereket fedi le. Vénás vérvételnél legfeljebb egy gyűjtőbejegyzés lehet. Kapilláris vérvételnél a gyűjtőbejegyzés
csak egyedi biomarkereket tartalmaz, és annyit kell küldened belőle, ahány mikrocsőre szükségük van.

## Válasz

Siker esetén az API `200 OK` választ ad, megerősítve, hogy a laborrendelési folyamat elindult.

**success** `boolean`

`true`, amikor a vérvételt rögzítették, és elindult a laborrendelési folyamat.

**warning** `string`

Csak akkor szerepel, ha a vérvételt nem az időpont napján rögzítették. A normál kulcsokkal ez nem
lehetséges — `409`-et kapnak `reason: "appointment_not_today"` indokkal. Tedd át az időpontot a
vérvétel napjára, majd erősítsd meg.

A rögzített kódokat a `lab_codes` mező adja vissza az [Időpont lekérése](https://docs.anivahealth.com/hu/api/appointments/get-appointment.md) végponton, és az [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) végponton minden eredmény és dokumentum tartalmazza azt a `lab_code` értéket, amely alatt rögzítették.

## Hibaválaszok

| Állapot | Leírás |
| - | - |
| `400` | Érvényesítési hiba — a `lab_code` és a `lab_codes` közül egyik sincs vagy mindkettő meg van adva, egy kód nem számjegyekből áll, vagy egy kód vagy panel ismétlődik. |
| `403` | Tiltott — az API-kulcsodnak nincs hozzáférése ehhez a művelethez. |
| `404` | Az időpont nem található. |
| `409` | Egy kód nem használható (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), egy panel kód nélkül maradt, egy `panel_id` nincs csatolva, egy vénás vérvételhez két bejegyzés tartozik `panel_ids` nélkül, egy kapilláris vérvételhez több bejegyzés tartozik, mint amennyi mikrotainer van, vagy több `panel_ids` nélküli bejegyzés van, mint amennyi csak markeres mikrotainer, vagy egy kapilláris kód nem egyezik a mikrotainereivel (mindegyik `panel_coverage`), egy visszaállítás előtt rögzített kód most más paneleket nevez meg (`remapped`), vagy ennél a vérvételnél kell maradnia, mert a labornál már meglehet a rendelése (`sent_to_lab`, `order_in_flight`), egy kód olyan panelt nevez meg, amely nincs betervezve az időponthoz (`unknown_panel`), vagy az időpont nem erősíthető meg (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). A `lab_code` megnevezi a hibás kódot, ha egy kód okozza a hibát. |
| `500` | Belső szerverhiba. |

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