Dokumentace pluginu Toret iDoklad

Nacházíte se na stránkách dokumentace Toret pluginu WooCommerce iDoklad, který propojuje e-shop a fakturační systém iDoklad.

Pro použití pluginu je nutností účet v systému iDoklad s tarifem, který umožňuje využívat propojení přes API.

Plugin iDoklad zakoupíte zde: Toret iDoklad pro WooCommerce

Instalace pluginu

Po zakoupení pluginu iDoklad obdržíte emailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete zde.

Aktivace pluginu

Po instalaci pluginu si otevřete plugin WooCommerce iDoklad, do příslušného pole vložte licenční klíč a ověřte licenci.

Videonávod

Propojení s iDokladem

Prvním krokem, který je potřeba udělat pro propojení pluginu s iDokladem, je registrovat se na stránkách www.idoklad.cz.

Pozor! iDoklad je dostupný ve více tarifech. Ověřte, zda vámi vybraný tarif umožňuje propojení přes API, které je pro propojení nezbytné.

Po vytvoření vašeho účtu a přihlášení se, přejděte do Nastavení (ikona ozubeného kolečka v levém menu) > Aplikace. Zde v záložce API vygenerujete přístupové klíče k propojení.

Zde si kliknutím na tlačítko Generovat vygenerujete Vaše Client ID  a Client Secret a uložíte.

Tyto dva vygenerované údaje poté zadáte do pluginu iDoklad (Toret plugins > iDoklad > Nastavení API). V sekci Lokalizace API vyberte českou či slovenskou API, podle toho, kterou používáte. Vše nezapomeňte uložit.

Upozornění: Pokud bude zadání těchto údajů nesprávné, nebude možné vybrat platební metodu a přiřadit ji k objednávce.

Číselné řady

Pro správnou evidenci, fungování a párování zálohových a běžných faktur je nutné nastavení číselných řad. Je potřeba si uvědomit, že číselné řady se načítají automaticky ze systému iDoklad.

Nejprve je tedy nutné nastavit číselné řady na portále iDoklad a poté je synchronizovat v pluginu.

Nastavení v systému iDoklad

Po přihlášení jdeme do Nastavení > Prodej. Zde zvolte záložku Číslování.

Doporučujeme si pozorně přečíst veškeré komentáře a informace o tom, jak se číselné řady v iDokladu generují a nastavují, než tak učiníte a začnete faktury vystavovat.

Nejprve si nastavíme běžné faktury. Po kliknutí na tlačítko Nová (ikona s dokumentem se znaménkem +) se do přehledu přidá nový prázdný řádek pro číslování. Zde je potřeba vyplnit všechna pole. Vysvětlivky k jednotlivým polím se Vám zobrazí po kliknutí na ikonku otazníku.

Stejný postup zvolíme i u nastavení číselných řad pro zálohovou fakturu a dobropis, které najdete níže na stránce.

Pro běžné faktury a dobropisy lze vložit více číselných řad. Uplatňovat se bude ta, která je označená jako vybraná. Na závěr nezapomeňte provedené změny uložit – tlačítko Uložit najdete vpravo dole.

Po vytvoření a uložení číselných řad v iDokladu přejdeme k jejich propojení v pluginu.

Nastavení v pluginu

Číselné řady přiřadíte k proformám, fakturám a dobropisům v sekcích pro jejich nastavení. Ukážeme si to na příkladu proforma faktury.

Vstupte do nastavení pluginu, do sekce Proforma faktura (Toret Plugins > iDoklad > Proforma faktura). V části Nastavení proformy vyberete číselnou řadu v roletce Výběr číselné řady. Uložte.

Stejným způsobem nastavíte číselné řady v sekcích Běžná faktura a Dobropis.

TIP: Nenačetly se číselné řady z iDokladu a v roletce žádné nevidíte? Zkuste nejprve kliknout na Uložit. Po přenačtení by již řady měly být k dispozici.

DPH

IDoklad při generování faktury si sám spočítá DPH položek, podle přiřazených DPH sazeb v nastavení pluginu (viz přiřazování sazeb DPH).

Je důležité, aby v nastavení WooCommerce na kartě Obecné byla nastavena dvě desetinná místa. (WooCommerce > Nastavení > Obecné > Počet desetinných míst) Pokud zde bude nastaveno nula desetinných míst, tak je možné, že iDoklad bude počítat se zaokrouhlenou částkou a celková částka na faktuře nebude souhlasit s částkou v objednávce ve WooCommerci.

