Zum Hauptinhalt springen
API

Behälternamen in der Terminvorschau werden zu Produktnamen

Ab dem nächsten Release ist containers[].name in der Terminvorschau der Produktname des Röhrchens. type ändert sich nicht, lies also type aus, wenn deine App Behälter vergleicht.
Admin-PanelAPI

Aniva spricht jetzt alle EU-Sprachen – und noch ein paar mehr

API

Ein Endpunkt für List Panels

  • List Panels gibt jetzt biomarker_groups zurück. Nutze diesen Endpunkt statt /api/v2/panels.
  • Create Panel wurde entfernt. Nutze das Admin-Panel.
API

Zeige Laborergebnisse in deiner App an

Deine Patienten können ihre Laborergebnisse jetzt in deiner App sehen: die Biomarker-Liste, den Trend jedes Biomarkers und einen 3D-Twin mit einer Bewertung pro Gesundheitsbereich. Die Seite verwendet deine Markenfarbe und dein Logo, im Hell- oder Dunkelmodus.Die Ergebnisseite ist ein kostenpflichtiges Add-on, und dein Ansprechpartner bei Aniva nennt dir den Preis. Create Embed Session zeigt, wie du sie einrichtest.
API

List-API-Abfragen werden bis zu 5 Minuten gecacht

Diese vier Endpunkte cachen ihre Antwort jetzt bis zu 5 Minuten lang, sodass es bis zu 5 Minuten dauern kann, bis eine Änderung sichtbar ist:Die Get-Endpunkte zeigen Änderungen weiterhin direkt an.Wenn du die API regelmäßig nach Änderungen abfragst, nutze stattdessen Webhooks. Ein Webhook informiert dich über jede Änderung, sobald sie eintritt. Siehe Wiederholte Abfragen.
Admin-Panel

Sieh, wann der Kurier deine Proben abholt

Das Admin-Panel zeigt jetzt die nächste Kurierabholung in deiner Praxis an, mit Sendungsverfolgung und Etikett.Admin-Panel mit einem Banner oben: GO! kommt morgen ~10:00–12:00.Admin-Panel mit einem Banner oben: GO! kommt morgen ~10:00–12:00.
API

Aniva-Bereiche sind jetzt verfügbar

Deine Ergebnisse können jetzt die Aniva-Bereiche enthalten: einen allgemeinen Bereich und einen engeren Bereich für jeden Biomarker, mit den Quellen, die Aniva erfasst hat. Die Bereiche unterscheiden sich nach Alter, Geschlecht und Schwangerschaftswoche.Um Zugang zu erhalten, unterschreibe die kurze Vereinbarung zu den Aniva-Bereichen. Wir schalten sie dann für deinen API-Schlüssel frei. Frag deinen Ansprechpartner bei Aniva nach der Vereinbarung.Die Bereiche stehen im neuen Feld aniva_range. Es ersetzt reference_range_aniva, das immer null war. Die Bereiche sind allgemeine Informationen. Sie bewerten kein Ergebnis und sind weder eine medizinische Beratung noch ein Medizinprodukt. Der Bereich des Labors bleibt der Standard. Siehe Aniva-Bereiche.
API

Das Fluoridröhrchen heißt jetzt fluoride

Preview Containers nennt das Fluoridröhrchen fluoride. Der alte Wert war naf. Wenn dein Code container.type mit naf vergleicht, ändere ihn auf fluoride.Zwei neue Werte können auftreten: lihep_capillary und fluoride_capillary. Das sind das kapillare Lithium-Heparin-Röhrchen und das kapillare Fluoridröhrchen.
API

Keine Doppelbuchungen mehr für den letzten Zeitslot

Wenn zwei Buchungen für den letzten Platz in einem Zeitslot gleichzeitig eingehen, ist nur eine erfolgreich. Die andere erhält 409, wie bei jedem vollen Zeitslot. Dasselbe gilt, wenn ein Termin geändert wird, während er gerade storniert oder bestätigt wird.Confirm Blood Draw hat drei neue 409-Gründe:
  • remapped: Der Code verweist jetzt auf andere Panels als zuvor.
  • sent_to_lab und order_in_flight: Das Labor kann den Auftrag bereits haben, daher muss der Code auf seinem Röhrchen bleiben.
APIHeimtest-Kits

Strengere Prüfung der Lieferadressen bei Heimtest-Kit-Bestellungen

