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

# Локации

> Как работают пункты сдачи анализов в API Aniva: аптеки и клиники, где делают забор крови, часы работы, доступность и розничные цены.

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

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

[Вебхук](https://docs.anivahealth.com/ru/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 — вызови [Получение доступности](https://docs.anivahealth.com/ru/api/locations/get-availability.md) для нужной локации и передай диапазон дат, который хочешь отобразить. Этот эндпоинт — правильный источник данных для любого интерфейса записи: он разворачивает `open_hours` в сетку слотов локации, применяет исключения по датам, вычитает уже занятые записи и учитывает [минимальный срок до записи](https://docs.anivahealth.com/ru/api/appointments/create-appointment.md#minimalniy-srok-do-zapisi).

## Розничные цены

Аптека сама устанавливает цену на каждую панель и каждый отдельный биомаркер, которые продаёт
клиентам без записи. Ты увидишь цену только после того, как аптека её опубликует.
[Список розничных цен](https://docs.anivahealth.com/ru/api/locations/list-retail-prices.md) возвращает их для всех доступных тебе
локаций, а [Получение розничных цен](https://docs.anivahealth.com/ru/api/locations/get-retail-prices.md) — для одной локации. Для обоих
нужно разрешение `retail_prices_view`; `locations_view` их не включает. Запроси оба разрешения для
одних и тех же локаций.

[Вебхук](https://docs.anivahealth.com/ru/concepts/webhooks.md) `location.retail_prices.updated` сообщает тебе об изменении цены.
`location.created` и `location.deactivated` сообщают, когда локация появляется или исчезает. Изменение
списка панелей, которые предлагает локация, может дойти до тебя позже изменения цены, поэтому запрашивай
Список розничных цен повторно раз в день.

## Пример локации

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