Jak napojit Fakturoid do WooCommece

Provozujete e-shop na WooCommerce a chcete, aby se k objednávkám automaticky vystavovaly faktury ve Fakturoidu? Plugin WPify Woo Fakturoid vám právě tohle umožní – a zvládne to během pár minut od instalace.

Plugin vyvíjí společnost WPify s.r.o., tvořená certifikovanými WordPress a WooCommerce specialisty s více než 15letou praxí v oboru. Tým WPify stojí i za řadou dalších pluginů pro české a slovenské e-shopy – platební brány, dopravce, feedy. Fakturoid integrace je součástí téhož ekosystému, takže všechno funguje pospolu bez konfliktů.

Doplněk není přímou součástí Fakturoidu a je placený doplněk od třetí strany. Pro otestování napojení si vystačíte s bezplatným tarifem Fakturoidu (1 500 API požadavků/měsíc, 5 kontaktů). Pro ostrý provoz budete potřebovat některý z placených tarifů, které nabízejí neomezený počet odběratelů a vyšší limity API.

Co plugin umí a proč právě WPify

WPify Woo Fakturoid není jen přemostění mezi e-shopem a Fakturoidem. Je to kompletní fakturační automatizace, která počítá s reálnými potřebami českých a slovenských e-shopů:

• Automatické generování proforem, faktur i opravných dokladů – na základě změny stavu objednávky, individuálně pro každou platební metodu.
• Webhook pro automatické párování plateb – když Fakturoid zjistí přijetí platby na bankovním účtu, plugin automaticky změní stav objednávky ve WooCommerce. Plugin webhook za vás vytvoří sám.
• Faktura v e-mailu, na děkovné stránce i v zákaznickém účtu – jako odkaz na webfakturu nebo jako PDF příloha. Vy si zvolíte, co vám vyhovuje.
• OSS, přenesená DPH, více měn – prodáváte do zahraničí? Plugin si poradí s režimy DPH i různými měnami na fakturách.
• Filtrovaní objednávek podle stavu fakturace – přímo v přehledu objednávek ve WooCommerce vidíte, které objednávky mají fakturu, proformu nebo čekají na zpracování.
• Podrobná dokumentace a filtry pro vývojáře – potřebujete upravit data na faktuře, změnit kontaktní údaje nebo deaktivovat automatiku pro určité objednávky? Všechno je zdokumentováno včetně hotových snippetů.

Součást ekosystému WPify Woo

WPify nevyvíjí jen Fakturoid integraci. Vtvořili mimo jiné i bezplatný základní plugin WPify Woo, který pokrývá to, co český e-shop na WooCommerce nutně potřebuje – včetně modulu pro IČO/DIČ pole v pokladně s validací přes ARES a VIES, kontrolou odpočtů DPH i OSS a veškerá data připravuje pro tento plugin, který s nimi dále pracuje. Všechny pluginy sdílí společný základ, načítají se jen ty aktivní a vzájemně si nekonkurují o zdroje, a naopak spolu spolupracují. Pro e-shop to znamená méně pluginů, méně konfliktů a rychlejší načítání.

Jak napojení funguje

Plugin komunikuje s Fakturoidem přes oficiální API v3 – nejnovější verzi rozhraní s lepším zabezpečením a podporou webhooků.

Typický scénář: Platba převodem

1. Zákazník odešle objednávku. Plugin automaticky vygeneruje proforma fakturu ve Fakturoidu a vloží tlačítko pro stačení do e-mailu se shrnutím objednávky, nebo jako přílohu emailu.
2. Zákazník zaplatí na účet. Fakturoid (napojený na vaši banku) spáruje platbu s proformou a automaticky vygeneruje finální fakturu.
3. Webhook informuje e-shop. Plugin změní stav objednávky (např. na „Zpracovává se“) a stahne finální fakturu z Fakturoidu a zákazníkovi ji odešle/zobrazí.

Nastavení krok za krokem

Celé nastavení zabere zhruba 10 minut. Potřebujete aktivní účet u Fakturoidu a zakoupený plugin WPify Woo Fakturoid.

1. Připravte si API přístupové údaje ve Fakturoidu

1. Přihlaste se do Fakturoidu a přejděte do Nastavení → Uživatelský účet.

• V sekci API v3 přístupové údaje zadejte název (např. „WPify Woo Fakturoid“) a klikněte na Vygenerovat.

• Nyní máte na stránce účtu veškeré potřebné údaje k dispozici ke zkopírování do nastavení pluginu. Budete potřebovat:
  • Název (doménu) účtu (1)
  • • E-mail účtu (2)
  • • Client ID (3)
  • • Client Secret (4)

2. Nainstalujte plugin

1. Zakupte WPify Woo Fakturoid na wpify.cz/produkt/wpify-woo-fakturoid/.

• Po zaplacení obdržíte e-mail se ZIP souborem a přístupem do uživatelského účtu.

• Ve WordPress administraci přejděte do Pluginy → Přidat plugin → Nahrát plugin.

• Vyberte stažený soubor wpify-woo-fakturoid.zip a nainstalujte.

• Po instalaci plugin rovnou aktivujte.

• Přejděte do WPify → WPify Woo Fakturoid a klikněte na Aktivovat doménu.

• Přihlásíte se na WPify.cz pod vaším účtem vytvořeným při nákupu, potvrďte aktivaci licence pro vaši doménu a jste zpět v nastavení s aktivní licencí.

