Přejít na hlavní obsah
API

Názvy nádobek v náhledu termínu se mění na produktové názvy

Od příštího vydání bude containers[].name v Náhledu termínu produktovým názvem zkumavky. type se nemění, takže čti type, pokud tvá aplikace porovnává nádobky.
Admin panelAPI

Aniva teď funguje ve všech jazycích EU a v několika dalších

API

Jeden endpoint List Panels

  • List Panels teď vrací biomarker_groups. Používej ho místo /api/v2/panels.
  • Create Panel byl odstraněn. Používej Admin panel.
API

Zobrazuj laboratorní výsledky ve své aplikaci

Tvoji pacienti si teď můžou prohlédnout své laboratorní výsledky v tvé aplikaci: seznam biomarkerů, trend každého biomarkeru a 3D Twin se známkou pro každou oblast zdraví. Stránka používá barvu tvé značky a tvé logo, ve světlém nebo tmavém režimu.Stránka s výsledky je placený doplněk a cenu ti řekne tvůj kontakt v Anivě. Create Embed Session ukazuje, jak ji nastavit.
API

Čtení z List API se ukládají do mezipaměti až na 5 minut

Tyto čtyři endpointy teď ukládají svou odpověď do mezipaměti až na 5 minut, takže zobrazení změny může trvat až 5 minut:Endpointy Get stále zobrazují změny přímo.Pokud se na změny v API opakovaně dotazuješ, použij raději webhooky. Webhook ti dá vědět o každé změně, jakmile nastane. Podívej se na Opakovaná čtení.
Admin panel

Podívej se, kdy kurýr přijede pro tvé vzorky

Admin panel teď zobrazuje další vyzvednutí kurýrem v tvé ordinaci, včetně sledování a štítku.Admin panel s bannerem nahoře: GO! přijede zítra ~10:00–12:00.Admin panel s bannerem nahoře: GO! přijede zítra ~10:00–12:00.
API

Rozmezí Aniva jsou teď k dispozici

Tvé výsledky teď můžou obsahovat rozmezí Aniva: obecné rozmezí a užší rozmezí pro každý biomarker, včetně zdrojů, které Aniva zaznamenala. Rozmezí se liší podle věku, pohlaví a týdne těhotenství.Pro získání přístupu podepiš krátkou dohodu o rozmezích Aniva. Potom je zapneme pro tvůj API klíč. O dohodu požádej svůj kontakt v Anivě.Rozmezí jsou v novém poli aniva_range. Nahrazuje reference_range_aniva, které bylo vždy null. Rozmezí slouží jako obecné informace. Nehodnotí výsledek a nejsou lékařskou radou ani zdravotnickým prostředkem. Rozmezí laboratoře zůstává standardem. Podívej se na Rozmezí Aniva.
API

Fluoridová zkumavka je teď fluoride

Preview Containers označuje fluoridovou zkumavku jako fluoride. Stará hodnota byla naf. Pokud tvůj kód porovnává container.type s naf, změň ji na fluoride.Můžou se objevit dvě nové hodnoty: lihep_capillary a fluoride_capillary. Jsou to kapilární zkumavka s lithium-heparinem a kapilární fluoridová zkumavka.
API

Už žádné dvojité rezervace posledního slotu

Pokud najednou dorazí dvě rezervace na poslední místo ve slotu, uspěje jen jedna. Druhá dostane 409, stejně jako u každého plného slotu. Totéž platí, když se termín změní ve chvíli, kdy se ruší nebo potvrzuje.Confirm Blood Draw má tři nové důvody pro 409:
  • remapped: kód se teď mapuje na jiné panely než dřív.
  • sent_to_lab a order_in_flight: laboratoř už objednávku může mít, takže kód musí zůstat na své zkumavce.
APIDomácí testovací sady

Přísnější doručovací adresy u objednávek domácích testovacích sad

Create Home Kit a Update Home Kit přísněji kontrolují delivery_address.
  • country_code přijímá malá písmena, např. de. Aniva ho ukládá a vrací velkými písmeny.
  • Německá adresa (DE) vyžaduje postal_code s přesně 5 číslicemi. Jiné hodnoty vrátí 400.
  • Mezery kolem postal_code před uložením odstraníme.
Admin panelDomácí testovací sadyAPI

Nová sada za sadu vrácenou k nám

Když nám dopravce sadu vrátí, už na krabici nečekáme. Dej nám vědět, že sadu chceš znovu, a hned pošleme novou. Můžeš ji vytvořit i přímo: zavolej Vytvořit domácí testovací sadu s replaces_home_kit_order_id nastaveným na vrácenou sadu. Nová sada je samostatná objednávka s novým kódem sady.Vrácenou krabici po doručení zkontrolujeme. Vrácená sada se pak změní na cancelled a uvidíš, co v krabici bylo.
VýsledkyAPIAdmin panel

