Назви контейнерів у попередньому перегляді запису стають торговими назвами
З наступного релізуcontainers[].name у Попередньому перегляді запису
буде торговою назвою пробірки. type не змінюється, тому читай type, якщо твій застосунок порівнює контейнери.Aniva тепер працює всіма мовами ЄС і ще кількома
- Адмінпанель, сайт, довідковий центр і документація: усіма 32 мовами.
- Профілі: вказуй мову для кожного пацієнта. Сторінка результатів і листи з результатами використовують її.
Один ендпоінт для списку панелей
- Список панелей тепер повертає
biomarker_groups. Використовуй його замість/api/v2/panels. - Ендпоінт створення панелі видалено. Користуйся адмінпанеллю.
Показуй лабораторні результати у своєму застосунку
Твої пацієнти тепер можуть бачити свої лабораторні результати у твоєму застосунку: список біомаркерів, динаміку кожного біомаркера та 3D Twin з оцінкою для кожної сфери здоров’я. Сторінка використовує колір твого бренду й твій логотип у світлій або темній темі.Сторінка результатів — це платне доповнення, а ціну підкаже твоя контактна особа в Aniva. Створення сесії вбудовування показує, як її налаштувати.Читання списків через API кешується до 5 хвилин
Ці чотири ендпоінти тепер кешують відповідь до 5 хвилин, тому зміни можуть відображатися із затримкою до 5 хвилин:ЕндпоінтиGet і далі показують зміни одразу.Якщо ти опитуєш API, щоб відстежувати зміни, краще використовуй вебхуки.
Вебхук повідомляє тебе про кожну зміну, щойно вона стається. Див.
Повторні читання.Діапазони Aniva тепер доступні
Твої результати тепер можуть містити діапазони Aniva: загальний діапазон і вужчий діапазон для кожного біомаркера разом із джерелами, які зафіксувала Aniva. Діапазони різняться за віком, статтю та тижнем вагітності.Щоб отримати доступ, підпиши коротку угоду щодо діапазонів Aniva. Після цього ми увімкнемо їх для твого API-ключа. Попроси угоду у своєї контактної особи в Aniva.Діапазони містяться в новому поліaniva_range. Воно замінює reference_range_aniva, яке
завжди мало значення null. Діапазони є загальною інформацією. Вони не оцінюють результат
і не є медичною порадою чи медичним виробом. Стандартом залишається діапазон лабораторії.
Див. Діапазони Aniva.Пробірка з фторидом тепер позначається як fluoride
Перегляд контейнерів позначає пробірку з фторидом як
fluoride. Старим значенням було naf. Якщо твій код порівнює container.type із naf,
зміни його на fluoride.Можуть з’являтися два нові значення: lihep_capillary і fluoride_capillary. Це капілярна
пробірка з літій-гепарином і капілярна пробірка з фторидом.Більше жодних подвійних бронювань останнього слота
Якщо два бронювання на останнє місце в слоті надходять одночасно, проходить лише одне. Інше отримує409, як для будь-якого заповненого слота. Те саме стосується випадків, коли запис
змінюють під час його скасування або підтвердження.Підтвердження забору крові має три нові причини для 409:remapped: код тепер відповідає іншим панелям, ніж раніше.sent_to_labіorder_in_flight: лабораторія вже може мати це замовлення, тому код повинен залишатися на своїй пробірці.
Суворіші вимоги до адрес доставки в замовленнях наборів для домашнього тесту
Створення набору для домашнього тесту та Оновлення набору для домашнього тесту суворіше перевіряютьdelivery_address.country_codeприймає малі літери, наприкладde. Aniva зберігає й повертає його великими літерами.- Для німецької адреси (
DE) потрібенpostal_codeрівно з 5 цифр. Інші значення отримують400. - Ми видаляємо пробіли навколо
postal_codeперед збереженням.
Новий набір замість поверненого нам
Коли перевізник повертає нам набір, ми більше не чекаємо на коробку. Повідом нам, що набір потрібен знову, і ми одразу надішлемо новий. Ти також можеш створити його самостійно: виклич Створити набір для домашнього тесту і вкажи повернений набір уreplaces_home_kit_order_id. Новий набір — це окреме замовлення з новим кодом набору.Ми перевіряємо повернену коробку, коли вона приходить. Тоді повернений набір змінює статус на
cancelled, і ти бачиш, що було в коробці.Лист команді, коли результати готові
Попроси нас встановити стандартну електронну адресу для твоєї групи профілів, наприклад поштову скриньку команди. На неї приходитиме лист, коли результати нового запису будуть готові. Це стосується записів з адмінпанелі, з API та від твоїх пацієнтів.Щоб змінити її для одного запису:- Адмінпанель: відредагуй електронні адреси або вимкни «Надіслати мені лист, коли результати будуть готові».
- API: надішли список у
results_ready_emails, щоб використати ці електронні адреси замість стандартної. Щоб зберегти свою стандартну електронну адресу, додай її до списку. Надішли[], щоб не надсилати лист.
Пацієнт вводить дату народження та стать
Тепер ми можемо дозволити твоїй групі профілів створювати профіль безdate_of_birth і sex.
Пацієнт вводить обидва поля на сторінці активації набору, причому дату народження — двічі.
Попроси нас увімкнути це. Дивись Профілі.Повернені нам набори
Коли перевізник повертає нам набір, сторінка Набори для домашнього тесту тепер показує його. Відфільтруй за статусом Повернено, щоб побачити кожен набір, який перевізник повернув нам, із причиною від перевізника. Відправлення завершується вfault і надсилає shipment.fault, а вже не
delivered. Щойно ми відкриємо коробку, ти також побачиш, що було в ній: повний комплект, бракує
частини або набір відкритий. Це покаже тобі, чи отримає твій клієнт повне повернення коштів.Хочеш, щоб ми надіслали набір ще раз? Напиши нам код набору та правильну адресу доставки. Ми
відправимо його з тим самим кодом набору.Логарифмічні одиниці
Список одиниць повертає третійunit_type: logarithmic — для значення,
яке є логарифмом величини, як-от pH або індекс атерогенності. Показуй його так само, як physical.
Не масштабуй його: дві логарифмічні одиниці різняться на зміщення, а не на множник.Розрахунок вартості набору для домашнього тесту зі зборами
Розрахувати кошик приймаєfulfilment. Надішли home_kit із
country_code, і розрахунок додасть позиції набору з твого щомісячного рахунку за одне замовлення:
збір за набір, засоби для забору зразків, доставку до цієї країни й назад, чохол і запасний пакет із
ланцетами. Стандартним варіантом залишається draw у локації зі зборами за запис. Відповідь вказує,
що саме розраховано, у fulfilment.kind.Знайомся з Aniva Concierge
Відтепер наш журнал змін також з’являється у твоєму каналі з нами в Slack, щойно ми щось випускаємо.Ми також створили Aniva Concierge. Маєш запитання про API чи адмінпанель? Згадай @Aniva в Slack або просто відповідай під дописом журналу змін. Він перевірить нашу документацію і підкаже, куди натиснути в адмінпанелі або який ендпоїнт і фільтри використати, з посиланням на сторінку.Список записів за один день
Список записів приймає два нові фільтри.date
(YYYY-MM-DD) повертає один календарний день у часовому поясі локації кожного запису, починаючи з
найранішого. location_id повертає одну локацію тестування. Використовуй обидва, щоб отримати
розклад локації на сьогодні.Дублікати профілів відхиляються
Створити профіль тепер повертає409 з
error_name: "duplicate_profile_error", якщо профіль, видимий для твого ключа, має ті самі ім’я,
прізвище, стать і дату народження. У відповіді вказано наявний profile_id. Використовуй його
замість створення другого профілю. Прізвища з пісочниці є винятком.Каталог тестів із твоїми цінами
Новий Каталог тестів в адмінпанелі показує кожен біомаркер із лабораторіями, пробірками та ціною за твоїм тарифом.Чому результат не має лабораторного діапазону
Кожен клінічний результат в Отримати результати та Отримати лабораторні результати для наборів для домашнього тесту тепер маєreference_range_lab_absent_reason. Це поле вказує, чому reference_range_lab має значення
null:not_provided: діапазону немає. Покажи «Не застосовується».lab_text_only: лабораторія вказала лише текст, наприклад цільове значення або рівень ризику. Покажиlab_reported.reference_range.not_measured: результат має статусundeliverable.
null, коли діапазон є. Дивись Результати.Роздрібні ціни та координати
- Локації тепер мають
state_code,latitudeіlongitude. - Список роздрібних цін та Отримати роздрібні ціни повертають ціну кожної панелі, яку аптека продає відвідувачам без попереднього запису.
- Вебхук
location.retail_prices.updatedповідомляє тебе, коли ціна змінюється.
retail_prices_view.Замовлення наборів для домашнього тесту в адмінпанелі
Тепер ти можеш замовити пацієнту набір для домашнього тесту на сторінці наборів для домашнього тесту в адмінпанелі. Вибери або створи пацієнта, обери набір і введи адресу доставки. Там ти також можеш скасувати набір.Тарифна сітка та розрахунок вартості
- Отримання тарифної сітки повертає твої тарифи в каталозі Aniva та твої збори.
- Розрахунок кошика розраховує ціни на панелі й біомаркери без запису.
- Рахунок у Розрахунку кошика та Попередньому перегляді запису тепер містить
fees,total_with_fees_centsіnameу кожному рядку біомаркера. rate_cardу списках приймаєidз Отримання тарифної сітки.
prices_view.Більше даних про документи
Кожен елемент уdocuments в Отриманні результатів тепер містить:file_name: назва, яку використовує Завантаження документа.- Нові:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, наприклад фінальний звіт Labor Quade
(_E) після попереднього (_V).Вебхуки
Aniva тепер звертається до твого сервера, коли змінюється запис, замовлення набору для домашнього тесту, його результати, локація, профіль або відправлення. Тобі більше не потрібно робити опитування.- Зареєструй HTTPS URL через
Створення вебхука. Тобі потрібен дозвіл
webhooks_manage. Попроси Aniva додати його до твого ключа або налаштувати вебхук за тебе. - Події охоплюють кожен статус запису й замовлення набору для домашнього тесту, новий час чи локацію та
кожну зміну результатів.
results.completedповідомляє, що результати остаточні. - Події
location.*,profile.*іshipment.*повідомляють, коли локація, профіль або відправлення з’являється, змінюється чи зникає. Відправлення також надсилаєshipment.<status>при кожній зміні статусу. - Події містять ідентифікатори й статуси, але ніколи не містять лабораторних показників чи персональних даних. Звернися за
urlу події, щоб отримати дані. - Кожен запит підписано за схемою Standard Webhooks.
- Aniva повторює невдалу доставку 10 разів протягом приблизно трьох днів. Ти можеш переглядати список доставок і надсилати їх повторно протягом 30 днів.
- Кожен результат в Отриманні результатів тепер має
id, тому ти можеш оновити результат, на який вказує подіяresults.updated. - Отримання локації повертає одну локацію за її
id. На неї вказуєurlподіїlocation.*.
Надіслати результати клієнту на пошту
Тепер ти можеш надіслати клієнту лист про те, що його лабораторні результати готові. Надішли його зі сторінки лабораторних результатів в адмінпанелі або через два нові ендпоїнти: Надсилання результатів на пошту для записів і Надсилання результатів на пошту для замовлень наборів для домашнього тесту.- До листа можна прикріпити лабораторні звіти як PDF-файли. Кожен PDF захищений паролем: пароль — це дата народження клієнта з 8 цифр (ДДММРРРР), і про це вказано в листі.
- Ти можеш додати особисту примітку до 1 000 символів.
- У ньому показано назву й логотип основної групи профілів для цього профілю, мовою профілю.
- Кожне надсилання — це один лист. Повторна спроба надсилає другий лист. Тобі потрібен дозвіл
results_viewдля цього клієнта.
Отримати лист, коли результати готові
Коли ти оформлюєш запис або замовляєш набір для домашнього тесту на заміну в адмінпанелі, ти можеш увімкнути «Надіслати мені лист, коли результати будуть готові». Тоді ми надішлемо один лист тобі або на будь-яку введену тобою адресу, щойно надійдуть усі лабораторні результати. У листі є посилання на результат в адмінпанелі. Клієнт не отримує цей лист. Тобі потрібен дозвілresults_view для цього клієнта.Через API ти можеш вказати до 5 адрес у results_ready_emails у
Створенні запису,
Створенні замовлення набору для домашнього тесту,
Оновленні запису та
Оновленні замовлення набору для домашнього тесту.Передавати телефон і пошту отримувача з кожним набором
Якщо вdelivery_address набору для домашнього тесту є phone або email, ми передаємо їх перевізнику.
Перевізник тоді повідомляє отримувача, коли посилка в дорозі або чекає в пункті видачі. Якщо ти
не вкажеш їх, перевізник не отримає контактів, навіть якщо вони є в профілі. Ти вирішуєш, хто отримує
сповіщення від перевізника. У сповіщенні відправником може бути вказано Aniva Health.Див. Створення замовлення набору для домашнього тесту.Aniva Berlin P-Berg (Mariposa), Потсдам, Мангайм і Вісбаден
Чотири нові локації для венозного забору крові. Див. Список локацій.Сторінка лабораторних результатів
Нова сторінка лабораторних результатів в адмінпанелі показує кожен забір крові та кожен активований набір для домашнього тесту з його лабораторними звітами. Шукай за ім’ям, датою народження або штрихкодом пробірки. Тобі потрібен дозвілresults_view, а щоб бачити набори — доступ до наборів для домашнього тесту.API-ключі лише для активації
Новий дозвілhome_kit_orders_activate дає ключу змогу лише активувати набори для домашнього тесту й нічого більше. Він не може
створювати, змінювати або скасовувати набір. Попроси в Aniva такий ключ, якщо твої набори активує окрема система.Див. Активація замовлення набору для домашнього тесту.Стать має бути чоловічою або жіночою
Створення профілю та Оновлення профілю більше не приймаютьsex: 0 (невідомо). Передавай 1 для чоловічої або 2
для жіночої статі; 0 повертає 400. Лабораторії потрібна стать для референтних діапазонів, а замовлення
для профілю без неї не могло потрапити до лабораторії.Див. Створення профілю.Набори, що надходять до лабораторії без активації
Якщо зразок надходить до лабораторії до активації набору, Aniva активує набір.activated_at — це ранок першої події відстеження зворотної посилки або ранок,
коли зразок надійшов до лабораторії, якщо відстеження немає. Подальший виклик активації з
іншим activated_at повертає 409.Див. Активація замовлення набору для домашнього тесту.Діапазони Aniva в результатах
Ендпоїнти результатів тепер заповнюютьreference_range_aniva порівняльними значеннями, які склала
Aniva, переведеними в одиницю вимірювання результату. Значення відрізняються залежно від віку, статі й тижня
вагітності. Твоєму ключу потрібен дозвіл ANIVA_REFERENCE_RANGES_VIEW. Без нього поле має значення null.Див. Отримання результатів запису.Набори на заміну
Замов заміну, якщо за набором не вдалося отримати всі результати. Заміна — це нове замовлення з новим лабораторним кодом, яке зберігає панель початкового замовлення.biomarker_ids визначає, що
лабораторія перевірить повторно.Див. Замовлення наборів для домашнього тесту.Одна ціна за біомаркер і панель
Біомаркери й панелі мають одне значенняprice_cents за твоєю тарифною сіткою, а поруч із ним —
retail_cents:> 0: можна замовити окремо.0: співвідношення (див.requires) або можна замовити лише з іншими маркерами (див.positions).null: не має ціни, тому не можна замовити.
groups[] видалено зі списків і попереднього перегляду запису. Поля
ціни retail і yours видалено.Див. Ціноутворення.Ключі ідемпотентності
Ендпоінти створення профілів, записів, замовлень наборів для домашнього тесту та відправлень приймають заголовокIdempotency-Key. Повторний запит із тим самим ключем повертає першу
відповідь і нічого не записує.Див. Ідемпотентність.
