Co s tím uděláte
Fakturujte z e-shopuObjednávka → zákazník → faktura → PDF → e-mail zákazníkovi. Celý řetězec voláním API.Stahujte doklady a platbySynchronizace adresáře a dokladů do vlastního systému, párování bankovních pohybů.Napojte AI asistentaMCP server zpřístupní účetnictví přímo v Claude Desktop nebo Claude Code.První volání
Dotaz na profil firmy neověří jen to, že klíč funguje — řekne vám i do které firmy jste se trefili a jak je nastavená.
curl -s https://online.iucto.cz/api/1.3/company_profile \
-H "X-Auth-Key: $IUCTO_API_KEY"
{
"name": "ACME s.r.o.",
"comid": "12345679",
"vatid": "CZ12345679",
"vat_type": "monthly",
"accounting_type": "accountancy",
"oss_status": false
}
vat_type a accounting_type určují, která pole budou na dokladech povinná, takže si je přečtěte hned na začátku. Celý postup je v části Začínáme.
Kudy dál
ZačínámeOd klíče k prvnímu volání a co si nastavit předtím.PrůvodceAutentizace, chyby, doklady, zálohy, zaúčtování, webhooky, slovníček.NávodyVystavení faktury, synchronizace adresáře, řešení potíží.API referenceVšech 161 operací nad doklady, platbami, adresářem a účetnictvím.Než začnete stavět
Nejde volat z prohlížeče
API neposílá hlavičky CORS, takže požadavek z frontendu prohlížeč zablokuje. Klíč patří na server. Na zkoušení použijte terminál nebo kolekci pro API klienty.
Není sandbox
Testuje se proti reálné firmě — založte si na to druhou, zkušební. Je 14 dní zdarma a má vlastní kvótu dotazů.
Klíč je plný přístup k jedné firmě
Žádný OAuth, žádné scopy. Oprávnění kopírují uživatele ve webové aplikaci, takže kdo staví aplikaci pro víc klientů, vybírá klíč od každého zvlášť.
Zbytek — kvóty, tvary chybových odpovědí, chybějící pojistka proti duplicitnímu zápisu — je v části Začínáme.
Pro AI asistenty
Celý popis API v OpenAPI 3.1 je na stabilní adrese /spec/openapi.yaml — můžete ho stáhnout a předložit modelu celý, nebo z něj vygenerovat klienta. Stručný rozcestník pro jazykové modely je v llms.txt. Když má asistent se účetnictvím přímo pracovat, použijte MCP server.
https://online.iucto.cz/api/1.3/ · Autentizace hlavička X-Auth-Key · Formát HAL+JSON, těla požadavků v JSON · komunikace výhradně přes HTTPS