Vstupenky

Tento dokument detailně popisuje strukturu, pravidla validace a povolené hodnoty pro blok <ticket>. Tento blok definuje komerční stav, distribuční kanál a cenové rozpětí události.

Rozsah použití

Blok lze použít na nejvyšší úrovni události (<event>) i u položek programu (<nested_event>); struktura i pravidla validace jsou v obou případech stejné. Položka programu, která vlastní <ticket> nemá, přebírá vstupenku své události.

1. Přehled prvků bloku `<ticket>`

Prvek	Typ	Povinné	Popis
`status`	Enum	Ano	Aktuální stav prodeje vstupenek. (Viz 2.1)
`sales_channel`	Enum	Ne	Hlavní kanál prodeje. (Viz 2.2)
`price_min`	String	Podmíněně	Nejnižší cena vstupenky. Povinné, pokud `status` není `free` ani `voluntary`; u `voluntary` jde o doporučenou částku. (Viz 3.1)
`price_max`	String	Ne	Nejvyšší cena vstupenky při více cenových hladinách.
`url`	String	Ne	Přímý HTTPS odkaz na prodejní stránku. (Viz 3.2)

2. Povolené hodnoty (Enumy)

2.1 Stav vstupenek (`status`)

Hodnota udává aktuální dostupnost vstupenek:

on_sale - Vstupenky jsou aktuálně v prodeji.
sold_out - Vyprodáno.
not_yet_available - Prodej ještě nebyl zahájen.
free - Vstup zdarma (neplatí se žádné vstupné).
voluntary - Dobrovolné vstupné: návštěvník zaplatí, kolik uzná za vhodné. Pošlete-li price_min, web ji ukáže jako doporučenou částku („Dobrovolné vstupné (doporučeno 100 Kč)“). Akce se objeví i mezi akcemi zdarma.

2.2 Distribuční kanál (`sales_channel`)

Určuje, kde nebo jakým způsobem lze vstupenky zakoupit:

online - Prodej probíhá online přes web.
at_door - Prodej probíhá pouze na místě před akcí.

3. Pravidla validace a podrobnosti

3.1 Pravidla pro ceny (`price_min` a `price_max`)

Povinnost price_min: Pokud je status nastaven na on_sale, sold_out nebo not_yet_available, pole price_min musí být vyplněno.
Pravidlo pro status: free a status: voluntary: pole price_min i price_max se nevyžadují a mohou být zcela vynechána. U voluntary znamená price_min doporučenou částku.

3.2 Pravidla pro URL adresu (`url`)

Protokol: Adresa musí začínat výhradně protokolem https://. Nezabezpečené odkazy (http://) budou validátorem odmítnuty.
Volitelnost: Pole url je vždy volitelné. Pro události se status: free není potřeba odkaz zadávat vůbec, případně lze uvést odkaz na registraci nebo web události.

3.3 Událost bez `<ticket>` a vstupenky programu

Chybějící <ticket> neznamená vstup zdarma. Událost bez tohoto bloku web ukáže bez ceny i bez štítku „Zdarma“ a nezařadí ji mezi akce zdarma. Je-li vstup volný, pošlete <status>free</status>.
Položky programu (<nested_event>) bez vlastního <ticket> přebírají vstupenku své události — cenu i odkaz na předprodej.
Ruční úprava redakce: redakce může vstupenku jednoho termínu programu nastavit ručně (např. jinou cenu premiéry). Takovou vstupenku feed už nepřepíše; čas a místo termínu se dál řídí feedem.
Vlastní vstupenka položky platí, dokud ji posíláte. Přestanete-li ji posílat, zůstane u položky naposledy poslaná — má-li se položka prodávat jako celá akce, pošlete jí stejnou vstupenku jako akci.

4. Příklady XML implementace

A. Standardní placená událost v prodeji

<ticket>
    <status>on_sale</status>
    <sales_channel>online</sales_channel>
    <price_min>450</price_min>
    <price_max>1200</price_max>
    <url>https://example.com/tickets/event-123</url>
</ticket>

B. Událost se vstupem zdarma (Free)

U stavu free není nutné uvádět ceny ani URL.

<ticket>
    <status>free</status>
</ticket>

C. Událost zdarma s nutností online registrace

<ticket>
    <status>free</status>
    <sales_channel>online</sales_channel>
    <url>https://example.com/register/event-123</url>
</ticket>

D. Prodej pouze na místě (At the door)

<ticket>
    <status>on_sale</status>
    <sales_channel>at_door</sales_channel>
    <price_min>200</price_min>
</ticket>

E. Dobrovolné vstupné s doporučenou částkou

U stavu voluntary je price_min nepovinná; když ji pošlete, web ukáže „Dobrovolné vstupné (doporučeno 100 Kč)“.

<ticket>
    <status>voluntary</status>
    <price_min>100</price_min>
</ticket>

Vstupenky

1. Přehled prvků bloku <ticket>