Salt la conținutul principal
API

Numele recipientelor din previzualizarea programării devin nume de produse

De la următoarea versiune, containers[].name din Previzualizare programare este numele de produs al tubului. type nu se schimbă, așa că citește type dacă aplicația ta compară recipiente.
Panou de administrareAPI

Aniva funcționează acum în toate limbile UE și încă câteva

API

Un singur endpoint de listare a panelurilor

API

Afișează rezultatele de laborator în aplicația ta

Pacienții tăi își pot vedea acum rezultatele de laborator în aplicația ta: lista de biomarkeri, evoluția fiecărui biomarker și un Twin 3D cu o notă pentru fiecare zonă de sănătate. Pagina folosește culoarea brandului tău și logo-ul tău, în modul luminos sau întunecat.Pagina de rezultate este o opțiune suplimentară cu plată, iar persoana ta de contact de la Aniva îți poate spune prețul. Creare sesiune de încorporare îți arată cum să o configurezi.
API

Citirile API de listare sunt păstrate în cache până la 5 minute

Aceste patru endpointuri păstrează acum răspunsul în cache până la 5 minute, așa că poate dura până la 5 minute ca o modificare să apară:Endpointurile Get afișează în continuare modificările direct.Dacă interoghezi periodic API-ul pentru a găsi modificări, folosește webhookuri în schimb. Un webhook te anunță despre fiecare modificare pe măsură ce are loc. Vezi Citiri repetate.
Panou de administrare

Vezi când vine curierul după probele tale

Panoul de administrare afișează acum următoarea ridicare prin curier de la cabinetul tău, cu urmărire și etichetă.Panou de administrare cu un banner în partea de sus: GO! vine mâine ~10:00–12:00.Panou de administrare cu un banner în partea de sus: GO! vine mâine ~10:00–12:00.
API

Intervalele Aniva sunt acum disponibile

Rezultatele tale pot include acum intervalele Aniva: un interval general și un interval mai restrâns pentru fiecare biomarker, cu sursele înregistrate de Aniva. Intervalele diferă în funcție de vârstă, sex și săptămâna de sarcină.Pentru a obține acces, semnează scurtul acord privind intervalele Aniva. Apoi le activăm pentru cheia ta API. Cere-i acordul persoanei tale de contact de la Aniva.Intervalele se află în noul câmp aniva_range. Acesta înlocuiește reference_range_aniva, care era întotdeauna null. Intervalele reprezintă informații generale. Nu evaluează un rezultat și nu constituie sfat medical sau dispozitiv medical. Intervalul laboratorului rămâne standardul. Vezi Intervalele Aniva.
API

Eprubeta cu fluorură este acum fluoride

Previzualizare recipiente numește eprubeta cu fluorură fluoride. Valoarea veche era naf. Dacă codul tău compară container.type cu naf, schimb-o în fluoride.Pot apărea două valori noi: lihep_capillary și fluoride_capillary. Acestea sunt eprubeta capilară cu litiu-heparină și eprubeta capilară cu fluorură.
API

Fără rezervări duble pentru ultimul interval

Dacă două rezervări pentru ultimul loc dintr-un interval ajung în același timp, doar una reușește. Cealaltă primește 409, ca la orice interval ocupat. Același lucru se aplică atunci când o programare este modificată în timp ce este anulată sau confirmată.Confirmare recoltare de sânge are trei motive noi de 409:
  • remapped: codul corespunde acum altor paneluri decât înainte.
  • sent_to_lab și order_in_flight: laboratorul poate avea deja comanda, deci codul trebuie să rămână pe eprubeta sa.
APIKituri de testare la domiciliu

Adrese de livrare mai stricte pentru comenzile de kituri de testare la domiciliu

Creare kit de testare la domiciliu și Actualizare kit de testare la domiciliu verifică delivery_address mai strict.
  • country_code acceptă litere mici, de ex. de. Aniva îl stochează și îl returnează cu litere mari.
  • O adresă din Germania (DE) are nevoie de un postal_code de exact 5 cifre. Alte valori primesc 400.
  • Spațiile din jurul câmpului postal_code sunt eliminate înainte să îl stocăm.
Panou de administrareKituri de testare la domiciliuAPI

Un kit nou pentru un kit trimis înapoi la noi

Când curierul trimite un kit înapoi la noi, nu mai așteptăm cutia. Spune-ne că vrei kitul din nou și trimitem imediat un kit nou. Îl poți crea și tu: apelează Creează kit de testare la domiciliu cu replaces_home_kit_order_id setat la kitul returnat. Noul kit este o comandă separată, cu un nou cod de kit.Verificăm cutia returnată când ajunge. Apoi kitul returnat trece în cancelled, iar tu vezi ce era în cutie.
RezultateAPIPanou de administrare

