3. Levé menu aplikace DOVIS ISKASA

Po přihlášení vidíte vlevo svislé menu. Slouží k přechodu mezi akcemi, kalendáři, statistikami a dalšími moduly — ještě nejste uvnitř jedné konkrétní akce (ta má vlastní horní menu kroků). Osobní nástroje (profil, poznámky, odhlášení) jsou v horním menu u jména vpravo.

Menu není u všech stejné. Položky, pořadí a popisky nastavuje správce podle organizace (nájemce). U vás v systému může být menu kratší nebo delší než v tomto návodu; chybějící položka znamená, že je pro váš účet vypnutá nebo nemáte oprávnění.

Jak systém rozhodne, co uvidíte

• Oprávnění uživatele — u každé položky menu je určeno, které role ji smí vidět (zkratky např.t, b v tabulkách níže). Položka se zobrazí, pokud vaše role odpovídá.
• Druhá role — někteří uživatelé mají i admin2; stačí shoda s jednou z rolí.
• Partner / catering — některé položky jen při zapnutém modulu partnerů nebo cateringu u uživatele.
• Podmenu — položka bez URL (prázdná adresa) je složka s šipkou ▾; podpoložky mají KodP= kód nadřazené položky.
• Tooltip — při najetí myší na položku uvidíte PopisMenu z databáze.

Přehled rolí (zkratky v menu)

Položka se šipkou ▾ vpravo má podmenu — klikněte na název, rozbalí se další odkazy (až tři úrovně).

Katalog položek levého menu

Přehled hlavních položek levého menu (úroveň 1). Sloupec Role = kdo položku typicky vidí. Podrobný popis je v sekcích níže; u položek ▾ viz také podmenu.

Kalendáře v DOVIS - ISKASA — přehled a ovládání

V levém menu je několik položek s názvem Přehled… nebo Kalendář…. Každá otevírá jiný typ kalendáře — jiná data, jiné filtry. Není to jedna obrazovka s přepínačem; jde o samostatné stránky.

Přehled auta v levém menu nevidíte? Položka s ikonou Přehled auta (odkaz na autacal) je volitelná — ve výchozím nastavení bývá u organizace vypnutá. Administrátor ji zapne v konfiguraci nájemce: config → AutaOK = Ano (stejný přepínač zapíná i položku Auta v menu a záložku Auta u akce). Role, které ji typicky vidí: t (admin), b (obchodník). Po změně konfigurace se uživatelé musí znovu přihlásit nebo obnovit stránku.

Společné ovládání (nová měsíční mřížka)

Kalendáře akcí, prostor, personálu na akcích, zaměstnanců a (po zapnutí modulu) Přehled auta mají stejný vzhled — sedm sloupců dnů, řádky po týdnech, barevné záznamy. Ovládání je na všech podobné:

Kalendář akcí — Přehled akcí

Typická úvodní obrazovka po přihlášení obchodníka.

• Měsíční mřížka — všechny akce ve zvoleném období; barva = stav OPCE / smlouva / fakturace (legenda dole).
• Filtry: středisko, budova, místnost — zúžíte jen akce s rezervací v daném prostoru.
• Klik na akci (čip nebo pruh) → detail akce.
• Klik na číslo týdne → týdenní kalendář akcí (7 sloupců, větší čitelnost).
• Tisk měsíce: ikona tiskárny v záhlaví — A4 na výšku nebo na šířku, zoom, tisk z prohlížeče.
• Admin / obchodník: v hlavičce dne mohou být mini-odkazy (např. rychlé akce); číslo dne může vést na seznam akcí daného dne.

Kalendář prostor — Přehled prostory

Před nabídkou termínu klientovi — kdy je sál volný nebo obsazený.

• Zobrazuje rezervace místností (ne celou akci jako obchodní přehled, ale obsazenost prostor).
• Filtry: středisko, budova, jedna místnost nebo více místností (pokud má firma zapnutý výběr více prostor).
• Tabulka kalendáře prostor — odkaz v záhlaví Tabulka kalendář prostory — stejné období v tabulkovém layoutu.
• Line — lineární přehled obsazenosti.
• Tisk měsíce — ikona tiskárny (zachová zvolené filtry).
• Po výběru volného termínu pokračujte v detailu akce → Prostory (rezervace).

Kalendář personálu na akcích — Přehled osoby

Koordinace produkce, cateringu, techniky — kdo je v daný den na akci.

• Personál z personálního ceníku přiřazený k akcím (ne dovolené — ty jsou v kalendáři zaměstnanců).
• Filtr střediska v horním panelu.
• Line — časová osa obsazenosti personálu.
• Tisk měsíce — ikona tiskárny v záhlaví.
• Doplňuje záložku Personál u konkrétní akce.

Týdenní kalendář akcí a Přehled zasedačka

Detailní plánování jednoho týdne; u zasedačky jedna přednastavená místnost.

• Jak se tam dostanete: z měsíčního kalendáře akcí — klik na číslo týdne; nebo menu Přehled zasedačka (často už s vybranou konkrétní místností).
• Filtry: středisko, budova, místnost — stejně jako u měsíčního kalendáře; u zasedačky je místnost obvykle předvybraná.
• Šipky týdne v horním panelu — předchozí / následující týden.
• Odkaz na měsíc v záhlaví — návrat na měsíční kalendář akcí nebo prostor.
• Zoom — stejné tlačítka − / + / Výchozí jako u měsíční mřížky.
• Tisk týdne — ikona tiskárny; volba A4 — dny pod sebou (vhodné pro dlouhý seznam akcí v jednom dni) nebo A4 — mřížka týdne (sedm sloupců jako na obrazovce).
• U zasedačky vidíte jen jednu místnost po celý týden — rychlá kontrola obsazenosti zasedací místnosti.

Kalendář zaměstnanců

Stejná mřížka jako u akcí, ale data = absence a směny zaměstnanců (dovolená, NV, služební cesta…). Podrobný postup vkládání a schvalování: Kalendář zaměstnanců — celá kapitola.

• Přehled z kalendáře — ikona v záhlaví → roční tabulka absencí; návod Přehled z kalendáře (calendar2-prehled).
• Tisk měsíce — ikona tiskárny (zoom + A4).
• Návod v záhlaví — systémová nápověda přímo v aplikaci.
• Nadřízený může v mřížce přesouvat schválené záznamy tažením myší (čip / vícedenní pruh) — zaměstnanec bez oprávnění nadřízeného jen žádá a čeká na schválení.

Kalendář aut — Přehled auta

Pro: obchodníky a koordinátory s firemními vozy — jen pokud má firma zapnutý modul aut (AutaOK = Ano).

Viditelnost v levém menu: Položka Přehled auta (ikona auta, odkaz autacal) se v postranním menu zobrazí až po povolení modulu administrátorem. Bez AutaOK ji v menu nehledejte — není to chyba účtu. Zapnutí: konfigurace nájemce (config) → pole AutaOK → Ano.

• Měsíční mřížka — všechny rezervace vozů (u akce i bez akce); barva čipu = blízkost odjezdu (ne kolize).
• Klik na číslo dne → nová rezervace bez akce (step51).
• Klik na čip / pruh → úprava (step50 u akce, step51 u vlastní rezervace bez akce, parametr car=).
• Tisk měsíce — ikona tiskárny v záhlaví (autacal-month-print).
• Zoom — stejné tlačítka − / + / Výchozí jako u ostatních kalendářů.

Nově — fotodokumentace a tisk karty řidiče (2026): U existující rezervace na step51 (?car== kód řádku v dovakceauta) lze nahrát fotografie jako důkaz stavu vozidla při předání nebo vrácení, zobrazit je v galerii a vytisknout kartu rezervace pro řidiče nebo kontrolu. Fotky u číselníku vozů (bez rezervace) se spravují na stránce auta při úpravě konkrétního auta.

##### Fotodokumentace u rezervace (step51?car=…)

Formulář Obsazení auta s fotodokumentací se otevře po kliknutí na vlastní čip v kalendáři (car= číslo rezervace). Po novém uložení rezervace systém vrátí do kalendáře — pro nahrání fotek nebo tisk karty znovu otevřete čip (úprava step51?car=).

• Galerii fotek k této rezervaci — miniatury stejné velikosti, kliknutím celá fotka v lightboxu, u každé fotky štítek Předání nebo Vrácení.
• Tlačítka vedle Uložit: Nahrát foto (zobrazí skrytý upload formulář) a Tisk karty (otevře step51tisk v novém okně).
• Upload: až 3 soubory najednou, typ Předání auta nebo Vrácení auta, volitelný název a popis (např. poškození, stav paliva).
• Soubory se ukládají do složky !files/auta{rok} (např.auta2026); záznam v tabulce rentautafoto s vazbou na rezervaci (KodDovAkceAuta) i vůz (KodAuta).
• Smazat fotku může pouze uživatel, který ji nahrál (ikona × u miniatury). Ostatní ji vidí, ale nemohou smazat.

##### Tisk karty řidiče (step51tisk?car=…)

Papírový doklad pro řidiče nebo kontrolu při předání/vrácení vozidla. Karta obsahuje:

• název vozu, SPZ, palivo, stav km,
• řidiče (jméno, telefon, e-mail),
• termín od–do (datum a čas),
• název akce (pokud je rezervace vázaná na akci), kdo rezervaci vložil, poznámku,
• miniatury nahrané fotodokumentace,
• řádky pro podpis při převzetí a podpis při vrácení.

Tisk: tlačítko Tisknout na stránce karty nebo Ctrl+P. Menu a navigace se při tisku skryjí.

##### Fotografie v číselníku aut (auta?action=add&cc=…)

Při úpravě existujícího vozu v levém menu Auta (ne u nového prázdného záznamu):

• tlačítko Nahrát foto vedle Vložit auto zobrazí formulář pro upload,
• dole galerie fotek k vozu (typ katalog — obecné fotky auta, ne vázané na konkrétní jízdu),
• stejná pravidla ukládání, lightboxu a mazání (jen vlastní fotky).

Podrobný návod (formát čipů, kolize, vazba na akci, step50 vs. step51, fotky, tisk): Přehled auta — celý popis a kapitola 7c · Fotodokumentace aut · Tisk karty řidiče.

Rozdíly na první pohled:

• Akce = obchodní události a pronájmy.
• Prostory = které místnosti jsou obsazené (bez ohledu na to, kdo akci vede).
• Osoby (personál) = kdo z personálu je na akci obsazený.
• Zaměstnanci = kdo je v práci / na dovolené / na služební cestě.
• Auta = které firemní vozy jsou rezervované (volitelná položka menu — viz Přehled auta).
• Týden / zasedačka = detail jednoho týdne; u akcí i vybrané místnosti.

Popis jednotlivých položek menu

Nová akce

Pro: obchodníka, administrátora s právy obchodníka.

Otevře formulář Základní info (prázdná akce). Vyplníte název, termín od–do, časy, kontakt, kontaktní osobu, popis. Po uložení má akce číslo a můžete pokračovat na Prostory, Služby atd.

• Stejný výsledek jako tlačítko Přidat novou akci v seznamu akcí.
• Bez uložení základních údajů nelze smysluplně rezervovat prostory.

Přehled akcí

Pro: všechny, kdo plánují termíny — typicky první obrazovka po přihlášení.

Měsíční kalendář akcí. Podrobně: filtry, zoom, tisk, týdenní pohled — viz Kalendář akcí a přehled všech kalendářů.

• Barvy = stav OPCE, zasmluvnění, fakturace (legenda pod mřížkou).
• Klik na akci → detail; klik na číslo týdne → týdenní kalendář.

Seznam akcí

Pro: obchodníka — hlavní pracovní nástroj pro hledání a správu všech akcí.

Nejdůležitější obrazovka pro práci s větším počtem akcí. Nahoře jsou filtry, pod nimi řádky akcí, dole legenda barev a tlačítko pro novou akci.

Co kde na stránce najdete:

Filtry (horní pruh)

• Datum od / do — omezí akce na období.
• Stav OPCE — platná, zrušená, zasmluvněná, vlastní akce…
• Budova — akce s rezervací v dané budově.
• Středisko — filtr podle organizační jednotky.
• Uživatel / osoba — akce vedené konkrétním obchodníkem nebo s daným personálem.
• Hledaný text — název akce, kontakt…
• Tlačítko Hledej — spustí vyhledávání.

Seznam řádků — každý řádek je jedna akce:

• Název akce (odkaz) → otevře detail akce s horním menu kroků (Info, Prostory…).
• Termín od – do, stav OPCE / zasmluvnění (ikony a text).
• Ikony v řádku: kopírování akce, kalkulace, historie, smazání (admin).
• Barva řádku = stav (zelená zasmluvněno, šedá platná OPCE, žlutá končí OPCE, červená prošlá / zrušená, modré odstíny fakturace…).
• Varování „Není vybráno místo/služba“ — akce ještě nemá rezervovaný prostor.

Typický postup: Nastavíte filtr (datum + text) → Hledej → klik na název akce → v horním menu doplníte Prostory, Služby…

Hledáte napříč celou aplikací? Místo jen seznamu akcí použijte globální vyhledávání (hledej) — ikona lupy v horní liště. Najde akce, kontakty, dokumenty, úkoly WebCollab a další moduly najednou.

Seznam eShop

Pro: obchodníky s napojením na e-shop (role t, b).

Tabulkový přehled akcí, které přišly z internetového objednávkového kanálu (eShop). Funguje podobně jako Seznam akcí, ale filtruje / zobrazuje jen e-shopové záznamy. Pokud položku v menu nevidíte, modul eShop u vaší organizace není zapnutý.

Objednávky

Pro: obchodníka, technika, administrátora (t, b, o).

Centrální seznam objednávek napojených na akce a nákup — přehled otevřených a uzavřených objednávek mimo detail jedné akce. V detailu akce je související záložka Objednávka; tato položka menu slouží k práci napříč všemi akcemi. Pro nákupní žádanky zboží a majetku (modul Žádanky v přepínači aplikací) použijte kapitolu 3f. Související evidence plateb dodavatelům je v Přímých nákladech.

Přímé náklady

Pro: obchodníka, technika, nákup / účetní přehled (t, b, o). Položku v menu uvidíte jen při zapnutém modulu objednávek / nákupu (stejně jako Objednávky).

K čemu to slouží: Centrální přehled přímých nákladů — tedy částek, které organizace platí dodavatelům (subdodavatelé, catering, technika, prostory atd.) v souvislosti s akcemi. Data se do evidence doplní z kalkulace akce (prostory, služby, mobiliář, technika, catering, personál…); na této stránce je kontrolujete a označujete jako zaplacené, ne primárně upravujete ceny v akci.

