Nastavení webhooku

Webhook umožňuje měnit stavy ve WooCommerce při změně stavu ve Fakturoidu. 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.

Správa webhooků přes API (doporučeno)

Plugin umožňuje spravovat webhooky přímo z nastavení bez nutnosti ručního kopírování URL do Fakturoidu.

Prerekvizity

1. V nastavení Fakturoidu přejděte do Nastavení → Uživatelský účet → API
2. Povolte správu webhooků přes API

Vytvoření webhooku

1. V nastavení pluginu přejděte na záložku Webhook
2. Klikněte na tlačítko Vytvořit webhook pro tento web
3. Plugin automaticky vytvoří webhook s potřebnými událostmi a správnou URL

Přehled webhooků

V sekci Fakturoid webhooky se zobrazují všechny webhooky vytvořené přes API. U každého webhooku vidíte:

• URL — cílová adresa webhooku
• Události — seznam sledovaných událostí
• Aktivní — zda je webhook aktivní
• Poslední aktualizace — datum poslední aktualizace

Webhooky jsou rozlišeny na:

• Tento web — webhook patří tomuto webu, lze ho aktualizovat nebo smazat
• Jiný web — webhook patří jinému webu (např. jiná instalace v multisite), zobrazuje se pouze informativně

Manuálně vytvořené webhooky

V přehledu se zobrazují pouze webhooky vytvořené přes API. Manuálně vytvořené webhooky ve Fakturoidu zde nejsou viditelné, ale zůstávají funkční — viz sekce Legacy nastavení níže.

Aktualizace webhooku

Kliknutím na Aktualizovat u webhooku tohoto webu se aktualizuje URL, autentizační token a seznam sledovaných událostí na aktuální hodnoty.

Smazání webhooku

Kliknutím na Smazat u webhooku tohoto webu se webhook odstraní z Fakturoidu.

Kontrola nedoručených webhooků

Kliknutím na Zkontrolovat nedoručené webhooky u webhooku tohoto webu se zkontrolují nedoručené webhooky za posledních 60 dní. Pokud nejsou žádné nedoručené webhooky, zobrazí se potvrzení. V opačném případě se zobrazí tabulka s detaily chyb (událost, typ chyby, datum).

Kdy kontrolovat

Kontrolu doporučujeme provést po vytvoření webhooku pro ověření, že komunikace mezi Fakturoidem a vaším webem funguje správně.

Legacy nastavení (ruční konfigurace)

Pro zpětnou kompatibilitu je možné webhook nakonfigurovat ručně.

V nastavení pluginu

1. Do pole Tajný klíč zadejte libovolný řetězec alfanumerických znaků sloužící k zabezpečení webhooku
2. Uložte nastavení
3. Zkopírujte celou URL adresu webhooku (nachází se v popisu legacy nastavení)

V nastavení účtu Fakturoid

1. Přejděte do Nastavení → Napojení na jiné aplikace

2. Proklikněte se do části Webhooky

3. Klikněte na tlačítko Nový webhook
4. Vložte zkopírovanou URL adresu z nastavení pluginu

5. Vyberte podporované akce

Doporučené nastavení akcí

U Faktury doporučujeme zaškrtnout vše kromě „Vytvořena”. U ostatních položek (Proforma, Opravný doklad atd.) ponechte vše vypnuté.

6. Nastavení uložte

Nastavení platebních metod

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

Zakázání změny stavu pro určité objednávky

V nastavení pluginu můžete definovat stavy objednávek, u kterých webhook nebude měnit stav. Toto je užitečné například pokud nechcete, aby se u již dokončených nebo zrušených objednávek měnil stav na základě událostí z Fakturoidu.

V poli Zakázat změnu objednávek vyberte stavy objednávek, při kterých se stav nebude měnit ani při příchozí události z webhooku.

Například:

• Pokud vyberete stav „Dokončeno”, tak u dokončených objednávek se stav nezmění, i když přijde webhook o uhrazení faktury
• Pokud vyberete stav „Zrušeno”, zrušené objednávky zůstanou zrušené bez ohledu na události z Fakturoidu