Przejdź do głównej treści
PATCH
Dodaj jeden lub więcej pojedynczych biomarkerów do wizyty jako badania à la carte, poza gotowym panelem. Decyzje o kierowaniu zleceń zapadają na dalszym etapie w potoku logistyki zamówień na podstawie mapowań każdego biomarkera w poszczególnych laboratoriach. Wynikowy zestaw jest walidowany synchronicznie pod kątem reguł domknięcia każdego laboratorium. Niektóre biomarkery można uzyskać tylko wtedy, gdy zamówisz je razem z innymi — na przykład wskaźnik LDL/HDL jest realizowany w ramach zlecenia, które zwraca również LDL i HDL, więc zamówienie samego wskaźnika nie tworzy spójnego zlecenia. (To właśnie na podstawie tych samych składników wskaźnik jest wyceniany — zobacz strukturę pricing w Liście biomarkerów.) Gdy zestawu nie da się poprawnie zamówić, wywołanie zwraca 400 z obiektem validation i nic nie zostaje zapisane, dzięki czemu możesz metodą prób i błędów dojść do poprawnego zestawu:
  1. PATCH … { "biomarker_ids": [45] } (sam wskaźnik LDL/HDL) → 400; validation.failures[].fix_options[].add_biomarkers wymienia LDL i HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (wskaźnik + LDL + HDL) → 200.
Ten sam mechanizm dotyczy biomarkerów, które Aniva sprzedaje wyłącznie w ramach pozycji: zamów taki biomarker osobno, a wywołanie zwróci 400 z error: "biomarker_requires_position" oraz pozycjami, w których jest dostępny. Zobacz Cennik. Lista biomarkerów podaje niektóre biomarkery z wartością price_cents: null. Te biomarkery są nieopracowane: Aniva ich nie wyceniła. Jeśli dodasz taki biomarker, wywołanie zwróci 400 z error: "biomarker_not_priced". Żaden inny biomarker nie naprawi tego błędu, ponieważ null oznacza, że nie ma ceny, po której możesz kupić ten marker. Wyjątkiem są markery z zestawów. Dodaj panel będący zestawem, a jego składniki zostaną dołączone razem z panelem. Wywołanie akceptuje też składnik, który dodajesz do wizyty zawierającej już ten panel. Przy pobraniu kapilarnym (draw_method: capillary) pobranie jest rozdzielane do mikroprobówek. Najpierw trafiają tam panele, w kolejności rezerwacji. Następnie pojedyncze biomarkery wypełniają wolne miejsce w mikroprobówkach paneli. Gdy potrzebują więcej miejsca, otwierają nowe mikroprobówki. Rozkładamy je równomiernie. Każda mikroprobówka mieści maksymalnie 150 µl pojedynczych biomarkerów. Biomarker, który potrzebuje ponad 150 µl we własnej mikroprobówce, nigdy się nie zmieści, podobnie jak biomarker bez określonej objętości. Jeśli wynikowy zestaw łamie tę regułę, wywołanie zwraca 400 z komunikatem error i nic nie zostaje zapisane. To wywołanie jest idempotentne: biomarkery już przypisane do wizyty zostają zachowane. Wymaga zakresów appointments_schedule oraz schedule_appointments_with_individual_biomarker_selection.
Nie można dodawać biomarkerów po wywołaniu Potwierdź pobranie krwi. Próba zmiany potwierdzonej wizyty zwraca 409 Conflict.

Żądanie

Parametry ścieżki

string
wymagane
Unikalny identyfikator (UUID) wizyty.

Parametry treści

number[]
wymagane
Tablica identyfikatorów biomarkerów do dodania. Musi zawierać co najmniej jeden element. Użyj Listy biomarkerów, aby znaleźć identyfikatory.

Odpowiedź

W przypadku powodzenia API zwraca 200 OK, potwierdzając dodanie biomarkerów.
boolean
true, gdy biomarkery zostały pomyślnie dodane do wizyty.

Odczytywanie 400

Każdy błąd 400 związany z walidacją domknięcia lub katalogiem zawiera zdanie w polu message. Błąd 400 dotyczący walidacji treści lub mikroprobówek zawiera samo pole error. Rozgałęziaj logikę na podstawie error. Przy błędzie walidacji domknięcia error jest zdaniem. Przy błędzie katalogu error jest kodem maszynowym: biomarker_not_priced lub biomarker_requires_position. Walidacja domknięcia — zestawu nie da się poprawnie zamówić w żadnym laboratorium:
  • validation.failures[] — obecne tylko przy błędach walidacji domknięcia (brak przy zwykłych błędach walidacji treści). Jeden wpis na każdą grupę biomarkerów, której żadne laboratorium nie obsługuje, zawierający błędne biomarker_ids oraz fix_options[], od najmniejszej opcji. Pole add_biomarkers ({ id, name }) w każdej opcji to zestaw, który musisz dodać W CAŁOŚCI — zachowaj pierwotne biomarkery, dodaj te i spróbuj ponownie. Puste fix_options oznacza, że dodanie innych biomarkerów nie pomoże; zamiast tego usuń ten biomarker.
Biomarker bez wyceny — Aniva nie wyceniła tego biomarkera. Lista biomarkerów podaje go jako price_cents: null lub go pomija, jeśli jest wskaźnikiem z niewycenionym składnikiem. error ma wartość biomarker_not_priced, a biomarker_id wskazuje ten marker. Żaden inny biomarker nie naprawi tego błędu, więc usuń ten biomarker. O możliwości zamówienia biomarkera decydują dwa warunki: laboratorium, do którego Aniva może skierować zlecenie, musi go wykonywać, oraz katalog Aniva musi mieć jego wycenę. Biomarker wymagający pozycji — biomarker sprzedawany wyłącznie w ramach pozycji, dla którego w zestawie brakuje odpowiedniej pozycji. error ma wartość biomarker_requires_position, biomarker_id wskazuje ten marker, a positions[] wymienia każdą pozycję, w której jest dostępny, od najtańszej. Dodaj wszystkie biomarkery z jednej z nich. Zobacz Cennik, aby poznać ten model, oraz pricing.positions w Pobierz biomarker, aby zobaczyć pełny zestaw składników pozycji.

Odpowiedzi z błędami