Úvod do API v2

API v2 umožňuje propojit elPokladny.cz s účetnictvím, e-shopem nebo jiným systémem. Zpřístupňuje produkty a kategorie, doklady, kontakty a import a export dat.

Adresa a verze

Základní adresa je https://www.elpokladny.cz/api/v2. Cesta uvedená u každé operace už obsahuje /api/v2, k adrese serveru ji připojte jen jednou. Změny API najdete v changelogu.

Formát požadavku a odpovědi

Metoda a cesta tvoří jednu operaci. Většina operací používá JSON v UTF-8. Při posílání JSON těla nastavte Content-Type: application/json. Názvy polí a velikost písmen zachovejte přesně podle stránky operace.

Ne všechny odpovědi jsou JSON: PDF dokladu je binární soubor, exporty vracejí soubory a importy mohou vrátit text. Před zpracováním odpovědi zkontrolujte HTTP stav a Content-Type, podrobnosti jsou v Chybových stavech.

Datum má formát YYYY-MM-DD, například 2026-10-30. Datum a čas má formát YYYY-MM-DD HH:MM:SS v časovém pásmu Europe/Prague, pokud stránka operace neuvádí jinak.

Rychlý start

1. V pokladně otevřete Nastavení → API přístupy a vytvořte přístup typu BEARER. Potřebujete modul 10223 API přístupy. Nastavte povolené IP adresy a zobrazený token si uložte, později už ho neuvidíte. Postup popisuje návod API přístupy.
2. Token posílejte v hlavičce Authorization. V dokumentaci ho zastupuje neplatná ukázková hodnota:

Authorization: Bearer elp_live_example.example_secret

3. Začněte čtením dat, například výpisem produktů, a zkontrolujte odpověď.

Token typu URL, platnost přístupů a IP omezení popisuje Autentizace.

Ukázky

Ukázky požadavků a odpovědí obsahují smyšlené údaje. Ukázkový token ani ukázková ID nepoužívejte jako skutečné přístupy.