Nazwy pojemników w podglądzie wizyty zmieniają się na nazwy produktów
Od następnego wydaniacontainers[].name w Podglądzie wizyty
będzie nazwą produktu probówki. type się nie zmienia, więc odczytuj type, jeśli twoja aplikacja porównuje pojemniki.Aniva działa teraz w każdym języku UE i jeszcze kilku
- Panel administratora, strona internetowa, centrum pomocy i dokumentacja: we wszystkich 32 językach.
- Profile: ustaw język każdego pacjenta. Strona z wynikami i e-maile z wynikami używają tego języka.
Jeden endpoint listy paneli
- Lista paneli zwraca teraz
biomarker_groups. Używaj tego endpointu zamiast/api/v2/panels. - Tworzenie panelu zostało usunięte. Użyj panelu administratora.
Wyświetlaj wyniki laboratoryjne w swojej aplikacji
Twoi pacjenci mogą teraz zobaczyć swoje wyniki laboratoryjne w twojej aplikacji: listę biomarkerów, trend każdego biomarkera oraz Twin 3D z oceną dla każdego obszaru zdrowia. Strona używa koloru twojej marki i twojego logo, w trybie jasnym lub ciemnym.Strona wyników jest płatnym dodatkiem, a twoja osoba kontaktowa w Aniva poda ci cenę. Tworzenie sesji osadzania pokazuje, jak ją skonfigurować.Odczyty list z API są buforowane do 5 minut
Te cztery endpointy buforują teraz odpowiedzi do 5 minut, więc wyświetlenie zmiany może potrwać do 5 minut:EndpointyGet nadal pokazują zmiany od razu.Jeśli odpytujesz API w poszukiwaniu zmian, użyj zamiast tego webhooków.
Webhook informuje cię o każdej zmianie, gdy tylko nastąpi. Zobacz
Wielokrotne odczyty.Zakresy Aniva są już dostępne
Twoje wyniki mogą teraz zawierać zakresy Aniva: zakres ogólny oraz węższy zakres dla każdego biomarkera wraz ze źródłami zapisanymi przez Aniva. Zakresy różnią się w zależności od wieku, płci i tygodnia ciąży.Aby uzyskać dostęp, podpisz krótką umowę dotyczącą zakresów Aniva. Następnie włączymy je dla twojego klucza API. Poproś swoją osobę kontaktową w Aniva o umowę.Zakresy znajdują się w nowym poluaniva_range. Zastępuje ono pole reference_range_aniva, które
zawsze miało wartość null. Zakresy to informacje ogólne. Nie stanowią oceny wyniku ani nie są
poradą medyczną ani wyrobem medycznym. Zakres laboratorium pozostaje standardem. Zobacz
Zakresy Aniva.Probówka fluorkowa to teraz fluoride
Podgląd pojemników nazywa probówkę fluorkową fluoride.
Poprzednia wartość to naf. Jeśli twój kod porównuje container.type z naf, zmień to na
fluoride.Mogą pojawić się dwie nowe wartości: lihep_capillary i fluoride_capillary. Są to probówka
kapilarna z heparyną litową oraz probówka kapilarna fluorkowa.Koniec z podwójnymi rezerwacjami ostatniego terminu
Jeśli dwie rezerwacje na ostatnie miejsce w danym terminie dotrą w tym samym czasie, powiedzie się tylko jedna. Druga otrzyma409, tak jak w przypadku każdego zajętego terminu. To samo dotyczy sytuacji, gdy wizyta jest zmieniana w trakcie
jej anulowania lub potwierdzania.Potwierdzenie pobrania krwi ma trzy nowe przyczyny kodu 409:remapped: kod odpowiada teraz innym panelom niż wcześniej.sent_to_labiorder_in_flight: laboratorium może już mieć to zlecenie, więc kod musi zostać na swojej probówce.
Bardziej rygorystyczna weryfikacja adresów dostawy w zamówieniach domowych zestawów testowych
Tworzenie domowego zestawu testowego i Aktualizacja domowego zestawu testowego bardziej rygorystycznie sprawdzajądelivery_address.country_codeakceptuje małe litery, np.de. Aniva zapisuje i zwraca go wielkimi literami.- Niemiecki adres (
DE) wymagapostal_codezłożonego z dokładnie 5 cyfr. Inne wartości zwracają400. - Spacje wokół
postal_codeusuwamy przed zapisaniem.
Nowy zestaw za zestaw odesłany do nas
Gdy przewoźnik odsyła do nas zestaw, nie czekamy już na paczkę. Daj nam znać, że znowu chcesz zestaw, a od razu wyślemy nowy. Możesz go też utworzyć samodzielnie: wywołaj Utwórz domowy zestaw testowy zreplaces_home_kit_order_id ustawionym na zwrócony zestaw. Nowy zestaw to osobne zamówienie z nowym
kodem zestawu.Sprawdzamy zwróconą paczkę, gdy do nas dotrze. Wtedy zwrócony zestaw zmienia status na cancelled,
a ty widzisz, co było w paczce.E-mail do zespołu, gdy wyniki są gotowe
Poproś nas o ustawienie domyślnego adresu e-mail dla twojej grupy profili, na przykład skrzynki zespołu. Na ten adres przyjdzie wtedy e-mail, gdy wyniki nowej rezerwacji będą gotowe. Dotyczy to rezerwacji z panelu administracyjnego, z API oraz od twoich pacjentów.Aby zmienić to dla jednej rezerwacji:- Panel administracyjny: edytuj adresy e-mail lub wyłącz opcję „Wyślij mi e-mail, gdy wyniki będą gotowe”.
- API: wyślij listę w
results_ready_emails, aby użyć tych adresów e-mail zamiast domyślnego. Aby zachować swój domyślny adres e-mail, uwzględnij go na liście. Wyślij[], aby nie wysyłać e-maila.
Pacjent podaje datę urodzenia i płeć
Możemy teraz pozwolić twojej grupie profili utworzyć profil bezdate_of_birth i sex.
Pacjent podaje obie te dane na stronie aktywacji zestawu, wpisując datę urodzenia dwa razy. Poproś
nas, abyśmy to włączyli. Zobacz Profile.Zestawy odesłane do nas
Gdy przewoźnik odsyła do nas zestaw, strona Domowe zestawy testowe teraz go wyświetla. Filtruj według Odesłane, aby zobaczyć każdy zestaw zwrócony do nas przez przewoźnika wraz z podanym przez niego powodem. Przesyłka kończy się statusemfault i wyzwala shipment.fault, już nie delivered. Gdy otworzymy
paczkę, zobaczysz też, co było w środku: kompletny, brakuje elementu lub otwarty. To pokazuje ci, czy
twój klient dostanie pełny zwrot pieniędzy.Chcesz, żebyśmy wysłali zestaw ponownie? Napisz do nas, podając kod zestawu i poprawny adres
dostawy. Wyślemy go z tym samym kodem zestawu.Jednostki logarytmiczne
Lista jednostek zwraca trzeciunit_type: logarithmic, dla wartości
będącej logarytmem wielkości, takiej jak pH lub wskaźnik aterogenności. Podczas wyświetlania traktuj
ją tak jak physical. Nie skaluj jej: dwie jednostki logarytmiczne różnią się przesunięciem, a nie
współczynnikiem.Wyceń domowy zestaw testowy wraz z opłatami
Wyceń koszyk przyjmujefulfilment. Wyślij home_kit z country_code,
a rachunek doda pozycje zestawu, które twoja miesięczna faktura nalicza za jedno zamówienie: opłatę za zestaw,
akcesoria do pobrania próbki, przesyłkę do tego kraju i z powrotem, obwolutę oraz zapasowy woreczek z
nakłuwaczami. Domyślnie pozostaje draw w lokalizacji z opłatami za wizytę. Odpowiedź wskazuje w
fulfilment.kind, który wariant został wyceniony.Poznaj Aniva Concierge
Od teraz nasza lista zmian pojawia się też na twoim kanale na Slacku z nami, od razu gdy coś wdrożymy.Stworzyliśmy też Aniva Concierge. Masz pytanie dotyczące API lub panelu administracyjnego? Oznacz @Aniva na Slacku albo po prostu odpowiedz pod postem z listy zmian. Sprawdzi naszą dokumentację i podpowie ci, gdzie kliknąć w panelu administracyjnym albo którego endpointu i filtrów użyć, wraz z linkiem do tej strony.Wyświetl wizyty z jednego dnia
Lista wizyt przyjmuje dwa nowe filtry.date
(YYYY-MM-DD) zwraca jeden dzień kalendarzowy w strefie czasowej lokalizacji każdej wizyty,
od najwcześniejszej. location_id zwraca jedną lokalizację badań. Użyj obu, aby uzyskać dzisiejszy
harmonogram lokalizacji.Duplikaty profili są odrzucane
Utwórz profil zwraca teraz409 z
error_name: "duplicate_profile_error", gdy profil widoczny dla twojego klucza ma takie samo imię,
nazwisko, płeć i datę urodzenia. Odpowiedź podaje istniejący profile_id. Użyj go zamiast
tworzyć drugi profil. Nazwiska ze środowiska sandbox są z tego wyłączone.Katalog badań z twoimi cenami
Nowy Katalog badań w panelu administracyjnym zawiera każdy biomarker wraz z jego laboratoriami, probówkami i ceną z twojego cennika.Dlaczego wynik nie ma zakresu laboratoryjnego
Każdy wynik kliniczny w Pobierz wyniki i Pobierz wyniki laboratoryjne dla domowych zestawów testowych ma terazreference_range_lab_absent_reason. Wskazuje, dlaczego reference_range_lab ma wartość null:not_provided: nie istnieje żaden zakres. Wyświetl „Nie dotyczy”.lab_text_only: laboratorium podało wyłącznie tekst, np. wartość docelową lub poziom ryzyka. Wyświetllab_reported.reference_range.not_measured: wynik ma statusundeliverable.
null, gdy zakres jest dostępny. Zobacz Wyniki.Ceny detaliczne i współrzędne
- Lokalizacje mają teraz
state_code,latitudeilongitude. - Lista cen detalicznych i Pobierz ceny detaliczne zwracają cenę każdego panelu, który apteka sprzedaje klientom bez rezerwacji.
- Webhook
location.retail_prices.updatedinformuje cię, gdy zmieni się cena.
retail_prices_view.Zamawiaj domowe zestawy testowe w panelu administracyjnym
Możesz teraz zamówić domowy zestaw testowy dla swojego pacjenta na stronie Domowe zestawy testowe w panelu administracyjnym. Wybierz lub utwórz pacjenta, wybierz zestaw i wpisz adres dostawy. Możesz tam też anulować zestaw.Cennik i wyceny
- Pobierz cennik zwraca twoje stawki w katalogu Aniva oraz twoje opłaty.
- Wyceń koszyk oblicza ceny paneli i biomarkerów bez wizyty.
- Rachunek w Wyceń koszyk i Podgląd wizyty zawiera teraz
fees,total_with_fees_centsoraznamew każdym wierszu biomarkera. rate_cardna listach przyjmujeidz Pobierz cennik.
prices_view.Więcej szczegółów dokumentów
Każdy wpis wdocuments w Pobierz wyniki zawiera teraz:file_name: nazwa używana przez Pobierz dokument.- Nowe:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, na przykład końcowy raport Labor Quade
(_E) po raporcie wstępnym (_V).Webhooki
Aniva wywołuje teraz twój serwer, gdy zmieni się wizyta, zamówienie domowego zestawu testowego, jego wyniki, lokalizacja, profil lub przesyłka. Nie musisz już odpytywać API.- Zarejestruj adres URL HTTPS przez
Utwórz webhook. Potrzebujesz zakresu
webhooks_manage. Poproś Aniva o dodanie go do twojego klucza lub o skonfigurowanie webhooka za ciebie. - Zdarzenia obejmują każdy status wizyty i zamówienia domowego zestawu testowego, nowy termin lub lokalizację oraz
każdą zmianę wyników.
results.completedinformuje, że wyniki są ostateczne. - Zdarzenia
location.*,profile.*ishipment.*informują, gdy lokalizacja, profil lub przesyłka pojawi się, zmieni lub zniknie. Przesyłka wysyła teżshipment.<status>przy każdej zmianie statusu. - Zdarzenia zawierają identyfikatory i statusy, nigdy wartości laboratoryjnych ani danych osobowych. Odczytaj
urlze zdarzenia, aby pobrać dane. - Każde żądanie jest podpisane zgodnie ze schematem Standard Webhooks.
- Aniva ponawia nieudane dostarczenie 10 razy w ciągu około trzech dni. Możesz wyświetlać i ponownie wysyłać dostarczenia przez 30 dni.
- Każdy wynik w Pobierz wyniki ma teraz
id, dzięki czemu możesz zaktualizować wynik, na który wskazuje zdarzenieresults.updated. - Pobierz lokalizację zwraca jedną lokalizację według jej
id. Wskazuje na niąurlze zdarzenialocation.*.
Wyślij wyniki e-mailem do klienta
Możesz teraz wysłać klientowi e-mail z informacją, że wyniki badań są gotowe. Wyślij go ze strony wyników badań w panelu administracyjnym lub przez dwa nowe endpointy: Wyślij wyniki e-mailem dla wizyt i Wyślij wyniki e-mailem dla zamówień domowych zestawów testowych.- Do e-maila można dołączyć raporty laboratoryjne jako pliki PDF. Każdy plik PDF jest chroniony hasłem: to data urodzenia klienta w formacie 8 cyfr (DDMMRRRR), o czym informuje e-mail.
- Możesz dodać osobistą notatkę o długości maksymalnie 1 000 znaków.
- E-mail wyświetla nazwę i logo głównej grupy profili tego profilu, w języku profilu.
- Każde wysłanie to jeden e-mail. Ponowna próba wysyła drugi. Potrzebujesz zakresu
results_viewdla tego klienta.
Otrzymuj e-mail, gdy wyniki będą gotowe
Gdy rezerwujesz wizytę lub zamawiasz zastępczy domowy zestaw testowy w panelu administracyjnym, możesz włączyć opcję „Wyślij mi e-mail, gdy wyniki będą gotowe”. Wyślemy wtedy jeden e-mail do ciebie lub na dowolny wpisany adres, gdy wszystkie wyniki badań będą dostępne. E-mail zawiera link do wyniku w panelu administracyjnym. Klient nie otrzymuje tego e-maila. Potrzebujesz zakresuresults_view dla tego klienta.Przez API możesz ustawić do 5 adresów w results_ready_emails w
Utwórz wizytę,
Utwórz zamówienie domowego zestawu testowego,
Zaktualizuj wizytę i
Zaktualizuj zamówienie domowego zestawu testowego.Wysyłaj telefon i e-mail odbiorcy z każdym zestawem
Jeślidelivery_address domowego zestawu testowego zawiera phone lub email, przekazujemy je przewoźnikowi.
Przewoźnik informuje wtedy odbiorcę, gdy paczka jest w drodze lub czeka w punkcie odbioru. Jeśli je
pominiesz, przewoźnik nie otrzyma danych kontaktowych, nawet jeśli są w profilu. To ty decydujesz, kto otrzymuje
powiadomienia od przewoźnika. Powiadomienie może wskazywać Aniva Health jako nadawcę.Zobacz Utwórz zamówienie domowego zestawu testowego.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim i Wiesbaden
Cztery nowe lokalizacje żylnych pobrań krwi. Zobacz Lista lokalizacji.Strona wyników badań
Nowa strona wyników badań w panelu administracyjnym wyświetla każde pobranie krwi i każdy aktywowany domowy zestaw testowy wraz z raportami laboratoryjnymi. Wyszukuj według imienia i nazwiska, daty urodzenia lub kodu kreskowego probówki. Potrzebujesz zakresuresults_view oraz uprawnienia do domowych zestawów testowych, aby widzieć zestawy.Klucze API tylko do aktywacji
Nowy zakreshome_kit_orders_activate pozwala kluczowi aktywować domowe zestawy testowe i nic poza tym. Nie może on
utworzyć, zmienić ani anulować zestawu. Poproś Aniva o taki klucz, jeśli twoje zestawy aktywuje osobny system.Zobacz Aktywuj zamówienie domowego zestawu testowego.Płeć musi być męska lub żeńska
Utwórz profil i Zaktualizuj profil nie akceptują jużsex: 0 (nieznana). Wyślij 1 dla płci męskiej lub 2
dla żeńskiej; 0 zwraca 400. Laboratorium potrzebuje płci do zakresów referencyjnych, a zamówienie
dla profilu bez niej nie mogło dotrzeć do laboratorium.Zobacz Utwórz profil.Zestawy, które docierają do laboratorium bez aktywacji
Jeśli próbka dotrze do laboratorium przed aktywacją zestawu, Aniva aktywuje zestaw.activated_at to poranek pierwszego zdarzenia śledzenia przesyłki zwrotnej lub poranek,
kiedy próbka dotarła do laboratorium, jeśli nie ma śledzenia. Późniejsze wywołanie aktywacji z
innym activated_at zwraca 409.Zobacz Aktywuj zamówienie domowego zestawu testowego.Zakresy Aniva w wynikach
Endpointy wyników wypełniają terazreference_range_aniva wartościami porównawczymi opracowanymi
przez Aniva, przeliczonymi na jednostkę wyniku. Wartości różnią się w zależności od wieku, płci i tygodnia
ciąży. Twój klucz wymaga zakresu ANIVA_REFERENCE_RANGES_VIEW. Bez niego pole ma wartość null.Zobacz Pobierz wyniki wizyty.Zestawy zastępcze
Zamów zestaw zastępczy, gdy zestaw nie mógł dostarczyć wszystkich wyników. Zestaw zastępczy to nowe zamówienie z nowym kodem laboratoryjnym, które zachowuje panel pierwotnego zamówienia.biomarker_ids określa, co
laboratorium zbada ponownie.Zobacz Zamówienia domowych zestawów testowych.Jedna cena za biomarker i panel
Biomarkery i panele mają jedną wartośćprice_cents według twojego cennika, z retail_cents obok
niej:> 0: można zamówić osobno.0: współczynnik (zobaczrequires) lub można zamówić tylko z innymi markerami (zobaczpositions).null: brak ceny, więc nie można zamówić.
groups[] zostało usunięte z list i z podglądu wizyty. Pola cenowe
retail i yours zostały usunięte.Zobacz Cennik.Klucze idempotencji
Endpointy tworzenia profili, wizyt, zamówień domowych zestawów testowych i przesyłek akceptują nagłówekIdempotency-Key. Ponowienie żądania z tym samym kluczem zwraca pierwszą odpowiedź i nic
nie zapisuje.Zobacz Idempotencja.
