Vai al contenuto principale
API

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.
Pannello adminAPI

Aniva ora funziona in tutte le lingue dell’UE, e qualcuna in più

API

Un unico endpoint Elenca pannelli

API

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.
API

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 endpoint Get 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.
Pannello admin

Vedi quando passa il corriere per i tuoi campioni

Il pannello admin ora mostra il prossimo ritiro del corriere presso il tuo studio, con tracciamento ed etichetta.Pannello admin con un banner in alto: GO! arriva domani ~10:00–12:00.Pannello admin con un banner in alto: GO! arriva domani ~10:00–12:00.
API

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 campo aniva_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.
API

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.
API

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 riceve 409, 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_lab e order_in_flight: il laboratorio può già avere l’ordine, quindi il codice deve restare sulla sua provetta.
APIKit domiciliari

Indirizzi di consegna più rigorosi per gli ordini di kit domiciliari

Crea kit domiciliare e Aggiorna kit domiciliare controllano delivery_address in modo più rigoroso.
  • country_code accetta il minuscolo, ad es. de. Aniva lo salva e lo restituisce in maiuscolo.
  • Un indirizzo tedesco (DE) richiede un postal_code di esattamente 5 cifre. Altri valori ricevono un 400.
  • Gli spazi intorno a postal_code vengono rimossi prima di salvarlo.
Pannello adminKit domiciliariAPI

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 con replaces_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.
RisultatiAPIPannello admin

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_emails per usare invece quegli indirizzi email. Per mantenere il tuo indirizzo email predefinito, includilo nella lista. Invia [] per non inviare email.
Vedi Email di risultati pronti.
APIKit domiciliari

Il paziente inserisce data di nascita e sesso

Ora possiamo consentire al tuo gruppo di profili di creare un profilo senza date_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.
Pannello admin

Un pannello admin più veloce

Il pannello admin mostra ora il primo contenuto in circa 0,2 s, rispetto a 1,3 s di prima. Niente più icone di caricamento. Le pagine si riempiono man mano che arrivano i dati. Le pagine iniziano a caricarsi quando passi con il mouse su un link.
Pannello adminKit domiciliariWebhook

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 in fault 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.
API

Unità logaritmiche

Elenca unità restituisce un terzo unit_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.
APIPrezzi

Calcola il preventivo di un kit domiciliare con i costi

Preventivo carrello accetta fulfilment. 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.
Concierge

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.
APIAppuntamenti

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.
APIProfili

I profili duplicati vengono rifiutati

Crea profilo ora restituisce 409 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.
Sedi

Aniva Berlin Mitte chiude

Dal 1° novembre 2026, Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) non offre più appuntamenti. La sede più vicina è Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Pannello adminPrezzi

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.
APIRisultati

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 ha reference_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. Mostra lab_reported.reference_range.
  • not_measured: il risultato è undeliverable.
È null quando è presente un intervallo. Vedi Risultati.
APISedi

Prezzi al pubblico e coordinate

Gli endpoint e l’evento per i prezzi al pubblico richiedono lo scope retail_prices_view.
Kit domiciliariPannello admin

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.
APIPrezzi

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_cents e un name in ogni riga di biomarcatore.
  • rate_card negli elenchi accetta l’id di Ottieni listino prezzi.
Entrambi i nuovi endpoint richiedono lo scope prices_view.
APIRisultati

Più dettagli sui documenti

Ogni voce in documents di Ottieni risultati ora include:
  • file_name: il nome usato da Scarica documento.
  • Nuovi: original_file_name, origin, content_type, etag, size_bytes.
Un referto PDF sostituito ora invia results.updated, ad esempio il referto finale di Labor Quade (_E) dopo quello preliminare (_V).
APIWebhook

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.completed ti avvisa che i risultati sono definitivi.
  • Gli eventi location.*, profile.* e shipment.* ti avvisano quando vengono aggiunti, modificati o rimossi una sede, un profilo o una spedizione. Una spedizione invia anche shipment.<status> a ogni cambio di stato.
  • Gli eventi contengono ID e stati, mai valori di laboratorio né dati personali. Leggi url nell’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 evento results.updated.
  • Ottieni sede restituisce una sede tramite il suo id. L’url di un evento location.* punta lì.
Vedi Webhook.
RisultatiPannello admin

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_view per 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 scope results_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.
Kit domiciliari

Invia telefono ed email del destinatario con ogni kit

Se delivery_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.
Sedi

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

Quattro nuove sedi per i prelievi di sangue venoso. Vedi Elenca sedi.
Pannello admin

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 scope results_view e un’autorizzazione per i kit domiciliari per vedere i kit.
Kit domiciliari

Chiavi API solo per l’attivazione

Il nuovo scope home_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.
APIModifica incompatibile

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 domiciliari

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.
API

Intervalli Aniva nei risultati

Gli endpoint dei risultati ora popolano reference_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.
APIKit domiciliari

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.
APIPrezziModifica incompatibile

Un prezzo per biomarcatore e pannello

Biomarcatori e pannelli hanno un unico price_cents in base al tuo listino prezzi, con retail_cents accanto:
  • > 0: ordinabile singolarmente.
  • 0: un rapporto (vedi requires), oppure ordinabile solo con altri marcatori (vedi positions).
  • null: senza prezzo, quindi non ordinabile.
Modifica incompatibile: groups[] viene rimosso dagli elenchi e dall’anteprima dell’appuntamento. I campi di prezzo retail e yours vengono rimossi.Vedi Prezzi.
API

Chiavi di idempotenza

Gli endpoint di creazione per profili, appuntamenti, ordini di kit domiciliari e spedizioni accettano un header Idempotency-Key. Un nuovo tentativo con la stessa chiave restituisce la prima risposta e non scrive nulla.Vedi Idempotenza.
Sedi

Aniva Hannover, Düsseldorf, Duisburg ed Essen

Quattro nuove sedi Aniva in Germania sono aperte per i prelievi di sangue venosi: Hannover, Düsseldorf, Duisburg ed Essen. Chiama Elenca sedi per vedere le sedi che la tua chiave può prenotare.