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

# Toimipisteet

> Näin testipaikat toimivat Aniva API:ssa: verinäytteenottoa tekevät apteekit ja vastaanotot, aukioloajat, saatavuus ja vähittäishinnat.

Toimipiste on fyysinen testauskeskus, jossa terveydenhuollon ammattilaiset tekevät verinäytteenottoja. Käytät toimipisteen `id`-tunnusta `practitioner`-ajanvarausten tekemiseen.

> [!NOTE]
>
> API-avaimesi palauttaa vain kumppanisi käyttöoikeuksiin kuuluvat toimipisteet. Listaa kaikki
> käytettävissäsi olevat toimipisteet kutsulla `GET
>     /api/v1/locations`.

`location.*`-[webhook](https://docs.anivahealth.com/fi/concepts/webhooks.md) ilmoittaa, kun toimipiste lisätään, muuttuu tai poistuu.

## Kentät

**id** `string` *required*

Toimipisteen UUID. Välitä tämä `location_id`-kentässä ajanvarausta luodessasi.

**name** `string` *required*

Toimipisteen näyttönimi.

**company\_name** `string`

Toimipistettä ylläpitävä klinikka tai yritys. Voi olla null.

**street** `string`

Kadunnimi ilman talonnumeroa. Voi olla null.

**house\_number** `string`

Talonnumero. Voi olla null.

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

Lisäosoiterivi — c/o, rakennus tai kerros. Voi olla null.

**city** `string`

Kaupunki. Voi olla null.

**state** `string`

Osavaltio tai maakunta (selvitetään kaupunkiin liitetyn osavaltion perusteella). Voi olla null,
kun kaupunkiin ei ole liitetty osavaltiota.

**state\_code** `string`

Osavaltion [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html)-koodi ilman
maaetuliitettä (esim. `BW` Baden-Württembergille). Voi olla null.

**postal\_code** `string`

Postinumero. Voi olla null.

**country\_name** `string`

Maan koko nimi (esim. `Germany`). Voi olla null.

**country\_code** `string`

Kaksikirjaiminen maakoodi [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)-standardin
mukaan (esim. `DE`, `US`). Voi olla null.

**timezone** `string`

Toimipisteen IANA-aikavyöhyketunniste (esim. `Europe/Berlin`, `America/New_York`). Käytä tätä
varattujen aikojen näyttämiseen oikeassa paikallisajassa. Voi olla null.

**latitude** `number`

Osoitteen leveysaste desimaaliasteina (WGS 84). Voi olla null.

**longitude** `number`

Osoitteen pituusaste desimaaliasteina (WGS 84). Voi olla null.

**contact\_phone** `string`

Toimipisteen puhelinnumero. Voi olla null.

**email** `string`

Toimipisteen sähköpostiosoite. Voi olla null.

**website** `string`

Toimipisteen verkkosivuston URL-osoite. Voi olla null.

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

Suora linkki toimipisteeseen Google Mapsissa. Voi olla null.

**image\_url** `string`

Toimipisteen valokuvan URL-osoite. Voi olla null.

**open\_hours** `object`

Toimipisteen viikoittaiset aukioloajat. Jokainen viikonpäiväavain (`monday`–`sunday`) sisältää
taulukon `{ open, close }`-aikavälejä `HH:MM`-muodossa (24 h). Tyhjä taulukko tarkoittaa, että
toimipiste on suljettu kyseisenä päivänä. Voi olla null, jos toimipisteen aukioloaikoja ei ole saatavilla.

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

Miten verinäyte otetaan tämän toimipisteen ajanvarauksessa, ellei ajanvarauksessa ole asetettu
omaa `draw_method`-arvoa: `capillary` (sormenpäästä tai olkavarresta mikroputkiin) tai `venous`
(laskimosta näyteputkiin).

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

Verinäytteenottotavat, joihin toimipisteellä on näyteastioita varastossa, järjestettynä. Tämän
toimipisteen ajanvarauksessa voi asettaa `draw_method`-arvoksi vain jonkin näistä.

> [!TIP]
>
> Käytä aina `timezone`-kenttää `scheduled_at`-aikaleimojen muuntamiseen paikallisaikaan ennen
> kuin näytät ne potilaille tai henkilökunnalle.

## Saatavuus

Yllä oleva `open_hours`-kenttä kuvaa staattista viikoittaista aukioloaikataulua. Jotta voit näyttää todelliset varattavat ajat – ja välttää päällekkäiset varaukset olemassa olevien Aniva-ajanvarausten kanssa – kutsu toimipisteelle päätepistettä [Get Availability](https://docs.anivahealth.com/fi/api/locations/get-availability.md) ja välitä sille näytettävä päivämääräväli. Kyseinen päätepiste on oikea tietolähde mille tahansa varauskäyttöliittymälle: se purkaa `open_hours`-kentän toimipisteen aikaruudukkoon, huomioi päiväkohtaiset poikkeukset, vähentää jo varatut ajanvaraukset ja soveltaa [vähimmäisennakkoaikaa](https://docs.anivahealth.com/fi/api/appointments/create-appointment.md#vaehimmaeisennakkoaika).

## Vähittäishinnat

Apteekki määrittää itse hinnan jokaiselle paneelille ja yksittäiselle biomarkkerille, jota se myy
ilman ajanvarausta tuleville asiakkaille. Näet hinnan vasta, kun apteekki on julkaissut sen.
[List Retail Prices](https://docs.anivahealth.com/fi/api/locations/list-retail-prices.md) palauttaa hinnat jokaiselta toimipisteeltä, johon
sinulla on lukuoikeus, ja [Get Retail Prices](https://docs.anivahealth.com/fi/api/locations/get-retail-prices.md) palauttaa ne yhdeltä
toimipisteeltä. Molemmat vaativat `retail_prices_view`-käyttöoikeuden; `locations_view` ei sisällä niitä.
Pyydä molemmat käyttöoikeudet samoille toimipisteille.

`location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/fi/concepts/webhooks.md) kertoo, kun hinta muuttuu.
`location.created` ja `location.deactivated` kertovat, kun toimipiste lisätään tai poistuu käytöstä.
Muutos siihen, mitä paneeleja toimipiste tarjoaa, voi saapua myöhemmin kuin hinnanmuutos, joten lue
List Retail Prices uudelleen kerran päivässä.

## Esimerkkitoimipiste

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