Tento návod popisuje, jak plugin Fakturoid pro WooCommerce reaguje na zrušené objednávky. Zaměřuje se na automatické storno neuhrazených proforma faktur, aby stav dokladů odpovídal skutečnosti.

Proč tuto sekci řešit

  • Zákazník objednávku zrušil nebo ji obchodník odmítl → proforma faktura nesmí zůstat aktivní.
  • Plugin dokáže proformu stornovat ve Fakturoidu automaticky, čímž zabraňuje chybám v účetnictví.
  • Ušetříte čas účetnímu oddělení a minimalizujete riziko, že se zákazník pokusí později proformu uhradit.

Kde nastavení najdete

  1. WordPress administrace → České pluginy → Fakturoid pro WooCommerce.
  2. Sjeďte na sekci Zrušení objednávky (nachází se pod refundy).

Screenshoty:

  • Přepínač „Automaticky stornovat proformu při zrušení objednávky“.
  • WooCommerce objednávka se stavem Zrušeno a poznámkou od pluginu.
  • Detail proformy ve Fakturoidu po stornu (s logem „Stornováno“).

Dostupná volba a její dopad

Automaticky stornovat proformu při zrušení objednávky

  • Co dělá: Při přechodu objednávky do stavu cancelled nebo refunded (dle WooCommerce) plugin vyhledá související proformu ve Fakturoidu a odešle požadavek DELETE.
  • Požadavky:
    • Objednávka musí mít v metadatech _fakturoid_invoice_id záznam o proformě a stav proformy nesmí být zaplacený ani stornovaný.
    • Token OAuth musí být platný (řeší sekce Napojení na API).
  • Výsledek:
    • Proforma se ve Fakturoidu označí jako stornovaná.
    • Do objednávky se přidá poznámka Fakturoid: proforma #2026-00042 byla stornována.

Bezpečnostní poznámka: Pokud proformu někdo uhradil těsně před stornem objednávky, Fakturoid vrátí chybu 422 Unprocessable Entity – paid invoice cannot be deleted. Plugin tuto chybu zapíše do logu i do poznámky objednávky.

Scénáře a doporučené postupy

Zrušení před úhradou

  1. Objednávka je ve stavu Čeká na platbu a zákazník ji zruší.
  2. WooCommerce nastaví stav Zrušeno.
  3. Plugin stornuje proformu a poznámku uloží do objednávky.
  4. Není třeba další zásah.

Zrušení po úhradě

Pokud již proforma byla zaplacená (např. bankovní převod přišel později), Fakturoid stornování nedovolí. Doporučení: vystavte dobropis podle interních pravidel (viz kapitola Refundy) a peníze vraťte ručně.

Ruční storna

  • Pokud potřebujete výjimku (např. speciální smlouva), nechte přepínač vypnutý a proformy stornujte přímo ve Fakturoidu.
  • Můžete kombinovat automatické storno s ručním postupem – stačí přepínač dočasně vypnout, otevřít objednávku a po dokončení znovu zapnout.

Poznámky do WooCommerce

Po úspěšném stornu se objeví soukromá poznámka s přesným číslem proformy. Při chybě se uloží poznámka Fakturoid: storno proformy selhalo – ... s detailním popisem chyby. Tyto poznámky pomáhají podpoře i účetnictví rychle pochopit stav dokladů.

Logování a diagnostika

  • Akce se zapisuje do tabulky wc_fakturoid_api_logs, pokud máte zapnuté logování API („Pouze chyby“ nebo „Všechna volání“).
  • Při potížích přepněte logování na „Všechna volání“, zrušení zopakujte a zkontrolujte položku v administraci České pluginy → Logy Fakturoid.
  • Chybové kódy 401 nebo 403 signalizují problémy s tokenem – stačí znovu uložit sekci Napojení na API.

Nejčastější dotazy

  • Co když WooCommerce používá vlastní stav (např. customer-cancelled)? – Plugin reaguje na standardní stavy. Pokud používáte vlastní workflow, vytvořte automatické přemapování (např. přes Action Scheduler) na stav cancelled.
  • Zůstane po stornu nějaký záznam ve Fakturoidu? – Ano, proforma je vidět jako stornovaná. V historii uvidíte, kdy byla vytvořena a kdo stornoval.
  • Mohu automaticky znovu vystavit proformu? – Ne, plugin po stornu proformu znovu nevytváří. Pro novou objednávku je nutné proformu vygenerovat standardním procesem.

Doporučení pro screenshoty

  • Nastavení sekce s aktivovaným přepínačem.
  • Poznámka v objednávce po úspěšném stornu.
  • Detail proformy ve Fakturoidu s ikonou „Stornováno“.

Související kapitoly

Tip: Po zprovoznění automatického storna otestujte také scenáře refundů, aby byly pokryté všechny životní cykly objednávky.