Přejít na hlavní obsah
DELETE
Zruš termín nastavením jeho stavu na cancelled. Zrušit můžeš jen termíny, u kterých ještě nebyl potvrzen odběr krve. Zrušení termínu, který už má stav cancelled, vrátí 200 s tímto termínem a nic nezapíše — žádné druhé zrušení se nezaznamená. Odpověď obsahuje Idempotent-Replayed: true, takže odlišíš opakované volání od toho, které akci provedlo. Opakované volání s jiným cancellation_reason místo toho vrátí 409: zaznamenaný důvod se nikdy nepřepíše. Viz Idempotence.
Po potvrzení odběru krve nelze termíny zrušit — to vrátí 409 Conflict.
Vyžaduje scope appointments_schedule nebo appointments_manage.

Požadavek

Parametry cesty

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

Parametry těla

Tělo je volitelné — pokud chceš termín zrušit bez zaznamenání důvodu, žádné tělo neposílej.
string
Volný text s důvodem zrušení, až 500 znaků (např. Patient no-show). Uloží se k termínu a vrací se jako cancellation_reason při tomto i pozdějších načteních.

Odpověď

Při úspěchu vrátí API 200 OK se zrušený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
Plánované datum a čas termínu v UTC (ISO 8601 s příponou Z, např. 2026-05-15T10:30:00Z). Může být null.
string
povinné
Stav termínu. Po úspěšném zrušení bude cancelled.
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, které byly k tomuto termínu připojeny před zrušením. Podrobnosti o panelu (název, biomarkery) najdeš přes Vypsat panely.
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, které byly k tomuto termínu přiřazeny před zrušením. Každé id odkazuje na 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