3. Propojte plugin s Fakturoidem

V nastavení pluginu (WPify → WPify Woo Fakturoid) vyplňte údaje získané ve vašem účtu v kroku 1:

• Doménu účtu – Název vašeho Fakturoid účtu (1)
• E-mail – e-mailová adresa majitele účtu (2)
• Client ID (3) a Client Secret (4)

Uložte. Plugin se propojí s Fakturoidem a ověří spojení.

4. Nastavte platební metody

Tohle je jádro celého nastavení. V nastavení plugin přejděte do záložky „Platební metody“.

Plugin zobrazí seznam všech platebních metod, které máte v e-shopu aktivní. U každé metody zvolíte:

• Jak se metoda zobrazí na faktuře (Způsob platby ve Fakturoidu)
• Při jakém stavu objednávky se vygeneruje proforma (např. „Čeká na vyřízení“ pro bankovní převod)
• Při jakém stavu se vygeneruje faktura (např. „Zpracovává se“ pro platbu kartou)

5. Nastavte webhook (volitelné, ale doporučené)

Pokud máte Fakturoid propojený s bankou, webhook zajistí, že při uhrazení faktury se automaticky změní stav objednávky i dokladů ve WooCommerce.

V nastavení účtu Fakturoid se ujistěte, že máte povolený správu webhooku přes API.

1. Přihlaste se do Fakturoidu a přejděte do Nastavení → Uživatelský účet.

• V sekci API v3 přístupové údaje u vašeho napojení zkontrolujte zda je text „Správa webhooků přes API je povolená.“. Pokud ne dejte upravit a tuto funkci zapněte a uložte

V nastavení pluginu přejděte do záložky Webhook a klikněte na tlačítko Vytvořit webhook pro tento web. Tím se webhook sám nastaví a vytvoří. Nový webhook bude vidět v přehledu webhooků.

V pluginu pak u požadovaných platebních metod zvolte změnu stavu objednávky pomocí webhooku po uhrazení ve Fakturoidu.

A je to. Objednávky se od teď budou automaticky fakturovat.

A to zdaleka není vše

Výše popsané nastavení pokrývá základní scénář. Plugin toho ale umí mnohem víc – například automatické generování opravných daňových dokladů (i částečných při částečném vrácení objednávky), storno faktur nebo manuální zasílání upomínek, přiřazení dokumentů k objednávkám i synchronizaci dat z Fakturoidu. Podrobné informace o všech nastaveních a možnostech najdete v dokumentaci: docs.wpify.cz/cs/wpify-woo-fakturoid/

Na co dát pozor

Důležité: Ve Fakturoidu v Nastavení → Banka a párování musíte mít uložený bankovní účet. Bez něj Fakturoid faktury nevygeneruje.

Důležité: Režim plátce DPH musí být správně nastavený jak ve Fakturoidu, tak ve WooCommerce – musí se shodovat.

• Plugin vyžaduje WordPress 6.2+, WooCommerce 8.0+ a PHP 8.1+. Starší verze nejsou podporovány.
• Licence se platí ročně. S aktivní licencí máte přístup k aktualizacím a podpoře. Po vypršení plugin funguje dál, ale nedostanete nové verze.
• Před ostrým provozem otestujte na testovací objednávce. Ověřte, že se generují správné doklady a e-maily odcházejí se správnými přílohami.

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

„Faktury se negenerují automaticky.“

Zkontrolujte nastavení platebních metod – u každé metody musí být zvolen stav objednávky, při kterém se má doklad vygenerovat. Pokud je pole prázdné, plugin pro danou metodu nic negeneruje. Ověřte také, že je propojení s Fakturoidem aktivní (viditelné v nastavení pluginu).

„Fakturoid hlásí chybu při generování faktury.“

Nejčastější příčinou je chybějící bankovní účet v nastavení Fakturoidu. Přejděte do Nastavení → Banka a párování a zkontrolujte, že je účet uložený. Kompletní přehled chybových hlášek a jejich řešení najdete v dokumentaci: docs.wpify.cz/cs/wpify-woo-fakturoid/troubleshooting/errors/

„Stav objednávky se nemění po uhrazení.“

Ověřte, že v API přístupových údajích ve Fakturoidu máte povolenu správu webhooků (zelené šoupátko). Dále zkontrolujte, že v nastavení pluginu máte zvolený cílový stav objednávky.

„Chci faktuře přiložit k e-mailu jako PDF.“

V nastavení pluginu naleznete volbu pro zasílání faktury jako přílohy v e-mailu. Alternativně můžete použít odkaz na webfakturu – zákazník si fakturu zobrazí v prohlížeči a může si ji stáhnout jako PDF, zaplatit online přes GoPay/PayPal, případně přidat do svého Fakturoidu do nákladů.

„Potřebuji upravit data, která plugin posílá do Fakturoidu.“

Plugin nabízí sadu PHP filtrů a akcí pro vývojáře – můžete upravit data kontaktu, dokumentu, platby, deaktivovat automatiku pro konkrétní objednávky a další. Vše včetně hotových příkladů najdete v sekci „Pro vývojáře“ v dokumentaci.

„Kde najdu diagnostiku, když něco nefunguje?“

Plugin obsahuje vestavěné diagnostické nástroje. Podrobně popsáno v dokumentaci: docs.wpify.cz/wpify-woo-fakturoid/troubleshooting/debugging/