FakturOS je od základu navržen jako integrovatelná platforma. Čisté JSON endpointy, OAuth 2.0, webhooks, stabilní verzování a SDK pro JavaScript i PHP.
Stačí API klíč z klientské zóny, jeden HTTP požadavek a FakturOS vrátí URL hotového PDF.
# Vystavit fakturu programaticky curl -X POST https://api.fakturos.cz/v1/invoices \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "firm_id": "acme_sro", "client": { "name": "Nordic Studio s.r.o.", "ico": "12345678" }, "items": [ { "label": "Webdesign", "qty": 40, "price": 1000 } ], "vat_rate": 21, "due_days": 14 }' # → 201 Created { "id": "inv_2026_0118", "number": "2026-0118", "pdf_url": "https://files.fakturos.cz/.../faktura.pdf", "isdoc_url": "https://files.fakturos.cz/.../faktura.isdoc", "total": 48400, "status": "issued" }
FakturOS pošle POST na váš endpoint, kdykoliv se stane něco, co vás zajímá. Bezpečné podpisy HMAC, exponenciální retry.
Spustí se hned po vystavení každé faktury. Obsahuje ID, PDF URL a hodnotu.
Triggernuto při manuálním označení nebo párováním z banky.
Den po splatnosti pošleme upozornění do vašeho systému.
Jakmile někdo přidá náklad (manuálně nebo přes OCR).
Položka klesla pod nastavenou minimální zásobu.
Admin firmy pozval do FakturOS dalšího uživatele.
Buď osobní API klíč pro skripty a integrace, nebo OAuth 2.0 (Authorization Code & Client Credentials) pro vícestranné aplikace. Tokeny rotujete v klientské zóně.
Oficiální SDK pro JavaScript / Node.js a PHP. K dispozici je i OpenAPI 3.1 spec — vygenerujete si klienta v libovolném jazyce.
npm install @fakturos/sdkcomposer require fakturos/sdk