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

# Lokationer

> Sådan fungerer testlokationer i Anivas API: apoteker og klinikker, der udfører blodprøvetagning, åbningstider, ledige tider og udsalgspriser.

En lokation er et fysisk testcenter, hvor sundhedspersonale udfører blodprøvetagninger. Du bruger en lokations `id` til at booke `practitioner`-tider.

> [!NOTE]
>
> Din API-nøgle returnerer kun lokationer inden for din partneradgangskontekst. Brug `GET
>     /api/v1/locations` til at hente alle lokationer, der er tilgængelige for dig.

En `location.*`-[webhook](https://docs.anivahealth.com/da/concepts/webhooks.md) giver dig besked, når en lokation oprettes, ændres eller fjernes.

## Felter

**id** `string` *required*

UUID for lokationen. Send dette som `location_id`, når du opretter en tid.

**name** `string` *required*

Visningsnavn for lokationen.

**company\_name** `string`

Klinik eller virksomhed, der driver lokationen. Kan være null.

**street** `string`

Vejnavn uden husnummer. Kan være null.

**house\_number** `string`

Husnummer. Kan være null.

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

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

**city** `string`

By. Kan være null.

**state** `string`

Delstat eller region (afledt fra byens tilknyttede delstat). Kan være null, når byen ikke har en
tilknyttet delstat.

**state\_code** `string`

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

**postal\_code** `string`

Postnummer eller ZIP-kode. Kan være null.

**country\_name** `string`

Fuldt landenavn (f.eks. `Germany`). Kan være null.

**country\_code** `string`

Landekode på to bogstaver efter [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-tidszone-id for lokationen (f.eks. `Europe/Berlin`, `America/New_York`). Brug det til at
vise planlagte tidspunkter i den korrekte lokale tid. Kan være null.

**latitude** `number`

Adressens breddegrad i decimalgrader (WGS 84). Kan være null.

**longitude** `number`

Adressens længdegrad i decimalgrader (WGS 84). Kan være null.

**contact\_phone** `string`

Telefonnummer til lokationen. Kan være null.

**email** `string`

E-mailadresse til lokationen. Kan være null.

**website** `string`

URL til lokationens hjemmeside. Kan være null.

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

Direkte link til lokationen på Google Maps. Kan være null.

**image\_url** `string`

URL til et foto af lokationen. Kan være null.

**open\_hours** `object`

Ugentlige åbningstider for lokationen. Hver ugedagsnøgle (`monday`–`sunday`) peger på et array af
`{ open, close }`-tidsrum i `HH:MM`-format (24 timer). Et tomt array betyder, at lokationen holder
lukket den dag. Kan være null, hvis der ikke findes åbningstider for lokationen.

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

Hvordan blodprøven tages ved en tid her, medmindre tiden angiver sin egen `draw_method`:
`capillary` (fingerspids eller overarm, i mikrorør) eller `venous` (fra venen, i prøverør).

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

De prøvetagningsmetoder, lokationen har beholdere på lager til, sorteret. En tid her kan kun
angive en af disse som sin `draw_method`.

> [!TIP]
>
> Brug altid feltet `timezone` til at konvertere `scheduled_at`-tidspunkter til lokal tid, før du
> viser dem til patienter eller personale.

## Ledige tider

Feltet `open_hours` ovenfor beskriver de faste ugentlige åbningstider. For at vise reelle ledige tider — og undgå dobbeltbookinger med eksisterende Aniva-tider — kalder du [Hent ledige tider](https://docs.anivahealth.com/da/api/locations/get-availability.md) for lokationen og sender det datointerval med, du vil vise. Det endpoint er den rette datakilde til enhver booking-UI: Det omsætter `open_hours` til lokationens tidsintervaller, tager højde for undtagelser pr. dato, trækker allerede bookede tider fra og anvender [minimumsvarsel](https://docs.anivahealth.com/da/api/appointments/create-appointment.md#minimumsvarsel).

## Udsalgspriser

Et apotek fastsætter selv sin pris for hvert panel og for hver enkelt biomarkør, det sælger til
walk-in-kunder. Du ser først en pris, når apoteket har offentliggjort den.
[Vis udsalgspriser](https://docs.anivahealth.com/da/api/locations/list-retail-prices.md) returnerer dem for alle lokationer, du kan
læse, og [Hent udsalgspriser](https://docs.anivahealth.com/da/api/locations/get-retail-prices.md) returnerer dem for én lokation.
Begge kræver scopet `retail_prices_view`; `locations_view` inkluderer dem ikke. Bed om begge scopes
for de samme lokationer.

En `location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/da/concepts/webhooks.md) giver dig besked, når en pris
ændres. `location.created` og `location.deactivated` giver besked, når en lokation kommer til eller
forsvinder. En ændring i, hvilke paneler en lokation tilbyder, kan nå frem senere end en
prisændring, så kald Vis udsalgspriser igen én gang om dagen.

## Eksempel på lokation

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