Перейти до основного вмісту
Використовуй цей посібник, щоб підтвердити, що забір крові відбувся. Підтвердження фіксує лабораторні коди (штрихкоди пробірок) фізичного набору та запускає процес лабораторного замовлення; далі прогрес результатів можна читати через Отримати результати.
Підтвердження є незворотним. Після того як ти підтвердиш забір крові, жодні подальші зміни — включно з додаванням панелей — у записі будуть неможливі. Переконайся, що всі панелі додані, а всі деталі правильні, перш ніж продовжувати.
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, щойно кожне подання закриється й одне надасть звіт.
Після підтвердження від твоєї інтеграції більше не потрібно жодних дій.

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