Перейти к основному содержанию
Используй это руководство, чтобы подтвердить, что забор крови состоялся. Подтверждение записывает лабораторные коды (штрихкоды пробирок) физического набора и запускает обработку лабораторного заказа; статус готовности результатов затем можно читать через Получить результаты.
Подтверждение необратимо. После подтверждения забора крови в запись нельзя внести никаких изменений — включая добавление панелей. Убедись, что все панели прикреплены, а все данные верны, прежде чем продолжить.
1

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

Перед подтверждением проверь, что все нужные панели анализов добавлены в запись. После подтверждения добавить панели нельзя.Посмотри руководство Создание записи, чтобы узнать, как прикрепить панели.Перед продолжением проверь следующее:
  • Все нужные панели прикреплены к записи.
  • Значения profile_id и location_id в записи указаны верно.
  • Пациент прошёл забор крови, и штрихкод каждой пробирки под рукой.
2

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

Отправь запрос POST на /api/v1/appointments/{id}/confirm с лабораторными кодами из физического набора для забора крови. При венозном заборе крови на каждой пробирке напечатан один и тот же код — передай его в поле lab_code. При заборе крови в аптеке у каждого микротейнера свой код — передай их в lab_codes, по одному элементу на код с panel_ids тех панелей, которые находятся в этом микротейнере (из panels записи); каждый код становится отдельным направлением в лабораторию. Отдельные биомаркеры в аптеке сначала заполняют свободное место в микротейнерах с панелями. Для каждого отдельного микротейнера, который им понадобится, отправь по одному элементу без panel_ids.
Каждый код должен быть числовой строкой, напечатанной на физической пробирке, выданной пациенту. Не подставляй другой идентификатор — неверный код приведёт к ошибке лабораторного заказа. Каждый код проверяется до записи данных; если хотя бы один отклонён, ничего не сохраняется.
Успешный запрос возвращает 200 OK:
3

Проверь статус записи

После подтверждения запроси запись, чтобы убедиться, что её статус изменился на blood_drawn.
Как только у записи появится status: "blood_drawn", процесс лабораторного заказа запущен. Сама запись далее остаётся в статусе blood_drawn; более детальный ход дальнейших этапов доступен через отдельные эндпоинты: переходи по каждому элементу встроенного массива shipments в Получить отправку для событий доставки курьером (в пути / доставлено) и используй Получить результаты для отслеживания готовности лабораторных результатов (status: "in_progress" → "completed").

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

После подтверждения работу продолжает процесс обработки лабораторных заказов Aniva:
  1. В лаборатории каждый лабораторный код сопоставляется со своими физическими пробирками — направление каждой панели содержит код с её пробирок.
  2. Прикреплённые к записи панели определяют, какие анализы будут выполнены.
  3. Когда результаты готовы, они привязываются к профилю пациента и появляются в Получить результаты — поле status верхнего уровня в ответе меняется с in_progress на completed, когда все заявки закрыты и хотя бы по одной получены результаты.
После подтверждения от твоей интеграции больше никаких действий не требуется.

Обработка ошибок