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

# Standorte

> So funktionieren Teststandorte in der Aniva API: Apotheken und Praxen, die Blut abnehmen, Öffnungszeiten, Verfügbarkeit und Endkundenpreise.

Ein Standort ist ein physisches Testzentrum, in dem medizinisches Fachpersonal Blutabnahmen durchführt. Mit der `id` eines Standorts buchst du `practitioner`-Termine.

> [!NOTE]
>
> Dein API-Schlüssel liefert nur Standorte innerhalb deines Partner-Zugriffskontexts. Nutze
> `GET /api/v1/locations`, um alle für dich verfügbaren Standorte aufzulisten.

Ein `location.*`-[Webhook](https://docs.anivahealth.com/de/concepts/webhooks.md) benachrichtigt dich, wenn ein Standort hinzukommt, sich ändert oder wegfällt.

## Felder

**id** `string` *required*

UUID des Standorts. Übergib diesen Wert beim Erstellen eines Termins als `location_id`.

**name** `string` *required*

Anzeigename des Standorts.

**company\_name** `string`

Klinik oder Unternehmen, das den Standort betreibt. Kann null sein.

**street** `string`

Straßenname ohne Hausnummer. Kann null sein.

**house\_number** `string`

Hausnummer. Kann null sein.

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

Zusätzliche Adresszeile – c/o, Gebäude oder Etage. Kann null sein.

**city** `string`

Stadt. Kann null sein.

**state** `string`

Bundesland oder Provinz (aufgelöst über das mit der Stadt verknüpfte Bundesland). Kann null sein,
wenn mit der Stadt kein Bundesland verknüpft ist.

**state\_code** `string`

Der [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html)-Code des Bundeslands ohne
Länderpräfix (z. B. `BW` für Baden-Württemberg). Kann null sein.

**postal\_code** `string`

Postleitzahl. Kann null sein.

**country\_name** `string`

Vollständiger Ländername (z. B. `Germany`). Kann null sein.

**country\_code** `string`

Zweistelliger Ländercode nach [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(z. B. `DE`, `US`). Kann null sein.

**timezone** `string`

IANA-Zeitzonenkennung für den Standort (z. B. `Europe/Berlin`, `America/New_York`). Nutze sie,
um geplante Zeiten in der richtigen Ortszeit anzuzeigen. Kann null sein.

**latitude** `number`

Breitengrad der Adresse in Dezimalgrad (WGS 84). Kann null sein.

**longitude** `number`

Längengrad der Adresse in Dezimalgrad (WGS 84). Kann null sein.

**contact\_phone** `string`

Telefonnummer des Standorts. Kann null sein.

**email** `string`

E-Mail-Adresse des Standorts. Kann null sein.

**website** `string`

Website-URL des Standorts. Kann null sein.

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

Direktlink zum Standort auf Google Maps. Kann null sein.

**image\_url** `string`

URL eines Fotos des Standorts. Kann null sein.

**open\_hours** `object`

Wöchentliche Öffnungszeiten des Standorts. Jeder Wochentag-Schlüssel (`monday`–`sunday`) verweist auf ein Array von
`{ open, close }`-Zeitfenstern im `HH:MM`-Format (24 Std.). Ein leeres Array bedeutet, dass der Standort an diesem Tag geschlossen
ist. Kann null sein, wenn für den Standort keine Zeiten vorliegen.

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

Wie das Blut bei einem Termin hier abgenommen wird, sofern der Termin keine eigene `draw_method`
festlegt: `capillary` (Fingerkuppe oder Oberarm, in Mikrogefäße) oder `venous` (aus der Vene, in
Röhrchen).

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

Die Abnahmemethoden, für die der Standort Gefäße vorrätig hat, sortiert. Ein Termin hier kann nur
eine davon als `draw_method` festlegen.

> [!TIP]
>
> Nutze immer das Feld `timezone`, um `scheduled_at`-Zeitstempel in die Ortszeit umzurechnen, bevor
> du sie Patienten oder Personal anzeigst.

## Verfügbarkeit

Das Feld `open_hours` oben beschreibt die statischen wöchentlichen Öffnungszeiten. Um echte buchbare Zeitfenster anzuzeigen – und Doppelbuchungen mit bestehenden Aniva-Terminen zu vermeiden – rufe [Get Availability](https://docs.anivahealth.com/de/api/locations/get-availability.md) für den Standort auf und übergib den gewünschten Zeitraum. Dieser Endpunkt ist die maßgebliche Quelle für jede Buchungsoberfläche: Er überträgt `open_hours` auf das Zeitraster des Standorts, berücksichtigt Ausnahmen für einzelne Tage, zieht bereits gebuchte Termine ab und wendet die [Mindestvorlaufzeit](https://docs.anivahealth.com/de/api/appointments/create-appointment.md#mindestvorlaufzeit) an.

## Verkaufspreise

Eine Apotheke legt für jedes Panel und jeden einzelnen Biomarker, den sie an Laufkunden
verkauft, ihren eigenen Preis fest. Du siehst einen Preis erst, nachdem die Apotheke ihn veröffentlicht hat.
[List Retail Prices](https://docs.anivahealth.com/de/api/locations/list-retail-prices.md) gibt sie für jeden Standort zurück, den du
lesen darfst, und [Get Retail Prices](https://docs.anivahealth.com/de/api/locations/get-retail-prices.md) gibt sie für einen einzelnen Standort zurück. Beide
benötigen den Scope `retail_prices_view`; `locations_view` enthält sie nicht. Fordere beide Scopes für
dieselben Standorte an.

Ein `location.retail_prices.updated`-[Webhook](https://docs.anivahealth.com/de/concepts/webhooks.md) informiert dich, wenn sich ein Preis ändert.
`location.created` und `location.deactivated` zeigen an, wenn ein Standort hinzukommt oder wegfällt. Eine Änderung,
welche Panels ein Standort anbietet, kann dich später erreichen als eine Preisänderung – rufe List Retail Prices
daher einmal täglich erneut auf.

## Beispielstandort

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