##### Odkud se náklady berou

Při práci v akci (záložky s položkami a Bilance) systém eviduje u každé relevantní položky nákupní cenu (co platíte dodavateli) a prodejní cenu (co účtujete zákazníkovi). Tyto řádky se agregují podle dodavatele (kontaktu) a akce. Pokud u položky chybí dodavatel, řádek se zvýrazní — je potřeba doplnit kontakt v akci.

flowchart LR
    A["Položky v akci"] --> E["Evidence u dodavatele"]
    E --> P["Přímé náklady v menu"]
    P --> Z["Označení Zaplaceno"]
    P --> K["KPI Náklady a marže"]

##### Filtry nahoře

Typ soupisu (rozbalovací seznam):

• vše — pod sebou akce v období a u každé platné akce řádky dodavatelů;
• rozpis podle akcí — nejdřív přehled akcí (název, odběratel, obchodník), pod nimi náklady;
• seskupovat dodavatele — součty podle dodavatele, typicky jen nezaplacené položky;
• všechny náklady — včetně záznamů bez přiřazeného dodavatele (pro kontrolu chybějících kontaktů).

Pokud vstoupíte z konkrétní akce, zobrazí se jen náklady té akce; v liště je vidět název akce a odkaz zpět na detail.

##### Sloupce v tabulce nákladů

Na konci tabulky je souhrn Celkem doplatit (náklady minus již označené platby) a celkový Prodej.

##### Barvy a stavy řádků

• Tlačítko Hledej (změna období nebo typu soupisu často formulář odešle sama).
• Zelený podklad — dodavatel je vyplněn v kontaktu.
• Červený podklad — chybí dodavatel; doplněte v akci u položky.
• Růžový / zvýrazněný řádek — náklad už byl označen jako zaplacený.
• U zrušené opce nebo neaktivní akce jsou částky přeškrtnuté a do součtů se nepočítají.
• V režimu rozpis podle akcí má řádek akce barvu podle opce / zasmluvnění / fakturace (platná opce, končící opce, zasmluvněno, stav faktury…) — stejná logika jako u seznamu akcí.

##### Typický postup

1. Zvolte období (např. aktuální měsíc).
2. Nechte vše nebo zvolte seskupovat dodavatele, pokud chcete jen neuhrazené faktury.
3. Projděte řádky s červeným podkladem — doplňte dodavatele v příslušné akci.
4. Po úhradě faktury zadejte datum a klikněte Zaplaceno.
5. Pro ekonomický souhrn marží použijte v menu KPI → Náklady a marže; pro detail jedné akce záložku Bilance.

Rozdíl oproti Bilanci v akci: Bilance ukazuje strukturu cen u jedné akce. Přímé náklady v levém menu jsou napříč všemi akcemi — hlavně pro účetní / nákupní kontrolu plateb dodavatelům.

Export kalendář akcí

Pro: obchodníky, kteří potřebují přehled mimo DOVIS - ISKASA (kalendář v Outlooku, sdílení).

Připraví export akcí za zvolené období (často celý rok). Slouží k předání harmonogramu akcí nebo importu do jiného kalendáře — podle nastavení vaší organizace.

Časová osa akcí

Pro: plánování delších období, kontrola překryvů více akcí najednou.

Grafické zobrazení akcí na časové ose (ne tabulka). Uvidíte, jak akce navazují a zda se termíny nepřekrývají. Doplňuje měsíční kalendář i seznam.

Přehledy uživatele

Pro: uživatele se zapnutým potvrzováním položek (zodpovědná osoba u položek akce).

Souhrn toho, co u vás čeká na kontrolu nebo potvrzení — např. počty akcí, prostor, služeb, mobiliáře, techniky, cateringu, personálu u akcí, kde jste uvedeni jako zodpovědná osoba. Po otevření konkrétní akce můžete položky schválit. Otevírá obrazovku login— podrobně v kapitole 3i. Zodpovědná osoba. Pokud modul nemáte zapnutý, položka v menu se nemusí zobrazit.

KPI ▾ (podmenu)

Pro: vedení, obchodní řízení, administrátory s rolí t nebo b — ne pro běžné zadávání jedné akce.

K čemu to slouží: Modul KPI agreguje ekonomické a provozní údaje ze všech akcí — tržby, náklady, marže, vytížení prostor, personálu, energie, fakturace a obchodní pipeline. Data neupravujete přímo v KPI; čerpají se z položek akcí (prostory, služby, mobiliář, technika, personál, catering, energie…) a z bilancí. Pro rychlý denní přehled slouží Nástěnka manažera (nastenka); podmenu KPI otevírá specializované grafy a tabulky (graf01, graf02…).

Nadřazená položka KPI (PopisMenu: KPI statistiky, měsíční, roční, kvartální) nemá vlastní stránku — po kliknutí se rozbalí podmenu. Jednotlivé obrazovky jsou jen pro čtení (grafy, tabulky, součty); změna čísel probíhá v detailu akce nebo v příslušných modulech (Energie, Přímé náklady, PREMIER…).

##### Nástěnka manažera — nastenka

Stránka Nástěnka manažera je centrální dashboard pro role t a b. Otevřete ji přímo adresou nastenka (není vždy samostatná položka levého menu — závisí na nastavení nájemce). Na jedné obrazovce uvidíte Globální souhrn financí, AKCE KPI karty, trychtýř obchodních příležitostí, cashflow záloh, nákupy, fakturaci, vývoj prodeje, rozpad kategorií, PREMIER, Colosseum, mapu akcí a další widgety. Filtry nahoře se sdílejí se stránkami graf01— odkaz Detail KPI → v jednotlivých boxech přenese stejné parametry.

Výchozí načtení stránky je dvoustupňové: nejdřív se zobrazí filtry, lišta nástěnky a kostra boxů (spinnery), těžká data se dotáhnou na pozadí přes nastenka?ajax_boxes=1. Pokud AJAX selže, systém nabídne přechod na plné synchronní načtení (?defer=0). Pro ladění nebo starší prohlížeče lze synchronní režim zvolit přímo v adrese.

Finanční částky ve widgetech nástěnky (KPI karty, PREMIER, zálohy, energie, nákupy, Colosseum v souhrnu) jsou sjednocené na hodnoty bez DPH. U faktur z PREMIER se používá součet položek CENA (ne hlavičkové CELKEM s DPH); u plateb (uhrazeno, zbývá) se částka škáluje z hlavičky faktury podle poměru bez DPH / s DPH. Trychtýř a fakturace akcí pracují s hodnotami z bilance akce, ne z PREMIER.

flowchart TB
    subgraph vstup["Zdroj dat"]
        A["Akce a položky v akci"]
        B["Bilance cen"]
        C["PREMIER faktury"]
        D["Colosseum prodeje"]
        E["Evidence energie"]
    end
    subgraph vypocet["Výpočet"]
        F["graf01 / fast refresh"]
        G["grafstats01 cache"]
        H["nastenka_data SQL"]
    end
    subgraph vystup["Co vidíte"]
        N["Nástěnka manažera"]
        SF["Globální souhrn financí"]
        K1["graf01 KPI"]
        K2["graf02 meziroční"]
        K3["graf03 marže"]
    end
    A --> F
    B --> F
    F --> G
    A --> H
    B --> H
    G --> N
    H --> N
    G --> SF
    H --> SF
    C --> SF
    D --> SF
    G --> K1
    C --> N
    D --> N
    E --> N
    SF --> N

###### Filtry nástěnky (horní lišta)

Formulář GET na stránce předává stejné parametry do všech widgetů. Změna filtru obnoví celou stránku; u KPI cache se může spustit automatický přepočet.

###### Přepočet KPI a cache

Tržby, náklady a rozpad kategorií v boxu AKCE KPI karty a v Rozpad KPI vycházejí z tabulky grafstats01_{KodU} (osobní cache) nebo grafstats01 (globální) — ceny položek akcí jsou bez DPH. Při prvním načtení může systém rychle zkopírovat odhad z globální cache; pro přesná čísla podle filtrů výše použijte tlačítko Přepočítat KPI na liště nástěnky nebo otevřete graf01 se stejnými filtry. Box Globální souhrn financí agreguje již spočítané částky z widgetů (KPI cache, PREMIER položky CENA, Colosseum bez DPH za ODxx–DOxx, zálohy, nákupy…). Trychtýř, fakturace, výsledková tabule obchodníků a mapa počítají živě z SQL (dovakce, dovakcedatum) a jsou rychlejší, ale nejsou součástí měsíční KPI cache.

flowchart LR
    F["Filtry nástěnky"] --> R{"Cache aktuální?"}
    R -->|Ano| C["AKCE KPI karty + rozpad"]
    R -->|Ne| B["Přepočítat KPI"]
    B --> G["graf01 algoritmus"]
    G --> T["grafstats01"]
    T --> C
    F --> L["Trychtýř / fakturace / mapa"]
    L --> S["Živé SQL bez cache"]

##### Widgety nástěnky — co jednotlivé boxy obsahují

Widgety se vykreslují z !nastenka/nastenka_boxes; data agreguje nastenka_data. Pořadí a šířku boxů lze měnit tlačítkem Uspořádání nástěnky (přetahování, skrytí, uložení rozložení pro účet). Výchozí pořadí začíná boxem souhrn (nad AKCE KPI kartami); uložené rozložení pro váš účet má přednost. U každého boxu je tlačítko ? s podrobnou nápovědou.

Globální souhrn financí (box souhrn): Slouží jako rychlý přehled napříč zdroji (akční KPI cache, PREMIER položky, Colosseum bez DPH, zálohy, nákupy). Všechny řádky jsou bez DPH a vztahují se k období z filtru nástěnky (ODxx–DOxx). Colosseum je v souhrnu vždy jeden řádek (součet bez_dph_celkem); platby celkem jsou jen v popisku — liší se od detailního boxu Colosseum, kde měsíční pohled ukazuje celý rok. Není to účetní výsledek firmy — řádky se sčítají transparentně a některé částky se mohou překrývat (KPI náklady vs. přijaté FA vs. objednávky). Pod tabulkami je 3D koláč; legenda je mimo plochu grafu. Výchozí umístění je nad AKCE KPI kartami; po přetažení zůstane uložené v rozložení nástěnky. Uživatelé se starým uloženým rozložením box souhrn uvidí až po resetu uspořádání nebo ručním přidání.

##### Podpoložky KPI v levém menu

Každá položka podmenu otevírá samostatnou stránku s grafy Google Charts nebo tabulkami. Většina sdílí filtry období, stavu OPCE, budovy, obchodníka a střediska jako nástěnka a graf01.

###### Kategorie v KPI (společné pro graf01, nástěnku i marže)

Agregace vychází z řádků akce v těchto tabulkách (ceny po slevě, nákup z řádku, období dle TerminOd v rozsahu filtru):

• Prostory —dovakcemista
• Služby —dovakcesluzby
• Mobiliář (inventář) —dovakceinventar
• Technika —dovakcetechnika, technické nabídky
• Personál —dovakcepersonal
• Catering —dovakcecatering (pokud modul zapnutý)
• Další položky — doplňkové řádky akce
• Energie —dovakcespotreba/ evidence energie

Marže = tržby − náklady (Kč); marže % = saldo ÷ tržby. Hodnota pipeline a trychtýře = poslední prodejní cena z dovakcebilancehistoriecen.

###### Typický postup pro vedení

1. Ráno otevřete Nástěnku manažera — nejdřív Globální souhrn financí, pak AKCE KPI karty, trychtýř a fakturaci.
2. Nastavte filtry (období, středisko, obchodník); pokud karty ukazují varování cache, klikněte Přepočítat KPI.
3. Pro detail kategorie nebo měsíční graf použijte box Rozpad KPI nebo KPI → graf01.
4. Pro srovnání s loňskem: KPI meziroční (graf02).
5. Pro kontrolu plateb dodavatelům a marže po akcích: Přímé náklady + Náklady a marže.
6. Pro výkon týmu: box Výsledková tabule na nástěnce nebo KPI uživatele.

Praktický tip: Nástěnka a graf01 používají stejný algoritmus přepočtu. Po změně filtru opcestav / budovy / střediska spusťte přepočet, jinak mohou AKCE KPI karty zobrazovat odhad z dřívější cache. Trychtýř a mapa filtr opcestav neberou — proto se počty „platných opcí“ v trychtýři mohou lišit od KPI karet. Částky PREMIER na nástěnce jsou nižší než hlavičky faktur v účetnictví (bez DPH z položek CENA). Box Globální souhrn financí se načítá až po AJAX dotáhnutí boxů — pokud je Colosseum prázdné, chybí v souhrnu i jeho řádky (doplňte cache nebo tlačítko Dnešek v boxu Colosseum). Čísla Colosseum v souhrnu odpovídají filtru období, ne měsíčnímu pohledu celého roku.

Poznámka: U jiného nájemce může být podmenu KPI kratší nebo jinak pojmenované. Akce se do KPI řadí podle období KPI (systém je může dopočítat při uložení). Pro práci s klientem používejte Seznam akcí nebo Přehled akcí — ne KPI grafy.

Přehled prostory

Pro: obchodníka před nabídkou termínu klientovi.

Kalendář obsazenosti místností — tisk, tabulka, Line, filtry budova/místnost: Kalendář prostor. Rezervaci doplníte v akci → Prostory.

Přehled osoby

Pro: koordinaci personálu (produkce, catering, technika na akcích).

Kalendář personálu na akcích — ne zaměstnanecké dovolené: Kalendář personálu na akcích. Doplňuje záložku Personál u akce.

Přehled auta (autacal)

Pro: obchodníky, koordinátory a každého, kdo plánuje jízdy firemními vozy (t, b… dle nastavení menu).

Levé menu — volitelná položka: Odkaz Přehled auta s ikonou v postranním menu u vás nemusí být vidět. Modul aut je u mnoha organizací vypnutý (AutaOK = Ne v konfiguraci). Administrátor ho povolí v config → AutaOK → Ano; současně se objeví položka Auta (číselník vozů) a záložka Auta u akce. Bez zapnutí modulu kalendář autacal není z menu dostupný.

K čemu to slouží: Měsíční kalendář obsazenosti všech firemních aut na jedné obrazovce. Data vycházejí ze stejné tabulky rezervací jako záložka Auta u akce (step50) a samostatné rezervace bez akce (step51). Kalendář slouží k rychlé kontrole kolizí před rezervací i k plánování služebních cest mimo konkrétní akci.

Levé menu Přehled auta otevře stránku autacal — mřížku podobnou kalendáři akcí nebo prostor: pondělí–neděle, číslo ISO týdne vlevo, víkendy odlišně, dnešní den zvýrazněný. V záhlaví je odkaz na Seznam aut (auta) a ikona tiskárny pro tisk měsíce.