Pokud nechcete na webu zobrazovat desetinná místa u cen při nastavení dvou desetinných míst ve WooCommerci, tak do child šablony vložte script pro skrytí nul za desetinnou čárkou.

add_filter( 'woocommerce_price_trim_zeros', '__return_true' );

Režim OSS (One Stop Shop)

Plugin umí pracovat s režimem OSS. Povolíte jej v Obecném nastavení pluginu (Toret Plugins > iDoklad > Obecné nastavení > Hlavní nastavení) a vyberete stát, ve kterém je OSS registrováno. Provedené změny nezapomeňte uložit.

IČ a DIČ

Vzhledem k tomu, že WooCommerce nativně neobsahuje pole pro IČ a DIČ, je nutné použít plugin pro jejich přidání. Pokud ho použijete, je nutné v pluginu iDoklad zadat název meta pole z pokladny pro údaje IČ, DIČ a SK DIČ (u slovenských klientů), která umožní propsat tyto údaje do systému iDoklad a na faktury.

Nastavení naleznete v menu pod záložkou Toret plugins > iDoklad > Obecné nastavení > Pole IČ/DIČ

TIP: Pole pro IČ, DIČ a IČ DPH přidáte snadno pomocí pluginu Toret EU VAT, se kterým také nastavíte přenesenou daňovou povinnost, pokud je třeba.

Pokud pro přidání polí využijete Toret plugin, není nutné názvy polí vyplňovat. Díky vzájemné kompatibilitě dojde k automatickému propojení.

Přiřazení daňových sazeb

Nastavení daňových sazeb ve vašem e-shopu je velmi důležité spárovat dle názvosloví/sazeb v iDokladu.

Standartní sazbu, obě snížené a nulovou je potřeba přiřadit pouze v případě, že tyto sazby daně používáte. To samé platí u daňových sazeb pro dopravu, kupóny a příplatky.

Nastavení pluginu najdeme v administraci v menu pod záložkou Toret plugins > iDoklad > Sazby a měny.

Přiřazení platebních metod

Pro správné označení na fakturách je nutné spárovat platební metody e-shopu s druhy platby dostupnými v systému iDoklad. Toto přiřazení provedete v sekci Sazby a měny (Toret plugins > iDoklad > Sazby a měny > Přiřazení platebních metod)

Nastavení bankovních účtů pro různé měny

V nastavení pluginu pro iDoklad existuje také možnost nastavit bankovní účty pro různé měny, pokud prodáváte i do cizích zemí a máte pro vaše zákazníky tyto účty k dispozici.

Přejděte v administraci do Toret plugins > iDoklad. Ve sekci Bankovní účty najdete následující tabulku.

Zadejte měnu, číslo účtu, kód banky, IBAN a příslušný SWIFT. Kliknutím na tlačítko Přidat řádek můžete přidat libovolný počet řádků pro další účty. Po zadání dat nezapomeňte vše uložit.

V praxi to znamená, že pokud bude objednávka např. v eurech, na faktuře bude uveden bankovní účet v eurech, tedy v měně objednávky.

Vystavování faktur

V této kapitole si vysvětlíme vystavování faktur.

Nastavení faktur v systému iDoklad

Nejprve je třeba nastavit faktury v iDokladu. Po přihlášení do iDokladu přejdete do Nastavení > Prodej.

Na kartě Výchozí nastavení vyplňte údaje podle vašich potřeb. S vyplněním vám pomůže nápověda pod ikonami otazníků. Provedené změny uložte.

Na kartě Vzhled a tisk dokladů > Vydané faktury pak upravíte podobu, text a jazyk faktur. Provedené změny uložte.

Nastavení číslování faktur jsme se věnovali zde.

Po nastavení faktur v iDokladu již pokračujeme pouze v administraci e-shopu.

Manuální vystavování faktur

Faktury je možné manuálně vystavovat kliknutím na tlačítko Vytvořit fakturu v přehledu objednávek či v detailu objednávky.

Všechny vystavené doklady je možné zobrazit v přehledu objednávek po kliknutí na odkaz ve sloupci ID faktury. Zákazník bude mít odkaz na fakturu ke stažení v e-mailu objednávky.

