Salt la conținutul principal
O locație este un centru fizic de testare unde personalul medical efectuează recoltări de sânge. Folosești id-ul unei locații pentru a face programări de tip practitioner.
Cheia ta API returnează doar locațiile din contextul tău de acces ca partener. Folosește GET /api/v1/locations pentru a lista toate locațiile disponibile pentru tine.
Un webhook location.* te anunță când o locație apare, se modifică sau dispare.

Câmpuri

string
obligatoriu
UUID-ul locației. Trimite această valoare ca location_id atunci când creezi o programare.
string
obligatoriu
Numele de afișare al locației.
string
Clinica sau compania care operează locația. Poate fi null.
string
Numele străzii, fără numărul casei. Poate fi null.
string
Numărul casei. Poate fi null.
string
Linie suplimentară de adresă — c/o, clădire sau etaj. Poate fi null.
string
Orașul. Poate fi null.
string
Statul sau provincia (obținut prin statul asociat orașului). Poate fi null atunci când orașul nu are un stat asociat.
string
Codul ISO 3166-2 al statului, fără prefixul de țară (de ex., BW pentru Baden-Württemberg). Poate fi null.
string
Cod poștal sau cod ZIP. Poate fi null.
string
Numele complet al țării (de ex., Germany). Poate fi null.
string
Codul de țară din două litere conform ISO 3166-1 alpha-2 (de ex., DE, US). Poate fi null.
string
Identificatorul de fus orar IANA al locației (de ex., Europe/Berlin, America/New_York). Folosește-l pentru a afișa orele programate la ora locală corectă. Poate fi null.
number
Latitudinea adresei în grade zecimale (WGS 84). Poate fi null.
number
Longitudinea adresei în grade zecimale (WGS 84). Poate fi null.
string
Numărul de telefon al locației. Poate fi null.
string
Adresa de e-mail a locației. Poate fi null.
string
URL-ul site-ului locației. Poate fi null.
string
Link direct către locație pe Google Maps. Poate fi null.
string
URL-ul unei fotografii a locației. Poate fi null.
object
Programul săptămânal al locației. Fiecare cheie a zilei săptămânii (monday–sunday) corespunde unui array de intervale orare { open, close } în format HH:MM (24 h). Un array gol înseamnă că locația este închisă în ziua respectivă. Poate fi null dacă programul nu este disponibil pentru locație.
string
obligatoriu
Modul în care se recoltează sângele la o programare aici, dacă programarea nu setează propriul draw_method: capillary (din vârful degetului sau din partea superioară a brațului, în microtuburi) sau venous (din venă, în eprubete).
string[]
obligatoriu
Metodele de recoltare pentru care locația are recipiente pe stoc, sortate. O programare aici poate seta doar una dintre acestea ca draw_method.
Folosește întotdeauna câmpul timezone pentru a converti datele și orele din scheduled_at la ora locală înainte de a le afișa pacienților sau personalului.

Disponibilitate

Câmpul open_hours de mai sus descrie programul săptămânal static. Pentru a afișa intervale reale care pot fi rezervate — și pentru a evita suprapunerea cu programările Aniva existente — apelează Obține disponibilitatea pentru locație și trimite intervalul de date pe care vrei să îl afișezi. Acest endpoint este sursa corectă de adevăr pentru orice interfață de programare: extinde open_hours pe grila de intervale a locației, aplică excepțiile pe date specifice, scade programările deja făcute și aplică preavizul minim.

Prețuri cu amănuntul

O farmacie își stabilește propriul preț pentru fiecare panel și pentru fiecare biomarker individual pe care îl vinde clienților din farmacie. Vezi un preț abia după ce farmacia îl publică. Listează prețurile cu amănuntul le returnează pentru fiecare locație pe care o poți citi, iar Obține prețurile cu amănuntul le returnează pentru o singură locație. Ambele necesită scope-ul retail_prices_view; locations_view nu le include. Solicită ambele scope-uri pentru aceleași locații. Un webhook location.retail_prices.updated te anunță când se schimbă un preț. location.created și location.deactivated te anunță când apare sau dispare o locație. O modificare a panelurilor oferite de o locație poate ajunge la tine mai târziu decât o modificare de preț, așa că citește din nou Listează prețurile cu amănuntul o dată pe zi.

Exemplu de locație