Create Home Kit und Update Home Kit prüfen delivery_address strenger.
  • country_code akzeptiert Kleinbuchstaben, z. B. de. Aniva speichert und gibt ihn in Großbuchstaben zurück.
  • Eine deutsche Adresse (DE) braucht einen postal_code mit genau 5 Ziffern. Andere Werte liefern 400.
  • Leerzeichen rund um postal_code werden entfernt, bevor wir ihn speichern.
Admin-PanelHeimtest-KitsAPI

Ein neues Kit für ein zurückgesendetes Kit

Wenn der Versanddienstleister ein Kit an uns zurücksendet, warten wir nicht mehr auf den Karton. Sag uns, dass du das Kit noch einmal haben möchtest, und wir schicken sofort ein neues Kit los. Du kannst es auch selbst anlegen: Rufe Heimtest-Kit erstellen auf und setze replaces_home_kit_order_id auf das zurückgesendete Kit. Das neue Kit ist eine eigene Bestellung mit einem neuen Kit-Code.Wir prüfen den zurückgesendeten Karton, sobald er ankommt. Dann wechselt das zurückgesendete Kit auf cancelled, und du siehst, was im Karton war.
ErgebnisseAPIAdmin-Panel

E-Mail an dein Team, wenn Ergebnisse vorliegen

Bitte uns, eine Standard-E-Mail-Adresse für deine Profilgruppe festzulegen, zum Beispiel dein Team-Postfach. Sie erhält dann eine E-Mail, sobald die Ergebnisse einer neuen Buchung vorliegen. Das gilt für Buchungen aus dem Admin-Panel, über die API und von deinen Patienten.Um sie für eine Buchung zu ändern:
  • Admin-Panel: Bearbeite die E-Mail-Adressen oder deaktiviere „Mich per E-Mail benachrichtigen, wenn die Ergebnisse vorliegen“.
  • API: Sende eine Liste in results_ready_emails, um stattdessen diese E-Mail-Adressen zu verwenden. Um deine Standard-E-Mail-Adresse beizubehalten, nimm sie mit in die Liste auf. Sende [], um keine E-Mail zu senden.
Siehe E-Mails bei vorliegenden Ergebnissen.
APIHeimtest-Kits

Der Patient gibt Geburtsdatum und Geschlecht ein

Wir können deiner Profilgruppe jetzt erlauben, ein Profil ohne date_of_birth und sex zu erstellen. Der Patient gibt beides auf der Kit-Aktivierungsseite ein, das Geburtsdatum dabei zweimal. Sag uns Bescheid, damit wir es aktivieren. Siehe Profile.
Admin-Panel

Ein schnelleres Admin-Panel

Das Admin-Panel zeigt erste Inhalte jetzt in etwa 0,2 s statt bisher 1,3 s. Keine Ladekreise mehr. Seiten füllen sich, sobald ihre Daten eintreffen. Seiten beginnen schon zu laden, wenn du mit der Maus über einen Link fährst.
Admin-PanelHeimtest-KitsWebhooks

An uns zurückgesendete Kits

Wenn der Versanddienstleister ein Kit an uns zurücksendet, zeigt die Seite Heimtest-Kits das jetzt an. Filtere nach Zurückgesendet, um jedes vom Versanddienstleister zurückgesendete Kit samt Grund zu sehen. Die Sendung endet in fault und löst shipment.fault aus, nicht mehr delivered. Sobald wir den Karton öffnen, siehst du außerdem, was darin war: vollständig, ein Teil fehlt oder geöffnet. So weißt du, ob dein Kunde eine vollständige Erstattung erhält.Sollen wir das Kit noch einmal losschicken? Schreib uns den Kit-Code und die richtige Lieferadresse. Wir versenden es mit demselben Kit-Code.
API

Logarithmische Einheiten

Einheiten auflisten liefert einen dritten unit_type: logarithmic, für einen Wert, der der Logarithmus einer Größe ist, etwa der pH-Wert oder ein atherogener Index. Behandle ihn bei der Anzeige wie physical. Skaliere ihn nicht: Zwei logarithmische Einheiten unterscheiden sich um einen Offset, nicht um einen Faktor.
APIPreise

Heimtest-Kit mit Gebühren berechnen

Warenkorb-Preis berechnen akzeptiert fulfilment. Sende home_kit mit einem country_code, und die Aufstellung ergänzt die Kit-Positionen, die deine Monatsrechnung für eine Bestellung abrechnet: die Kit-Gebühr, das Abnahmematerial, das Porto in dieses Land und zurück, die Versandhülle und einen Ersatz-Lanzettenbeutel. Standard bleibt draw an einem Standort mit den Termingebühren. Die Antwort gibt in fulfilment.kind an, welche Variante berechnet wurde.
Concierge

