Přejít na hlavní obsah
PATCH
Uprav údaje termínu, například naplánovaný čas nebo odběrové místo. Upravit lze jen termíny, u kterých ještě nebyl potvrzen odběr krve.
Termíny nelze upravovat po potvrzení odběru krve ani po jejich zrušení. Pokus o úpravu takového termínu vrátí 409 Conflict. Jedinou výjimkou je results_ready_emails, které můžeš změnit i po odběru krve.
Vyžaduje scope appointments_schedule nebo appointments_manage.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) termínu, který chceš upravit.

Parametry těla

Všechny parametry těla požadavku jsou volitelné — uveď jen pole, která chceš změnit.
string
Nové datum a čas termínu ve formátu ISO 8601 (např. 2026-05-20T14:00:00Z nebo 2026-05-20T16:00:00+02:00). Musí obsahovat označení časového pásma — buď Z, nebo explicitní posun jako +02:00; časy bez časového pásma jsou zamítnuty. Musí být v budoucnosti.Musí jít o přesný začátek slotu se zbývající kapacitou — viz Získat dostupnost. Přesouvaný termín se nikdy nezapočítává do kapacity vlastního cílového slotu, ale přesun na slot, kde už má stejný profil jiný termín, vrátí 409 s appointment_id daného termínu.Pokud cílové odběrové místo provozuje Aniva, musí být nový čas také alespoň 12 hodin dopředu — viz Minimální předstih.
string
UUID nového odběrového místa. Místo musí existovat a být aktivní. Použij Seznam odběrových míst k nalezení dostupných ID míst.
string[]
Nahradí seznam až 5 adres, z nichž každá dostane jeden e-mail, jakmile jsou všechny laboratorní výsledky konečné. Pro vypnutí e-mailů pošli []. Toto pole zůstává upravitelné i po odběru krve; odmítne ho jen zrušený termín. Po odběru krve ho posílej samostatně: pokud je ve stejném těle scheduled_at nebo location_id, požadavek vrátí 409. Tvůj klíč potřebuje přístup results_view k pacientovi, jinak dostaneš 403. Viz E-maily o hotových výsledcích.
string | null
Nová metoda odběru: capillary nebo venous, případně null pro opětovné použití default_draw_method daného místa. Místo musí tuto metodu uvádět ve svém draw_methods a rezervované testy s ní musí jít provést, jinak vrátí 400. Když termín přesuneš na jiné místo, proběhne tam stejná kontrola: u jeho vlastního draw_method, jinak u default_draw_method nového místa.

Odpověď

V případě úspěchu API vrátí 200 OK s upraveným termínem a jeho vnořeným profilem.
string
povinné
Jedinečný identifikátor termínu (UUID).
string
povinné
UUID profilu, ke kterému tento termín patří.
string
UUID odběrového místa, kde odběr krve probíhá.
string
Naplánované datum a čas termínu jako okamžik v UTC (ISO 8601 s příponou Z, např. 2026-05-20T14:00:00Z). Může být null.
string
povinné
Aktuální stav termínu. Jedna z hodnot pending, confirmed, blood_drawn nebo cancelled. Podrobnější stav dokončení laboratorních výsledků najdeš v Získat výsledky; detailnější průběh zásilky v jednotlivých položkách pole shipments (viz níže) a následně v Získat zásilku.
string
Volný text s důvodem zaznamenaným při zrušení termínu (např. nedostavení se, pozdní zrušení, „Nezdařilo se. Nutné opakování“). null, pokud status není cancelled.
string[]
povinné
Adresy malými písmeny, z nichž každá dostane jeden e-mail, jakmile jsou všechny laboratorní výsledky konečné. Prázdné, když je vypnuto. Viz E-maily o připravených výsledcích.
string
povinné
Způsob odběru krve: capillary (z konečku prstu nebo horní části paže do mikrozkumavek) nebo venous (ze žíly do zkumavek). Jde o metodu nastavenou u termínu, jinak default_draw_method jeho místa. Po odběru krve uvádí metodu, která byla použita.
string
povinné
Časové razítko ISO 8601 vytvoření termínu.
string
Časové razítko ISO 8601 poslední aktualizace. Může být null.
object
povinné
Profil pacienta spojený s tímto termínem.
AppointmentPanel[]
povinné
Panely aktuálně připojené k tomuto termínu. Nezahrnuje zrušená připojení. Detaily panelu (název, biomarkery) najdeš přes Seznam panelů.
AppointmentIndividualBiomarker[]
povinné
Samostatné biomarkery připojené k tomuto termínu mimo jakýkoli panel (viz Přidat vlastní biomarkery). Údaje pro zobrazení pro každé biomarker_id dohledej přes Vypsat biomarkery.
AppointmentShipmentLink[]
povinné
Zásilky propojené s tímto termínem, od nejstaršího propojení. Prázdné pole, pokud nejsou propojeny žádné zásilky. Pro celý payload zásilky dohledej každé id přes Získat zásilku.
string[]
povinné
Laboratorní kódy (čárové kódy zkumavek) zaznamenané pro tento termín v pořadí skenování. Prázdné, dokud není potvrzen odběr krve. Žilní odběr krve má jeden kód vytištěný na každé zkumavce; kapilární odběr má jeden kód pro každou mikrozkumavku. Výsledky a dokumenty v Získat výsledky na tyto kódy odkazují přes lab_code.

Chybové odpovědi