Naar hoofdinhoud gaan
API

Containernamen in de voorvertoning van een afspraak worden productnamen

Vanaf de volgende release is containers[].name in Voorvertoning van afspraak de productnaam van het buisje. type verandert niet, dus lees type uit als je app containers vergelijkt.
AdminpaneelAPI

Aniva werkt nu in elke EU-taal, en nog een paar extra

API

Eén List Panels-endpoint

  • List Panels geeft nu biomarker_groups terug. Gebruik dit in plaats van /api/v2/panels.
  • Create Panel is verwijderd. Gebruik het Adminpaneel.
API

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

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:De Get-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.
Adminpaneel

Zie wanneer de koerier je monsters ophaalt

Het adminpaneel toont nu het volgende ophaalmoment van de koerier bij je praktijk, met tracking en label.Adminpaneel met een banner bovenaan: GO! komt morgen ~10:00–12:00.Adminpaneel met een banner bovenaan: GO! komt morgen ~10:00–12:00.
API

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

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

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 krijgt 409, 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_lab en order_in_flight: het lab kan de aanvraag al hebben, dus de code moet op zijn buisje blijven.
APIThuistestkits

Strengere bezorgadressen bij bestellingen van thuistestkits

Create Home Kit en Update Home Kit controleren delivery_address strenger.
  • country_code accepteert kleine letters, bijv. de. Aniva slaat deze op en geeft deze terug in hoofdletters.
  • Voor een Duits adres (DE) moet postal_code precies 5 cijfers hebben. Andere waarden krijgen een 400.
  • Spaties rond postal_code worden verwijderd voordat we deze opslaan.
BeheerpaneelThuistestkitsAPI

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 met replaces_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.
ResultatenAPIBeheerpaneel

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_emails om 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.
Zie E-mails wanneer resultaten klaar zijn.
APIThuistestkits

De patiënt vult geboortedatum en geslacht in

We kunnen je profielgroep nu een profiel laten aanmaken zonder date_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.
Beheerpaneel

Een sneller beheerpaneel

Het beheerpaneel toont de eerste inhoud nu in ongeveer 0,2 s, in plaats van 1,3 s. Geen laadicoontjes meer. Pagina’s worden gevuld zodra de gegevens binnenkomen. Pagina’s beginnen al te laden wanneer je over een link beweegt.
BeheerpaneelThuistestkitsWebhooks

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

Logaritmische eenheden

List Units geeft een derde unit_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.
APIPrijzen

Prijsopgave voor een thuistestkit met kosten

Quote Cart accepteert fulfilment. 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.
Concierge

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

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

Dubbele profielen worden geweigerd

Create Profile geeft nu 409 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.
Locaties

Aniva Berlin Mitte sluit

Vanaf 1 november 2026 biedt Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) geen afspraken meer aan. De dichtstbijzijnde locatie is Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
BeheerpaneelPrijzen

Testcatalogus met je prijzen

De nieuwe Testcatalogus in het beheerpaneel toont elke biomarker met de bijbehorende labs, buisjes en de prijs op je prijslijst.
APIResultaten

Waarom een resultaat geen labbereik heeft

Elk klinisch resultaat bij Get Results en Get Lab Results voor thuistestkits heeft nu reference_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. Toon lab_reported.reference_range.
  • not_measured: het resultaat is undeliverable.
Dit is null wanneer er een bereik aanwezig is. Zie Resultaten.
APILocaties

Winkelprijzen en coördinaten

  • Locaties hebben nu state_code, latitude en longitude.
  • 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.updated laat je weten wanneer een prijs verandert.
De endpoints en het event voor winkelprijzen hebben de scope retail_prices_view nodig.
ThuistestkitsBeheerpaneel

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

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_cents en een name op elke biomarkerrij.
  • rate_card bij de overzichten gebruikt de id uit Tariefkaart ophalen.
Beide nieuwe endpoints hebben de scope prices_view nodig.
APIResultaten

Meer documentdetails

Elk item in documents bij Resultaten ophalen heeft nu:
  • file_name: de naam die Document downloaden gebruikt.
  • Nieuw: original_file_name, origin, content_type, etag, size_bytes.
Een vervangen pdf-rapport verstuurt nu results.updated, bijvoorbeeld het eindrapport van Labor Quade (_E) na het voorlopige rapport (_V).
APIWebhooks

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_manage nodig. 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.completed laat je weten dat de resultaten definitief zijn.
  • De events location.*, profile.* en shipment.* laten je weten wanneer een locatie, een profiel of een zending verschijnt, verandert of verdwijnt. Een zending stuurt ook shipment.<status> bij elke statuswijziging.
  • Events bevatten id’s en statussen, nooit labwaarden of persoonsgegevens. Lees de url in 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 een results.updated-event naar verwijst.
  • Locatie ophalen geeft één locatie terug op basis van de id. De url van een location.*-event verwijst daarnaar.
Zie Webhooks.
ResultatenBeheerpaneel

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_view nodig 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 scope results_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.
Thuistestkits

Telefoonnummer en e-mailadres van de ontvanger meesturen met elke kit

Als het delivery_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.
Locaties

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

Vier nieuwe locaties voor veneuze bloedafnames. Zie Locaties weergeven.
Beheerpaneel

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 scope results_view nodig, en rechten voor thuistestkits om kits te zien.
Thuistestkits

API-sleutels alleen voor activering

Met de nieuwe scope home_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.
APIBreaking

Geslacht moet man of vrouw zijn

Profiel aanmaken en Profiel bijwerken accepteren niet langer sex: 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.
Thuistestkits

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

Aniva-bereiken in resultaten

De resultaten-endpoints vullen reference_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.
APIThuistestkits

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

Eén prijs per biomarker en panel

Biomarkers en panels hebben één price_cents volgens je tariefkaart, met retail_cents ernaast:
  • > 0: los te bestellen.
  • 0: een ratio (zie requires), of alleen samen met andere markers te bestellen (zie positions).
  • null: geen prijs, dus niet te bestellen.
Breaking: groups[] is verwijderd uit de overzichten en uit de preview van de afspraak. De prijsvelden retail en yours zijn verwijderd.Zie Prijzen.
API

Idempotency-keys

De create-endpoints voor profielen, afspraken, bestellingen van thuistestkits en zendingen accepteren een Idempotency-Key-header. Een nieuwe poging met dezelfde key geeft de eerste respons terug en schrijft niets weg.Zie Idempotency.
Locaties

Aniva Hannover, Düsseldorf, Duisburg en Essen

Vier nieuwe Aniva-locaties in Duitsland zijn open voor veneuze bloedafnames: Hannover, Düsseldorf, Duisburg en Essen. Roep Locaties ophalen aan om te zien welke locaties je key kan boeken.