EET 2.0 pro WooCommerce
Koupit

Zákaznická dokumentace

Nastavení EET 2.0 pro WooCommerce krok za krokem.

Tento návod vás provede přípravou údajů, nastavením pluginu, testováním v Playgroundu i zahájením ostrého provozu. Právní rozsah evidence vždy ověřte pro svůj konkrétní provoz na oficiálním webu EET nebo s odborníkem.

Začít s nastavením →Otevřít podporu

01 · Než začnete

Připravte si přístupy a technické minimum.

Plugin vyžaduje WordPress 6.5 nebo novější, WooCommerce 8.0 nebo novější a PHP 8.1.29 nebo novější. Nastavení provádějte pod účtem s oprávněním spravovat WooCommerce.

Plugin je plně kompatibilní s HPOS (High-Performance Order Storage), moderním úložištěm objednávek WooCommerce. Můžete jej používat jak s HPOS, tak se starším způsobem ukládání objednávek.

Serverové požadavky: PHP musí mít aktivní rozšíření OpenSSL a DOM/libxml. Hosting musí umožňovat odchozí HTTPS spojení s ověřením certifikátu. Pro automatické opakování musí fungovat úlohy na pozadí WordPressu a WooCommerce; u webů s nízkou návštěvností doporučujeme systémový cron. Doporučený limit paměti pro WordPress je alespoň 256 MB.

Rozsah použití

Plugin je určen pro jednoho poplatníka s jedním EIČ a jedním pokladním certifikátem v rámci jedné samostatné instalace WordPressu a WooCommerce. Může evidovat více pokladen a evidenčních jednotek téhož poplatníka. Není určen pro WordPress Multisite, marketplace ani jiné řešení, ve kterém jedna instalace obsluhuje více právně samostatných poplatníků, EIČ nebo pokladních certifikátů.

Co budete potřebovat

  • aktivní roční předplatné EET 2.0 pro WooCommerce a licenční klíč,
  • přístup do portálu MOJE daně a jeho DIS+,
  • EIČ poplatníka, pokladnu a evidenční jednotku,
  • příslušný pokladní certifikát a jeho heslo.

Nejste-li si jisti, zda se evidence týká vašeho typu plateb, ověřte si výklad na stránce Finanční správy. Nastavení pluginu nenahrazuje právní nebo daňové posouzení. Zjistit, jak začít evidovat na eet.gov.cz ↗

02 · Registrace a certifikát

Nejdříve zaregistrujte údaje v systému EET.

Evidenční jednotku a pokladní certifikát nevytváří plugin. Založíte je v prostředí Finanční správy.

  1. Přihlaste se do DIS+

    V portálu MOJE daně se přihlaste do Daňové informační schránky plus a zvolte službu evidence tržeb. Otevřít přihlášení do DIS+ ↗

  2. Založte evidenční jednotku

    V DIS+ uveďte alespoň jednu evidenční jednotku. Její identifikátor následně vložíte do nastavení pluginu.

  3. Vygenerujte pokladní certifikát

    Po založení evidenční jednotky přejděte z DIS+ do certifikační autority CA EET a vygenerujte certifikát pro pokladní zařízení. Přejít na online služby EET ↗

Správné prostředí, správný certifikát

Pro Playground použijte testovací certifikát určený pro toto prostředí. Produkční certifikát patří pouze do nastavení Produkce. Testovací potvrzení není právně platnou evidencí tržby.

03 · Instalace a licence

Aktivujte plugin a připojte předplatné.

  1. Nahrajte a aktivujte plugin

    Ve WordPress administraci otevřete Pluginy, nahrajte ZIP soubor pluginu a aktivujte jej. WooCommerce musí být aktivní dříve než EET 2.0 pro WooCommerce.

  2. Otevřete nastavení EET 2.0

    V levém menu WordPressu přejděte do WooCommerce → EET 2.0.

  3. Aktivujte licenci

    Na kartě Licence a předplatné vložte licenční klíč ze zákaznického účtu. Roční předplatné umožňuje používat funkce pluginu současně až na dvou samostatných instalacích WordPressu, například na produkčním webu a testovacím či stagingovém prostředí. Aktivní licence je nutná pro odesílání tržeb i pro instalaci soukromých aktualizací pluginu; automatické aktualizace jsou dostupné při aktivní licenci.