Automatické vystavování faktur

Při automatickém vystavování plugin automaticky vystaví fakturu v zadaném stavu objednávky. U každé platební metody zvlášť lze nastavit zda a v jakém stavu objednávky generovat fakturu.

Automatické vystavování nastavíte v sekci Běžná faktura > Vytvoření faktury dle stavu objednávky

Zákazník bude mít fakturu ke stažení v e-mailu objednávky.

Vy budete mít fakturu u objednávky ve WooCommerci ve sloupci ID faktury.

Své faktury najdete také a v administraci svého účtu na idoklad.cz.

Vystavování zálohových faktur (proforma)

V této kapitole si vysvětlíme vystavování zálohových faktur (proforem).

Nastavení proforem v systému iDoklad

Nejprve je potřeba nastavit zálohové faktury v iDokladu. Zde si po přihlášení přejdete do Nastavení > Prodej > Vzhled a tisk dokladů > Zálohové faktury.

Zde upravíte podobu, text a jazyk faktur. Provedené změny uložte.

Po nastavení zálohových faktur v iDokladu již pokračujeme pouze v administraci e-shopu.

Manuální vystavování proforem (zálohových faktur)

Faktury je možné manuálně vystavovat kliknutím na tlačítko Vytvořit proformu v přehledu objednávek či v detailu objednávky.

Všechny vystavené doklady je možné zobrazit v přehledu objednávek po kliknutí na odkaz ve sloupci ID faktury. Zákazník bude mít odkaz na fakturu ke stažení v e-mailu objednávky.

Automatické vystavování proforem (zálohových faktur)

Při automatickém vystavování plugin automaticky vystaví proformu v zadaném stavu objednávky. U každé platební metody zvlášť lze nastavit zda a v jakém stavu objednávky proformu generovat.

Automatické vystavování nastavíte v sekci Proforma faktura > Vytvoření proformy dle stavu objednávky

TIP: Proforma by se měla generovat u platebních metod, kde nejsou finance připsány na váš účet okamžitě nebo jsou složeny v hotovosti, ale je zapotřebí určitý čas pro jejich převod na váš účet.

Všechny vystavené doklady je možné zobrazit v přehledu objednávek po kliknutí na odkaz ve sloupci ID faktury. Zákazník bude mít odkaz na fakturu ke stažení v e-mailu objednávky.

Odkaz na zálohovou fakturu v potvrzovacím e-mailu.

Vystavování dobropisů

Stejně jako při vystavování faktur a proforem, i doprapisy lze vystavovat manuálně či automaticky.

Manuální vystavování dobropisů

Dobropisy je možné manuálně vystavovat kliknutím na tlačítko Vytvořit dobropis v přehledu objednávek či v detailu objednávky.

Všechny vystavené doklady je možné zobrazit v přehledu objednávek po kliknutí na odkaz ve sloupci ID faktury.

Automatické vystavování dobropisů

Automatické vystavování dobropisů lze navázat na konkrétní stavy objednávek u jednotlivých platebních metod.

Všechny vystavené doklady je možné zobrazit v přehledu objednávek po kliknutí na odkaz ve sloupci ID faktury.

Uhrazování zálohových faktur (proforem)

V pluginu lze nastavit, zda se bude uhrazenost faktury kontrolovat (automatické párování plateb pomocí cronu) či ne. Toto nastavíte v sekci Proforma faktura > Nastavení proformy > Kontrola zaplacenosti.

Při volbě Nekontrolovat: Zaplacenost proformy nebude nijak kontrolována. K následnému vystavení faktury dojde buď manuálně nebo automaticky, pokud sami změníte stav objednávky.

Při volbě Kontrolovat: Zaplacenost bude zkontrolována pomocí cronu a při potvrzení zaplacení se automaticky změní stav objednávky – viz Automatická kontrola plateb níže. Na změnu stavu může automaticky navázat vystavení faktury.

Automatická kontrola plateb (párování plateb)

Aplikace iDoklad obsahuje funkci kontroly plateb. Pokud nastavíte propojení bankovního účtu s iDokladem, v momentě, kdy bude na váš účet připsána platba s určitým variabilním symbolem, tento mechanismus je schopen tuto částku spárovat s příslušnou fakturou či proformou v iDokladu a potvrdit její zaplacení.

