Hoppa till huvudinnehåll
PATCH
Lägg till en eller flera enskilda biomarkörer i en bokning som à la carte-tester, utanför en färdig panel. Dirigeringsbeslut fattas nedströms av orderlogistikflödet baserat på varje biomarkörs mappningar per labb. Den resulterande uppsättningen valideras synkront mot varje labbs slutenhetsregler. Vissa biomarkörer går bara att få genom att beställa dem tillsammans med andra – en LDL/HDL-kvot levereras till exempel av en beställning som också returnerar LDL och HDL, så att bara begära kvoten ger ingen sammanhängande beställning. (Det är samma komponenter som kvoten prissätts efter – se uppdelningen i pricing under Lista biomarkörer.) När uppsättningen inte kan beställas som den är returnerar anropet 400 med en validation-payload och inget sparas, så att du kan testa dig fram till en giltig uppsättning:
  1. PATCH … { "biomarker_ids": [45] } (enbart LDL/HDL-kvot) → 400; validation.failures[].fix_options[].add_biomarkers listar LDL och HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (kvot + LDL + HDL) → 200.
Samma loop gäller biomarkörer som Aniva bara säljer i en position: begär en sådan ensam så returnerar anropet 400 med error: "biomarker_requires_position" och de positioner som säljer den. Se Prissättning. Lista biomarkörer anger price_cents: null för vissa biomarkörer. Dessa biomarkörer är okurerade: Aniva har inte prissatt dem. Om du lägger till en sådan returnerar anropet 400 med error: "biomarker_not_priced". Ingen annan biomarkör löser det här felet, eftersom null innebär att du saknar ett pris att köpa markören för. Kitmarkörer är undantaget. Lägg till panelen som utgör kitet, så följer dess ingående markörer med panelen. Anropet godkänner också en ingående markör som du lägger till i en bokning som redan innehåller den panelen. Vid en kapillär blodprovstagning (draw_method: capillary) packas provet i mikrotainers. Paneler kommer först, i bokningsordning. Enskilda biomarkörer fyller sedan det lediga utrymmet i panelernas mikrotainers. När de behöver mer plats öppnas nya mikrotainers. Vi fördelar dem jämnt. Varje mikrotainer rymmer högst 150 µl enskilda biomarkörer. En biomarkör som behöver mer än 150 µl i en egen mikrotainer får aldrig plats, och det får inte heller en biomarkör utan en kurerad volym. Om den resulterande uppsättningen bryter mot den här regeln returnerar anropet 400 med ett error-meddelande och inget sparas. Det här anropet är idempotent: biomarkörer som redan finns i bokningen behålls. Kräver scopen appointments_schedule och schedule_appointments_with_individual_biomarker_selection.
Biomarkörer kan inte läggas till efter att du har anropat Bekräfta blodprovstagning. Försök att ändra en bekräftad bokning returnerar 409 Conflict.

Förfrågan

Sökvägsparametrar

string
obligatorisk
Unik identifierare (UUID) för bokningen.

Body-parametrar

number[]
obligatorisk
Array med biomarkör-ID:n att lägga till. Måste innehålla minst ett objekt. Använd Lista biomarkörer för att hitta ID:n.

Svar

Om anropet lyckas returnerar API:et 200 OK som bekräftelse på att biomarkörerna har lagts till.
boolean
true när biomarkörerna har lagts till i bokningen.

Så tolkar du 400

Varje 400 vid slutenhetsvalidering eller katalogfel innehåller en mening i message. En 400 vid body-validering eller mikrotainerfel innehåller enbart error. Förgrena på error. Vid ett slutenhetsvalideringsfel är error en mening. Vid ett katalogfel är error en maskinkod: biomarker_not_priced eller biomarker_requires_position. Slutenhetsvalidering – uppsättningen kan inte beställas som den är hos något labb:
  • validation.failures[] – finns bara med vid slutenhetsvalideringsfel (saknas vid vanliga body-valideringsfel). En post per biomarkörgrupp som inget labb kan hantera, med de biomarker_ids som misslyckades och fix_options[], med det minsta alternativet först. Varje alternativs add_biomarkers ({ id, name }) är en uppsättning där du lägger till ALLA – behåll dina ursprungliga, lägg till dessa och försök igen. En tom fix_options innebär att inget tillägg hjälper; ta bort biomarkören i stället.
Oprissatt biomarkör – Aniva har inte prissatt den här biomarkören. Lista biomarkörer anger den som price_cents: null, eller utelämnar den när den är en kvot med en oprissatt komponent. error är biomarker_not_priced och biomarker_id anger markören. Ingen annan biomarkör löser det här felet, så ta bort biomarkören. Två villkor gör en biomarkör beställningsbar: ett labb som Aniva kan dirigera till måste leverera den, och Anivas katalog måste ha ett pris för den. Positionsbunden biomarkör – en biomarkör som bara säljs i en position, utan någon täckande position i uppsättningen. error är biomarker_requires_position, biomarker_id anger markören och positions[] listar varje position som säljer den, billigast först. Lägg till alla biomarkörer i en av dem. Se Prissättning för modellen och pricing.positions i Hämta biomarkör för en positions fullständiga uppsättning av markörer.

Felsvar