Skip to content
WPify Documentation

Chyby a jejich oprava

Tento průvodce obsahuje nejčastější chyby při používání pluginu WPify Woo Fakturoid a postupy pro jejich řešení.

Chyby při nastavení pluginu

Section titled “Chyby při nastavení pluginu”

Critical Error při ukládání API údajů

Section titled “Critical Error při ukládání API údajů”

Problém: Po zadání Client ID a Client Secret a kliknutí na “Uložit změny” se zobrazí Critical Error nebo Fatal Error s hlášením podobným:

Fatal error: Uncaught Error: Call to a member function getAccountProvider() on null

Příčina: Tato chyba se vyskytovala ve starších verzích pluginu při prvním ukládání nastavení nebo při neplatných API údajích.

Řešení:

  1. Aktualizujte plugin na nejnovější verzi (minimálně 5.2.7)
  2. Zkontrolujte, že Client ID a Client Secret jsou správně zkopírované z Fakturoidu bez mezer na začátku a konci
  3. Ověřte, že máte správně vyplněnou doménu účtu a e-mail

Prázdné nastavení / nastavení se nenačítá

Section titled “Prázdné nastavení / nastavení se nenačítá”

Problém: Po otevření nastavení pluginu se zobrazí prázdná stránka nebo chybí formulářová pole.

Řešení:

  1. Aktualizujte plugin na nejnovější verzi
  2. Zkuste deaktivovat a znovu aktivovat plugin
  3. Zkontrolujte, zda nemáte konflikt s jiným pluginem (např. Packeta)

Chyby při vytváření kontaktu

Section titled “Chyby při vytváření kontaktu”

Subject id missing / [401 Unauthorized]

Section titled “Subject id missing / [401 Unauthorized]”

Problém: Vámi nastavené údaje pro napojení s Fakturoid účtem nebyli nalezeny nebo neprošli autorizací.

Řešení: Zkontrolujte zda máte údaje k napojení správně nastavené.

Neplatné DIČ. Obsahuje kód státu? [422 Unprocessable Entity]

Section titled “Neplatné DIČ. Obsahuje kód státu? [422 Unprocessable Entity]”

Problém: Fakturoid odmítá vytvořit kontakt s chybou validace DIČ.

Příčina: DIČ zákazníka neobsahuje kód státu na začátku (např. 12345678 místo CZ12345678).

Řešení:

  1. Zkontrolujte DIČ v objednávce zákazníka
  2. DIČ musí obsahovat prefix státu (CZ, SK, DE, …)
  3. Pokud používáte plugin pro IČO/DIČ, zkontrolujte jeho nastavení

Chyba 5xx

Section titled “Chyba 5xx”

Problém: API Fakturoidu je dočasně nedostupný.

Řešení: Zkuste požadavek opakovat později.

Chyba 429 Too Many Requests

Section titled “Chyba 429 Too Many Requests”

Problém: Byl překročen povolený počet požadavků z jedné IP adresy (200 požadavků za minutu).

Řešení: K takovému počtu požadavků by nemělo docházet a je určitě potřeba zjistit příčinu takového chování.

Chyba 402 Payment Required

Section titled “Chyba 402 Payment Required”

Problém: Váš Fakturoid účet byl zablokován.

Řešení: Vyřešte příčinu blokace účtu. Pravděpodobně nemáte uhrazeno další období tarifu.

Chyba 404

Section titled “Chyba 404”

Problém: Subjekt nebo dokument nebyl nalezen.

Řešení: Zkontrolujte zda se nachází v systému Fakturoid.

Chyba při vytváření kontaktu: Bylo dosaženo maximálního počtu kontaktů [403 Forbidden]

Section titled “Chyba při vytváření kontaktu: Bylo dosaženo maximálního počtu kontaktů [403 Forbidden]”

Problém: V rámci vašeho tarifu bylo dosaženo maximálního počtu kontaktů.

Řešení: Přejděte na vyšší tarif Fakturoid.

Chyba při vytváření faktury [403 Forbidden]

Section titled “Chyba při vytváření faktury [403 Forbidden]”

Problém: Ve vašem Fakturoid účtu není zadaný bankovní účet.

Řešení: Přejděte do nastavení Fakturoid účtu a vložte bankovní účet.

Chyba při vytváření kontaktu/faktury [422 Unprocessable Entity]

Section titled “Chyba při vytváření kontaktu/faktury [422 Unprocessable Entity]”

Problém: Do Fakturoidu došlo k zaslání nevalidních dat.

Řešení: Upravujete data vlastním snippetem? Zkontrolujte zda vracíte validní data.

Chyby při provádění akcí [422 Unprocessable Entity]

Section titled “Chyby při provádění akcí [422 Unprocessable Entity]”

Problém: Akci není možné u příslušného dokumentu provést.

Řešení: Zkontrolujte, zda je možné danou akci u konkrétního dokumentu provést.

Změny stavu objednávky pomocí webhooku nefungují

