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.location.*-Webhook benachrichtigt dich, wenn ein Standort hinzukommt, sich ändert oder wegfällt.
Felder
UUID des Standorts. Übergib diesen Wert beim Erstellen eines Termins als
location_id.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.
Der ISO 3166-2-Code des Bundeslands ohne
Länderpräfix (z. B.
BW für Baden-Württemberg). Kann null sein.Zweistelliger Ländercode nach ISO 3166-1 alpha-2
(z. B.
DE, US). Kann null sein.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.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.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).Die Abnahmemethoden, für die der Standort Gefäße vorrätig hat, sortiert. Ein Termin hier kann nur
eine davon als
draw_method festlegen.Verfügbarkeit
Das Feldopen_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 Scoperetail_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.