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

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

> Покрокова інструкція: зафіксуй забір крові в Aniva API та передай зразок у процес обробки лабораторних замовлень.

Використовуй цей посібник, щоб підтвердити, що забір крові відбувся. Підтвердження фіксує лабораторні коди (штрихкоди пробірок) фізичного набору та запускає процес лабораторного замовлення; далі прогрес результатів можна читати через [Отримати результати](https://docs.anivahealth.com/uk/api/appointments/get-results.md).

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

**1. Переконайся, що панелі додані**

Перед підтвердженням перевір, чи всі потрібні тестові панелі додані до запису. Після підтвердження додати панелі не можна.

Переглянь посібник [Запланувати запис](https://docs.anivahealth.com/uk/guides/schedule-appointment.md), щоб дізнатися, як додати панелі.

Перевір таке перед продовженням:

* Усі потрібні панелі додані до запису.
* `profile_id` і `location_id` у записі правильні.
* Пацієнт пройшов забір крові, а штрихкод кожної пробірки під рукою.

**2. Підтвердь забір крові**

Надішли запит `POST` на `/api/v1/appointments/{id}/confirm` із лабораторними кодами з фізичного набору для забору крові. Венозний забір крові має один код, надрукований на кожній пробірці, — надішли його як `lab_code`. Забір крові в аптеці має по одному коду на кожен мікротейнер — надішли їх як `lab_codes`, по одному елементу на код із `panel_ids`, які містить його мікротейнер (із `panels` запису); кожен код стає окремим лабораторним направленням. Окремі біомаркери в аптеці спочатку заповнюють вільне місце в мікротейнерах панелей. Надішли по одному елементу без `panel_ids` для кожного мікротейнера, який потрібен їм окремо.

> [!WARNING]
>
> Кожен код має бути цифровим рядком, надрукованим на фізичній пробірці, переданій пацієнту. Не підставляй інший ідентифікатор — неправильний код призведе до збою лабораторного замовлення. Кожен код перевіряється до збереження будь-яких даних; якщо один із них відхилено, нічого не записується.

```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();
```

Успішний запит повертає `200 OK`:

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

**3. Перевір статус запису**

Після підтвердження отримай запис, щоб перевірити, чи змінився його статус на `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"
```

Щойно запис має `status: "blood_drawn"`, процес лабораторного замовлення запущено. Сам статус запису надалі залишається `blood_drawn`; детальніший подальший перебіг доступний через окремі ендпоінти: для кожного елемента у вбудованому масиві `shipments` звернися до [Отримати відправлення](https://docs.anivahealth.com/uk/api/shipments/get-shipment.md) для подій кур’єрської доставки у дорозі / доставлено, а для готовності лабораторних результатів (`status: "in_progress"` → `"completed"`) використовуй [Отримати результати](https://docs.anivahealth.com/uk/api/appointments/get-results.md).

## Що відбувається далі

Після підтвердження роботу перебирає процес лабораторного замовлення Aniva:

1. У лабораторії кожен лабораторний код зіставляється зі своїми фізичними пробірками — направлення кожної панелі містить код із її пробірок.
2. Панелі, додані до запису, визначають, які аналізи будуть виконані.
3. Коли результати готові, вони прив’язуються до профілю пацієнта та з’являються в
   [Отримати результати](https://docs.anivahealth.com/uk/api/appointments/get-results.md) — поле `status` верхнього рівня у відповіді змінюється
   з `in_progress` на `completed`, щойно кожне подання закриється й одне надасть звіт.

Після підтвердження від твоєї інтеграції більше не потрібно жодних дій.

## Обробка помилок

| Статус | Причина | Вирішення |
| - | - | - |
| `400 Bad Request` | Не вказано жодного з `lab_code` / `lab_codes` або вказано обидва, код не є числовим, або код чи панель повторюються. | Надішли рівно одне з двох полів із точними числовими кодами з фізичних пробірок. |
| `409 Conflict` | Код не можна використати (уже призначений, незареєстрований, належить до набору для домашнього тесту, інша клініка), панель не має коду або запис не можна підтвердити. | Перевір `reason` і `lab_code`; відскануй іншу пробірку або перевір статус запису. |
| `403 Forbidden` | Твій API-ключ не має доступу до цієї операції. | Звернися до Aniva, щоб підтвердити права доступу свого API-ключа. |
| `404 Not Found` | ID запису не існує або не належить твоєму акаунту. | Перевір правильність ID запису. |


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