> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Locații

> Cum funcționează locațiile de testare în API-ul Aniva: farmacii și cabinete care fac recoltări de sânge, program de funcționare, disponibilitate și prețuri cu amănuntul.

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

> [!NOTE]
>
> 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](https://docs.anivahealth.com/ro/concepts/webhooks.md) `location.*` te anunță când o locație apare, se modifică sau dispare.

## Câmpuri

**id** `string` *required*

UUID-ul locației. Trimite această valoare ca `location_id` atunci când creezi o programare.

**name** `string` *required*

Numele de afișare al locației.

**company\_name** `string`

Clinica sau compania care operează locația. Poate fi null.

**street** `string`

Numele străzii, fără numărul casei. Poate fi null.

**house\_number** `string`

Numărul casei. Poate fi null.

**address\_line\_2** `string`

Linie suplimentară de adresă — c/o, clădire sau etaj. Poate fi null.

**city** `string`

Orașul. Poate fi null.

**state** `string`

Statul sau provincia (obținut prin statul asociat orașului). Poate fi null atunci când orașul nu
are un stat asociat.

**state\_code** `string`

Codul [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) al statului, fără
prefixul de țară (de ex., `BW` pentru Baden-Württemberg). Poate fi null.

**postal\_code** `string`

Cod poștal sau cod ZIP. Poate fi null.

**country\_name** `string`

Numele complet al țării (de ex., `Germany`). Poate fi null.

**country\_code** `string`

Codul de țară din două litere conform [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(de ex., `DE`, `US`). Poate fi null.

**timezone** `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.

**latitude** `number`

Latitudinea adresei în grade zecimale (WGS 84). Poate fi null.

**longitude** `number`

Longitudinea adresei în grade zecimale (WGS 84). Poate fi null.

**contact\_phone** `string`

Numărul de telefon al locației. Poate fi null.

**email** `string`

Adresa de e-mail a locației. Poate fi null.

**website** `string`

URL-ul site-ului locației. Poate fi null.

**google\_maps\_url** `string`

Link direct către locație pe Google Maps. Poate fi null.

**image\_url** `string`

URL-ul unei fotografii a locației. Poate fi null.

**open\_hours** `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.

**default\_draw\_method** `string` *required*

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

**draw\_methods** `string[]` *required*

Metodele de recoltare pentru care locația are recipiente pe stoc, sortate. O programare aici
poate seta doar una dintre acestea ca `draw_method`.

> [!TIP]
>
> 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](https://docs.anivahealth.com/ro/api/locations/get-availability.md) 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](https://docs.anivahealth.com/ro/api/appointments/create-appointment.md#preaviz-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](https://docs.anivahealth.com/ro/api/locations/list-retail-prices.md) le returnează pentru fiecare locație
pe care o poți citi, iar [Obține prețurile cu amănuntul](https://docs.anivahealth.com/ro/api/locations/get-retail-prices.md) 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](https://docs.anivahealth.com/ro/concepts/webhooks.md) `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

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Mitte Health Center",
  "company_name": "Aniva Berlin GmbH",
  "street": "Friedrichstraße",
  "house_number": "100",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "state_code": "BE",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "latitude": 52.531677,
  "longitude": 13.388042,
  "contact_phone": "+493012345678",
  "email": "berlin@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Friedrichstra%C3%9Fe+100+Berlin",
  "image_url": "https://anivahealth.com/images/locations/berlin-mitte.jpg",
  "open_hours": {
    "monday": [{ "open": "08:00", "close": "18:00" }],
    "tuesday": [{ "open": "08:00", "close": "18:00" }],
    "wednesday": [{ "open": "08:00", "close": "18:00" }],
    "thursday": [{ "open": "08:00", "close": "18:00" }],
    "friday": [{ "open": "08:00", "close": "16:00" }],
    "saturday": [],
    "sunday": []
  },
  "default_draw_method": "venous",
  "draw_methods": ["venous"]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.