Coca-Cola export (COCCZ)

Modul slouží k přípravě a odeslání denního datového exportu pro Coca-Cola HBC Connector Platform. Jednou za den se z vašich vydaných dokladů (faktur nebo dodacích listů) sestaví čtyři datové zprávy — zákazníci (CUS), produkty (PRO), prodeje (SAL) a stav zásob (STO) — a odešlou se přes zabezpečené FTPS připojení na server výrobce. Modul si drží vlastní "staging" kopii dat, takže si před odesláním můžete obsah zkontrolovat, případně chybný řádek odebrat, aniž byste zasahovali do původních faktur či dodacích listů.

Jeden doklad COCCZ odpovídá vždy jedné firmě a jednomu kalendářnímu dni exportu — na stejný den nelze založit druhý export.

Jak se do modulu dostat

Menu → Coca-Cola export (COCCZ). Otevře se seznam všech dosavadních denních exportů; kliknutím na řádek se otevře karta konkrétního dne se záložkami Prodeje, Zákazníci, Produkty a Sklady.

Jak na časté úkoly

Zpracovat běžný denní export

Standardní denní rutina — vytvoří obsah exportu z dokladů vystavených daný den a odešle ho výrobci.

1. V seznamu klikněte na Nový export. Systém rovnou předvyplní datum dnešním pracovním dnem, pobočku (BRANCH_ID) a identifikaci výrobce podle toho, co je nastavené v Nastavení modulu.
2. Uložte kartu (tlačítko Uložit) — tím doklad reálně vznikne v seznamu.
3. Na kartě klikněte na Generovat obsah. Systém prohledá vaše faktury nebo dodací listy (podle toho, co je v Nastavení zvolené jako Zdroj prodejů (SAL)) vystavené k datu exportu a naplní záložky Zákazníci, Produkty, Prodeje a Sklady.
4. Projděte si záložku Prodeje (SAL) — zkontrolujte počty a všimněte si, zda se po generování nezobrazilo upozornění o přeskočených anonymních prodejích (prodejích bez přiřazeného zákazníka).
5. Klikněte na Odeslat FTPS. Systém znovu sestaví XML zprávy přímo ze staging dat (ne z faktur), odešle je na server Connector Platform a stav dokladu se změní na Odesláno.

