Bezplatné fakturační API pro vývojáře

Fakturační API

Zdarma můžete z vlastního kódu číst faktury, klienty, firmy, platby, plány pravidelné fakturace, nahrané soubory dodavatelů, výkazy DPH a stáří pohledávek i prioritní další kroky. Lifetime Pro za 49 € včetně daně přidává operace zápisu a odchozí webhooky za jednu platbu, bez měsíčního poplatku a ročního obnovení.

Základní URL

https://freebillgen.com/api/v1

Autentizace

Každý požadavek používá token typu Bearer. Vytvořte ho v části Nastavení → Klíče API, přidělte mu potřebné rozsahy čtení a zápisu pro jednotlivé zdroje, případně nastavte konec platnosti a posílejte ho s každým požadavkem:

Authorization: Bearer <your-api-key>

Požadavky se ověřují vůči účtu, který klíč vytvořil, a kontrolují podle přidělených rozsahů. Token chraňte a při vyzrazení nebo ukončení používání ho odvolejte.

Co můžete dělat

Čtení faktur, klientů, firem, plateb a plánů pravidelné fakturace
Jejich vytváření a aktualizace přes API pro zápis (Pro)
Načítání výkazů DPH a stáří pohledávek jako JSON
Čtení stejné omezené fronty prioritních dalších kroků, kterou používá přehled
Čtení souborů elektronických faktur dodavatelů, které jste ručně nahráli do doručené pošty (nejde o koncový bod pro příjem přes Peppol ani e-mail)
Stahování obecných mapování OASIS UBL a UN/CEFACT CII ke kontrole, bez ověření profilu
Registrace koncových bodů webhooků pro události faktur a plateb (Pro)
Idempotency-Key u podporovaných zápisů; změněná data požadavku pod stejným klíčem vrátí 409
Kurzorové stránkování přes links.next s nastavitelným per_page, nejvýše 100
Čtení libovolné sdílené faktury agenty AI pomocí schema.org/Invoice JSON-LD a Accept: application/json nebo text/markdown na každém podepsaném odkazu
MCP server bez přihlášení, jen pro čtení, na https://freebillgen.com/api/mcp s nástroji get_invoice a verify_invoice pro agenty AI

Konvence

Idempotence: U podporovaných volání pro vytvoření nebo akci pošlete jedinečný Idempotency-Key. Opakování stejných dat vrátí původní úspěšný výsledek. Změněná data pod stejným klíčem vrátí 409.
Stránkování: Seznamy uložených zdrojů používají kurzorové stránkování. Pokračujte přes links.next nebo předejte ?cursor=... a nastavte ?per_page=, nejvýše 100. Omezený přehled akcí uvádí svůj limit a informaci o zkrácení.
Peněžní částky: Peněžní částky jsou přesné řetězce JSON ve formátu odpovídajícím počtu desetinných míst měny podle ISO 4217, například „121.00“ pro EUR nebo „500“ pro JPY. Jednotkové ceny mohou zachovat další desetinná místa vstupu.
Identifikátory: Každý zdroj používá neprůhledný identifikátor id, nikdy pořadové číslo.

Příklad: výpis vašich faktur

curl https://freebillgen.com/api/v1/invoices \
  -H "Authorization: Bearer $FREEBILLGEN_API_KEY"

Otevřít úplnou interaktivní referenci API →

Otázky k fakturačnímu API

Je fakturační API zdarma?

Ano. API pro čtení je bezplatnou součástí tarifu Zdarma. API pro zápis a odchozí webhooky jsou součástí Lifetime Pro za jednorázových 49 € včetně daně, bez měsíčního poplatku a ročního obnovení.

Jak se autentizuji?

V části Nastavení > Klíče API vytvořte token typu Bearer, přidělte mu rozsahy čtení nebo zápisu pro jednotlivé zdroje a posílejte jej s každým požadavkem v hlavičce Authorization: Bearer. Klíče jsou omezené na váš účet a můžete je zrušit nebo jim nastavit konec platnosti.

Mohu vytvářet faktury programově?

Ano, přes API pro zápis, které je součástí doplňku Pro. Vytváří stejné profesionální faktury jako webová aplikace, s navazujícím číslováním a nastavitelným zpracováním DPH na serveru. API nepotvrzuje soulad s místními právními předpisy.

Jak se při opakování vyhnu vytvoření duplicitních faktur?

Při vytváření pošlete jedinečný Idempotency-Key. Opakování stejných dat s tímto klíčem vrátí původní výsledek. Opětovné použití klíče se změněnými daty vrátí 409, místo aby tiše zopakovalo jinou fakturu.

Mohu číst faktury, které jsem obdržel?

Ano, zdarma. GET /api/v1/inbox vypíše podporované soubory dodavatelů UBL nebo CII, které jste ručně nahráli a FreeBillGen rozpoznal. Původní soubor zůstává uložený pro audit. GET /api/v1/inbox/{id} vrátí jeden záznam. Rozpoznání syntaxe není ověření profilu a tyto koncové body neznamenají, že FreeBillGen přijímá faktury přes Peppol, vládní síť nebo e-mail.

Může AI agent číst fakturu bez účtu?

Ano. Každá faktura sdílená podepsaným veřejným odkazem je na stejné adrese čitelná pro agenty. Stránka obsahuje schema.org/Invoice JSON-LD, hlavička Accept: application/json vrátí strukturovanou fakturu se stranami, řádky, součty, splatným zůstatkem a platebními možnostmi a Accept: text/markdown vrátí čisté zobrazení s malým počtem tokenů. Na https://freebillgen.com/api/mcp je také MCP server bez přihlášení, jen pro čtení, s nástroji get_invoice a verify_invoice. Podpis odkazu slouží jako přístupový token. Celou adresu považujte za tajnou, protože fakturu může otevřít každý, kdo ji získá.