04 · Nastavení pluginu

Začněte v Playgroundu, produkci zapněte až po ověření.

Základní nastavení

Na kartě Základní nastavení zvolte aktivní prostředí Playground, vyplňte EIČ poplatníka a uložte změny.

Lokalita pro e-shop

Vytvořte lokalitu s vlastním popiskem, identifikátorem pokladny a evidenční jednotkou. Na kartě WooCommerce pak tuto lokalitu vyberte pro e-shopové objednávky.

Certifikáty a zabezpečení

Na kartě Certifikáty a zabezpečení nahrajte soubor .p12 nebo .pfx a zadejte jeho heslo pro odpovídající prostředí. Plugin certifikát a heslo ukládá šifrovaně; ve stejné části uvidíte stav jeho platnosti.

Pravidla automatického odesílání

Na kartě WooCommerce můžete zapnout automatické odesílání e-shopových objednávek. Vyberte současně stavy objednávek, platební metody a lokalitu, která se má použít. Objednávka se odešle až po splnění obou zvolených podmínek.

Automatické odesílání se vztahuje pouze na objednávky vytvořené v e-shopu. Objednávky vytvořené ve správě WordPressu evidujte manuálně. Pokud u způsobilé objednávky chybí datum zaplacení, plugin před odesláním vyžádá manuální potvrzení skutečného data a času tržby.

05 · Testování v Playgroundu

Nejprve ověřte stejné spojení, které použije váš e-shop.

Nechte aktivní prostředí Playground, vložte testovací certifikát a uložte nastavení. Na kartě Testování a protokoly pak použijte Odeslat vzorovou tržbu. Plugin odešle test přes stejnou komunikační cestu jako u objednávky, ale bez vytvoření právně platné evidence.

  1. Zkontrolujte výsledek testu

    V protokolu si ověřte úspěšný stav a POK. Při chybě zkontrolujte, zda spolu odpovídají prostředí, certifikát, EIČ, identifikátor pokladny a evidenční jednotky.

  2. Vyzkoušejte vlastní objednávku

    Vytvořte testovací objednávku s platební metodou a stavem, které jste vybrali pro automatické odesílání. V jejím detailu zkontrolujte metabox EET 2.0, stav evidence a čitelné potvrzení.

  3. Test opakujte po změně údajů

    Změníte-li certifikát, aktivní prostředí, EIČ nebo lokalitu, proveďte test znovu. Testovací potvrzení slouží pouze k ověření technického propojení.

06 · Ostrý provoz

Produkci zapněte až po úspěšném testu.

  1. Vložte produkční údaje

    Nahrajte produkční certifikát, přepněte aktivní prostředí na Produkce a uložte nastavení. Produkční a testovací certifikát nikdy nezaměňujte.

  2. Nastavte okamžik automatického odeslání

    Na kartě WooCommerce vyberte lokalitu, alespoň jeden stav objednávky a alespoň jednu platební metodu. Automatické odeslání proběhne pouze tehdy, když objednávka splní obě vybrané podmínky. Pokud některý výběr chybí, nic se neodešle automaticky.

  3. Ověřte první ostrou objednávku

    Po první evidované objednávce otevřete její detail a zkontrolujte stav, POK a potvrzení. Je to praktická kontrola nastavení; nenahrazuje posouzení vašich zákonných povinností.

Platnost certifikátu

Na kartě Certifikáty a zabezpečení plugin zobrazuje platnost uložených certifikátů. Můžete zapnout denní kontrolu a automatickou obnovu přes oficiální rozhraní CA EET. Obnova certifikátu je možná jen před skončením platnosti; po jejím vypršení je potřeba vystavit nový certifikát. Výsledek obnovy najdete v historii na kartě Testování a protokoly.

07 · Manuální odeslání a opakování

Manuální odeslání a opakování řešíte samostatně u objednávky.

Manuální odeslání zůstává k dispozici i v případě, že je automatika vypnutá. U první e-shopové objednávky evidované manuálně vyplňte skutečné datum a čas tržby; plugin jej vyhodnotí v časovém pásmu nastaveném ve WordPressu. Při dalším odeslání téhož záznamu použije stejný čas, aby data zůstala konzistentní.

