Při první registraci a platbě na 1 rok nabízíme nyní 2 měsíce zdarma

REST API (čtení i zápis)

Napojte účetnictví iÚčto na svůj e-shop, informační systém nebo vlastní aplikaci. Veřejné REST API umí vystavovat a číst doklady, párovat platby, udržovat adresář i sahat do účetního deníku. Celkem 161 operací, popsaných v dokumentaci pro vývojáře.

Dokumentace pro vývojáře
Začínáme

Získat API klíč →

Co s API uděláte

Fakturujte z e-shopu

Objednávka, zákazník, faktura, PDF a e-mail zákazníkovi. Celý řetězec voláním API, krok za krokem v návodu První faktura.

Stahujte doklady a platby do svého systému

Synchronizace adresáře, dokladů a bankovních pohybů oběma směry. Postup je v návodu Synchronizace adresáře.

Nechte účetnictví reagovat samo

Webhooky pošlou vaší aplikaci oznámení, když doklad vznikne, změní se, zmizí nebo se uhradí. Nemusíte se API doptávat.

Napojte AI asistenta

MCP server zpřístupní účetnictví přímo v Claude Desktop nebo Claude Code, bez psaní kódu.

Jak to funguje

API je postavené na REST, komunikuje výhradně přes HTTPS a odpovídá ve formátu HAL+JSON. Ověřuje se jedinou hlavičkou s API klíčem, který si vygenerujete v aplikaci pod Nastavení → Nastavení API.

Základní URL: https://online.iucto.cz/api/1.3/

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
}

Podrobnosti ke klíči a jeho oprávněním: Autentizace.

Co API pokrývá

Odkazy vedou do API reference na vývojářském portálu.

Firma

Adresář

Zákazníci
Dodavatelé
Země
skupiny zákazníků a dodavatelů, preferované metody platby

Doklady vydané

Doklady přijaté

Platby

Účetnictví

Ceník a sklady

Přílohy, číselníky a webhooky

Přílohy k dokladům i kontaktům: nahrání, výpis, stažení
Měny, metody plateb, způsoby zaokrouhlení
Změna dokladu a úhrada dokladu

Zdroje k EET zůstávají v API kvůli historickým dokladům, nová evidence se přes ně nezakládá.

Nemusíte nic programovat

Než začnete psát integraci, podívejte se v aplikaci do Nastavení → Rozšíření. iÚčto umí hotové importy mimo jiné ze Shoptetu, Fakturoidu a iDokladu. Vlastní integrace má smysl až tam, kde import nestačí: jiný zdroj dat, vlastní logika nad doklady nebo obousměrné napojení.

Nástroje pro vývojáře

PHP SDK – composer require iucto/iucto-api-php-sdk, typované objekty místo ručního skládání JSON
MCP server – účetnictví jako sada nástrojů pro Claude Desktop, Claude Code a další MCP klienty
Kolekce pro API klienty – Postman, Insomnia, Bruno: vyzkoušení volání bez psaní kódu
OpenAPI 3.1 specifikace – vygenerování klienta ve vašem jazyce, validace, podklad pro jazykový model
Mock server – u každé operace v referenci je tlačítko Vyzkoušet endpoint, které volá mock, ne ostré účetnictví

Než začnete stavět

Tři vlastnosti, které rozhodnou o návrhu integrace dřív, než padne první řádek kódu:

API se nedá volat z prohlížeče. Neposílá hlavičky CORS, takže požadavek z frontendu prohlížeč zablokuje. Klíč patří na server.
Není sandbox. Testuje se proti reálné firmě. Na zkoušení si založte druhou, zkušební firmu – má vlastní 14denní zkušební období i vlastní klíč.
Klíč je plný přístup k účetnictví jedné firmy. Žádný OAuth, žádné scopy, oprávnění kopírují uživatele ve webové aplikaci. Kdo staví aplikaci pro víc klientů, vybírá klíč od každého zvlášť.

Celý seznam včetně kvót a chybových stavů je na portálu: Limity a kvóty, Chyby a jak je číst.