iÚčto pro vývojáře

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á.

Požadavek
curl -s https://online.iucto.cz/api/1.3/company_profile \
  -H "X-Auth-Key: $IUCTO_API_KEY"

Odpověď 200
{
  "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.

Základní URL: https://online.iucto.cz/api/1.3/
Autentizace: hlavička X-Auth-Key
Formát: HAL+JSON, těla požadavků v JSON
Přenos: výhradně přes HTTPS