Behälternamen in der Terminvorschau werden zu Produktnamen
Ab dem nächsten Release istcontainers[].name in der Terminvorschau
der Produktname des Röhrchens. type ändert sich nicht, lies also type aus, wenn deine App Behälter vergleicht.Aniva spricht jetzt alle EU-Sprachen – und noch ein paar mehr
- Admin-Panel, Website, Hilfecenter und Dokumentation: in allen 32 Sprachen.
- Profile: Lege die Sprache für jeden Patienten fest. Die Ergebnisseite und die Ergebnis-E-Mails richten sich danach.
Ein Endpunkt für List Panels
- List Panels gibt jetzt
biomarker_groupszurück. Nutze diesen Endpunkt statt/api/v2/panels. - Create Panel wurde entfernt. Nutze das Admin-Panel.
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.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:DieGet-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.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 Feldaniva_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.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.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ält409, 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_labundorder_in_flight: Das Labor kann den Auftrag bereits haben, daher muss der Code auf seinem Röhrchen bleiben.
Strengere Prüfung der Lieferadressen bei Heimtest-Kit-Bestellungen
Create Home Kit und Update Home Kit prüfendelivery_address strenger.country_codeakzeptiert Kleinbuchstaben, z. B.de. Aniva speichert und gibt ihn in Großbuchstaben zurück.- Eine deutsche Adresse (
DE) braucht einenpostal_codemit genau 5 Ziffern. Andere Werte liefern400. - Leerzeichen rund um
postal_codewerden entfernt, bevor wir ihn speichern.
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 setzereplaces_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.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.
Der Patient gibt Geburtsdatum und Geschlecht ein
Wir können deiner Profilgruppe jetzt erlauben, ein Profil ohnedate_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.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 infault 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.Logarithmische Einheiten
Einheiten auflisten liefert einen drittenunit_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.Heimtest-Kit mit Gebühren berechnen
Warenkorb-Preis berechnen akzeptiertfulfilment. 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.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.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.Doppelte Profile werden abgelehnt
Profil erstellen liefert jetzt409 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.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.Warum ein Ergebnis keinen Labor-Referenzbereich hat
Jedes klinische Ergebnis in Ergebnisse abrufen und Laborergebnisse abrufen für Heimtest-Kits enthält jetztreference_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. Zeigelab_reported.reference_rangean.not_measured: Das Ergebnis istundeliverable.
null, wenn ein Bereich vorhanden ist. Siehe Ergebnisse.Verkaufspreise und Koordinaten
- Standorte haben jetzt
state_code,latitudeundlongitude. - Verkaufspreise auflisten und Verkaufspreise abrufen liefern den Preis jedes Panels, das eine Apotheke an Laufkunden verkauft.
- Der Webhook
location.retail_prices.updatedinformiert dich, wenn sich ein Preis ändert.
retail_prices_view.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.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_centsund einennamein jeder Biomarker-Zeile. rate_cardin den Listen nimmt dieidaus Preisliste abrufen entgegen.
prices_view.Mehr Dokumentdetails
Jeder Eintrag indocuments bei Ergebnisse abrufen enthält jetzt:file_name: der Name, den Dokument herunterladen verwendet.- Neu:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, zum Beispiel der endgültige Bericht
(_E) von Labor Quade nach dem vorläufigen (_V).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.completedzeigt dir an, dass die Ergebnisse endgültig sind. location.*-,profile.*- undshipment.*-Events informieren dich, wenn ein Standort, ein Profil oder eine Sendung hinzukommt, sich ändert oder wegfällt. Eine Sendung sendet außerdemshipment.<status>bei jeder Statusänderung.- Events enthalten IDs und Status, niemals Laborwerte oder personenbezogene Daten. Rufe die
urlim 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 einresults.updated-Event verweist. - Standort abrufen liefert einen einzelnen Standort anhand seiner
id. Dieurleineslocation.*-Events verweist darauf.
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_viewfü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 Scoperesults_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.Telefonnummer und E-Mail des Empfängers mit jedem Kit senden
Wenn diedelivery_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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim und Wiesbaden
Vier neue Standorte für venöse Blutabnahmen. Siehe Standorte auflisten.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 Scoperesults_view sowie eine Heimtest-Kit-Berechtigung, um Kits zu sehen.API-Schlüssel nur zum Aktivieren
Mit dem neuen Scopehome_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.Geschlecht muss männlich oder weiblich sein
Profil erstellen und Profil aktualisieren akzeptierensex: 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.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.Aniva-Bereiche in Ergebnissen
Die Ergebnis-Endpunkte füllenreference_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.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.Ein Preis pro Biomarker und Panel
Biomarker und Panels haben einenprice_cents-Wert nach deiner Preisliste, mit retail_cents
daneben:> 0: einzeln bestellbar.0: ein Verhältnis (sieherequires) oder nur zusammen mit anderen Markern bestellbar (siehepositions).null: nicht bepreist, daher nicht bestellbar.
groups[] wurde aus den Listen und aus der Terminvorschau entfernt. Die
Preisfelder retail und yours wurden entfernt.Siehe Preise.Idempotenzschlüssel
Die Create-Endpunkte für Profile, Termine, Heimtest-Kit-Bestellungen und Sendungen akzeptieren einenIdempotency-Key-Header. Ein erneuter Versuch mit demselben Schlüssel gibt die erste Antwort zurück und schreibt
nichts.Siehe Idempotenz.
