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

# Steder

> Slik fungerer teststeder i Aniva-API-et: apotek og klinikker som utfører blodprøvetaking, åpningstider, tilgjengelighet og utsalgspriser.

En lokasjon er et fysisk testsenter der helsepersonell utfører blodprøvetaking. Du bruker lokasjonens `id` for å bestille `practitioner`-timer.

> [!NOTE]
>
> API-nøkkelen din returnerer bare lokasjoner innenfor partnertilgangen din. Bruk `GET
>     /api/v1/locations` for å liste opp alle lokasjoner som er tilgjengelige for deg.

En `location.*`-[webhook](https://docs.anivahealth.com/no/concepts/webhooks.md) gir deg beskjed når en lokasjon dukker opp, endres eller forsvinner.

## Felter

**id** `string` *required*

UUID for lokasjonen. Send denne som `location_id` når du oppretter en time.

**name** `string` *required*

Visningsnavn for lokasjonen.

**company\_name** `string`

Klinikk eller selskap som driver lokasjonen. Kan være null.

**street** `string`

Gatenavn, uten husnummer. Kan være null.

**house\_number** `string`

Husnummer. Kan være null.

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

Ekstra adresselinje — c/o, bygning eller etasje. Kan være null.

**city** `string`

By. Kan være null.

**state** `string`

Delstat eller provins (hentet via byens tilknyttede delstat). Kan være null når byen ikke har noen tilknyttet
delstat.

**state\_code** `string`

Delstatens [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html)-kode uten
landsprefikset (f.eks. `BW` for Baden-Württemberg). Kan være null.

**postal\_code** `string`

Postnummer. Kan være null.

**country\_name** `string`

Fullt landnavn (f.eks. `Germany`). Kan være null.

**country\_code** `string`

Tobokstavers landkode etter [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(f.eks. `DE`, `US`). Kan være null.

**timezone** `string`

IANA-tidssoneidentifikator for stedet (f.eks. `Europe/Berlin`, `America/New_York`). Bruk denne for
å vise avtalte tidspunkter i riktig lokal tid. Kan være null.

**latitude** `number`

Breddegrad for adressen i desimalgrader (WGS 84). Kan være null.

**longitude** `number`

Lengdegrad for adressen i desimalgrader (WGS 84). Kan være null.

**contact\_phone** `string`

Telefonnummer til stedet. Kan være null.

**email** `string`

E-postadresse til stedet. Kan være null.

**website** `string`

Nettadresse til stedet. Kan være null.

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

Direktelenke til stedet på Google Maps. Kan være null.

**image\_url** `string`

URL til et bilde av stedet. Kan være null.

**open\_hours** `object`

Ukentlige åpningstider for stedet. Hver ukedagsnøkkel (`monday`–`sunday`) peker til en array av
`{ open, close }`-tidsrom i `HH:MM`-format (24-timers). En tom array betyr at stedet er stengt
den dagen. Kan være null hvis åpningstider ikke er tilgjengelige for stedet.

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

Hvordan blodprøven tas ved en time her med mindre timen angir sin egen `draw_method`: `capillary`
(fingertupp eller overarm, i mikrorør) eller `venous` (fra venen, i prøverør).

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

Metodene for blodprøvetaking som lokasjonen har prøvebeholdere på lager for, sortert. En time her
kan bare angi én av disse som sin `draw_method`.

> [!TIP]
>
> Bruk alltid `timezone`-feltet til å konvertere `scheduled_at`-tidspunkter til lokal tid før du
> viser dem til pasienter eller ansatte.

## Tilgjengelighet

Feltet `open_hours` ovenfor beskriver de faste ukentlige åpningstidene. For å vise faktiske ledige tidsluker – og unngå dobbeltbooking mot eksisterende Aniva-timer – kall [Get Availability](https://docs.anivahealth.com/no/api/locations/get-availability.md) for stedet og send inn datovinduet du vil vise. Det endepunktet er riktig sannhetskilde for ethvert bestillingsgrensesnitt: det utvider `open_hours` til stedets tidsluker, bruker unntak per dato, trekker fra allerede bestilte timer og tar hensyn til [minimumsfrist](https://docs.anivahealth.com/no/api/appointments/create-appointment.md#minimumsfrist).

## Utsalgspriser

Et apotek setter sin egen pris for hvert panel, og for hver enkelt biomarkør, som det selger til
drop-in-kunder. Du ser en pris først når apoteket publiserer den.
[List Retail Prices](https://docs.anivahealth.com/no/api/locations/list-retail-prices.md) returnerer dem for hvert sted du kan
lese, og [Get Retail Prices](https://docs.anivahealth.com/no/api/locations/get-retail-prices.md) returnerer dem for ett sted. Begge
krever scopet `retail_prices_view`; `locations_view` inkluderer dem ikke. Be om begge scopes på
de samme stedene.

En `location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/no/concepts/webhooks.md) varsler deg når en pris endres.
`location.created` og `location.deactivated` varsler deg når et sted kommer til eller forsvinner. En
endring i hvilke paneler et sted tilbyr, kan nå deg senere enn en prisendring, så les List Retail
Prices på nytt én gang om dagen.

## Eksempel på sted

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