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

# Platser

> Så fungerar provtagningsplatser i Aniva API: apotek och mottagningar som utför blodprovstagning, öppettider, tillgänglighet och slutkundspriser.

En plats är ett fysiskt provtagningscenter där vårdpersonal utför blodprovstagningar. Du använder platsens `id` för att schemalägga `practitioner`-bokningar.

> [!NOTE]
>
> Din API-nyckel returnerar bara platser inom din partners åtkomstkontext. Använd `GET
>     /api/v1/locations` för att lista alla platser som är tillgängliga för dig.

En `location.*`-[webhook](https://docs.anivahealth.com/sv/concepts/webhooks.md) meddelar dig när en plats läggs till, ändras eller tas bort.

## Fält

**id** `string` *required*

UUID för platsen. Skicka detta som `location_id` när du skapar en bokning.

**name** `string` *required*

Visningsnamn för platsen.

**company\_name** `string`

Klinik eller företag som driver platsen. Kan vara null.

**street** `string`

Gatunamn, utan husnummer. Kan vara null.

**house\_number** `string`

Husnummer. Kan vara null.

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

Extra adressrad – c/o, byggnad eller våning. Kan vara null.

**city** `string`

Stad. Kan vara null.

**state** `string`

Delstat eller provins (hämtas via stadens kopplade delstat). Kan vara null när staden saknar en
kopplad delstat.

**state\_code** `string`

Delstatens [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html)-kod utan
landsprefix (t.ex. `BW` för Baden-Württemberg). Kan vara null.

**postal\_code** `string`

Postnummer. Kan vara null.

**country\_name** `string`

Fullständigt landsnamn (t.ex. `Germany`). Kan vara null.

**country\_code** `string`

Landskod med två bokstäver enligt [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(t.ex. `DE`, `US`). Kan vara null.

**timezone** `string`

IANA-tidszonsidentifierare för platsen (t.ex. `Europe/Berlin`, `America/New_York`). Använd den för att
visa bokade tider i rätt lokal tid. Kan vara null.

**latitude** `number`

Adressens latitud i decimalgrader (WGS 84). Kan vara null.

**longitude** `number`

Adressens longitud i decimalgrader (WGS 84). Kan vara null.

**contact\_phone** `string`

Telefonnummer till platsen. Kan vara null.

**email** `string`

E-postadress till platsen. Kan vara null.

**website** `string`

URL till platsens webbplats. Kan vara null.

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

Direktlänk till platsen på Google Maps. Kan vara null.

**image\_url** `string`

URL till ett foto av platsen. Kan vara null.

**open\_hours** `object`

Veckovisa öppettider för platsen. Varje veckodagsnyckel (`monday`–`sunday`) mappas till en array med
`{ open, close }`-tidsintervall i formatet `HH:MM` (24 h). En tom array betyder att platsen är stängd
den dagen. Kan vara null om öppettider saknas för platsen.

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

Hur blodprovet tas vid en bokning här om bokningen inte anger en egen `draw_method`:
`capillary` (fingertopp eller överarm, i mikrorör) eller `venous` (från ven, i rör).

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

De provtagningsmetoder som platsen har behållare i lager för, sorterade. En bokning här kan
endast ange en av dessa som sin `draw_method`.

> [!TIP]
>
> Använd alltid fältet `timezone` för att konvertera datum och tider i `scheduled_at` till lokal tid innan
> du visar dem för patienter eller personal.

## Tillgänglighet

Fältet `open_hours` ovan beskriver det statiska veckoschemat för öppettider. För att visa faktiska bokningsbara tider – och undvika dubbelbokningar mot befintliga Aniva-bokningar – anropar du [Hämta tillgänglighet](https://docs.anivahealth.com/sv/api/locations/get-availability.md) för platsen och skickar med det datumintervall du vill visa. Den endpointen är rätt sanningskälla för alla bokningsgränssnitt: den expanderar `open_hours` på platsens tidsrutnät, tillämpar undantag per datum, drar bort redan gjorda bokningar och tillämpar [minsta framförhållning](https://docs.anivahealth.com/sv/api/appointments/create-appointment.md#minsta-framfoerhallning).

## Utpriser

Ett apotek sätter sitt eget pris för varje panel och varje enskild biomarkör som det säljer till
drop-in-kunder. Du ser ett pris först när apoteket har publicerat det.
[Lista utpriser](https://docs.anivahealth.com/sv/api/locations/list-retail-prices.md) returnerar dem för varje plats du kan
läsa, och [Hämta utpriser](https://docs.anivahealth.com/sv/api/locations/get-retail-prices.md) returnerar dem för en plats. Båda
kräver scopet `retail_prices_view`; `locations_view` inkluderar dem inte. Be om båda scopes för
samma platser.

En `location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/sv/concepts/webhooks.md) meddelar dig när ett pris ändras.
`location.created` och `location.deactivated` meddelar dig när en plats tillkommer eller försvinner. En ändring av
vilka paneler en plats erbjuder kan nå dig senare än en prisändring, så läs Lista utpriser
igen en gång om dagen.

## Exempelplats

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