Skip to main content
Všechny endpointy dodržují společná pravidla pro formát CSV a hodnot. Tato stránka je shrnuje.

​
Formát výstupu

  • Formát: CSV (text/csv), kódování UTF-8.
  • Názvy sloupců: anglicky, bez diakritiky, slova oddělená podtržítkem (_).
  • Pořadí sloupců: odpovídá pořadí uvedenému v tabulce sloupců u každého endpointu.

​
Hodnoty

​
desetinné číslo
Oddělovač desetinných míst je čárka. Ceny nemají oddělovač tisíců. Název sloupce vždy uvádí, zda jde o cenu bez DPH (_without_vat), nebo s DPH (_with_vat).
​
číslo
Uváděna jako číslo, například 12 nebo 19.
​
yyyy-MM-dd
Například 2026-06-16.
​
yyyy-MM-dd hh-mm-ss
Například 2026-06-16 14-30-05.
​
unix
Unixový čas jako celé číslo, například 1765200223.
​
0 / 1
Logické hodnoty mají prefix is_ a nabývají hodnot 0 (ne) nebo 1 (ano).

​
Filtrování

Většina endpointů podporuje filtry v query parametrech. Nejčastější:
Pro pravidelnou synchronizaci používejte last_updated_at_from — stáhnete jen záznamy změněné od posledního běhu.

​
Stránkování

Endpointy nad objednávkami, fakturami, výdejkami a zákazníky podporují stránkování: Příklad — druhá stránka po 1000 záznamech:

​
Verzování

API rozlišuje dva typy změn:

Nedestruktivní změny

Zůstává stejná verze API. Nové sloupce se přidávají na konec CSV výstupu. Váš parser musí počítat s tím, že sloupců může přibýt.

Destruktivní změny

Vydává se nová verze API. Sem patří odebírání sloupců.
Nespoléhejte na pevný počet sloupců. Sloupce mapujte podle názvu v hlavičce CSV, ne podle pozice — nové sloupce mohou přibýt na konec kdykoli v rámci stejné verze.
Historii konkrétních změn najdete v sekci Changelog.