Przejdź do głównej treści
API

Nazwy pojemników w podglądzie wizyty zmieniają się na nazwy produktów

Od następnego wydania containers[].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.
Panel administratoraAPI

Aniva działa teraz w każdym języku UE i jeszcze kilku

API

Jeden endpoint listy paneli

API

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ć.
API

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:Endpointy Get 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.
Panel administratora

Sprawdź, kiedy kurier przyjedzie po twoje próbki

Panel administratora pokazuje teraz najbliższy odbiór kurierski w twoim gabinecie, wraz ze śledzeniem i etykietą.Panel administratora z banerem na górze: GO! przyjedzie jutro ~10:00–12:00.Panel administratora z banerem na górze: GO! przyjedzie jutro ~10:00–12:00.
API

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 polu aniva_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.
API

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.
API

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 otrzyma 409, 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_lab i order_in_flight: laboratorium może już mieć to zlecenie, więc kod musi zostać na swojej probówce.
APIDomowe zestawy testowe

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_code akceptuje małe litery, np. de. Aniva zapisuje i zwraca go wielkimi literami.
  • Niemiecki adres (DE) wymaga postal_code złożonego z dokładnie 5 cyfr. Inne wartości zwracają 400.
  • Spacje wokół postal_code usuwamy przed zapisaniem.
Panel administracyjnyDomowe zestawy testoweAPI

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 z replaces_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.
WynikiAPIPanel administracyjny

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.
Zobacz E-maile o gotowych wynikach.
APIDomowe zestawy testowe

Pacjent podaje datę urodzenia i płeć

Możemy teraz pozwolić twojej grupie profili utworzyć profil bez date_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.
Panel administracyjny

Szybszy panel administracyjny

Panel administracyjny wyświetla teraz pierwszą treść w około 0,2 s zamiast 1,3 s. Koniec ze wskaźnikami ładowania. Strony wypełniają się w miarę napływania danych. Strony zaczynają się ładować, gdy najedziesz kursorem na link.
Panel administracyjnyDomowe zestawy testoweWebhooki

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ę statusem fault 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.
API

Jednostki logarytmiczne

Lista jednostek zwraca trzeci unit_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.
APICennik

Wyceń domowy zestaw testowy wraz z opłatami

Wyceń koszyk przyjmuje fulfilment. 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.
Concierge

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.
APIWizyty

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.
APIProfile

Duplikaty profili są odrzucane

Utwórz profil zwraca teraz 409 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.
Lokalizacje

Zamknięcie Aniva Berlin Mitte

Od 1 listopada 2026 Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) nie oferuje już wizyt. Najbliższa lokalizacja to Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Panel administracyjnyCennik

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.
APIWyniki

Dlaczego wynik nie ma zakresu laboratoryjnego

Każdy wynik kliniczny w Pobierz wyniki i Pobierz wyniki laboratoryjne dla domowych zestawów testowych ma teraz reference_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świetl lab_reported.reference_range.
  • not_measured: wynik ma status undeliverable.
Ma wartość null, gdy zakres jest dostępny. Zobacz Wyniki.
APILokalizacje

Ceny detaliczne i współrzędne

  • Lokalizacje mają teraz state_code, latitude i longitude.
  • Lista cen detalicznych i Pobierz ceny detaliczne zwracają cenę każdego panelu, który apteka sprzedaje klientom bez rezerwacji.
  • Webhook location.retail_prices.updated informuje cię, gdy zmieni się cena.
Endpointy i zdarzenie dotyczące cen detalicznych wymagają zakresu uprawnień retail_prices_view.
Domowe zestawy testowePanel administracyjny

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.
APICennik

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_cents oraz name w każdym wierszu biomarkera.
  • rate_card na listach przyjmuje id z Pobierz cennik.
Oba nowe endpointy wymagają zakresu prices_view.
APIWyniki

Więcej szczegółów dokumentów

Każdy wpis w documents w Pobierz wyniki zawiera teraz:
  • file_name: nazwa używana przez Pobierz dokument.
  • Nowe: original_file_name, origin, content_type, etag, size_bytes.
Zastąpiony raport PDF wysyła teraz results.updated, na przykład końcowy raport Labor Quade (_E) po raporcie wstępnym (_V).
APIWebhooki

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.completed informuje, że wyniki są ostateczne.
  • Zdarzenia location.*, profile.* i shipment.* 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 url ze 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 zdarzenie results.updated.
  • Pobierz lokalizację zwraca jedną lokalizację według jej id. Wskazuje na nią url ze zdarzenia location.*.
Zobacz Webhooki.
WynikiPanel administracyjny

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_view dla 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 zakresu results_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.
Domowe zestawy testowe

Wysyłaj telefon i e-mail odbiorcy z każdym zestawem

Jeśli delivery_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.
Lokalizacje

Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim i Wiesbaden

Cztery nowe lokalizacje żylnych pobrań krwi. Zobacz Lista lokalizacji.
Panel administracyjny

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 zakresu results_view oraz uprawnienia do domowych zestawów testowych, aby widzieć zestawy.
Domowe zestawy testowe

Klucze API tylko do aktywacji

Nowy zakres home_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.
APIZmiana niekompatybilna

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.
Domowe zestawy testowe

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.
API

Zakresy Aniva w wynikach

Endpointy wyników wypełniają teraz reference_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.
APIDomowe zestawy testowe

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.
APICennikZmiana niekompatybilna

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 (zobacz requires) lub można zamówić tylko z innymi markerami (zobacz positions).
  • null: brak ceny, więc nie można zamówić.
Zmiana niekompatybilna: groups[] zostało usunięte z list i z podglądu wizyty. Pola cenowe retail i yours zostały usunięte.Zobacz Cennik.
API

Klucze idempotencji

Endpointy tworzenia profili, wizyt, zamówień domowych zestawów testowych i przesyłek akceptują nagłówek Idempotency-Key. Ponowienie żądania z tym samym kluczem zwraca pierwszą odpowiedź i nic nie zapisuje.Zobacz Idempotencja.
Lokalizacje

Aniva Hannover, Düsseldorf, Duisburg i Essen

Cztery nowe lokalizacje Aniva w Niemczech są otwarte na pobrania krwi żylnej: Hannover, Düsseldorf, Duisburg i Essen. Wywołaj Pobierz listę lokalizacji, aby zobaczyć lokalizacje, w których twój klucz może rezerwować.