Hoppa till huvudinnehåll
API

Behållarnamn i bokningens förhandsgranskning blir produktnamn

Från och med nästa release är containers[].name i Förhandsgranska bokning provrörets produktnamn. type ändras inte, så läs type om din app jämför behållare.
AdminpanelAPI

Aniva fungerar nu på alla EU-språk, och några till

API

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

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

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

Se när budet hämtar dina prover

Adminpanelen visar nu nästa budhämtning på din mottagning, med spårning och etikett.Adminpanelen med en banner högst upp: GO! kommer imorgon ~10:00–12:00.Adminpanelen med en banner högst upp: GO! kommer imorgon ~10:00–12:00.
API

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ältet aniva_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.
API

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

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år 409, 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_lab och order_in_flight: labbet kan redan ha beställningen, så koden måste stanna på sitt rör.
APIHemtestkit

Striktare leveransadresser för beställningar av hemtestkit

Skapa hemtestkit och Uppdatera hemtestkit kontrollerar delivery_address striktare.
  • country_code accepterar 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 i postal_code. Andra värden ger 400.
  • Mellanslag runt postal_code tas bort innan vi sparar värdet.
AdminpanelHemtestkitAPI

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 med replaces_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.
ResultatAPIAdminpanel

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_emails fö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.
Se Mejl när resultat är klara.
APIHemtestkit

Patienten anger födelsedatum och kön

Vi kan nu låta din profilgrupp skapa en profil utan date_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.
Adminpanel

En snabbare adminpanel

Adminpanelen visar nu det första innehållet på ungefär 0,2 s, ned från 1,3 s. Inga fler laddningsikoner. Sidor fylls på i takt med att data kommer in. Sidor börjar laddas när du för muspekaren över en länk.
AdminpanelHemtestkitWebhooks

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

Logaritmiska enheter

Lista enheter returnerar en tredje unit_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.
APIPrissättning

Prisberäkna ett hemtestkit med avgifter

Prisberäkna varukorg tar emot fulfilment. 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.
Concierge

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

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

Dubblettprofiler nekas

Skapa profil returnerar nu 409 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.
Platser

Aniva Berlin Mitte stänger

Från och med 1 november 2026 erbjuder Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) inte längre några bokningar. Närmaste plats är Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
AdminpanelPrissättning

Testkatalog med dina priser

Den nya Testkatalogen i adminpanelen listar varje biomarkör med dess labb, provrör och pris enligt din prislista.
APIResultat

Varför ett resultat saknar labbintervall

Varje kliniskt resultat i Hämta resultat och Hämta labbresultat för hemtestkit har nu reference_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å. Visa lab_reported.reference_range.
  • not_measured: resultatet är undeliverable.
Det är null när ett intervall finns. Se Resultat.
APIPlatser

Butikspriser och koordinater

  • Platser har nu state_code, latitude och longitude.
  • 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.updated meddelar dig när ett pris ändras.
Endpointarna och händelsen för butikspriser kräver scope retail_prices_view.
HemtestkitAdminpanel

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

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_cents och name på varje biomarkörrad.
  • rate_card i listorna tar id från Hämta prislista.
Båda de nya slutpunkterna kräver scopet prices_view.
APIResultat

Fler dokumentdetaljer

Varje post i documents 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.
En ersatt rapport-PDF skickar nu results.updated, till exempel Labor Quades slutrapport (_E) efter den preliminära rapporten (_V).
APIWebhooks

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.completed talar om att resultaten är slutgiltiga.
  • Händelserna location.*, profile.* och shipment.* 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 url i 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 en results.updated-händelse pekar på.
  • Hämta plats returnerar en plats utifrån dess id. url i en location.*-händelse pekar på den.
Se Webhooks.
ResultatAdminpanel

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_view fö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 scopet results_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.
Hemtestkit

Skicka mottagarens telefonnummer och e-post med varje kit

Om delivery_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.
Platser

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

Fyra nya platser för venös blodprovstagning. Se Lista platser.
Adminpanel

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 scopet results_view och behörighet för hemtestkit för att se kit.
Hemtestkit

API-nycklar enbart för aktivering

Det nya scopet home_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.
APIBrytande ändring

Kön måste vara man eller kvinna

Skapa profil och Uppdatera profil godtar inte längre sex: 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.
Hemtestkit

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

Anivas intervall i resultat

Slutpunkterna för resultat fyller nu i reference_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.
APIHemtestkit

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.
APIPriserBrytande ändring

Ett pris per biomarkör och panel

Biomarkörer och paneler har ett price_cents enligt din prislista, med retail_cents bredvid sig:
  • > 0: kan beställas separat.
  • 0: en kvot (se requires), eller kan bara beställas tillsammans med andra markörer (se positions).
  • null: inte prissatt och kan därför inte beställas.
Brytande ändring: 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.
API

Idempotensnycklar

Endpoints för att skapa profiler, bokningar, beställningar av hemtestkit och försändelser tar emot en Idempotency-Key-header. Ett nytt försök med samma nyckel returnerar det första svaret och skriver ingenting.Se Idempotens.
Platser

Aniva Hannover, Düsseldorf, Duisburg och Essen

Fyra nya Aniva-platser i Tyskland är öppna för venös blodprovstagning: Hannover, Düsseldorf, Duisburg och Essen. Anropa Lista platser för att se vilka platser din nyckel kan boka.