Pro přebírání informací o uhrazení faktury/proformy do WooCommerce lze využít cron, který bude v pravidelných intervalech uhrazení kontrolovat.

Pro nastavení automatické kontroly plateb vstupte do nastavení pluginu Toret plugins > iDoklad > Párování plateb. Zde najdete URL adresu, kterou zadáte do cronu na svém hostingu (a) a zvolíte interval spouštění. Doporučená doba spouštění je 1x za hodinu. To znamená, že 1x za hodinu se bude automaticky kontrolovat uhrazení faktur.

Dále zvolte, jaké stavy objednávek se mají kontrolovat (b) a také nastavte, do jakého stavu se přepne objednávka po zjištění uhrazení faktury/proformy (c). Provedené změny uložte.

Uhrazení faktur

Zde si vysvětlíme, jak nastavit uhrazení faktur v pluginu podle stavu objednávky (Toret plugins > iDoklad > Běžná faktura > Označení faktury jako uhrazené (ve stavu objednávky))

Nejprve je třeba si uvědomit, že vystavení faktury neznamená automaticky její zaplacení. To je například zřejmé u platební metody Platba na dobírku, kdy je faktura vystavena při potvrzení objednávky a odeslána jak v potvrzovacím e-mailu, tak poté i společně s produktem v dobírce. Faktura je zaplacena teprve při převzetí zásilky zákazníkem a objednávka se mění do stavu Dokončeno.

Pokud chcete fakturu vystavit i uhradit zároveň, zaškrtněte v nastavení faktury checkbox Nastavit datum splatnosti dle data úhrady. (Toret plugins > iDoklad > Běžná faktura > Nastavení faktury)

Jediná výjimka je, pokud se rozhodnete vystavovat zálohové faktury. V tomto případě se po spárování této zálohové faktury s platbou okamžitě vytvoří již zaplacená odpovídající faktura – daňový doklad.

Zobrazení v přehledu objednávek

Jakmile si zákazník zakoupí jakýkoliv produkt ve vašem e-shopu a dokončí objednávku, bude tato objednávka okamžitě viditelná v administraci pod záložkou WooCommerce > Objednávky. Zákazníkovi je také automaticky odeslán potvrzovací e-mail o dané objednávce.

Ve sloupci ID faktury najdete číslo příslušné faktury/proformy, pokud byla k objednávce vystavena. Kliknutím na číslo fakturu zobrazíte. V tomto sloupci uvidíte také případnou prodejku.

Ve sloupci iDoklad se zobrazují ikony pro vystavení faktury nebo proformy (čtverec se šipkou u objednávek bez vytvořené faktury), stažení faktury (PDF soubor), editaci faktury (tužka) a vystavení dobropisu (dvě šipky). Pro odeslání objednávek do iDokladu lze využít také hromadné akce.

V detailu objednávky je k dispozici iDoklad metabox, ve kterém můžete také vytvářet faktury, proformy a dopropisy, stáhnout je, či upravit.

Nastavení obsahu vystavovaných dokumentů

Zobrazení názvu varianty na faktuře

Dalším důležitým prvkem v nastavení pluginu iDoklad je zobrazení názvu varianty produktu na faktuře. To znamená, jak bude produkt specifikován na faktuře včetně jeho vlastností jako např. barva a velikost.

Nejprve je tedy důležité mít již vytvořený primární produkt a jeho různé varianty dle vlastností. Jak si tedy tyto varianty nastavíte v menu pod Produkty, tak je budete mít k dispozici zde pro výběr názvu, který se bude zobrazovat na fakturách vystavovaných zákazníkům.

Příklad: Primární produkt je Tričko, varianty budou dle barvy a velikostí. Zákazník si zakoupí toto tričko v modré barvě a velikosti XXL. Na příslušné faktuře můžeme tedy zobrazit buď variantu „Tričko, Modrá XXL“  nebo včetně názvů vlastností „Tričko Barva: Modrá, Velikost: XXL“.

Nastavení formátu názvu provedete v sekci Obecné nastavení – Formát dokladů (Toret plugins > iDoklad > Obecné nastavení > Formát dokladů)

Zobrazení vlastního textu na faktuře

Na faktuře je možné zobrazovat vlastní texty umístěné před a za položkami faktury, viz. obr:

