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.Aniva funcționează acum în toate limbile UE și încă câteva
- Panelul de administrare, site-ul web, centrul de ajutor și documentația: în toate cele 32 de limbi.
- Profiluri: setează limba fiecărui pacient. Pagina de rezultate și e-mailurile cu rezultate o folosesc.
Un singur endpoint de listare a panelurilor
- Listare paneluri returnează acum
biomarker_groups. Folosește-l în locul/api/v2/panels. - Crearea de paneluri a fost eliminată. Folosește Panoul de administrare.
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.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ă:- Listare expedieri
- Listare comenzi de kituri de testare la domiciliu
- Listare programări
- Listare profiluri
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.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âmpaniva_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.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ă.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ște409, 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șiorder_in_flight: laboratorul poate avea deja comanda, deci codul trebuie să rămână pe eprubeta sa.
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_codeacceptă litere mici, de ex.de. Aniva îl stochează și îl returnează cu litere mari.- O adresă din Germania (
DE) are nevoie de unpostal_codede exact 5 cifre. Alte valori primesc400. - Spațiile din jurul câmpului
postal_codesunt eliminate înainte să îl stocăm.
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 cureplaces_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.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_emailsca 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.
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.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 cufault ș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.Unități logaritmice
Listează unitățile returnează un al treileaunit_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.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.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ă.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.Profilurile duplicate sunt refuzate
Creează profil returnează acum409 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.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.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 acumreference_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 esteundeliverable.
null când există un interval. Vezi Rezultate.Prețuri de vânzare și coordonate
- Locațiile au acum
state_code,latitudeșilongitude. - Listează prețurile de vânzare și Obține prețurile de vânzare returnează prețul fiecărui panel pe care o farmacie îl vinde clienților care vin fără programare.
- Webhook-ul
location.retail_prices.updatedte anunță când se schimbă un preț.
retail_prices_view.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.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 unnamepe fiecare rând de biomarker. rate_carddin listări preiaiddin Obținere grilă de tarife.
prices_view.Mai multe detalii despre documente
Fiecare intrare dindocuments î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.
results.updated, de exemplu raportul final al Labor Quade
(_E) după cel preliminar (_V).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.*șishipment.*îți spun când apare, se modifică sau dispare o locație, un profil sau o expediere. O expediere trimite șishipment.<status>la fiecare schimbare de status. - Evenimentele conțin ID-uri și statusuri, niciodată valori de laborator sau date personale. Accesează
urldin 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 evenimentresults.updated. - Obținere locație returnează o locație după
id. Câmpulurlal unui evenimentlocation.*trimite către acest endpoint.
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_viewpentru 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-ulresults_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.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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim și Wiesbaden
Patru locații noi pentru recoltări de sânge venos. Vezi Listare locații.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-ulresults_view și de o permisiune pentru kituri de testare la domiciliu ca să vezi kiturile.Chei API doar pentru activare
Noul scopehome_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.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 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.Intervalele Aniva în rezultate
Endpointurile de rezultate completează acumreference_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.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.Un singur preț per biomarker și panel
Biomarkerii și panelurile au un singurprice_cents conform grilei tale de tarife, alături de
retail_cents:> 0: se poate comanda separat.0: un raport (vezirequires) sau se poate comanda doar împreună cu alți markeri (vezipositions).null: fără preț, deci nu se poate comanda.
groups[] a fost eliminat din liste și din previzualizarea programării.
Câmpurile de preț retail și yours au fost eliminate.Vezi Prețuri.Chei de idempotență
Endpoint-urile de creare pentru profiluri, programări, comenzi de kituri de testare la domiciliu și expedieri acceptă un antetIdempotency-Key. O reîncercare cu aceeași cheie returnează primul răspuns și nu
scrie nimic.Vezi Idempotență.
