Zum Hauptinhalt springen
Ein Standort ist ein physisches Testzentrum, in dem medizinisches Fachpersonal Blutabnahmen durchführt. Mit der id eines Standorts buchst du practitioner-Termine.
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 benachrichtigt dich, wenn ein Standort hinzukommt, sich ändert oder wegfällt.

Felder

string
erforderlich
UUID des Standorts. Übergib diesen Wert beim Erstellen eines Termins als location_id.
string
erforderlich
Anzeigename des Standorts.
string
Klinik oder Unternehmen, das den Standort betreibt. Kann null sein.
string
Straßenname ohne Hausnummer. Kann null sein.
string
Hausnummer. Kann null sein.
string
Zusätzliche Adresszeile – c/o, Gebäude oder Etage. Kann null sein.
string
Stadt. Kann null sein.
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.
string
Der ISO 3166-2-Code des Bundeslands ohne Länderpräfix (z. B. BW für Baden-Württemberg). Kann null sein.
string
Postleitzahl. Kann null sein.
string
Vollständiger Ländername (z. B. Germany). Kann null sein.
string
Zweistelliger Ländercode nach ISO 3166-1 alpha-2 (z. B. DE, US). Kann null sein.
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.
number
Breitengrad der Adresse in Dezimalgrad (WGS 84). Kann null sein.
number
Längengrad der Adresse in Dezimalgrad (WGS 84). Kann null sein.
string
Telefonnummer des Standorts. Kann null sein.
string
E-Mail-Adresse des Standorts. Kann null sein.
string
Website-URL des Standorts. Kann null sein.
string
Direktlink zum Standort auf Google Maps. Kann null sein.
string
URL eines Fotos des Standorts. Kann null sein.
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.
string
erforderlich
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).
string[]
erforderlich
Die Abnahmemethoden, für die der Standort Gefäße vorrätig hat, sortiert. Ein Termin hier kann nur eine davon als draw_method festlegen.
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 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 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 gibt sie für jeden Standort zurück, den du lesen darfst, und Get Retail Prices 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 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