Lerne den Aniva Concierge kennen

Ab sofort erscheint unser Changelog auch in deinem Slack-Kanal mit uns, sobald wir etwas ausliefern.Außerdem haben wir den Aniva Concierge gebaut. Hast du eine Frage zur API oder zum Admin-Panel? Erwähne @Aniva in Slack oder antworte einfach unter einem Changelog-Beitrag. Er durchsucht unsere Doku und sagt dir, wo du im Admin-Panel klicken musst oder welchen Endpunkt und welche Filter du nutzen solltest, mit einem Link zur Seite.
APITermine

Termine eines Tages auflisten

Termine auflisten akzeptiert zwei neue Filter. date (YYYY-MM-DD) liefert einen Kalendertag in der Zeitzone des jeweiligen Terminstandorts, den frühesten Termin zuerst. location_id liefert einen Teststandort. Nutze beide zusammen für den heutigen Tagesplan eines Standorts.
APIProfile

Doppelte Profile werden abgelehnt

Profil erstellen liefert jetzt 409 mit error_name: "duplicate_profile_error", wenn ein für deinen Schlüssel sichtbares Profil denselben Vornamen und Nachnamen sowie dasselbe Geschlecht und Geburtsdatum hat. Die Antwort nennt die vorhandene profile_id. Verwende sie, statt ein zweites Profil anzulegen. Die Sandbox-Nachnamen sind davon ausgenommen.
Standorte

Aniva Berlin Mitte schließt

Ab dem 1. November 2026 bietet Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) keine Termine mehr an. Der nächstgelegene Standort ist Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Admin-PanelPreise

Testkatalog mit deinen Preisen

Der neue Testkatalog im Admin-Panel listet jeden Biomarker mit seinen Laboren, Röhrchen und dem Preis aus deiner Preisliste auf.
APIErgebnisse

Warum ein Ergebnis keinen Labor-Referenzbereich hat

Jedes klinische Ergebnis in Ergebnisse abrufen und Laborergebnisse abrufen für Heimtest-Kits enthält jetzt reference_range_lab_absent_reason. Das Feld gibt an, warum reference_range_lab null ist:
  • not_provided: Es gibt keinen Bereich. Zeige „Nicht zutreffend“ an.
  • lab_text_only: Das Labor hat nur Text angegeben, etwa einen Zielwert oder eine Risikostufe. Zeige lab_reported.reference_range an.
  • not_measured: Das Ergebnis ist undeliverable.
Es ist null, wenn ein Bereich vorhanden ist. Siehe Ergebnisse.
APIStandorte

Verkaufspreise und Koordinaten

  • Standorte haben jetzt state_code, latitude und longitude.
  • Verkaufspreise auflisten und Verkaufspreise abrufen liefern den Preis jedes Panels, das eine Apotheke an Laufkunden verkauft.
  • Der Webhook location.retail_prices.updated informiert dich, wenn sich ein Preis ändert.
Die Endpunkte und das Event für Verkaufspreise brauchen den Scope retail_prices_view.
Heimtest-KitsAdmin-Panel

Heimtest-Kits im Admin-Panel bestellen

Du kannst jetzt auf der Heimtest-Kits-Seite im Admin-Panel ein Heimtest-Kit für deinen Patienten bestellen. Wähle den Patienten aus oder lege ihn an, wähle das Kit aus und gib die Lieferadresse ein. Dort kannst du ein Kit auch stornieren.
APIPreise

Preisliste und Preisberechnung

  • Preisliste abrufen liefert deine Preise aus dem Aniva-Katalog und deine Gebühren.
  • Warenkorb berechnen berechnet die Preise für Panels und Biomarker ohne Termin.
  • Die Abrechnung bei Warenkorb berechnen und Termin-Vorschau enthält jetzt fees, total_with_fees_cents und einen name in jeder Biomarker-Zeile.
  • rate_card in den Listen nimmt die id aus Preisliste abrufen entgegen.
Beide neuen Endpunkte benötigen den Scope prices_view.
APIErgebnisse

Mehr Dokumentdetails

Jeder Eintrag in documents bei Ergebnisse abrufen enthält jetzt:
  • file_name: der Name, den Dokument herunterladen verwendet.
  • Neu: original_file_name, origin, content_type, etag, size_bytes.
