Naar hoofdinhoud gaan
PATCH
Werk afspraakgegevens bij, zoals het geplande tijdstip of de testlocatie. Alleen afspraken waarvan de bloedafname nog niet is bevestigd, kunnen worden gewijzigd.
Afspraken kunnen niet worden gewijzigd nadat de bloedafname is bevestigd of als ze al zijn geannuleerd. Een poging om zo’n afspraak bij te werken geeft 409 Conflict terug. De enige uitzondering is results_ready_emails, dat je na de bloedafname nog kunt aanpassen.
Vereist de scope appointments_schedule of appointments_manage.

Verzoek

Padparameters

string
vereist
Unieke identifier (UUID) van de afspraak die je wilt bijwerken.

Bodyparameters

Alle bodyparameters zijn optioneel — neem alleen de velden op die je wilt wijzigen.
string
Nieuwe datum en tijd van de afspraak in ISO 8601-formaat (bijv. 2026-05-20T14:00:00Z of 2026-05-20T16:00:00+02:00). Moet een tijdzone-aanduiding bevatten — ofwel Z of een expliciete offset zoals +02:00; naïeve datum-tijden worden geweigerd. Moet in de toekomst liggen.Moet een exacte starttijd van een tijdslot met resterende capaciteit zijn — zie Beschikbaarheid ophalen. De afspraak die wordt verzet telt nooit mee voor het eigen doeltijdslot, maar verplaatsen naar een tijdslot waarop hetzelfde profiel al een andere afspraak heeft, geeft 409 terug met de appointment_id van die afspraak.Als de beoogde locatie door Aniva wordt beheerd, moet het nieuwe tijdstip ook minimaal 12 uur vooruit liggen — zie Minimale termijn.
string
UUID van de nieuwe testlocatie. De locatie moet bestaan en actief zijn. Gebruik Locaties ophalen om beschikbare locatie-ID’s te vinden.
string[]
Vervangt de lijst van maximaal 5 adressen die elk één e-mail krijgen zodra alle labresultaten definitief zijn. Stuur [] om de e-mails uit te zetten. Dit veld blijft bewerkbaar na de bloedafname; alleen een geannuleerde afspraak weigert het. Stuur het na de bloedafname apart: met scheduled_at of location_id in dezelfde body geeft het verzoek 409 terug. Je sleutel heeft results_view-toegang tot de patiënt nodig, anders 403. Zie E-mails wanneer resultaten klaarstaan.
string | null
Nieuwe afnamemethode: capillary of venous, of null om weer de default_draw_method van de locatie te gebruiken. De locatie moet de methode in draw_methods hebben staan en de geboekte tests moeten ermee mogelijk zijn, anders 400. Wanneer je een afspraak naar een andere locatie verplaatst, wordt daar dezelfde controle uitgevoerd: op de eigen draw_method, anders op de default_draw_method van de nieuwe locatie.

Respons

Bij succes geeft de API 200 OK terug met de bijgewerkte afspraak en het ingesloten profiel.
string
vereist
Unieke afspraak-identifier (UUID).
string
vereist
UUID van het profiel waarbij deze afspraak hoort.
string
UUID van de testlocatie waar de bloedafname plaatsvindt.
string
Geplande datum en tijd van de afspraak als UTC-tijdstip (ISO 8601 met Z-achtervoegsel, bijv. 2026-05-20T14:00:00Z). Kan null zijn.
string
vereist
Huidige status van de afspraak. Een van pending, confirmed, blood_drawn of cancelled. De gedetailleerde voortgang van labresultaten leid je af uit Resultaten ophalen; de verdere voortgang van zendingen uit elk item in de inline shipments-array (zie hieronder) door deze op te vragen via Zending ophalen.
string
Vrije tekst als reden die is vastgelegd bij het annuleren van de afspraak (bijv. no-show, late annulering, ‘Mislukt. Herhaling vereist’). null tenzij status gelijk is aan cancelled.
string[]
vereist
E-mailadressen die elk één e-mail krijgen zodra alle labresultaten definitief zijn, in kleine letters. Leeg wanneer uitgeschakeld. Zie E-mails bij beschikbare resultaten.
string
vereist
Hoe het bloed wordt afgenomen: capillary (vingertop of bovenarm, in microtainers) of venous (uit de ader, in buisjes). Dit is de methode die de afspraak instelt, anders de default_draw_method van de locatie. Na de bloedafname is dit de methode die is gebruikt.
string
vereist
ISO 8601-tijdstempel van wanneer de afspraak is aangemaakt.
string
ISO 8601-tijdstempel van de laatste update. Kan null zijn.
object
vereist
Het patiëntprofiel dat bij deze afspraak hoort.
AppointmentPanel[]
vereist
Panels die momenteel aan deze afspraak zijn gekoppeld. Geannuleerde koppelingen zijn uitgesloten. Zoek details van een panel (naam, biomarkers) op via Panels weergeven.
AppointmentIndividualBiomarker[]
vereist
À-la-carte biomarkers die los van een panel aan deze afspraak zijn gekoppeld (zie Aangepaste biomarkers toevoegen). Zoek elke biomarker_id op via Biomarkers opvragen voor weergavegegevens.
AppointmentShipmentLink[]
vereist
Zendingen gekoppeld aan deze afspraak, met de oudste koppeling eerst. Lege array wanneer er geen zendingen zijn gekoppeld. Gebruik elke id bij Zending ophalen voor de volledige zendingspayload.
string[]
vereist
Labcodes (barcodes op de buisjes) die voor deze afspraak zijn vastgelegd, in scanvolgorde. Leeg totdat de bloedafname is bevestigd. Een veneuze bloedafname heeft één code die op elk buisje staat gedrukt; een capillaire bloedafname heeft één code per microtainer. Resultaten en documenten op Resultaten ophalen verwijzen naar deze codes via lab_code.

Foutresponsen