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

# Atrašanās vietas

> Kā darbojas analīžu vietas Aniva API: aptiekas un prakses, kurās veic asins paņemšanu, darba laiks, pieejamība un mazumtirdzniecības cenas.

Atrašanās vieta ir fizisks testēšanas centrs, kurā veselības aprūpes speciālisti veic asins paņemšanu. Tu izmanto atrašanās vietas `id`, lai ieplānotu `practitioner` pierakstus.

> [!NOTE]
>
> Tava API atslēga atgriež tikai tās atrašanās vietas, kas ietilpst tavā partnera piekļuves kontekstā. Izmanto `GET
>     /api/v1/locations`, lai skatītu visas tev pieejamās atrašanās vietas.

`location.*` [webhook](https://docs.anivahealth.com/lv/concepts/webhooks.md) tev paziņo, kad atrašanās vieta parādās, mainās vai pazūd.

## Lauki

**id** `string` *required*

Atrašanās vietas UUID. Norādi to kā `location_id`, veidojot pierakstu.

**name** `string` *required*

Atrašanās vietas attēlojamais nosaukums.

**company\_name** `string`

Klīnika vai uzņēmums, kas pārvalda šo atrašanās vietu. Var būt null.

**street** `string`

Ielas nosaukums bez mājas numura. Var būt null.

**house\_number** `string`

Mājas numurs. Var būt null.

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

Papildu adreses rinda — c/o, ēka vai stāvs. Var būt null.

**city** `string`

Pilsēta. Var būt null.

**state** `string`

Štats vai province (noteikts pēc pilsētai piesaistītā štata). Var būt null, ja pilsētai nav
piesaistīta štata.

**state\_code** `string`

Štata vai federālās zemes [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) kods bez
valsts prefiksa (piem., `BW` — Baden-Württemberg). Var būt null.

**postal\_code** `string`

Pasta indekss vai ZIP kods. Var būt null.

**country\_name** `string`

Pilns valsts nosaukums (piem., `Germany`). Var būt null.

**country\_code** `string`

Divu burtu valsts kods saskaņā ar [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(piem., `DE`, `US`). Var būt null.

**timezone** `string`

Atrašanās vietas IANA laika joslas identifikators (piem., `Europe/Berlin`, `America/New_York`).
Izmanto to, lai ieplānotos laikus parādītu pareizajā vietējā laikā. Var būt null.

**latitude** `number`

Adreses ģeogrāfiskais platums decimālgrādos (WGS 84). Var būt null.

**longitude** `number`

Adreses ģeogrāfiskais garums decimālgrādos (WGS 84). Var būt null.

**contact\_phone** `string`

Atrašanās vietas tālruņa numurs. Var būt null.

**email** `string`

Atrašanās vietas e-pasta adrese. Var būt null.

**website** `string`

Atrašanās vietas tīmekļa vietnes URL. Var būt null.

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

Tiešā saite uz atrašanās vietu Google Maps. Var būt null.

**image\_url** `string`

Atrašanās vietas fotoattēla URL. Var būt null.

**open\_hours** `object`

Atrašanās vietas iknedēļas darba laiks. Katra nedēļas dienas atslēga (`monday`–`sunday`) atbilst
`{ open, close }` laika intervālu masīvam `HH:MM` (24 h) formātā. Tukšs masīvs nozīmē, ka šajā
dienā vieta ir slēgta. Var būt null, ja šai atrašanās vietai darba laiks nav pieejams.

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

Kā šeit notiek asins paņemšana pieraksta laikā, ja pierakstā nav norādīts savs `draw_method`:
`capillary` (no pirksta gala vai augšdelma mikrokonteineros) vai `venous` (no vēnas
stobriņos).

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

Asins paņemšanas metodes, kurām atrašanās vietā ir pieejami trauki, sakārtotas. Pierakstam šeit
kā `draw_method` var norādīt tikai vienu no tām.

> [!TIP]
>
> Vienmēr izmanto lauku `timezone`, lai pārvērstu `scheduled_at` datumus un laikus vietējā laikā,
> pirms tos rādi pacientiem vai personālam.

## Pieejamība

Augstāk norādītais lauks `open_hours` apraksta statisko iknedēļas darba grafiku. Lai parādītu reāli pieejamos pieraksta laikus — un izvairītos no dubultiem pierakstiem ar esošajiem Aniva pierakstiem —, izsauc [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md) attiecīgajai atrašanās vietai un padod datumu diapazonu, ko vēlies attēlot. Šis galapunkts ir īstais datu avots jebkurai pieraksta saskarnei: tas izklāj `open_hours` pa atrašanās vietas laika logu režģi, piemēro konkrētu datumu izņēmumus, atņem jau rezervētos pierakstus un piemēro [minimālo iepriekšējās pieteikšanās laiku](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md#minimalais-pieteiksanas-laiks).

## Mazumtirdzniecības cenas

Aptieka pati nosaka cenu katram panelim un katram atsevišķam biomarķierim, ko tā pārdod klientiem
uz vietas. Tu redzi cenu tikai pēc tam, kad aptieka to publicē.
[Mazumtirdzniecības cenu saraksts](https://docs.anivahealth.com/lv/api/locations/list-retail-prices.md) atgriež tās visām atrašanās
vietām, kurām tev ir lasīšanas piekļuve, bet
[Iegūt mazumtirdzniecības cenas](https://docs.anivahealth.com/lv/api/locations/get-retail-prices.md) atgriež tās vienai atrašanās
vietai. Abiem nepieciešams `retail_prices_view` tvērums; `locations_view` tās neiekļauj. Pieprasi
abus tvērumus vienām un tām pašām atrašanās vietām.

`location.retail_prices.updated` [webhook](https://docs.anivahealth.com/lv/concepts/webhooks.md) paziņo, kad mainās cena.
`location.created` un `location.deactivated` ziņo, kad atrašanās vieta parādās vai pazūd. Izmaiņas
tajā, kurus paneļus atrašanās vieta piedāvā, var sasniegt tevi vēlāk nekā cenu izmaiņas, tāpēc
reizi dienā atkārtoti nolasi Mazumtirdzniecības cenu sarakstu.

## Atrašanās vietas piemērs

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