Vai al contenuto principale
Una sede è un centro analisi fisico in cui il personale sanitario esegue i prelievi di sangue. Usi l’id di una sede per fissare appuntamenti practitioner.
La tua chiave API restituisce solo le sedi nel tuo contesto di accesso partner. Usa GET /api/v1/locations per elencare tutte le sedi disponibili per te.
Un webhook location.* ti avvisa quando una sede compare, cambia o scompare.

Campi

string
obbligatorio
UUID della sede. Passalo come location_id quando crei un appuntamento.
string
obbligatorio
Nome visualizzato della sede.
string
Clinica o azienda che gestisce la sede. Può essere null.
string
Nome della via, senza il numero civico. Può essere null.
string
Numero civico. Può essere null.
string
Riga di indirizzo aggiuntiva — c/o, edificio o piano. Può essere null.
string
Città. Può essere null.
string
Stato o provincia (risolto tramite lo stato collegato alla città). Può essere null quando la città non ha uno stato collegato.
string
Il codice ISO 3166-2 dello stato senza il prefisso del paese (es. BW per il Baden-Württemberg). Può essere null.
string
Codice postale o CAP. Può essere null.
string
Nome completo del paese (es. Germany). Può essere null.
string
Codice paese a due lettere secondo ISO 3166-1 alpha-2 (es. DE, US). Può essere null.
string
Identificatore del fuso orario IANA della sede (es. Europe/Berlin, America/New_York). Usalo per mostrare gli orari programmati nell’ora locale corretta. Può essere null.
number
Latitudine dell’indirizzo in gradi decimali (WGS 84). Può essere null.
number
Longitudine dell’indirizzo in gradi decimali (WGS 84). Può essere null.
string
Numero di telefono della sede. Può essere null.
string
Indirizzo email della sede. Può essere null.
string
URL del sito web della sede. Può essere null.
string
Link diretto alla sede su Google Maps. Può essere null.
string
URL di una foto della sede. Può essere null.
object
Orari di apertura settimanali della sede. Ogni chiave del giorno della settimana (monday–sunday) corrisponde a un array di fasce orarie { open, close } in formato HH:MM (24 ore). Un array vuoto indica che la sede è chiusa quel giorno. Può essere null se gli orari non sono disponibili per la sede.
string
obbligatorio
Come viene effettuato il prelievo di sangue durante un appuntamento in questa sede, salvo che l’appuntamento imposti il proprio draw_method: capillary (dal polpastrello o dalla parte superiore del braccio, in microprovette) o venous (dalla vena, in provette).
string[]
obbligatorio
I metodi di prelievo per cui la sede dispone di contenitori, ordinati. Un appuntamento in questa sede può impostare solo uno di questi come draw_method.
Usa sempre il campo timezone per convertire le date e gli orari di scheduled_at in ora locale prima di mostrarli ai pazienti o allo staff.

Disponibilità

Il campo open_hours qui sopra descrive gli orari di apertura settimanali statici. Per mostrare gli slot realmente prenotabili — ed evitare doppie prenotazioni rispetto agli appuntamenti Aniva esistenti — chiama Ottieni disponibilità per la sede e passa l’intervallo di date che vuoi mostrare. Quell’endpoint è la fonte di riferimento per qualsiasi interfaccia di prenotazione: espande open_hours sulla griglia di slot della sede, applica le eccezioni per singola data, sottrae gli appuntamenti già prenotati e applica il preavviso minimo.

Prezzi al pubblico

Ogni farmacia stabilisce il proprio prezzo per ciascun pannello e per ogni singolo biomarcatore che vende ai clienti senza appuntamento. Vedi un prezzo solo dopo che la farmacia lo pubblica. Elenca prezzi al pubblico li restituisce per ogni sede che puoi leggere, mentre Ottieni prezzi al pubblico li restituisce per una singola sede. Entrambi richiedono lo scope retail_prices_view; locations_view non li include. Richiedi entrambi gli scope sulle stesse sedi. Un webhook location.retail_prices.updated ti avvisa quando cambia un prezzo. location.created e location.deactivated ti avvisano quando una sede viene aggiunta o rimossa. Una modifica ai pannelli offerti da una sede può arrivarti dopo una variazione di prezzo, quindi leggi di nuovo Elenca prezzi al pubblico una volta al giorno.

Esempio di sede