##### Ovládání kalendáře

##### Co vidíte v buňce dne

• Jednodenní rezervace — barevný čip v těle buňky.
• Vícedenní jízda (termín od–do přes více kalendářních dnů) — pruh přes celý týden pod mřížkou dnů (stejná logika jako u akcí v kalendáři).
• Text čipu — logo značky vozu (pokud je u auta v číselníku rozpoznaná značka) + čas od – čas do + SPZ. Název auta není v textu čipu, ale je v tooltipu spolu s akcí, řidičem a poznámkou.
• Tooltip (najetí myší) — u rezervace vázané na akci: název akce, přesný odjezd/příjezd, poznámka, řidič, kdo záznam vložil. U rezervace bez akce chybí řádek s názvem akce.

##### Barvy čipů — blízkost termínu odjezdu

Barva neříká „kolize“ — jen jak brzy začíná jízda. Kolizi stejného auta ve stejném čase hlídá formulář při ukládání (viz kontrola kolizí).

##### Kam vede klik z kalendáře

##### Diagram — kalendář a dva způsoby rezervace

flowchart TB
    CAL["autacal Přehled auta"]
    CAL --> DEN["Klik na číslo dne"]
    CAL --> CHIP["Klik na čip / pruh"]
    DEN --> S51["step51 nová rezervace bez akce"]
    CHIP --> TYP{"Rezervace má akci?"}
    TYP -->|ano| S50["step50 úprava u akce"]
    TYP -->|ne vlastní| S51E["step51 úprava car="]
    TYP -->|ne cizí| RO["bez odkazu jen náhled tooltip"]
    S50 --> DB["(dovakceauta)"]
    S51 --> DB
    S51E --> DB
    DB --> CAL

##### Vazba na akce a objednávku

• Rezervace z step50 má v databázi KodAkce > 0— zobrazí se v kalendáři s názvem akce v tooltipu, jde do Objednávky akce (step06) a do KPI akce.
• Rezervace z step51 (kalendář → číslo dne) má KodAkce = 0— v kalendáři je vidět, ale nepropisuje se do objednávky žádné akce. Slouží pro služební cesty, blokaci auta nebo vnitřní plánování.
• Chcete auto fakturovat zákazníkovi — vždy použijte Auta u akce (step50), ne samostatný step51.

Tip před rezervací: Otevřete Přehled auta na příslušný měsíc, zkontrolujte pruhy a čipy, teprve pak doplňte auto u akce. Při vyplňování formuláře step50/step51 systém live kontroluje kolize — nemusíte čekat až na uložení.

##### Fotodokumentace u rezervace (step51)

Po otevření existující rezervace (step51?car=kód řádku) — typicky klik na vlastní čip v kalendáři:

Fotky se ukládají do !files/auta{aktuální rok} a evidují v databázi v tabulce rentautafoto s vazbou KodDovAkceAuta (rezervace) a KodAuta (vůz z číselníku).

##### Tisk karty řidiče

Stránka step51tisk slouží jako papírový doklad pro kontrolu při předání nebo vrácení vozidla. Vhodné pro služební cesty, předání vozu kolegovi nebo archivaci stavu auta. Karta obsahuje údaje z rezervace, řidiče, termín, poznámku, náhledy fotek a podpisové řádky. Tisk z prohlížeče (Ctrl+P) — bez menu aplikace.

Podrobný postup vkládání, editace, kolizí, fotodokumentace a číselníku vozů: kapitola 7c. Modul se zobrazí jen při zapnutém AutaOK v nastavení firmy — bez něj v menu chybí položky Auta i Přehled auta.

Přehled zasedačka

Pro: obchodníka, recepci, koordinátory zasedacích místností (t, b, k, o, p, u…).

Otevře přímo týdenní kalendář (často už s vybranou zasedací místností). Zoom, tisk týdne: Týdenní kalendář a zasedačka. Doplňuje měsíční Přehled prostory.

Energie — evidence energie / voda / teplo / chlad / plyn

Pro: správce budov (r) a technickou správu (t). Obchodník energii v levém menu obvykle neřeší; u konkrétní akce může spotřebu přiřadit přes záložku Energie v detailu akce (viz níže).

V demu: účet spravce na demo.iskasa.eu— měřidla, import, KPI energie.

K čemu to slouží: Centrální modul pro evidenci spotřeby podle areálů, budov a měřidel (elektřina kWh, voda m³, teplo/chlad GJ, plyn m³). Záznamy mohou být celofiremní (měsíční odečty budov) nebo vázané na konkrétní akci. Součty jdou do KPI energie a do kalkulace akce, pokud spotřebu k události přiřadíte.

Pořadí práce: Nejdřív založte měřidla (levé menu Umístění měření), pak evidence / import v Energii.

##### Umístění měření — číselník rozváděčů (levé menu)

Pro: správce budov (r) — vlastní položka v levém menu. Administrátor (t) stejnou obrazovku často otevírá přes Prostory (širší správa budov a místností); pro energie je důležitá stejná data o měřidlech.

Položka Umístění měření otevře správu areálů a budov s důrazem na rozváděče a vodoměry. V horní liště postupujte:

1. Areály — přehled areálů (u role r typicky jen pro navigaci).
2. Budovy — seznam budov v areálu; vyberte budovu, ke které měřidlo patří.
3. Umístění rozváděčů a vody — seznam všech měřidel (EAN, název umístění, budova, koeficient, číslo měřidla).

###### Nový nebo upravený záznam měřidla

1. Na stránce Umístění rozváděčů a vody použijte v liště odkaz Přidat (případně po výběru budovy).
2. Vyplňte formulář a uložte tlačítkem Vložit měření:

V seznamu měřidel lze řádek upravit (ikona tužky) nebo smazat, pokud není vázaný na jiná data. Vyhledávání: pole Hledaný text nad seznamem.

Propojení s modulem Energie: Měřidla zde jsou položky ve výběru při Novém měření a cílem importu z PREMIER. Pokud v Energii uvidíte „Chybí energie“, nejdřív doplňte měřidlo v Umístění měření včetně EAN a koeficientu.

##### Horní lišta modulu Energie (čtyři režimy)

##### Evidence — hlavní obrazovka

Pod sebou uvidíte čtyři sekce:

• Odečty elektřiny (kWh),
• Odečty vody (m³),
• Odečty chlad + teplo (GJ),
• Odečty plynu (m³).

##### Význam sloupců v tabulce odečtů

##### Nové měření (ruční zápis)

Postup: areál → budova → prostor (volitelně) → datum od / do → výběr měřidla ze seznamu rozváděčů založených v Umístění měření. Pokud seznam nejde vybrat, chybí měřidlo nebo má koeficient 0 — doplňte ho v levém menu Umístění měření.

Vyplníte jednotkovou cenu, spotřebu za období, služby spojené s dodávkou a popis; pole Cena se dopočítá (spotřeba × sazba + služby). Uložením vznikne řádek v evidenci budovy.

##### Propojení s PREMIER — jak data tečou do DOVIS - ISKASA

flowchart LR
    M["Umístění měření EAN"] --> P["Účetní: PREMIER"]
    P --> S["Synchronizace faktur"]
    S --> I["Import měření"]
    I --> E["Evidence energie"]
    E --> K["KPI energie"]
    E --> A["Energie u akce"]

Systém zobrazí tabulku faktur z PREMIER, které:

• jsou spárované s měřidlem — identifikátor objednávky na faktuře = id rozváděče u měřidla v DOVIS - ISKASA, nebo
• mají na faktuře kód dodacího listu ve tvaru mmTYP#spotřeba (měsíc + typ energie + množství).

##### Typy energie v importu (kód v dodacím listu PREMIER)

Příklad formátu dodacího listu: 02= únor, 5022= teplo, #400= spotřeba 400 GJ → řádek „únor“, teplo, 400 GJ.

V importu uvidíte sloupce: měsíc a druh, EAN/objednávka, rozváděč, spotřeba, dodavatel, datum vystavení, částka. Po najetí na řádek faktury se zobrazí náhled položek faktury z PREMIER.

Bez párování import nezapíše měření: U každého měřidla v DOVIS - ISKASA musí být vyplněné id rozváděče shodné s objednávkou na faktuře PREMIER, nebo faktura musí mít správný kód 5021–5024 v dodacím listu. Jinak řádek v soupisu uvidíte, ale do evidence se nepropíše.

##### Rozdíl: Energie v levém menu × Energie u akce

Typický postup: měsíční faktury z PREMIER → Import do evidence budovy → u probíhající akce na záložce Energie doplníte odečty pro vyúčtování zákazníkovi / kalkulaci.

PREMIER v menu Aplikace: Modul Premier slouží k stažení faktur do DOVIS - ISKASA. Samotné měření a kontrolu dělá správce v Energii → Import / Evidence. Nástěnka a KPI energie čerpají stejná data.

Kontakty

Pro: obchodníka, technika, správce objektů a lektora v Denio (t, b, o, r, u). V hlavním modulu Akce jde o adresář firem a dodavatelů; v aplikaci Denio (denio/kontakty) jde pro lektora především o databázi škol, na které stavíte výuku a akce.

K čemu to slouží: Centrální adresář subjektů a kontaktních osob. Jedna organizace se eviduje jednou; v akci, objednávce nebo přímém nákladu na ni odkazujete polem Kontakt. V Denio jsou v seznamu pouze školy (záznamy s REDIZO z registru škol); v obchodním modulu naopak běžné firmy bez REDIZO. Integrace RAYNET platí hlavně pro obchod — v Denio se školy spravují přes ARES a registr škol RŠ. U zahraničních odběratelů a dodavatelů panel Veřejný přehled firmy umí doplnit údaje z databáze VIES (EU) podle správně zadaného DIČ — viz VIES a zahraniční firmy.

##### Denio — databáze škol pro lektory

Lektor (u) otevře v levém menu Denio položku Kontakty. Stránka denio/kontakty používá stejné obrazovky jako hlavní modul, ale automaticky filtruje jen školy a školská zařízení — v databázi musí mít vyplněné REDIZO (identifikátor ředitelství z registru škol MŠMT).

Pro lektora — typické využití:

1. V Evidence zkontrolujte součty; případné chyby párování opravte id rozváděče u měřidla nebo údaje na faktuře v PREMIER a import opakujte.
2. Najít školu podle názvu, města, IČO nebo REDIZO (hledání nahoře).
3. Otevřít detail — adresa, e-mail školy, kontaktní osoby (ředitel).
4. Obnovit z RŠ — tlačítko v panelu ARES doplní nebo aktualizuje údaje školy a ředitele z veřejného registru.
5. Při nové akci ve Denio vybrat tuto školu v poli Kontakt — předvyplní se údaje o zákazníkovi.

Počáteční naplnění databáze: Správce může hromadně naimportovat školy z exportu registru škol (XML). Lektor pak pracuje s hotovým seznamem a jednotlivé záznamy doplňuje nebo obnovuje z ARES/RŠ.

flowchart TB
    subgraph Denio["Denio  -  lektor u"]
        MK["Menu Kontakty"] --> DS["denio/kontakty"]
    DS --> FIL["Filtr pouze skoly s REDIZO"]
    FIL --> HLED["Hledání: název, IČO, REDIZO, okres"]
    HLED --> DET["Detail školy"]
    DET --> OS["Kontaktní osoby ředitel"]
    DET --> PAN["Panel ARES plus RŠ"]
    PAN --> OBNOV["Obnovit  -  sync do DB"]
    OBNOV --> DBK["dovkontakty"]
    OBNOV --> DBO["dovosobakontakty"]
    DET --> AKD["Nová akce Denio  -  pole Kontakt"]
    end
    subgraph Obchod["Hlavní modul  -  t, b, o"]
        MK2["Menu Kontakty"] --> FIR["Firmy bez REDIZO"]
    FIR --> RAY["RAYNET volitelně"]
    end

sequenceDiagram participant L as Lektor participant K as denio/kontakty participant A as ARES a RŠ API participant DB as Databáze DOVIS L->>K: Otevře detail školy dd=... K->>A: Načte veřejný přehled podle IČO A-->>K: ARES plus registr škol RŠ K-->>L: Panel REDIZO, IZO, ředitel Note over K,DB: Chybí osoby — doplní chybějící z RŠ L->>K: Klik Obnovit K->>A: Čerstvá data RŠ K->>DB: Aktualizace školy a nahrazení kontaktních osob L->>K: F5 — nový ředitel v seznamu osob

flowchart LR
    M["Levé menu Kontakty"] --> S["Seznam subjektů"]
    S --> H["Hledání a status plateb"]
    S --> D["Detail subjektu"]
    D --> O["Kontaktní osoby"]
    D --> ARES_INS["ARES, RŠ nebo VIES panel"]
    D --> HA["Historie akcí"]
    S --> P["Přidat subjekt"]
    P --> ARES_BTN["Hledat v ARES"]
    P --> RN["Import RAYNET"]
    AK["Akce - Základní info"] --> SEL["Výběr Kontakt"]
    SEL --> PF["Předvyplnění údajů"]
    S --> DUP["Duplicity  -  admin t"]

##### Seznam kontaktů

Po otevření položky Kontakty v levém menu uvidíte tabulku subjektů. V Denio jsou to jen školy (ředitelství s REDIZO); v hlavním modulu Akce jde o běžné firmy a dodavatele.

Denio — co v seznamu neuvidíte: Běžné firmy bez REDIZO (dodavatelé, agentury) se v denio/kontakty nezobrazují — filtr RedIzo > 0 je nastaven automaticky podle aplikace Denio (570). Lektor tedy pracuje čistě s katalogem škol.

###### Barvy statusu (platební morálka)

• Bílý / bez barvy — Nový (ještě nehodnoceno).
• Zelený — Bez problémů (spolehlivý odběratel / dodavatel).
• Červený — Problémový (pozor při smlouvě nebo fakturaci).
• Šedý / černý — Zákaz (nepoužívat pro nové akce).

Stejné barvy se zobrazují i ve výběru kontaktu při zakládání akce — hned vidíte rizikového klienta.

Duplicity a sloučení (administrátor): Systém hlídá duplicity podle IČO, DIČ, názvu nebo názvu + města. Žlutý panel nahoře upozorní a odkáže na Soupis duplicit. U každého kontaktu lze spustit Sloučit — vyberete cílový záznam; akce, kontaktní osoby a objednávky se přesunou. Volitelně se starý záznam smaže. Lze také aktualizovat údaje z ARES při slučování.

##### Detail subjektu a kontaktní osoby

Klik na název školy nebo firmy otevře Informace o kontaktu (kontakty?action=view&dd=…, v Denio denio/kontakty?action=view&dd=…):

