Tato sekce rozšiřuje stručné FAQ z hlavní příručky. Obsahuje praktické odpovědi pro administrátory i zákaznickou podporu e-shopu.
Napojení na API
Otázka: „Po uložení se zobrazí hláška, že přístupové údaje chybí.“
Řešení: Zkontrolujte, že jsou vyplněné slug, e-mail, Client ID a Client Secret. Odstraňte mezery zkopírované z PDF. Hláška 401 Unauthorized znamená špatný Client Secret.
Otázka: „Server blokuje odchozí požadavky.“
Řešení: Požádejte hosting o povolení cílové adresy https://api.fakturoid.cz. Dočasně lze testovat přes lokální prostředí, ale produkční provoz musí probíhat ze serveru.
Proformy a faktury
Otázka: „Proforma vzniká dvakrát.“
Řešení: Obvykle jde o souběh automatické a ruční akce. Zkontrolujte, zda nemáte vlastní hook na woocommerce_order_status_changed. Ujistěte se, že Fakturoid_Hookers::maybe_auto_create_invoice_on_status_change běží pouze jednou.
Otázka: „Finální faktura nemá číslo řady z Fakturoidu.“
Řešení: Vyberte řadu v nastavení po načtení API údajů. Pokud je řada nová, ve Fakturoidu klikněte na „Obnovit“ a stránku uložte znovu.
E-maily a přílohy
Otázka: „PDF se nepřipojuje, ale odkaz funguje.“
Řešení: Fakturoid nestihl PDF stáhnout v limitu. V logu hledejte cURL error 28. Zvyšte timeout nebo preferujte webové odkazy, zejména u faktur s mnoha položkami.
Otázka: „Zákazník nenašel e-mail.“
Řešení: Aktivujte logování e-mailů (např. WP Mail Logging). Ověřte, že WooCommerce e-mail customer_completed_order není vypnutý.
Refundy a storna
Otázka: „Refund proběhl ve dvou krocích a Fakturoid hlásí chybu 409.“
Řešení: Fakturoid dovoluje jen jeden opravný doklad. Proveďte refund v jedné akci nebo upravte existující doklad ručně.
Otázka: „Storno proformy neproběhlo, píše že byla zaplacená.“
Řešení: Uhrazenou proformu nelze smazat. Vystavte dobropis, proformu ve Fakturoidu ručně označte jako stornovanou a informujte zákazníka.
Webhooky a notifikace
Otázka: „Webhook hlásí neplatný podpis.“
Řešení: Vygenerujte nový Webhook Secret v administraci a aktualizujte ho ve Fakturoidu. Ověřte správný parametr ?key=.... U proxy služeb whitelistujte hlavičky.
Otázka: „Stav se nemění ani po označení faktury jako zaplacené.“
Řešení: Zkontrolujte tabulku logů wc_fakturoid_api_logs – pokud vidíte 403 Forbidden, webhook není autorizovaný. Ujistěte se, že WP cron běží (příkaz wp cron event run fakturoid_process_webhook_queue).
Licence a aktualizace
Otázka: „Po aktualizaci pluginu licence zmizela.“
Řešení: Některé hostingy blokují wp_remote_post. Klikněte na Aktualizovat stav licence a dočasně vypněte firewall pluginy.
Otázka: „Potřebuji licenci pro staging.“
Řešení: Kontaktujte dodavatele – často poskytuje jeden staging web zdarma nebo nabídne multi-licenci.
Migrace mezi weby
Otázka: „Po přesunu databáze tokeny nefungují.“
Řešení: Otevřete sekci Napojení na API a klikněte na Uložit změny. Token se vygeneruje pro nové prostředí.
Otázka: „Staré odkazy ke stažení přestaly fungovat.“
Řešení: Pravděpodobně jste změnili bezpečnostní salt. Informujte zákazníky, že mají použít nové odkazy, nebo je vygenerujte znovu.
Logování a diagnostika
Otázka: „Logy se plní a zpomalují web.“
Řešení: Přepněte na „Pouze chyby“ a zapněte automatické mazání (30 dní). Staré záznamy smažte ručně v databázi.
Otázka: „Soubor debug.log je příliš velký.“
Řešení: Vypněte debug, soubor archivujte a smažte. Dbejte na odstranění citlivých údajů před sdílením.
Další zdroje
Pokud problém přetrvává, přiložte screenshoty logů a objednávky a kontaktujte podporu na podpora@ceskepluginy.cz – uveďte číslo objednávky a přesný čas chyby.