Перейти до основного вмісту
PATCH
Онови деталі запису, наприклад запланований час або локацію аналізу. Змінювати можна лише ті записи, для яких ще не підтверджено забір крові.
Записи не можна змінювати після підтвердження забору крові або якщо їх уже скасовано. Спроба оновити такий запис повертає 409 Conflict. Єдиний виняток — results_ready_emails, яке ти все ще можеш змінити після забору крові.
Потребує області доступу appointments_schedule або appointments_manage.

Запит

Параметри шляху

string
обов'язково
Унікальний ідентифікатор (UUID) запису, який потрібно оновити.

Параметри тіла запиту

Усі параметри тіла запиту необов’язкові — передай лише ті поля, які хочеш змінити.
string
Нова дата й час запису у форматі ISO 8601 (наприклад, 2026-05-20T14:00:00Z або 2026-05-20T16:00:00+02:00). Має містити позначення часового поясу — або Z, або явне зміщення на кшталт +02:00; дати без часового поясу відхиляються. Дата має бути в майбутньому.Час має точно збігатися з початком слота, де є вільні місця — переглянь Отримати доступність. Запис, який переноситься, ніколи не займає місце у власному цільовому слоті, але перенесення на слот, де в того самого профілю вже є інший запис, повертає 409 із appointment_id того запису.Якщо цільовою локацією керує Aniva, новий час також має бути щонайменше за 12 годин — переглянь Мінімальний час попередження.
string
UUID нової локації аналізу. Локація має існувати й бути активною. Використай Список локацій, щоб знайти доступні ID локацій.
string[]
Замінює список до 5 адрес, кожна з яких отримує один лист, щойно всі результати лабораторії стають остаточними. Надішли [], щоб вимкнути листи. Це поле можна редагувати й після забору крові; відмовляє лише скасований запис. Після забору крові надсилай його окремо: якщо в тому самому тілі є scheduled_at або location_id, запит поверне 409. Твій ключ потребує доступу results_view до пацієнта, інакше повернеться 403. Переглянь Листи про готовність результатів.
string | null
Новий метод забору крові: capillary або venous, або null, щоб знову використовувати default_draw_method локації. Цей метод має бути в draw_methods локації, а замовлені аналізи мають бути можливі з ним, інакше повернеться 400. Коли ти переносиш запис в іншу локацію, там виконується та сама перевірка: за власним draw_method запису або за default_draw_method нової локації.

Відповідь

У разі успіху API повертає 200 OK з оновленим записом і вбудованим профілем.
string
обов'язково
Унікальний ідентифікатор запису (UUID).
string
обов'язково
UUID профілю, до якого належить цей запис.
string
UUID локації тестування, де відбувається забір крові.
string
Запланована дата й час запису в UTC (ISO 8601 із суфіксом Z, наприклад 2026-05-20T14:00:00Z). Може бути null.
string
обов'язково
Поточний статус запису. Одне зі значень: pending, confirmed, blood_drawn або cancelled. Детальний статус готовності результатів аналізів можна отримати з Отримати результати, а докладніший прогрес відправлення — із кожного елемента вбудованого масиву shipments (див. нижче) із переходом до Отримати відправлення.
string
Причина скасування у вільній формі, зафіксована під час скасування запису (наприклад, неявка, пізнє скасування, «Помилка. Потрібно повторити»). null, якщо status не дорівнює cancelled.
string[]
обов'язково
Електронні адреси в нижньому регістрі, на кожну з яких надходить один лист, коли всі лабораторні результати стають остаточними. Порожньо, якщо вимкнено. Див. Листи про готовність результатів.
string
обов'язково
Спосіб забору крові: capillary (із пальця або плеча в мікротейнери) або venous (із вени у пробірки). Це спосіб, указаний у записі, або default_draw_method його локації. Після забору крові — це фактично використаний спосіб.
string
обов'язково
Часова мітка ISO 8601 створення запису.
string
Часова мітка ISO 8601 останнього оновлення. Може бути null.
object
обов'язково
Профіль пацієнта, пов’язаний із цим записом.
AppointmentPanel[]
обов'язково
Панелі, які наразі прикріплені до цього запису. Скасовані прикріплення не включено. Переглянь деталі панелі (назву, біомаркери) через Список панелей.
AppointmentIndividualBiomarker[]
обов'язково
Окремі біомаркери, додані до цього запису поза межами панелей (див. Додати окремі біомаркери). Звіряй кожен biomarker_id зі Списком біомаркерів, щоб отримати дані для відображення.
AppointmentShipmentLink[]
обов'язково
Відправлення, пов’язані з цим записом, у порядку від найдавнішого зв’язку. Порожній масив, якщо пов’язаних відправлень немає. Звір кожен id через Отримати відправлення, щоб отримати повні дані відправлення.
string[]
обов'язково
Лабораторні коди (штрихкоди пробірок), зафіксовані для цього запису, у порядку сканування. Порожньо до підтвердження забору крові. Венозний забір крові має один код, надрукований на кожній пробірці; капілярний забір крові має по одному коду на кожен мікротейнер. Результати й документи в Отримати результати посилаються на ці коди через lab_code.

Відповіді з помилками