Pro vývojáře (API)Pro
API: Číselníky a chyby
Povolené hodnoty (sazby, stavy) a HTTP chybové kódy.
Číselníky
| Pole | Hodnoty |
|---|---|
sazbaDPH | S_21 · S_12 · S_0 |
typDokladu | FAKTURA · ZALOHOVA |
formaUhrady | BANKOVNI_PREVOD, HOTOVE, KARTOU, DOBIRKA, ZAPOCET |
rezimDPH | STANDARD, REVERSE_CHARGE, OSVOBOZENO, MIMO_DPH |
stav | ROZPRACOVANA, VYSTAVENA, CASTECNE_ZAPLACENA, ZAPLACENA, PO_SPLATNOSTI, STORNOVANA |
Chybové kódy
Tělo chyby má tvar { "error": "..." }, u vybraných chyb navíc kod (strojově čitelný důvod) a zbyva (kolik z faktury zbývá dobropisovat).
| Kód | Význam |
|---|---|
| 400 | neplatná data požadavku |
| 401 | chybný nebo chybějící API klíč |
| 402 | API je jen v tarifu Pro |
| 403 | klíč nemá oprávnění k zápisu (scope write) |
| 404 | záznam nenalezen |
| 409 | kolize s existujícím záznamem — externí ID už patří jinému dokladu, platbě nebo odběrateli; u dobropisu kod EXTERNI_ID_OBSAZENO, DOBROPIS_PREKRACUJE_ZBYTEK nebo CASTECNE_DOBROPISY_EXISTUJI (se zbyva) |
| 429 | příliš mnoho požadavků — viz Retry-After |
| 503 | kurz ČNB pro cizí měnu teď není k dispozici (kod KURZ_CNB_NEDOSTUPNY) — dočasná chyba, požadavek zopakuj později |