Napojení přes API: jak propojit FakturaOnline s vaším systémem
Co je API
API je způsob, jak spolu dva programy komunikují, aniž byste cokoli přepisovali ručně. Váš e-shop, systém nebo vlastní aplikace pošlou data do FakturaOnline a faktura se vystaví sama — bez otevírání aplikace a bez opisování údajů.
Zkratka pochází z anglického „application programming interface", tedy rozhraní pro propojení programů. Představte si ho jako dohodnutý jazyk: jeden program řekne „vystav fakturu s těmito údaji" a druhý mu rozumí a fakturu založí.
K čemu se napojení hodí
Hlavní přínos je automatizace opakované práce. Místo abyste stejné údaje vyplňovali pořád dokola, vystaví se faktura sama ve chvíli, kdy má vzniknout. Typické situace:
E-shop po každé objednávce sám vystaví fakturu ve FakturaOnline.
Vlastní systém nebo CRM vytvoří fakturu ve chvíli, kdy uzavřete zakázku.
Faktury vznikají hromadně z jiné evidence místo jedné po druhé.
Pro koho to je
Napojení dává smysl, když fakturujete opakovaně z jiného systému a chcete si ušetřit ruční práci. Když vystavíte pár faktur měsíčně, ruční vystavení je jednodušší a API nepotřebujete.
Technické propojení není nic, co byste museli umět sami. Buď ho nastaví programátor, nebo použijete hotové propojení, které vaše e-shopová platforma nabízí — v takovém případě obvykle jen vložíte přístupový klíč a je hotovo. Vaším úkolem je klíč vytvořit a předat; o zbytek se postará ten, kdo propojení zapojuje.
Technický postup, adresy a příklady najde v dokumentaci FakturaOnline API.
API klíč: bezpečný přístup místo hesla
Aby propojení fungovalo bezpečně, musí se druhý program prokázat, že smí s vaším účtem pracovat. K tomu slouží API klíč — bezpečný přístupový průkaz, který programu dáte místo svého hesla. Program se jím při každém požadavku prokáže a FakturaOnline pozná, že požadavek patří k vašemu účtu.
Proč klíč, a ne rovnou heslo? Heslo otevírá celý účet a nemá omezenou platnost. Klíč dáte jen konkrétnímu propojení, nastavíte mu, jak dlouho platí, a nemusíte kvůli němu nikde prozrazovat své heslo.
Jak vytvořit API klíč krok za krokem
Klíč si vytvoříte přímo v aplikaci:
Přihlaste se do FakturaOnline a otevřete Můj účet → API klíč.
Zvolte vytvoření nového klíče.
Zadejte název — pojmenujte klíč podle propojení, ke kterému patří (např. „e-shop" nebo „účetní systém"). Podle názvu poznáte, k čemu klíč slouží, když jich máte víc.
Nastavte platnost — jak dlouho má klíč fungovat. Po vypršení sám přestane platit, což je bezpečnější než klíč bez omezení.
Klíč si zkopírujte a bezpečně uložte.
Vytvořený klíč pak vložíte do druhého programu, nebo ho předáte tomu, kdo propojení nastavuje. Od té chvíle může program přes klíč vystavovat faktury ve vašem účtu a vy je uvidíte ve FakturaOnline jako každou jinou.
Co přes napojení získáte
Přes API využijete to hlavní, k čemu FakturaOnline slouží — vystavování a správu faktur, jen automaticky a bez ručního opisování. Nejde o systém, který za vás povede kompletní účetnictví; cílem je, aby faktury vznikaly samy a na jednom místě.
Co je API klíč a proč se používá místo hesla?
Je to bezpečný přístupový průkaz pro propojený program. Na rozdíl od hesla ho dáte jen jednomu propojení a nastavíte mu platnost, takže nemusíte nikde sdílet přihlašovací údaje k celému účtu.
Kde si API klíč vytvořím?
V aplikaci v sekci Můj účet → API klíč. Tam klíč vytvoříte, pojmenujete a nastavíte jeho platnost.
Potřebuju k napojení programátora?
Většinou ano — nastavení propojení je technická úloha. Někdy ho ale zvládne hotové propojení přímo ve vaší e-shopové nebo systémové platformě, kam jen vložíte API klíč.
K čemu se napojení přes API hodí?
Hlavně k automatizaci. Faktury mohou vznikat automaticky z e-shopu, CRM nebo vlastního systému, takže je nemusíte vystavovat ručně.
Co se stane, když platnost klíče vyprší?
Klíč přestane fungovat a propojený program přes něj už nebude moct vystavovat faktury. Vytvoříte si nový klíč a vložíte ho do propojení.
fakturovat úplně každýHomepage