Ein ersetztes Berichts-PDF sendet jetzt results.updated, zum Beispiel der endgültige Bericht (_E) von Labor Quade nach dem vorläufigen (_V).
APIWebhooks

Webhooks

Aniva ruft jetzt deinen Server auf, wenn sich ein Termin, eine Heimtest-Kit-Bestellung, deren Ergebnisse, ein Standort, ein Profil oder eine Sendung ändert. Du musst nicht mehr pollen.
  • Registriere eine HTTPS-URL mit Webhook erstellen. Du brauchst den Scope webhooks_manage. Bitte Aniva, ihn zu deinem Schlüssel hinzuzufügen oder den Webhook für dich einzurichten.
  • Events decken jeden Status eines Termins und einer Heimtest-Kit-Bestellung, eine neue Zeit oder einen neuen Standort sowie jede Änderung der Ergebnisse ab. results.completed zeigt dir an, dass die Ergebnisse endgültig sind.
  • location.*-, profile.*- und shipment.*-Events informieren dich, wenn ein Standort, ein Profil oder eine Sendung hinzukommt, sich ändert oder wegfällt. Eine Sendung sendet außerdem shipment.<status> bei jeder Statusänderung.
  • Events enthalten IDs und Status, niemals Laborwerte oder personenbezogene Daten. Rufe die url im Event auf, um die Daten zu erhalten.
  • Jede Anfrage ist nach dem Schema von Standard Webhooks signiert.
  • Aniva wiederholt eine fehlgeschlagene Zustellung 10-mal über etwa drei Tage. Du kannst Zustellungen 30 Tage lang auflisten und erneut senden.
  • Jedes Ergebnis bei Ergebnisse abrufen hat jetzt eine id, sodass du das Ergebnis aktualisieren kannst, auf das ein results.updated-Event verweist.
  • Standort abrufen liefert einen einzelnen Standort anhand seiner id. Die url eines location.*-Events verweist darauf.
Siehe Webhooks.
ErgebnisseAdmin-Panel

Ergebnisse per E-Mail an den Kunden senden

Du kannst einen Kunden jetzt per E-Mail benachrichtigen, dass seine Laborergebnisse vorliegen. Sende die E-Mail über die Seite für Laborergebnisse im Admin-Panel oder über zwei neue Endpunkte: Ergebnisse per E-Mail senden für Termine und Ergebnisse per E-Mail senden für Heimtest-Kit-Bestellungen.
  • Die E-Mail kann die Laborberichte als PDF-Dateien im Anhang enthalten. Jedes PDF ist passwortgeschützt: Das Passwort ist das Geburtsdatum des Kunden als 8 Ziffern (TTMMJJJJ), und die E-Mail weist darauf hin.
  • Du kannst eine persönliche Notiz mit maximal 1.000 Zeichen hinzufügen.
  • Die E-Mail zeigt den Namen und das Logo der primären Profilgruppe des Profils, in der Profilsprache.
  • Jeder Versand ist eine E-Mail. Ein erneuter Versuch sendet eine zweite. Du brauchst den Scope results_view für diesen Kunden.

E-Mail erhalten, wenn Ergebnisse vorliegen

Wenn du im Admin-Panel einen Termin buchst oder ein Ersatz-Heimtest-Kit bestellst, kannst du „E-Mail an mich, wenn die Ergebnisse vorliegen“ aktivieren. Wir senden dann eine E-Mail an dich oder an eine beliebige Adresse, die du eingibst, sobald alle Laborergebnisse vorliegen. Die E-Mail verlinkt auf das Ergebnis im Admin-Panel. Der Kunde erhält diese E-Mail nicht. Du brauchst den Scope results_view für diesen Kunden.Über die API kannst du bis zu 5 Adressen in results_ready_emails angeben bei Termin erstellen, Heimtest-Kit-Bestellung erstellen, Termin aktualisieren und Heimtest-Kit-Bestellung aktualisieren.
Heimtest-Kits

Telefonnummer und E-Mail des Empfängers mit jedem Kit senden

Wenn die delivery_address eines Heimtest-Kits phone oder email enthält, geben wir diese Daten an den Versanddienstleister weiter. Der Versanddienstleister informiert den Empfänger dann, wenn das Paket unterwegs ist oder an einer Abholstation wartet. Wenn du sie weglässt, erhält der Versanddienstleister keine Kontaktdaten, auch wenn im Profil welche hinterlegt sind. Du entscheidest, wer Versandbenachrichtigungen erhält. Die Benachrichtigung kann Aniva Health als Absender nennen.Siehe Heimtest-Kit-Bestellung erstellen.
Standorte

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

