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

# Локації

> Як працюють локації тестування в Aniva API: аптеки та медичні кабінети, де роблять забір крові, години роботи, доступність і роздрібні ціни.

Локація — це фізичний центр тестування, де медичні фахівці виконують забір крові. Ти використовуєш `id` локації для планування записів типу `practitioner`.

> [!NOTE]
>
> Твій API-ключ повертає лише локації в межах твого партнерського контексту доступу. Використовуй `GET
>     /api/v1/locations`, щоб отримати список усіх доступних тобі локацій.

[Вебхук](https://docs.anivahealth.com/uk/concepts/webhooks.md) `location.*` повідомляє тобі, коли локація з’являється, змінюється або зникає.

## Поля

**id** `string` *required*

UUID локації. Передавай його як `location_id` під час створення запису.

**name** `string` *required*

Назва локації для відображення.

**company\_name** `string`

Клініка або компанія, яка керує локацією. Може бути null.

**street** `string`

Назва вулиці без номера будинку. Може бути null.

**house\_number** `string`

Номер будинку. Може бути null.

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

Додатковий рядок адреси — c/o, корпус або поверх. Може бути null.

**city** `string`

Місто. Може бути null.

**state** `string`

Штат або провінція (визначається через пов’язаний із містом штат). Може бути null, якщо місто не має
пов’язаного штату.

**state\_code** `string`

Код штату або землі за [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) без
префікса країни (наприклад, `BW` для Баден-Вюртембергу). Може бути null.

**postal\_code** `string`

Поштовий індекс або ZIP-код. Може бути null.

**country\_name** `string`

Повна назва країни (наприклад, `Germany`). Може бути null.

**country\_code** `string`

Дволітерний код країни за [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(наприклад, `DE`, `US`). Може бути null.

**timezone** `string`

Ідентифікатор часового поясу IANA для локації (наприклад, `Europe/Berlin`, `America/New_York`).
Використовуй його, щоб показувати запланований час у правильному місцевому часі. Може бути null.

**latitude** `number`

Широта адреси в десяткових градусах (WGS 84). Може бути null.

**longitude** `number`

Довгота адреси в десяткових градусах (WGS 84). Може бути null.

**contact\_phone** `string`

Номер телефону локації. Може бути null.

**email** `string`

Електронна адреса локації. Може бути null.

**website** `string`

URL вебсайту локації. Може бути null.

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

Пряме посилання на локацію в Google Maps. Може бути null.

**image\_url** `string`

URL фотографії локації. Може бути null.

**open\_hours** `object`

Тижневий графік роботи локації. Кожен ключ дня тижня (`monday`–`sunday`) відповідає масиву
часових інтервалів `{ open, close }` у 24-годинному форматі `HH:MM`. Порожній масив означає, що
цього дня локація зачинена. Може бути null, якщо графік роботи локації недоступний.

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

Як тут проводять забір крові під час запису, якщо в записі не вказано власний `draw_method`:
`capillary` (з пальця або плеча в мікроконтейнери) або `venous` (з вени в пробірки).

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

Способи забору крові, для яких у локації є контейнери, у відсортованому порядку. У записі тут можна
вказати лише один із них як `draw_method`.

> [!TIP]
>
> Завжди використовуй поле `timezone`, щоб переводити дату й час `scheduled_at` у місцевий час,
> перш ніж показувати їх пацієнтам або персоналу.

## Доступність

Поле `open_hours` вище описує статичний тижневий графік роботи. Щоб показати реальні вільні слоти — і уникнути подвійного бронювання поверх наявних записів Aniva — виклич [Get Availability](https://docs.anivahealth.com/uk/api/locations/get-availability.md) для цієї локації та передай діапазон дат, який хочеш відобразити. Саме цей ендпоїнт є правильним джерелом істини для будь-якого інтерфейсу запису: він розгортає `open_hours` на сітку слотів локації, застосовує винятки для конкретних дат, віднімає вже зайняті записи та враховує [мінімальний час попередження](https://docs.anivahealth.com/uk/api/appointments/create-appointment.md#minimalniy-chas-do-zapisu).

## Роздрібні ціни

Аптека встановлює власну ціну для кожної панелі та кожного окремого біомаркера, які продає
відвідувачам без попереднього запису. Ти побачиш ціну лише після того, як аптека її опублікує.
[List Retail Prices](https://docs.anivahealth.com/uk/api/locations/list-retail-prices.md) повертає їх для кожної локації, до якої ти
маєш доступ на читання, а [Get Retail Prices](https://docs.anivahealth.com/uk/api/locations/get-retail-prices.md) — для однієї
локації. Обом потрібен дозвіл `retail_prices_view`; `locations_view` їх не включає. Запитуй обидва
дозволи для тих самих локацій.

[Вебхук](https://docs.anivahealth.com/uk/concepts/webhooks.md) `location.retail_prices.updated` повідомляє тобі, коли змінюється
ціна. `location.created` і `location.deactivated` повідомляють, коли локація з’являється або
зникає. Зміна набору панелей, які пропонує локація, може надійти до тебе пізніше, ніж зміна ціни,
тому повторно зчитуй List Retail Prices раз на день.

## Приклад локації

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