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

# Helyszínek

> Így működnek a vizsgálati helyszínek az Aniva API-ban: vérvételt végző gyógyszertárak és rendelők, nyitvatartás, elérhetőség és fogyasztói árak.

A helyszín egy fizikai tesztközpont, ahol egészségügyi szakemberek végeznek vérvételt. A helyszín `id` azonosítóját használod a `practitioner` időpontok foglalásához.

> [!NOTE]
>
> Az API-kulcsod csak a partneri hozzáférési körödbe tartozó helyszíneket adja vissza. Használd a `GET
>     /api/v1/locations` végpontot a számodra elérhető összes helyszín listázásához.

A `location.*` [webhook](https://docs.anivahealth.com/hu/concepts/webhooks.md) értesít, ha egy helyszín megjelenik, megváltozik vagy megszűnik.

## Mezők

**id** `string` *required*

A helyszín UUID azonosítója. Ezt add meg `location_id` értékként időpont létrehozásakor.

**name** `string` *required*

A helyszín megjelenített neve.

**company\_name** `string`

A helyszínt üzemeltető klinika vagy cég. Lehet null.

**street** `string`

Utcanév, házszám nélkül. Lehet null.

**house\_number** `string`

Házszám. Lehet null.

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

Kiegészítő címsor — c/o, épület vagy emelet. Lehet null.

**city** `string`

Város. Lehet null.

**state** `string`

Állam vagy tartomány (a városhoz kapcsolt állam alapján feloldva). Lehet null, ha a városhoz nincs
kapcsolt állam.

**state\_code** `string`

A tartomány [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) kódja az ország-előtag
nélkül (pl. `BW` Baden-Württemberg esetén). Lehet null.

**postal\_code** `string`

Irányítószám. Lehet null.

**country\_name** `string`

Az ország teljes neve (pl. `Germany`). Lehet null.

**country\_code** `string`

Kétbetűs országkód az [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
szabvány szerint (pl. `DE`, `US`). Lehet null.

**timezone** `string`

A helyszín IANA időzóna-azonosítója (pl. `Europe/Berlin`, `America/New_York`). Ezzel jelenítsd meg
az ütemezett időpontokat a megfelelő helyi időben. Lehet null.

**latitude** `number`

A cím szélességi foka decimális fokban (WGS 84). Lehet null.

**longitude** `number`

A cím hosszúsági foka decimális fokban (WGS 84). Lehet null.

**contact\_phone** `string`

A helyszín telefonszáma. Lehet null.

**email** `string`

A helyszín e-mail-címe. Lehet null.

**website** `string`

A helyszín weboldalának URL-je. Lehet null.

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

Közvetlen link a helyszínhez a Google Mapsen. Lehet null.

**image\_url** `string`

A helyszínről készült fotó URL-je. Lehet null.

**open\_hours** `object`

A helyszín heti nyitvatartása. A hét napjait jelölő kulcsok (`monday`–`sunday`) egy-egy
`{ open, close }` időtartományokat tartalmazó tömbre mutatnak `HH:MM` (24 órás) formátumban. Az
üres tömb azt jelenti, hogy a helyszín aznap zárva van. Lehet null, ha a helyszínhez nem érhető el
nyitvatartás.

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

A vérvétel alapértelmezett módja az itteni időpontokon, ha az időpont nem ad meg saját
`draw_method` értéket: `capillary` (ujjbegyből vagy felkarból, mikrocsövekbe) vagy `venous`
(vénából, csövekbe).

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

Azok a vérvételi módok, amelyekhez a helyszín tart készleten mintavételi tartályokat, rendezve.
Egy itteni időpont `draw_method` értéke csak ezek közül valamelyik lehet.

> [!TIP]
>
> Mindig a `timezone` mező segítségével alakítsd át a `scheduled_at` dátum- és időértékeket helyi
> időre, mielőtt megjeleníted őket a pácienseknek vagy a személyzetnek.

## Elérhetőség

A fenti `open_hours` mező a statikus heti nyitvatartási rendet írja le. A valódi, foglalható idősávok megjelenítéséhez – és a meglévő Aniva időpontokkal való dupla foglalás elkerüléséhez – hívd meg a [Get Availability](https://docs.anivahealth.com/hu/api/locations/get-availability.md) végpontot a helyszínre, és add át neki a megjeleníteni kívánt dátumtartományt. Ez a végpont a mérvadó forrás minden foglalási felülethez: kiterjeszti az `open_hours` értékeket a helyszín idősávrácsára, alkalmazza a dátumhoz kötött kivételeket, levonja a már lefoglalt időpontokat, és figyelembe veszi a [minimális előzetes határidőt](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md#minimalis-elofoglalasi-ido).

## Kiskereskedelmi árak

A gyógyszertár saját árat állít be minden olyan panelhez és egyedi biomarkerhez, amelyet betérő
ügyfeleknek értékesít. Egy árat csak azután látsz, hogy a gyógyszertár közzétette.
A [List Retail Prices](https://docs.anivahealth.com/hu/api/locations/list-retail-prices.md) minden olyan helyszínre visszaadja őket,
amelyet olvashatsz, a [Get Retail Prices](https://docs.anivahealth.com/hu/api/locations/get-retail-prices.md) pedig egy helyszínre.
Mindkettőhöz szükséges a `retail_prices_view` scope; a `locations_view` nem tartalmazza őket. Kérd
mindkét scope-ot ugyanazokra a helyszínekre.

A `location.retail_prices.updated` [webhook](https://docs.anivahealth.com/hu/concepts/webhooks.md) értesít, ha egy ár megváltozik.
A `location.created` és a `location.deactivated` jelzi, amikor egy helyszín létrejön vagy megszűnik.
Az, hogy egy helyszín mely paneleket kínálja, később is eljuthat hozzád, mint egy árváltozás, ezért
naponta egyszer olvasd ki újra a List Retail Prices végpontot.

## Példa helyszín

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