• Údaje subjektu — název, IČO (odkaz na ARES), DIČ, adresa sídla, zastoupení, e-mail školy, popis.
• Ověřit plátce DPH — u vyplněného DIČ (u škol méně časté).
• Spolehlivost kontaktu — kontrola plátce DPH.
• Mapa — zobrazení adresy (pokud je modul zapnutý).
• Kontaktní osoby — ředitel, referentka apod. (jméno, telefon, e-mail); ruční úprava nebo doplnění tlačítkem Přidat kontaktní osobu. Po synchronizaci z RŠ mají osoby v popisu značku RŠ: Ředitel atd.
• Veřejný přehled firmy — panel ARES + registr škol u českých škol; u zahraničních firem data z VIES (EU) podle DIČ (viz ARES/RŠ a VIES).
• Odkaz Zpět na akci, pokud jste na detail přišli z rozpracované akce Denio.

Klik na IČO v seznamu otevře Historii akcí dané školy — přehled výuky a souvisejících dokladů.

Tip pro lektora: Po kliknutí Obnovit v panelu ARES se aktualizují údaje školy v databázi a kontaktní osoby se nahradí údaji z registru škol. Seznam osob nahoře na stránce se projeví až po obnovení stránky (F5).

##### Veřejný přehled firmy — ARES a registr škol RŠ

Na detailu kontaktu se pod hlavními údaji zobrazí žlutý panel Veřejný přehled firmy. U českých škol a firem se data stahují na pozadí z ARES a u škol navíc z registru škol RŠ. U zahraničních subjektů bez platného českého IČO slouží jako zdroj databáze VIES (EU) podle DIČ — popis v kapitole VIES. Stránka se nejdřív vykreslí normálně, pak se doplní panel (spinner).

K čemu to slouží: Rychlá orientace před jednáním se školou — právní forma, sídlo, stav v rejstřících, REDIZO, seznam IZO (MŠ, jídelna…), jméno ředitele a zřizovatele. U škol panel umí navíc zapsat údaje do DOVIS (adresa, REDIZO, kontaktní osoby) — viz tlačítko Obnovit.

Podmínka (české školy a firmy): Platné IČO. Bez IČO ARES neobsahuje údaje — u zahraniční firmy použijte správné DIČ země (ES, DE, FR…) a postup v sekci VIES.

###### Synchronizace do databáze (školy v Denio)

flowchart TD
    O["Otevření detailu školy"] --> P["Panel ARES načte data"]
    P --> Q{"Má škola REDIZO?"}
    Q -->|ne| W["Zápis REDIZO a adresy z RŠ"]
    Q -->|ano| R{"Klik Obnovit?"}
    R -->|ne| M["Doplnění chybějících osob z RŠ"]
    R -->|ano| F["Přepsání školy a nahrazení všech osob"]
    W --> OK["Synchronizace DOVIS"]
    M --> OK
    F --> OK

###### Štítky registrů (řádek Registry ARES)

Šedé štítky = registr u subjektu není aktivní. Kliknutelné jen aktivní (barevné).

###### Ovládání panelu

• Text Načítám veřejné údaje o firmě z ARES… při prvním načtení.
• Obnovit — stáhne čerstvá data z ARES/RŠ a u škol zapíše do databáze (včetně kontaktních osob).
• Upozornění pod panelem: údaje jsou orientační; smluvní realita může být jiná.

Při chybě načítání: Žlutá diagnostika s tlačítkem Kopírovat diagnostiku — předejte správci. V Denio častá příčina bývala špatná cesta k API (opraveno na absolutní URL /fiapi). Dále: chybějící IČO, výpadek ARES, nepřihlášený uživatel (role u musí mít přístup). U zahraničních firem zkontrolujte správnost DIČ (prefix země) — české CZ… u firmy s názvem typu … SL, GmbH, Ltd je často překlep; viz VIES.

##### Zahraniční firmy — VIES (EU) a ověření podle DIČ

Pokud kontakt nemá platné české IČO, ale má vyplněné zahraniční DIČ (prefix jiný než CZ— např.DE, ES, FR, IT, PL), panel Veřejný přehled firmy načte údaje z databáze VIES (systém EU pro ověření plátců DPH). Data se stahují automaticky při otevření detailu; tlačítkem Obnovit vynutíte čerstvý dotaz a zápis do kontaktu.

K čemu to slouží (obchod): Rychlé ověření zahraničního odběratele nebo dodavatele před fakturací — název, sídlo, zda je DIČ platné v registru EU, datum ověření. Při prvním načtení nebo po Obnovit může systém doplnit do kontaktu prázdné pole název a adresa sídla (ulice, obec, PSČ).

###### Podmínky a formát DIČ

• DIČ musí mít prefix země (2 písmena) + číslo bez mezer, např.ESB12345678, DE123456789.
• Bez platného českého IČO se ARES nevolá — pro zahraniční subjekt je zdrojem VIES.
• Při Obnovit se prázdná pole v kontaktu doplní; při vynuceném obnovení se mohou přepsat i vyplněná (stejně jako u ARES u škol).
• Velká Británie (GB): Po Brexitu VIES pro GB… obvykle nevrátí data. Pro plné údaje je potřeba napojení HMRC (nastavuje administrátor serveru). Bez něj panel zobrazí upozornění a odkaz na gov.uk/check-vat-number.

Častá chyba v datech: U firmy se zahraničním názvem (např. BRAVO EVENTOS SL, Example GmbH, 10bit FX Limited) je v kontaktu uložené české DIČ CZ… bez IČO. Panel zobrazí červené varování o nesouladu — pravděpodobně jde o překlep nebo DIČ jiné české firmy. Opravte DIČ na správný prefix země (např.ES… pro Španělsko). Systém nehledá firmu podle názvu ani adresy — jen podle správného IČO (ARES) nebo DIČ (VIES).

flowchart TD
    D["Detail kontaktu"] --> P["Panel Veřejný přehled"]
    P --> I{"Platné české IČO?"}
    I -->|ano| A["ARES + u škol RŠ"]
    I -->|ne| V{"DIČ mimo CZ?"}
    V -->|ano| W["VIES EU podle DIČ"]
    V -->|ne CZ DIČ + zahraniční název| E["Varování nesoulad DIČ"]
    V -->|ne| X["Chybí údaje pro ARES"]
    W --> S["Doplnění názvu a adresy do kontaktu"]
    A --> S

###### Co VIES neumí

Technické volání probíhá přes API fiapi?dd=… (vyžaduje přihlášení). Odkaz Ověřit plátce DPH v hlavičce kontaktu slouží k ruční kontrole DIČ mimo panel.

Ruční založení školy: v záhlaví seznamu Hledat v ARES podle IČO — viz Přidání subjektu. Panel na detailu slouží u již uložené školy.

##### Kontakt v akci — výběr a předvyplnění

Při zakládání nebo úpravě akce (záložka Základní info) je pole Kontakt rozbalovací seznam z adresáře:

1. Začněte psát název školy nebo firmy, nebo vyberte ze seznamu (Select2 — našeptávač).
2. Po výběru se do akce předvyplní název, IČO, DIČ, adresa a e-mail z kontaktu.
3. Volitelně vyberete kontaktní osobu (ředitel) — pokud je u školy evidována.
4. Barva řádku ve výběru odpovídá statusu plateb (u obchodních klientů).

Denio: V seznamu Kontakt u nové akce uvidíte jen školy (stejný filtr REDIZO jako v menu Kontakty). Lektor tím pádem nemůže omylem vybrat dodavatele místo školy.

Technik (o) v hlavním modulu vidí často jen dodavatele techniky; superadministrátor dodavatele systému — podle role se filtr liší.

##### Přidání subjektu a hledání v ARES

V modrém záhlaví u kontaktů (v Denio i v hlavním modulu):

• Přidat kontakt — ruční formulář (název, IČO, DIČ, adresy, status…). U české školy doplněte IČO a po uložení použijte panel ARES k doplnění REDIZO. U zahraniční firmy zadejte správné DIČ země (ES, DE, FR…) — po uložení panel načte údaje z VIES (návod).
• Hledat v ARES — podle IČO načtete údaje z veřejného registru a uložíte jako nový subjekt (jen české subjekty).

##### Propojení s RAYNET CRM (obchodní modul)

V Denio se RAYNET typicky nepoužívá. Níže popis platí pro obchodníky v hlavním modulu Akce, pokud je integrace zapnutá (viz menu RAYNET). Před prvním importem nebo synchronizací musí být splněno dvouúrovňové nastavení API — nejdřív administrátor, poté každý obchodník u položky Raynet API.

flowchart LR
    RN_CRM["CRM Raynet"] -->|API Klienti import| DB["Adresář Kontakty"]
    DB --> AK2["Akce pole Kontakt"]
    DB --> N["Náklady a objednávky"]
        ARES_PUB["Veřejný ARES"] -->|bez Raynet| DB

Typický postup lektora v Denio: V menu Kontakty najít školu → zkontrolovat detail a případně Obnovit z RŠ → v Nové akci vybrat školu jako Kontakt → doplnit prostory, personál a služby (nebo balíček).

Typický postup obchodníka: Klienta importovat z Raynet nebo založit z ARES → zkontrolovat detail → v akci vybrat Kontakt → doplnit prostory a služby. Před fakturací status plateb (zelená / červená).

Balíčky do akce

Pro: obchodníka, technika a lektora (t, b, u) — kdokoli zakládá opakované akce se stejným obsahem.

Co to je: Balíček není akce — je to šablona (předpřipravený seznam položek). Jednou sestavíte typickou kombinaci prostor, služeb, mobiliáře, cateringu nebo personálu a při zakládání nové akce ji na jedno kliknutí vložíte do reálné události. Modul musí mít organizace zapnutý v nastavení (Balíčky do akce); bez toho položka v levém menu nebo výběr u nové akce nebude.

Dvě různé funkce se podobným názvem: V levém menu je položka Balíčky do akce (obchodní šablony — prostory, služby, mobiliář…). U technika existuje samostatná správa balíčků techniky (sady audiovizuálního vybavení z katalogu techniky). Obě se jmenují „balíčky“, ale pracují s jinými daty a vkládají se v jiném kroku akce. Níže popis obou.

##### 1. Obchodní balíčky — správa šablon (levé menu)

Otevřete Balíčky do akce v levém menu. V záhlaví stránky přepínáte:

V seznamu u každého balíčku:

• Název (odkaz) — otevře detail balíčku a skládání položek.
• Poznámka — krátký popis, k čemu šablona slouží (zobrazí se i jako nápověda při výběru v akci).
• Ikony — upravit metadata balíčku · smazat celý balíček.

###### Skládání položek uvnitř balíčku

Po kliknutí na název balíčku uvidíte souhrnný seznam položek (název, kusy, orientační prodej a nákup). Nad ním jsou záložky podle typu — z nich přidáváte řádky do šablony:

U každé řádky v seznamu balíčku lze upravit počet kusů nebo řádek smazat. Ceny se berou z aktuálních ceníků v nastavení — při změně ceníku se u nově vkládaných akcí použijí nové sazby.

flowchart TB
    M["Levé menu Balíčky do akce"] --> V["Vlastní nebo společné"]
    V --> N["Nový balíček název a popis"]
    N --> P["Přidat položky Prostory Služby Mobiliář Catering Personál"]
    P --> S["Seznam položek v šabloně"]
    S --> U["Uloženo jako šablona"]

##### 2. Použití balíčku při zakládání akce

Obchodní balíček se nepřidává z levého menu u existující akce. Používá se jen při prvním uložení nové akce — v kapitole Založení nové akce, formulář Základní info:

1. V levém menu zvolte Nová akce (nebo Přidat novou akci v seznamu).
2. Vyplňte název, termín, kontakt a další povinná pole.
3. Pokud máte modul zapnutý, zobrazí se pole Balíčky — rozbalovací seznam. Nahoře jsou společné balíčky (žlutě), pod nimi vlastní. Volitelně vyberte jednu šablonu; prázdná volba = akce bez předvyplnění.
4. Uložte formulář. Systém nejdřív založí akci a hned poté automaticky vloží všechny položky z balíčku do příslušných kroků (prostory, služby, mobiliář, catering, personál).
5. Pokračujte menu akce — zkontrolujte obsazenost místností, doplňte techniku, bilanci atd.

Co balíček neudělá: Nevybere kontakt za vás, neřeší techniku z katalogu technika, nekopíruje přílohy ani smlouvy. Po vložení jsou položky běžné řádky akce — můžete je upravit, doplnit nebo smazat jako kdybyste je zadali ručně.

###### Kolize prostor a sklad

Při vkládání prostor z balíčku systém testuje, zda místnost v termínu akce není obsazená jinou akcí. Při mobiliáři kontroluje skladové množství. Když něco nesedí, uvidíte upozornění s odkazem na kolizní akci — termín nebo místnost upravíte ručně v kroku Prostory / Mobiliář. Po zasmluvnění akce se dočasné záznamy o testech balíčku uklidí.

flowchart TD
    A["Nová akce Základní info"] --> B{"Vybrán balíček?"}
    B -->|Ne| C["Jen prázdná akce"]
    B -->|Ano| D["Uložení akce"]
    D --> E["Automatické vložení položek"]
    E --> F["Prostory"]
    E --> G["Služby"]
    E --> H["Mobiliář"]
    E --> I["Catering a personál"]
    F --> J["Kontrola obsazenosti"]
    H --> K["Kontrola skladu"]
    J --> L["Pokračování v menu akce"]
    K --> L
    C --> L

##### 3. Technické balíčky — samostatná funkce

Pro audiovizuální techniku existuje jiný typ balíčku než v levém menu Balíčky do akce. Spravuje ho technik v modulu Technika (obrazovka Technika balíčky). Zapíná se v nastavení (Balíčky techniky).

Podrobný návod: 3c — Balíčky techniky (správa a vložení).

Typický postup obchodníka: Jednou v levém menu sestavíte společný balíček „Konference 80 osob“ (sál + projekce + coffee break + obsluha) → u každé podobné akce při Nové akci balíček vyberete → po uložení zkontrolujete prostory a doplníte techniku u technika → zbytek doladíte v bilanci. Vlastní balíčky si nechte pro varianty, které používáte sami; firemní standardy dejte do společných.

Recepce ▾

Pro: recepci, obchodníka s právy vstupů (t, b, k).

Složka pro evidenci vstupů a návštěvnosti podle objektů a akcí. Nadřazená položka se rozbalí na podmenu:

Partneři ▾

Pro: obchodníka při zapnutém partnerském programu u vaší organizace.

