Behållarnamn i bokningens förhandsgranskning blir produktnamn
Från och med nästa release ärcontainers[].name i Förhandsgranska bokning
provrörets produktnamn. type ändras inte, så läs type om din app jämför behållare.Aniva fungerar nu på alla EU-språk, och några till
- Adminpanel, webbplats, hjälpcenter och dokumentation: på alla 32 språk.
- Profiler: ange varje patients språk. Resultatsidan och resultatmejlen använder samma språk.
En enda endpoint för att lista paneler
- Lista paneler returnerar nu
biomarker_groups. Använd den i stället för/api/v2/panels. - Skapa panel har tagits bort. Använd Adminpanelen.
Visa labbresultat i din app
Dina patienter kan nu se sina labbresultat i din app: biomarkörlistan, trenden för varje biomarkör och en 3D-Twin med betyg per hälsoområde. Sidan använder din varumärkesfärg och din logotyp, i ljust eller mörkt läge.Resultatsidan är ett betaltillägg och din kontaktperson på Aniva kan ge dig priset. Skapa inbäddningssession visar hur du ställer in den.Listläsningar i API:et cachas i upp till 5 minuter
Dessa fyra endpoints cachar nu sitt svar i upp till 5 minuter, så det kan ta upp till 5 minuter innan en ändring syns:Get-endpoints visar fortfarande ändringar direkt.Om du pollar API:et efter ändringar, använd webhooks i stället. En
webhook meddelar dig om varje ändring när den sker. Se
Upprepade läsningar.Aniva-intervall är nu tillgängliga
Dina resultat kan nu inkludera Aniva-intervall: ett allmänt intervall och ett snävare intervall för varje biomarkör, med de källor som Aniva har registrerat. Intervallen varierar beroende på ålder, kön och graviditetsvecka.För att få åtkomst, skriv under det korta avtalet om Aniva-intervall. Sedan slår vi på dem för din API-nyckel. Be din kontaktperson på Aniva om avtalet.Intervallen ligger i det nya fältetaniva_range. Det ersätter reference_range_aniva, som alltid
var null. Intervallen är allmän information. De bedömer inte ett resultat och är varken
medicinsk rådgivning eller en medicinteknisk produkt. Laboratoriets intervall förblir standarden. Se
Aniva-intervall.Fluoridröret är nu fluoride
Förhandsgranska behållare kallar fluoridröret fluoride.
Det gamla värdet var naf. Om din kod jämför container.type med naf, ändra det till
fluoride.Två nya värden kan förekomma: lihep_capillary och fluoride_capillary. De är det kapillära
litiumheparinröret och det kapillära fluoridröret.Inga fler dubbelbokningar av sista tidsluckan
Om två bokningar för den sista platsen i en tidslucka kommer in samtidigt lyckas bara en. Den andra får409, precis som för en full tidslucka. Detsamma gäller när en bokning ändras medan den
avbokas eller bekräftas.Bekräfta blodprovstagning har tre nya 409-orsaker:remapped: koden är nu kopplad till andra paneler än tidigare.sent_to_labochorder_in_flight: labbet kan redan ha beställningen, så koden måste stanna på sitt rör.
Striktare leveransadresser för beställningar av hemtestkit
Skapa hemtestkit och Uppdatera hemtestkit kontrollerardelivery_address striktare.country_codeaccepterar små bokstäver, t.ex.de. Aniva sparar och returnerar värdet i stora bokstäver.- En tysk adress (
DE) måste ha exakt 5 siffror ipostal_code. Andra värden ger400. - Mellanslag runt
postal_codetas bort innan vi sparar värdet.
Ett nytt kit för ett kit som skickats tillbaka till oss
När transportören skickar tillbaka ett kit till oss väntar vi inte längre på paketet. Säg till om du vill ha kitet igen så skickar vi ett nytt direkt. Du kan också skapa det själv: anropa Skapa hemtestkit medreplaces_home_kit_order_id satt till det returnerade kitet. Det nya kitet är en separat
beställning med en ny kitkod.Vi kontrollerar det returnerade paketet när det kommer fram. Då ändras det returnerade kitet till
cancelled, och du ser vad som låg i paketet.Mejla ditt team när resultaten är klara
Be oss ange en standardmejladress för din profilgrupp, till exempel teamets inkorg. Då får den ett mejl när resultaten för en ny bokning är klara. Det gäller bokningar från adminpanelen, från API:et och från dina patienter.För att ändra det för en bokning:- Adminpanel: redigera mejladresserna, eller stäng av “Mejla mig när resultaten är klara”.
- API: skicka en lista i
results_ready_emailsför att använda de mejladresserna i stället. För att behålla din standardmejladress, ta med den i listan. Skicka[]om inget mejl ska skickas.
Patienten anger födelsedatum och kön
Vi kan nu låta din profilgrupp skapa en profil utandate_of_birth och sex. Patienten
anger båda på sidan för kitaktivering, där födelsedatumet skrivs in två gånger. Be oss aktivera
det. Se Profiler.Kit som skickats tillbaka till oss
När transportören skickar tillbaka ett kit till oss visas det nu på sidan Hemtestkit. Filtrera på Tillbakaskickat för att se alla kit som transportören har returnerat till oss, tillsammans med transportörens orsak. Försändelsen avslutas medfault och utlöser shipment.fault, inte längre delivered. När vi
har öppnat paketet ser du också vad som låg i det: komplett, en del saknas eller öppnat. Det
visar om din kund får full återbetalning.Vill du att vi skickar ut kitet igen? Skicka ett meddelande till oss med kitkoden och rätt
leveransadress. Vi skickar det med samma kitkod.Logaritmiska enheter
Lista enheter returnerar en tredjeunit_type: logarithmic, för ett
värde som är logaritmen av en storhet, som pH eller ett aterogent index. Hantera den som
physical när du visar den. Skala den inte: två logaritmiska enheter skiljer sig åt med en
förskjutning, inte en faktor.Prisberäkna ett hemtestkit med avgifter
Prisberäkna varukorg tar emotfulfilment. Skicka home_kit med
country_code så lägger specifikationen till de kitrader som din månadsfaktura debiterar för
en beställning: kitavgiften, provtagningsmaterialet, porto till det landet och tillbaka,
skyddshylsan och en extra lansettpåse. Standardvalet är fortfarande draw på en plats med
bokningsavgifterna. Svaret visar vilket alternativ som prissattes i fulfilment.kind.Möt Aniva Concierge
Från och med nu visas vår ändringslogg också i din Slack-kanal med oss, så fort vi släpper något.Vi har också byggt Aniva Concierge. Har du en fråga om API:et eller adminpanelen? Nämn @Aniva i Slack, eller svara bara under ett inlägg i ändringsloggen. Den kollar vår dokumentation och berättar var du ska klicka i adminpanelen, eller vilken endpoint och vilka filter du ska använda, med en länk till sidan.Lista en dags bokningar
Lista bokningar tar emot två nya filter.date
(YYYY-MM-DD) returnerar en kalenderdag, i tidszonen för varje boknings plats, tidigast
först. location_id returnerar en testplats. Använd båda för dagens schema på en plats.Dubblettprofiler nekas
Skapa profil returnerar nu409 med
error_name: "duplicate_profile_error" när en profil som din nyckel kan se har samma förnamn,
efternamn, kön och födelsedatum. Svaret anger det befintliga profile_id. Använd det i stället
för att skapa en andra profil. Sandbox-efternamnen är undantagna.Testkatalog med dina priser
Den nya Testkatalogen i adminpanelen listar varje biomarkör med dess labb, provrör och pris enligt din prislista.Varför ett resultat saknar labbintervall
Varje kliniskt resultat i Hämta resultat och Hämta labbresultat för hemtestkit har nureference_range_lab_absent_reason. Det anger varför reference_range_lab är null:not_provided: inget intervall finns. Visa “Ej tillämpligt”.lab_text_only: labbet skrev bara ut text, till exempel ett målvärde eller en risknivå. Visalab_reported.reference_range.not_measured: resultatet ärundeliverable.
null när ett intervall finns. Se Resultat.Butikspriser och koordinater
- Platser har nu
state_code,latitudeochlongitude. - Lista butikspriser och Hämta butikspriser returnerar priset för varje panel som ett apotek säljer till drop-in-kunder.
- Webhooken
location.retail_prices.updatedmeddelar dig när ett pris ändras.
retail_prices_view.Beställ hemtestkit i adminpanelen
Du kan nu beställa ett hemtestkit till din patient på sidan Hemtestkit i adminpanelen. Välj eller skapa patienten, välj kit och ange leveransadressen. Du kan också avbeställa ett kit där.Prislista och prisförslag
- Hämta prislista returnerar dina priser i Anivas katalog och dina avgifter.
- Prissätt varukorg prissätter paneler och biomarkörer utan bokning.
- Prisspecifikationen i Prissätt varukorg och Förhandsgranska bokning
har nu
fees,total_with_fees_centsochnamepå varje biomarkörrad. rate_cardi listorna taridfrån Hämta prislista.
prices_view.Fler dokumentdetaljer
Varje post idocuments i Hämta resultat har nu:file_name: namnet som Ladda ner dokument använder.- Nytt:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, till exempel Labor Quades slutrapport
(_E) efter den preliminära rapporten (_V).Webhooks
Aniva anropar nu din server när en bokning, en beställning av hemtestkit, dess resultat, en plats, en profil eller en försändelse ändras. Du behöver inte längre polla.- Registrera en HTTPS-URL med
Skapa webhook. Du behöver
scopet
webhooks_manage. Be Aniva lägga till det på din nyckel eller konfigurera webhooken åt dig. - Händelser täcker varje status för en bokning och en beställning av hemtestkit, ny tid eller plats och
varje ändring av resultaten.
results.completedtalar om att resultaten är slutgiltiga. - Händelserna
location.*,profile.*ochshipment.*talar om när en plats, en profil eller en försändelse läggs till, ändras eller tas bort. En försändelse skickar ocksåshipment.<status>vid varje statusändring. - Händelser innehåller ID:n och statusar, aldrig labbvärden eller personuppgifter. Läs
urli händelsen för att hämta datan. - Varje anrop signeras med Standard Webhooks-schemat.
- Aniva försöker igen 10 gånger under ungefär tre dagar om en leverans misslyckas. Du kan lista och skicka om leveranser i 30 dagar.
- Varje resultat i Hämta resultat har nu ett
id, så att du kan uppdatera det resultat som enresults.updated-händelse pekar på. - Hämta plats returnerar en plats utifrån dess
id.urli enlocation.*-händelse pekar på den.
Mejla resultaten till kunden
Du kan nu mejla en kund om att labbresultaten är klara. Skicka mejlet från sidan Labbresultat i adminpanelen, eller via två nya slutpunkter: Mejla resultat för bokningar och Mejla resultat för beställningar av hemtestkit.- Labbrapporterna kan bifogas i mejlet som PDF-filer. Varje PDF är lösenordsskyddad: lösenordet är kundens födelsedatum som 8 siffror (DDMMÅÅÅÅ), och det står i mejlet.
- Du kan lägga till ett personligt meddelande på högst 1 000 tecken.
- Det visar namnet och logotypen för profilens primära profilgrupp, på profilens språk.
- Varje utskick är ett mejl. Ett nytt försök skickar ett till. Du behöver scopet
results_viewför den kunden.
Få ett mejl när resultaten är klara
När du gör en bokning eller beställer ett hemtestkit som ersättning i adminpanelen kan du slå på “Mejla mig när resultaten är klara”. Vi skickar då ett mejl till dig, eller till valfri adress du anger, när alla labbresultat har kommit in. Mejlet länkar till resultatet i adminpanelen. Kunden får inte detta mejl. Du behöver scopetresults_view för den kunden.Via API:et kan du ange upp till 5 adresser i results_ready_emails i
Skapa bokning,
Skapa beställning av hemtestkit,
Uppdatera bokning och
Uppdatera beställning av hemtestkit.Skicka mottagarens telefonnummer och e-post med varje kit
Omdelivery_address för ett hemtestkit innehåller phone eller email skickar vi vidare dem till transportören.
Transportören meddelar då mottagaren när paketet är på väg eller väntar hos ett ombud. Om du
utelämnar dem får transportören inga kontaktuppgifter, även om profilen har sådana. Du bestämmer vem som får
aviseringar från transportören. Aviseringen kan ange Aniva Health som avsändare.Se Skapa beställning av hemtestkit.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim och Wiesbaden
Fyra nya platser för venös blodprovstagning. Se Lista platser.Sidan Labbresultat
Den nya sidan Labbresultat i adminpanelen listar varje blodprovstagning och varje aktiverat hemtestkit med tillhörande labbrapporter. Sök på namn, födelsedatum eller provrörets streckkod. Du behöver scopetresults_view och behörighet för hemtestkit för att se kit.API-nycklar enbart för aktivering
Det nya scopethome_kit_orders_activate låter en nyckel aktivera hemtestkit och inget annat. Den kan inte
skapa, ändra eller avbeställa ett kit. Be Aniva om en sådan nyckel om ett separat system aktiverar dina kit.Se Aktivera beställning av hemtestkit.Kön måste vara man eller kvinna
Skapa profil och Uppdatera profil godtar inte längresex: 0 (okänt). Skicka 1 för man eller 2
för kvinna; 0 returnerar 400. Laboratoriet behöver könet för referensintervallen, och en beställning
för en profil utan kön kunde inte nå laboratoriet.Se Skapa profil.Kit som når labbet utan aktivering
Om ett prov når laboratoriet innan kitet har aktiverats aktiverar Aniva kitet.activated_at sätts till morgonen för returpaketets första spårningshändelse, eller morgonen
då provet anlände till laboratoriet om spårning saknas. Ett senare anrop till Aktivera med ett
annat activated_at returnerar 409.Se Aktivera beställning av hemtestkit.Anivas intervall i resultat
Slutpunkterna för resultat fyller nu ireference_range_aniva med de jämförelsevärden som Aniva
har sammanställt, omräknade till resultatets enhet. Värdena skiljer sig åt beroende på ålder, kön och
graviditetsvecka. Din nyckel behöver scopet ANIVA_REFERENCE_RANGES_VIEW. Utan det är fältet null.Se Hämta bokningsresultat.Ersättningskit
Beställ ett ersättningskit när ett kit inte kunde leverera alla resultat. En ersättning är en ny beställning med en ny labbkod och behåller panelen från den ursprungliga beställningen.biomarker_ids anger vad
laboratoriet analyserar på nytt.Se Beställningar av hemtestkit.Ett pris per biomarkör och panel
Biomarkörer och paneler har ettprice_cents enligt din prislista, med retail_cents bredvid
sig:> 0: kan beställas separat.0: en kvot (serequires), eller kan bara beställas tillsammans med andra markörer (sepositions).null: inte prissatt och kan därför inte beställas.
groups[] har tagits bort från listorna och från förhandsgranskningen av bokningen. Prisfälten
retail och yours har tagits bort.Se Prissättning.Idempotensnycklar
Endpoints för att skapa profiler, bokningar, beställningar av hemtestkit och försändelser tar emot enIdempotency-Key-header. Ett nytt försök med samma nyckel returnerar det första svaret och skriver
ingenting.Se Idempotens.