Co se stane potom: doklad dostane vyplněné datum a čas odeslání (Odesláno v), jeho stav se uzavře (odpovídá příznaku „s_fin" v číselníku stavů) a další generování, mazání položek i opětovné odeslání už nejsou možné — datový export daného dne je považován za hotový.

Časté chyby: kliknutí na Odeslat FTPS bez předchozího Generovat obsah odešle prázdné nebo neaktuální zprávy — vždy generujte obsah těsně před odesláním, ne o den dříve.

Opravit chybu při odesílání (stav Chyba)

Když FTPS server přenos odmítne (výpadek, špatné heslo, plný adresář…), doklad zůstane otevřený a lze ho poslat znovu bez ztráty dat.

1. V seznamu poznáte problém podle barevného stavu Chyba ve sloupci Stav; na kartě se navíc pod polem Poznámka zobrazí červené hlášení s konkrétní chybou (text výjimky z FTPS spojení).
2. Přejděte do Nastavení a opravte FTPS údaje (server, port, uživatel, heslo, vzdálený adresář).
3. Ověřte spojení tlačítkem Test připojení — jen zkouší přihlášení a výpis adresáře, nic neodesílá.
4. Vraťte se na kartu exportu a klikněte znovu na Odeslat FTPS. Protože staging data (záložky CUS/PRO/SAL/STO) z předchozího generování zůstala zachována, není potřeba klikat na Generovat obsah znovu — pokud mezitím nepřibyly další doklady k zahrnutí.

Co se stane potom: při úspěchu se chybové hlášení smaže, doplní se Odesláno v a doklad se uzavře stejně jako v běžném scénáři.

Zkontrolovat a opravit data před odesláním

Staging tabulky nejsou jen náhled — dají se v nich jednotlivé řádky odebrat, než se export odešle.

1. Po Generovat obsah otevřete záložku Prodeje (SAL). U každého řádku prodeje je ve sloupci Doklad č. proklik, který otevře zdrojovou fakturu nebo dodací list v novém okně — snadno tak dohledáte, odkud konkrétní řádek pochází.
2. Pokud narazíte na řádek, který do exportu nepatří (např. testovací doklad), smažte jej přímo v gridu. Nové řádky ručně přidat nelze — vznikají výhradně generováním.
3. Pokud potřebujete přepočítat vše od začátku (např. jste opravili fakturu po prvním generování), klikněte znovu na Generovat obsah — staging se nejprve celý vyprázdní a naplní znovu, ručně smazané řádky se tak vrátí, pokud stále odpovídají zdrojovým dokladům.
4. Teprve po kontrole klikněte na Odeslat FTPS.

Častá chyba: ruční smazání řádku a následné opětovné kliknutí na Generovat obsah — oprava se tím ztratí, protože generování je vždy úplný přepočet od nuly.

Nastavit modul pro novou firmu (administrátorský úkol)

Než lze cokoliv generovat nebo odesílat, musí být vyplněné Nastavení COCCZ pro danou firmu.

1. V seznamu klikněte na tlačítko Nastavení (ozubené kolo v nástrojové liště).
2. Vyplňte FTPS připojení: FTPS server, Port (výchozí 21), Uživatel, Heslo a Vzdálený adresář (výchozí /).
3. Vyplňte identifikaci distributora: Pobočka (BRANCH_ID), PRODUCER_ID a PRODUCER_NAME (výchozí hodnota „COCCZ", pokud výrobce nepředepíše jinak).
4. Vyberte Výrobce (dodavatel CC) — konkrétní záznam z modulu Partneři, který v ceníku figuruje jako dodavatel produktů Coca-Cola. Bez tohoto výběru generování obsahu skončí chybou, protože systém potřebuje vědět, které položky ceníku do exportu vůbec patří.
5. Zvolte Zdroj prodejů (SAL) — odkud se mají brát prodejní řádky: Dodací listy, nebo Faktury.
6. Otestujte spojení tlačítkem Test připojení ještě před tím, než necháte modul cokoliv odesílat.
7. Uložte tlačítkem Uložit.

Co se stane potom: nastavení se použije při každém dalším Nový export (předvyplnění pobočky a výrobce) i při každém Generovat obsah (výběr zdroje prodejů a producenta v ceníku).

Past: heslo se při uložení vždy zašifruje a při dalším otevření formuláře se nezobrazuje — pole necháte prázdné, pokud chcete zachovat stávající heslo; vyplníte ho, jen když ho měníte.

Stáhnout XML zprávu bez odeslání

Užitečné pro ruční kontrolu obsahu zprávy nebo když potřebujete soubor předat podpoře výrobce, aniž byste znovu odesíleli na Connector Platform.

1. Na kartě exportu (musí mít vygenerovaný obsah) klikněte na jedno z tlačítek CUS / PRO / SAL / STO v nástrojové liště karty.
2. Prohlížeč stáhne příslušný XML soubor pojmenovaný podle typu zprávy, pobočky a data exportu (např. SAL_1234_2026-07-22.xml).

Co se stane potom: nic se neodesílá ani neukládá — jde o čistě lokální export aktuálního obsahu staging tabulek do souboru, stav dokladu se nemění. Dostupné i k dokladu, který je již uzavřený (odeslaný).

Hromadně změnit stav nebo barevně označit více exportů

Pro rychlou orientaci v delší historii exportů (např. při měsíční uzávěrce).

1. V seznamu zaškrtněte více řádků exportů.
2. V liště hromadných akcí zvolte Změna stavu a konkrétní cílový stav, nebo Barevné označení a jednu z barev (zelená, žlutá, jantarová, fialová), případně zrušit označení.
3. Potvrďte provedení akce.

Poznámka: barevné označení řádků v seznamu je čistě orientační štítek pro uživatele a nijak neovlivňuje stav s_fin ani možnost doklad dál generovat či odeslat — na rozdíl od sloupce Stav, který skutečně řídí, co s dokladem ještě lze dělat.

Založit export na den, který už existuje

Modul aktivně brání duplicitám — na jeden den a firmu smí existovat jen jeden doklad COCCZ.

1. Kliknete-li na Nový export v den, pro který export už existuje, zobrazí se hláška Export pro tento den již existuje a nový doklad se nezaloží.
2. Požadovaný den najděte přímo v seznamu (řazeno defaultně od nejnovějšího data) a otevřete existující záznam.

Časté chyby: opakované klikání na Nový export při zpracování více poboček se stejným datem — pobočka (BRANCH_ID) je jen textové pole na dokladu, ale uniknost hlídá kombinace firma + datum exportu, ne pobočka; pro více poboček téže firmy a dne je potřeba řešit situaci jinak (např. samostatnou firmou v systému), export sám o sobě druhou pobočku pro stejný den nepovolí.

Nechat proběhnout automatický noční export

Pokud je v Nastavení zapnutá volba Povolen automatický denní export, nemusí uživatel do modulu vůbec zasahovat.

Co se stane: na pozadí se pro daný den automaticky založí doklad (pokud ještě neexistuje), vygeneruje se obsah a odešle se na FTPS — stejný postup, jaký by jinak uživatel udělal ručně přes Generovat obsah a Odeslat FTPS. Pokud už byl doklad daného dne jednou úspěšně odeslán (stav Odesláno), automatika ho přeskočí. Pokud předchozí pokus skončil chybou, zkusí ho odeslat znovu, ale obsah negeneruje podruhé, pokud už jednou vygenerován byl.

Kdy zasáhnout ručně: pokud chcete mít jistotu, že export obsahuje i doklady vystavené později večer, nebo pokud chcete stav a obsah zkontrolovat před odesláním, nechte volbu vypnutou a zpracovávejte export ručně podle scénáře výše.

Přehled seznamu

Seznam zobrazuje jeden řádek za každý den, pro který byl export založen.

Filtry: rychlé textové hledání podle pobočky a poznámky, plošné filtry podle stavu v horní liště seznamu. Hromadné akce nad zaškrtnutými řádky: vymazat, změna stavu a barevné označení — viz scénář „Hromadně změnit stav nebo barevně označit více exportů" výše.

Formulář

Záložka karta

Hlavičkové údaje jednoho dne exportu.

Export za den (povinné, needitovatelné datum založení) – den, za který se export sestavuje. Kdy: nastavuje se při založení podle pracovního data a dále se needituje jako běžné pole (mění se jen založením nového dokladu na jiný den). Následek: toto datum určuje, které doklady (faktury/dodací listy) se při generování obsahu vezmou v úvahu — berou se jen ty vystavené přesně k tomuto dni.

Stav (povinné) – aktuální fáze zpracování exportu (číselník stavů COCCZ). Kdy: běžně ho měníte jen výjimečně ručně (např. hromadnou akcí); systém ho sám posouvá při Generovat obsah (na „rozpracováno") a při úspěšném Odeslat FTPS (na uzavírací stav). Následek: jakmile má stav příznak uzavření („s_fin"), přestávají fungovat Generovat obsah, mazání položek i Odeslat FTPS — doklad se chová jako uzavřený, i když modul nemá klasické tlačítko Zamknout.

Pobočka (BRANCH_ID), PRODUCER_ID, PRODUCER_NAME – identifikační údaje distributora a výrobce, jak je vyžaduje formát zprávy Connector Platform. Kdy: při založení se předvyplní z Nastavení modulu, měnit je ručně na kartě dává smysl jen výjimečně (např. jednorázová odchylka pro konkrétní den). Následek: hodnoty se doslovně promítnou do atributu BRANCH_ID/PRODUCER_ID/PRODUCER_NAME ve všech čtyřech odesílaných XML zprávách.

Poznámka – volný text pro interní potřebu, neexportuje se.

Průběh exportu (needitovatelné, zobrazí se jen u existujícího dokladu): zde se objeví štítek s časem generování, štítek s časem odeslání a případně červené hlášení poslední chyby FTPS odeslání — rychlý přehled bez nutnosti otevírat jiné záložky.

Záložka Prodeje (SAL)

Řádkové položky prodeje (zpráva SAL) — jedna z nejdůležitějších záložek, otevírá se jako výchozí. Sloupce: CUSTOMER_ID, Zdroj (typ zdrojového dokladu — Faktura / Faktura vratka / Dodací list / Dodací list vratka), Doklad č. (proklik na zdrojový doklad v novém okně), ITEM (pořadí v rámci zdrojového dokladu), PRODUCT_ID, MJ, Množství, Objem (VOL) (přepočtený objem, jen pokud má produkt v ceníku vyplněný objem) a FIELD_1. Vratky se do množství promítají jako záporná hodnota. Řádky vznikají pouze generováním, ručně lze jednotlivý řádek jen smazat (dokud doklad není uzavřený), ne přidat ani upravit jeho hodnoty.

Záložka Zákazníci (CUS)

Zákazníci, kteří v aktivním okně (posledních cca 6 měsíců/183 dní zpětně od data exportu) nakoupili produkty daného výrobce. Sloupce: CUSTOMER_ID, Název, Město, PSČ, Ulice, Země, IČO (TIN), Aktivní. Slouží jako zdroj dat pro zprávu CUS (adresa a identifikace odběratele); vzniká výhradně generováním.

Záložka Produkty (PRO)

Produkty daného výrobce z ceníku — aktivní produkty vždy, neaktivní jen pokud se v aktivním okně prodaly. Sloupce: PRODUCT_ID, Kód výrobce, EAN (pokud v ceníku chybí, doplní se náhradní kód samými nulami dle specifikace Connector Platform), Název, MJ, Aktivní, MULTIPLIER, MULTIPLIER_VOL (přepočtový koeficient objemu, dopočítaný z objemu a měrné jednotky v ceníku). Vzniká výhradně generováním.

Záložka Sklady (STO)

Aktuální stav zásob produktů daného výrobce, sečtený napříč všemi sklady k okamžiku generování (nejde o historický stav k datu exportu, ale o aktuální skladovou zásobu v době kliknutí na Generovat obsah). Sloupce: PRODUCT_ID, Datum stavu, Stav zásob, MJ. Vzniká výhradně generováním.

Akce a tlačítka na dokladu

Technická poznámka: v systému existuje ještě funkce pro smazání celého vygenerovaného obsahu bez opětovného generování, aktuální rozhraní k ní ale nenabízí žádné tlačítko — prakticky se stejného výsledku dosáhne opakovaným kliknutím na Generovat obsah (nejprve smaže, pak znovu naplní).

Mazání a omezení

• Kopírování dokladu je u tohoto modulu vypnuté — v seznamu ani na kartě nenajdete tlačítko Kopírovat. Dává to smysl: kopie by kolidovala s pravidlem jeden export na den a firmu.
• Číselnou řadu modul nemá — doklady se nečíslují, identifikují se kombinací firmy a data exportu.
• Zamykání dokladu (obecný zámek systému) modul nepoužívá — nenajdete tlačítko Zamknout/Odemknout ani filtr na zamčené doklady. Roli uzavření místo toho plní stav s příznakem „s_fin" (typicky stav Odesláno): jakmile ho doklad má, blokuje se Generovat obsah, mazání staging řádků, mazání celého dokladu i Odeslat FTPS s hláškou „Doklad je uzavřen…".
• Smazání celého dokladu je možné jen dokud není uzavřený; u uzavřeného dokladu se smazání odmítne hláškou „Doklad je uzavřen, mazání není možné".
• Hromadné mazání v seznamu je k dispozici stejně jako u ostatních modulů (vyžaduje právo „mazat").

Tisk a export

• CUS / PRO / SAL / STO — čtyři samostatná tlačítka na kartě stáhnou aktuální obsah dané staging tabulky jako XML soubor ve formátu vyžadovaném specifikací Connector Platform [COCCZ] verze 5.0 (hodnoty jako XML atributy, prázdné volitelné atributy se vůbec neuvádí). Soubory jsou pojmenované TYP_pobočka_datum.xml.
• Odeslat FTPS — sestaví stejné čtyři soubory a nahraje je přes zabezpečené FTPS (explicitní TLS, port 21, pasivní režim) do vzdáleného adresáře nastaveného v Nastavení modulu, pod stejným jmenným vzorem.
• Modul má k dispozici i tiskový souhrn dne (přehled počtu položek v CUS/PRO/ SAL/STO a souhrn prodejů a skladů podle produktu) v rámci standardní tiskové funkce systému — slouží jako interní kontrolní sestava, ne jako soubor pro Connector Platform.

Vazby na jiné moduly

COCCZ nestojí sám: bere produkty a jejich přepočtové koeficienty z Ceníku (jen položky, kde je jako výrobce nastavený partner zvolený v poli Výrobce (dodavatel CC)), bere prodejní řádky z Faktur vydaných nebo Dodacích listů (podle volby Zdroj prodejů (SAL) v Nastavení) vystavených k datu exportu, bere adresy zákazníků z Partnerů (adresní kniha) a bere aktuální skladové zásoby ze Skladu. Konfigurace výrobce jako dodavatele (Výrobce (dodavatel CC)) se vybírá přímo z modulu Partneři. Samotný COCCZ žádné navazující doklady v jiných modulech nevytváří — je to koncový, jednosměrný export dat ven ze systému.

Oprávnění

Rozhodovací vodítka

Zdroj prodejů (SAL): Dodací listy vs. Faktury

• Dodací listy – zvolte, pokud firma fakturuje souhrnně (např. jednou za týden/měsíc) a skutečný fyzický odběr zboží zákazníkem odpovídá dodacím listům, ne datu faktury.
• Faktury – zvolte, pokud se fakturuje k datu dodání a faktura je jediným dokladem o prodeji (typicky menší firmy bez samostatných dodacích listů).
• Volba je společná pro celou firmu a mění, odkud se berou řádky pro zprávu SAL i které partnery/produkty generátor vyhodnotí jako „aktivní" pro záložky CUS a PRO — po změně volby proto doporučujeme obsah znovu vygenerovat.

Ruční odeslání vs. automatický denní export

• Ruční (volba v Nastavení vypnutá) – použijte, když chcete mít kontrolu nad obsahem před odesláním nebo když čas odeslání potřebujete přizpůsobit provozu (např. až po uzávěrce pokladny).
• Automatický (volba zapnutá) – použijte, když je zdroj dat stabilní a není potřeba obsah před odesláním kontrolovat; ušetří každodenní ruční krok, ale chybu (např. špatně nastaveného výrobce v ceníku) odhalíte až zpětně podle stavu Chyba v seznamu.

Časté chyby

• Generování obsahu selže s chybou o chybějícím výrobci — v Nastavení není vyplněné pole Výrobce (dodavatel CC); bez něj generátor neví, které položky ceníku do exportu patří.
• Ve staging datech chybí očekávaní zákazníci — prodej proběhl jako anonymní (bez přiřazeného partnera, typicky hotovostní prodej na pokladně); takové řádky generátor záměrně přeskakuje a jejich počet ohlásí ve flash hlášce po generování.
• Odeslat FTPS končí chybou hned na začátku — v Nastavení chybí FTPS server nebo uživatel; ověřte je tlačítkem Test připojení.
• Po opravě faktury se změna neprojevila v exportu — staging data se needitují automaticky podle zdrojových dokladů; je nutné znovu kliknout na Generovat obsah.
• Nelze smazat řádek v záložce Prodeje ani celý doklad — doklad je už uzavřený (odeslaný); u odeslaného exportu lze už jen stahovat XML, ne ho upravovat.

Časté otázky

Lze mít dva exporty pro stejný den? Ne, na den a firmu smí existovat jen jeden doklad COCCZ; druhý pokus o založení systém odmítne.

Můžu opravit fakturu a nechat COCCZ, ať se sám přegeneruje? Ne automaticky — po opravě zdrojového dokladu je potřeba ručně kliknout na Generovat obsah, aby se staging data přepočítala.

Co znamená hláška o přeskočených anonymních prodejích? Jde o prodeje bez přiřazeného zákazníka (např. prodej na pokladně bez zadání odběratele) — specifikace exportu je nepodporuje, proto se do zprávy SAL nezahrnou.

Jde stáhnout XML i po odeslání? Ano, tlačítka CUS/PRO/SAL/STO fungují i u uzavřeného (odeslaného) dokladu — pouze další generování a odeslání už nejsou možná.

Proč nejde doklad zkopírovat jako u jiných modulů? Kopírování je pro tento modul záměrně vypnuté, protože by kolidovalo s pravidlem jeden export na den a firmu.

Tipy a triky

• Než poprvé zapnete automatický denní export, nechte si jeden dva dny běžet proces ručně a zkontrolujte výsledek — snadno tak odhalíte špatně nastaveného výrobce nebo nefunkční FTPS dřív, než se stane rutinou bez dohledu.
• Barevné označení řádků v seznamu využijte pro vlastní organizaci (např. žlutá = čeká na kontrolu, zelená = zkontrolováno) — se stavem exportu se nijak nekříží.
• Odkaz na zdrojový doklad v záložce Prodeje (sloupec Doklad č.) se otevírá v novém okně — je to nejrychlejší způsob, jak ověřit konkrétní řádek prodeje bez opuštění karty exportu.