Vier neue Standorte für venöse Blutabnahmen. Siehe Standorte auflisten.
Admin-Panel

Seite für Laborergebnisse

Die neue Seite für Laborergebnisse im Admin-Panel listet jede Blutabnahme und jedes aktivierte Heimtest-Kit mit den zugehörigen Laborberichten auf. Suche nach Name, Geburtsdatum oder Röhrchen-Barcode. Du brauchst den Scope results_view sowie eine Heimtest-Kit-Berechtigung, um Kits zu sehen.
Heimtest-Kits

API-Schlüssel nur zum Aktivieren

Mit dem neuen Scope home_kit_orders_activate kann ein Schlüssel Heimtest-Kits aktivieren und sonst nichts. Er kann kein Kit erstellen, ändern oder stornieren. Bitte Aniva um einen solchen Schlüssel, wenn ein separates System deine Kits aktiviert.Siehe Heimtest-Kit-Bestellung aktivieren.
APIBreaking

Geschlecht muss männlich oder weiblich sein

Profil erstellen und Profil aktualisieren akzeptieren sex: 0 (unbekannt) nicht mehr. Sende 1 für männlich oder 2 für weiblich; 0 gibt 400 zurück. Das Labor braucht das Geschlecht für die Referenzbereiche, und eine Bestellung für ein Profil ohne diese Angabe konnte das Labor nicht erreichen.Siehe Profil erstellen.
Heimtest-Kits

Kits, die das Labor ohne Aktivierung erreichen

Wenn eine Probe das Labor erreicht, bevor das zugehörige Kit aktiviert wurde, aktiviert Aniva das Kit. activated_at ist der Morgen des ersten Tracking-Events des Rücksendepakets oder der Morgen, an dem die Probe im Labor eingetroffen ist, falls kein Tracking vorliegt. Ein späterer Aufruf zum Aktivieren mit einem anderen activated_at gibt 409 zurück.Siehe Heimtest-Kit-Bestellung aktivieren.
API

Aniva-Bereiche in Ergebnissen

Die Ergebnis-Endpunkte füllen reference_range_aniva jetzt mit den Vergleichswerten, die Aniva zusammengestellt hat, umgerechnet in die Einheit des Ergebnisses. Die Werte unterscheiden sich nach Alter, Geschlecht und Schwangerschaftswoche. Dein Schlüssel braucht den Scope ANIVA_REFERENCE_RANGES_VIEW. Ohne ihn ist das Feld null.Siehe Terminergebnisse abrufen.
APIHeimtest-Kits

Ersatz-Kits

Bestelle einen Ersatz, wenn ein Kit nicht alle Ergebnisse liefern konnte. Ein Ersatz ist eine neue Bestellung mit einem neuen Laborcode und behält das Panel der ursprünglichen Bestellung bei. biomarker_ids legt fest, was das Labor erneut analysiert.Siehe Heimtest-Kit-Bestellungen.
APIPreiseBreaking

Ein Preis pro Biomarker und Panel

Biomarker und Panels haben einen price_cents-Wert nach deiner Preisliste, mit retail_cents daneben:
  • > 0: einzeln bestellbar.
  • 0: ein Verhältnis (siehe requires) oder nur zusammen mit anderen Markern bestellbar (siehe positions).
  • null: nicht bepreist, daher nicht bestellbar.
Breaking: groups[] wurde aus den Listen und aus der Terminvorschau entfernt. Die Preisfelder retail und yours wurden entfernt.Siehe Preise.
API

Idempotenzschlüssel

Die Create-Endpunkte für Profile, Termine, Heimtest-Kit-Bestellungen und Sendungen akzeptieren einen Idempotency-Key-Header. Ein erneuter Versuch mit demselben Schlüssel gibt die erste Antwort zurück und schreibt nichts.Siehe Idempotenz.
Standorte

Aniva Hannover, Düsseldorf, Duisburg und Essen

Vier neue Aniva-Standorte in Deutschland sind für venöse Blutabnahmen geöffnet: Hannover, Düsseldorf, Duisburg und Essen. Rufe Standorte auflisten auf, um die Standorte zu sehen, die dein Schlüssel buchen kann.