> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primulusgroup.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Konvence exportu

> Formáty dat, ceny, datumy, filtrování, stránkování a verzování

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

<ResponseField name="Ceny" type="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`).
</ResponseField>

<ResponseField name="Sazba DPH" type="číslo">
  Uváděna jako číslo, například `12` nebo `19`.
</ResponseField>

<ResponseField name="Datum" type="yyyy-MM-dd">
  Například `2026-06-16`.
</ResponseField>

<ResponseField name="Datum a čas" type="yyyy-MM-dd hh-mm-ss">
  Například `2026-06-16 14-30-05`.
</ResponseField>

<ResponseField name="Timestamp" type="unix">
  Unixový čas jako celé číslo, například `1765200223`.
</ResponseField>

<ResponseField name="Boolean" type="0 / 1">
  Logické hodnoty mají prefix `is_` a nabývají hodnot `0` (ne) nebo `1` (ano).
</ResponseField>

## 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í](/ciselniky/mutace).             |
| `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. |

<Tip>
  Pro pravidelnou synchronizaci používejte `last_updated_at_from` — stáhnete jen záznamy změněné od posledního běhu.
</Tip>

## 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`. |

Příklad — druhá stránka po 1000 záznamech:

```bash theme={null}
curl "https://zeptej.se.it/api/csv/v1/order-items?key=VAS_KLIC&limit=1000&from_index=1000"
```

## Verzování

API rozlišuje dva typy změn:

<CardGroup cols={2}>
  <Card title="Nedestruktivní změny" icon="circle-plus">
    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.
  </Card>

  <Card title="Destruktivní změny" icon="triangle-exclamation">
    Vydává se **nová verze** API. Sem patří odebírání sloupců.
  </Card>
</CardGroup>

<Warning>
  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.
</Warning>

Historii konkrétních změn najdete v sekci [Changelog](/changelog).