Naar hoofdinhoud gaan
Gebruik deze handleiding om te bevestigen dat een bloedafname heeft plaatsgevonden. De bevestiging legt de labcodes (barcodes op de buisjes) van de fysieke kit vast en start de laborder-pipeline; de voortgang van de resultaten lees je vervolgens uit via Resultaten ophalen.
Bevestigen is onomkeerbaar. Zodra je een bloedafname hebt bevestigd, kunnen er geen wijzigingen meer — inclusief het toevoegen van panels — aan de afspraak worden aangebracht. Zorg ervoor dat alle panels zijn gekoppeld en alle gegevens kloppen voordat je verdergaat.
1

Controleren of panels zijn toegevoegd

Controleer voordat je bevestigt of alle benodigde testpanels aan de afspraak zijn toegevoegd. Na bevestiging kun je geen panels meer toevoegen.Bekijk de handleiding Een afspraak plannen voor instructies over het koppelen van panels.Controleer het volgende voordat je verdergaat:
  • Alle vereiste panels zijn gekoppeld aan de afspraak.
  • De profile_id en location_id bij de afspraak kloppen.
  • De patiënt heeft de bloedafname afgerond en de barcode van elk buisje ligt klaar.
2

Bloedafname bevestigen

Stuur een POST-verzoek naar /api/v1/appointments/{id}/confirm met de labcodes van de fysieke bloedafnamekit. Een veneuze bloedafname heeft één code die op elk buisje staat — stuur deze als lab_code. Een bloedafname in de apotheek heeft één code per microtainer — stuur deze als lab_codes, één item per code met de panel_ids die de microtainer bevat (uit panels van de afspraak); elke code wordt een eigen laboratoriumaanvraag. Losse biomarkers in een apotheek vullen eerst de vrije ruimte van de panel-microtainers. Stuur één item zonder panel_ids voor elke microtainer die ze apart nodig hebben.
Elke code moet de cijferreeks zijn die op het fysieke buisje staat dat aan de patiënt is gegeven. Gebruik geen andere identificatiecode — door een onjuiste code mislukt de laborder. Elke code wordt gevalideerd voordat er iets wordt weggeschreven; als er één wordt afgewezen, wordt er niets vastgelegd.
Een geslaagd verzoek geeft 200 OK terug:
3

Afspraakstatus controleren

Haal na bevestiging de afspraak op om te controleren of de status is gewijzigd naar blood_drawn.
Zodra de afspraak status: "blood_drawn" toont, is de laborder-pipeline gestart. De afspraakstatus zelf blijft vanaf nu blood_drawn; meer gedetailleerde voortgang verderop in het proces is beschikbaar via specifieke endpoints: volg elk item in de inline shipments-array naar Zending ophalen voor koerierevents over onderweg / bezorgd, en gebruik Resultaten ophalen voor de voltooiing van de labresultaten (status: "in_progress" → "completed").

Wat er daarna gebeurt

Na bevestiging neemt de laborder-pipeline van Aniva het over:
  1. Elke labcode wordt in het laboratorium gekoppeld aan de fysieke buisjes — de aanvraag van elk panel draagt de code van de eigen buisjes.
  2. De panels die aan de afspraak zijn gekoppeld, bepalen welke tests worden uitgevoerd.
  3. Zodra resultaten klaar zijn, worden ze gekoppeld aan het patiëntprofiel en verschijnen ze in Resultaten ophalen — het top-level status-veld in het antwoord verandert van in_progress naar completed zodra elke inzending is afgesloten en één ervan heeft gerapporteerd.
Na bevestiging is er geen verdere actie meer nodig vanuit je integratie.

Foutafhandeling