Containernamen in de voorvertoning van een afspraak worden productnamen
Vanaf de volgende release iscontainers[].name in Voorvertoning van afspraak
de productnaam van het buisje. type verandert niet, dus lees type uit als je app containers vergelijkt.Aniva werkt nu in elke EU-taal, en nog een paar extra
- Admin panel, website, helpcentrum en documentatie: in alle 32 talen.
- Profielen: stel per patiënt de taal in. De resultatenpagina en de e-mails met resultaten volgen die taal.
Eén List Panels-endpoint
- List Panels geeft nu
biomarker_groupsterug. Gebruik dit in plaats van/api/v2/panels. - Create Panel is verwijderd. Gebruik het Adminpaneel.
Toon labresultaten in je app
Je patiënten kunnen nu hun labresultaten in je app bekijken: de biomarkerlijst, de trend van elke biomarker en een 3D-twin met een cijfer per gezondheidsgebied. De pagina gebruikt je merkkleur en je logo, in lichte of donkere modus.De resultatenpagina is een betaalde add-on en je contactpersoon bij Aniva kan je de prijs vertellen. Create Embed Session laat zien hoe je dit instelt.List API-leesverzoeken worden tot 5 minuten gecachet
Deze vier endpoints cachen hun antwoord nu tot 5 minuten, waardoor het tot 5 minuten kan duren voordat een wijziging zichtbaar is:DeGet-endpoints tonen wijzigingen nog steeds direct.Als je de API pollt om wijzigingen te vinden, gebruik dan in plaats daarvan webhooks. Een
webhook informeert je zodra een wijziging plaatsvindt. Zie
Herhaalde leesverzoeken.Aniva-bereiken zijn nu beschikbaar
Je resultaten kunnen nu de Aniva-bereiken bevatten: een algemeen bereik en een smaller bereik voor elke biomarker, met de bronnen die Aniva heeft vastgelegd. De bereiken verschillen per leeftijd, geslacht en zwangerschapsweek.Onderteken de korte overeenkomst voor Aniva-bereiken om toegang te krijgen. Daarna schakelen we ze in voor je API-sleutel. Vraag je contactpersoon bij Aniva om de overeenkomst.De bereiken staan in het nieuwe veldaniva_range. Dit vervangt reference_range_aniva, dat
altijd null was. De bereiken zijn algemene informatie. Ze beoordelen geen resultaat en zijn
geen medisch advies of medisch hulpmiddel. Het bereik van het laboratorium blijft de standaard. Zie
Aniva-bereiken.Het fluoridebuisje is nu fluoride
Preview Containers noemt het fluoridebuisje fluoride.
De oude waarde was naf. Als je code container.type vergelijkt met naf, wijzig dit dan naar
fluoride.Er kunnen twee nieuwe waarden voorkomen: lihep_capillary en fluoride_capillary. Dit zijn het capillaire
lithium-heparinebuisje en het capillaire fluoridebuisje.Geen dubbele boekingen meer voor het laatste tijdslot
Als twee boekingen voor de laatste plek in een tijdslot tegelijkertijd binnenkomen, slaagt er maar één. De andere krijgt409, net als bij elk vol tijdslot. Hetzelfde geldt wanneer een afspraak wordt gewijzigd terwijl deze
wordt geannuleerd of bevestigd.Confirm Blood Draw heeft drie nieuwe 409-redenen:remapped: de code verwijst nu naar andere panels dan voorheen.sent_to_labenorder_in_flight: het lab kan de aanvraag al hebben, dus de code moet op zijn buisje blijven.
Strengere bezorgadressen bij bestellingen van thuistestkits
Create Home Kit en Update Home Kit controlerendelivery_address strenger.country_codeaccepteert kleine letters, bijv.de. Aniva slaat deze op en geeft deze terug in hoofdletters.- Voor een Duits adres (
DE) moetpostal_codeprecies 5 cijfers hebben. Andere waarden krijgen een400. - Spaties rond
postal_codeworden verwijderd voordat we deze opslaan.
Een nieuwe kit voor een teruggestuurde kit
Wanneer de bezorgdienst een kit naar ons terugstuurt, wachten we niet meer op de doos. Laat ons weten dat je de kit opnieuw wilt, dan sturen we meteen een nieuwe kit. Je kunt deze ook zelf aanmaken: roep Create Home Kit aan metreplaces_home_kit_order_id ingesteld op de teruggestuurde kit. De nieuwe kit is een aparte bestelling met een nieuwe
kitcode.We controleren de teruggestuurde doos zodra deze aankomt. De teruggestuurde kit verandert dan naar cancelled en je
ziet wat er in de doos zat.Mail je team wanneer resultaten klaar zijn
Vraag ons om een standaard e-mailadres in te stellen voor je profielgroep, bijvoorbeeld je teaminbox. Dat adres krijgt dan een e-mail wanneer de resultaten van een nieuwe boeking klaar zijn. Dit geldt voor boekingen uit het beheerpaneel, via de API en van je patiënten.Om dit voor één boeking te wijzigen:- Beheerpaneel: bewerk de e-mailadressen of zet “Mail mij wanneer de resultaten klaar zijn” uit.
- API: stuur een lijst mee in
results_ready_emailsom in plaats daarvan die e-mailadressen te gebruiken. Om je standaard e-mailadres te behouden, neem je het op in de lijst. Stuur[]voor geen e-mail.
De patiënt vult geboortedatum en geslacht in
We kunnen je profielgroep nu een profiel laten aanmaken zonderdate_of_birth en sex. De
patiënt vult beide in op de kitactivatiepagina en typt de geboortedatum twee keer in. Vraag ons om dit
aan te zetten. Zie Profielen.Kits die naar ons zijn teruggestuurd
Wanneer de bezorgdienst een kit naar ons terugstuurt, staat deze nu op de pagina Thuistestkits. Filter op Teruggestuurd om elke kit te zien die de bezorgdienst naar ons heeft teruggestuurd, met de reden van de bezorgdienst. De zending eindigt infault en verstuurt shipment.fault, niet meer delivered. Zodra we de doos openen, zie je ook
wat erin zat: compleet, een onderdeel ontbreekt of geopend. Zo weet je of je klant het volledige
bedrag terugkrijgt.Wil je dat we de kit opnieuw versturen? Stuur ons een bericht met de kitcode en het juiste
bezorgadres. We verzenden de kit met dezelfde kitcode.Logaritmische eenheden
List Units geeft een derdeunit_type terug: logarithmic, voor een waarde die
de logaritme is van een grootheid, zoals pH of een atherogene index. Behandel deze bij weergave net als physical.
Schaal de waarde niet: twee logaritmische eenheden verschillen met een verschuiving, niet met een factor.Prijsopgave voor een thuistestkit met kosten
Quote Cart accepteertfulfilment. Stuur home_kit mee met een country_code,
dan voegt de rekening de kitregels toe die je maandelijkse factuur voor één bestelling in rekening brengt: de kitkosten,
het afnamemateriaal, de verzendkosten naar dat land en terug, de hoes en een zakje met reservelancetten. De
standaard blijft een draw op een locatie met de afspraakkosten. Het antwoord geeft in fulfilment.kind aan
welke optie is berekend.Maak kennis met de Aniva Concierge
Vanaf nu verschijnt onze changelog ook in je Slack-kanaal met ons, zodra we iets uitbrengen.We hebben ook de Aniva Concierge gebouwd. Heb je een vraag over de API of het beheerpaneel? Tag @Aniva in Slack of reageer gewoon onder een changelogbericht. De Concierge kijkt in onze documentatie en vertelt je waar je moet klikken in het beheerpaneel, of welk endpoint en welke filters je moet gebruiken, met een link naar de pagina.Afspraken van één dag opvragen
List Appointments accepteert twee nieuwe filters.date
(YYYY-MM-DD) geeft één kalenderdag terug, in de tijdzone van de locatie van elke afspraak, de vroegste
eerst. location_id geeft één testlocatie terug. Gebruik beide voor de planning van een locatie vandaag.Dubbele profielen worden geweigerd
Create Profile geeft nu409 terug met
error_name: "duplicate_profile_error" wanneer een profiel dat je sleutel kan zien dezelfde voornaam,
achternaam en geboortedatum en hetzelfde geslacht heeft. Het antwoord noemt het bestaande profile_id. Gebruik dit in plaats
van een tweede profiel aan te maken. De sandbox-achternamen zijn uitgezonderd.Testcatalogus met je prijzen
De nieuwe Testcatalogus in het beheerpaneel toont elke biomarker met de bijbehorende labs, buisjes en de prijs op je prijslijst.Waarom een resultaat geen labbereik heeft
Elk klinisch resultaat bij Get Results en Get Lab Results voor thuistestkits heeft nureference_range_lab_absent_reason. Dit geeft aan waarom reference_range_lab null is:not_provided: er bestaat geen bereik. Toon “Niet van toepassing”.lab_text_only: het lab heeft alleen tekst vermeld, zoals een streefwaarde of een risiconiveau. Toonlab_reported.reference_range.not_measured: het resultaat isundeliverable.
null wanneer er een bereik aanwezig is. Zie Resultaten.Winkelprijzen en coördinaten
- Locaties hebben nu
state_code,latitudeenlongitude. - List Retail Prices en Get Retail Prices geven de prijs terug van elk panel dat een apotheek verkoopt aan inloopklanten.
- De webhook
location.retail_prices.updatedlaat je weten wanneer een prijs verandert.
retail_prices_view nodig.Thuistestkits bestellen in het beheerpaneel
Je kunt nu een thuistestkit bestellen voor je patiënt op de pagina Thuistestkits in het beheerpaneel. Kies de patiënt of maak deze aan, kies de kit en vul het bezorgadres in. Je kunt daar ook een kit annuleren.Tariefkaart en prijsopgaven
- Tariefkaart ophalen geeft je tarieven voor de Aniva-catalogus en je kosten terug.
- Winkelwagen berekenen berekent de prijs van panels en biomarkers zonder afspraak.
- De rekening bij Winkelwagen berekenen en Afspraak vooraf bekijken bevat nu
fees,total_with_fees_centsen eennameop elke biomarkerrij. rate_cardbij de overzichten gebruikt deiduit Tariefkaart ophalen.
prices_view nodig.Meer documentdetails
Elk item indocuments bij Resultaten ophalen heeft nu:file_name: de naam die Document downloaden gebruikt.- Nieuw:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, bijvoorbeeld het eindrapport van Labor Quade
(_E) na het voorlopige rapport (_V).Webhooks
Aniva roept nu je server aan wanneer een afspraak, een thuistestkitbestelling, de resultaten daarvan, een locatie, een profiel of een zending verandert. Je hoeft niet langer te pollen.- Registreer een HTTPS-URL met
Webhook aanmaken. Je hebt de scope
webhooks_managenodig. Vraag Aniva om die aan je sleutel toe te voegen, of om de webhook voor je in te stellen. - Events dekken elke status van een afspraak en een thuistestkitbestelling, een nieuw tijdstip of een nieuwe locatie, en
elke wijziging in de resultaten.
results.completedlaat je weten dat de resultaten definitief zijn. - De events
location.*,profile.*enshipment.*laten je weten wanneer een locatie, een profiel of een zending verschijnt, verandert of verdwijnt. Een zending stuurt ookshipment.<status>bij elke statuswijziging. - Events bevatten id’s en statussen, nooit labwaarden of persoonsgegevens. Lees de
urlin het event om de gegevens op te halen. - Elk verzoek wordt ondertekend met het Standard Webhooks-schema.
- Aniva probeert een mislukte bezorging 10 keer opnieuw gedurende ongeveer drie dagen. Je kunt bezorgingen 30 dagen lang bekijken en opnieuw verzenden.
- Elk resultaat bij Resultaten ophalen heeft nu een
id, zodat je het resultaat kunt bijwerken waar eenresults.updated-event naar verwijst. - Locatie ophalen geeft één locatie terug op basis van de
id. Deurlvan eenlocation.*-event verwijst daarnaar.
Resultaten naar de klant e-mailen
Je kunt een klant nu e-mailen dat de labresultaten klaarstaan. Verstuur de e-mail vanaf de pagina Labresultaten in het beheerpaneel, of via twee nieuwe endpoints: Resultaten e-mailen voor afspraken en Resultaten e-mailen voor thuistestkitbestellingen.- De e-mail kan de labrapporten als pdf-bestanden meesturen. Elke pdf is beveiligd met een wachtwoord: het wachtwoord is de geboortedatum van de klant in 8 cijfers (DDMMYYYY), en dat staat in de e-mail.
- Je kunt een persoonlijke notitie van maximaal 1.000 tekens toevoegen.
- De e-mail toont de naam en het logo van de primaire profielgroep van het profiel, in de taal van het profiel.
- Elke verzending is één e-mail. Een nieuwe poging stuurt een tweede. Je hebt de scope
results_viewnodig voor die klant.
Een e-mail ontvangen wanneer resultaten klaarstaan
Wanneer je een afspraak boekt of een vervangende thuistestkit bestelt in het beheerpaneel, kun je “Stuur mij een e-mail wanneer de resultaten klaarstaan” aanzetten. We sturen dan één e-mail naar jou, of naar een adres dat je invult, zodra alle labresultaten binnen zijn. De e-mail linkt naar het resultaat in het beheerpaneel. De klant krijgt deze e-mail niet. Je hebt de scoperesults_view nodig voor die klant.Via de API kun je maximaal 5 adressen instellen in results_ready_emails bij
Afspraak aanmaken,
Thuistestkitbestelling aanmaken,
Afspraak bijwerken en
Thuistestkitbestelling bijwerken.Telefoonnummer en e-mailadres van de ontvanger meesturen met elke kit
Als hetdelivery_address van een thuistestkit phone of email bevat, geven we die door aan de vervoerder. De
vervoerder laat de ontvanger dan weten wanneer het pakket onderweg is of klaarligt bij een afhaalpunt. Laat je
ze weg, dan krijgt de vervoerder geen contactgegevens, ook al staan die wel in het profiel. Jij bepaalt wie
meldingen van de vervoerder krijgt. De melding kan Aniva Health als afzender noemen.Zie Thuistestkitbestelling aanmaken.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim en Wiesbaden
Vier nieuwe locaties voor veneuze bloedafnames. Zie Locaties weergeven.Pagina Labresultaten
De nieuwe pagina Labresultaten in het beheerpaneel toont elke bloedafname en elke geactiveerde thuistestkit met de bijbehorende labrapporten. Zoek op naam, geboortedatum of barcode van het buisje. Je hebt de scoperesults_view nodig, en rechten voor thuistestkits om kits te zien.API-sleutels alleen voor activering
Met de nieuwe scopehome_kit_orders_activate kan een sleutel alleen thuistestkits activeren en niets anders. Hij kan
geen kit aanmaken, wijzigen of annuleren. Vraag Aniva om zo’n sleutel als een apart systeem je kits activeert.Zie Thuistestkitbestelling activeren.Geslacht moet man of vrouw zijn
Profiel aanmaken en Profiel bijwerken accepteren niet langersex: 0 (onbekend). Stuur 1 voor man of 2
voor vrouw; 0 geeft 400 terug. Het laboratorium heeft het geslacht nodig voor de referentiebereiken, en een bestelling
voor een profiel zonder geslacht kon het laboratorium niet bereiken.Zie Profiel aanmaken.Kits die het lab bereiken zonder activering
Als een monster het laboratorium bereikt voordat de kit is geactiveerd, activeert Aniva de kit.activated_at is de ochtend van het eerste trackingevent van het retourpakket, of de ochtend
waarop het monster bij het laboratorium aankwam als er geen tracking is. Een latere activeringsaanroep met een
andere activated_at geeft 409 terug.Zie Thuistestkitbestelling activeren.Aniva-bereiken in resultaten
De resultaten-endpoints vullenreference_range_aniva nu met de vergelijkingswaarden die Aniva
heeft samengesteld, omgerekend naar de eenheid van het resultaat. De waarden verschillen per leeftijd, geslacht en
zwangerschapsweek. Je sleutel heeft de scope ANIVA_REFERENCE_RANGES_VIEW nodig. Zonder die scope is het veld null.Zie Afspraakresultaten ophalen.Vervangende kits
Bestel een vervanging wanneer een kit niet alle resultaten kon opleveren. Een vervanging is een nieuwe bestelling met een nieuwe labcode en behoudt het panel van de oorspronkelijke bestelling.biomarker_ids bepaalt wat het
laboratorium opnieuw uitvoert.Zie Thuistestkitbestellingen.Eén prijs per biomarker en panel
Biomarkers en panels hebben éénprice_cents volgens je tariefkaart, met retail_cents
ernaast:> 0: los te bestellen.0: een ratio (zierequires), of alleen samen met andere markers te bestellen (ziepositions).null: geen prijs, dus niet te bestellen.
groups[] is verwijderd uit de overzichten en uit de preview van de afspraak. De
prijsvelden retail en yours zijn verwijderd.Zie Prijzen.Idempotency-keys
De create-endpoints voor profielen, afspraken, bestellingen van thuistestkits en zendingen accepteren eenIdempotency-Key-header. Een nieuwe poging met dezelfde key geeft de eerste respons terug en schrijft
niets weg.Zie Idempotency.
