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
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).Uváděna jako číslo, například
12 nebo 19.Například
2026-06-16.Například
2026-06-16 14-30-05.Unixový čas jako celé číslo, například
1765200223.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ší:| Parametr | Typ | Popis |
|---|---|---|
mutation_id | string | Seznam ID mutací oddělených čárkou. Viz číselník mutací. |
create_date_from | string | Datum vytvoření od (YYYY-MM-DD). |
create_date_to | string | Datum vytvoření do (YYYY-MM-DD). |
last_updated_at_from | timestamp | Vrátí jen záznamy změněné od zadaného timestampu. Vhodné pro inkrementální synchronizaci. |
Stránkování
Endpointy nad objednávkami, fakturami, výdejkami a zákazníky podporují stránkování:| Parametr | Typ | Popis |
|---|---|---|
limit | int | Vlastní limit počtu záznamů místo výchozí hodnoty. |
from_index | int | Index prvního vráceného výsledku (první výsledek má index 0). Kombinuje se s limit. |
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ů.