I nomi dei contenitori nell’anteprima dell’appuntamento diventano nomi di prodotto
Dal prossimo rilascio,containers[].name in Anteprima appuntamento
è il nome di prodotto della provetta. type non cambia, quindi leggi type se la tua app confronta i contenitori.Aniva ora funziona in tutte le lingue dell’UE, e qualcuna in più
- Pannello admin, sito web, centro assistenza e documentazione: in tutte le 32 lingue.
- Profili: imposta la lingua di ogni paziente. La pagina dei risultati e le email dei risultati usano quella lingua.
Un unico endpoint Elenca pannelli
- Elenca pannelli ora restituisce
biomarker_groups. Usalo al posto di/api/v2/panels. - Crea pannello è stato rimosso. Usa il Pannello admin.
Mostra i risultati di laboratorio nella tua app
I tuoi pazienti ora possono vedere i loro risultati di laboratorio nella tua app: l’elenco dei biomarcatori, l’andamento di ogni biomarcatore e un Twin 3D con un voto per area della salute. La pagina usa il colore del tuo brand e il tuo logo, in modalità chiara o scura.La pagina dei risultati è un componente aggiuntivo a pagamento e il tuo referente in Aniva può indicarti il prezzo. Crea sessione embed mostra come configurarla.Le letture API di elenco sono in cache fino a 5 minuti
Questi quattro endpoint ora memorizzano la risposta in cache fino a 5 minuti, quindi una modifica può richiedere fino a 5 minuti per comparire:Gli endpointGet continuano a mostrare le modifiche direttamente.Se esegui il polling dell’API per trovare le modifiche, usa invece i webhook. Un
webhook ti avvisa di ogni modifica nel momento in cui avviene. Vedi
Letture ripetute.Gli intervalli Aniva sono ora disponibili
I tuoi risultati ora possono includere gli intervalli Aniva: un intervallo generale e uno più ristretto per ogni biomarcatore, con le fonti registrate da Aniva. Gli intervalli variano in base a età, sesso e settimana di gravidanza.Per ottenere l’accesso, firma il breve accordo sugli intervalli Aniva. Poi li attiviamo per la tua chiave API. Chiedi l’accordo al tuo referente in Aniva.Gli intervalli si trovano nel nuovo campoaniva_range. Sostituisce reference_range_aniva, che era
sempre null. Gli intervalli sono informazioni generali. Non valutano un risultato e non sono
un consiglio medico né un dispositivo medico. L’intervallo del laboratorio resta lo standard. Vedi
Intervalli Aniva.La provetta al fluoruro ora è fluoride
Anteprima contenitori chiama fluoride la provetta al fluoruro.
Il vecchio valore era naf. Se il tuo codice confronta container.type con naf, cambialo in
fluoride.Possono comparire due nuovi valori: lihep_capillary e fluoride_capillary. Sono la provetta
capillare con litio eparina e la provetta capillare al fluoruro.Niente più doppie prenotazioni dell’ultimo slot
Se due prenotazioni per l’ultimo posto di uno slot arrivano nello stesso momento, solo una va a buon fine. L’altra riceve409, come per qualsiasi slot pieno. Lo stesso vale quando un appuntamento viene modificato
mentre è in corso di annullamento o conferma.Conferma prelievo di sangue ha tre nuovi motivi 409:remapped: il codice ora corrisponde a pannelli diversi da prima.sent_to_labeorder_in_flight: il laboratorio può già avere l’ordine, quindi il codice deve restare sulla sua provetta.
Indirizzi di consegna più rigorosi per gli ordini di kit domiciliari
Crea kit domiciliare e Aggiorna kit domiciliare controllanodelivery_address in modo più rigoroso.country_codeaccetta il minuscolo, ad es.de. Aniva lo salva e lo restituisce in maiuscolo.- Un indirizzo tedesco (
DE) richiede unpostal_codedi esattamente 5 cifre. Altri valori ricevono un400. - Gli spazi intorno a
postal_codevengono rimossi prima di salvarlo.
Un nuovo kit per un kit rimandato indietro
Quando il corriere ci rimanda indietro un kit, non aspettiamo più il pacco. Dicci che vuoi di nuovo il kit e te ne spediamo subito uno nuovo. Puoi anche crearlo tu: chiama Crea kit domiciliare conreplaces_home_kit_order_id impostato sul kit restituito. Il nuovo kit è un ordine separato con un
nuovo codice kit.Controlliamo il pacco restituito quando arriva. Poi il kit restituito passa a cancelled e vedi
cosa c’era nel pacco.Invia un’email al tuo team quando i risultati sono pronti
Chiedici di impostare un indirizzo email predefinito per il tuo gruppo di profili, ad esempio la casella del tuo team. Riceverà così un’email quando i risultati di una nuova prenotazione sono pronti. Vale per le prenotazioni dal pannello admin, dall’API e dai tuoi pazienti.Per cambiarlo per una singola prenotazione:- Pannello admin: modifica gli indirizzi email o disattiva “Inviami un’email quando i risultati sono pronti”.
- API: invia una lista in
results_ready_emailsper usare invece quegli indirizzi email. Per mantenere il tuo indirizzo email predefinito, includilo nella lista. Invia[]per non inviare email.
Il paziente inserisce data di nascita e sesso
Ora possiamo consentire al tuo gruppo di profili di creare un profilo senzadate_of_birth e
sex. Il paziente inserisce entrambi nella pagina di attivazione del kit, digitando la data di
nascita due volte. Chiedici di attivare questa opzione. Vedi
Profili.Kit rimandati indietro
Quando il corriere ci rimanda indietro un kit, ora la pagina Kit domiciliari lo mostra. Filtra per Rimandato indietro per vedere tutti i kit che il corriere ci ha restituito, con il motivo indicato dal corriere. La spedizione termina infault e genera shipment.fault, non più
delivered. Quando apriamo il pacco, vedi anche cosa c’era dentro: completo, con una parte
mancante o aperto. Così sai se il tuo cliente riceve un rimborso completo.Vuoi che rispediamo il kit? Scrivici indicando il codice kit e l’indirizzo di consegna corretto.
Lo spediamo con lo stesso codice kit.Unità logaritmiche
Elenca unità restituisce un terzounit_type: logarithmic, per un
valore che è il logaritmo di una grandezza, come il pH o un indice aterogenico. Trattalo come
physical quando lo visualizzi. Non scalarlo: due unità logaritmiche differiscono per un offset,
non per un fattore.Calcola il preventivo di un kit domiciliare con i costi
Preventivo carrello accettafulfilment. Invia home_kit con un
country_code e il conto aggiunge le voci del kit addebitate nella tua fattura mensile per un
ordine: il costo del kit, i dispositivi di raccolta, le spese postali di andata e ritorno per quel
paese, la custodia e una bustina di lancette di ricambio. L’impostazione predefinita resta un
draw in una sede con i costi dell’appuntamento. La risposta indica quale ha calcolato in
fulfilment.kind.Scopri Aniva Concierge
D’ora in poi il nostro changelog appare anche nel tuo canale Slack con noi, appena rilasciamo qualcosa.Abbiamo anche creato Aniva Concierge. Hai una domanda sull’API o sul pannello admin? Menziona @Aniva su Slack o rispondi sotto un post del changelog. Consulta la nostra documentazione e ti dice dove cliccare nel pannello admin, oppure quale endpoint e quali filtri usare, con un link alla pagina.Elenca gli appuntamenti di un giorno
Elenca appuntamenti accetta due nuovi filtri.date
(YYYY-MM-DD) restituisce un giorno di calendario, nel fuso orario della sede di ciascun
appuntamento, partendo dal primo. location_id restituisce una sede per gli esami. Usali
entrambi per il programma di oggi di una sede.I profili duplicati vengono rifiutati
Crea profilo ora restituisce409 con
error_name: "duplicate_profile_error" quando un profilo visibile alla tua chiave ha lo stesso
nome, cognome, sesso e data di nascita. La risposta indica il profile_id esistente. Usalo invece
di creare un secondo profilo. I cognomi della sandbox sono esenti.Catalogo esami con i tuoi prezzi
Il nuovo Catalogo esami nel pannello admin elenca ogni biomarcatore con i suoi laboratori, le provette e il prezzo nel tuo listino.Perché un risultato non ha un intervallo di laboratorio
Ogni risultato clinico in Ottieni risultati e Ottieni risultati di laboratorio per i kit domiciliari ora hareference_range_lab_absent_reason. Indica perché reference_range_lab è null:not_provided: non esiste alcun intervallo. Mostra “Non applicabile”.lab_text_only: il laboratorio ha riportato solo testo, ad esempio un target o una fascia di rischio. Mostralab_reported.reference_range.not_measured: il risultato èundeliverable.
null quando è presente un intervallo. Vedi
Risultati.Prezzi al pubblico e coordinate
- Le sedi ora hanno
state_code,latitudeelongitude. - Elenca prezzi al pubblico e Ottieni prezzi al pubblico restituiscono il prezzo di ogni pannello che una farmacia vende ai clienti senza appuntamento.
- Il webhook
location.retail_prices.updatedti avvisa quando un prezzo cambia.
retail_prices_view.Ordina kit domiciliari nel pannello admin
Ora puoi ordinare un kit domiciliare per il tuo paziente nella pagina Kit domiciliari nel pannello admin. Scegli o crea il paziente, scegli il kit e inserisci l’indirizzo di consegna. Da lì puoi anche annullare un kit.Listino prezzi e preventivi
- Ottieni listino prezzi restituisce le tue tariffe sul catalogo Aniva e le tue spese.
- Preventivo carrello calcola il prezzo di pannelli e biomarcatori senza un appuntamento.
- Il conto in Preventivo carrello e Anteprima appuntamento ora include
fees,total_with_fees_centse unnamein ogni riga di biomarcatore. rate_cardnegli elenchi accetta l’iddi Ottieni listino prezzi.
prices_view.Più dettagli sui documenti
Ogni voce indocuments di Ottieni risultati ora include:file_name: il nome usato da Scarica documento.- Nuovi:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, ad esempio il referto finale di Labor Quade
(_E) dopo quello preliminare (_V).Webhook
Ora Aniva chiama il tuo server quando un appuntamento, un ordine di kit domiciliare, i suoi risultati, una sede, un profilo o una spedizione cambiano. Non devi più fare polling.- Registra un URL HTTPS con
Crea webhook. Ti serve lo
scope
webhooks_manage. Chiedi ad Aniva di aggiungerlo alla tua chiave o di configurare il webhook per te. - Gli eventi coprono ogni stato di un appuntamento e di un ordine di kit domiciliare, un nuovo orario o una nuova sede e
ogni modifica dei risultati.
results.completedti avvisa che i risultati sono definitivi. - Gli eventi
location.*,profile.*eshipment.*ti avvisano quando vengono aggiunti, modificati o rimossi una sede, un profilo o una spedizione. Una spedizione invia ancheshipment.<status>a ogni cambio di stato. - Gli eventi contengono ID e stati, mai valori di laboratorio né dati personali. Leggi
urlnell’evento per ottenere i dati. - Ogni richiesta è firmata con lo schema Standard Webhooks.
- Aniva ritenta una consegna non riuscita 10 volte nell’arco di circa tre giorni. Puoi elencare e inviare di nuovo le consegne per 30 giorni.
- Ogni risultato in Ottieni risultati ora ha un
id, così puoi aggiornare il risultato a cui punta un eventoresults.updated. - Ottieni sede restituisce una sede tramite il suo
id. L’urldi un eventolocation.*punta lì.
Invia i risultati via email al cliente
Ora puoi inviare un’email a un cliente per avvisarlo che i suoi risultati di laboratorio sono pronti. Inviala dalla pagina Risultati di laboratorio nel pannello admin oppure tramite due nuovi endpoint: Invia risultati via email per gli appuntamenti e Invia risultati via email per gli ordini di kit domiciliari.- L’email può allegare i referti di laboratorio come file PDF. Ogni PDF è protetto da password: la password è la data di nascita del cliente in 8 cifre (GGMMAAAA), e l’email lo indica.
- Puoi aggiungere una nota personale di al massimo 1.000 caratteri.
- Mostra il nome e il logo del gruppo di profili principale del profilo, nella lingua del profilo.
- Ogni invio è un’email. Un nuovo tentativo ne invia una seconda. Ti serve lo scope
results_viewper quel cliente.
Ricevi un’email quando i risultati sono pronti
Quando prenoti un appuntamento o ordini un kit domiciliare sostitutivo nel pannello admin, puoi attivare “Inviami un’email quando i risultati sono pronti”. Inviamo poi un’email a te, o a qualsiasi indirizzo inserisci, appena arrivano tutti i risultati di laboratorio. L’email contiene un link al risultato nel pannello admin. Il cliente non riceve questa email. Ti serve lo scoperesults_view per quel cliente.Tramite API, puoi impostare fino a 5 indirizzi in results_ready_emails su
Crea appuntamento,
Crea ordine di kit domiciliare,
Aggiorna appuntamento e
Aggiorna ordine di kit domiciliare.Invia telefono ed email del destinatario con ogni kit
Sedelivery_address di un kit domiciliare contiene phone o email, li trasmettiamo al corriere. Il
corriere avvisa quindi il destinatario quando il pacco è in viaggio o è pronto presso un punto di ritiro. Se li
ometti, il corriere non riceve alcun contatto, anche se il profilo ne ha uno. Decidi tu chi riceve le
notifiche del corriere. La notifica può indicare Aniva Health come mittente.Vedi Crea ordine di kit domiciliare.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim e Wiesbaden
Quattro nuove sedi per i prelievi di sangue venoso. Vedi Elenca sedi.Pagina Risultati di laboratorio
La nuova pagina Risultati di laboratorio nel pannello admin elenca ogni prelievo di sangue e ogni kit domiciliare attivato con i relativi referti di laboratorio. Cerca per nome, data di nascita o codice a barre della provetta. Ti serve lo scoperesults_view e un’autorizzazione per i kit domiciliari per vedere i kit.Chiavi API solo per l’attivazione
Il nuovo scopehome_kit_orders_activate consente a una chiave di attivare i kit domiciliari e nient’altro. Non può
creare, modificare o annullare un kit. Chiedi questa chiave ad Aniva se un sistema separato attiva i tuoi kit.Vedi Attiva ordine di kit domiciliare.Il sesso deve essere maschile o femminile
Crea profilo e Aggiorna profilo non accettano piùsex: 0 (sconosciuto). Invia 1 per maschile o 2
per femminile; 0 restituisce 400. Il laboratorio ha bisogno del sesso per gli intervalli di riferimento e un ordine
per un profilo che ne è privo non poteva raggiungere il laboratorio.Vedi Crea profilo.Kit che arrivano in laboratorio senza attivazione
Se un campione arriva al laboratorio prima che il suo kit sia attivato, Aniva attiva il kit.activated_at è la mattina del primo evento di tracciamento del pacco di reso, o la mattina in cui
il campione è arrivato al laboratorio se non c’è tracciamento. Una successiva chiamata di attivazione con un
activated_at diverso restituisce 409.Vedi Attiva ordine di kit domiciliare.Intervalli Aniva nei risultati
Gli endpoint dei risultati ora popolanoreference_range_aniva con i valori di confronto raccolti da
Aniva, convertiti nell’unità di misura del risultato. I valori variano in base a età, sesso e settimana di
gravidanza. La tua chiave richiede lo scope ANIVA_REFERENCE_RANGES_VIEW. Senza questo scope, il campo è null.Vedi Ottieni risultati dell’appuntamento.Kit sostitutivi
Ordina un kit sostitutivo quando un kit non è riuscito a fornire tutti i risultati. Una sostituzione è un nuovo ordine con un nuovo codice di laboratorio e mantiene il pannello dell’ordine originale.biomarker_ids imposta ciò che il
laboratorio analizza di nuovo.Vedi Ordini di kit domiciliari.Un prezzo per biomarcatore e pannello
Biomarcatori e pannelli hanno un unicoprice_cents in base al tuo listino prezzi, con retail_cents
accanto:> 0: ordinabile singolarmente.0: un rapporto (vedirequires), oppure ordinabile solo con altri marcatori (vedipositions).null: senza prezzo, quindi non ordinabile.
groups[] viene rimosso dagli elenchi e dall’anteprima dell’appuntamento. I
campi di prezzo retail e yours vengono rimossi.Vedi Prezzi.Chiavi di idempotenza
Gli endpoint di creazione per profili, appuntamenti, ordini di kit domiciliari e spedizioni accettano un headerIdempotency-Key. Un nuovo tentativo con la stessa chiave restituisce la prima risposta e non
scrive nulla.Vedi Idempotenza.
