Přejít na hlavní obsah
POST
Naplánuj termín odběru krve pro profil pacienta na konkrétním odběrovém místě. Po vytvoření přejde termín standardně do stavu confirmed (některá odběrová místa mohou mít jako výchozí stav pending — jde o nastavení konkrétního místa). Pomocí Přidat panely připoj panely krevních testů před potvrzením odběru krve.
Profil může mít nejvýše jeden termín pro dané odběrové místo a čas. Vytvoření termínu pro slot, který už profil obsazuje, vrátí 409 s existujícím appointment_id místo druhého termínu — opakovaný nebo omylem znovu odeslaný požadavek tak nikdy nevytvoří duplicitní rezervaci. Viz Duplicitní termíny.
Odešli volitelnou hlavičku Idempotency-Key, aby šlo toto vytvoření bezpečně zopakovat — opakované použití stejného klíče vrátí původní odpověď místo vytvoření dalšího záznamu. Viz Idempotence. Vyžaduje rozsah appointments_schedule.

Požadavek

Parametry těla

string
povinné
UUID profilu pacienta, pro který se termín vytváří.
string
povinné
UUID odběrového místa, kde odběr krve proběhne. Dostupná ID míst najdeš přes Vypsat odběrová místa.
string
povinné
Datum a čas termínu ve formátu ISO 8601 (např. 2026-05-15T10:30:00Z nebo 2026-05-15T12:30:00+02:00). Musí obsahovat označení časového pásma — buď Z, nebo explicitní posun jako +02:00; hodnoty bez časového pásma jsou odmítnuty. Musí být v budoucnosti.Musí jít o přesný začátek slotu v rozvrhu odběrového místa a slot musí mít volnou kapacitu — nejprve načti Získat dostupnost. Časy mimo rozvrh vracejí 400; obsazený slot vrací 409. Na odběrových místech provozovaných Anivou musí být termín také alespoň 12 hodin dopředu — viz Minimální předstih.
string[]
Až 5 adres, z nichž každá dostane jeden e-mail, jakmile budou všechny laboratorní výsledky konečné. E-mail odkazuje na stránku s výsledky v administračním panelu Aniva. Tvůj klíč potřebuje oprávnění results_view k pacientovi, jinak 403. Vynech ho, pokud chceš použít výchozí adresy nastavené pro skupinu pacienta. Prázdný seznam e-maily vypne. Viz E-maily o připravených výsledcích.
string
Způsob odběru krve: capillary nebo venous. Vynech ho, pokud chceš použít default_draw_method daného odběrového místa. Odběrové místo musí tuto metodu uvádět v draw_methods, jinak 400.

Odpověď

Při úspěchu vrátí API 201 Created s novým termínem.
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é
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.
object
povinné
Profil pacienta spojený s tímto termínem.
AppointmentPanel[]
povinné
Panely aktuálně připojené k tomuto termínu. U nově vytvořených termínů je pole prázdné — připoj je přes Přidat panely. Detaily panelů (název, biomarkery) najdeš přes Vypsat panely.
AppointmentIndividualBiomarker[]
povinné
Samostatné biomarkery připojené k tomuto termínu mimo jakýkoli panel. U nově vytvořených termínů je pole prázdné — připoj je přes Přidat jednotlivé biomarkery. Údaje pro zobrazení najdeš spárováním každého biomarker_id s Vypsat biomarkery.
AppointmentShipmentLink[]
povinné
Zásilky propojené s tímto termínem, od nejstaršího propojení. U nově vytvořených termínů je pole prázdné — propoj je přes Vytvořit zásilku (s appointment_id) nebo Připojit termíny k zásilce.
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.

Minimální předstih

Termíny na odběrových místech provozovaných Anivou je nutné rezervovat alespoň 12 hodin předem; rezervace v kratším předstihu vrátí 400. Získat dostupnost tyto sloty už vynechává, takže vše, co z tohoto rozvrhu načteš, lze rezervovat. Odběrová místa, která provozuješ ve vlastní režii, nemají minimální předstih — rezervace na stejný den i přímo na místě zůstávají beze změny.

Duplicitní termíny

Profil může mít nejvýše jeden nezrušený termín pro dané odběrové místo a okamžik — jednomu člověku nelze odebrat krev dvakrát na stejném místě ve stejnou chvíli, bez ohledu na počet odběrových křesel. Vytvoření termínu pro slot, který už profil obsazuje, vrátí 409 s appointment_id už existujícího termínu:
Zpracuj to tak, že požadavek už byl proveden: načti termín přes Získat termín, přesuň ho přes Upravit termín nebo ho zruš přes Zrušit termín. Vytvoření neopakuj — bude dál vracet 409. Opakované vytváření je díky tomu bezpečné: požadavek, který po vypršení časového limitu odešleš znovu, nebo dvakrát odeslaný formulář nemůže vytvořit dva termíny pro stejného pacienta na stejný čas.
appointment_id se vrací pouze u duplicitní chyby 409. Kapacitní 409 — slot je plný, protože ho obsadili jiní pacienti — vrací pouze error a správným řešením je vybrat jiný slot v Získat dostupnost.

Chybové odpovědi