Nastavení vlastních textů provedete v sekci Obecné nastavení – Formát dokladů (Toret plugins > iDoklad > Obecné nastavení > Formát dokladů)

Zobrazení jednotky na faktuře

V pluginu je možné nastavit vlastní jednotku produktu, dopravy, nebo poplatku. Vlastní jednotky se propíšou na proforma fakturu i na běžnou fakturu. 

Pokud pole nebudou vyplněna, bude se používat výchozí hodnota „ks“. Funkce je určena například pro e-shopy, které prodávají zboží na metry, kg ap.

Příklad nastavení:

Příklad produktu na faktuře: 

Zobrazení doručovací adresy na faktuře

V pluginu je možné nastavit zobrazování doručovací adresy (pokud je vyplněna) na faktuře. Tuto možnost najdete v nastavení formátu dokladů (Toret Plugins > iDoklad > Obecné nastavení > Formát dokladů).

Nastavení jazyka faktury

V nastavení formátu dokladů (Toret plugins > iDoklad > Obecné nastavení > Formát dokladů) lze vybrat jazyk, ve kterém se budou dokumenty vystavovat. Jazyk lze zadat pevně nebo určovat automaticky dle země objednávky.

Dostupné jazyky jsou:

• čeština
• slovenština
• angličtina
• němčina

Nastavení e-mailů a děkovné stránky

V sekci E-mail a Můj účet si můžete přizpůsobit odesílání e-mailů s fakturami, proformami a dobropisy.

Tlačítka a akce

Checkboxy Zobrazit ikonu pro odeslání… (a) slouží k zobrazení ikony pro manuální odeslání v přehledu objednávek (symbol obálky).

Při zaškrtnutí checkboxů Automaticky odeslat… (b) budou dané dokumenty odesílány e-mailem ze systému iDoklad automaticky při jejich vytvoření. Příjemce těchto e-mailů nastavíte v sekci Příjemci (viz níže).

Přidat odkaz na fakturu do e-mailu (c): Tato funkce přidává odkazy na faktury, proformy a dobropisy do automatických WooCommerce e-mailů o objednávce.

Zobrazit odkaz na stažení na děkovné stránce (d): Díky této funkci si zákazník může stáhnout fakturu/proformu na děkovné stránce ihned po odeslání objednávky (pokud je dokument již vytvořen).

Příjemci

V části Příjemci nastavíte, komu chcete posílat e-maily s vystavenými dokumenty (jedná se o e-maily ze systému iDoklad, které jsme povolovali v předchozím kroku, viz výše).

Obsah e-mailů

Obsah e-mailů s dokumenty odesílaných ze systému iDoklad lze upravit v sekcích Vlastní text – Faktura a Vlastní text – Proforma (Toret plugins > iDoklad > E-mail a Můj účet > Vlastní text).

Nastavení synchronizace skladu

V administraci iDokladu můžete využít funkce evidování skladových zásob a propojit je s položkami faktury. Pokud se na webu provede objednávka, tak se položka automaticky odečte ze skladu v administraci iDokladu.

Nastavení si projdeme v několika krocích:

Aktivace funkce v pluginu

Na webu přejděte do nastavení iDokladu v pluginu (Toret plugins > iDoklad > Synchronizace skladu).

V části nastavení pluginu WooCommerce -> iDoklad aktivujte tuto funkci checkboxem, nastavte typ synchronizace a uložte. Rozdíl mezi typy synchronizace si vysvětlíme.

Snížení/zvýšení množství skladem při objednání i manuální úpravě v administraci – To znamená, že skladovost (počet kusů skladem) se u importovaného produktu v iDokladu upraví, když se prodá i když ji manuálně upravíte u produktu ve WooCommerce.

Např. manuálně doplníte sklad daného produktu. Zároveň se bude počet kusů skladem synchronizovat i při objednávce nebo zrušení objednávky.

Pouze snížení množství skladem při objednání – Tato funkce upraví počet kusů skladu v iDokladu jen objednávkou. Při manuální změně stavu skladu se sklad na straně iDokladu nesynchronizuje.

Po uložení nastavení se v levém menu administrace pod Toret plugins zobrazí karta iDoklad sync stock – pokud se po uložení tato karta nezobrazí aktualizujte stránku např. klávesou F5.

