> ## 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/ru/api/appointments/get-appointment.md), а каждый результат и документ в [Получить результаты](https://docs.anivahealth.com/ru/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.