4a. Colosseum — step01 (ID) a step25 (spárování)

Modul propojuje akci v DOVIS s prodejem vstupenek z pokladního systému Colosseum. Data prodejů jsou v tabulce sale_document_items (import z API — nastavení _Colosseum_ v administraci). U akce se ukládají sloupce dovakce.id_colosseum (ID prodeje = Title_id) a dovakce.id_colosseum_kam (kam se souhrn zařadí do kalkulace).

Kdy se záložka a pole zobrazí

• V menu akce je položka Colosseum (MenuAkce = 25, URL step25), pokud má nájemce modul zapnutý.
• Při vykreslení menu na kroku 25 nastaví AkceMenu2 proměnnou PouzivamColosseum = 1 — pak se na step01 zobrazí žlutý řádek ID COLOSSEUM (dva sloupce: textové ID + rozbalovací „zařadit v objednávce …“).
• Barva záložky: AkceColosseumTest — červená pokud id_colosseum = 0, zelená po spárování.

Pole na step01 (základní info)

Uložení step01 jen zapíše ID a volbu „kam“ do dovakce. Automatické vložení řádků do objednávky proběhne až na step25 (formulář nebo přehled po spárování). Při úpravě akce na step01 se nejdřív zruší vazba KodAkce u všech sale_document_items dané akce — po změně ID je vhodné znovu projít krok Colosseum.

Co dělá step25 a proč

Stránka step25 (obal step25 → !step25/step25) je hlavní pracovní místo pro obchodníka:

1. Ještě není ID (id_colosseum = 0): formulář — výběr prodeje z SeznamProdejSelect, povinné _Kam zařadit_ (stejné hodnoty 10 / 20 jako na step01), tlačítko Uložit → step25vloz.
2. Po uložení step25vloz: nastaví sale_document_items.KodAkce u vybraného Title_id, uloží id_colosseum a id_colosseum_kam do dovakce, agreguje prodej podle sazeb DPH a volá SluzbaVloz nebo DalsiVloz — vytvoří řádky typu „Vstupenky - \[název akce\] - \[DPH%, počet, /zdarma …\]“.
3. ID už je nastavené: zobrazí SeznamProdejPolozky2 — tabulka položek prodeje, součty DPH, volba „zařadit do služby / další položky“; při zobrazení může znovu přepočítat a přepsat služby/catering u akce (smaže stávající dovakcesluzby a dovakcecatering pro akci, pak znovu vloží souhrny).

Na přehledu akce (AkceInfo2) se při id_colosseum > 0 zobrazí odkaz ID Colosseum → step25.

Diagram — tok dat

flowchart TB
    subgraph sync["Synchronizace mimo akci"]
        API["Colosseum API"] --> SDI["sale\_document\_items"]
    end
    subgraph akce["U akce"]
        S01["step01: id\_colosseum + id\_colosseum\_kam"] --> S25{"step25"}
    S25 -->|id=0| F["Vyber prodeje + Kam zařadit"]
    F --> V["step25vloz"]
    S25 -->|id>0| P["SeznamProdejPolozky2"]
    V --> SDI2["UPDATE sale\_document\_items.KodAkce"]
    V --> DV["dovakce ID + kam"]
    V --> IMP["Agregace DPH + SluzbaVloz / DalsiVloz"]
    P --> IMP
    IMP --> SL["dovakcesluzby nebo dovakcecatering"]
    SL --> O6["step06 objednávka / kalkulace"]
    end

Diagram — menu a stav záložky

flowchart LR
    M["AkceMenu2"] --> T["AkceColosseumTest"]
    T -->|id\_colosseum=0| C["Colosseum červeně"]
    T -->|id\_colosseum>0| G["Colosseum zeleně"]
    G --> S25["step25 přehled prodeje"]
    C --> S25F["step25 formulář spárování"]

Soubory a tabulky

Provoz: Import z Colosseum API má limit cca 1 dotaz / 10 minut — data musí být v DB dříve, než obchodník páruje akci. Bez syncu v nastavení bude seznam prodejů prázdný.