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

# Lokality

> Jak v Aniva API fungují testovací místa: lékárny a ordinace s odběrem krve, otevírací doba, dostupnost a maloobchodní ceny.

Odběrové místo je fyzické testovací centrum, kde zdravotníci provádějí odběry krve. Pomocí `id` odběrového místa plánuješ termíny typu `practitioner`.

> [!NOTE]
>
> Tvůj API klíč vrací jen odběrová místa v rámci tvého partnerského přístupu. Pomocí `GET
>     /api/v1/locations` vypíšeš všechna odběrová místa, která máš k dispozici.

[Webhook](https://docs.anivahealth.com/cs/concepts/webhooks.md) `location.*` tě upozorní, když odběrové místo přibude, změní se nebo zmizí.

## Pole

**id** `string` *required*

UUID odběrového místa. Při vytváření termínu ho předej jako `location_id`.

**name** `string` *required*

Zobrazovaný název odběrového místa.

**company\_name** `string`

Klinika nebo společnost provozující odběrové místo. Může být null.

**street** `string`

Název ulice bez čísla domu. Může být null.

**house\_number** `string`

Číslo domu. Může být null.

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

Doplňující řádek adresy — c/o, budova nebo patro. Může být null.

**city** `string`

Město. Může být null.

**state** `string`

Stát nebo provincie (určeno přes stát propojený s městem). Může být null, když město nemá
propojený stát.

**state\_code** `string`

Kód státu podle [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) bez
předpony země (např. `BW` pro Baden-Württemberg). Může být null.

**postal\_code** `string`

PSČ nebo ZIP kód. Může být null.

**country\_name** `string`

Celý název země (např. `Germany`). Může být null.

**country\_code** `string`

Dvoupísmenný kód země podle [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(např. `DE`, `US`). Může být null.

**timezone** `string`

Identifikátor časového pásma IANA pro pobočku (např. `Europe/Berlin`, `America/New_York`). Použij ho
k zobrazení naplánovaných časů ve správném místním čase. Může být null.

**latitude** `number`

Zeměpisná šířka adresy v desetinných stupních (WGS 84). Může být null.

**longitude** `number`

Zeměpisná délka adresy v desetinných stupních (WGS 84). Může být null.

**contact\_phone** `string`

Telefonní číslo pobočky. Může být null.

**email** `string`

E-mailová adresa pobočky. Může být null.

**website** `string`

URL webu pobočky. Může být null.

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

Přímý odkaz na pobočku na Google Maps. Může být null.

**image\_url** `string`

URL fotografie pobočky. Může být null.

**open\_hours** `object`

Týdenní otevírací doba pobočky. Každý klíč dne v týdnu (`monday`–`sunday`) obsahuje pole
časových rozmezí `{ open, close }` ve formátu `HH:MM` (24 h). Prázdné pole znamená, že je pobočka
ten den zavřená. Může být null, pokud otevírací doba pobočky není k dispozici.

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

Jak se zde při termínu odebírá krev, pokud termín nenastaví vlastní `draw_method`: `capillary`
(z bříška prstu nebo paže, do mikrozkumavek) nebo `venous` (ze žíly, do zkumavek).

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

Metody odběru, pro které má místo skladem odběrové nádobky, seřazené. Termín na tomto místě může
jako `draw_method` nastavit jen jednu z nich.

> [!TIP]
>
> Vždy použij pole `timezone` k převodu dat a časů `scheduled_at` na místní čas, než
> je zobrazíš pacientům nebo personálu.

## Dostupnost

Pole `open_hours` výše popisuje statický týdenní rozvrh otevírací doby. Pokud chceš zobrazit skutečně rezervovatelné sloty – a vyhnout se duplicitním rezervacím s existujícími termíny Aniva – zavolej pro danou pobočku [Get Availability](https://docs.anivahealth.com/cs/api/locations/get-availability.md) a předej mu rozmezí dat, které chceš zobrazit. Tento endpoint je správným zdrojem pravdy pro jakékoli rezervační UI: rozepíše `open_hours` do mřížky slotů pobočky, zohlední výjimky pro jednotlivá data, odečte už rezervované termíny a uplatní [minimální předstih](https://docs.anivahealth.com/cs/api/appointments/create-appointment.md#minimalni-predstih).

## Maloobchodní ceny

Lékárna si sama nastavuje cenu pro každý panel i pro každý jednotlivý biomarker, který prodává
příchozím zákazníkům. Cenu uvidíš až poté, co ji lékárna zveřejní.
[List Retail Prices](https://docs.anivahealth.com/cs/api/locations/list-retail-prices.md) je vrátí pro každou pobočku, kterou můžeš
číst, a [Get Retail Prices](https://docs.anivahealth.com/cs/api/locations/get-retail-prices.md) je vrátí pro jednu pobočku. Oba
vyžadují scope `retail_prices_view`; `locations_view` je nezahrnuje. Požádej o oba scopy pro
stejné pobočky.

[Webhook](https://docs.anivahealth.com/cs/concepts/webhooks.md) `location.retail_prices.updated` ti dá vědět, když se cena změní.
`location.created` a `location.deactivated` ti dají vědět, když pobočka přibude nebo zmizí. Změna
v tom, jaké panely pobočka nabízí, k tobě může dorazit později než změna ceny, proto jednou denně
znovu načti List Retail Prices.

## Příklad pobočky

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