Dokumentace pluginu Toret EET 2.0

Nacházíte se na stránkách dokumentace WooCommerce pluginu Toret EET 2.0.

Plugin napojuje WooCommerce e-shop na elektronickou evidenci tržeb EET 2.0 podle zákona č. 180/2026 Sb., platnou od 1. 1. 2027.

Plugin si můžete zakoupit zde.

Minimální požadavky

• WordPress 6.9 nebo vyšší
• WooCommerce 11.0 nebo vyšší
• PHP 8.2 nebo vyšší s rozšířením OpenSSL
• MySQL 5.0 nebo vyšší
• Pokladní certifikát a evidenční jednotka z DIS+ na portálu MOJE daně

Plugin je kompatibilní s HPOS (High-Performance Order Storage).

Pozn. Na starší verzi PHP se plugin nenačte a v administraci se zobrazí upozornění s vaší aktuální verzí PHP. Bez rozšíření OpenSSL nejde tržby podepsat a odeslat – plugin na to upozorní v nastavení. V obou případech se obraťte na svůj hosting.

Instalace pluginu

Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení ZIP souboru s pluginem. Plugin nainstalujete standardně:

1. V administraci WordPressu přejděte na Pluginy → Instalace pluginů → Nahrát plugin.
2. Vyberte stažený ZIP soubor a klikněte na Instalovat.
3. Po instalaci plugin aktivujte.

Alternativně můžete obsah ZIP souboru nahrát přes FTP do složky wp-content/plugins/ a plugin aktivovat v přehledu pluginů.

Nastavení pluginu najdete v menu Toret plugins → EET 2. Má čtyři záložky: Nastavení, Pravidla evidence, Log a Nápověda. Plugin je přeložený do češtiny a slovenštiny.

Než začnete: Údaje z DIS+

Před nastavením pluginu si v DIS+ na portálu MOJE daně připravte tyto údaje:

1. Vygenerujte pokladní certifikát a stáhněte soubor .p12 i s heslem. Certifikát platí 366 dní.
2. Poznamenejte si své EIČ (evidenční identifikační číslo, obvykle vaše DIČ) a své čísla svých evidenčních jednotek (prodejny, výdejní místa, vozidla apod. kde přijímáte kontaktní platby).

TIP: Podrobné informace k EET 2.0 najdete na eet.gov.cz a na webu Finanční správy.

Aktivace licence

(Toret plugins → EET 2 → Nastavení)

V sekci Licence vložte do pole Licenční klíč klíč, který jste obdrželi e-mailem nebo který najdete v Mém účtu na toret.cz, a nastavení uložte. Po ověření se u pole zobrazí Aktivní.

Ostatní nastavení a záložky se zobrazí, jakmile bude klíč aktivní.

Pozor! Bez platného licenčního klíče plugin nefunguje – do EET se neodesílají žádné tržby a administrace pluginu ukazuje jen pole pro licenční klíč a nápovědu. Tržby čekající na opakování zůstanou zachované a odešlou se, jakmile bude klíč znovu aktivní.

Nastavení

(Toret plugins → EET 2 → Nastavení)

Na záložce Nastavení zadáte údaje z DIS+, nahrajete pokladní certifikát a ověříte spojení s EET. Změny uložíte tlačítkem Uložit změny dole na stránce.

Připojení k EET

• Prostředí – Testovací (playground) slouží k vyzkoušení pluginu s testovacími certifikáty Finanční správy, nic se neeviduje. Před první skutečnou platbou vložte produkční certifikát a přepněte na Produkční.
• EIČ – evidenční identifikační číslo, obvykle vaše DIČ, např. CZ12345678. Musí se shodovat s EIČ v certifikátu.
• Číslo evidenční jednotky – číslo, které DIS+ přidělila evidenční jednotce, kde platby přijímáte nejčastěji (prodejna, výdejní místo nebo e-shop). Další místa s vlastním číslem nastavíte v záložce Pravidla evidence. Čísla z DIS+ mají nejméně dvě číslice a končí na 1, 2, 3 nebo 4 – pokud zadané číslo tomuto tvaru neodpovídá, plugin na to upozorní.
• Označení pokladního zařízení – vaše vlastní označení tohoto e-shopu jako pokladny, např. eshop. Musí být jedinečné v rámci evidenční jednotky, nejvýš 20 znaků bez diakritiky.
• Mezní doba odezvy – jak dlouho (v sekundách) čekat na potvrzení z EET. Obvykle stačí 3 až 5 sekund, zákon vyžaduje nejméně 2. Tržbu, která není včas potvrzena, plugin odešle znovu.