Export produktů z WooCommerce do iDokladu

Na stránce iDoklad sync stock je vypsán se seznam produktů ve WooCommerce. Tlačítkem „Exportovat položku do iDokladu“ se vytvoří produkt se skladovou zásobou ve službě iDoklad. Jako hodnota „Kód“ ve službě iDoklad se převede ID produktu nebo katalogové číslo (SKU), pokud je vyplněné.

Exportovat produkty z WooCommerce do iDokladu můžete také po 500 položkách pomocí tlačítka, které je na konci tabulky. 

Párování produktů

V případě, že máte v iDokladu již vytvořené produkty a chcete je spárovat s produkty z WooCommerce, postačí před exportem produktů v tabulce iDoklad sync stock upravit „iDoklad ID položky“ na hodnotu již vytvořeného ID produktu na straně iDokladu.

ID produktu v iDokladu najdete za lomítkem na konci URL v detailu iDoklad produktu (viz obr. níže)

Zkopírujte ID v detailu produktu ve službě iDoklad.

Vložte ID do pole iDoklad ID položky k produktu, který chcete spárovat, uložte a poté klikněte na tlačítko pro export produktu.

Jakmile dojde ke spárování produktu, tak se v iDokladu aktualizuje hodnota skladu, ceny a čárového kódu na hodnoty produktu z WooCommerce. 

Mazání exportovaných produktů – DŮLEŽITÉ

POZOR! Exportované produkty vždy mažte přes tabulku iDoklad sync stock pomocí červeného tlačítka „Odstranit položku v iDokladu“. Pokud byste smazali exportovaný produkt přes administraci služby iDoklad, nebylo by již možné smazat produkt přes tabulku v pluginu, dokud by nebyla promazaná databáze (a to není úkon pro běžného uživatele). V případě, že by byl exportovaný produktu smazán přes službu iDoklad, tak pro znovu exportování produktu je nutné v databázi smazat metadata _idoklad_id_polozky a _idoklad_nazev_polozky.

Synchronizace skladu z iDokladu do WooCommerce

Ve výchozím nastavení je párování skladu pouze jednosměrné z WooCommerce do iDokladu. V případě, že chcete párovat sklad také ve WooCommerce podle skladu produktů v iDokladu, tak je nutné mít v pluginu aktivní funkci Aktivovat synchronizaci v sekci iDoklad -> WooCommerce.

Po aktivaci funkce oboustranné synchronizace je nutné vyčkat 24 hodin, než se sklad ve WooCommerce začne synchronizovat se skladem v iDokladu. Jedná se o ochranu, aby souhlasily hodnoty skladů. Po 24 hodinách bude synchronizace probíhat automaticky jednou za hodinu.

Druhou možností je načítat stav skladu v iDokladu pomocí WP cronu. V tom případě je nutné potvrdit checkbox Aktivovat WP cron a nastavit interval jeho načítání.

Využít můžete také vlastní cron. Na svém hostingu vložte URL pro vlastní cron do cronu a nastavte interval jeho opakování. Tento interval můžete nastavit podle své potřeby.

Deaktivace synchronizace skladu pro platební metodu

V této sekci můžete vybrat platební metody, při jejichž použití nebude sklad synchronizován a položky se ze skladu v iDokladu neodečtou.

Filtry

Jak změnit jazyk faktury

Faktury jsou vystavovány v českém jazyce, vzhledem k tomu, že plugin je primárně určen pro Českou republiku. Přestože je jej možné používat i na Slovensku, tak se objevil požadavek, aby bylo možné vystavit faktury i v jiném jazyce.
V tomto případě je důležitá informace, že WordPress neumí jazykové mutace. Je buď v jednom jazyce, nebo v druhém.

Avšak, existují pluginy, jenž umožňují mutace vytvářet. Bohužel, není možné, připravit plugin tak, aby byl kompatibilní se všemi pluginy.

Proto je v pluginu vložen filtr, jenž umožňuje změnit jazyk pro odeslanou fakturu, nebo zálohovou fakturu.

$lang = 'cs-CZ';
$data['LanguageCode'] = apply_filters( 
    'idoklad_language_code', 
    $lang, 
    $order_id, 
     $order 
);

Jak můžete vidět, defaultní hodnota je cs-CZ a do filtru je doplněno id objednávky a celý objekt objednávky.

