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

# Lokalizacje

> Jak działają lokalizacje badań w API Aniva: apteki i gabinety wykonujące pobrania krwi, godziny otwarcia, dostępność i ceny detaliczne.

Lokalizacja to fizyczny punkt badań, w którym personel medyczny wykonuje pobrania krwi. Do umawiania wizyt `practitioner` używasz `id` lokalizacji.

> [!NOTE]
>
> Twój klucz API zwraca tylko lokalizacje w ramach twojego partnerskiego kontekstu dostępu. Użyj `GET
>     /api/v1/locations`, aby wyświetlić listę wszystkich dostępnych dla ciebie lokalizacji.

[Webhook](https://docs.anivahealth.com/pl/concepts/webhooks.md) `location.*` informuje cię, gdy lokalizacja się pojawia, zmienia lub znika.

## Pola

**id** `string` *required*

UUID lokalizacji. Przekaż tę wartość jako `location_id` podczas tworzenia wizyty.

**name** `string` *required*

Wyświetlana nazwa lokalizacji.

**company\_name** `string`

Klinika lub firma prowadząca lokalizację. Może mieć wartość null.

**street** `string`

Nazwa ulicy, bez numeru domu. Może mieć wartość null.

**house\_number** `string`

Numer domu. Może mieć wartość null.

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

Dodatkowa linia adresu — c/o, budynek lub piętro. Może mieć wartość null.

**city** `string`

Miasto. Może mieć wartość null.

**state** `string`

Stan lub województwo (ustalane na podstawie regionu powiązanego z miastem). Może mieć wartość null,
gdy miasto nie ma powiązanego regionu.

**state\_code** `string`

Kod [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) stanu lub kraju związkowego bez
prefiksu kraju (np. `BW` dla Baden-Württemberg). Może mieć wartość null.

**postal\_code** `string`

Kod pocztowy lub kod ZIP. Może mieć wartość null.

**country\_name** `string`

Pełna nazwa kraju (np. `Germany`). Może mieć wartość null.

**country\_code** `string`

Dwuliterowy kod kraju według [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(np. `DE`, `US`). Może mieć wartość null.

**timezone** `string`

Identyfikator strefy czasowej IANA dla lokalizacji (np. `Europe/Berlin`, `America/New_York`). Użyj
go, aby wyświetlać zaplanowane godziny we właściwym czasie lokalnym. Może mieć wartość null.

**latitude** `number`

Szerokość geograficzna adresu w stopniach dziesiętnych (WGS 84). Może mieć wartość null.

**longitude** `number`

Długość geograficzna adresu w stopniach dziesiętnych (WGS 84). Może mieć wartość null.

**contact\_phone** `string`

Numer telefonu lokalizacji. Może mieć wartość null.

**email** `string`

Adres e-mail lokalizacji. Może mieć wartość null.

**website** `string`

Adres URL strony internetowej lokalizacji. Może mieć wartość null.

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

Bezpośredni link do lokalizacji w Google Maps. Może mieć wartość null.

**image\_url** `string`

Adres URL zdjęcia lokalizacji. Może mieć wartość null.

**open\_hours** `object`

Tygodniowe godziny otwarcia lokalizacji. Każdy klucz dnia tygodnia (`monday`–`sunday`) wskazuje na
tablicę przedziałów czasowych `{ open, close }` w formacie `HH:MM` (24h). Pusta tablica oznacza, że
lokalizacja jest tego dnia zamknięta. Może mieć wartość null, jeśli godziny otwarcia lokalizacji są niedostępne.

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

Sposób pobierania krwi podczas wizyty w tej lokalizacji, chyba że wizyta ustawia własne `draw_method`:
`capillary` (z opuszki palca lub ramienia, do mikroprobówek) lub `venous` (z żyły, do probówek).

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

Posortowane metody pobrania krwi, do których lokalizacja ma na stanie pojemniki. Wizyta w tej
lokalizacji może ustawić tylko jedną z nich jako swoje `draw_method`.

> [!TIP]
>
> Zawsze używaj pola `timezone`, aby przeliczać znaczniki czasu `scheduled_at` na czas lokalny przed
> wyświetleniem ich pacjentom lub personelowi.

## Dostępność

Pole `open_hours` powyżej opisuje stały tygodniowy harmonogram otwarcia. Aby wyświetlić rzeczywiste terminy do rezerwacji — i uniknąć podwójnych rezerwacji z istniejącymi wizytami Aniva — wywołaj [Get Availability](https://docs.anivahealth.com/pl/api/locations/get-availability.md) dla danej lokalizacji i przekaż przedział dat, który chcesz wyświetlić. Ten endpoint jest właściwym źródłem danych dla każdego interfejsu rezerwacji: przekłada `open_hours` na siatkę terminów lokalizacji, uwzględnia wyjątki dla poszczególnych dat, odejmuje już zarezerwowane wizyty i stosuje [minimalne wyprzedzenie](https://docs.anivahealth.com/pl/api/appointments/create-appointment.md#minimalne-wyprzedzenie).

## Ceny detaliczne

Apteka ustala własną cenę dla każdego panelu i pojedynczego biomarkera, które sprzedaje klientom
na miejscu. Cenę zobaczysz dopiero po jej opublikowaniu przez aptekę.
[List Retail Prices](https://docs.anivahealth.com/pl/api/locations/list-retail-prices.md) zwraca je dla każdej lokalizacji, do której masz
dostęp do odczytu, a [Get Retail Prices](https://docs.anivahealth.com/pl/api/locations/get-retail-prices.md) zwraca je dla jednej lokalizacji. Oba
wymagają zakresu `retail_prices_view`; zakres `locations_view` ich nie obejmuje. Poproś o oba zakresy dla
tych samych lokalizacji.

[Webhook](https://docs.anivahealth.com/pl/concepts/webhooks.md) `location.retail_prices.updated` informuje o zmianie ceny.
`location.created` i `location.deactivated` informują o pojawieniu się lub zniknięciu lokalizacji. Zmiana
paneli oferowanych przez lokalizację może dotrzeć do ciebie później niż zmiana ceny, więc odczytuj List Retail Prices
ponownie raz dziennie.

## Przykładowa lokalizacja

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