E-mail týmu, když jsou výsledky připravené

Požádej nás o nastavení výchozí e-mailové adresy pro tvou skupinu profilů, například týmové schránky. Na tuto adresu pak přijde e-mail, jakmile jsou výsledky nové rezervace připravené. Platí to pro rezervace z admin panelu, z API i od tvých pacientů.Pro změnu u jedné rezervace:
  • Admin panel: uprav e-mailové adresy, nebo vypni „Poslat mi e-mail, až budou výsledky připravené“.
  • API: pošli seznam v results_ready_emails, aby se místo toho použily tyto e-mailové adresy. Pokud chceš zachovat výchozí e-mailovou adresu, přidej ji do seznamu. Pokud nechceš žádný e-mail, pošli [].
Viz E-maily o připravených výsledcích.
APIDomácí testovací sady

Pacient zadává datum narození a pohlaví

Tvé skupině profilů teď můžeme povolit vytvořit profil bez date_of_birth a sex. Pacient zadá oba údaje na stránce pro aktivaci sady, přičemž datum narození napíše dvakrát. Požádej nás o zapnutí. Viz Profily.
Admin panel

Rychlejší admin panel

Admin panel teď zobrazí první obsah zhruba za 0,2 s místo 1,3 s. Už žádná načítací kolečka. Stránky se doplňují postupně, jak přicházejí data. Stránky se začnou načítat, jakmile najedeš na odkaz.
Admin panelDomácí testovací sadyWebhooky

Sady vrácené k nám

Když nám dopravce sadu vrátí, nově se zobrazí na stránce Domácí testovací sady. Filtruj podle Vráceno zpět a uvidíš všechny sady, které nám dopravce vrátil, včetně jeho důvodu. Zásilka skončí ve stavu fault a spustí shipment.fault, už ne delivered. Jakmile krabici otevřeme, uvidíš také, co v ní bylo: kompletní, chybí část, nebo otevřená. Podle toho poznáš, jestli tvůj zákazník dostane plné vrácení peněz.Chceš, abychom sadu poslali znovu? Napiš nám kód sady a správnou doručovací adresu. Pošleme ji se stejným kódem sady.
API

Logaritmické jednotky

Vypsat jednotky vrací třetí unit_type: logarithmic, pro hodnotu, která je logaritmem veličiny, například pH nebo aterogenního indexu. Při zobrazení s ní zacházej jako s physical. Neškáluj ji: dvě logaritmické jednotky se liší posunem, ne koeficientem.
APICeny

Nacenění domácí testovací sady včetně poplatků

Nacenit košík přijímá fulfilment. Pošli home_kit s country_code a rozpis ceny přidá položky sady, které měsíční faktura účtuje za jednu objednávku: poplatek za sadu, odběrové pomůcky, poštovné do dané země a zpět, přebal a sáček s náhradními lancetami. Výchozí možností zůstává draw na odběrovém místě s poplatky za termín. Odpověď v fulfilment.kind uvádí, kterou možnost nacenila.
Concierge

Poznej Aniva Concierge

Odteď se náš changelog zobrazí i v našem společném kanálu na Slacku, jakmile něco vydáme.Vytvořili jsme také Aniva Concierge. Máš otázku k API nebo admin panelu? Zmiň @Aniva na Slacku, nebo prostě odpověz pod příspěvkem v changelogu. Projde naši dokumentaci a poradí ti, kam kliknout v admin panelu, nebo jaký endpoint a filtry použít, včetně odkazu na stránku.
APITermíny

Výpis termínů za jeden den

Vypsat termíny přijímá dva nové filtry. date (YYYY-MM-DD) vrátí jeden kalendářní den v časovém pásmu odběrového místa daného termínu, od nejčasnějšího. location_id vrátí jedno odběrové místo. Použij oba pro dnešní rozvrh odběrového místa.
APIProfily

Duplicitní profily se zamítají

Vytvořit profil teď vrací 409 s error_name: "duplicate_profile_error", pokud profil viditelný tvým klíčem má stejné jméno, příjmení, pohlaví a datum narození. Odpověď uvádí existující profile_id. Použij ho místo vytváření druhého profilu. Příjmení v sandboxu mají výjimku.
Odběrová místa

Aniva Berlin Mitte zavírá

Od 1. listopadu 2026 už Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) nenabízí termíny. Nejbližší odběrové místo je Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Admin panelCeny

Katalog testů s tvými cenami

Nový Katalog testů v admin panelu uvádí každý biomarker včetně jeho laboratoří, zkumavek a ceny z tvého ceníku.
APIVýsledky

