Čtení faktur přes API
Načítání seznamu faktur a jejich dat ve strojově čitelném formátu přes REST API. Podporuje stránkování a filtrování. Odpovědi obsahují kompletní data faktury včetně položek, kontaktů a bankovních údajů.
Brzy doplníme screenshoty a podrobnější návod.
Stránkovaný seznam faktur
Endpoint GET /api/invoice-isdoc vrací stránkovaný seznam faktur. Parametry: 'offset' (index stránky, výchozí 0), 'limit' (počet položek na stránce, výchozí 25), 'exclude drafts' (vyfiltrovat návrhy). Odpověď obsahuje: 'items' (pole faktur s kompletními daty), 'hasMore' (zda existují další záznamy), 'totalCount' (celkový počet v databázi).
Struktura odpovědi
Každá faktura v odpovědi obsahuje kompletní data: číslo faktury, údaje odběratele a dodavatele (jméno, IČO, DIČ, adresa, e-mail), bankovní údaje (IBAN, BIC), položky faktury (popis, množství, cena, DPH), celkové částky v lokální i zahraniční měně, data (vystavení, splatnost, zdanitelné plnění), symboly (variabilní, konstantní, specifický) a stav faktury.
Generování ZUGFeRD přes API
Endpoint POST /api/generate-zugferd-invoice přijímá PDF dokument a data faktury. Systém vygeneruje ZUGFeRD XML ze strukturovaných dat a vloží ho přímo do PDF souboru. Výstupem je PDF s vloženými strojově čitelnými daty podle evropského standardu ZUGFeRD. Vhodné pro automatizované generování elektronických faktur pro německé a evropské odběratele.