Manuální odeslání nebo opětovné odeslání mohou provést administrátoři, správci obchodu a při aktivním LightPOS také pokladní s příslušným oprávněním.

Při prvním odeslání e-shopové objednávky plugin uloží neměnný snímek fiskálních údajů: částku, datum a čas tržby, pokladnu, evidenční jednotku i případný přepočet měny. Opětovné a manuální odeslání používá tento původní snímek i po pozdější úpravě objednávky nebo nastavení.

Jakmile systém EET potvrdí tržbu kódem POK, potvrzený fiskální stav zůstává zachován i při pozdějším neúspěšném opětovném odeslání.

Pokud se spojení dočasně nezdaří, plugin zařadí objednávku do fronty dalších pokusů. Zpracování fronty zajišťují úlohy na pozadí WooCommerce a WordPressu. V nastavení určíte maximální počet opakování i časové okno. Po dosažení některého limitu se automatické opakování zastaví a záznam se označí k manuálnímu dořešení v přehledu WooCommerce → Chybné odeslání EET. V tomto přehledu najdete čekající záznamy, aktivní opakování i chyby vyžadující manuální zásah, včetně storen.

Výchozí nastavení čeká na synchronní odpověď 4 sekundy a opakuje neúspěšné odeslání až 48 hodin. Vyšší počet pokusů nebo delší časové okno nemění zákonnou povinnost podnikatele zajistit řádné odeslání údajů; pokud automatické opakování skončí chybou, objednávku zkontrolujte a podle potřeby odešlete manuálně.

08 · Práce s objednávkami

Stav evidence, storno a související podklady řešíte u objednávky.

Stav a potvrzení

V metaboxu EET 2.0 v detailu objednávky uvidíte stav evidence, POK, chybu a protokol jednotlivých pokusů. Po úspěšném odeslání si můžete otevřít čitelné potvrzení; více potvrzení lze stáhnout také hromadně jako ZIP.

Platby v cizí měně

Je-li objednávka uhrazena v jiné měně než CZK, plugin při evidenci automaticky přepočte částku na Kč podle denního kurzu ČNB. Kontrola kurzovního lístku ČNB je naplánována jednou denně na 14:30 v časovém pásmu Europe/Prague; v závislosti na provozu WordPressu může proběhnout o něco později. V metaboxu EET 2.0 u objednávky pak uvidíte původní měnu a částku, použitý kurz ČNB a datum jeho platnosti i částku v Kč, která byla odeslána do EET. Pro opakované odeslání a storno se zachová stejný uložený kurz.

Podporované měny: CZK a měny zveřejňované v denním kurzovním lístku ČNB: AUD, BRL, CAD, CHF, CNY, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, XDR a ZAR. Pokud ČNB kurz pro danou měnu nezveřejňuje nebo není pro okamžik tržby dostupný, plugin částku neodešle a vyžádá si kontrolu.

XML a podrobný protokol

Pro běžnou kontrolu stačí stav, POK a čitelné potvrzení. Potřebujete-li při řešení potíží surové XML požadavku a odpovědi, zapněte na kartě Testování a protokoly volbu Podrobné logování. Surové XML může zobrazit a stáhnout pouze administrátor.

Refundace a storno

Refundace se do EET neodesílá automaticky. V detailu původní objednávky vytvořte refundaci a u ní zvolte odeslání storna v okamžiku, kdy tomu odpovídá váš provozní postup. Storno je samostatná záporná tržba se svým datem, časem a potvrzením. Při prvním odeslání storna vyberte pokladnu a evidenční jednotku, kde byly peníze skutečně vráceny. Plugin tyto údaje uloží ke stornu i pro případné další odeslání. Proto je nutné nejprve evidovat původní tržbu.

Volitelný prodej na fyzické pokladně

Pro prodej na fyzické pokladně lze volitelně použít LightPOS – Point of Sale (POS) for WooCommerce ↗. LightPOS není pro e-shopové a manuální objednávky nutný. Je-li aktivní, plugin po dokončení prodeje odešle tržbu do EET, zobrazí její stav přímo v POS a zpřístupní potvrzení. Pokladna a evidenční jednotka se určí podle přihlášeného pokladního a jeho přiřazené lokality.

09 · Dárkové poukázky a zákaznický kredit

Nabíjení a čerpání kreditu evidujte u správného produktu a kupónu.