Proč výsledek nemá laboratorní rozmezí

Každý klinický výsledek v Získat výsledky a Získat laboratorní výsledky pro domácí testovací sady teď obsahuje reference_range_lab_absent_reason. Udává, proč je reference_range_lab null:
  • not_provided: žádné rozmezí neexistuje. Zobraz „Nevztahuje se“.
  • lab_text_only: laboratoř uvedla pouze text, například cílovou hodnotu nebo stupeň rizika. Zobraz lab_reported.reference_range.
  • not_measured: výsledek je undeliverable.
Když rozmezí existuje, hodnota je null. Viz Výsledky.
APIOdběrová místa

Maloobchodní ceny a souřadnice

Endpointy a událost pro maloobchodní ceny vyžadují scope retail_prices_view.
Domácí testovací sadyAdmin panel

Objednávání domácích testovacích sad v admin panelu

Domácí testovací sadu teď můžeš pro svého pacienta objednat na stránce Domácí testovací sady v admin panelu. Vyber nebo vytvoř pacienta, vyber sadu a zadej doručovací adresu. Sadu tam můžeš také zrušit.
APICeny

Ceník a kalkulace

  • Získat ceník vrací tvé sazby v katalogu Aniva a tvé poplatky.
  • Ocenit košík ocení panely a biomarkery bez termínu.
  • Vyúčtování v Ocenit košík a Náhled termínu nově obsahuje fees, total_with_fees_cents a name na každém řádku biomarkeru.
  • rate_card ve výpisech přijímá id ze Získat ceník.
Oba nové endpointy vyžadují scope prices_view.
APIVýsledky

Více údajů o dokumentech

Každá položka v documents u Získat výsledky nově obsahuje:
  • file_name: název, který používá Stáhnout dokument.
  • Nově: original_file_name, origin, content_type, etag, size_bytes.
Nahrazené PDF se zprávou nově posílá results.updated, například konečná zpráva Labor Quade (_E) po předběžné (_V).
APIWebhooky

Webhooky

Aniva nově zavolá tvůj server, když se změní termín, objednávka domácí testovací sady, její výsledky, pobočka, profil nebo zásilka. Už se nemusíš opakovaně dotazovat.
  • Zaregistruj HTTPS URL přes Vytvořit webhook. Potřebuješ scope webhooks_manage. Požádej Anivu, aby ho přidala k tvému klíči, nebo aby webhook nastavila za tebe.
  • Události pokrývají každý stav termínu i objednávky domácí testovací sady, nový čas nebo pobočku a každou změnu výsledků. results.completed ti dá vědět, že jsou výsledky konečné.
  • Události location.*, profile.* a shipment.* hlásí, když se pobočka, profil nebo zásilka objeví, změní nebo zmizí. Zásilka při každé změně stavu pošle také shipment.<status>.
  • Události nesou ID a stavy, nikdy laboratorní hodnoty ani osobní údaje. Data získáš z url v události.
  • Každý požadavek je podepsán podle schématu Standard Webhooks.
  • Neúspěšné doručení Aniva zopakuje 10krát během zhruba tří dní. Doručení můžeš zobrazit a znovu odeslat po dobu 30 dní.
  • Každý výsledek v Získat výsledky má nově id, takže můžeš aktualizovat výsledek, na který událost results.updated odkazuje.
  • Získat pobočku vrací jednu pobočku podle jejího id. Odkazuje na ni url události location.*.
Viz Webhooky.
VýsledkyAdmin panel

Poslat výsledky zákazníkovi e-mailem

Nově můžeš zákazníkovi poslat e-mail, že jsou jeho laboratorní výsledky hotové. Odešleš ho ze stránky Laboratorní výsledky v admin panelu, nebo přes dva nové endpointy: Poslat výsledky e-mailem pro termíny a Poslat výsledky e-mailem pro objednávky domácích testovacích sad.
  • E-mail může mít v příloze laboratorní zprávy jako soubory PDF. Každé PDF je chráněné heslem: heslem je datum narození zákazníka jako 8 číslic (DDMMYYYY) a e-mail to uvádí.
  • Můžeš přidat osobní poznámku o délce nejvýše 1 000 znaků.
  • Zobrazuje název a logo primární profilové skupiny profilu, a to v jazyce profilu.
  • Každé odeslání je jeden e-mail. Opakovaný pokus odešle druhý. Potřebuješ scope results_view pro daného zákazníka.

Dostat e-mail, až budou výsledky hotové

