Naar hoofdinhoud gaan
PATCH
Voeg een of meer individuele biomarkers toe aan een afspraak als à-la-cartetests, buiten een vooraf samengesteld panel. Routeringsbeslissingen worden verderop genomen door de bestellogistiek-pipeline op basis van de mappings per lab van elke biomarker. De resulterende set wordt synchroon gevalideerd aan de hand van de closure-regels van elk lab. Sommige biomarkers kun je alleen verkrijgen door ze samen met andere te bestellen — een LDL/HDL-ratio wordt bijvoorbeeld geleverd door een bestelling die ook LDL en HDL oplevert, dus alleen de ratio aanvragen is geen coherente bestelling. (Op basis van diezelfde componenten wordt ook de prijs van de ratio berekend — zie het pricing- overzicht bij Biomarkers weergeven.) Als de set niet correct kan worden besteld, geeft de aanroep 400 terug met een validation-payload en wordt er niets opgeslagen, zodat je proefondervindelijk tot een geldige set kunt komen:
  1. PATCH … { "biomarker_ids": [45] } (alleen LDL/HDL-ratio) → 400; validation.failures[].fix_options[].add_biomarkers vermeldt LDL en HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (ratio + LDL + HDL) → 200.
Dezelfde lus geldt voor biomarkers die Aniva alleen binnen een positie verkoopt: vraag je er een los aan, dan geeft de aanroep 400 terug met error: "biomarker_requires_position" en de posities die deze verkopen. Zie Prijzen. Biomarkers weergeven vermeldt sommige biomarkers als price_cents: null. Deze biomarkers zijn niet gecureerd: Aniva heeft er geen prijs voor vastgesteld. Als je er een toevoegt, geeft de aanroep 400 terug met error: "biomarker_not_priced". Geen enkele andere biomarker lost deze fout op, omdat null betekent dat je geen prijs hebt om de marker voor af te nemen. Kitmarkers zijn de uitzondering. Koppel het panel dat de kit is, en de bijbehorende markers komen mee met het panel. De aanroep accepteert ook een bijbehorende marker die je toevoegt aan een afspraak die dat panel al bevat. Bij een capillaire bloedafname (draw_method: capillary) wordt de bloedafname verdeeld over microtainers. Panels gaan eerst, in volgorde van boeking. Individuele biomarkers vullen daarna de vrije ruimte in de microtainers van de panels. Als ze meer ruimte nodig hebben, openen ze nieuwe microtainers. We verdelen ze gelijkmatig. Elke microtainer bevat maximaal 150 µl aan individuele biomarkers. Een biomarker die in een eigen microtainer meer dan 150 µl nodig heeft, past nooit, en een biomarker zonder gecureerd volume ook niet. Als de resulterende set deze regel overtreedt, geeft de aanroep 400 terug met een error-melding en wordt er niets opgeslagen. Deze aanroep is idempotent: biomarkers die al bij de afspraak staan, blijven behouden. Vereist de scopes appointments_schedule en schedule_appointments_with_individual_biomarker_selection.
Biomarkers kunnen niet worden toegevoegd nadat je Bloedafname bevestigen hebt aangeroepen. Een poging om een bevestigde afspraak te wijzigen geeft 409 Conflict terug.

Verzoek

Padparameters

string
vereist
Unieke identifier (UUID) van de afspraak.

Bodyparameters

number[]
vereist
Array van biomarker-ID’s om te koppelen. Moet ten minste één item bevatten. Gebruik Biomarkers weergeven om ID’s te vinden.

Respons

Bij succes geeft de API 200 OK terug als bevestiging dat de biomarkers zijn gekoppeld.
boolean
true wanneer de biomarkers met succes aan de afspraak zijn toegevoegd.

Een 400 lezen

Elke 400 voor closure-validatie of catalogus bevat een zin in message. Een 400 voor bodyvalidatie of microtainers bevat alleen error. Vertak op error. Bij een fout in de closure-validatie is error een zin. Bij een catalogusfout is error een machinecode: biomarker_not_priced of biomarker_requires_position. Closure-validatie — de set kan bij geen enkel lab correct worden besteld:
  • validation.failures[] — alleen aanwezig bij fouten in de closure-validatie (ontbreekt bij gewone bodyvalidatiefouten). Eén item per biomarkergroep die geen enkel lab kan leveren, met de biomarker_ids die mislukten en fix_options[], met de kleinste optie eerst. De add_biomarkers ({ id, name }) van elke optie is een set die je VOLLEDIG toevoegt — behoud je oorspronkelijke selectie, voeg deze toe en probeer het opnieuw. Een lege fix_options betekent dat iets toevoegen niet helpt; verwijder in plaats daarvan de biomarker.
Biomarker zonder prijs — Aniva heeft geen prijs vastgesteld voor deze biomarker. Biomarkers weergeven vermeldt deze als price_cents: null, of laat deze weg als het een ratio is met een component zonder prijs. error is biomarker_not_priced en biomarker_id noemt de marker. Geen enkele andere biomarker lost deze fout op, dus verwijder de biomarker. Twee voorwaarden maken een biomarker bestelbaar: een lab waarnaar Aniva kan routeren moet deze leveren en de Aniva-catalogus moet er een prijs voor bevatten. Afgeschermde biomarker — een biomarker die alleen binnen een positie wordt verkocht, zonder dekkende positie in de set. error is biomarker_requires_position, biomarker_id noemt de marker en positions[] vermeldt elke positie die deze verkoopt, goedkoopste eerst. Voeg elke biomarker van een daarvan toe. Zie Prijzen voor het model en pricing.positions bij Biomarker ophalen voor de volledige set markers van een positie.

Foutresponsen