Přejít na hlavní obsah
PATCH
Přidej k termínu jeden nebo více jednotlivých biomarkerů jako samostatné testy mimo jakýkoli předpřipravený panel. O směrování rozhoduje navazující pipeline pro logistiku objednávek podle mapování každého biomarkeru pro jednotlivé laboratoře. Výsledná sada se synchronně ověřuje podle pravidel uzavřenosti jednotlivých laboratoří. Některé biomarkery lze získat jen tehdy, když je objednáš společně s jinými — například poměr LDL/HDL se dodává v rámci objednávky, která vrací také LDL a HDL, takže požadovat samotný poměr není ucelená objednávka. (Podle stejných složek je poměr také oceněn — podívej se na rozpis pricing ve Výpisu biomarkerů.) Když sadu nelze čistě objednat, volání vrátí 400 s payloadem validation a nic se neuloží, takže se k platné sadě můžeš dopracovat metodou pokus–omyl:
  1. PATCH … { "biomarker_ids": [45] } (samotný poměr LDL/HDL) → 400; validation.failures[].fix_options[].add_biomarkers uvádí LDL a HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (poměr + LDL + HDL) → 200.
Stejný postup platí pro biomarkery, které Aniva prodává jen v rámci pozice: když požádáš jen o jeden samostatně, volání vrátí 400 s error: "biomarker_requires_position" a pozicemi, které ho prodávají. Podívej se na Ceny. Výpis biomarkerů u některých biomarkerů uvádí price_cents: null. Tyto biomarkery jsou nekurované: Aniva jim nestanovila cenu. Pokud některý přidáš, volání vrátí 400 s error: "biomarker_not_priced". Žádný jiný biomarker tuto chybu nevyřeší, protože null znamená, že pro tento marker nemáš nákupní cenu. Výjimkou jsou markery ze sady. Připoj panel, který tuto sadu představuje, a jeho součásti se přidají společně s ním. Volání přijme i součást, kterou přidáš k termínu, který už tento panel obsahuje. Při kapilárním odběru krve (draw_method: capillary) se odběr rozděluje do mikrozkumavek. Jako první přijdou na řadu panely, a to v pořadí rezervace. Jednotlivé biomarkery pak zaplní volné místo v mikrozkumavkách pro panely. Když potřebují víc místa, otevřou se nové mikrozkumavky. Rozdělujeme je rovnoměrně. Každá mikrozkumavka pojme nejvýše 150 µl jednotlivých biomarkerů. Biomarker, který ve vlastní mikrozkumavce potřebuje víc než 150 µl, se nikdy nevejde, stejně jako biomarker bez stanoveného objemu. Pokud výsledná sada toto pravidlo poruší, volání vrátí 400 se zprávou error a nic se neuloží. Toto volání je idempotentní: biomarkery, které už u termínu jsou, zůstanou zachovány. Vyžaduje rozsahy appointments_schedule a schedule_appointments_with_individual_biomarker_selection.
Biomarkery nelze přidávat poté, co zavoláš Potvrzení odběru krve. Pokus o úpravu potvrzeného termínu vrátí 409 Conflict.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) termínu.

Parametry těla

number[]
povinné
Pole ID biomarkerů k připojení. Musí obsahovat alespoň jednu položku. K nalezení ID použij Výpis biomarkerů.

Odpověď

Při úspěchu vrátí API 200 OK s potvrzením, že biomarkery byly připojeny.
boolean
true, když byly biomarkery úspěšně přidány k termínu.

Jak číst 400

Každá 400 z validace uzavřenosti a katalogu obsahuje větu v message. Chyba 400 z validace těla nebo mikrozkumavek obsahuje jen error. Větvi podle error. Při selhání validace uzavřenosti je error věta. Při chybě katalogu je error strojový kód: biomarker_not_priced nebo biomarker_requires_position. Validace uzavřenosti — sadu nelze čistě objednat v žádné laboratoři:
  • validation.failures[] — přítomno jen při selhání validace uzavřenosti (u běžných chyb validace těla chybí). Jeden záznam pro každou skupinu biomarkerů, kterou žádná laboratoř neumí zpracovat, s hodnotami biomarker_ids, které selhaly, a fix_options[] od nejmenší možnosti. add_biomarkers ({ id, name }) každé možnosti je sada, kterou přidáš CELOU — ponech původní, přidej tyto a zkus to znovu. Prázdné fix_options znamená, že žádné přidání nepomůže; místo toho biomarker odeber.
Neoceněný biomarker — Aniva tomuto biomarkeru nestanovila cenu. Výpis biomarkerů ho uvádí jako price_cents: null, případně ho vynechá, pokud jde o poměr s neoceněnou složkou. error má hodnotu biomarker_not_priced a biomarker_id označuje daný marker. Žádný jiný biomarker tuto chybu nevyřeší, takže biomarker odeber. Biomarker lze objednat za dvou podmínek: musí ho dodávat laboratoř, do které umí Aniva směrovat, a katalog Aniva mu musí stanovit cenu. Vázaný biomarker — biomarker prodávaný jen v rámci pozice, přičemž v sadě žádná pokrývající pozice není. error má hodnotu biomarker_requires_position, biomarker_id označuje daný marker a positions[] uvádí všechny pozice, které ho prodávají, od nejlevnější. Přidej všechny biomarkery z jedné z nich. Model najdeš v části Ceny a úplnou sadu součástí pozice v pricing.positions v Získání biomarkeru.

Chybové odpovědi