Rozšíření API iÚčto 1.3 – přílohy u dokladů a podrobnější účetní deník

Radek Václavík 4. 6. 2026

Rozšířili jsme API iÚčto o dvě praktické novinky. Nově můžete přímo přes API spravovat přílohy u dokladů a kontaktů, takže soubory už nemusíte řešit zvlášť mimo iÚčto. Druhou novinkou je podrobnější účetní deník, který získal celou řadu nových filtrů i polí v odpovědi a hodí se hlavně pro reporting a napojení na další systémy. Obojí je součástí stávající verze 1.3, není proto potřeba nic migrovat ani přepínat verzi API.

API 1.3

Přílohy u dokladů a kontaktů

Nově můžete přes API nahrávat, stahovat a spravovat přílohy přímo u dokladů a kontaktů. Soubory tak nemusíte řešit mimo iÚčto. Všechny operace najdete pod novým endpointem /attachment.

Metoda	Endpoint	Popis
POST	`/{resource}/{id}/attachment`	Nahrání přílohy
GET	`/{resource}/{id}/attachment`	Seznam příloh
GET	`/attachment/{id}`	Detail přílohy
GET	`/attachment/{id}/download`	Stažení přílohy
DELETE	`/attachment/{id}`	Smazání přílohy

Kde lze přílohy používat

Přílohy lze přidávat k těmto dokladům:

invoice_received
invoice_issued
proforma_invoice_received
proforma_invoice_issued
creditnote_received
creditnote_issued
direct_accounting
direct_expense

a ke kontaktům:

customer
supplier

Povolené formáty a velikost

Podporované formáty souborů: pdf, doc, docx, xls, xlsx, odt, ods, png, jpg, jpeg, gif, xml, csv, txt, isdoc, isdocx.

Maximální velikost jednoho souboru je 5 MB.

Rozšíření účetního deníku (`/journal`)

Endpoint účetního deníku /journal jsme rozšířili o sadu nových filtrů pro seznam položek. Můžete tak data filtrovat mnohem přesněji, například podle dodavatele, střediska, zakázky nebo typu DPH.

Nové filtry

supplier_id: filtrování podle dodavatele
customer_id: filtrování podle odběratele
department_id: filtrování podle střediska
contract_id: filtrování podle zakázky
vat_type_id: filtrování podle typu DPH
vat: filtrování podle sazby DPH
document_id: filtrování podle ID dokladu
parent_document_type: filtrování podle typu rodičovského dokladu
parent_document_id: filtrování podle ID rodičovského dokladu
document_variable_symbol: filtrování podle variabilního symbolu dokladu
item_variable_symbol: filtrování podle variabilního symbolu položky
text: filtrování podle textu položky
date_expense_from, date_expense_to: filtrování podle data nákladů
document_maturity_date_from, document_maturity_date_to: filtrování podle data splatnosti

Nová pole v seznamu položek

V odpovědi seznamu položek účetního deníku jsou nově dostupná tato pole:

parent_document_type
parent_document_id
date_expense
vat_type_id
vat
supplier
customer
department_id
contract_id
document_variable_symbol
document_maturity_date
item_variable_symbol

Závěr

Verze 1.3 API iÚčto tak nově zvládá přílohy u dokladů i kontaktů a nabízí mnohem přesnější práci s účetním deníkem. Všechny změny jsou dostupné okamžitě v rámci stávající verze, stačí je začít používat.

Kompletní popis endpointů, parametrů a příkladů volání najdete v dokumentaci API. Pokud vám v API něco chybí nebo na něco narazíte, dejte nám vědět. Vaše podněty nám pomáhají rozhodovat, co do API přidáme dál.