Tento dokument rozepisuje sekci Napojení na API v nastavení pluginu Fakturoid pro WooCommerce. Najdete ji ve WordPress administraci pod České pluginy → Fakturoid pro WooCommerce → karta Napojení na API.

Co si připravit předem

  • Administrátorský přístup do WordPressu a WooCommerce.
  • Firemní účet ve Fakturoidu s aktivovaným API v3.
  • Vytvořenou OAuth aplikaci typu Client credentials (Client ID, Client Secret, Account slug).
  • Kontaktní e-mail, který chcete uvádět v User-Agent hlavičkách (může být technický účet podpory).
  • Přehled aktivních platebních metod ve WooCommerce.

Kde nastavení najdete

  1. Přihlaste se do WordPress administrace.
  2. V levém menu klikněte na České pluginy a vyberte Fakturoid pro WooCommerce.
  3. Na stránce nastavení přejděte na první sekci Napojení na API.

Screenshot: Zachyťte celou sekci od názvu po tlačítko „Uložit změny“. Doporučené rozlišení 1440×900, formát PNG. Ujistěte se, že citlivé údaje (Client Secret) jsou rozmazané nebo zakryté.

Vyplnění polí krok za krokem

1. Slug Fakturoid účtu

  • Najdete jej ve Fakturoidu v Nastavení → Účet (např. moje-firma).
  • Zkopírujte přesné znění bez mezer a vložte do pole.
  • Tip: Pokud slug obsahuje pomlčky, musí být uvedeny přesně tak, jak jsou ve Fakturoidu.

2. E-mail Fakturoid účtu

  • Slouží jako identifikace v hlavičkách API požadavků.
  • Doporučujeme technický e-mail typu fakturoid@domena.cz, ke kterému má přístup tým podpory.
  • Bezpečnost: Nepoužívejte osobní adresy zaměstnanců, aby nedošlo k odhalení soukromých údajů.

3. Client ID

  • Ve Fakturoidu otevřete Nastavení → API → OAuth aplikace a zkopírujte hodnotu Client ID.
  • Vkládejte bez mezer, ideálně pomocí klávesové zkratky ⌘ + V / Ctrl + V.
  • Kontrola: Po vložení zkontrolujte, zda na začátku nebo konci nezůstaly mezery.

4. Client Secret

  • Zobrazí se pouze jednou při vytvoření OAuth aplikace.
  • Pokud ho nemáte, vytvořte novou aplikaci nebo použijte možnost „Reset secret“ ve Fakturoidu.
  • Uložte také do bezpečného správce hesel, protože bez něj se plugin nepřihlásí.

5. Spárování platebních metod

  • Každou aktivní WooCommerce platební metodu přiřaďte k typu, který Fakturoid rozpozná (bank, cash, cod, card, …).
  • Klikněte na seznam a vyberte odpovídající hodnotu. Přehled doporučených párů:
    • Bankovní převod → bank
    • Platba kartou → card
    • Dobírka → cod
    • Hotově na pobočce → cash
  • Tip: Pokud používáte pluginy třetích stran (např. ComGate, GoPay), zkontrolujte, zda WooCommerce vrací unifikovaný název metody.

Uložení a ověření

  1. Po vyplnění všech polí klikněte na Uložit změny (tlačítko pod sekcí).
  2. Plugin odešle testovací přihlášení a načte dostupné číselné řady.
  3. Úspěch poznáte podle informační hlášky nahoře: „Nastavení byla úspěšně uložena.“
  4. V případě chyby se zobrazí varování. Nejčastější zprávy:
    • Access token missing – špatně zadané Client ID/Secret nebo server blokuje požadavky na https://api.fakturoid.cz.
    • invalid_client – Fakturoid odmítl přihlašovací údaje, zkontrolujte slug i tajný klíč.

Screenshot (volitelné): Pokud nastane chyba, vyfoťte hlášku nad formulářem. Ověřte, že nejsou vidět tajné údaje.

Nejčastější otázky

  • Musím mít WooCommerce v nejnovější verzi? Doporučujeme 7.0 nebo vyšší, starší verze mohou mít jiné názvy stavů objednávek.
  • Mohu používat více Fakturoid účtů? Plugin podporuje jeden účet na instalaci. Pro různé obchody použijte samostatné WordPress instalace.
  • Co se stane, když token vyprší? Plugin si všimne expirovaného tokenu (platnost cca 2 hodiny) a automaticky požádá o nový, pokud jsou údaje správně.

Odstraňování problémů

SymptomyMožná příčinaDoporučené řešení
„Access token missing“Blokovaný HTTPS požadavek nebo špatné údajeZkontrolujte firewall hostingu, ověřte slug/Client ID/Secret, případně resetujte secret ve Fakturoidu.
WooCommerce padá po uloženíStará verze PHP (<7.4) nebo chybějící cURLAktualizujte PHP, ověřte, že je rozšíření cURL aktivní.
Nelze vybrat číselnou řaduPlugin ještě neuložil nastaveníUložte formulář, číselné řady se načtou při prvním úspěšném připojení.
API volání je příliš pomaléHosting omezuje odchozí dotazyKontaktujte hostingovou podporu s žádostí o whitelisting api.fakturoid.cz.

Screenshot checklist

  • Formulář Napojení na API s vyplněnými (anonymizovanými) poli.
  • Potvrzovací hláška po úspěšném uložení.
  • Chybová hláška (pokud dokumentujete problémové scénáře).
  • Náhled spárování platebních metod po rozkliknutí rozbalovacího menu.

Tip pro anonymizaci: Použijte nástroj jako macOS Preview nebo Windows Snipping Tool a citlivé údaje začerněte. Plugin se prezentuje lépe, když je jasné, která pole se vyplňují, ale tajná data nejsou čitelná.

Další kroky

Pokračujte na sekci Nastavení proforma faktur, kde se rozhoduje o vytváření zálohových dokladů. Kompletní přehled odkazů najdete v hlavní uživatelské příručce.