Section titled “Změny stavu objednávky pomocí webhooku nefungují”

Problém: Webhook není správně nakonfigurován.

Řešení: Pro správné fungování webhooku je zapotřebí mít vyplněný jedinečný klíč. Zkontrolujte správnost nastavení Webhooku a jeho zkopírování do účtu Fakturoid.

Problémy s DPH

Section titled “Problémy s DPH”

Špatná sazba DPH u dopravy (20% místo 21%)

Section titled “Špatná sazba DPH u dopravy (20% místo 21%)”

Problém: Na faktuře se u dopravy zobrazuje špatná sazba DPH.

Příčina: Plugin dopočítává DPH ze zaokrouhlených částek, pokud dopravní plugin (např. Zásilkovna) neukládá ID daňové sazby k položce.

Řešení:

  1. Zkontrolujte nastavení DPH ve WooCommerce (Nastavení > Daň)
  2. Ověřte, že máte správně nastavený počet desetinných míst
  3. Zkontrolujte nastavení cen dopravy - doporučujeme zadávat ceny bez DPH a nechat WooCommerce DPH dopočítat

Problémy s generováním faktur

Section titled “Problémy s generováním faktur”

Faktury se negenerují automaticky

Section titled “Faktury se negenerují automaticky”

Problém: Propojení s Fakturoidem funguje, ale faktury/proformy se nevystavují.

Příčina: Nejsou správně nastavené stavy objednávek u platebních metod.

Řešení:

  1. Přejděte do nastavení pluginu > záložka Platební metody
  2. U každé platební metody nastavte, při jakém stavu objednávky se má generovat proforma/faktura
  3. Stavy musí odpovídat skutečnému workflow vašeho e-shopu:
    • Platba kartou: objednávka obvykle přechází do “Zpracovává se”
    • Platba převodem: objednávka přechází do “Čeká na vyřízení”
    • Dobírka: objednávka přechází do “Zpracovává se”

Objednávky se nepřepínají do stavu “Dokončeno”

Section titled “Objednávky se nepřepínají do stavu “Dokončeno””

Problém: Po zaplacení faktury ve Fakturoidu se objednávka nepřepne do očekávaného stavu.

Příčina: Webhook se volá pouze při změně stavu úhrady faktury. Pokud generujete fakturu už jako uhrazenou (ve stejném kroku), webhook se nezavolá.

Řešení:

  1. Oddělte generování faktury a její úhradu do různých stavů objednávky
  2. Nebo nastavte změnu stavu objednávky pomocí WooCommerce (ne přes webhook)

Na fakturách je špatný bankovní účet

Section titled “Na fakturách je špatný bankovní účet”

Problém: Na fakturách se zobrazuje starý nebo nesprávný bankovní účet.

Řešení:

  1. Přejděte do nastavení pluginu > záložka Obecné
  2. Zkontrolujte seznam bankovních účtů
  3. Přeuložte nastavení - plugin načte aktuální účty z Fakturoidu
  4. Pokud máte více účtů, můžete nechtěné zakázat v poli “Zakázané bankovní účty”

Časté dotazy (FAQ)

Section titled “Časté dotazy (FAQ)”
Přešel jsem z API v2 na v3 a plugin nefunguje

Od verze 5.x plugin používá nové Fakturoid API v3. Staré přihlašovací údaje (API token) již nefungují.

Řešení:

  1. V nastavení Fakturoidu (Nastavení > Uživatelský účet) vygenerujte nové Client ID a Client Secret
  2. Tyto údaje zadejte do nastavení pluginu
  3. Smažte staré pole “API klíč” pokud je stále vyplněné
Jak vytvořit opravný doklad jako neplátce DPH?

Neplátci DPH nemohou vystavovat opravné daňové doklady. Místo toho je potřeba fakturu stornovat.

Řešení:

  1. Ve Fakturoidu označte fakturu jako stornovanou
  2. Více informací: Storno faktury na Fakturoid.cz
Webhook mění stavy i u starých/dokončených objednávek

Řešení: V nastavení pluginu > záložka Webhook nastavte Zakázané stavy objednávek. Vyberte stavy (např. Dokončeno, Zrušeno), u kterých se nemá stav měnit na základě webhooků.

Mám více Fakturoid účtů - jak přepnout na jiný?

API údaje (Client ID, Client Secret) jsou vázané na konkrétní Fakturoid účet, ne na uživatelské přihlášení.

Řešení:

  1. V novém Fakturoid účtu vygenerujte nové API údaje
  2. V nastavení pluginu změňte doménu účtu a zadejte nové API údaje
  3. Uložte nastavení
HTML tagy nebo systémová metadata se zobrazují na faktuře

Tento problém byl opraven ve verzi 5.2.10.

Řešení:

  1. Aktualizujte plugin na nejnovější verzi
  2. Pokud problém přetrvává, vypněte volbu “Přidat meta data za název produktu” v obecném nastavení