Pokladní certifikát

• Soubor certifikátu – pokladní certifikát .p12 vygenerovaný v DIS+ na portálu MOJE daně.
• Heslo certifikátu – vyplňte jen při nahrávání souboru certifikátu. Heslo se neukládá, privátní klíč se ukládá zašifrovaný.
• Uložený certifikát – po nahrání ukazuje EIČ z certifikátu, platnost, název souboru a vydavatele. Testovací certifikát Finanční správy má označení testovací certifikát. Tlačítko Odebrat certifikát ho z webu smaže.

TIP: Certifikát platí 366 dní. Jakmile se objeví upozornění na konec platnosti, vygenerujte v DIS+ nový certifikát a nahrajte ho v poli Nahradit certifikát.

Údaje EET pro zákazníka

• E-maily zákazníkovi – volitelně zobrazí evidovanou tržbu (POK, pořadové číslo, částku) v e-mailech WooCommerce zákazníkovi. Zobrazí se ve všech e-mailech odeslaných po potvrzení tržby z EET. Zákon uvádění POK na dokladech nevyžaduje, jde jen o informaci.
• Faktury a jiné pluginy – ukazuje funkce, kterými fakturační pluginy mohou číst údaje EET objednávky (viz Pro vývojáře).

Test spojení

Tlačítko Otestovat spojení odešle do EET testovací tržbu 0,00 Kč v ověřovacím módu – nic se neeviduje. Test použije uložené nastavení, změny proto nejdřív uložte. Spusťte ho po každé změně nastavení nebo certifikátu.

Pravidla evidence

(Toret plugins → EET 2 → Pravidla evidence)

Pravidla určují, které platby a kdy se odešlou do EET.

TIP: Informace o tom, které tržby je třeba evidovat najdete na webu Finanční správy k EET 2.0.

V tabulce jsou všechny platební metody registrované ve WooCommerce. U každé metody nastavíte:

• Evidovat – zapne evidenci pro danou platební metodu.
• Jen s dopravou – omezí pravidlo na vybrané způsoby dopravy, např. dobírku jen s osobním odběrem. Prázdné pole znamená všechny dopravy. Pro objednávky bez dopravy je v nabídce možnost Bez dopravy (virtuální objednávky).
• Kdy evidovat – Při dokončení platby, nebo Při změně stavu objednávky na vybraný stav.
• Zaokrouhlit na celé Kč (hotovost) – zaeviduje částku zaokrouhlenou na celé koruny, pro hotovost přijímanou zaokrouhleně. Platí jen pro objednávky v Kč.

Pozor! Volba Při dokončení platby je pro platební metody, které zaplacení samy potvrdí, např. platební brány nebo platební terminál nastavený jako samostatná platební metoda. Dobírka, převod ani šek zaplacení nikdy nepotvrdí, takže se u nich s touto volbou nic nezaeviduje – zvolte místo ní stav objednávky.

Tržbu je nutné evidovat v okamžiku přijetí platby. U hotovosti nebo karty při osobním odběru zvolte stav objednávky, který obsluha nastaví, když zákazník zaplatí – ne stav nastavovaný později, např. hromadně druhý den.

Pravidlo zaeviduje celkovou částku objednávky po odečtení už zaevidovaných plateb, takže se objednávka nezaeviduje dvakrát, ani když se stav nastaví znovu. Když byla část objednávky zaplacena jinak (např. záloha převodem), zaevidujte místo toho skutečně přijatou platbu v detailu objednávky a pravidlo pro takové objednávky nepoužívejte.

Evidenční jednotky podle dopravy

Tržba se eviduje pod evidenční jednotkou, kde zákazník zaplatil: vaše prodejna nebo výdejní místo, případně vozidlo vlastního rozvozu. Každou z nich oznamte v DIS+ a u příslušného způsobu dopravy vyplňte:

• Číslo evidenční jednotky – číslo místa z DIS+.
• Označení pokladního zařízení – označení pokladny na tomto místě.

Doprava bez vyplněných údajů použije evidenční jednotku a pokladní zařízení ze záložky Nastavení. Každé výdejní místo osobního odběru WooCommerce má vlastní řádek.

