Názvy nádobek v náhledu termínu se mění na produktové názvy
Od příštího vydání budecontainers[].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.Aniva teď funguje ve všech jazycích EU a v několika dalších
- Admin panel, web, centrum nápovědy a dokumentace: ve všech 32 jazycích.
- Profily: nastav jazyk každého pacienta. Stránka s výsledky a e-maily s výsledky se podle něj řídí.
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.
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.Č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:EndpointyGet 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í.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 polianiva_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.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.Už žádné dvojité rezervace posledního slotu
Pokud najednou dorazí dvě rezervace na poslední místo ve slotu, uspěje jen jedna. Druhá dostane409, 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_labaorder_in_flight: laboratoř už objednávku může mít, takže kód musí zůstat na své zkumavce.
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_codepřijímá malá písmena, např.de. Aniva ho ukládá a vrací velkými písmeny.- Německá adresa (
DE) vyžadujepostal_codes přesně 5 číslicemi. Jiné hodnoty vrátí400. - Mezery kolem
postal_codepřed uložením odstraníme.
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 sreplaces_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.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[].
Pacient zadává datum narození a pohlaví
Tvé skupině profilů teď můžeme povolit vytvořit profil bezdate_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.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 stavufault 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.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.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.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.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.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.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.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ď obsahujereference_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. Zobrazlab_reported.reference_range.not_measured: výsledek jeundeliverable.
null. Viz Výsledky.Maloobchodní ceny a souřadnice
- Odběrová místa teď mají
state_code,latitudealongitude. - Vypsat maloobchodní ceny a Získat maloobchodní ceny vracejí cenu každého panelu, který lékárna prodává příchozím zákazníkům.
- Webhook
location.retail_prices.updatedtě upozorní, když se cena změní.
retail_prices_view.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.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_centsanamena každém řádku biomarkeru. rate_cardve výpisech přijímáidze Získat ceník.
prices_view.Více údajů o dokumentech
Každá položka vdocuments 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.
results.updated, například konečná zpráva Labor Quade
(_E) po předběžné (_V).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.completedti dá vědět, že jsou výsledky konečné. - Události
location.*,profile.*ashipment.*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
urlv 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álostresults.updatedodkazuje. - Získat pobočku vrací jednu pobočku podle jejího
id. Odkazuje na niurludálostilocation.*.
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_viewpro 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š scoperesults_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.Poslat telefon a e-mail příjemce u každé sady
Pokuddelivery_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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim a Wiesbaden
Čtyři nové pobočky pro odběry žilní krve. Viz Seznam poboček.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š scoperesults_view
a pro zobrazení sad také oprávnění pro domácí testovací sady.API klíče jen pro aktivaci
Nový scopehome_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.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.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.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.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.Jedna cena za biomarker a panel
Biomarkery a panely mají jednu cenuprice_cents podle tvého ceníku a vedle ní retail_cents:> 0: lze objednat samostatně.0: poměr (vizrequires), nebo lze objednat jen s dalšími markery (vizpositions).null: bez ceny, takže nelze objednat.
groups[] je odstraněno z výpisů i z náhledu termínu. Cenová pole
retail a yours jsou odstraněna.Viz Ceny.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čkuIdempotency-Key. Opakovaný požadavek se stejným klíčem vrátí první odpověď a nic
nezapíše.Viz Idempotence.
