Saltar al contingut principal
Una ubicació és un centre físic de proves on professionals sanitaris fan extraccions de sang. Fas servir l’id d’una ubicació per programar cites practitioner.
La teva clau d’API només retorna les ubicacions del teu context d’accés de soci. Fes servir GET /api/v1/locations per llistar totes les ubicacions disponibles per a tu.
Un webhook location.* t’avisa quan una ubicació apareix, canvia o desapareix.

Camps

string
requerit
UUID de la ubicació. Passa’l com a location_id quan creïs una cita.
string
requerit
Nom visible de la ubicació.
string
Clínica o empresa que gestiona la ubicació. Pot ser nul.
string
Nom del carrer, sense el número de portal. Pot ser nul.
string
Número de portal. Pot ser nul.
string
Línia d’adreça addicional — a l’atenció de, edifici o planta. Pot ser nul.
string
Ciutat. Pot ser nul.
string
Estat o província (resolt a través de l’estat vinculat a la ciutat). Pot ser nul quan la ciutat no té cap estat vinculat.
string
Codi ISO 3166-2 de l’estat sense el prefix del país (p. ex., BW per a Baden-Württemberg). Pot ser nul.
string
Codi postal o ZIP. Pot ser nul.
string
Nom complet del país (p. ex., Germany). Pot ser nul.
string
Codi de país de dues lletres segons ISO 3166-1 alfa-2 (p. ex., DE, US). Pot ser nul.
string
Identificador de fus horari IANA de la ubicació (p. ex., Europe/Berlin, America/New_York). Fes-lo servir per mostrar les hores programades en l’hora local correcta. Pot ser nul.
number
Latitud de l’adreça en graus decimals (WGS 84). Pot ser nul·la.
number
Longitud de l’adreça en graus decimals (WGS 84). Pot ser nul·la.
string
Número de telèfon de la ubicació. Pot ser nul.
string
Adreça electrònica de la ubicació. Pot ser nul·la.
string
URL del lloc web de la ubicació. Pot ser nul·la.
string
Enllaç directe a la ubicació a Google Maps. Pot ser nul.
string
URL d’una foto de la ubicació. Pot ser nul·la.
object
Horari d’obertura setmanal de la ubicació. Cada clau de dia de la setmana (monday–sunday) correspon a una matriu de franges horàries { open, close } en format HH:MM (24 h). Una matriu buida indica que la ubicació està tancada aquell dia. Pot ser nul si l’horari no està disponible per a la ubicació.
string
requerit
Com es fa l’extracció de sang en una cita aquí, llevat que la cita defineixi el seu propi draw_method: capillary (punta del dit o part superior del braç, en microtubs) o venous (de la vena, en tubs).
string[]
requerit
Els mètodes d’extracció per als quals la ubicació disposa de contenidors, ordenats. Una cita aquí només pot definir un d’aquests com a draw_method.
Fes servir sempre el camp timezone per convertir les dates i hores scheduled_at a l’hora local abans de mostrar-les als pacients o al personal.

Disponibilitat

El camp open_hours anterior descriu l’horari d’obertura setmanal estàtic. Per mostrar franges reals que es puguin reservar —i evitar reserves duplicades amb cites d’Aniva existents— crida Obtenir la disponibilitat per a la ubicació i passa-li l’interval de dates que vols mostrar. Aquest endpoint és la font de referència per a qualsevol interfície de reserva: desplega open_hours sobre la graella de franges de la ubicació, aplica les excepcions per data, resta les cites ja reservades i aplica l’antelació mínima.

Preus de venda al públic

Una farmàcia fixa el seu propi preu per a cada panell, i per a cada biomarcador individual, que ven a clients de pas. Només veus un preu quan la farmàcia el publica. Llistar els preus de venda al públic els retorna per a cada ubicació que pots llegir, i Obtenir els preus de venda al públic els retorna per a una ubicació. Tots dos necessiten l’abast retail_prices_view; locations_view no els inclou. Demana tots dos abastos per a les mateixes ubicacions. Un webhook location.retail_prices.updated t’avisa quan canvia un preu. location.created i location.deactivated t’avisen quan apareix o desapareix una ubicació. Un canvi en els panells que ofereix una ubicació et pot arribar més tard que un canvi de preu, així que torna a consultar Llistar els preus de venda al públic un cop al dia.

Exemple d’ubicació