Trimite email echipei tale când rezultatele sunt gata

Cere-ne să setăm o adresă de email implicită pentru grupul tău de profiluri, de exemplu inboxul echipei tale. Aceasta primește apoi un email când rezultatele unei programări noi sunt gata. Se aplică programărilor din panoul de administrare, din API și de la pacienții tăi.Ca să o schimbi pentru o singură programare:
  • Panou de administrare: editează adresele de email sau dezactivează „Trimite-mi un email când rezultatele sunt gata”.
  • API: trimite o listă în results_ready_emails ca să folosești în loc acele adrese de email. Ca să păstrezi adresa ta de email implicită, include-o în listă. Trimite [] pentru niciun email.
Vezi Emailuri când rezultatele sunt gata.
APIKituri de testare la domiciliu

Pacientul introduce data nașterii și sexul

Acum putem permite grupului tău de profiluri să creeze un profil fără date_of_birth și sex. Pacientul le introduce pe ambele pe pagina de activare a kitului, tastând data nașterii de două ori. Cere-ne să activăm această opțiune. Vezi Profiluri.
Panou de administrare

Un panou de administrare mai rapid

Panoul de administrare afișează acum primul conținut în aproximativ 0,2 s, față de 1,3 s anterior. Gata cu indicatorii de încărcare. Paginile se completează pe măsură ce sosesc datele. Paginile încep să se încarce când treci cu cursorul peste un link.
Panou de administrareKituri de testare la domiciliuWebhook-uri

Kituri trimise înapoi la noi

Când curierul trimite un kit înapoi la noi, pagina Kituri de testare la domiciliu îl afișează acum. Filtrează după Trimis înapoi ca să vezi fiecare kit pe care curierul ni l-a returnat, împreună cu motivul curierului. Expedierea se încheie cu fault și declanșează shipment.fault, nu mai ajunge în delivered. După ce deschidem cutia, vezi și ce conținea: complet, cu o piesă lipsă sau deschis. Asta îți spune dacă clientul tău primește o rambursare integrală.Vrei să trimitem kitul din nou? Trimite-ne un mesaj cu codul kitului și adresa corectă de livrare. Îl expediem cu același cod de kit.
API

Unități logaritmice

Listează unitățile returnează un al treilea unit_type: logarithmic, pentru o valoare care este logaritmul unei mărimi, cum ar fi pH-ul sau un indice aterogenic. Trateaz-o ca physical când o afișezi. Nu o scala: două unități logaritmice diferă printr-un decalaj, nu printr-un factor.
APIPrețuri

Calculează prețul unui kit de testare la domiciliu cu taxele aferente

Calculează coșul acceptă fulfilment. Trimite home_kit cu un country_code, iar calculul adaugă liniile de kit pe care factura ta lunară le facturează pentru o comandă: taxa de kit, dispozitivele de recoltare, transportul poștal către acea țară și înapoi, manșonul și o pungă de rezervă cu lancete. Valoarea implicită rămâne draw într-o locație, cu taxele de programare. Răspunsul spune în fulfilment.kind pentru care dintre ele a calculat prețul.
Concierge

Fă cunoștință cu Aniva Concierge

De acum înainte, jurnalul nostru de modificări apare și pe canalul tău de Slack cu noi, imediat ce lansăm ceva.Am construit și Aniva Concierge. Ai o întrebare despre API sau panoul de administrare? Menționează @Aniva pe Slack sau răspunde pur și simplu sub o postare din jurnalul de modificări. Verifică documentația noastră și îți spune unde să dai clic în panoul de administrare sau ce endpoint și filtre să folosești, cu un link către pagină.
APIProgramări

Listează programările dintr-o singură zi

Listează programările acceptă două filtre noi. date (YYYY-MM-DD) returnează o zi calendaristică, în fusul orar al locației fiecărei programări, începând cu cea mai devreme. location_id returnează o singură locație de testare. Folosește-le pe ambele pentru programul de azi al unei locații.
APIProfiluri

Profilurile duplicate sunt refuzate

Creează profil returnează acum 409 cu error_name: "duplicate_profile_error" când un profil pe care cheia ta îl poate vedea are același prenume, nume de familie, sex și aceeași dată de naștere. Răspunsul indică profile_id-ul existent. Folosește-l în loc să creezi un al doilea profil. Numele de familie din sandbox sunt exceptate.
Locații

Aniva Berlin Mitte se închide

Începând cu 1 noiembrie 2026, Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) nu mai oferă programări. Cea mai apropiată locație este Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Panou de administrarePrețuri

Catalog de teste cu prețurile tale

Noul Catalog de teste din panoul de administrare listează fiecare biomarker cu laboratoarele, eprubetele și prețul din grila ta de tarife.
APIRezultate

De ce un rezultat nu are interval de laborator