EET v objednávce

(WooCommerce → Objednávky → detail objednávky → box EET)

Box EET v detailu objednávky ukazuje všechny její tržby, vratky a storna. U každého záznamu vidíte Datum, Typ, Pořadové číslo (s evidenční jednotkou a pokladním zařízením), Částku, Stav, POK / zprávu a počet Pokusů. Každý výsledek se zapíše i do poznámek objednávky.

Ruční zaevidování platby

Pole Přijatá částka a tlačítko Zaevidovat platbu v EET hned zaevidují jednu skutečně přijatou platbu bez ohledu na pravidla. Každá platba je samostatná tržba.

PŘÍKLAD: Zákazník zaplatil zálohu 500 Kč převodem a zbytek 1 200 Kč hotově při převzetí na prodejně. Evidovat se musí jen hotovostní část – zadejte do pole Přijatá částka 1 200 a klikněte na Zaevidovat platbu v EET hned. Pravidlo pro takové objednávky nepoužívejte, jinak by zaevidovalo celou částku objednávky.

Storno

Tlačítko Stornovat … v EET (s částkou, např. Stornovat Kč 471,00 v EET) stornuje zaevidovanou částku. Použijte ho, když zákazník nezaplatil nebo byla platba zaevidována omylem.

Co se děje automaticky

• Vratka provedená ve WooCommerce (refundace) se zaeviduje jako záporná tržba.
• Když zrušíte objednávku se zaevidovanou platbou, zaevidovaná částka se v EET stornuje.

Pozn. Úprava položek nebo částky už zaevidované objednávky se do EET neodesílá. Pokud zákazníkovi vracíte peníze, proveďte vratku (refundaci) ve WooCommerce.

Typy záznamů a pořadová čísla

Typ	Význam	Pořadové číslo
Tržba	Přijatá platba.	Číslo objednávky, další platby téže objednávky dostanou příponu -P2, -P3 …
Vratka	Vratka z WooCommerce zaevidovaná jako záporná částka.	Číslo objednávky-R ID vratky
Storno	Storno zaevidované částky bez vratky (zrušená objednávka, tlačítko Stornovat v EET).	Číslo objednávky-S1

Log a opakované odeslání

(Toret plugins → EET 2 → Log)

Log ukazuje vše odeslané do EET od nejnovějšího a jde filtrovat podle stavu (Vše, Evidováno, Chyba …). Každý řádek obsahuje Datum, Objednávku, Typ, Pořadové číslo s evidenční jednotkou a pokladním zařízením, Částku (u cizích měn s kurzem ČNB), Stav, POK / zprávu EET a počet Pokusů. Řádky odeslané do testovacího prostředí mají označení playground. Počet tržeb, které vyžadují pozornost, ukazuje číslo u záložky Log.

Stav	Význam
Odesílá se	Tržba se právě odesílá.
Evidováno	EET tržbu přijalo, POK je uložený. Není potřeba nic dělat.
Čeká na opakování	EET neodpovědělo nebo selhalo spojení. Plugin tržbu odešle znovu sám po 1, 5, 15 a 30 minutách a pak každou hodinu.
Po lhůtě 48 h, dál se opakuje	Tržba nebyla potvrzena do 48 hodin. Povinnost ji zaslat trvá, plugin ji proto dál zkouší odeslat každých 6 hodin. Zkontrolujte příčinu ve zprávě.
Chyba	EET tržbu odmítlo, nebo ji vůbec nešlo odeslat (chybí nastavení, neznámá měna). Neopakuje se – odstraňte příčinu a klikněte na Odeslat znovu.

Tlačítko Odeslat znovu je u tržeb, které EET nepotvrdilo, v záložce Log i v boxu EET v detailu objednávky.

Technické podrobnosti každého pokusu včetně odpovědí EET najdete ve WooCommerce → Stav → Logy (zdroj toret-eet-2).

Upozornění v administraci

Když tržbu nejde zaevidovat, objeví se v administraci WordPressu červené upozornění s počtem tržeb nebo vratek, které se nepodařilo zaevidovat. Odkaz Otevřít log EET vede k problému, Skrýt do dalšího problému ho schová, dokud nenastane nový. Jakmile se tržby zaevidují, upozornění samo zmizí.