Když v admin panelu rezervuješ termín nebo objednáš náhradní domácí testovací sadu, můžeš zapnout „Poslat mi e-mail, až budou výsledky hotové“. Jakmile dorazí všechny laboratorní výsledky, pošleme jeden e-mail tobě nebo na libovolnou zadanou adresu. E-mail odkazuje na výsledek v admin panelu. Zákazník tento e-mail nedostane. Pro daného zákazníka potřebuješ scope results_view.Přes API můžeš nastavit až 5 adres v results_ready_emails u Vytvořit termín, Vytvořit objednávku domácí testovací sady, Upravit termín a Upravit objednávku domácí testovací sady.
Domácí testovací sady

Poslat telefon a e-mail příjemce u každé sady

Pokud delivery_address domácí testovací sady obsahuje phone nebo email, předáme je dopravci. Dopravce pak příjemci dá vědět, když je balík na cestě nebo čeká na výdejním místě. Pokud je vynecháš, dopravce nedostane žádný kontakt, ani když je uvedený v profilu. Rozhoduješ, kdo oznámení od dopravce dostane. V oznámení může být jako odesílatel uvedena Aniva Health.Viz Vytvořit objednávku domácí testovací sady.
Pobočky

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

Čtyři nové pobočky pro odběry žilní krve. Viz Seznam poboček.
Admin panel

Stránka Laboratorní výsledky

Nová stránka Laboratorní výsledky v admin panelu vypisuje každý odběr krve a každou aktivovanou domácí testovací sadu včetně laboratorních zpráv. Hledej podle jména, data narození nebo čárového kódu zkumavky. Potřebuješ scope results_view a pro zobrazení sad také oprávnění pro domácí testovací sady.
Domácí testovací sady

API klíče jen pro aktivaci

Nový scope home_kit_orders_activate umožňuje klíči pouze aktivovat domácí testovací sady a nic jiného. Nemůže sadu vytvořit, změnit ani zrušit. Požádej Anivu o takový klíč, pokud tvé sady aktivuje samostatný systém.Viz Aktivovat objednávku domácí testovací sady.
APIZásadní změna

Pohlaví musí být muž nebo žena

Vytvořit profil a Upravit profil už nepřijímají sex: 0 (neznámé). Posílej 1 pro muže nebo 2 pro ženu; 0 vrací 400. Laboratoř potřebuje pohlaví pro referenční rozmezí a objednávka pro profil bez něj se nemohla dostat do laboratoře.Viz Vytvořit profil.
Domácí testovací sady

Sady, které dorazí do laboratoře bez aktivace

Pokud vzorek dorazí do laboratoře dříve, než je sada aktivována, Aniva sadu aktivuje. activated_at je ráno prvního záznamu sledování zpětné zásilky, nebo ráno, kdy vzorek dorazil do laboratoře, pokud sledování chybí. Pozdější volání aktivace s jiným activated_at vrací 409.Viz Aktivovat objednávku domácí testovací sady.
API

Rozmezí Aniva ve výsledcích

Endpointy pro výsledky nově vyplňují reference_range_aniva srovnávacími hodnotami, které sestavila Aniva, převedenými na jednotku výsledku. Hodnoty se liší podle věku, pohlaví a týdne těhotenství. Tvůj klíč potřebuje scope ANIVA_REFERENCE_RANGES_VIEW. Bez něj je pole null.Viz Získat výsledky termínu.
APIDomácí testovací sady

Náhradní sady

Objednej náhradu, když sada nemohla dodat všechny výsledky. Náhrada je nová objednávka s novým laboratorním kódem a ponechává si panel z původní objednávky. biomarker_ids určuje, co laboratoř znovu otestuje.Viz Objednávky domácích testovacích sad.
APICenyZásadní změna

Jedna cena za biomarker a panel

Biomarkery a panely mají jednu cenu price_cents podle tvého ceníku a vedle ní retail_cents:
  • > 0: lze objednat samostatně.
  • 0: poměr (viz requires), nebo lze objednat jen s dalšími markery (viz positions).
  • null: bez ceny, takže nelze objednat.
Nekompatibilní změna: groups[] je odstraněno z výpisů i z náhledu termínu. Cenová pole retail a yours jsou odstraněna.Viz Ceny.
API

Idempotenční klíče

Endpointy pro vytváření profilů, termínů, objednávek domácích testovacích sad a zásilek přijímají hlavičku Idempotency-Key. Opakovaný požadavek se stejným klíčem vrátí první odpověď a nic nezapíše.Viz Idempotence.
Odběrová místa

Aniva Hannover, Düsseldorf, Duisburg a Essen

Čtyři nová odběrová místa Aniva v Německu jsou otevřená pro žilní odběry krve: Hannover, Düsseldorf, Duisburg a Essen. Zavolej Vypsat odběrová místa a zobraz si místa, která může tvůj klíč rezervovat.