Fiecare rezultat clinic din Obține rezultatele și Obține rezultatele de laborator pentru kituri de testare la domiciliu are acum reference_range_lab_absent_reason. Indică de ce reference_range_lab este null:
  • not_provided: nu există niciun interval. Afișează „Nu se aplică”.
  • lab_text_only: laboratorul a tipărit doar text, cum ar fi o țintă sau un nivel de risc. Afișează lab_reported.reference_range.
  • not_measured: rezultatul este undeliverable.
Este null când există un interval. Vezi Rezultate.
APILocații

Prețuri de vânzare și coordonate

Endpoint-urile și evenimentul pentru prețurile de vânzare necesită scope-ul retail_prices_view.
Kituri de testare la domiciliuPanou de administrare

Comandă kituri de testare la domiciliu în panoul de administrare

Acum poți comanda un kit de testare la domiciliu pentru pacientul tău pe pagina Kituri de testare la domiciliu din panoul de administrare. Alege sau creează pacientul, alege kitul și introdu adresa de livrare. Tot acolo poți și să anulezi un kit.
APIPrețuri

Grilă de tarife și estimări de preț

  • Obținere grilă de tarife returnează tarifele tale din catalogul Aniva și taxele tale.
  • Estimare coș calculează prețul pentru paneluri și biomarkeri fără o programare.
  • Nota de plată din Estimare coș și Previzualizare programare include acum fees, total_with_fees_cents și un name pe fiecare rând de biomarker.
  • rate_card din listări preia id din Obținere grilă de tarife.
Ambele endpointuri noi au nevoie de scope-ul prices_view.
APIRezultate

Mai multe detalii despre documente

Fiecare intrare din documents în Obținere rezultate are acum:
  • file_name: numele pe care îl folosește Descărcare document.
  • Noi: original_file_name, origin, content_type, etag, size_bytes.
Un raport PDF înlocuit trimite acum results.updated, de exemplu raportul final al Labor Quade (_E) după cel preliminar (_V).
APIWebhookuri

Webhookuri

Aniva apelează acum serverul tău când se modifică o programare, o comandă de kit de testare la domiciliu, rezultatele acesteia, o locație, un profil sau o expediere. Nu mai trebuie să faci polling.
  • Înregistrează un URL HTTPS cu Creare webhook. Ai nevoie de scope-ul webhooks_manage. Cere echipei Aniva să îl adauge la cheia ta sau să configureze webhookul pentru tine.
  • Evenimentele acoperă fiecare status al unei programări și al unei comenzi de kit de testare la domiciliu, o oră sau o locație nouă și fiecare modificare a rezultatelor. results.completed îți spune că rezultatele sunt finale.
  • Evenimentele location.*, profile.* și shipment.* îți spun când apare, se modifică sau dispare o locație, un profil sau o expediere. O expediere trimite și shipment.<status> la fiecare schimbare de status.
  • Evenimentele conțin ID-uri și statusuri, niciodată valori de laborator sau date personale. Accesează url din eveniment pentru a obține datele.
  • Fiecare cerere este semnată cu schema Standard Webhooks.
  • Aniva reîncearcă o livrare eșuată de 10 ori pe parcursul a aproximativ trei zile. Poți lista și retrimite livrările timp de 30 de zile.
  • Fiecare rezultat din Obținere rezultate are acum un id, astfel încât poți actualiza rezultatul indicat de un eveniment results.updated.
  • Obținere locație returnează o locație după id. Câmpul url al unui eveniment location.* trimite către acest endpoint.
Vezi Webhookuri.
RezultatePanou de administrare

Trimite rezultatele pe e-mail clientului

Acum poți anunța pe e-mail un client că rezultatele sale de laborator sunt gata. Trimite e-mailul din pagina Rezultate de laborator din panoul de administrare sau prin două endpointuri noi: Trimitere rezultate pe e-mail pentru programări și Trimitere rezultate pe e-mail pentru comenzi de kituri de testare la domiciliu.
  • E-mailul poate avea atașate rapoartele de laborator ca fișiere PDF. Fiecare PDF este protejat cu parolă: parola este data nașterii clientului în format de 8 cifre (ZZLLAAAA), iar e-mailul precizează acest lucru.
  • Poți adăuga o notă personală de cel mult 1.000 de caractere.
  • Afișează numele și logo-ul grupului principal de profiluri al profilului, în limba profilului.
  • Fiecare trimitere înseamnă un e-mail. O reîncercare trimite încă unul. Ai nevoie de scope-ul results_view pentru acel client.

Primește un e-mail când rezultatele sunt gata

