Salt la conținutul principal
PATCH
Adaugă unul sau mai mulți biomarkeri individuali la o programare ca teste à-la-carte, în afara oricărui panel predefinit. Deciziile de rutare sunt luate ulterior de fluxul de logistică a comenzilor, pe baza mapărilor per laborator ale fiecărui biomarker. Setul rezultat este validat sincron față de regulile de închidere ale fiecărui laborator. Unii biomarkeri pot fi obținuți doar dacă îi comanzi împreună cu alții — un raport LDL/HDL, de exemplu, este livrat printr-o comandă care returnează și LDL și HDL, deci solicitarea raportului singur nu este o comandă coerentă. (Aceleași componente stabilesc și prețul raportului — vezi structura pricing în Listare biomarkeri.) Când setul nu poate fi comandat corect, apelul returnează 400 cu un payload validation și nimic nu este salvat, astfel încât să poți ajusta setul prin încercări până devine valid:
  1. PATCH … { "biomarker_ids": [45] } (doar raportul LDL/HDL) → 400; validation.failures[].fix_options[].add_biomarkers listează LDL și HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (raport + LDL + HDL) → 200.
Același mecanism acoperă biomarkerii pe care Aniva îi vinde doar într-o poziție: dacă ceri unul singur, apelul returnează 400 cu error: "biomarker_requires_position" și pozițiile care îl vând. Vezi Prețuri. Listare biomarkeri indică unii biomarkeri cu price_cents: null. Acești biomarkeri sunt neconfigurați: Aniva nu le-a stabilit un preț. Dacă adaugi unul, apelul returnează 400 cu error: "biomarker_not_priced". Niciun alt biomarker nu rezolvă această eroare, deoarece null înseamnă că nu ai un preț la care să cumperi markerul. Markerii din kituri sunt excepția. Atașează panelul care reprezintă kitul, iar membrii săi vin odată cu panelul. Apelul acceptă și un membru pe care îl adaugi la o programare care are deja acel panel. La o recoltare capilară (draw_method: capillary), recoltarea de sânge este repartizată în microtainere. Panelurile intră primele, în ordinea programării. Biomarkerii individuali ocupă apoi spațiul liber din microtainerele panelurilor. Când au nevoie de mai mult spațiu, deschid microtainere noi. Îi distribuim uniform. Fiecare microtainer poate conține cel mult 150 µl de biomarkeri individuali. Un biomarker care necesită mai mult de 150 µl într-un microtainer propriu nu încape niciodată, la fel și un biomarker fără un volum configurat. Dacă setul rezultat încalcă această regulă, apelul returnează 400 cu un mesaj error și nimic nu este salvat. Acest apel este idempotent: biomarkerii deja existenți în programare sunt păstrați. Necesită scope-urile appointments_schedule și schedule_appointments_with_individual_biomarker_selection.
Biomarkerii nu pot fi adăugați după ce apelezi Confirmare recoltare de sânge. Încercarea de a modifica o programare confirmată returnează 409 Conflict.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul unic (UUID) al programării.

Parametri de corp

number[]
obligatoriu
Listă de ID-uri de biomarkeri de atașat. Trebuie să conțină cel puțin un element. Folosește Listare biomarkeri pentru a afla ID-urile.

Răspuns

În caz de succes, API-ul returnează 200 OK, confirmând că biomarkerii au fost atașați.
boolean
true când biomarkerii au fost adăugați cu succes la programare.

Interpretarea unui 400

Fiecare 400 de validare a închiderii sau de catalog include o propoziție în message. Un 400 de validare a corpului sau de microtainer include doar error. Ramifică logica după error. La o eroare de validare a închiderii, error este o propoziție. La o eroare de catalog, error este un cod programatic: biomarker_not_priced sau biomarker_requires_position. Validarea închiderii — setul nu poate fi comandat corect la niciun laborator:
  • validation.failures[] — prezent doar la erorile de validare a închiderii (absent la erorile simple de validare a corpului). Câte o intrare pentru fiecare grup de biomarkeri pe care niciun laborator nu îl poate onora, conținând biomarker_ids care au eșuat și fix_options[], cu cea mai mică opțiune prima. Câmpul add_biomarkers ({ id, name }) al fiecărei opțiuni este un set pe care îl adaugi INTEGRAL — păstrează-i pe cei inițiali, adaugă-i pe aceștia și încearcă din nou. Un fix_options gol înseamnă că nu te va ajuta să adaugi nimic; elimină în schimb biomarkerul.
Biomarker fără preț — Aniva nu a stabilit un preț pentru acest biomarker. Listare biomarkeri îl indică cu price_cents: null sau îl omite când este un raport cu o componentă fără preț. error este biomarker_not_priced, iar biomarker_id indică markerul. Niciun alt biomarker nu rezolvă această eroare, așa că elimină biomarkerul. Două condiții fac un biomarker disponibil pentru comandă: un laborator către care Aniva poate ruta trebuie să îl livreze, și catalogul Aniva trebuie să îi stabilească un preț. Biomarker restricționat — un biomarker vândut doar într-o poziție, fără o poziție care să îl acopere în set. error este biomarker_requires_position, biomarker_id indică markerul, iar positions[] listează fiecare poziție care îl vinde, începând cu cea mai ieftină. Adaugă fiecare biomarker din una dintre ele. Vezi Prețuri pentru model și pricing.positions în Obținere biomarker pentru setul complet de membri al unei poziții.

Răspunsuri de eroare