Výpis dokladů

/api/v2/docs

Vrací přehled dokladů a uzávěrek přihlášené firmy. Každý záznam je pole hodnot v pevném pořadí (poziční řádek), ne objekt s názvy. Metoda POST na stejné adrese /api/v2/docs vrací stejný přehled, doklad nevytváří.

Filtry

Parametry v query (type, dir, sort, paid, eet, internalConsumption) fungují u GET i POST. Filtr skladů, rozsah dat a hledaný text se posílají jako pole formuláře metodou POST s Content-Type: application/x-www-form-urlencoded:

Filtr skladů a rozsah dat platí pro doklady i uzávěrky (u uzávěrky se porovnává datum otevření). Neplatné datum se ignoruje. Filtry paid, eet, internalConsumption a q se týkají jen dokladů, ne uzávěrek.

Řazení a počet záznamů

Doklady se řadí podle sort a dir. Výpis dokladů vrací nejvýše 400 řádků cen. Doklad s více sazbami DPH zabírá více řádků, takže dokladů může být méně než 400. Stránkování ani vlastní limit nejsou k dispozici, pro užší výběr použijte filtry.

Uzávěrky se řadí od nejnovější a limit 400 se na ně nevztahuje. U type=all následují uzávěrky až za všemi doklady.

Řádek dokladu (26 pozic)

Data mají tvar den.měsíc.rok bez úvodních nul (např. 30.1.2026). Datum vystavení hotovostního dokladu (cash) a poslední vystavení periodického dokladu obsahují i čas (např. 30.1.2026 14:05:09). Časy jsou v místním čase Europe/Prague bez uvedení časového pásma. Ceny jsou součty přes všechny sazby DPH dokladu. Nevyplněné textové hodnoty mohou být null.

Řádek uzávěrky (11 pozic)

Řádek uzávěrky má jiný tvar než řádek dokladu. Rozlišíte ho podle hodnoty closure na indexu 1.

Částky na indexech 8 až 10 mohou přijít jako číslo nebo jako řetězec. Data otevření a uzavření mají stejný tvar jako u dokladů, bez času. Nevyplněné údaje jsou null.

Výpis vrací jen data firmy, ke které patří API token. Viz také Chybové stavy.

curl -X GET 'https://www.elpokladny.cz/api/v2/docs?type=invoice' \
  -H 'Authorization: Bearer elp_live_example.example_secret'

<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/docs?type=invoice');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array (
  0 => 'Authorization: Bearer elp_live_example.example_secret',
),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

const response = await fetch("https://www.elpokladny.cz/api/v2/docs?type=invoice", {
    "method": "GET",
    "headers": {
        "Authorization": "Bearer elp_live_example.example_secret"
    }
});
const data = await response.json();

{
  "status": "success",
  "data": [
    [
      1,
      "invoice",
      1,
      "FV2026-1",
      "2026001",
      "30.10.2026",
      "13.11.2026",
      "30.10.2026",
      "bank",
      0,
      0,
      0,
      1,
      1,
      "Ukázkový odběratel",
      "Ukázkový uživatel",
      [
        100,
        21,
        121
      ],
      null,
      null,
      0,
      0,
      null,
      null,
      0,
      0,
      0
    ]
  ]
}

{
  "status": "error",
  "message": "Unauthorized"
}