Pozn. Testovací prostředí Finanční správy má pravidelné odstávky (obvykle ve čtvrtek večer a v noci). Výpadek v této době není chyba pluginu.

Časté dotazy a řešení problémů

Hlášky a situace

Hláška nebo situace	Co dělat
Plugin nemá aktivní licenci	Do EET se neodesílají žádné tržby a administrace ukazuje jen licenční klíč a nápovědu. Zadejte platný klíč v záložce Nastavení. Tržby čekající na opakování se odešlou, jakmile bude klíč aktivní.
V nastavení pluginu chybí EIČ nebo číslo evidenční jednotky.	Vyplňte záložku Nastavení a u tržby klikněte na Odeslat znovu.
Platnost certifikátu vypršela.	Vygenerujte v DIS+ nový certifikát, nahrajte ho v záložce Nastavení a odmítnuté tržby odešlete znovu ze záložky Log.
Chyba 4: neplatný podpis	Certifikát pro dané prostředí neplatí – např. testovací certifikát v produkci nebo certifikát po konci platnosti. Zkontrolujte box Uložený certifikát.
Varování: EIČ se liší od certifikátu	Tržba byla přijata, ale EIČ v nastavení nesedí s certifikátem. Opravte EIČ.
Varování: číslo evidenční jednotky neodpovídá formátu	Tržba byla přijata, ale číslo evidenční jednotky nemá tvar čísla z DIS+. Zkontrolujte číslo v nastavení a v Evidenčních jednotkách podle dopravy.
POK končí na -ff	Tržba šla do testovacího prostředí a není zaevidovaná. Přepněte prostředí na Produkční a nahrajte certifikát z DIS+.
Měna objednávky není na lístku ČNB	EET přijímá jen Kč a plugin jiné měny přepočítává kurzem ČNB. Měnu, kterou ČNB nevyhlašuje, přepočítat nejde a tržba skončí jako Chyba.
Opakované odeslání přichází pozdě	Opakování běží přes WP-Cron, který potřebuje návštěvníky. Na webu s malou návštěvností spouštějte WP-Cron systémovým cronem.
Dobírka se nezaeviduje	Zkontrolujte, zda pravidlo nemá v poli Kdy evidovat volbu Při dokončení platby. U dobírky zvolte stav objednávky, např. Dokončeno. Zkontrolujte také pole Jen s dopravou.

Nefungoval internet nebo EET. Musím něco udělat?

Ne, plugin tržbu odešle znovu sám. Jen když se v administraci objeví upozornění, otevřete záložku Log a zkontrolujte příčinu.

Objednávky mám v eurech. Jak se evidují?

EET přijímá jen částky v Kč. Plugin objednávky v cizí měně přepočítá kurzem ČNB a kurz uloží k záznamu tržby – v logu ho uvidíte u částky.

Zákazníci platí na více místech (prodejna, výdejní místo, vlastní rozvoz). Jak to nastavit?

Každé místo oznamte v DIS+ jako samostatnou evidenční jednotku. V záložce Pravidla evidence pak v sekci Evidenční jednotky podle dopravy zadejte u příslušné dopravy číslo evidenční jednotky a označení pokladního zařízení.

Pro vývojáře

Údaje EET objednávky jsou uložené v meta objednávky s prefixem _toret_eet_2_. Fakturační a jiné pluginy je mohou číst těmito funkcemi:

Funkce	Co vrací
toret_eet_2_get_order_data( $order )	Údaje EET objednávky (první platba, další platby, vratky a storna), null, když objednávka do EET neodešla.
toret_eet_2_get_order_html( $order )	Hotový blok s potvrzenou tržbou pro faktury a doklady.

Filtry

Filtr	Parametry	K čemu slouží
toret_eet_2_porad_cis	$value, $order, $refund_id	Pořadové číslo posílané do EET.
toret_eet_2_exchange_rate	$rate, $currency	Kurz použitý pro objednávky v cizí měně.
toret_eet_2_order_data	$data, $order	Údaje, které vrací toret_eet_2_get_order_data().
toret_eet_2_order_html	$output, $order, $data, $plain	Blok, který vrací toret_eet_2_get_order_html() a který se tiskne do e-mailů.

Akce

Hook	Parametry	Kdy se spouští
toret_eet_2_sale_sent	$record, $result	Po každém pokusu o odeslání tržby, vratky nebo storna.