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.

:::info Rozsah použití: Tento blok lze použít jak na nejvyšší úrovni události (<event>), tak i uvnitř vnořených událostí (<nested_events>). Pravidla validace a struktura zůstávají v obou případech identická.

:::

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`. (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é).

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**: Pokud je stav nastaven na free, pole price_min i price_max se nevyžadují a mohou být zcela vynechána.

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.

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>

Vstupenky

1. Přehled prvků bloku <ticket>