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

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

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

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

> [!WARNING]
>
> Подтверждение **необратимо**. После подтверждения забора крови в запись нельзя внести
> никаких изменений — включая добавление панелей. Убедись, что все панели прикреплены, а
> все данные верны, прежде чем продолжить.

**1. Убедись, что панели добавлены**

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

Посмотри руководство [Создание записи](https://docs.anivahealth.com/ru/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/ru/api/shipments/get-shipment.md) для событий доставки курьером (в пути / доставлено) и используй [Получить результаты](https://docs.anivahealth.com/ru/api/appointments/get-results.md) для отслеживания готовности лабораторных результатов (`status: "in_progress"` → `"completed"`).

## Что происходит дальше

После подтверждения работу продолжает процесс обработки лабораторных заказов Aniva:

1. В лаборатории каждый лабораторный код сопоставляется со своими физическими пробирками — направление каждой панели содержит код с её пробирок.
2. Прикреплённые к записи панели определяют, какие анализы будут выполнены.
3. Когда результаты готовы, они привязываются к профилю пациента и появляются в
   [Получить результаты](https://docs.anivahealth.com/ru/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.