Când faci o programare sau comanzi un kit de testare la domiciliu de înlocuire în panoul de administrare, poți activa opțiunea „Trimite-mi un e-mail când rezultatele sunt gata”. Îți trimitem apoi un singur e-mail ție sau la orice adresă introduci, după ce sosesc toate rezultatele de laborator. E-mailul include un link către rezultat în panoul de administrare. Clientul nu primește acest e-mail. Ai nevoie de scope-ul results_view pentru acel client.Prin API, poți seta până la 5 adrese în results_ready_emails la Creare programare, Creare comandă de kit de testare la domiciliu, Actualizare programare și Actualizare comandă de kit de testare la domiciliu.
Kituri de testare la domiciliu

Trimite telefonul și e-mailul destinatarului cu fiecare kit

Dacă delivery_address pentru un kit de testare la domiciliu conține phone sau email, le transmitem curierului. Apoi curierul anunță destinatarul când coletul este pe drum sau așteaptă la un punct de ridicare. Dacă le omiți, curierul nu primește niciun contact, chiar dacă profilul are unul. Tu decizi cine primește notificările de la curier. Notificarea poate menționa Aniva Health ca expeditor.Vezi Creare comandă de kit de testare la domiciliu.
Locații

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

Patru locații noi pentru recoltări de sânge venos. Vezi Listare locații.
Panou de administrare

Pagina Rezultate de laborator

Noua pagină Rezultate de laborator din panoul de administrare listează fiecare recoltare de sânge și fiecare kit de testare la domiciliu activat, împreună cu rapoartele sale de laborator. Caută după nume, data nașterii sau codul de bare al eprubetei. Ai nevoie de scope-ul results_view și de o permisiune pentru kituri de testare la domiciliu ca să vezi kiturile.
Kituri de testare la domiciliu

Chei API doar pentru activare

Noul scope home_kit_orders_activate permite unei chei doar să activeze kituri de testare la domiciliu și nimic altceva. Nu poate crea, modifica sau anula un kit. Cere echipei Aniva o astfel de cheie dacă un sistem separat îți activează kiturile.Vezi Activare comandă de kit de testare la domiciliu.
APIModificare incompatibilă

Sexul trebuie să fie masculin sau feminin

Creare profil și Actualizare profil nu mai acceptă sex: 0 (necunoscut). Trimite 1 pentru masculin sau 2 pentru feminin; 0 returnează 400. Laboratorul are nevoie de sex pentru intervalele de referință, iar o comandă pentru un profil fără acesta nu putea ajunge la laborator.Vezi Creare profil.
Kituri de testare la domiciliu

Kituri care ajung la laborator fără activare

Dacă o probă ajunge la laborator înainte ca kitul să fie activat, Aniva activează kitul. activated_at este dimineața primului eveniment de urmărire al coletului de retur sau dimineața în care proba a ajuns la laborator, dacă nu există urmărire. Un apel ulterior de activare cu un alt activated_at returnează 409.Vezi Activare comandă de kit de testare la domiciliu.
API

Intervalele Aniva în rezultate

Endpointurile de rezultate completează acum reference_range_aniva cu valorile de comparație pe care Aniva le-a compilat, convertite în unitatea rezultatului. Valorile diferă în funcție de vârstă, sex și săptămâna de sarcină. Cheia ta are nevoie de scope-ul ANIVA_REFERENCE_RANGES_VIEW. Fără acesta, câmpul este null.Vezi Obținere rezultate programare.
APIKituri de testare la domiciliu

Kituri de înlocuire

Comandă un kit de înlocuire când un kit nu a putut furniza toate rezultatele. O înlocuire este o comandă nouă cu un cod de laborator nou și păstrează panelul comenzii inițiale. biomarker_ids stabilește ce analizează din nou laboratorul.Vezi Comenzi de kituri de testare la domiciliu.
APIPrețuriModificare incompatibilă

Un singur preț per biomarker și panel

Biomarkerii și panelurile au un singur price_cents conform grilei tale de tarife, alături de retail_cents:
  • > 0: se poate comanda separat.
  • 0: un raport (vezi requires) sau se poate comanda doar împreună cu alți markeri (vezi positions).
  • null: fără preț, deci nu se poate comanda.
Modificare incompatibilă: groups[] a fost eliminat din liste și din previzualizarea programării. Câmpurile de preț retail și yours au fost eliminate.Vezi Prețuri.
API

Chei de idempotență

Endpoint-urile de creare pentru profiluri, programări, comenzi de kituri de testare la domiciliu și expedieri acceptă un antet Idempotency-Key. O reîncercare cu aceeași cheie returnează primul răspuns și nu scrie nimic.Vezi Idempotență.
Locații

Aniva Hannover, Düsseldorf, Duisburg și Essen

Patru noi locații Aniva din Germania sunt deschise pentru recoltări de sânge venos: Hannover, Düsseldorf, Duisburg și Essen. Apelează Listare locații pentru a vedea locațiile la care cheia ta poate face programări.