Radek Venzhöfer · Fakturoid a fakturace
Fakturoid API a integrace
Fakturoid je oblíbený, protože je jednoduchý. Jednoduchý ale přestává být ve chvíli, kdy se do něj faktury přepisují z e-shopu, tabulky s hodinami nebo CRM. Přes Fakturoid API zařídím, aby faktury vznikaly samy z dat, která už máte.
Co přes API jde
Fakturoid API v3 pokrývá skoro všechno, co se ve Fakturoidu dělá ručně.
- vystavení a odeslání faktury
- kontakty a jejich aktualizace
- opakované faktury přes generátory
- náklady a přijaté doklady
- úhrady a stav faktur
- webhooky při změně faktury nebo platby
Odkud faktury vznikají
Faktura je většinou jen poslední krok — data pro ni už leží jinde.
- objednávky z e-shopu
- výkazy hodin a projektů
- smlouvy a předplatné v CRM
- rezervační a objednávkové systémy
- vlastní aplikace a interní nástroje
- tabulky, když nic lepšího není
Na co si dát pozor
Technické detaily, které rozhodují, jestli napojení vydrží roky, nebo týdny.
- přihlášení přes OAuth 2 a obnova tokenu
- povinná hlavička User-Agent s kontaktem
- limit 400 požadavků za minutu
- stejná objednávka nesmí vystavit dvě faktury
- dobropisy a storna, ne mazání faktur
- upozornění, když se faktura nevystaví
Domlouváme se česky nebo anglicky
Pracuji z Vysočiny pro klienty v Česku i jinde v Evropě. S vámi se domluvím česky, dokumentaci a předání dělám česky nebo anglicky podle toho, co vám víc vyhovuje.
FAQ
- Jak se k Fakturoid API přihlašuje?
- Fakturoid API v3 používá OAuth 2. Pro napojení vlastního účtu stačí tok Client Credentials — přístupové údaje si stáhnete v nastavení svého uživatelského účtu. Aplikace, které se připojují k účtům více firem, používají tok Authorization Code. Ke každému požadavku patří i hlavička User-Agent s názvem aplikace a kontaktním e-mailem, jinak ho Fakturoid odmítne.
- Zvládne API velké množství faktur?
- Fakturoid povoluje 400 požadavků za 60 sekund a při překročení vrací chybu 429. Pro běžný provoz je to dost. U hromadných akcí, třeba vystavení stovek faktur najednou, nastavím tempo tak, aby se nic neodmítlo a nic nevystavilo dvakrát.
- Postavil jste už něco s fakturací?
- Ano, vlastní nástroj Fakturyzator — generátor faktur pro české podnikatele, který doplňuje údaje o firmě z ARES podle IČO. S Fakturoidem propojený není, je to samostatná aplikace. Najdete ho v mém portfoliu.
- Jak se jiný systém dozví, že faktura byla zaplacená?
- Přes webhooky. Fakturoid při změně faktury pošle oznámení na zadanou adresu, takže e-shop nebo CRM může stav platby převzít hned, bez neustálého dotazování.
- Kolik takové napojení stojí?
- Jedno propojení, třeba faktury z e-shopu nebo z výkazů práce, bývá práce na jeden až tři týdny. Fakturoid má dobře popsané API, takže víc času obvykle zabere systém na druhé straně.
Kolik faktur se u vás měsíčně přepisuje ručně?
Popište mi, odkud se berou data pro vaše faktury a kdo je dnes do Fakturoidu zadává. Ve většině případů jde zadávání úplně vypustit.
Napsat Radkovi