Upozornění: Pokud máte možnost přepínat jazyky, tak je třeba v okamžiku vytvoření objednávky, uložit aktuální jazyk do post meta objednávky. Pak již jen pomocí filtru získáte jeho hodnotu a vrátíte jazyk, který potřebujete.

Vzorová ukázka kompletní změny jazyka na fakturách:

add_filter( 'idoklad_language_code', 'toret_net_custom_idoklad_language', 10, 3 );
function toret_net_custom_idoklad_language( $lang, $order_id, $order ){

return 'en-US';

}

add_filter( 'idoklad_request_language_code', 'toret_net_custom_idoklad_language2', 10, 1 );
add_filter( 'idoklad_language_code_faktura', 'toret_net_custom_idoklad_language2', 10, 1 );

function toret_net_custom_idoklad_language2( $lang ){

return 'en-US';

}

Ovlivnění odeslání faktury/proformy do iDokladu

V případě, že potřebujete nějakým způsobem ovlivnit odesílání faktur a proforem do iDokladu,  můžete použít dva filtry, jenž jsou k dispozici:

Změna jazyku pdf faktury a proformy

Na rozdíl od filtru, který určuje, v jakém jazyce je doklad vystavován, tak tento filtr umožňuje změnit výchozí jazyk, v kterém je získáván pdf soubor.

Při vytvoření proformy, nebo faktury, odesílá plugin informaci o tom v jakém jazyce je doklad. Při requestu pro zobrazení pdf souboru se odesílá header s defaultně nastavenou češtinou. Pokud z nějakého důvodu potřebujete změnit tuto hodnotu, použijte následující filtr:

Nastavení stavu zaplacené faktury

Pokud používáte pro kontrolu zaplacenosti faktur soubor control.php, můžete potřebovat změnit stav, na který se objednávky při spárování změní. Ve výchozím stavu to je completed. Pro změnu použijte následující filtr:

Změna popisu faktury a proformy

V případě, že potřebujete nějakým způsobem ovlivnit popis faktury, nebo proformy, můžete použít následující filtry:

apply_filters('idoklad_invoice_description', $description, $order_id)
apply_filters( 'idoklad_proforma_description', $description, $order_id );

Změna čísla objednávky faktury

Jako číslo objednávky se do iDokladu zasílá $order_id. V případě, že to potřebujete ovlivnit, použijte tento filtr:

Přidání kurzu měny do faktury

API iDokladu obsahuje pro faktury a proformy možnost přidat kurz měny a jeho číselnou hodnotu – ExchangeRate a ExchangeRateAmount.

Protože měny a jejich přepínání nejsou ve WooCommerce ve výchozím stavu, je v pluginu způsob, jak do faktur pomocí filtrů tyto hodnoty přidat.

ExchangeRateAmount určuje, zda je kurz počítaný pro 1, 10, nebo 100 ekvivalentů měny. Například ruský rubl bude mít rate amount 100.

Přidání prodejky

Filtr do iDokladu pro aktivaci prodejky:

$stvrzenka = apply_filters( 'idoklad_pdf_with_stvrzenka', false );

Odložení tvorby faktury/proformy

idoklad_send_proforma_postpone nebo idoklad_send_invoice_postpone a vrácením hodnoty true

Změna stavu, při kterém se dokument označí jako zaplacený

 idoklad_pay_invoice_on_status s parametry $status, $payment_method a $order_id

Změna stavu, při kterém se dokument vytvoří

idoklad_create_invoice_on_status s parametry $status, $payment_method, $document_type a $order_id

Časté dotazy

Debugování chyb

Vzhledem k tomu, že se vždy může něco pokazit, má plugin vestavěný způsob zachytávání chyb.

V detailu objednávky, kde se vyskytla chyba, najdete v pravém horním rohu iDoklad log, který se vztahuje pouze na konkrétní otevřenou objednávku.

V přehledu pluginů od Toretu najdete iDoklad log, který obsahuje všechny objednávky najednou.

Do iDoklad.cz se posílají špatně zaokrouhlené částky

Zkontrolujte nastavení WordPress a ujistěte se, že je ve WooCommerce povoleno pracovat s alespoň dvěma desetinnými místy.

Nastavení najdete ve WooCommerce → Nastavení, záložka Obecné, položka Počet desetinných míst.