Partnerský program a sponzoring — bez zapnutého modulu se celá větev menu nezobrazí. Typické podpoložky:

Technika

Pro: technika a přehled techniky (o, p; někdy t).

Přechod na sklad / seznam techniky (v menu může být odkaz {tt}— systém doplní správnou adresu skladu). Slouží k rezervaci a inventuře techniky napříč akcemi, ne jen u jedné akce.

RAYNET ▾

Pro: obchodníky s CRM Raynet (t, b — dle nastavení). Základní konfiguraci serveru nastavuje administrátor systému.

Integrace s Raynet CRM doplňuje adresář Kontakty — synchronizace klientů, import při zakládání firmy a filtr ve výběru kontaktu u akce. V databázi se údaje ukládají do tabulky configraynet: jeden společný řádek organizace (nastaví admin) a u každého uživatele vlastní řádek s jeho API klíčem.

Proč formulář Raynet API není hned aktivní? Obchodník nemůže ukládat vlastní API údaje, dokud administrátor v konfiguraci systému nevyplní alespoň adresu serveru API (configraynet.adresa, typicky https://app.raynet.cz/api/v2). Bez toho systém neví, kam se připojovat, a formulář RAYNET → Raynet API zůstane neaktivní se zprávou Formulář není aktivní. Stejný princip jako u PREMIER — nejdřív adresa a instance organizace, poté osobní přístup každého uživatele.

##### Nastavení RAYNET — kdo co konfiguruje

Propojení má dva kroky. Oba ukládají data do configraynet, ale do jiných řádků (administrátor má kodu = 0, uživatel má kodu = KodU z přihlášení).

flowchart TB
    subgraph K1["Krok 1  -  administrátor"]
        A["Konfigurace → RAYNET nastavení"] --> B["Adresa API + Název CRM"]
    B --> C["Volitelně sync klíč pro RaynetSync"]
    C --> DB0["configraynet kodu = 0"]
    end
    subgraph K2["Krok 2  -  obchodník t/b"]
        D{"Je v DB0 vyplněna adresa?"}
    D -->|Ne| E["Formulář Raynet API neaktivní"]
    E --> F["Hláška: čeká na administrátora"]
    D -->|Ano| G["RAYNET → Raynet API"]
    G --> H["E-mail Raynet + vlastní API klíč"]
    H --> I["Ověřit spojení s RAYNET API"]
    I --> DBU["configraynet kodu = KodU"]
    end
    DB0 --> D
    DBU --> J["RAYNET → Klienti"]
    DBU --> K["Kontakty  -  import z Raynet"]
    DBU --> L["Akce  -  výběr kontaktu z CRM"]

Co může obchodník na stránce Raynet API:

• Vložit do databáze — první registrace vlastního API klíče (jen pokud je formulář aktivní).
• Uložit změny — aktualizace e-mailu nebo API klíče po obnovení klíče v Raynetu.
• Ověřit spojení s RAYNET API — test GET /company/?limit=1 proti uložené konfiguraci (zobrazí se po prvním uložení).

Adresu serveru a název instance nemění — ty určuje administrátor v kroku 1.

##### Raynet API — vlastní nastavení uživatele

Stránka RAYNET → Raynet API slouží k uložení osobních přihlašovacích údajů do Raynet CRM. Přístup probíhá přes HTTPS s HTTP Basic (e-mail:api-klic) a hlavičku X-Instance-Name podle dokumentace RAYNET CRM API.

Pokud administrátor základní konfiguraci ještě neprovedl, uživatel uvidí upozornění Formulář není aktivní a tlačítko uložení bude nedostupné — musí požádat správce o doplnění RAYNET nastavení v konfiguraci systému.

##### Podmenu RAYNET v levém menu

Po aktivaci integrace (admin nastavil adresu, uživatelé mají vlastní API klíče) se v levém menu zobrazí větev RAYNET ▾:

Z modulu Kontakty je dostupný odkaz Raynet kontakty v záhlaví a u každého IČO ikona pro dohledání v CRM — viz Propojení s RAYNET.

Bez aktivní integrace (chybí admin adresa nebo uživatelské API) se větev RAYNET v menu nemusí zobrazit nebo nebude funkční; kontakty spravujete přes ARES a ruční zadání.

Typický postup zavedení: Administrátor vyplní RAYNET nastavení (adresa + název CRM + sync klíč) → každý obchodník si v Raynetu vygeneruje API klíč → v RAYNET → Raynet API uloží e-mail a klíč → ověří spojení → spustí RAYNET → Klienti nebo import z katalogu v Kontaktech.

Seznamy ▾ (tisky)

Pro: obchodníka (b) — tiskové přehledy ceníků a skladů.

PopisMenu: Přehled služeb, personálu a mobiliáře. Podmenu slouží k tisku seznamů (ne k editaci akce):

Aplikace ▾

Pro: uživatele s přístupem do více modulů — role se liší u každé podpoložky.

V demu: demo.iskasa.eu— účet obchod (obchodní menu), nahlizi (jen prohlížení). Přepínač modulů (Dovio, Majetek, Denio…) podle role — tabulka účtů v kapitole 2b.

Přechod do jiných aplikací v rámci platformy (nové okno / složka). Typické podpoložky v DOVIS - ISKASA:

Běžný obchodník zůstává v modulu Akce; ostatní odkazy vidí jen s příslušnými právy.

Kalendář zaměstnanců

Pro: HR, vedení, zaměstnance (t, b, k, o, p, m, r, u, e, ex…).

Kalendář dovolených, náhradního volna, služebních cest — ovládání mřížky (zoom, tisk): Kalendář zaměstnanců v přehledu kalendářů. Není to kalendář akcí, personál na akcích ani brigádní směny.

V demu: přihlaste se jako personalni na demo.iskasa.eu— kalendář absencí a personalistika.

Na co si dát pozor. Jde o osobní absenci (kdo je kdy pryč z práce). Obsazení lidí na konkrétní akci nebo směnu řešíte jinde — viz kapitola 3a Plánování směn a záložka Personál u akce.

##### Co uvidíte po otevření

V levém menu modulu Akce (případně jiného modulu, kde máte položku Kalendář zaměstnanců) otevřete měsíční mřížku — podobně jako u kalendáře akcí, ale místo akcí jsou tam záznamy zaměstnanců (barevné zkratky a vícedenní pruhy).

• Šipky měsíce — přepnutí období; volitelně filtry střediska, útvaru, organizační struktury (podle nastavení firmy).
• Zoom − / + / Výchozí — stejně jako u kalendáře akcí (viz společné ovládání kalendářů).
• Legenda typů — barvy a zkratky (DO, NV, SC…) z číselníku typů kalendáře; správce je upravuje v Nastavení → Kalendář typ.
• Klik na den — začnete vložit záznam od zvoleného data (viz níže).
• Klik na jméno / záznam v buňce — detail žádosti (QR, schválení, tisk listku u některých typů).
• Přehled z kalendáře — ikona v záhlaví měsíční mřížky → roční tabulkový přehled absencí; podrobně Přehled z kalendáře (calendar2-prehled).

##### Přehled z kalendáře — tabulka za rok (calendar2-prehled)

Obrazovka Přehled z kalendáře (calendar2-prehled) doplňuje měsíční mřížku calendar2. Místo barevných čipů v buňkách uvidíte seznam všech záznamů za zvolený rok — vhodné pro kontrolu čerpání dovolené, souhrn pro HR nebo tisk přehledu pro vedení. Záznamy se nevkládají ani neschvalují — jen se zobrazují data z kalendáře.

###### Jak se na přehled dostanete

• Z měsíčního Kalendáře zaměstnanců (calendar2) — ikona Přehled z kalendáře v horním záhlaví vedle názvu měsíce.
• Stejná ikona je i na osobním kalendáři (zzpkalendar) a na kartě zaměstnance (karta).
• V záhlaví přehledu je odkaz zpět na calendar2, jméno zobrazené osoby, ikona tisku a odkaz na tento návod.

###### Filtry nad tabulkou

Formulář nahoře se po změně hodnoty sám odešle (onchange). Kombinace filtrů určí, co v tabulce uvidíte:

Bez výběru osoby v přehledu vidíte vlastní záznamy přihlášeného uživatele. Nadřízený nebo admin si v rozevíracím seznamu zvolí podřízeného a zkontroluje jeho absences za rok.

Oprávnění podle role — stručně.

• Běžný zaměstnanec — jen svůj přehled; filtr osoby nemá; v nabídce typů jen typy, které firma neukryla.
• Nadřízený (MySuperior = 1 v kartě uživatele) — může přepínat osobu a prohlížet přehled podřízených (stejný seznam jako u běžných zaměstnanců v kalendáři).
• Administrátor e (admin = e) — výběr libovolné osoby; navíc v filtru typů a v legendě dole vidí i skryté typy (přeškrtnuté) a odkazy na úpravu typu v calendartyp.
• Administrátor e + admin2 — na obrazovce přehledu stejný výběr osoby jako nadřízený; u tisku přehledu (calendar2-prehled-print) je výběr osoby jen pro MySuperior a admin = e (ne pro samotné admin2 bez e).

Přehled nezobrazuje záznamy jiných lidí bez oprávnění — v SQL je vždy omezení na KodU (vlastní ID nebo vybraná osoba).

###### Co je v tabulce

Záznamy jsou seskupené podle měsíce (nahoře prosinec, dolů leden — jen měsíce, ve kterých máte alespoň jeden řádek). Název měsíce je odkaz do měsíční mřížky calendar2 pro daný měsíc a rok.

Zrušené záznamy (přeškrtnutý text, šedé pozadí) zůstávají v přehledu kvůli historii, ale Prac.dnu = 0 a nepočítají se do součtu. Vícedenná absence je v přehledu jako jeden řádek na každý kalendářní den (stejně jako v databázi working_calendar).

###### Tisk a legenda

• Tisk — ikona tiskárny v záhlaví otevře calendar2-prehled-print s aktuálním rokem a filtrem typu; po načtení se spustí dialog tisku. Tisková verze má sloupec Prac.dnu v tabulce.
• Legenda typů — pod tabulkou je stejný seznam zkratek, barev a popisů jako v kalendáři (CalendarTypSeznam2). Superadmin e vidí i skryté typy a může je upravit klikem na zkratku.

flowchart LR
    M["Měsíční kalendář calendar2"] --> I["Ikona Přehled z kalendáře"]
    I --> P["calendar2-prehled"]
    P --> F["Filtry: rok / typ / osoba"]
    F --> T["Tabulka po měsících"]
    T --> S["Prac.dnů celkem"]
    P --> PR["Tisk calendar2-prehled-print"]

Typické použití: Zaměstnanec si na konci roku zkontroluje Prac.dnů celkem u dovolené. HR nebo nadřízený vybere podřízeného, filtr DO a rok — rychlý souhrn bez proklikávání měsíců. Před schválením delší absence ověřte, že víkendy a svátky v rozsahu mají v přehledu Prac.dnu: 0 (systém je nepočítá automaticky).

##### Typy záznamů (příklady)

Konkrétní nabídka závisí na vaší organizaci (tabulka typů v administraci). Běžně se používá například:

##### Stavy záznamu

V přehledu poznáte stav podle barvy a textu (nepotvrzené žádosti bývají zvýrazněné červeně, stejně jako v legendě „čeká na schválení“):

##### Vkládání od kalendáře (krok za krokem)

1. Otevřete Kalendář zaměstnanců a v mřížce klikněte na den, od kterého chcete absenci plánovat (můžete začít i na jeden den a rozsah později upravit).
2. Systém zobrazí datum a nabídku typu (dovolená, NV, služební cesta…). Vyberte typ — u některých typů systém zkontroluje, zda už v daném dni nemáte jiný záznam.
3. Doplňte datum od a datum do (u půldne nebo speciálních technických typů může systém navrhnout rozsah sám).
4. U běžných absencí napište zprávu / důvod do poznámky; u služební cesty často další pole (místo pobytu, účel, doprava, spolucestující).
5. Vyberte nadřízeného, který má žádost schválit (při prvním použití si ho systém může zapamatovat pro další žádosti).
6. Po uložení se v kalendáři objeví barevný záznam ve stavu čeká na schválení a nadřízenému přijde e-mail s odkazem na potvrzení.

HR nebo nadřízený může záznam vložit i za jiného zaměstnance (výběr osoby ve formuláři), pokud k tomu má oprávnění.

flowchart TD
    K["Kalendář zaměstnanců"] --> D["Klik na den"]
    D --> T["Výběr typu absence"]
    T --> F["Formulář: od–do, poznámka, nadřízený"]
    F --> U["Uložení do kalendáře"]
    U --> C["Stav: čeká na schválení"]
    C --> M["E-mail nadřízenému"]
    M --> Z["Zobrazení v mřížce barevným čipem"]

##### Schvalování nadřízeným

1. Nadřízený dostane e-mail („požaduje schválení“) s údaji: kdo, jaký typ, od–do, důvod.
2. V e-mailu je odkaz — po přihlášení otevře detail záznamu (včetně QR kódu pro rychlou identifikaci na pracovišti).
3. Pokud je žádost v pořádku, klikne na Potvrdit. Systém změní stav na schváleno a pošle zaměstnanci e-mail se shrnutím (u lékaře může být v mailu i prostor pro doplnění údajů po návštěvě).
4. Není-li žádost v pořádku, nadřízený zvolí Zrušit — zaměstnanec u svého záznamu může použít Poslat znovu ke schválení, pokud žádost upraví.

Schválit může jen uživatel, který je u záznamu uveden jako nadřízený (systém při pokusu jiné osoby zobrazí chybu). Odkaz z e-mailu může vyžadovat přihlášení — po přihlášení se vrátíte na stejnou žádost.

flowchart LR
    Z["Zaměstnanec: žádost z kalendáře"] --> C["Čeká na schválení"]
    C --> E["E-mail nadřízenému"]
    E --> D["Detail + Potvrdit / Zrušit"]
    D -->|Potvrdit| OK["Schváleno  -  viditelné v kalendáři"]
    D -->|Zrušit| X["Zamítnuto / smazáno"]
    OK --> EM["E-mail zaměstnanci"]
    X --> Z2["Zaměstnanec může opravit a poslat znovu"]

##### Úpravy nadřízeného v kalendáři

• Přesun rozsahu — u schválených (nebo svých) záznamů může nadřízený v mřížce táhnout čip nebo vícedenní pruh na jiné dny; po puštění potvrdí uložení (Esc = zrušit).
• Zrušení — z detailu záznamu; u již schválené absence může jít o označení zrušení a informační e-mail.
• Hromadné vkládání — speciální obrazovka pro vybrané vedoucí techniků; podrobně níže.

##### Speciální funkce: Hromadné vkládání do kalendáře

Samostatná obrazovka Hromadné vkládání do kalendáře slouží vedoucím technikům k naplnění celého roku pracovními týdny / víkendovými směnami pro všechny přímé podřízené najednou — bez klikání den po dni v běžném kalendáři zaměstnanců.

Kdo to může ovládat. Přístup není pro běžné role (HR, obchodník, zaměstnanec). Obrazovka je v systému omezena na vybrané přihlášené účty (typicky vedoucí techniků s přiřazenými podřízenými v evidenci Nadřízený ↔ podřízený). Ostatní uživatelé uvidí hlášku nemáte oprávnění a formulář se nezobrazí. Odkaz na obrazovku bývá přímý (záložka / interní odkaz), není v běžném levém menu pro všechny.

###### Účel a rozdíl oproti běžnému vkládání

###### Předpoklady (musí být splněno)

1. V administraci máte u každého technika v tabulce vztahů přiřazeného nadřízeného (stejný vedoucí, který hromadně vkládá).
2. U podřízených je vyplněné pole pořadí v týdnu (poradityden) — určuje, kdo „bere“ který týden v rotaci (1 = typicky první pracovní týden, 5 = začátek víkendové skupiny).
3. Seznam podřízených na obrazovce zobrazuje systém automaticky — pokud je prázdný, hromadné vložení nic neudělá.

###### Formulář — co vyplníte

###### Jak systém přiřazuje dny (rotace po týdnech)

Logika probíhá týden po týdnu v celém zvoleném roce:

1. Načtou se všichni aktivní přímí podřízení seřazení podle pořadí v týdnu.
2. Pro první kalendářní týden (od pondělí) se vezme zvolený (nebo výchozí) podřízený — jemu se vloží všechny vybrané dny v tom týdnu (např. každý pracovní den = záznam PRT).
3. V dalším týdnu pokračuje další podřízený v pořadí; po posledním se cyklus vrátí na prvního (rotace dokola až do konce roku).
4. U každého dne systém zkontroluje, zda jde o pracovní den, víkend nebo státní svátek — do hromadného vkládání „pracovních dnů“ se státní svátky v týdnu nezapočítávají (je potřeba doplnit ručně v běžném kalendáři, pokud má technik sloužit).

Speciální pravidlo pro PRV + víkendy: Když se v sobotu vkládá typ PRV, systém navíc automaticky doplní dva předchozí pracovní dny typem NVV (náhradní volno za víkend — technici) pro stejného podřízeného — pokud tyto dny najde v daném roce (hledá maximálně několik dní zpět).

flowchart TD
    V["Vedoucí: Hromadné vkládání"] --> F["Typ PRT nebo PRV + rok + pracovní dny / víkendy"]
    F --> S["Od koho začít rotaci"]
    S --> T["Týden 1: podřízený A  -  všechny vybrané dny"]
    T --> T2["Týden 2: podřízený B"]
    T2 --> T3["Týden 3: další v pořadí…"]
    T3 --> CYK["Po posledním znovu A až do 31. 12."]
    CYK --> KAL["Záznamy v Kalendáři zaměstnanců"]
    F -->|PRV + sobota| NVV["+ automaticky NVV na 2 předchozí pracovní dny"]
    NVV --> KAL

###### Souhrn a hromadné smazání

Pod formulářem je tabulka Souhrn vámi vložených záznamů pro zvolený rok:

• každý typ (PRT, PRV, případně NVV z automatiky), který jste jako vedoucí vložili,
• počet řádků v kalendáři,
• tlačítko Smazat tento typ — smaže všechny vaše hromadné záznamy daného typu v daném roce (po potvrzení). Mazání se týká jen záznamů, kde jste uvedeni jako nadřízený při vložení; cizí záznamy nezmizí.

flowchart LR
    H["Hromadné vložení dokončeno"] --> S["Souhrn podle typu a roku"]
    S --> D{"Smazat tento typ?"}
    D -->|Ano| DEL["Vymaže všechny řádky typu vložené vámi v roce"]
    D -->|Ne| KAL["Kalendář beze změny"]

###### Upozornění a chyby

• Pokud už má podřízený v daný den jiný záznam, vložení selže (kolize v databázi) — v hlášení uvidíte počet neúspěšných a detail.
• Státní svátky v týdnu se při volbě „pracovní dny“ přeskočí — doplnění ručně, pokud je potřeba.
• Hromadné záznamy nenahrazují schvalování dovolené — na DO/NV používejte běžný kalendář.
• Na obrazovce je často vložený interní návod (modul novinek) — doplňuje tento uživatelský popis.

Typický postup vedoucího techniků: Na začátku roku nejdřív Pracovní dny + typ PRT (rotace od 1. podřízeného), poté Víkendy + typ PRV (rotace od podřízeného s pořadím 5). Zkontrolujte měsíční kalendář a svátky ručně. Před opakováním stejného roku nejdřív v souhrnu smažte starý typ, jinak hrozí kolize.

##### Související obrazovky

Tipy: Před delší dovolenou zkontrolujte kolizi s akcemi v Personál u akcí, ne v tomto kalendáři. Nepotvrzená žádost v kalendáři neznamená, že máte volno schválené — počkejte na e-mail „schváleno“ nebo zelený stav v detailu. Brigádní směny řešte v Seznam směn, ne zde.

Rozdělení osob

Pro: HR a vedení s přístupem ke struktuře firmy.

Organizační struktura — strom oddělení a přiřazení zaměstnanců. Používá se pro plánování kapacit a přehledy podle týmů.

Karta zaměstnance

Pro: BOZP, majetek přiřazený k osobám (t, b, k, o, p, m, r, u, e…).

Evidence BOZP a majetku podle osob — co má který zaměstnanec přiděleno (odpovědnost, vybavení).

Seznam směn

Pro: brigádníky a plánovače směn (ex, e, t, b).

Otevře modul plánování směn — tabulkový seznam všech naplánovaných směn (kdo, kdy, jaký typ směny, pozice, stav). Slouží ke kontrole, schvalování, hromadné změně stavu a dokončení směn.

Podrobný popis filtrů, stavů a postupu: kapitola Plánování směn → Seznam směn.

Přehled požadavků

Pro: stejné role jako Seznam směn — vedení směn a brigády.

Měsíční mřížka požadavků na obsazení — podle pozice a dne v měsíci vidíte, kolik lidí je potřeba na daný typ směny a kolik je už obsazeno. Brigádník si zde může přihlásit směnu, pokud je volné místo.

Podrobný popis: kapitola Plánování směn → Přehled požadavků.

Nastavení ▾

Pro: administrátora akcí (t), správce objektů (r u vybraných položek), lektora (u u školních modulů). Běžný obchodník (b) menu Nastavení většinou nevidí — pracuje s položkami už založenými v akci (Seznam (nové)).

K čemu slouží: Centrální správa ceníků a číselníků, ze kterých se při zakládání akce vybírají prostory, služby, mobiliář, personál a technika. Změna ceny nebo názvu zde se projeví u nových výběrů v akcích (u rozpracovaných akcí záleží na tom, zda už byla položka vložena).

Struktura menu odpovídá tabulce configmenu2 (nadřazená položka Nastavení, kód 8). Pořadí podpoložek může administrátor upravit; níže je typické zobrazení jako na obrázku menu.

flowchart LR
    subgraph Nast["Nastaveni - ceniky"]
        P["Prostory budovy mistnosti"]
        S["Sluzby"]
        M["Mobiliar"]
        Z["Personal"]
        T["Technika"]
    end
    subgraph Akce["Prace v akci"]
        K["Krok Prostory Sluzby atd."]
        L["Seznam nove - vyber z ceníku"]
    end
    Nast --> K
    K --> L

##### Přehled všech položek (strom menu)

Doplňkové položky (nemusí být ve vašem menu — závisí na konfiguraci nájemce): Parametry (vlastnosti míst a zboží), Auta (číselník vozů), News, Umístění měření (role r — stejný číselník jako u energetických měřidel), Školní pomůcky, Kategorie předmětů, Seznam plateb (role u lektor).

Složka Catering ▾ (kategorie, zboží, tisky…) je u většiny instalací samostatná větev levého menu, ne pod Nastavením. Ceník zde doplňuje správce; obchodník ho používá v záložce Catering u akce — viz kapitola 7d.

##### Ceníky — prostory, služby, mobiliář, personál

###### Prostory (+ Prostory tisk)

Hierarchie areál → budova → místnost. U každé místnosti evidujete kapacitu, vybavení, nákupní a prodejní cenu (pronájem), případně vazbu na měření energií. U budovy i místnosti je pole Smlouva — výběr vzoru smlouvy o pronájmu ze šablon, které založil superadmin v Doklady (TypDokladu ≥ 1000). Bez přiřazení vzoru obchodník u akce smlouvu nevygeneruje — viz Smlouvy podle budov. Tyto místnosti pak obchodník vybírá v kroku Prostory u akce.

• Prostory tisk — tiskový výpis ceníku místností (pro obchodníka b i admina) pro rychlou orientaci při nabídce.

###### Služby (+ Služby tisk)

Číselník doplňkových služeb (úklid, security, produkce, recepce…). U každé služby cena nákup / prodej, jednotka, DPH. V akci: záložka Služby → Seznam (nové).

Služby tisk — tisk seznamu služeb včetně cen (role u u škol může služby jen číst/tisknout dle nastavení).

###### Mobiliář (+ kategorie a tisky)

Evidence stolů, židlí, pultů, lednic atd. s cenami. Podpoložky:

• Mobiliář kategorie — strom kategorií (uspořádání katalogu).
• Mobiliář tisk — tisk ceníku (nákup i prodej).
• Mobiliář tisk prodej — tisk pouze prodejních cen (pro nabídky zákazníkovi bez nákupní strany).

V akci: Mobiliář — včetně přiřazení k údržbě u akce (mobiliář „u akce“ v plánování směn).

###### Personál (+ Personál tisk)

Položka Nastavení → Personál otevře obrazovku personal— centrální správu personálního ceníku pro akce (pokladna, vstup, security, uklízečky, produkce…). Na rozdíl od jednoduchých číselníků (služby, mobiliář) má personál v DOVIS - ISKASA třístupňovou strukturu, která se propojuje s záložkou Detail u akce a s tiskem Infosheetu. Obchodník pak v akci vybírá z ceníku v kroku Personál; obsazení konkrétních lidí navazuje plánování směn u akcí.

Klíčová vazba: Všechny tři kroky níže sdílí společný identifikátor rozdělení personálu (tabulka dovdetailpersonalu). Typ v ceníku (dovpersonal.detail), řádek personálu u akce (dovakcepersonal.detail) i box v detailu akce / infosheetu (dovdetail.DetailAkcePersonal) se vážou na stejné rozdělení. Bez správného zařazení se personál v provozním listu nebo infosheetu neobjeví ve správné sekci.

###### Horní lišta — tři kroky (jako v aplikaci)

Na stránce personal (a související detailconfig) je nahoře navigace se třemi číslovanými kroky. Doporučené pořadí zavádění je 1 → 2 → 3:

Volitelně (pokud má organizace zapnuté zodpovědné osoby u položek, režim Individuální): odkaz Přidat zod. osobu hromadně (personal?action=zod) — viz 3i.

flowchart TB
    subgraph K1["Krok 1 - Rozdeleni dovdetailpersonalu"]
        R1["Provoz"]
        R2["Security"]
        R3["Catering"]
    end
    subgraph K2["Krok 2 - Cenik personal"]
        T1["Typ Pokladna"]
        T2["Typ Vstup"]
        O1["Osoba Novak"]
    end
    subgraph K3["Krok 3 - Detail boxy dovdetail"]
        D1["Box Provozni personal rozpis=3"]
        D2["Box Security rozpis=3"]
    end
    subgraph Akce["Prace v akci"]
        P4["step04 Personál"]
        DT["Zalozka Detail akce"]
        IS["Infosheet tisk"]
    end
    R1 --> T1
    R2 --> T2
    R1 --> D1
    R2 --> D2
    T1 --> P4
    T2 --> P4
    O1 --> P4
    P4 --> DT
    DT --> IS

###### Krok 1 — Seznam / Přidat rozdělení

K čemu slouží: Logické skupiny, do kterých se řadí typy personálu, konkrétní osoby i boxy detailu. Bez rozdělení lze sice založit typ „Pokladna“, ale nepropojí se automaticky s příslušnou sekcí infosheetu.

• Seznam —detailconfig?action=per (pouze role t).
• Přidat / upravit —detailconfig?action=perf nebo klik na název v seznamu.

###### Krok 2a — Seznam personálu (typy rolí)

Výchozí obrazovka personal— číselník typů externího personálu s prodejními a nákupními sazbami. Obchodník z nich vybírá v akci (kapitola Personál).

• Seznam — tabulka: název, rozdělení (zeleně), nákup, cena za 1 h, editace.
• Přidat personál —personal?action=add.
• Upravit typ —personal?action=add&pp={Kod} (admin t; obchodník b může editovat/smazat vlastní záznamy).
• Hledat — pole Hledaný text nad seznamem.

Varianty u typu (pod formulářem): Po uložení nového typu lze přidat podpoložky skladové karty (skladkartazbozi) — stejný princip jako u techniky: jiný dodavatel, jiná nákupní cena, jiný název varianty. Bez dodavatele se položka eviduje jako nepřímé náklady. Každá varianta musí mít platné rozdělení — jinak u ní v seznamu svítí Opravte rozdělení personálu; viz kontrola a oprava v kroku 2b.

Režim TechnikaPersonalOK: U některých instalací (propojení technika + personál) obsahuje formulář typu i jméno, adresu, RČ, IČO, telefon a e-mail — a při uložení může založit uživatelský účet.

Parametry: Pokud je zapnut modul parametrů (ParametryOK = 1), u každého typu je ikona pro vlastní parametry (stejně jako u mobiliáře).

###### Krok 2b — Seznam personálu osob / Přidat osobu

Evidence konkrétních lidí (brigádníci, externisté se jménem), ne jen abstraktních typů. Tabulka dovpersonalosoby.

• Seznam osob —personal?action=oso (sloupce: jméno, adresa, telefon, e-mail, kdo vložil, sazby).
• Přidat osobu —personal?action=oso&pp=0.
• Upravit osobu —personal?action=oso&pp={Kod}.

###### Kontrola „Opravte rozdělení personálu“

Na stránce personal systém kontroluje, zda je u záznamu vyplněno platné rozdělení personálu (krok 1). Pokud chybí nebo neodpovídá žádnému záznamu v dovdetailpersonalu, místo zeleného názvu rozdělení uvidíte červený text:

Opravte rozdělení personálu — kliknutelný odkaz (role t).

Kde se hláška zobrazuje: Nejvíc viditelná je u variant dodavatele pod typem personálu (tabulka skladkartazbozi— zelený podblok Název / Dodavatel pod hlavním řádkem typu, např. 01. Security — Venkovní prostory u dodavatele SAFE WORLD…). Hlavní typ může mít rozdělení v pořádku (zeleně Personál Security), ale konkrétní varianta s dodavatelem ne — pak u varianty svítí červeně. Stejná logika platí i pro pole Zařadit do u osoby: bez rozdělení se osoba nezařadí do správného boxu detailu akce / infosheetu.

Proč systém kontroluje: Pole detail/DetailAkcePersonal musí ukazovat na existující rozdělení z kroku 1. Jen pak:

• se řádek personálu u akce filtruje do správného boxu v záložce Detail,
• může se vložit do Infosheetu (u boxů s rozpisem vložit i personál),
• souhlasí s typem personálu v ceníku a s konfigurací v Detail názvy.

Bez rozdělení zůstane varianta nebo osoba „mimo strukturu“ provozního listu — obchodník sice personál do akce vloží, ale v detailu / infosheetu se neobjeví ve správné sekci.

###### Jak opravit na personal

1. Klikněte na Opravte rozdělení personálu — otevře se personal?action=add&kz={varianta}&pp={typ}.
2. Nejdřív ověřte, že nadřazený typ má v poli Zařadit do správné rozdělení (personal?action=add&pp={Kod typu}).
3. Pokud chybí rozdělení v kroku 1, založte ho v detailconfig?action=perf— viz krok 1.
4. U varianty znovu uložte formulář dodavatele (Vložit) — skryté pole převezme DetailAkcePersonal z typu a červená hláška zmizí; místo ní se zobrazí zelený název rozdělení.

1. Otevřete personal?action=oso&pp={Kod osoby}.
2. V poli Zařadit do vyberte stejné rozdělení jako u příslušného typu personálu (např. Personál Security).
3. Uložte (Vložit personál). Osoba se pak správně propojí s detailem akce a infosheetem při obsazení směny.

flowchart TD
    A["Zobrazi se Opravte rozdeleni personalu"] --> B{"Co chybi?"}
    B -->|Rozdeleni v kroku 1| C["detailconfig action=perf - zalozit skupinu"]
    B -->|Typ nema Zařadit do| D["personal action=add pp=typ"]
    B -->|Varianta dodavatele| E["Klik na cerveny odkaz kz+pp"]
    B -->|Osoba| F["personal action=oso pp=osoba"]
    C --> G["U typu vybrat Zařadit do"]
    D --> G
    G --> H["Preulozit variantu nebo osobu"]
    E --> H
    F --> H
    H --> I["Zeleny nazev rozdeleni v seznamu"]

Oprávnění: Osobu může editovat nebo smazat ten, kdo ji vložil (obchodník b, lektor u), nebo hlavní administrátor (t). Opravu rozdělení u typů a variant typicky provádí admin (t); obchodník u vlastních osob doplní Zařadit do sám.

Rozdíl typ vs. osoba v akci: V kroku Personál u akce obvykle vybíráte typ (2× Pokladna). Konkrétní jméno doplníte režimem Jedna položka / přiřazením osoby (KodOsoba) nebo z plánovacího kalendáře směn — pak se do řádku doplní příjmení a jméno z dovpersonalosoby. U variant s dodavatelem se do akce může dostat konkrétní nákupní sazba — proto musí mít i varianta platné rozdělení (viz krok 2a — varianty).

###### Krok 3 — Seznam / Přidat detail (boxy pro akci a infosheet)

Obrazovka detailconfig (výchozí seznam) definuje bloky, které se zobrazí v záložce Detail u akce a v tisku Infosheetu. Stejnou obrazovku otevře i samostatná položka levého menu Detail názvy (detailconfig) — lišta kroků 1 a 3 je shodná.

###### Tok dat: ceník → akce → detail → infosheet

1. Administrátor založí rozdělení, typy personálu (s přiřazením rozdělení) a detail boxy s rozpis = vložit i personál.
2. Obchodník v akci v kroku Personál vloží požadavek (typ + počet + termín) — vznikne záznam v dovakcepersonal včetně pole detail z ceníku.
3. Volitelně doplní konkrétní osobu (nebo ji obsadí koordinátor v kalendáři směn) —KodOsoba odkazuje na dovpersonalosoby.
4. V záložce Detail akce obchodník u každého boxu doplní text; u boxů s personálem vidí automatický výpis řádků se shodným rozdělením a může zaškrtnout Vložit personál do Infosheet.
5. Při generování Infosheetu systém složí HTML/PDF: text boxu + (pokud doinfosheet = 1) tabulku personálu — termín, počet, název typu, jméno osoby, poznámka.
6. Osobám s e-mailem může systém poslat info z personálu akce (step100InfoSheet— obsah z PopisPersonal).

flowchart LR
    subgraph Nastaveni["Nastaveni personal 3 kroky"]
        RP["Rozdeleni"]
        DP["dovpersonal typ"]
        DD["dovdetail box"]
    end
    subgraph AkceData["Data v akci"]
        AP["dovakcepersonal"]
        ADV["dovakcedetailvlastni"]
    end
    subgraph Vystup["Vystup"]
        DET["Zalozka Detail"]
        INF["Infosheet PDF"]
        MAIL["Email osobam"]
    end
    RP --> DP
    RP --> DD
    DP -->|detail stejne kod| AP
    DD -->|DetailAkcePersonal| ADV
    AP -->|filtr detail| DET
    AP -->|doinfosheet=1| INF
    AP --> MAIL
    ADV --> INF

###### Personál tisk

Podpoložka Personál tisk (PersonalTisk) — tiskový výpis ceníku typů personálu včetně sazeb. Role t (admin) tiskne celý ceník; obchodník b má v menu přístup ke čtení seznamu a tisku pro orientaci při nabídce (bez editace cizích záznamů).

###### Role a oprávnění

Tip pro zavádění: Nejdřív vymyslete rozdělení podle provozního listu (kolik sekcí infosheeta potřebujete). Pak založte typy personálu a každý typ zařaďte do rozdělení. Teprve potom vytvořte detail boxy s vložit i personál a stejným rozdělením. Nakonec v testovací akci vložte personál a ověřte záložku Detail + tisk Infosheetu.

Související: Detail názvy, Infosheetáři, vkládání personálu do akce, plánování směn, záložka Detail u akce.

###### Technika (+ Technika kategorie)

Základní katalog techniky pro modul akcí (jiný než velký sklad techniků v menu role o — viz kapitola Technici). Položky zde lze přidávat do akce v kroku Technika.

Technika kategorie — členění katalogu (obchodník b může prohlížet podle oprávnění).

##### Provoz, dokumenty a kontrola

###### Správci objektů

Evidence správců budov (jméno, kontakt, přiřazené objekty). Při akci se správce volí do položek typu „správce u akce“ — systém z něj může generovat úkoly v plánování (prohlídky, předání klíčů). Role r často správce sama spravuje.

###### Logolinky

Správa log partnerů a sponzorů (soubor obrázku, pořadí). Loga se vkládají do tiskových výstupů, nabídek nebo dokumentů k akci podle šablony organizace.

###### Aktivity uživatelů

Přehled kdo se kdy přihlásil a jak pracoval s akcemi — kontrolní obrazovka pro vedení (audit aktivit obchodníků a referentů).

###### Detail názvy

Položka Nastavení → Detail názvy (role t, bez podpoložek — viz tabulka menu výše) otevře obrazovku detailconfig. V databázi menu (configmenu2) je popis Popis jednotlivých detailů v akci; v praxi jde o šablonu boxů (nadpis + volitelný automatický obsah), které obchodník vyplňuje v záložce Detail u akce a které se skládají do tisku Infosheetu (provozní list pro infosheetaře).

Vazba na Personál (obr. menu Nastavení): Položka Detail názvy není oddělený modul — sdílí obrazovku a data s Personálem. Z menu Personál jde na krok 3 přes lištu; z menu Detail názvy jdete rovnou na seznam boxů (krok 3), ale horní lišta stále umožňuje přejít na rozdělení personálu (krok 1). Bez rozdělení a typů personálu v ceníku boxy s vložit i personál nevyplní správná data.

###### Dva vstupy — jedna obrazovka

###### Seznam detail boxů

Tabulka zobrazuje u každého boxu: název, pořadí (poradi), popis, rozdělení personálu, typ automatického doplnění (technika / mobiliář / personál / text z akce), zda se box v detailu akce zobrazuje nebo skrývá, odkud kopírovat starý obsah. Odkaz Zobrazit vše včetně skrytých boxů (zkryt = 1).

###### Přidat / upravit detail — pole formuláře

Tabulku hodnot rozpis (včetně vložit i personál) najdete v Personál → krok 3.

###### Tok: Detail názvy → akce → infosheet

1. Administrátor v Detail názvy založí boxy (název, rozdělení, rozpis, pořadí).
2. Obchodník v akci vyplní krok Personál — řádky nesou kód rozdělení z ceníku.
3. V záložce Detail u akce systém pro každý box zobrazí textové pole; u rozpis = personál automaticky vypíše řádky se shodným rozdělením.
4. Obchodník zaškrtne Vložit personál do Infosheet u příslušného boxu → uloží se doinfosheet v dovakcedetailvlastni.
5. Tisk Infosheetu (SkladamInfosheet) složí HTML z boxů + zaškrtnutého personálu; infosheetaři (Infosheetáři) akci kontrolují podle těchto výstupů.

flowchart TB
    subgraph Menu["Nastaveni menu"]
        DN["Detail nazvy"]
        PER["Personal krok 3"]
    end
    subgraph Config["detailconfig"]
        DC["dovdetail boxy"]
        DR["dovdetailpersonalu rozdeleni"]
    end
    subgraph Akce["Prace v akci"]
        AP["dovakcepersonal"]
        ADV["dovakcedetailvlastni"]
        DET["Zalozka Detail"]
    end
    subgraph Out["Vystup"]
        IS["Infosheet PDF"]
    end
    DN --> DC
    PER --> DC
    DC --> DR
    DR --> AP
    DC --> DET
    AP --> DET
    DET --> ADV
    ADV --> IS

Podrobně o rozdělení, ceníku typů a osobách: Personál — kompletní popis. Vyplnění detailu obchodníkem: kapitola 15 — záložka Detail, vkládání personálu: kapitola 14.

###### Infosheetáři :)

Seznam uživatelů s rolí infosheetař — osoby, které u akcí kontrolují a potvrzují vybrané položky (prostory, služby, personál…) podle pravidel organizace. Přidání / úprava jako u běžných uživatelů, jen s jiným typem účtu.

###### Programy, okruhy

Číselník programů a okruhů pro evidenci vstupů, prodeje vstupenek nebo vazbu na dopravu / akce (podle vašeho provozu — např. kulturní program, okruh prohlídky).

###### Colosseum

Modul ve složce Colosseum (položka v Nastavení, role t) stahuje z pokladního systému Colosseum prodeje vstupenek, plateb a související položky, ukládá je do databáze DOVIS - ISKASA a zobrazuje přehledy návštěvnosti a tržeb. Souvisí s číselníkem Programy, okruhy a s krokem u akce Colosseum (spárování akce na konkrétní prodej / ID vstupenky), pokud má organizace modul zapnutý.

Kdy modul vidíte: Jen pokud je v konfiguraci nájemce zapnutý příznak Colosseum. V menu akce se pak objeví krok pro spárování; bez něj zůstane akce bez vazby na pokladnu.

###### Obrazovky modulu (horní lišta)

Po otevření Nastavení → Colosseum přepínáte obrazovky odkazy nahoře (název se může mírně lišit):

###### Synchronizace dat (jak to funguje)

1. Colosseum API — externí pokladní systém vrací prodeje za zvolené období (omezení: typicky ne častěji než jednou za 10 minut).
2. Import do DOVIS - ISKASA — na pozadí běží import (SOAP/XML), který zapisuje doklady do tabulek sale_documents, položek a plateb.
3. Cache — obrazovka Seznam prodejů počítá denní a měsíční součty do cache (colosseum_den_prodej, colosseum_mesic_prodej…), aby KPI a přehledy byly rychlé.
4. Přepočet — při změně filtru nebo parametru ulož KPI se cache pro období smaže a znovu spočítá (může trvat déle u širokého rozsahu).

flowchart LR
    API["Colosseum API"] --> IMP["Import do DB DOVIS - ISKASA"]
    IMP --> RAW["sale_documents polozky platby"]
    RAW --> SEZ["Seznam prodeju prepocet cache"]
    SEZ --> KPI["KPI a prehledy"]
    SEZ --> AKCE["Spárování s akcí"]

###### Seznam prodejů — ovládání

• Měsíc a rok — stejný filtr období jako jinde v DOVIS - ISKASA (změna rovnou odešle formulář).
• Cenová kategorie — filtr podle číselníku colosseum_cenove_kategorie (např. typ vstupenky, kino, skupinová…).
• Okruh — volitelný filtr kódu položky / okruhu.
• Tabulka — po dnech: počet vstupenek, rozdělení plateb (hotově, kartou, online…), zboží bez DPH; součty po týdnech a měsících.
• Grafy — pod tabulkou kombinovaný graf a koláč (Google Charts).
• Export XLS — export zobrazené tabulky pro účetní / vedení.
• Přepočet cache — pokud čísla nesedí, spusťte přepočet období (parametr pro vynucení přepočtu KPI cache — obvykle tlačítko nebo odkaz s označením uložení KPI).

Na nástěnce manažera box Colosseum zobrazuje detailní pohled (den/týden/měsíc); v Globálním souhrnu financí je Colosseum vždy jeden řádek — součet bez DPH jen za období z filtru nástěnky (ODxx–DOxx), ne za celý rok jako měsíční pohled v tomto boxu.

###### Úvodní obrazovka Colosseum

• Vypsat údaje (výchozí) — zobrazí denní rozpis (aktuální týden), měsíční a roční souhrn z cache; klik na datum otevře Seznam prodejů za daný měsíc.
• Načíst data + Hledej — ruční import z Colosseum za zvolené období (iframe s průběhem); použijte po výpadku sync nebo pro doplnění minulých dnů (respektujte limit API).
• Odkaz Sync — stránka pro automatickou synchronizaci a nastavení plánovače úloh Windows (min. interval 10 min).

###### Vazba na akci v DOVIS - ISKASA

U akce s zapnutým Colosseum — podrobný postup: kapitola 7b.

• V horním menu kroků akce je položka Colosseum (step25, spárování).
• Obchodník vybere konkrétní prodej z nabídky — do akce se uloží id_colosseum a souhrn jde do objednávky.
• Na Základní info je pole ID COLOSSEUM a volba zařadit v objednávce … (dva sloupce vedle sebe).
• Bez spárování (id_colosseum = 0) systém upozorní, že akce není navázaná na prodej v pokladně.

flowchart TD
    A["Zalozeni akce s modulem Colosseum"] --> B{"Krok Colosseum u akce"}
    B --> C["Vyber prodeje z Colosseum"]
    C --> D["id_colosseum v akci"]
    D --> E["Prehledy trzeb a navstevnosti"]
    E --> F["KPI organizace"]

Provozní limity: Colosseum API nepřijímá dotazy častěji než cca 10 minut — plánovač sync nastavte s intervalem ≥ 10 min. Příliš široké období na Seznamu prodejů může dlouho běžet (systém prodlužuje čas skriptu); pro velké rozsahy raději po měsících.

Tip: Pro běžnou kontrolu používejte Seznam prodejů + KPI. Ruční Načíst data na úvodní obrazovce jen když sync nestačil nebo chybí dny v cache.

##### Importy a údržba

###### Import akcí

Speciální nástroj pro přenos akcí mezi dvěma instancemi DOVIS - ISKASA (označení DOV / DOV2) — typicky při sdílení dat mezi nájemci nebo testovací a produkční prostředí. Pouze administrátor.

###### Import FA

Obrazovka Import z PREMIER — faktury přijaté, vydané (položka Nastavení → Import FA, role t; obchodník b má přístup k seznamům faktur, ne k importu z API). Stahuje data z účetního systému PREMIER přes JSON rozhraní a ukládá je do tabulek DOVIS - ISKASA (premier_fa_in, premier_fa_out, premier_fa_zout, položky faktur včetně CENA). Tato data pak používají Energie → Import měření, nástěnka manažera (částky bez DPH z položek), KPI faktur a kontrola plateb.

Směr dat: Import FA = PREMIER → DOVIS - ISKASA (faktury). Opačný směr DOVIS - ISKASA → PREMIER (objednávky) probíhá při fakturaci akce nebo exportu z modulu Žádanky — to není totéž jako tato obrazovka.

###### Horní lišta a KPI faktur

Nahoře na stránce:

• Import z PREMIER — hlavní formulář importu a seznamů.
• KPI faktury → Přijaté — roční přehled přijatých faktur (částky, úhrady, zbývá doplatit).
• Vydané — stejně pro vydané faktury.
• Souhrn — kombinovaný roční pohled přijaté + vydané.

###### Filtry formuláře (před Hledej)

###### Režimy v poli „vyberte co …“

###### Typický postup — import přijatých faktur

1. Ověřte, že je v systému nastaveno připojení k PREMIER (adresa, port, UJID — konfiguruje superadmin / účetní).
2. Zvolte období a rok (např. měsíc, za který dorazily faktury od dodavatelů).
3. V poli režimu zvolte Fa přijaté import a klikněte Hledej.
4. Počkejte na dokončení (u většího období může běh trvat dlouho — systém prodlužuje čas skriptu).
5. Přepněte na Fa přijaté seznam, zkontrolujte faktury; filtr vyber energie použijte pro energie před zápisem do Evidence energie.

flowchart LR
    subgraph PREMIER["Účetní systém PREMIER"]
        API["JSON API faktury"]
    end
    subgraph DOVIS["DOVIS -"]
        ISKASA["DOVIS - ISKASA Import FA"]
        IMP["Import přijaté / vydané"]
        DB["(premier_fa_in premier_fa_out)"]
        SEZ["Seznamy a filtry"]
    end
    subgraph Pouziti["Použití dat"]
        EN["Energie Import měření"]
        KPI["KPI faktury roční"]
        NAST["Nástěnka Fakturace PREMIER"]
        ZAD["Žádanky náklady"]
    end
    API --> IMP --> DB --> SEZ
    DB --> EN
    DB --> KPI
    DB --> NAST
    DB --> ZAD

###### Tři fáze importu přijatých faktur

1. Fáze 1 — hlavičky — stažení seznamu faktur (doklad PF) za období, INSERT nebo UPDATE v premier_fa_in (číslo, dodavatel, IČO, zakázka, středisko, objednávka, dodací list, částky, splatnost…).
2. Fáze 2 — úhrady — doplnění úhrad a zbývající částky k zaplacení podle stavu v PREMIER.
3. Fáze 3 — položky — načtení řádků faktur (položky materiálu / služeb) do premier_fa_in_polozky pro detail a párování (energie, náklady).

Automatická synchronizace přijatých faktur může běžet na pozadí (plánovač úloh volá sync za posledních N měsíců) — obdoba ručního importu bez nutnosti otevírat formulář.

flowchart TD
    START["Fa přijaté import + Hledej"] --> F1["Fáze 1 hlavičky premier_fa_in"]
    F1 --> F2["Fáze 2 úhrady"]
    F2 --> F3["Fáze 3 položky faktur"]
    F3 --> SEZ["Fa přijaté seznam"]
    SEZ --> EN{"Energie 5021-5024?"}
    EN -->|Ano| ZAP["Zapsat do měření v Energii"]
    EN -->|Ne| NAK["Náklady KPI nástěnka"]

###### Seznam faktur — sloupce a práce

V seznamu přijatých / vydaných faktur typicky vidíte:

• Dodavatel / odběratel — název a IČO.
• Zakázka, středisko — vazba na účetní dimenze PREMIER.
• Dod. list, Objednávka — klíč pro párování s měřidlem (EAN / objednávka) nebo žádankou.
• Vystaveno, Celkem, Uhradit, Zaplaceno, Úhrada, Prodlení — stav plateb a splatnosti.

Při výběru konkrétního dodavatele (filtr IČO / název) systém může doplnit detail úhrad a položek faktury.

###### Export DOVIS - ISKASA → PREMIER (opačný směr)

Do PREMIER se z DOVIS - ISKASA odesílají např.:

• Objednávky z modulu Žádanky — po vyřízení nákupu export do účetnictví.
• Objednávky k akci — při fakturačním workflow akce (propojení s číslem objednávky na faktuře).

Pro správný export musí být v PREMIER nastavené číselníky, DPH sazby a mapování kontaktů — konfiguraci řeší účetní / superadmin.

###### Kde se importované faktury použijí

Bez nastavení PREMIER import neběží: Chybí-li adresa serveru, port nebo UJID, zobrazí se hláška a fáze se nespustí. Import vyžaduje běžící PREMIER API ve vaší síti.

Tip: Nejprve import za období, poté seznam a filtry. Pro energie vždy zkontrolujte pole Objednávka / Dod. list proti měřidlům v Umístění měření, jinž zápis do evidence selže.

###### Údržba dat

Položka Údržba dat v menu Nastavení (role t) otevře obrazovku compress— hromadnou kompresi JPEG fotografií v centrálním úložišti souborů DOVIS - ISKASA (typicky složka /!files/ a všechny podadresáře). Používá se po nahrání většího množství fotek z akcí, expozic nebo dokumentace, když roste obsazenost disku.

K čemu slouží: Projde rekurzivně úložiště souborů, najde soubory .jpg / .jpeg / .jpe větší než nastavenou hranici a zmenší je přepočítáním JPEG (nižší kvalita = menší soubor). Menší soubory se přeskakují. Operace může trvat dlouho — nechte okno prohlížeče otevřené do konce.

###### Dvě cesty komprese (stará a nová)

Systém podporuje dva způsoby komprese. Primární je původní komponenta v IIS; pokud na serveru nefunguje, nabídne se záložní cesta přes PHP.

Schéma rozhodování při spuštění komprese:

flowchart TD
    START["Admin otevře compress"] --> TEST{"AspJpeg funguje?"}
    TEST -->|Ano| ASP["Komprese pres Persits AspJpeg"]
    TEST -->|Ne chyba COM| FALL["Modry box Alternativa bez AspJpeg"]
    FALL --> BTN["Klik Spustit kompresi pres PHP"]
    BTN --> PHP["compress + jpegoptim CLI"]
    ASP --> SCAN["Rekurzivne !files a podadresare"]
    PHP --> SCAN
    SCAN --> FILTER{"Soubor JPG a vetsi nez limit?"}
    FILTER -->|Ano| CMP["Prekodovani JPEG"]
    FILTER -->|Ne| SKIP["Preskoceno"]
    CMP --> OK["Tecka v prubehu"]
    CMP --> ERR["Vykricnik pri chybe"]

###### Nastavení (GLOBAL)

Parametry komprese se nastavují v souboru GLOBAL na serveru (Application proměnné). Po změně je potřeba recycle Application Pool v IIS. PHP záloha načte stejné hodnoty z exportu !DATA/compress_runtime (vytvoří se při otevření compress).

###### Volba kvality komprese

Pozor: Komprese přepisuje původní soubory (záloha se nevytváří). Před prvním hromadným během na produkci vyzkoušejte na kopii složky nebo na několika souborech. Po změně kvality v GLOBAL jednou otevřete compress, aby se obnovil export pro PHP.

###### Typický postup administrátora

1. Přihlaste se jako administrátor (role t).
2. V levém menu otevřete Nastavení → Údržba dat (nebo přímo compress).
3. Na stránce uvidíte parametry: cílová složka, kvalita %, min. velikost v B.
4. Spuštění proběhne automaticky — v logu uvidíte řádky podle podadresářů.
5. Sledujte průběh: tečka = soubor OK, vykřičník = chyba u souboru (tooltip s popisem).
6. Po dokončení se zobrazí souhrn: nalezeno / zkomprimováno / přeskočeno / chyby.

###### Cesta 1 — AspJpeg (původní)

Pokud je na serveru nainstalovaná komponenta Persits AspJpeg, komprese proběhne ihned bez dalšího kroku.

• Komponenta musí odpovídat bitovosti IIS (32-bit vs 64-bit App Pool).
• Při chybě AspJpeg se nepodařilo spustit (COM, licence) se zobrazí návod na IIS a pod ním modrý box s tlačítkem PHP.
• Stejná komponenta se používá i při nahrávání / zmenšování obrázků v jiných částech DOVIS (např. generování miniatur).

###### Cesta 2 — PHP + jpegoptim (záloha)

Použijte, když AspJpeg na serveru nejde spustit (typicky migrace IIS na 64-bit bez 64-bit licence Persits).

1. Na stránce compress po chybě AspJpeg klikněte na modré tlačítko Spustit kompresi přes PHP (jpegoptim).
2. Otevře se compress s jednorázovým autorizačním tokenem (platnost cca 1 hodinu).
3. Neotevírejte compress ručně z adresní řádky — vždy přes tlačítko z compress.
4. Průběh a souhrn vypadají stejně jako u ASP verze.

Požadavky na server pro PHP cestu (řeší správce IT, ne běžný uživatel):

• PHP na IIS (FastCGI) — v projektu DOVIS je připraven web.config a !DATA/php-iis/php.
• Program jpegoptim ve složce !tools/jpegoptim/ (portable, bez instalátoru).
• V PHP povolená funkce exec() a právo App Poolu spouštět jpegoptim a zapisovat do !files/.

Tok dat u záložní PHP cesty:

flowchart LR
    subgraph ASP["compress"]
        G["GLOBAL parametry"]
        TOK["Autorizacni token"]
        JSON["compress_runtime"]
    end
    subgraph PHP["compress"]
        VAL["Overeni tokenu"]
        JO["jpegoptim --max=kvalita"]
    end
    subgraph Disk["Uloziste"]
        FILES["!files rekurze"]
        AUTH["!files KodU compress_auth"]
    end
    G --> TOK
    G --> JSON
    TOK --> AUTH
    JSON --> VAL
    VAL --> JO
    JO --> FILES

###### Co se komprimuje a co ne

###### Časté problémy

Tip: Údržbu dat spouštějte mimo špičku (večer / víkend). Po velkém importu fotografií z akce nejdřív zkontrolujte, kolik souborů je nad limitem velikosti, a až potom spusťte celou rekurzi. Pro běžnou práci s jednotlivými fotkami v akci stačí automatické zmenšení při nahrání — hromadná komprese je doplněk pro úklid starého archivu.

###### Související místa v DOVIS

• Nahrání fotek k akci — menší verze vznikají už při uploadu (AspJpeg / resize); údržba dat řeší celé úložiště najednou.
• Logolinky (Nastavení → Logolinky) — loga partnerů; komprese se týká hlavně fotodokumentace v !files.
• Superadmin — globální šablony a uživatelé; parametry komprese mění admin s přístupem k GLOBAL na serveru.

##### Modul lektora (role u) — pokud je zapnutý

Tyto položky v Nastavení hlavního modulu DOVIS - ISKASA odpovídají stejným číselníkům v aplikaci Denio (služby a pomůcky s příznakem denio):

• Školní pomůcky — pomůcky k vybraným lekcím / programům.
• Kategorie předmětů — členění školních předmětů.
• Seznam plateb — platební metody za programy a výuku.

flowchart TD
    A["Admin upravi ceník v Nastaveni"] --> B["Obchodnik otevře akci"]
    B --> C["Vybere polozku ze Seznam nove"]
    C --> D["System nacte ceny z ceníku"]
    D --> E["Bilance a KPI akce"]

Tip: Tiskové podpoložky (… tisk) nemění data — jen vytisknou aktuální ceník. Pro změnu ceny vždy otevřete hlavní položku (např. Prostory, ne Prostory tisk).

Dvě úrovně menu: Toto levé menu je navigace celého DOVIS - ISKASA. Až otevřete konkrétní akci, objeví se navíc horizontální menu kroků (Info, Základní info, Prostory…) — popis v kapitole 6.

flowchart TD
    L["Levé menu"] --> A["Akce: nová přehled seznam"]
    L --> K["Kalendáře: prostory osoby zasedačka"]
    L --> S["Statistiky: KPI náklady"]
    L --> M["Moduly: aplikace Raynet HR"]
    L --> N["Nastaveni: ceniky a ciselniky"]
    N --> A
    A --> D["Detail akce"]
    D --> H["Horní menu kroků"]

Co použít nejčastěji

• Nová akce nebo Seznam akcí → založení a úprava akcí.
• Přehled akcí → rychlý pohled na vytížení termínů.
• Kalendáře — akce, prostory, personál, týden, zaměstnanci, auta (zoom, tisk; auta jen při AutaOK).
• Přehled prostory / Týden / zasedačka → volné místnosti.
• Kontakty → škola před akcí (Denio) nebo klient (obchod).
• KPI → statistiky (vedení); Seznamy → tisky ceníků.
• Kalendář zaměstnanců → dovolené a absence (ne akce).