Napojení Fakturoidu přes API na e-shop, CRM a další systémy
Pro firmy a živnostníky, kteří fakturují ve Fakturoidu a údaje do faktur přepisují z e-shopu, CRM, výkazů nebo tabulek. Fakturoid má veřejné API, přes které se faktury dají vystavovat automaticky a stav úhrad vracet zpět do ostatních systémů.
- Fakturoid má veřejné REST API ve verzi 3 s autorizací OAuth 2 a webhooky, které hlásí změny, například zaplacení faktury.
- Přes API lze zakládat kontakty a faktury, odesílat je e-mailem, zapisovat úhrady, pracovat s náklady a skladovými položkami.
- Typická napojení: e-shop nebo rezervační systém vystaví fakturu, CRM ji založí z obchodu, výkazy práce se vyfakturují na konci měsíce.
- Webhooky vyžadují placený tarif Fakturoidu; pro vlastní napojení vlastního účtu slouží tok Client Credentials, pro aplikace pro více účtů tok Authorization Code.
- Hotové napojení existuje pro řadu služeb; na míru se staví, když potřebujete vlastní logiku nebo systém bez hotového konektoru.
Kdy se napojení Fakturoidu vyplatí
Fakturoid je oblíbený právě proto, že je jednoduchý. S rostoucím počtem faktur se ale objeví ruční práce kolem něj:
- každá objednávka z e-shopu nebo rezervace se ručně přepisuje do faktury,
- obchodník uzavře zakázku v CRM a fakturantka ji zakládá znovu ve Fakturoidu,
- hodiny z výkazů se na konci měsíce sčítají v tabulce a přepisují do položek,
- v CRM nebo e-shopu nikdo neví, zda zákazník už zaplatil,
- stejný zákazník je ve třech systémech se třemi různými adresami.
Pokud jde hlavně o vystavování faktur z různých zdrojů, obecný postup popisujeme u automatizace fakturace.
Co umí Fakturoid API v3
API je dostupné na adrese app.fakturoid.cz/api/v3 a většina operací se vztahuje ke konkrétnímu účtu. Podle oficiální dokumentace nabízí mimo jiné:
| Oblast | K čemu se v napojení hodí |
|---|---|
| Kontakty (subjekty) | Založení nebo aktualizace zákazníka z e-shopu či CRM |
| Faktury | Vystavení, odeslání, storno, stažení PDF |
| Úhrady faktur | Zápis platby, když se páruje mimo Fakturoid |
| Náklady | Přijaté doklady a jejich úhrady |
| Skladové položky a pohyby | Jednoduchá evidence skladu |
| Generátory a pravidelné faktury | Opakovaná fakturace, předplatné |
| Webhooky | Okamžité upozornění na vystavení, odeslání, zaplacení nebo upomínku |
Každý požadavek musí obsahovat hlavičku User-Agent s názvem aplikace a kontaktním e-mailem. API má limit počtu požadavků za časové okno, aktuální hodnotu vrací v hlavičkách odpovědi.
Jak napojení funguje krok za krokem
- Autorizace. Pro napojení vlastního účtu se používá OAuth 2 tok Client Credentials, pro aplikaci, kterou používá více firem, tok Authorization Code. Přístupový token platí omezenou dobu a obnovuje se automaticky.
- Zákazník. Integrace najde kontakt podle IČO nebo e-mailu, případně ho založí. Tím se zabrání duplicitám.
- Faktura. Z objednávky, obchodu v CRM nebo z výkazů se sestaví položky, sazby DPH, splatnost a variabilní symbol. Faktura se vystaví a podle nastavení rovnou odešle.
- Úhrada. Fakturoid umí u podporovaných bank sám párovat platby. Jinak integrace zapíše úhradu přes API z vlastního párování.
- Zpětná informace. Webhook o zaplacení nebo upomínce se propíše do e-shopu, CRM nebo interního systému. Obchodník vidí, kdo zaplatil, bez otevírání Fakturoidu.
Fakturoid opakuje doručení webhooku, když přijímající strana neodpoví včas, a každé doručení nese identifikátor, podle kterého se dá poznat opakovaná zpráva. Přijímající aplikace tak může stejnou událost zpracovat jen jednou, i když dorazí víckrát. Neúspěšná doručení lze podle dokumentace dohledat přes API.
Hotová integrace, integrační platforma, nebo na míru
- Hotová integrace. Fakturoid má napojení na řadu e-shopů, platebních a dalších služeb. Pokud Vaše kombinace existuje a dělá, co potřebujete, začněte jí.
- Integrační platforma. Make, n8n nebo Zapier mají pro Fakturoid moduly nebo se napojí přes obecné HTTP volání. Hodí se pro jednodušší toky s malým objemem. Srovnání v článku n8n vs. Make vs. vývoj na míru.
- Napojení na míru. Vyplatí se při složitějším sestavování položek, například z výkazů a sazeb podle zakázky, při více systémech najednou nebo když potřebujete spolehlivé hlídání chyb a historii. Pro propojení s CRM viz propojení CRM a účetnictví.
Na co si dát pozor
- Přechod ze starší verze API. Starší integrace postavené na předchozí verzi API je potřeba převést na v3 a jejich autorizaci na OAuth 2.
- Duplicitní faktury. Když integrace selže uprostřed a zkusí to znovu, nesmí vystavit fakturu dvakrát. Ukládejte vazbu mezi objednávkou a fakturou.
- Tarif. Některé funkce, například webhooky, jsou jen v placených tarifech. Ověřte to předem.
- Limity požadavků. Hromadné operace, třeba převod historie, musí respektovat limit API a čekat, když ho dosáhnou.
- Kde se doklady upravují. Ruční úprava faktury ve Fakturoidu by se měla propsat zpět, nebo musí být jasné, že ji integrace nepřepíše.
- Bezpečné uložení přístupů. Client ID a secret patří do zabezpečeného úložiště, ne do sdílené tabulky nebo e-mailu. Při odchodu dodavatele nebo zaměstnance je vygenerujte znovu.
- Kontrola webhooků. Adresa, na kterou Fakturoid posílá webhooky, by měla ověřovat autorizační hlavičku, aby zprávy nemohl podvrhnout někdo jiný.
Jak napojení Fakturoidu postavíme my
V rozboru projdeme, odkud data do faktur přicházejí, kdo dnes faktury vystavuje a kam se má vracet informace o úhradě. Pokud stačí hotová integrace, řekneme to. Jinak dostanete návrh s rozsahem a cenou předem. Stavíme po částech, nejdřív kontakty a vystavování faktur, potom úhrady a webhooky, a vše testujeme na zkušebním účtu, než se přepne na ostrý. KUDEN není oficiálním partnerem Fakturoidu, stavíme nad jeho veřejným API.
Napojení je součástí služby AI automatizace a propojení systémů. Z čeho se skládá cena, popisuje stránka kolik stojí automatizace. Ozvěte se přes kontakt.
Časté otázky
Má Fakturoid API?
Ano, Fakturoid má veřejné REST API ve verzi 3. Autorizace probíhá přes OAuth 2 a API umožňuje práci s kontakty, fakturami, úhradami, náklady, skladem a webhooky. Dokumentace je na webu Fakturoidu.
Jak napojit Fakturoid na Shoptet nebo jiný e-shop?
Nejdřív ověřte, zda pro Váš e-shop existuje hotová integrace. Pokud ne, napojení se postaví přes API: z objednávky se založí kontakt a faktura, a informace o úhradě se vrací zpět do e-shopu. Pro jednodušší případy lze použít i integrační platformu.
Umí Fakturoid sám poslat informaci, že faktura byla zaplacena?
Ano, přes webhooky. Při zaplacení faktury, odeslání nebo jiných změnách pošle Fakturoid zprávu na zadanou adresu Vaší aplikace. Webhooky jsou dostupné v placených tarifech.
Jaký je rozdíl mezi Client Credentials a Authorization Code ve Fakturoidu?
Client Credentials je určený pro skripty a služby, které pracují jen s Vaším vlastním účtem. Authorization Code je pro aplikace, které přistupují k účtům více uživatelů a každý uživatel jim přístup schvaluje. Pro firemní napojení vlastního účtu obvykle stačí Client Credentials.
Dá se ve Fakturoidu automaticky fakturovat z výkazů práce?
Ano. Integrace na konci období sečte výkazy podle zákazníka nebo zakázky, převede je na položky se sazbami a přes API vystaví fakturu, případně ji rovnou odešle. Důležité je mít výkazy ve strojově čitelné podobě.
Chcete to vyřešit ve Vaší firmě?
Napište nám, jak to u Vás dnes funguje. Ozve se Vám přímo člověk, který to bude stavět, a po krátkém hovoru dostanete rozsah a cenu předem. Víc o službě AI & automatizace.
Nebo rovnou: info@kuden.cz, +420 736 253 575