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

# Підтвердити забір крові

> Зафіксувати, що забір крові проведено, і запустити процес опрацювання лабораторного замовлення

Зафіксуй завершення забору крові та запусти процес лабораторного замовлення. Надішли лабораторні коди (штрихкоди пробірок) із набору для забору крові, щоб прив’язати фізичні зразки до запису.

Коди для забору крові передаються одним із двох способів:

* **Один код на весь забір крові** — венозний забір крові, коли на кожній пробірці надруковано той самий штрихкод. Надішли його як `lab_code`.
* **Один код на кожен мікротейнер** — капілярний забір крові, коли кожен мікротейнер має власний штрихкод. Надішли їх як `lab_codes`, по одному елементу на код із `panel_ids`, які містить цей мікротейнер. Кожен код стає окремим лабораторним направленням — штрихкод на пробірці є номером замовлення лабораторії. Елемент без `panel_ids` є загальним для всіх панелей, не вказаних в інших елементах. Венозний забір крові може мати щонайбільше один такий елемент.

Надішли рівно один із цих двох варіантів. Кожна додана панель має потрапити рівно під один код (у власний елемент або в загальний). Під час венозного забору крові окремі біомаркери потребують загального елемента. Під час капілярного забору крові вкажи кожну панель у коді її мікротейнера. Окремі біомаркери заповнюють вільний простір мікротейнерів із панелями та займають нові мікротейнери лише за потреби. Ми розподіляємо їх рівномірно. Кожен мікротейнер вміщує щонайбільше 150 µl таких біомаркерів. Надішли один елемент без `panel_ids` для кожного мікротейнера, який їм потрібен окремо, і не більше. Код, у якому зрештою не виявиться жодної панелі й жодного біомаркера, відхиляється зі статусом `409` і `reason: "panel_coverage"`. Усі коди перевіряються перед збереженням будь-яких даних; якщо якийсь код неможливо використати або панель залишилася непокритою, нічого не зберігається, а відповідь указує на проблему.

Потребує області доступу `appointments_schedule`, `appointments_manage` або `appointments_operate`.

> [!WARNING]
>
> Ця дія незворотна. Щойно ти підтвердиш забір крові, запис блокується — жодні
> подальші зміни, включно з додаванням панелей, неможливі.

## Запит

### Параметри шляху

**id** `string` *required*

Унікальний ідентифікатор (UUID) запису, який потрібно підтвердити.

### Параметри тіла запиту

**lab\_code** `string`

Числовий лабораторний код, надрукований на наборі для забору крові, коли один код охоплює всі пробірки. Взаємовиключний
із `lab_codes`.

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

Усі лабораторні коди забору крові в порядку сканування (щонайменше один елемент). Взаємовиключний із `lab_code`. Кожен
код може зустрічатися лише один раз; панель може бути вказана лише в одному елементі.

**Елемент лабораторного коду**

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

Числовий лабораторний код, надрукований на пробірках цих панелей.

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

Додані панелі, пробірки яких мають цей код — значення `panel_id` із поля `panels`
цього запису. Не передавай поле або надішли `[]` для загального елемента, який охоплює всі панелі, не вказані в інших елементах, а також
окремі біомаркери. Венозний забір крові може мати щонайбільше один загальний елемент. Під час капілярного забору крові загальний елемент
містить лише окремі біомаркери, і ти надсилаєш по одному такому елементу на кожен потрібний для них мікротейнер.

## Відповідь

У разі успіху API повертає `200 OK`, підтверджуючи запуск процесу лабораторного замовлення.

**success** `boolean`

`true`, коли забір крові зафіксовано й запущено процес лабораторного замовлення.

**warning** `string`

Присутнє лише тоді, коли забір крові зафіксовано в інший день, ніж день запису. Звичайні ключі
не можуть цього зробити — вони отримують `409` із `reason: "appointment_not_today"`. Перенеси
запис на день забору крові, а потім підтвердь його.

Зафіксовані коди повертаються як `lab_codes` у [Отримати запис](https://docs.anivahealth.com/uk/api/appointments/get-appointment.md), а кожен результат і документ у [Отримати результати](https://docs.anivahealth.com/uk/api/appointments/get-results.md) містить `lab_code`, під яким його оформлено.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `400` | Помилка валідації — не передано жодного або передано обидва поля `lab_code` і `lab_codes`, код не є числовим, або код чи панель повторюється. |
| `403` | Доступ заборонено — твій API-ключ не має доступу до цієї операції. |
| `404` | Запис не знайдено. |
| `409` | Код не можна використати (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), панель залишилася без коду, `panel_id` не додано, венозний забір крові має два елементи без `panel_ids`, капілярний забір крові має більше елементів, ніж мікротейнерів, або більше елементів без `panel_ids`, ніж мікротейнерів лише для маркерів, або капілярний код не відповідає своїм мікротейнерам (усе це — `panel_coverage`), код, зафіксований до скидання, тепер вказує на інші панелі (`remapped`) або має залишитися за цим забором крові, бо лабораторія може вже мати його замовлення (`sent_to_lab`, `order_in_flight`), код вказує на панель, не заплановану в записі (`unknown_panel`), або запис не можна підтвердити (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` вказує на код, який спричинив помилку, якщо причина в ньому. |
| `500` | Внутрішня помилка сервера. |

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