Pro vývojáře (API)Pro

Přehled API

Veřejné REST API v1 — základy, formát chyb, limity.

Veřejné REST API v1 umožní vystavovat faktury a spravovat odběratele programově z vlastního systému. Je dostupné v tarifu Pro a vyžaduje API klíč.


Base URL	`https://zafakturujto.cz/api/v1`
Formát	JSON (požadavky i odpovědi)
Autentizace	Bearer API klíč — viz Autentizace
Tvar chyby	`{ "error": "..." }`, u vybraných chyb navíc `kod` a `zbyva`
Limit požadavků	HTTP 429 + hlavička `Retry-After`

Endpointy

GET/fakturySeznam faktur

POST/fakturyVytvořit fakturu

GET/faktury/{cislo}Detail

PATCH/faktury/{cislo}/stavZměna stavu

GET/faktury/{cislo}/pdfPDF

GET/faktury/{cislo}/isdocISDOC 6.0.2

POST/faktury/{cislo}/dobropisVystavit dobropis

POST/faktury/{cislo}/emailOdeslat e-mailem

GET/odberateleSeznam odběratelů

POST/odberateleVytvořit odběratele

PATCH/odberatele/{id}Upravit odběratele

GET/ciselne-radyČíselné řady (id pro ciselnaRadaId)

Strojově čitelný popis je v OpenAPI specu. Detaily v Faktury, Odběratelé a Číselníky a chyby.