Naar hoofdinhoud gaan
Een locatie is een fysiek testcentrum waar bloedafnames worden uitgevoerd door zorgprofessionals. Je gebruikt de 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.
Een location.*-webhook meldt wanneer een locatie wordt toegevoegd, gewijzigd of verwijderd.

Velden

string
vereist
UUID van de locatie. Geef dit mee als location_id bij het aanmaken van een afspraak.
string
vereist
Weergavenaam van de locatie.
string
Kliniek of bedrijf dat de locatie exploiteert. Kan null zijn.
string
Straatnaam, zonder huisnummer. Kan null zijn.
string
Huisnummer. Kan null zijn.
string
Extra adresregel — p/a, gebouw of verdieping. Kan null zijn.
string
Plaats. Kan null zijn.
string
Deelstaat of provincie (bepaald via de gekoppelde deelstaat van de plaats). Kan null zijn als de plaats geen gekoppelde deelstaat heeft.
string
De ISO 3166-2-code van de deelstaat zonder het landvoorvoegsel (bijv. BW voor Baden-Württemberg). Kan null zijn.
string
Postcode. Kan null zijn.
string
Volledige landnaam (bijv. Germany). Kan null zijn.
string
Landcode van twee letters volgens ISO 3166-1 alpha-2 (bijv. DE, US). Kan null zijn.
string
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.
number
Breedtegraad van het adres in decimale graden (WGS 84). Kan null zijn.
number
Lengtegraad van het adres in decimale graden (WGS 84). Kan null zijn.
string
Telefoonnummer van de locatie. Kan null zijn.
string
E-mailadres van de locatie. Kan null zijn.
string
Website-URL van de locatie. Kan null zijn.
string
Directe link naar de locatie op Google Maps. Kan null zijn.
string
URL van een foto van de locatie. Kan null zijn.
object
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.
string
vereist
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).
string[]
vereist
De afnamemethoden waarvoor de locatie afnamemateriaal op voorraad heeft, gesorteerd. Een afspraak hier kan alleen een van deze methoden instellen als draw_method.
Gebruik altijd het veld timezone om scheduled_at-datums en -tijden om te zetten naar lokale tijd voordat je ze aan patiënten of medewerkers toont.

Beschikbaarheid

Het veld open_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 scope retail_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.

Voorbeeldlocatie