Spring til hovedindhold
PATCH
Tilføj en eller flere individuelle biomarkører til en tid som à la carte-tests uden for et foruddefineret panel. Routingbeslutninger træffes nedstrøms af ordrelogistik-pipelinen baseret på hver biomarkørs tilknytninger pr. laboratorium. Det resulterende sæt valideres synkront mod hvert laboratoriums closure-regler. Nogle biomarkører kan kun fås ved at bestille dem sammen med andre — en LDL/HDL-ratio leveres for eksempel af en ordre, der også returnerer LDL og HDL, så en anmodning om ratioen alene ikke er en sammenhængende ordre. (Det er de samme komponenter, ratioen prissættes ud fra — se pricing- oversigten på Vis biomarkører.) Når sættet ikke kan bestilles korrekt, returnerer kaldet 400 med en validation-payload, og intet gemmes, så du kan prøve dig frem til et gyldigt sæt:
  1. PATCH … { "biomarker_ids": [45] } (LDL/HDL-ratio alene) → 400; validation.failures[].fix_options[].add_biomarkers viser LDL og HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (ratio + LDL + HDL) → 200.
Det samme loop dækker biomarkører, som Aniva kun sælger som del af en position: Bed om en alene, og kaldet returnerer 400 med error: "biomarker_requires_position" og de positioner, der sælger den. Se Prissætning. Vis biomarkører angiver nogle biomarkører med price_cents: null. Disse biomarkører er ukuraterede: Aniva har ikke prissat dem. Hvis du tilføjer en, returnerer kaldet 400 med error: "biomarker_not_priced". Ingen anden biomarkør løser denne fejl, fordi null betyder, at du ikke har nogen pris at købe markøren til. Kitmarkører er undtagelsen. Tilknyt det panel, der er kittet, så følger dets medlemmer med panelet. Kaldet accepterer også et medlem, som du tilføjer til en tid, der allerede har det pågældende panel. Ved en kapillær blodprøvetagning (draw_method: capillary) pakkes den i microtainere. Paneler kommer først i bookingrækkefølge. Individuelle biomarkører fylder derefter den ledige plads i panelmicrotainerne. Når de har brug for mere plads, åbner de nye microtainere. Vi fordeler dem jævnt. Hver microtainer rummer højst 150 µl individuelle biomarkører. En biomarkør, der kræver mere end 150 µl i sin egen microtainer, passer aldrig, og det gør en biomarkør uden en kurateret volumen heller ikke. Hvis det resulterende sæt bryder denne regel, returnerer kaldet 400 med en error-besked, og intet gemmes. Dette kald er idempotent: Biomarkører, der allerede er på tiden, beholdes. Kræver scopes appointments_schedule og schedule_appointments_with_individual_biomarker_selection.
Biomarkører kan ikke tilføjes, efter du har kaldt Bekræft blodprøvetagning. Forsøg på at ændre en bekræftet tid returnerer 409 Conflict.

Forespørgsel

Stiparametre

string
påkrævet
Unikt id (UUID) for tiden.

Body-parametre

number[]
påkrævet
Array af biomarkør-id’er, der skal tilknyttes. Skal indeholde mindst ét element. Brug Vis biomarkører til at finde id’er.

Svar

Ved succes returnerer API’et 200 OK som bekræftelse på, at biomarkørerne er tilknyttet.
boolean
true, når biomarkørerne er tilføjet til tiden.

Sådan læser du en 400

Hver 400 fra closure-validering og katalog indeholder en sætning i message. En 400 fra body-validering eller microtainer indeholder kun error. Skeln ud fra error. Ved en closure-valideringsfejl er error en sætning. Ved en katalogfejl er error en maskinkode: biomarker_not_priced eller biomarker_requires_position. Closure-validering — sættet kan ikke bestilles korrekt hos noget laboratorium:
  • validation.failures[] — findes kun ved closure-valideringsfejl (ikke ved almindelige body-valideringsfejl). Ét element pr. biomarkørgruppe, som intet laboratorium kan levere, med de biomarker_ids, der fejlede, og fix_options[] med den mindste løsning først. Hver løsnings add_biomarkers ({ id, name }) er et sæt, hvor du skal tilføje ALLE — behold dine oprindelige, tilføj disse, og prøv igen. En tom fix_options betyder, at det ikke hjælper at tilføje noget; fjern biomarkøren i stedet.
Ikke-prissat biomarkør — Aniva har ikke prissat denne biomarkør. Vis biomarkører angiver den som price_cents: null eller udelader den, når det er en ratio med en ikke-prissat komponent. error er biomarker_not_priced, og biomarker_id angiver markøren. Ingen anden biomarkør løser denne fejl, så fjern biomarkøren. To betingelser gør en biomarkør mulig at bestille: Et laboratorium, som Aniva kan route til, skal levere den, og Aniva-kataloget skal prissætte den. Begrænset biomarkør — en biomarkør, der kun sælges som del af en position, uden nogen dækkende position i sættet. error er biomarker_requires_position, biomarker_id angiver markøren, og positions[] viser alle positioner, der sælger den, billigste først. Tilføj alle biomarkører fra en af dem. Se Prissætning for modellen og pricing.positions på Hent biomarkør for en positions fulde medlemssæt.

Fejlsvar