id van een locatie om practitioner-afspraken in te plannen.
Je API-sleutel geeft alleen locaties binnen jouw partnertoegangscontext terug. Gebruik
GET /api/v1/locations om alle locaties op te vragen die voor jou beschikbaar zijn.location.*-webhook meldt wanneer een locatie wordt toegevoegd, gewijzigd of verwijderd.
Velden
Deelstaat of provincie (bepaald via de gekoppelde deelstaat van de plaats). Kan null zijn als de
plaats geen gekoppelde deelstaat heeft.
De ISO 3166-2-code van de deelstaat zonder het
landvoorvoegsel (bijv.
BW voor Baden-Württemberg). Kan null zijn.Landcode van twee letters volgens ISO 3166-1 alpha-2
(bijv.
DE, US). Kan null zijn.IANA-tijdzone-identifier voor de locatie (bijv.
Europe/Berlin, America/New_York). Gebruik dit om
geplande tijden in de juiste lokale tijd te tonen. Kan null zijn.Wekelijkse openingstijden van de locatie. Elke weekdagsleutel (
monday–sunday) verwijst naar een array van
{ open, close }-tijdvakken in het formaat HH:MM (24-uurs). Een lege array betekent dat de locatie
die dag gesloten is. Kan null zijn als er geen openingstijden voor de locatie beschikbaar zijn.Hoe het bloed hier tijdens een afspraak wordt afgenomen, tenzij de afspraak een eigen
draw_method instelt:
capillary (vingertop of bovenarm, in microtainers) of venous (uit de ader, in buisjes).De afnamemethoden waarvoor de locatie afnamemateriaal op voorraad heeft, gesorteerd. Een afspraak hier kan alleen een
van deze methoden instellen als
draw_method.Beschikbaarheid
Het veldopen_hours hierboven beschrijft het statische wekelijkse openingsschema. Om echte boekbare tijdsloten weer te geven — en dubbele boekingen met bestaande Aniva-afspraken te voorkomen — roep je Get Availability aan voor de locatie en geef je het datumbereik mee dat je wilt tonen. Dat endpoint is de juiste bron van waarheid voor elke boekings-UI: het zet open_hours om naar het tijdslotraster van de locatie, past uitzonderingen per datum toe, haalt al geboekte afspraken eraf en past de minimale voorlooptijd toe.
Verkoopprijzen
Een apotheek bepaalt zelf de prijs voor elk panel en elke losse biomarker die ze aan inloopklanten verkoopt. Je ziet een prijs pas nadat de apotheek deze heeft gepubliceerd. List Retail Prices geeft ze terug voor elke locatie die je kunt lezen, en Get Retail Prices geeft ze terug voor één locatie. Beide hebben de scoperetail_prices_view nodig; locations_view bevat ze niet. Vraag beide scopes aan voor
dezelfde locaties.
Een location.retail_prices.updated-webhook laat je weten wanneer een prijs verandert.
location.created en location.deactivated laten je weten wanneer een locatie erbij komt of verdwijnt. Een wijziging in
welke panels een locatie aanbiedt kan je later bereiken dan een prijswijziging, dus lees List Retail Prices
eenmaal per dag opnieuw uit.