Plugin podporuje evidenci dárkových poukázek a předplaceného zákaznického kreditu podle EET 2.0. Slouží k odeslání správných údajů do EET; sám nevytváří poukazové kódy, nevede zůstatek zákazníka ani kredit automaticky neodečítá. Tyto funkce musí zajišťovat váš proces, WooCommerce kupóny nebo samostatné řešení pro dárkové poukázky.

Produkt, kterým zákazník získá kredit

Upravte produkt ve WooCommerce a v jeho nastavení EET 2.0 zaškrtněte možnost „Produkt prodává dárkový poukaz s kreditem“. Použijte ji jen tehdy, když nákup produktu přidá zákazníkovi kredit použitelný později na různé zboží nebo služby. Plugin do EET odešle hodnotu tohoto kreditu jako urceno_cerp_zuct.

Příklad: zákazník koupí dárkový poukaz v hodnotě 1 000 Kč, který může později použít na libovolný nákup ve vašem e-shopu.

Poukaz platný pouze na konkrétní produkt nebo konkrétní službu takto neoznačujte. Typickým příkladem je poukaz na jednu masáž, konkrétní večeři v restauraci nebo vybraný zážitek. Jeho prodej se eviduje jako běžná tržba.

U variabilního produktu označte rodičovský produkt; označení se použije pro všechny jeho varianty.

Kupón, kterým zákazník čerpá dříve koupený kredit

Upravte WooCommerce kupón a v jeho nastavení EET 2.0 zaškrtněte možnost „Kupón uplatňuje dárkový poukaz s kreditem“. Použijte ji jen u kupónu, kterým zákazník skutečně hradí objednávku z dříve zakoupeného kreditu. Plugin odešle uplatněnou částku jako cerp_zuct.

Běžný slevový kupón tímto způsobem neoznačujte. Sleva není čerpáním předplaceného kreditu.

Co uvidíte v potvrzení EET

  • Celková částka pro EET — hodnota celk_trzba, kterou plugin skutečně odeslal do EET.
  • Nabití kreditu (EET) — hodnota urceno_cerp_zuct; kredit vznikající nákupem označeného produktu.
  • Čerpání kreditu (EET) — hodnota cerp_zuct; kredit použitý jako úhrada objednávky.

V jedné objednávce mohou být uvedeny oba údaje. Například zákazník může koupit nový dárkový poukaz a současně jeho cenu uhradit již dříve získaným kreditem. Řádky nabití a čerpání nejsou dalšími poplatky; vysvětlují, jak byla tržba z pohledu předplaceného kreditu evidována.

Vrácení částky

Při odeslání storna vyberte způsob vrácení. Volba Vrátit peníze eviduje běžné storno. Volbu Připsat zpět na kredit dárkového poukazu použijte pouze tehdy, když se částka skutečně vrací do zákazníkova kreditu; plugin ji odešle jako záporné cerp_zuct.

10 · Kontrola a řešení potíží

Postupujte od údajů k připojení.

  1. Objednávka se neodeslala automaticky

    Ověřte, že je automatické odesílání zapnuté, že má objednávka vybraný stav i platební metodu a že je u e-shopu nastavena lokalita. Zkontrolujte také aktivní licenci.

  2. Odeslání skončilo chybou

    V detailu objednávky otevřete protokol a zkontrolujte text chyby. Následně prověřte aktivní prostředí, platnost správného certifikátu, EIČ, pokladnu a evidenční jednotku. Pokud je problém v připojení dočasný, sledujte stav dalších pokusů ve frontě. Ověřte také, že hosting neblokuje odchozí HTTPS spojení a že běží úlohy na pozadí.

  3. Potřebujete technické podklady

    Zapněte Podrobné logování pouze po dobu řešení problému. Surové XML obsahuje technické údaje komunikace, proto jej poskytujte podpoře jen bezpečným způsobem a po vyhodnocení potíží logování opět vypněte.

11 · Podpora a oficiální odkazy

Kde najdete další informace.

Plugin pomáhá s technickým propojením WooCommerce a EET 2.0. Informace o registraci, zákonných podmínkách a rozhraní EET sledujte u Finanční správy.

Potřebujete-li pomoci s nastavením pluginu, napište nám na support@eet-plugin.cz.