SaldoDokumentace
Otevřít Saldo

Reference API

Doklady a jejich stavy

Všechny doklady firmy: vydané a přijaté faktury, zálohy, dobropisy, pokladní, interní a obchodní doklady. Koncept, vystavení s číslem (v podvojném účetnictví i se zaúčtováním), storno, úhrady, upomínky, sdílení, ISDOC a opakované faktury.

45 operací · vygenerováno z OpenAPI · ukázky zaznamenané na smyšlené firmě

GET Seznam dokladů

/entities/{entity_id}/documents

Oprávnění
Každý člen firmy včetně role Jen čtení
Pravidlo
Role Nahrává doklady (submitter): jen doklady, které volající sám založil (created_by_id).
Klíč jen pro čtení
Stačí

Vrátí stránkovaný seznam dokladů firmy všech druhů a stavů (koncepty, vystavené i stornované), pokud je filtry nevyloučí. Řazení je pevné: od nejnovějšího data vystavení, při shodě od nejvyššího ID. Filtry se kombinují; hledání q prochází číslo dokladu, údaje kontaktu uložené na dokladu (jméno, IČO, DIČ, adresa, e-mail, telefon), jméno kontaktu v adresáři, variabilní symbol, popis a číslo dokladu dodavatele. Součty sums jsou za vystavené doklady celého vyfiltrovaného výběru (všechny stránky, všechny druhy a směry dohromady; koncepty a stornované doklady se nesčítají), ne jen za vrácenou stránku.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
kinddotaztextneDruhy dokladů oddělené čárkou. Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_out, delivery_out. Lze i opakovat kind[]; neznámá hodnota nic nenajde. Příklad invoice_out,credit_out.
statusdotaztextneStav dokladu – koncept, vystavený, stornovaný; jiná hodnota nic nenajde Hodnoty: draft, issued, cancelled. Příklad issued.
statedotaztextneStav úhrady; vybírá jen vystavené doklady s úhradou (faktury, zálohové faktury, dobropisy). unpaid = zbývá něco uhradit (i částečně uhrazené a po splatnosti; ne zálohová faktura vyúčtovaná konečnou fakturou), overdue = zbývá uhradit a splatnost už uplynula, paid = nic nezbývá (i přeplacené a doklady s nulovou částkou), pending_orders = vystavené přijaté objednávky bez výsledku (nevyřízené), missing_original = vystavené přijaté faktury, dobropisy a výdajové pokladní doklady bez přílohy, kromě načtených z ISDOC. uploaded = koncepty, které založil člen s rolí Nahrává doklady (ke kontrole). Jiná hodnota se ignoruje. Hodnoty: unpaid, overdue, paid, pending_orders, missing_original, uploaded. Příklad unpaid.
approvaldotaztextnewaiting = přijaté výdaje ve schvalování (odeslané, vrácené k opravě nebo změněné po schválení), bez stornovaných; mine = doklady čekající na schválení (odeslané nebo změněné po schválení), které smí schválit volající. Jiná hodnota se ignoruje. Hodnoty: waiting, mine. Příklad waiting.
partner_iddotazcelé čísloneJen doklady tohoto kontaktu Příklad 118.
fromdotazdatumneDatum vystavení od (včetně), ISO YYYY-MM-DD Příklad 2026-09-01.
todotazdatumneDatum vystavení do (včetně), ISO YYYY-MM-DD Příklad 2026-09-30.
yeardotazcelé čísloneHospodářský rok firmy podle data vystavení (začíná měsícem fiscal_year_start firmy). Hodnota mimo rozsah se ořízne, nečíselná znamená aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
qdotaztextneHledaný text (část čísla, údajů kontaktu včetně IČO a adresy, variabilního symbolu, popisu nebo čísla dokladu dodavatele). Velikost písmen ani diakritika se nerozlišují („cedok“ najde Čedok). Příklad nordwood.
pagedotazcelé čísloneČíslo stránky; hodnota menší než 1 znamená 1 Výchozí 1. Rozsah od 1. Příklad 1.
perdotazcelé číslonePočet řádků na stránce; 0 nebo prázdná hodnota znamená 100, jiné hodnoty se ořežou do rozsahu 1–500 Výchozí 100. Rozsah od 1 do 500. Příklad 50.

Odpověď

200 application/json Objekt s počtem, stránkováním, součty v Kč a řádky dokladů (souhrnná podoba, bez položek a úhrad).

PoleVýznam
totalPočet dokladů odpovídajících filtrům (všechny stránky)
pageVrácená stránka
perPoužitý počet řádků na stránce
sums.net_czkSoučet základů v Kč za celý výběr
sums.vat_czkSoučet DPH v Kč za celý výběr
sums.gross_czkSoučet částek s DPH v Kč za celý výběr
sums.countPočet vystavených dokladů, které součty zahrnují
rows[].idID dokladu
rows[].kindDruh dokladu (invoice_out, invoice_in, …)
rows[].kind_labelČeský název druhu, např. Faktura vydaná
rows[].statusdraft (koncept), issued (vystavený), cancelled (stornovaný)
rows[].numberČíslo z číselné řady; null u konceptu, který ještě nebyl vystaven
rows[].variable_symbolVariabilní symbol
rows[].original_numberČíslo dokladu dodavatele (u přijatých dokladů)
rows[].partner_idID kontaktu
rows[].partner_nameJméno kontaktu – u vystaveného dokladu ze snímku při vystavení
rows[].partner_icoIČO kontaktu
rows[].issue_dateDatum vystavení
rows[].taxable_dateDatum uskutečnění zdanitelného plnění (DUZP)
rows[].due_dateDatum splatnosti
rows[].currencyMěna dokladu (ISO 4217)
rows[].total_netZáklad v měně dokladu
rows[].total_vatDPH v měně dokladu
rows[].total_payableČástka k úhradě v měně dokladu (včetně zaokrouhlení)
rows[].total_gross_czkČástka s DPH přepočtená kurzem dokladu na Kč
rows[].paid_amountUhrazeno v měně dokladu
rows[].remainingZbývá uhradit (total_payable − paid_amount)
rows[].payment_statena (nevystavený doklad nebo druh bez úhrad), unpaid, partial, overdue, paid
rows[].days_overduePočet dní po splatnosti (0, není-li overdue)
rows[].descriptionPopis dokladu
rows[].vat_modeRežim DPH
rows[].sourcePůvod dokladu: manual, recurring, isdoc, pohoda, import
rows[].tagsŠtítky (text)
rows[].related_document_idID souvisejícího dokladu (např. faktura u dobropisu)
rows[].reminders_sentPočet zaznamenaných upomínek
rows[].outcomeVýsledek nabídky: accepted, rejected nebo null
rows[].attachments_countPočet příloh
rows[].approval_stateUložený stav schvalování (pending, approved, returned, changed) nebo null
rows[].created_by_idID uživatele, který doklad založil (null u starších a importovaných)
rows[].created_by_nameZobrazované nebo uživatelské jméno toho, kdo doklad založil
rows[].uploaded_byJméno autora, když ho nahrál člen s rolí Nahrává doklady; jinak null

Chování

Co změní
Nic nezapisuje.
Limity
Nejvýše 500 řádků na stránku (výchozí 100).

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents?kind=invoice_out&state=unpaid&per=2"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents?kind=invoice_out&state=unpaid&per=2', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "total": 4,
  "page": 1,
  "per": 2,
  "sums": {
    "net_czk": 177520.0,
    "vat_czk": 20916.0,
    "gross_czk": 198436.0,
    "count": 4,
    "cash_in": 0,
    "cash_out": 0
  },
  "rows": [
    {
      "id": 129,
      "kind": "invoice_out",
      "kind_label": "Faktura vydaná",
      "status": "issued",
      "number": "FV20260025",
      "variable_symbol": "20260025",
      "original_number": null,
      "partner_id": 1,
      "partner_name": "Nordwood Studio s.r.o.",
      "partner_ico": "90000013",
      "issue_date": "2026-09-28",
      "taxable_date": "2026-09-28",
      "due_date": "2026-10-12",
      "currency": "CZK",
      "total_net": 19800.0,
      "total_vat": 4158.0,
      "total_payable": 23958.0,
      "total_gross_czk": 23958.0,
      "paid_amount": 0.0,
      "remaining": 23958.0,
      "payment_state": "unpaid",
      "days_overdue": 0,
      "description": "Správa webu – září",
      "vat_mode": "domestic",
      "source": "manual",
      "tags": null,
      "related_document_id": null,
      "reminders_sent": 0,
      "outcome": null,
      "attachments_count": 0,
      "approval_state": null,
      "created_by_id": 1,
      "created_by_name": "ukazka",
      "uploaded_by": null
    },
    {
      "id": 23,
      "kind": "invoice_out",
      "kind_label": "Faktura vydaná",
      "status": "issued",
      "number": "FV20260023",
      "variable_symbol": "20260023",
      "original_number": null,
      "partner_id": 5,
      "partner_name": "Hafenlicht GmbH",
      "partner_ico": null,
      "issue_date": "2026-09-21",
      "taxable_date": "2026-09-21",
      "due_date": "2026-10-21",
      "currency": "EUR",
      "total_net": 3200.0,
      "total_vat": 0.0,
      "total_payable": 3200.0,
      "total_gross_czk": 77920.0,
      "paid_amount": 0.0,
      "remaining": 3200.0,
      "payment_state": "unpaid",
      "days_overdue": 0,
      "description": "Software development services – sprint",
      "vat_mode": "eu_services",
      "source": "manual",
      "tags": null,
      "related_document_id": null,
      "reminders_sent": 0,
      "outcome": null,
      "attachments_count": 0,
      "approval_state": null,
      "created_by_id": 1,
      "created_by_name": "ukazka",
      "uploaded_by": null
    }
  ]
}

POST Založení dokladu, volitelně s vystavením

/entities/{entity_id}/documents

Oprávnění
Vlastník, účetní nebo editor
Pravidlo
S issue: true platí pro přijaté výdaje (invoice_in, cash_out, credit_in) pravidla schvalování: kdo doklad nesmí schválit, ten ho jen odešle ke schválení. Role Nahrává doklady (submitter): jen koncept invoice_in nebo cash_out; kontakt, účet, číselná řada, číslo a související doklad se nepřevezmou.
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY
V příručce
Vydané faktury › Vystavit fakturu; Přijaté doklady a účtenky › Doklady nahrané kolegy; Zálohy, dobropisy a obchodní doklady › Vystavit zálohovou fakturu; Zálohy, dobropisy a obchodní doklady › Daňový doklad k přijaté platbě; Zálohy, dobropisy a obchodní doklady › Vyúčtovat zálohu konečnou fakturou; Zálohy, dobropisy a obchodní doklady › Přijatá zálohová faktura; Zálohy, dobropisy a obchodní doklady › Dobropisy (opravné daňové doklady); Zálohy, dobropisy a obchodní doklady › Vytvořit cenovou nabídku; Zálohy, dobropisy a obchodní doklady › Objednávka u dodavatele; Zálohy, dobropisy a obchodní doklady › Přijatá objednávka od odběratele; Zálohy, dobropisy a obchodní doklady › Dodací list; Zálohy, dobropisy a obchodní doklady › Interní doklad s čísly řádků MD/Dal

Uloží nový doklad jako koncept: dopočítá částky řádků a součty podle sazeb DPH (DPH z rekapitulace po sazbách; u dokladu v Kč zaokrouhlí částku k úhradě – u prodeje podle nastavení firmy, u nákupu jen hotovostní), datum pro DPH a u dokladu v Kč kurz 1. Kontakt, bankovní účet, související doklad, odečítaná záloha a číselná řada, které firmě nepatří, se tiše vynechají (uloží se prázdné). S issue: true se doklad hned vystaví jako v issueDocument; když vystavení selže, nic se neuloží (žádný koncept nezůstane). Přijatý výdaj, na který se vztahuje pravidlo schvalování a volající ho nesmí schválit, zůstane konceptem a odešle se ke schválení. Kurz cizí měny server nedoplňuje – bez exchange_rate se uloží kurz 1.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
documentobjektano
document.kindtextanoDruh dokladu (nelze později změnit). invoice_out/invoice_in – faktura vydaná/přijatá (řada FV/FP); proforma_out/proforma_in – zálohová faktura vydaná/přijatá (ZV/ZP, není daňový doklad; při vystavení se nezaúčtuje, její úhrady ano); advance_out/advance_in – daňový doklad k přijaté/poskytnuté platbě zálohy (DZ/DP); credit_out/ credit_in – opravný daňový doklad (dobropis) vydaný/přijatý (OV/OP); customs_in – doklad celního úřadu o dovozu (JSD, řada JSD; jen CZK, režim import, DPH a clo proti účtu 379, DPH do ř. 42); cash_in/cash_out – příjmový/ výdajový pokladní doklad (PP/VP); internal – interní doklad (ID, jen CZK, bez DPH; každý řádek se při vystavení zaúčtuje account_code / credit_account, oba povinné a různé; jednoduché ruční zápisy jsou /entries); quote_out – cenová nabídka (NA), order_out – objednávka vydaná (OB), delivery_out – dodací list (DL): obchodní doklady, nikdy se neúčtují ani nevstupují do DPH. Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out.
document.partner_idcelé čísloneID kontaktu (odběratel nebo dodavatel); ID, které firmě nepatří, se uloží jako prázdné
document.issue_datedatumanoDatum vystavení; určuje rok číselné řady
document.taxable_datedatumneDUZP; u daňových dokladů se při vystavení doplní datem vystavení, pokud chybí
document.due_datedatumneDatum splatnosti; nesmí být dříve než datum vystavení
document.received_datedatumneDatum přijetí dokladu (u přijatých dokladů)
document.vat_datedatumneDatum pro DPH. U prodeje se vždy přepíše na DUZP (jinak datum vystavení). U nákupu se bez hodnoty nastaví na pozdější z DUZP a data přijetí (jinak datum vystavení); zadané dřívější datum se posune na tuto hodnotu. U samovyměření (reverse_charge, eu_goods, eu_services, triangular) je to den povinnosti přiznat daň: DUZP, u pořízení zboží z EU datum vystavení, nejpozději 15. den následujícího měsíce (§ 24, § 25 a § 92a ZDPH); dřívější datum (úplata předem) se uloží, pozdější vrátí 422.
document.accounting_datedatumneDatum účetního případu (zaúčtování). Výchozí je DUZP (jinak datum vystavení); u přijaté faktury, dobropisu a daňového dokladu k záloze s DUZP v uzamčeném období první den po uzamčení. Zadaná hodnota se uloží; změna DUZP nebo data vystavení bez ní datum znovu odvodí. DUZP zůstává pro DPH a kontrolní hlášení.
document.currencytextneKód měny ze tří písmen (převede se na velká); výchozí CZK
document.exchange_ratečísloneKurz CZK za 1 jednotku měny (> 0, 6 desetinných míst). U CZK se vždy nastaví 1. Koncept v cizí měně bez hodnoty má kurz 1; při vystavení ho server nahradí kurzem ČNB ke dni rate_date (jinak DUZP nebo vystavení), a když kurz nezjistí, doklad nevystaví (422).
document.rate_datedatumneDatum, ke kterému je kurz (informativní; posouzení limitu schvalování podle něj hledá kurz ČNB)
document.vat_modetextneRežim DPH: domestic – tuzemské plnění (výchozí), reverse_charge – přenesená daňová povinnost (§ 92a), eu_goods – dodání/pořízení zboží v EU, eu_services – služby v rámci EU, import – dovoz ze třetí země, export – vývoz do třetí země, exempt – osvobozené plnění, non_vat – mimo DPH, triangular – třístranný obchod. DPH se počítá jen v režimu domestic a jen na řádcích druhu standard (u prodeje jen u plátce DPH, u interního dokladu nikdy); u přijatých dokladů plátce DPH nebo identifikované osoby v režimech reverse_charge, eu_goods, eu_services a triangular se daň vyměří samovyměřením. Přijatý doklad v režimu import (faktura zahraničního dodavatele) do přiznání nevstupuje – daň z dovozu nese doklad customs_in (JSD). Hodnoty: domestic, reverse_charge, eu_goods, eu_services, import, export, exempt, non_vat, triangular.
document.rc_codetextneKód předmětu plnění u přenesené daňové povinnosti (číselník rc_codes v /codebooks; hodnota se neověřuje)
document.prices_include_vatano/neneCeny řádků jsou včetně DPH (výchozí false)
document.simplifiedano/neneZjednodušený daňový doklad (výchozí false)
document.regime_44ano/neneOprava daně u nedobytné pohledávky (§ 46) nebo odpočtu u závazku po splatnosti (§ 74b) – jen u dobropisu (výchozí false). Zaúčtuje jen daň (343 proti 311/321), doklad se neplatí; pohodlněji ji vystaví POST …/documents/{id}/vat_correction
document.payment_methodtextneZpůsob úhrady – převodem, hotově, kartou, dobírka, zápočet, uhrazeno zálohou, jinak (výchozí bank) Hodnoty: bank, cash, card, cod, offset, advance, other.
document.bank_account_idcelé čísloneID bankovního účtu nebo pokladny firmy pro úhradu; cizí ID se uloží jako prázdné
document.variable_symboltextneVariabilní symbol; nečíselné znaky se odstraní, nejvýše 10 číslic. U prodeje se při vystavení doplní z čísla dokladu
document.constant_symboltextneKonstantní symbol, nejvýše 10 číslic
document.specific_symboltextneSpecifický symbol, nejvýše 10 číslic
document.original_numbertextneČíslo dokladu dodavatele (u přijatých dokladů); používá se ke kontrole duplicit
document.descriptiontextnePopis dokladu
document.notetextneText na dokladu (vidí ho i zákazník)
document.internal_notetextneInterní poznámka; na sdílené stránce dokladu se nezobrazí
document.languagetextneJazyk dokladu (výchozí cs) Hodnoty: cs, en.
document.kh_sectiontextneOddíl kontrolního hlášení; jen se uloží, výpočty ho nečtou
document.cost_centertextneStředisko (podmínka pravidel schvalování)
document.projecttextneProjekt / zakázka
document.tagstextneŠtítky jako text
document.related_document_idcelé čísloneID souvisejícího dokladu firmy (např. původní faktura dobropisu); cizí ID se uloží jako prázdné
document.payee_accounttextneÚčet dodavatele vytištěný na přijatém dokladu (předčíslí-číslo/kód banky); příkaz k úhradě ho použije místo účtu kontaktu
document.payee_ibantextneIBAN dodavatele z dokladu (přednost před payee_account u plateb SEPA)
document.payee_bictextneBIC dodavatele z dokladu
document.round_wholeano/neneZaokrouhlení celkové částky na celé koruny jen pro tento doklad (true/false); null = pravidlo firmy (u přijatých dokladů jen hotovost). Import ISDOC nastaví true, když soubor uvádí PayableRoundingAmount a celou částku k úhradě.
document.series_codetextneKód další číselné řady druhu (listNumberSeries); prázdný nebo neznámý = hlavní řada
document.numbertextneVlastní číslo dokladu, jen u konceptu (u vystaveného se ignoruje); musí být v rámci druhu jedinečné. Prázdné = Saldo ho přidělí při vystavení: navazuje na číslo posledního dokladu druhu v roce, které nemá formát hlavní řady (třeba importované 2026-009 → 2026-010), jinak bere další číslo řady.
document.lines_attributespole (objekt)neŘádky dokladu v pořadí, v jakém se mají zobrazit
document.lines_attributes[].descriptiontextneText položky, nejvýše 500 znaků
document.lines_attributes[].quantityčísloneMnožství, nesmí být 0 (záporné u dobropisu nebo odpočtu); výchozí 1
document.lines_attributes[].unittextneJednotka, např. ks, hod
document.lines_attributes[].unit_pricečísloneJednotková cena (bez DPH, nebo s DPH při prices_include_vat), 4 desetinná místa
document.lines_attributes[].discount_percentčísloneSleva v procentech 0–100
document.lines_attributes[].vat_ratečísloneSazba DPH v procentech 0–100; bez hodnoty 0
document.lines_attributes[].vat_kindtextneDruh plnění – zdanitelné, osvobozené s nárokem, osvobozené bez nároku na odpočet, není předmětem daně (výchozí standard) Hodnoty: standard, exempt_with_credit, exempt_without_credit, not_subject.
document.lines_attributes[].account_codetextneÚčet (podvojné účetnictví) nebo kategorie daňové evidence; prázdný se při zaúčtování nahradí 602/518 (daňová evidence P02/V05); nejvýše 12 znaků: číslice, velká písmena, tečka, pomlčka; v podvojném účetnictví musí být v účtovém rozvrhu firmy, jinak vystavení odpoví 422
document.lines_attributes[].assetano/nenePořízení dlouhodobého majetku (u nákupu plátce i ř. 47 přiznání k DPH)
document.lines_attributes[].deductiontextneNárok na odpočet DPH u nákupu – plný, krácený koeficientem, žádný (výchozí full) Hodnoty: full, proportional, none.
document.lines_attributes[].vat_sharečíslonePodíl pro podnikání v procentech, nad 0 až 100 (výchozí 100): poměrný odpočet § 75 ZDPH u věci používané i soukromě; odpočet i zápis na 343 se sníží na tento podíl
document.lines_attributes[].advance_document_idcelé čísloneOdpočet zálohy – ID daňového dokladu k záloze (advance_out/advance_in); jiné ID se uloží jako prázdné
document.lines_attributes[].stated_vatčísloneJen customs_in: DPH řádku podle rozhodnutí celního úřadu; bez hodnoty se spočítá ze základu
document.lines_attributes[].credit_accounttextneJen internal: účet Dal řádku (account_code je MD); při vystavení povinný a jiný než MD
issueano/nenetrue = po uložení doklad vystavit (nebo odeslat ke schválení)
capture_keytextneVolitelný klíč idempotence (UUID). Opakovaný požadavek se stejným klíčem ve stejné firmě vrátí už uložený doklad místo nového. Editor Salda ho posílá u každého nového dokladu, takže opakované Vystavit po ztracené odpovědi druhý doklad nevystaví.

Odpověď

201 application/json Detail založeného dokladu jako v getDocument (včetně approval). Při opakování se stejným capture_key odpověď 200 s detailem dříve uloženého dokladu bez klíče approval.

Chyby této operace

StavKódKdy
422–capture_key není UUID: „Neplatný identifikátor nahrání“
422–kind není druh dokladu: „Neznámý druh dokladu „…““
422–S issue: true doklad bez řádků: „Doklad nemá žádnou položku“
422–S issue: true faktura, zálohová faktura, dobropis, daňový doklad k záloze nebo obchodní doklad bez kontaktu: „Doplňte odběratele nebo dodavatele“
422–S issue: true řádek odečítá neexistující nebo nevystavený daňový doklad k záloze: „Odečítaná záloha neexistuje“
422–S issue: true je daňový doklad k záloze už odečtený na jiném vystaveném dokladu: „Daňový doklad … je už odečtený na dokladu …“
422–S issue: true datum dokladu v uzamčeném období: „Období do … je uzamčeno – doklad nelze měnit“ (tvar { error, errors }); se zadaným capture_key se místo této chyby vrátí 200 s uloženým konceptem
403SUBMITTER_ONLYRole Nahrává doklady poslala issue: true nebo jiný druh než invoice_in, credit_in a cash_out; nic se neuloží

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Vytvoří doklad se zdrojem manual a jeho řádky a zapíše do historie document.created. S issue: true navíc totéž co issueDocument (číslo z řady, účetní zápisy v podvojném účetnictví, document.issued), případně odeslání ke schválení (document.approval_submitted). U přijatého výdaje v cizí měně se při zapnutém schvalování může dotázat kurz ČNB (jen pro posouzení limitu). Uložení i vystavení probíhá v jedné transakci: když vystavení selže (422), koncept se neuloží.
Limity
Popis řádku nejvýše 500 znaků; variabilní, konstantní a specifický symbol nejvýše 10 číslic.
Opakování
Bez capture_key vytvoří každé volání nový doklad (i po chybě vystavení, kdy už koncept existuje). Se stejným capture_key (bez ohledu na velikost písmen, jedinečný v rámci firmy) vrátí opakované volání dříve uložený doklad se stavem 200, tělo ignoruje a nic nevystavuje; souběžné opakování se ošetří stejně.

Příklad

Vystaví fakturu vydanou; odpověď obsahuje číslo z řady FV a stav issued.

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue":true,"document":{"kind":"invoice_out","partner_id":1,"issue_date":"2026-09-28","taxable_date":"2026-09-28","due_date":"2026-10-12","payment_method":"bank","bank_account_id":2,"description":"Konzultace – září","lines_attributes":[{"description":"Konzultace – digitální strategie","quantity":6,"unit":"hod","unit_price":2200,"vat_rate":21,"account_code":"602"}]}}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "issue": true,
    "document": {
      "kind": "invoice_out",
      "partner_id": 1,
      "issue_date": "2026-09-28",
      "taxable_date": "2026-09-28",
      "due_date": "2026-10-12",
      "payment_method": "bank",
      "bank_account_id": 2,
      "description": "Konzultace – září",
      "lines_attributes": [
        {
          "description": "Konzultace – digitální strategie",
          "quantity": 6,
          "unit": "hod",
          "unit_price": 2200,
          "vat_rate": 21,
          "account_code": "602"
        }
      ]
    }
  })
});
const data = await response.json();
Odpověď 201 Created
{
  "id": 136,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260027",
  "variable_symbol": "20260027",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 13200.0,
  "total_vat": 2772.0,
  "total_payable": 15972.0,
  "total_gross_czk": 15972.0,
  "paid_amount": 0.0,
  "remaining": 15972.0,
  "payment_state": "unpaid",
  "days_overdue": 0,
  "description": "Konzultace – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5CEE85BA-AE60-4AB7-9A87-4E199DF71486",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 15972.0,
  "total_net_czk": 13200.0,
  "total_vat_czk": 2772.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 137,
      "position": 0,
      "description": "Konzultace – digitální strategie",
      "quantity": 6.0,
      "unit": "hod",
      "unit_price": 2200.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 13200.0,
      "vat": 2772.0,
      "gross": 15972.0,
      "net_czk": 13200.0,
      "vat_czk": 2772.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 13200.0,
      "vat": 2772.0,
      "gross": 15972.0,
      "net_czk": 13200.0,
      "vat_czk": 2772.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 1,
  "attachments_locked": false,
  "issued_version": {
    "number": 1,
    "action": "issued",
    "created_at": "2026-09-28T10:00:00.000Z",
    "digest": "cb468a382a6b995643a0266240cf8281f27fc726b0a88ab3ee44a9026f947239",
    "supplier": {
      "name": "Ukázková firma s.r.o.",
      "street": "Na Příkopě",
      "house_number": "859",
      "orientation_number": "22",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ",
      "ico": "99999994",
      "dic": "CZ99999994",
      "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
      "email": "demo@example.cz",
      "phone": "+420 777 000 000",
      "web": null,
      "vat_status": "monthly",
      "invoice_footer": null,
      "logo_data": null,
      "accent_color": null,
      "settings": {
        "invoice_style": "plain",
        "invoice_font": "auto",
        "invoice_density": "normal",
        "invoice_table": "auto",
        "invoice_corners": "auto",
        "invoice_logo_size": "m",
        "show_qr": true,
        "invoice_logo_name": false,
        "invoice_row_numbers": false,
        "invoice_paid_stamp": true,
        "invoice_contacts": true,
        "invoice_credit": true
      },
      "vat_payer": true,
      "bank_account": {
        "number": "2900001227",
        "bank_code": "2010",
        "iban": "CZ3820100000002900001227",
        "bic": "FIOBCZPP",
        "currency": "CZK"
      }
    },
    "original": null
  }
}

GET Detail dokladu

/entities/{entity_id}/documents/{id}

Oprávnění
Každý člen firmy včetně role Jen čtení
Pravidlo
Role Nahrává doklady (submitter): jen vlastní doklad, jiný vrátí 404; odpověď je bez úhrad, bankovního účtu, schvalování, sdílení a řady a navíc nese return_note (důvod vrácení).
Klíč jen pro čtení
Stačí

Vrátí úplný doklad: souhrnné údaje jako v seznamu, všechny údaje dokladu, kontakt (uložený snímek – u vystaveného dokladu z okamžiku vystavení –, jinak aktuální údaje z adresáře), řádky s dopočítanými částkami, rekapitulaci DPH podle sazeb, úhrady, metadata příloh, stav sdíleného odkazu, bankovní účet, související doklad, aktivní opakování a stav schvalování. Koncept navíc nese series (číselné řady druhu), vystavená vydaná zálohová faktura plátce DPH advance_tax (daňové doklady k platbám a platby, ke kterým chybí).

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Všechna pole řádku ze seznamu dokladů (listDocuments) a navíc údaje níže. Peníze jsou čísla v měně dokladu, pole *_czk v Kč.

PoleVýznam
uuidUUID dokladu (u importu z ISDOC), jinak null
constant_symbolKonstantní symbol
specific_symbolSpecifický symbol
received_dateDatum přijetí
vat_dateDatum pro DPH
accounting_dateDatum účetního případu (zaúčtování)
payee_accountÚčet dodavatele z dokladu (také payee_iban, payee_bic)
payee_mismatchU nákupu { printed, known }, když se účet z dokladu liší od účtu kontaktu, jinak null
exchange_rateKurz CZK za jednotku měny
rate_dateDatum kurzu
rc_codeKód předmětu plnění PDP
prices_include_vatCeny včetně DPH
simplifiedZjednodušený daňový doklad
regime_44Oprava podle § 44 ZDPH
payment_methodZpůsob úhrady
bank_account_idID účtu pro úhradu
roundingZaokrouhlení částky k úhradě
total_grossČástka s DPH v měně dokladu (před zaokrouhlením)
total_net_czkZáklad v Kč
total_vat_czkDPH v Kč
noteText na dokladu
internal_noteInterní poznámka
languagecs nebo en
kh_sectionUložený oddíl kontrolního hlášení
cost_centerStředisko
projectProjekt
paid_onDatum poslední úhrady, když je doklad plně uhrazen (u pokladního dokladu datum vystavení), jinak null
created_atZaloženo
updated_atNaposledy změněno
partnerKontakt { name, ico, dic, street, city, zip, country, email, phone }
lines[]Řádky { id, position, description, quantity, unit, unit_price, discount_percent, vat_rate, vat_kind, account_code, asset, deduction, vat_share, advance_document_id, net, vat, gross, net_czk, vat_czk }
attachments[]Přílohy { id, filename, content_type, byte_size, inline, created_at }
shareVeřejný odkaz { token, shared_at, viewed_at, views } nebo null
payments[]Úhrady podle data { id, document_id, bank_transaction_id, bank_account_id, paid_on, amount, amount_czk, exchange_rate, payment_method, note, counter_document_id, counter_number, settlement_key, account_code } – poslední čtyři u zápočtu a odpisu
vat_recap[]Rekapitulace DPH po sazbách sestupně { rate, net, vat, gross, net_czk, vat_czk }
bank_accountBankovní účet nebo pokladna dokladu (údaje účtu, display_number) nebo null
related_document{ id, number, kind, currency, remaining } souvisejícího dokladu nebo null
open_credits[]U otevřené faktury vystavené dobropisy k ní, které s ní ještě nejsou započtené { id, number, remaining }; jinak prázdné
recurrenceAktivní pravidlo opakování, kde je doklad vzorem (bez template), nebo null
vat_corrections[]Opravy DPH podle § 46 nebo § 74b k faktuře { id, number, issue_date, total_vat_czk }; u jiných dokladů prázdné
vat_filedPřiznání k DPH za období dokladu, které bylo podané dřív, než doklad vznikl { period, label, filed_on, filing_id } (doklad v něm chybí), nebo null
approvalStav schvalování { state, label, required, rule, approvers, fingerprint, can_submit, can_approve, can_return, history[] } nebo null, když doklad nemá historii schvalování a schvalování se ho netýká (nebo byl vystaven dřív, než ho pravidlo pokrylo)
series_codeKód další číselné řady, nebo null (hlavní řada)
series[]Jen u konceptu: číselné řady druhu { code, label, prefix, format }
advance_taxJen u vystavené vydané zálohové faktury plátce: { duty_free (důvod, proč se daňový doklad nevystavuje, nebo null), documents[] { id, number, taxable_date, issue_date, total_gross }, gaps[] { paid_on, amount, due_on } }
versions_countPočet uložených verzí dokladu (GET …/versions); koncepty a obchodní doklady 0
issued_versionJen u vystavené nebo stornované faktury, zálohové faktury, dobropisu a daňového dokladu k záloze: verze předaná odběrateli { number, action, created_at, digest, supplier (dodavatel z doby vystavení: název, adresa, IČO, DIČ, kontakty, logo, vzhled faktury v settings, vat_payer, bank_account), original { version, sha256, byte_size, created_at } nebo null }; false, když byl doklad vystaven dřív, než Saldo vystavené verze ukládalo (tisk pak ukazuje dnešní údaje firmy)
attachments_lockedtrue, když je doklad vystavený nebo stornovaný a leží v uzamčeném období – přílohy pak nejde smazat

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 129,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260025",
  "variable_symbol": "20260025",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "unpaid",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 130,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": {
    "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
    "shared_at": "2026-09-28T10:00:00.000Z",
    "viewed_at": null,
    "views": 0
  },
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 1,
  "attachments_locked": false,
  "issued_version": {
    "number": 1,
    "action": "issued",
    "created_at": "2026-09-28T10:00:00.000Z",
    "digest": "a956a6ec56c1861f94eb51c270eb620bf3c94b457240e4ce5cfbb7fa4af0a15f",
    "supplier": {
      "name": "Ukázková firma s.r.o.",
      "street": "Na Příkopě",
      "house_number": "859",
      "orientation_number": "22",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ",
      "ico": "99999994",
      "dic": "CZ99999994",
      "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
      "email": "demo@example.cz",
      "phone": "+420 777 000 000",
      "web": null,
      "vat_status": "monthly",
      "invoice_footer": null,
      "logo_data": null,
      "accent_color": null,
      "settings": {
        "invoice_style": "plain",
        "invoice_font": "auto",
        "invoice_density": "normal",
        "invoice_table": "auto",
        "invoice_corners": "auto",
        "invoice_logo_size": "m",
        "show_qr": true,
        "invoice_logo_name": false,
        "invoice_row_numbers": false,
        "invoice_paid_stamp": true,
        "invoice_contacts": true,
        "invoice_credit": true
      },
      "vat_payer": true,
      "bank_account": {
        "number": "2900001227",
        "bank_code": "2010",
        "iban": "CZ3820100000002900001227",
        "bic": "FIOBCZPP",
        "currency": "CZK"
      }
    },
    "original": null
  }
}

PATCH Úprava dokladu

/entities/{entity_id}/documents/{id}

Oprávnění
Vlastník, účetní nebo editor
Pravidlo
Změnu částky, kurzu, dodavatele (včetně jeho účtu), střediska nebo účtů zaúčtovaného přijatého výdaje, na který se vztahuje pravidlo schvalování, smí uložit jen jeho schvalovatel; ostatním vrátí 422. Role Nahrává doklady (submitter): jen vlastní koncept (cizí doklad 404), bez issue a se stejným omezením polí jako při založení.
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Změní údaje dokladu a jeho řádků; kind se ignoruje (druh nelze změnit). Řádek s id se upraví, řádek s id a _destroy: true se odebere, řádek bez id se přidá; řádky, které v požadavku nejsou, zůstanou beze změny. Upravit lze i vystavený doklad: u vystaveného se účetní zápisy smažou a zaúčtují znovu a při změně kontaktu se obnoví snímek kontaktu. Změní-li se kurz nebo částka dokladu s úhradami, zaúčtují se znovu i úhrady (kurzový rozdíl proti novému kurzu), aby saldokonto 311/321 sedělo; měnu dokladu s úhradou změnit nejde (422). U vystavené faktury, dobropisu a daňového dokladu k záloze nejde měnit kontakt, data vystavení a DUZP, měnu, kurz, režim DPH, kód § 92a, ceny s DPH ani řádky (popis, množství, jednotku, cenu, slevu, sazbu, druh plnění; přidat ani odebrat) – oprava se dělá opravným daňovým dokladem (§ 45 ZDPH); účty řádků, středisko, zakázku, splatnost, platební údaje a poznámky změnit lze. Stornovaný doklad upravit nejde. Změna vystaveného dokladu, jehož data leží v uzamčeném období, se odmítne; u konceptu se uzamčení nekontroluje. S issue: true se koncept po uložení vystaví (nebo odešle ke schválení); u nekonceptu se issue ignoruje.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
documentobjektano
document.partner_idcelé čísloneID kontaktu; cizí ID se uloží jako prázdné
document.issue_datedatumneDatum vystavení
document.taxable_datedatumneDUZP
document.due_datedatumneDatum splatnosti; nesmí být dříve než datum vystavení
document.received_datedatumneDatum přijetí
document.vat_datedatumneDatum pro DPH (u prodeje se přepíše na DUZP, u nákupu nejdřív DUZP / datum přijetí, u samovyměření den povinnosti přiznat daň)
document.accounting_datedatumneDatum účetního případu; bez hodnoty DUZP, do uzamčeného období první otevřený den (viz createDocument)
document.currencytextneKód měny
document.exchange_ratečísloneKurz CZK za jednotku měny (> 0); u CZK vždy 1
document.rate_datedatumneDatum kurzu
document.vat_modetextneRežim DPH (viz createDocument) Hodnoty: domestic, reverse_charge, eu_goods, eu_services, import, export, exempt, non_vat, triangular.
document.rc_codetextneKód předmětu plnění PDP
document.prices_include_vatano/neneCeny včetně DPH
document.simplifiedano/neneZjednodušený daňový doklad
document.regime_44ano/neneOprava podle § 44 ZDPH
document.payment_methodtextneZpůsob úhrady Hodnoty: bank, cash, card, cod, offset, advance, other.
document.bank_account_idcelé čísloneID bankovního účtu nebo pokladny; cizí ID se uloží jako prázdné
document.variable_symboltextneVariabilní symbol (jen číslice, nejvýše 10)
document.constant_symboltextneKonstantní symbol, nejvýše 10 číslic
document.specific_symboltextneSpecifický symbol, nejvýše 10 číslic
document.original_numbertextneČíslo dokladu dodavatele
document.descriptiontextnePopis
document.notetextneText na dokladu
document.internal_notetextneInterní poznámka
document.languagetextneJazyk dokladu Hodnoty: cs, en.
document.kh_sectiontextneOddíl kontrolního hlášení (jen se uloží)
document.cost_centertextneStředisko
document.projecttextneProjekt
document.tagstextneŠtítky
document.related_document_idcelé čísloneID souvisejícího dokladu; cizí ID se uloží jako prázdné
document.lines_attributespole (objekt)neZměny řádků – s id úprava, s id a _destroy smazání, bez id nový řádek
document.lines_attributes[].idcelé čísloneID existujícího řádku dokladu
document.lines_attributes[]._destroyano/nenetrue = řádek odebrat
document.lines_attributes[].descriptiontextneText položky, nejvýše 500 znaků
document.lines_attributes[].quantityčísloneMnožství, nesmí být 0
document.lines_attributes[].unittextneJednotka
document.lines_attributes[].unit_pricečísloneJednotková cena
document.lines_attributes[].discount_percentčísloneSleva 0–100 %
document.lines_attributes[].vat_ratečísloneSazba DPH 0–100 %
document.lines_attributes[].vat_kindtextneDruh plnění Hodnoty: standard, exempt_with_credit, exempt_without_credit, not_subject.
document.lines_attributes[].account_codetextneÚčet nebo kategorie daňové evidence
document.lines_attributes[].assetano/nenePořízení dlouhodobého majetku
document.lines_attributes[].deductiontextneNárok na odpočet Hodnoty: full, proportional, none.
document.lines_attributes[].vat_sharečíslonePodíl pro podnikání v procentech (poměrný odpočet § 75 ZDPH), výchozí 100
document.lines_attributes[].advance_document_idcelé čísloneID odečítaného daňového dokladu k záloze
issueano/nenetrue = koncept po uložení vystavit (nebo odeslat ke schválení)

Odpověď

200 application/json Detail upraveného dokladu jako v getDocument (včetně approval).

Chyby této operace

StavKódKdy
422–Data dokladu v uzamčeném období (u nekonceptu): „Období do … je uzamčeno – doklad nelze měnit“ (tvar { error, errors })
422–Změna údajů vystaveného daňového dokladu: „Faktura … je vystavený daňový doklad – odběratele, data, měnu, kurz, režim DPH ani položky v něm už neměňte. …“
422–Stornovaný doklad: „Stornovaný doklad nelze měnit – vystavte nový doklad“
422–Účetní zápisy vystaveného dokladu leží v uzamčeném období: „Období do … je uzamčeno – zaúčtování nelze změnit“
422–Nepovolená změna zaúčtovaného výdaje ve schvalování: „Změnu částky, kurzu, dodavatele, střediska nebo účtů u zaúčtovaného dokladu musí schválit … – vraťte doklad do konceptu a odešlete ho ke schválení“
422–S issue: true stejné chyby jako issueDocument (bez řádků, bez kontaktu, odečítaná záloha)
403SUBMITTER_ONLYRole Nahrává doklady mění zaúčtovaný doklad nebo posílá issue: true

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Uloží změny a zapíše document.updated; u vystaveného dokladu v podvojném účetnictví přeúčtuje jeho účetní zápisy a když se obsah změnil, uloží novou verzi dokladu (původní obsah a zápisy zůstanou v předchozí verzi) a událost nese details.version a details.changes. Při zapnutém schvalování změnu schvalovaných údajů schvalovatelem rovnou znovu schválí, změnu jiného člena u schváleného dokladu označí „Změněno po schválení“. S issue: true navíc jako issueDocument; když vystavení selže, neuloží se ani změny.
Opakování
Opakování se stejným tělem dá stejný výsledek, kromě řádků bez id – ty se při každém volání přidají znovu; každé volání zapíše další document.updated.

Příklad

cURL

curl \
  -X PATCH \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document":{"due_date":"2026-10-20","note":"Děkujeme za spolupráci."}}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/132

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/132', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'PATCH',
  body: JSON.stringify({
    "document": {
      "due_date": "2026-10-20",
      "note": "Děkujeme za spolupráci."
    }
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 132,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-20",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Návrh úvodní stránky",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": "Děkujeme za spolupráci.",
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 133,
      "position": 0,
      "description": "Návrh úvodní stránky",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 0,
  "attachments_locked": false,
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ]
}

DELETE Smazání konceptu nebo stornovaného dokladu

/entities/{entity_id}/documents/{id}

Oprávnění
Vlastník, účetní nebo editor
Pravidlo
Role Nahrává doklady (submitter): jen vlastní koncept, cizí doklad vrátí 404.
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Smaže koncept, který ještě nemá číslo (nikdy nebyl vystaven), nebo stornovaný doklad, s jeho řádky, přílohami, historií schvalování a verzemi a zruší otevřené žádosti o podklad k dokladu. Vystavený doklad se nejdřív stornuje. Bylo-li číslo smazaného dokladu poslední z řady, řada se o jedno vrátí a další doklad ho dostane znovu. Koncept vrácený z vystaveného dokladu (má číslo) se také nejdřív stornuje.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1540.

Odpověď

204 Prázdná odpověď.

Chyby této operace

StavKódKdy
422–Doklad je vystavený: „Vystavený doklad nejdřív stornujte, potom ho půjde smazat“
422–Koncept už má číslo z řady: „Koncept už má číslo z řady – stornujte ho, potom ho půjde smazat“
422–Doklad (i koncept) je vzorem automatického pravidla: „Doklad nelze smazat – je z něj automatické pravidlo – nejdřív pravidlo zrušte“
422–Stornovaný doklad v uzamčeném období: „Období do 31. 8. 2026 je uzamčeno – doklad nelze smazat“
422–Na stornovaný doklad něco odkazuje (dobropis, odpočet zálohy, zápočet, pravidlo opakování, majetek, časové rozlišení, oprava DPH): „Doklad nelze smazat – odkazuje na něj doklad OV20260002“
422–Stornovaná faktura má uložený originál PDF předaný odběrateli: „Doklad nelze smazat – jeho originál PDF předaný odběrateli se archivuje, stornovaný doklad zůstává v evidenci“
403SUBMITTER_ONLYRole Nahrává doklady maže zaúčtovaný doklad

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Smaže doklad, řádky, přílohy, verze a záznamy schvalování; otevřené žádosti o podklad k dokladu zruší (zpráva a událost document_request.cancelled) a zapíše document.deleted. U stornovaného dokladu s posledním číslem řady sníží další číslo řady o jedno. Pravidlo opakování, jehož je koncept vzorem, se nesmaže.
Opakování
Druhé volání vrátí 404.

Příklad

cURL

curl \
  -X DELETE \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/132

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/132', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'DELETE'
});
const data = await response.json();
Odpověď 204 No Content
soubor, 0 bajtů

GET Předvyplněný nový doklad

/entities/{entity_id}/documents/template

Oprávnění
Každý člen firmy včetně role Jen čtení
Pravidlo
Role Nahrává doklady (submitter): jen invoice_in, credit_in nebo cash_out (jiný druh dá invoice_in), bez bankovního účtu, náhledu čísla a řad.
Klíč jen pro čtení
Stačí

Vrátí neuložený koncept zvoleného druhu s výchozími hodnotami firmy: datum vystavení dnes, DUZP dnes u daňových dokladů, datum přijetí dnes u nákupních, u faktur, zálohových faktur a dobropisů splatnost podle výchozí splatnosti firmy (u nabídky 30 dní, jinde žádná), jazyk z nastavení faktur, u pokladních dokladů hotově a první aktivní pokladna, jinak převodem a výchozí (nebo první) aktivní bankovní účet, tuzemské plnění a jeden řádek 1 ks s cenou 0, sazbou 21 % (u prodeje neplátce DPH 0 %) a výchozím účtem. Přidá number_preview – číslo, které by doklad dostal při vystavení dnes v hlavní řadě – a series, číselné řady druhu. Nic neukládá; doklad se založí přes createDocument.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
kinddotaztextneDruh dokladu; neznámá hodnota znamená invoice_out Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Výchozí invoice_out. Příklad invoice_in.

Odpověď

200 application/json Doklad ve tvaru getDocument (id null, status draft, částky 0, přílohy a úhrady prázdné, approval chybí) a navíc number_preview.

PoleVýznam
number_previewNáhled čísla z hlavní číselné řady k dnešnímu dni
series[]Číselné řady druhu { code, label, prefix, format }; první je hlavní (code prázdný)
lines[]Jeden výchozí řádek bez id

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/template?kind=invoice_out"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/template?kind=invoice_out', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": null,
  "partner_name": null,
  "partner_ico": null,
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": null,
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {},
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "",
      "quantity": 1.0,
      "unit": "ks",
      "unit_price": 0.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "FV20260027",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ]
}

GET Náhled dalšího čísla dokladu

/entities/{entity_id}/documents/next_number

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí číslo, které by dostal doklad druhu kind v řadě series vystavený k datu date, podle formátu čísel firmy nebo řady (výchozí {prefix}{yyyy}{nnnn}, např. FV20260001; další zástupné znaky {yy}, {mm}). Každá řada druhu má vlastní pořadí pro každý kalendářní rok data vystavení (listNumberSeries). Jde jen o náhled: číslo se nerezervuje a při vystavení se přeskočí čísla, která už nějaký doklad téhož druhu používá (např. z importu).

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
kinddotaztextneDruh dokladu; neznámá hodnota znamená invoice_out Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Výchozí invoice_out. Příklad invoice_out.
datedotazdatumneDatum vystavení, ke kterému se číslo počítá (výchozí dnes) Příklad 2026-09-28.
seriesdotaztextneKód další číselné řady; prázdný nebo neznámý = hlavní řada Příklad eshop.

Odpověď

200 application/json Objekt s náhledem čísla.

PoleVýznam
numberČíslo, např. FV20260042

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/next_number?kind=invoice_out&date=2026-09-28"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/next_number?kind=invoice_out&date=2026-09-28', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "number": "FV20260027"
}

GET Číselné řady firmy

/entities/{entity_id}/series

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Pro každý druh dokladu vrátí jeho číselné řady za rok year: hlavní řadu (code prázdný) s předponou a formátem a další řady (pobočka, e-shop), u každé další číslo, náhled čísla a počet očíslovaných dokladů v roce.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
yeardotazcelé čísloneRok (výchozí letošní) Příklad 2026.

Odpověď

200 application/json Rok a řady po druzích dokladů.

PoleVýznam
yearRok
kinds[]{ kind, label, default_prefix, series[] }
kinds[].series[]{ code, label, prefix, format, next_number, preview, used }

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/series?year=2026"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/series?year=2026', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "year": 2026,
  "kinds": [
    {
      "kind": "invoice_out",
      "label": "Faktura vydaná",
      "default_prefix": "FV",
      "series": [
        {
          "code": "",
          "label": "Hlavní řada",
          "prefix": "FV",
          "format": "{prefix}{yyyy}{nnnn}",
          "next_number": 27,
          "preview": "FV20260027",
          "used": 26
        }
      ]
    },
    {
      "kind": "invoice_in",
      "label": "Faktura přijatá",
      "default_prefix": "FP",
      "series": [
        {
          "code": "",
          "label": "Hlavní řada",
          "prefix": "FP",
          "format": "{prefix}{yyyy}{nnnn}",
          "next_number": 40,
          "preview": "FP20260040",
          "used": 39
        }
      ]
    }
  ]
}

Dlouhé seznamy jsou v ukázce zkrácené na první položky.

PATCH Nastavení číselné řady

/entities/{entity_id}/series/{id}

Oprávnění
Vlastník nebo účetní
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

U druhu dokladu id změní předponu a formát hlavní řady, seznam dalších řad a další číslo řad v roce year. Pole, která v těle nejsou, se nemění; extra nahradí celý seznam dalších řad. Další číslo jde snížit jen v řadě, která v daném roce ještě nemá očíslovaný doklad; dvě řady druhu nesmí dávat stejná čísla a řadu s doklady nejde odebrat.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestatextanoDruh dokladu Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Příklad invoice_out.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
yearcelé čísloneRok, kterého se týká numbers (výchozí letošní)
prefixtextnePředpona hlavní řady, nejvýše 10 znaků (písmena, číslice, - / _ .); prázdná = bez předpony
formattextneFormát čísel druhu, např. {prefix}{yy}-{nnnnn}; musí obsahovat {n…}; prázdný = formát firmy
extrapole (objekt)neDalší řady druhu
extra[].codetextneKód řady, 1–20 malých písmen, číslic nebo pomlček
extra[].labeltextneNázev řady (do 40 znaků)
extra[].prefixtextnePředpona řady
extra[].formattextneVlastní formát řady (nepovinné)
numbersobjektneDalší číslo podle kódu řady, např. { "": 138, "eshop": 1 }

Odpověď

200 application/json Řady druhu ve tvaru kinds[] z listNumberSeries.

Chyby této operace

StavKódKdy
403–Volající není vlastník ani účetní firmy
422–Snížení čísla v řadě s doklady: „Řada už má v roce … očíslované doklady – další číslo lze jen zvýšit (teď …)“
422–Neplatná předpona, formát nebo kód řady, dvě řady se stejnými čísly, odebrání použité řady

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Uloží nastavení řad firmy a další čísla a zapíše series.updated s původním a novým nastavením.
Opakování
Opakování se stejným tělem nic dalšího nezmění (zapíše další událost).

Příklad

cURL

curl \
  -X PATCH \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"extra":[{"code":"eshop","label":"E-shop","prefix":"EV"}],"numbers":{"eshop":1}}' \
  https://techtools.cz/ucetnictvi-api/entities/1/series/invoice_out

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/series/invoice_out', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'PATCH',
  body: JSON.stringify({
    "year": 2026,
    "extra": [
      {
        "code": "eshop",
        "label": "E-shop",
        "prefix": "EV"
      }
    ],
    "numbers": {
      "eshop": 1
    }
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "kind": "invoice_out",
  "label": "Faktura vydaná",
  "default_prefix": "FV",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}",
      "next_number": 27,
      "preview": "FV20260027",
      "used": 26
    },
    {
      "code": "eshop",
      "label": "E-shop",
      "prefix": "EV",
      "format": "{prefix}{yyyy}{nnnn}",
      "next_number": 1,
      "preview": "EV20260001",
      "used": 0
    }
  ]
}

GET Našeptávač položek z dřívějších dokladů

/entities/{entity_id}/documents/items

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí nejvýše 8 položek, které firma použila na dokladech stejného směru jako kind (prodej, nákup, nebo interní), jejichž text obsahuje všechna slova dotazu (bez ohledu na velikost písmen a diakritiku); prázdný dotaz vrátí nejčastější položky. Prochází posledních 3 000 řádků nestornovaných dokladů s kladným množstvím a neprázdným textem, bez odpočtů záloh. Položky se stejným textem se sloučí a hodnoty jsou z posledního použití. Pořadí: skóre (četnost, text nebo slovo začíná dotazem, použití za posledních 45 a 180 dní), pak novější použití.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
qdotaztextneHledaná slova Příklad konzultace.
kinddotaztextneDruh editovaného dokladu; určuje směr (prodej / nákup / interní) Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Výchozí invoice_out. Příklad invoice_out.

Odpověď

200 application/json Návrhy položek.

PoleVýznam
rows[].descriptionText položky
rows[].unitJednotka
rows[].unit_priceJednotková cena z posledního použití
rows[].vat_rateSazba DPH
rows[].vat_kindDruh plnění
rows[].account_codeÚčet / kategorie
rows[].discount_percentSleva
rows[].currencyMěna dokladu, kde byla položka naposledy
rows[].prices_include_vatZda byla cena včetně DPH
rows[].countKolikrát byla položka použita
rows[].last_usedDatum vystavení posledního dokladu s položkou
rows[].scoreSkóre pořadí

Chování

Co změní
Nic nezapisuje.
Limity
Nejvýše 8 návrhů; prohledá posledních 3 000 řádků.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/items?q=konzultace&kind=invoice_out"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/items?q=konzultace&kind=invoice_out', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "rows": [
    {
      "description": "Konzultace – srpen",
      "unit": "hod",
      "unit_price": 1650.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "discount_percent": 0.0,
      "currency": "CZK",
      "prices_include_vat": false,
      "count": 1,
      "last_used": "2026-08-31",
      "score": 11
    },
    {
      "description": "Konzultace – digitální strategie",
      "unit": "hod",
      "unit_price": 2200.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "discount_percent": 0.0,
      "currency": "CZK",
      "prices_include_vat": false,
      "count": 3,
      "last_used": "2026-07-15",
      "score": 10
    }
  ]
}

GET Výchozí údaje dokladu podle kontaktu

/entities/{entity_id}/documents/partner_defaults

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Pro kontakt vrátí údaje z jeho posledního nestornovaného dokladu (i konceptu) stejného směru jako kind (přednostně stejného druhu): měnu, způsob úhrady, jazyk, režim DPH, kód PDP, ceny s DPH, konstantní symbol, bankovní účet (jen je-li stále aktivní) a splatnost ve dnech (z kontaktu, jinak z posledního dokladu s úhradou, 0–365). U nákupu navrhne účet řádku. last_document nese řádky posledního dokladu stejného druhu (bez odpočtů záloh) pro „Stejné jako minule“.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
partner_iddotazcelé čísloanoID kontaktu firmy Příklad 118.
kinddotaztextneDruh editovaného dokladu Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Výchozí invoice_out. Příklad invoice_in.

Odpověď

200 application/json Výchozí hodnoty; bez předchozího dokladu jsou údaje dokladu null.

PoleVýznam
partner_idID kontaktu
based_on{ id, number, kind, issue_date } dokladu, ze kterého hodnoty pocházejí (number u konceptu je text Koncept), nebo null
currencyMěna
payment_methodZpůsob úhrady
languageJazyk
vat_modeRežim DPH
rc_codeKód PDP
prices_include_vatCeny s DPH
constant_symbolKonstantní symbol
bank_account_idAktivní bankovní účet posledního dokladu nebo null
due_daysSplatnost ve dnech nebo null
account_codeU nákupu výchozí účet kontaktu, jinak nejčastější účet řádků vystavených přijatých faktur, dobropisů a výdajových pokladních dokladů kontaktu (bez záloh, odpočtů záloh a účtů 314, 324, 343), jinak 518 (daňová evidence V05); u prodeje a interního dokladu null
account_sourceOdkud je account_code: partner (výchozí účet kontaktu), history (dřívější doklady), default (výchozí účet firmy); u prodeje null
last_document{ id, number, issue_date, total_payable, currency, prices_include_vat, lines[] } posledního dokladu stejného druhu, nebo null

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/partner_defaults?partner_id=1&kind=invoice_out"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/partner_defaults?partner_id=1&kind=invoice_out', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "partner_id": 1,
  "based_on": {
    "id": 132,
    "number": "Koncept",
    "kind": "invoice_out",
    "issue_date": "2026-09-28"
  },
  "currency": "CZK",
  "payment_method": "bank",
  "language": "cs",
  "vat_mode": "domestic",
  "rc_code": null,
  "prices_include_vat": false,
  "constant_symbol": null,
  "bank_account_id": 2,
  "due_days": 14,
  "account_code": null,
  "account_source": null,
  "last_document": {
    "id": 132,
    "number": "Koncept",
    "issue_date": "2026-09-28",
    "total_payable": 23958.0,
    "currency": "CZK",
    "prices_include_vat": false,
    "lines": [
      {
        "description": "Návrh úvodní stránky",
        "quantity": 12.0,
        "unit": "hod",
        "unit_price": 1650.0,
        "discount_percent": 0.0,
        "vat_rate": 21.0,
        "vat_kind": "standard",
        "account_code": "602",
        "deduction": "full",
        "vat_share": 100.0,
        "asset": false
      }
    ]
  }
}

GET Kontrola duplicity přijatého dokladu

/entities/{entity_id}/documents/duplicates

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Zjistí, zda firma už nemá stejný přijatý doklad. Kontroluje jen nákupní druhy (invoice_in, proforma_in, advance_in, credit_in, cash_out) se známým kontaktem firmy a porovnává s nestornovanými nákupními doklady téhož dodavatele (stejný kontakt nebo stejné IČO): nejdřív shodné číslo dokladu dodavatele (bez ohledu na velikost písmen a mezery na krajích), jinak stejná měna a částka k úhradě (±0,005) s datem vystavení nejvýše 3 dny od zadaného. Vrátí nejstarší takový doklad s větou pro uživatele, jinak null. Ukládání dokladu tuto kontrolu neprovádí; hromadné vystavení ano.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
kinddotaztextneDruh kontrolovaného dokladu; u jiného než nákupního druhu (včetně internal a order_out) je výsledek vždy null Hodnoty: invoice_out, invoice_in, proforma_out, proforma_in, advance_out, advance_in, credit_out, credit_in, customs_in, cash_in, cash_out, internal, quote_out, order_in, order_out, delivery_out. Výchozí invoice_out. Příklad invoice_in.
partner_iddotazcelé čísloneID dodavatele; bez něj (nebo s cizím ID) je výsledek null Příklad 131.
original_numberdotaztextneČíslo dokladu dodavatele Příklad 2026090815.
issue_datedotazdatumneDatum vystavení (pro shodu podle částky) Příklad 2026-09-20.
totaldotazčísloneČástka k úhradě v měně dokladu (pro shodu podle částky; 0 nebo prázdná shodu podle částky vypne) Příklad 17545.
currencydotaztextneKód měny dokladu velkými písmeny (pro shodu podle částky); hodnota se nepřevádí, takže s eur se shoda podle částky nenajde Výchozí CZK. Příklad CZK.
iddotazcelé čísloneID právě upravovaného dokladu, který se má z porovnání vynechat Příklad 1540.

Odpověď

200 application/json Pravděpodobná duplicita nebo null.

PoleVýznam
duplicate_ofnull, nebo { id, number, kind, status, original_number, issue_date, total_payable, currency, partner, reason, message }
duplicate_of.reasonnumber (stejné číslo dokladu dodavatele) nebo amount (stejná částka do 3 dnů)
duplicate_of.messageČeská věta pro uživatele

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/duplicates?kind=invoice_in&partner_id=6&original_number=FA-2026-0815&issue_date=2026-09-20&total=17545&currency=CZK"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/duplicates?kind=invoice_in&partner_id=6&original_number=FA-2026-0815&issue_date=2026-09-20&total=17545&currency=CZK', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "duplicate_of": null
}

GET Doklady k upomenutí s úroky z prodlení

/entities/{entity_id}/documents/reminders

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Bez ids vrátí vydané faktury (invoice_out) po splatnosti, u nichž od splatnosti i od poslední upomínky uplynulo aspoň tolik dní, kolik je v nastavení automatizace (reminder_days, výchozí 7), seřazené podle splatnosti. S ids vrátí z uvedených dokladů firmy jen vydané faktury a vydané zálohové faktury po splatnosti; ostatní započte do skipped. U každého dokladu spočítá úrok z prodlení k dnešku podle NV č. 351/2013 Sb. (a u kontaktu s IČO náklady uplatnění pohledávky 1 200 Kč). Nic nezaznamenává – upomínku zapíše recordDocumentReminder nebo hromadná akce remind.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idsdotaztextneID dokladů oddělená čárkou (nebo opakovaný parametr ids[]); použije se prvních 100 Příklad 15321533.

Odpověď

200 application/json Doklady s úrokem a pořadím příští upomínky.

PoleVýznam
daysPočet dní po splatnosti z nastavení automatizace (reminder_days)
entityÚdaje firmy pro hlavičku upomínky
skippedS ids počet uvedených ID, které nejsou vydanou fakturou nebo zálohovou fakturou po splatnosti (i cizí ID); bez ids 0
rows[].documentDetail dokladu (bez approval)
rows[].interestVýpočet úroku jako v getDocumentReminder, nebo null, když výpočet nejde
rows[].next_levelPořadí příští upomínky (zaznamenané upomínky + 1)

Chování

Co změní
Nic nezapisuje.
Limity
Nejvýše 100 ID v parametru ids.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/reminders

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/reminders', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "days": 7,
  "entity": {
    "id": 1,
    "accent_color": null,
    "archived": false,
    "bookkeeping": "double_entry",
    "city": "Praha",
    "company_id": null,
    "country": "CZ",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "databox": null,
    "default_due_days": 14,
    "dic": "CZ99999994",
    "email": "demo@example.cz",
    "first_name": null,
    "fiscal_year_start": 1,
    "flat_expense_rate": null,
    "house_number": "859",
    "ico": "99999994",
    "invoice_footer": null,
    "last_name": null,
    "legal_form": "sro",
    "locked_until": null,
    "nace": "621000",
    "name": "Ukázková firma s.r.o.",
    "orientation_number": "22",
    "owner_id": 1,
    "phone": "+420 777 000 000",
    "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
    "responsible_id": null,
    "street": "Na Příkopě",
    "tax_office_code": "451",
    "tax_office_workplace": "2001",
    "title": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "vat_registered_on": "2023-01-01",
    "vat_status": "monthly",
    "web": null,
    "zip": "11000",
    "settings": {
      "round_total": "always",
      "invoice_language": "cs",
      "number_format": "{prefix}{yyyy}{nnnn}",
      "reminder_days": [
        3,
        14
      ],
      "show_qr": true,
      "invoice_style": "plain",
      "invoice_font": "auto",
      "invoice_density": "normal",
      "invoice_table": "auto",
      "invoice_corners": "auto",
      "invoice_logo_size": "m",
      "invoice_logo_name": false,
      "invoice_row_numbers": false,
      "invoice_paid_stamp": true,
      "invoice_contacts": true,
      "invoice_credit": true,
      "demo": true,
      "statement_category": "mikro",
      "submitter": {
        "first_name": "Jana",
        "last_name": "Ukázková",
        "relation": "jednatelka"
      },
      "tax_profile": {
        "children": [
          {
            "order": 1,
            "first_name": "Eliška",
            "last_name": "Ukázková"
          }
        ],
        "main_activity": true
      },
      "ossz_code": "110",
      "cssz_variable_symbol": "1234567890",
      "jmhz_workplace": {
        "municipality": "Praha",
        "municipality_code": "554782",
        "country": "CZ"
      },
      "tax_years": null
    },
    "has_logo": false,
    "legal_form_label": "s.r.o.",
    "bookkeeping_label": "Podvojné účetnictví",
    "vat_status_label": "Plátce DPH – měsíčně",
    "vat_payer": true,
    "double_entry": true,
    "role": null,
    "can_write": null,
    "can_manage": null,
    "payroll_access": false,
    "member_user_id": null,
    "membership_id": null,
    "ownership_offer": null
  },
  "skipped": 0,
  "rows": [
    {
      "document": {
        "id": 130,
        "kind": "invoice_out",
        "kind_label": "Faktura vydaná",
        "status": "issued",
        "number": "FV20260026",
        "variable_symbol": "20260026",
        "original_number": null,
        "partner_id": 1,
        "partner_name": "Nordwood Studio s.r.o.",
        "partner_ico": "90000013",
        "issue_date": "2026-08-31",
        "taxable_date": "2026-08-31",
        "due_date": "2026-09-14",
        "currency": "CZK",
        "total_net": 19800.0,
        "total_vat": 4158.0,
        "total_payable": 23958.0,
        "total_gross_czk": 23958.0,
        "paid_amount": 0.0,
        "remaining": 23958.0,
        "payment_state": "overdue",
        "days_overdue": 14,
        "description": "Konzultace – srpen",
        "vat_mode": "domestic",
        "source": "manual",
        "tags": null,
        "related_document_id": null,
        "reminders_sent": 0,
        "outcome": null,
        "attachments_count": 0,
        "approval_state": null,
        "created_by_id": 1,
        "created_by_name": "ukazka",
        "uuid": "73627D73-9935-4F92-8928-F62DE05B6E66",
        "constant_symbol": null,
        "specific_symbol": null,
        "received_date": null,
        "vat_date": "2026-08-31",
        "exchange_rate": 1.0,
        "rate_date": null,
        "rc_code": null,
        "prices_include_vat": false,
        "simplified": false,
        "regime_44": false,
        "payment_method": "bank",
        "bank_account_id": 2,
        "rounding": 0.0,
        "total_gross": 23958.0,
        "total_net_czk": 19800.0,
        "total_vat_czk": 4158.0,
        "note": null,
        "internal_note": null,
        "language": "cs",
        "kh_section": null,
        "cost_center": null,
        "project": null,
        "paid_on": null,
        "round_whole": null,
        "payee_account": null,
        "payee_iban": null,
        "payee_bic": null,
        "series_code": null,
        "created_at": "2026-09-28T10:00:00.000Z",
        "updated_at": "2026-09-28T10:00:00.000Z",
        "accounting_date": "2026-08-31",
        "payee_mismatch": null,
        "partner": {
          "name": "Nordwood Studio s.r.o.",
          "ico": "90000013",
          "dic": "CZ90000013",
          "street": "Korunní 1208/74",
          "city": "Praha 10",
          "zip": "10100",
          "country": "CZ",
          "email": "fakturace@example.cz",
          "phone": null
        },
        "lines": [
          {
            "id": 131,
            "position": 0,
            "description": "Konzultace – srpen",
            "quantity": 12.0,
            "unit": "hod",
            "unit_price": 1650.0,
            "discount_percent": 0.0,
            "vat_rate": 21.0,
            "vat_kind": "standard",
            "account_code": "602",
            "credit_account": null,
            "asset": false,
            "deduction": "full",
            "vat_share": 100.0,
            "advance_document_id": null,
            "stated_vat": null,
            "net": 19800.0,
            "vat": 4158.0,
            "gross": 23958.0,
            "net_czk": 19800.0,
            "vat_czk": 4158.0
          }
        ],
        "attachments": [],

…

Dlouhé seznamy jsou v ukázce zkrácené na první položky.

POST Hromadná akce s doklady

/entities/{entity_id}/documents/bulk

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Provede jednu akci s každým vybraným dokladem zvlášť – odmítnutí jednoho dokladu nezastaví ostatní a odpověď říká, co se povedlo a proč zbytek ne. issue vystaví koncepty jako issueDocument, ale nikdy neschvaluje (přijatý výdaj, který schválení potřebuje a nemá ho, odmítne) a nevystaví koncept přijatého dokladu, který vypadá jako duplicita (viz findDuplicateDocument). pay zaznamená úhradu zbývající částky k paid_on na bank_account_id (hotově, je-li to pokladna, jinak převodem); zálohovou fakturu vyúčtovanou konečnou fakturou (payment_state settled) odmítne. remind zaznamená upomínku u vydané faktury nebo zálohové faktury po splatnosti. recode nastaví řádkům účet account_code (s from_account jen řádkům s tímto účtem, řádky odpočtu zálohy nikdy), dokladu cost_center a project; uloží se jako změna v editoru (vystavený doklad se přeúčtuje, uzamčené období a schvalování platí). delete smaže koncepty bez čísla. Parametr se jmenuje operation, protože název action je v Rails vyhrazený.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
operationtextanoHromadná akce Hodnoty: issue, pay, remind, recode, delete.
idspole (celé číslo)anoID dokladů firmy (lze i jeden řetězec s ID oddělenými čárkou); ID jiných firem se tiše vynechají
paid_ondatumneJen pay – datum úhrady (výchozí dnes)
bank_account_idcelé čísloneJen pay – bankovní účet nebo pokladna, na kterou se úhrada zaznamená; ID, které firmě nepatří, vrátí 422 a nic se nezaplatí
account_codetextneJen recode – nový účet řádků (musí být v účtovém rozvrhu firmy)
from_accounttextneJen recode s account_code – změnit jen řádky s tímto účtem
cost_centertextneJen recode – nové středisko (nejvýš 80 znaků)
projecttextneJen recode – nová zakázka (nejvýš 80 znaků)

Odpověď

200 application/json Výsledek akce po dokladech.

PoleVýznam
operationProvedená akce
donePočet dokladů, u kterých akce proběhla
failed[]{ id, number, error } – doklady, u kterých akce neproběhla, s důvodem v češtině
documents[]{ id, number, partner } – doklady, u kterých akce proběhla

Chyby této operace

StavKódKdy
422–Neznámá hodnota operation: „Neznámá hromadná akce – použijte issue, pay, remind, recode nebo delete“
422–recode bez účtu, střediska i zakázky, s účtem mimo rozvrh nebo s delším textem
422–Žádné z ids nepatří dokladu firmy: „Vyberte alespoň jeden doklad“
422–bank_account_id jiné firmy nebo neexistující: „Zvolený účet nebo pokladna ve firmě není – zavřete okno, obnovte stránku a vyberte ho znovu“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
issue: jako issueDocument u každého úspěšného dokladu (číslo, účetní zápisy, document.issued). pay: úhrada s poznámkou „Hromadně označeno jako zaplacené“, v podvojném účetnictví i její účetní zápis (payment.recorded). remind: počítadlo upomínek +1, datum poslední upomínky dnes, document.reminded. delete: smazání konceptu jako deleteDocument (document.deleted). Každý doklad se zpracuje samostatně; akce nad celou dávkou není atomická.
Limity
Použije prvních 300 ID z ids (další se ignorují); doklady zpracuje v pořadí podle data vystavení.
Opakování
Opakovaná akce issue nebo pay vrátí doklady ve failed („Doklad už je vystavený“, „Doklad je už uhrazený“); remind zaznamená při každém volání další upomínku; delete nenajde smazané doklady.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"pay","ids":[129],"paid_on":"2026-09-28","bank_account_id":2}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/bulk

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/bulk', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "operation": "pay",
    "ids": [
      129
    ],
    "paid_on": "2026-09-28",
    "bank_account_id": 2
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "operation": "pay",
  "done": 1,
  "failed": [],
  "documents": [
    {
      "id": 129,
      "number": "FV20260025",
      "partner": "Nordwood Studio s.r.o."
    }
  ]
}

POST Vystavení dokladu

/entities/{entity_id}/documents/{id}/issue

Oprávnění
Vlastník, účetní nebo editor
Pravidlo
Přijatý výdaj (invoice_in, cash_out, credit_in), na který se vztahuje pravidlo schvalování a který není schválený, smí vystavit jen jeho schvalovatel – vystavení se pak zaznamená jako schválení („Schváleno při vystavení“); ostatním vrátí 422.
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY
V příručce
Vydané faktury › Vystavit fakturu; Vydané faktury › Koncept a vystavení; Zálohy, dobropisy a obchodní doklady › Vystavit zálohovou fakturu; Zálohy, dobropisy a obchodní doklady › Daňový doklad k přijaté platbě; Zálohy, dobropisy a obchodní doklady › Vyúčtovat zálohu konečnou fakturou; Zálohy, dobropisy a obchodní doklady › Přijatá zálohová faktura; Zálohy, dobropisy a obchodní doklady › Dobropisy (opravné daňové doklady); Zálohy, dobropisy a obchodní doklady › Vytvořit cenovou nabídku; Zálohy, dobropisy a obchodní doklady › Objednávka u dodavatele; Zálohy, dobropisy a obchodní doklady › Přijatá objednávka od odběratele; Zálohy, dobropisy a obchodní doklady › Dodací list; Zálohy, dobropisy a obchodní doklady › Interní doklad s čísly řádků MD/Dal

Vystaví koncept: ověří, že má aspoň jeden řádek a že faktura, zálohová faktura, dobropis, daňový doklad k záloze a obchodní doklad má kontakt. U prodejních dokladů (kromě převzaté historie) musí mít každý řádek popis, faktura a zálohová faktura kladnou částku (konečná faktura s odečtenou zálohou smí vyjít na nulu i méně) a dobropis nesmí opravit víc, než z faktury zbývá; daňový doklad kromě opravného nesmí nést sazbu DPH, která k jeho DUZP neplatí (15 % a 10 % od roku 2024), a daňový doklad k záloze nejde vystavit v režimu, v němž platba povinnost přiznat daň nezakládá (§ 92a, dodání zboží do EU, vývoz, třístranný obchod, dovoz, mimo DPH). Přidělí číslo z číselné řady dokladu (series_code, jinak hlavní řada druhu) a roku data vystavení (koncept vrácený z vystaveného dokladu si číslo ponechá), u prodeje doplní prázdný variabilní symbol z číslic čísla (má-li je už otevřená faktura, zálohová faktura nebo dobropis, dostane navíc číslici druhu na začátek), u daňových dokladů doplní chybějící DUZP datem vystavení, u faktury a zálohové faktury bez splatnosti doplní výchozí splatnost, uloží snímek kontaktu, přepočítá částky a nastaví stav issued. Konečnou fakturu uhrazené zálohové faktury bez daňových dokladů k platbám uhradí zálohou (jako settleAdvanceOnInvoice). V podvojném účetnictví zaúčtuje předkontaci (prodej MD 311 / D výnosové účty a 343, nákup MD nákladové účty a 343 / D 321, pokladní doklad proti účtu pokladny, daňový doklad k záloze 324/343 nebo 343/314); zálohové faktury, interní a obchodní doklady ani daňová evidence se neúčtují. Pokladní doklad se označí za uhrazený; faktura nebo zálohová faktura vytvořená z nabídky označí nabídku, která ještě nemá výsledek, jako přijatou.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID konceptu Příklad 1540.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
fingerprinttextneOtisk approval.fingerprint z načteného detailu; když se doklad od načtení změnil, vystavení skončí 422 (chrání „Schválit a vystavit“ před schválením jiné verze)

Odpověď

200 application/json Detail vystaveného dokladu jako v getDocument (včetně approval).

Chyby této operace

StavKódKdy
422–fingerprint nesedí: „Doklad se mezitím změnil – obnovte stránku a zkontrolujte ho znovu“
422–Doklad není koncept: „Doklad už je vystavený“, u stornovaného „Stornovaný doklad nejde vystavit – vystavte nový doklad“
422–Doklad nemá řádky: „Doklad nemá žádnou položku“
422–Chybí kontakt: „Doplňte odběratele nebo dodavatele“
422–Datum vystavení nebo DUZP víc než rok po dnešku: „Datum … je víc než rok dopředu – zkontrolujte rok v datu vystavení a DUZP“
422–Řádek odečítá neexistující nebo nevystavený daňový doklad k záloze: „Odečítaná záloha neexistuje“
422–Daňový doklad k záloze už je odečtený jinde: „Daňový doklad … je už odečtený na dokladu …“
422–Odpočet zálohy vyšší než její daňový doklad (po sazbách) nebo v jiné měně: „Odpočet zálohy – daňový doklad … je vyšší než záloha: …“
422–Pokladní doklad bez pokladny v podvojném účetnictví: „Pokladní doklad patří do pokladny – v poli Pokladna vyberte …“
422–Řádek na účtu mimo účtový rozvrh firmy (v podvojném účetnictví; importovaná historie stačí se syntetickým účtem v rozvrhu): „Účet … v účtovém rozvrhu firmy není – …“
422–Řádek prodejního dokladu bez popisu: „Položka č. … nemá popis – doplňte, co dodáváte (§ 29 ZDPH)“
422–Faktura nebo zálohová faktura se zápornou nebo nulovou částkou: „Faktura nesmí mít zápornou částku …“, „Doklad má nulovou částku – doplňte ceny položek“
422–Dobropis převyšuje zbytek faktury: „Dobropis na … převyšuje, co z faktury … ještě zbývá opravit (…)“
422–Sazba neplatná k DUZP: „Sazba DPH 15 % k … neplatí – použijte 21 % nebo 12 % …“
422–Cizí měna s kurzem 1 a kurz ČNB nejde načíst: „Doklad v … má kurz 1 a kurz ČNB ke dni … se nepodařilo načíst – zadejte kurz“
422–Daňový doklad k záloze v režimu bez povinnosti přiznat daň: „Z platby této zálohy se daň nepřiznává – …“
422–Výdaj ve schvalování, volající ho nesmí schválit: „Doklad musí před zaúčtováním schválit … – odešlete ho ke schválení“, „Doklad čeká na schválení – schvaluje …“, „Doklad se po schválení změnil – odešlete ho znovu ke schválení (schvaluje …)“ nebo „Doklad byl vrácen k opravě – upravte ho a odešlete znovu ke schválení“
422–Datum dokladu v uzamčeném období: „Období do … je uzamčeno – doklad nelze měnit“ (tvar { error, errors })

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Přidělí číslo (posune číselnou řadu), uloží stav issued a snímek kontaktu, v podvojném účetnictví vytvoří účetní zápisy, u pokladního dokladu nastaví uhrazenou částku a datum úhrady, u zdrojové nabídky nastaví výsledek accepted, uloží verzi dokladu (u vydaných faktur, dobropisů, zálohových faktur a daňových dokladů k platbě i s ISDOC), zapíše document.issued s details.version (a případně document.approved se záznamem schválení). U přijatého výdaje v cizí měně se při zapnutém schvalování může dotázat kurz ČNB (jen pro posouzení limitu).
Opakování
Druhé volání vrátí 422 „Doklad už je vystavený“.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/132/issue

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/132/issue', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 132,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260027",
  "variable_symbol": "20260027",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "unpaid",
  "days_overdue": 0,
  "description": "Návrh úvodní stránky",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "FB3C0C1B-2381-457D-ACF6-EB573A637208",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 133,
      "position": 0,
      "description": "Návrh úvodní stránky",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 1,
  "attachments_locked": false,
  "issued_version": {
    "number": 1,
    "action": "issued",
    "created_at": "2026-09-28T10:00:00.000Z",
    "digest": "a21c0b98c62b87bf221bf3cb7fcdda3dae3a12a399475ec6dbf1e081a2a89758",
    "supplier": {
      "name": "Ukázková firma s.r.o.",
      "street": "Na Příkopě",
      "house_number": "859",
      "orientation_number": "22",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ",
      "ico": "99999994",
      "dic": "CZ99999994",
      "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
      "email": "demo@example.cz",
      "phone": "+420 777 000 000",
      "web": null,
      "vat_status": "monthly",
      "invoice_footer": null,
      "logo_data": null,
      "accent_color": null,
      "settings": {
        "invoice_style": "plain",
        "invoice_font": "auto",
        "invoice_density": "normal",
        "invoice_table": "auto",
        "invoice_corners": "auto",
        "invoice_logo_size": "m",
        "show_qr": true,
        "invoice_logo_name": false,
        "invoice_row_numbers": false,
        "invoice_paid_stamp": true,
        "invoice_contacts": true,
        "invoice_credit": true
      },
      "vat_payer": true,
      "bank_account": {
        "number": "2900001227",
        "bank_code": "2010",
        "iban": "CZ3820100000002900001227",
        "bic": "FIOBCZPP",
        "currency": "CZK"
      }
    },
    "original": null
  }
}

POST Storno dokladu

/entities/{entity_id}/documents/{id}/cancel

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Stornuje doklad: smaže jeho účetní zápisy a nastaví stav cancelled; číslo zůstává obsazené, takže v řadě nevznikne mezera. Nejde, pokud má doklad s úhradou zaznamenané úhrady, pokud k němu existuje vystavený opravný doklad (nejdřív se stornuje ten) nebo pokud je daňový doklad k záloze odečtený na jiném dokladu. Stornovat lze vystavený doklad a koncept, který už má číslo (vrácený do konceptu); koncept bez čísla se maže a stornovaný doklad už nejde upravit ani vrátit do konceptu. Veřejný odkaz stornovaného dokladu vrací 404.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Detail stornovaného dokladu jako v getDocument.

Chyby této operace

StavKódKdy
422–Doklad je koncept bez čísla nebo už stornovaný: „Stornovat lze jen vystavený doklad – koncept smažte“, „Doklad už je stornovaný“
422–Doklad s úhradou má zaznamenané úhrady: „Nejprve zrušte úhrady dokladu“
422–K dokladu existuje vystavený dobropis: „K dokladu je vystavený opravný doklad … – nejdřív stornujte ten“
422–Daňový doklad k záloze je odečtený na jiném dokladu: „Záloha je odečtená na dokladu … – nejdřív upravte ten“
422–Účetní zápisy v uzamčeném období: „Období do … je uzamčeno – zaúčtování nelze změnit“; nebo datum dokladu v uzamčeném období: „Období do … je uzamčeno – doklad nelze měnit“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Smaže účetní zápisy dokladu, nastaví stav cancelled, uloží verzi dokladu (zrušené zápisy zůstanou v předchozí verzi) a zapíše document.cancelled se změnami.
Opakování
Opakované volání na stornovaný doklad vrátí 422 „Doklad už je stornovaný“.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/cancel

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/cancel', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 129,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "cancelled",
  "number": "FV20260025",
  "variable_symbol": "20260025",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 130,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": {
    "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
    "shared_at": "2026-09-28T10:00:00.000Z",
    "viewed_at": null,
    "views": 0
  },
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 2,
  "attachments_locked": false,
  "issued_version": {
    "number": 1,
    "action": "issued",
    "created_at": "2026-09-28T10:00:00.000Z",
    "digest": "a956a6ec56c1861f94eb51c270eb620bf3c94b457240e4ce5cfbb7fa4af0a15f",
    "supplier": {
      "name": "Ukázková firma s.r.o.",
      "street": "Na Příkopě",
      "house_number": "859",
      "orientation_number": "22",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ",
      "ico": "99999994",
      "dic": "CZ99999994",
      "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
      "email": "demo@example.cz",
      "phone": "+420 777 000 000",
      "web": null,
      "vat_status": "monthly",
      "invoice_footer": null,
      "logo_data": null,
      "accent_color": null,
      "settings": {
        "invoice_style": "plain",
        "invoice_font": "auto",
        "invoice_density": "normal",
        "invoice_table": "auto",
        "invoice_corners": "auto",
        "invoice_logo_size": "m",
        "show_qr": true,
        "invoice_logo_name": false,
        "invoice_row_numbers": false,
        "invoice_paid_stamp": true,
        "invoice_contacts": true,
        "invoice_credit": true
      },
      "vat_payer": true,
      "bank_account": {
        "number": "2900001227",
        "bank_code": "2010",
        "iban": "CZ3820100000002900001227",
        "bic": "FIOBCZPP",
        "currency": "CZK"
      }
    },
    "original": null
  }
}

POST Vrácení dokladu do konceptu

/entities/{entity_id}/documents/{id}/reopen

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Vrátí vystavený doklad do stavu koncept (stornovaný ani koncept ne): smaže jeho účetní zápisy a číslo ponechá. Doklad pak lze upravit a znovu vystavit se stejným číslem; koncept s číslem smazat nelze. Podmínky jsou stejné jako u storna: žádné úhrady, žádný vystavený opravný doklad, daňový doklad k záloze neodečtený jinde a neuzamčené období. S cancel_payments: true nejdřív v téže transakci zruší úhrady jako unpayDocument; nejde-li zrušit všechny, nezmění nic.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
cancel_paymentsano/nenetrue = nejdřív zrušit úhrady dokladu (jako unpayDocument), výchozí false

Odpověď

200 application/json Detail dokladu ve stavu draft jako v getDocument.

Chyby této operace

StavKódKdy
422–Doklad není vystavený: „Do konceptu lze vrátit jen vystavený doklad“
422–Doklad s úhradou má úhrady a chybí cancel_payments: „Doklad s úhradami nelze vrátit do konceptu“
422–S cancel_payments nejdou zrušit všechny úhrady: chyba jako u unpayDocument nebo „Úhrady dokladu Saldo samo nezruší – …“
422–K dokladu existuje vystavený dobropis: „K dokladu je vystavený opravný doklad … – nejdřív stornujte ten“
422–Daňový doklad k záloze je odečtený jinde: „Záloha je odečtená na dokladu … – nejdřív upravte ten“
422–Uzamčené období: „Období do … je uzamčeno – zaúčtování nelze změnit“ nebo „Období do … je uzamčeno – doklad nelze měnit“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Smaže účetní zápisy dokladu, nastaví stav draft, uloží verzi dokladu „Vrácení do konceptu“ a zapíše document.reopened se změnami; s cancel_payments předtím vše jako unpayDocument (payment.deleted, document.unpaid).
Opakování
Opakované volání na koncept vrátí 422.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/reopen

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/reopen', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 129,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "draft",
  "number": "FV20260025",
  "variable_symbol": "20260025",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 130,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": {
    "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
    "shared_at": "2026-09-28T10:00:00.000Z",
    "viewed_at": null,
    "views": 0
  },
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 2,
  "attachments_locked": false,
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ]
}

GET Verze dokladu s původním obsahem a změnami

/entities/{entity_id}/documents/{id}/versions

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí všechny uložené verze účetního dokladu od nejstarší. Verzi uloží každé vystavení, oprava vystaveného dokladu (jen když se obsah změnil), storno a vrácení do konceptu; doklad vystavený před zavedením verzí dostane při první opravě verzi original se stavem před ní. Každá verze nese úplný snímek (záhlaví, kontakt, položky, účetní zápisy), změny proti předchozí verzi a otisk SHA-256 navázaný na otisk předchozí verze; intact říká, zda řetězec sedí. Verze nejde změnit ani smazat (§ 35 zákona o účetnictví).

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID firmy. Příklad 1.
idcestacelé čísloanoID dokladu. Příklad 431.

Odpověď

200 application/json Objekt s polem versions a příznakem intact.

PoleVýznam
intacttrue, když každý otisk odpovídá svému snímku a otisku předchozí verze
versions[].numberPořadí verze od 1
versions[].actionoriginal, issued, updated, cancelled nebo reopened; action_label je český název
versions[].userKdo verzi uložil; api_key { name, hint }, když přes API klíč
versions[].created_atČas uložení
versions[].digestSHA-256 z otisku předchozí verze a snímku (previous_digest)
versions[].has_isdocK verzi je uložený ISDOC (vydané doklady při vystavení a opravě)
versions[].has_supplierVerze nese údaje dodavatele z doby vystavení (vydané faktury, zálohové faktury, dobropisy a daňové doklady k záloze); jsou součástí otisku digest
versions[].pdf_sha256SHA-256 uloženého originálu PDF, nebo null (GET …/versions/{number}/pdf)
versions[].snapshot{ document: údaje záhlaví a součty, partner, lines[], entries[] { date, debit, credit, amount, text } }; částky jako řetězce
versions[].changesZměny proti předchozí verzi { field, label, from, to }; field entries má ve from zrušené a v to nové zápisy, lines.N položky

Chování

Co změní
Nic nezapisuje.

Příklad

Ukázka nejdřív posune splatnost vystavené faktury, takže vrátí dvě verze.

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "versions": [
    {
      "number": 1,
      "action": "issued",
      "action_label": "Vystavení",
      "user": "ukazka",
      "api_key": null,
      "created_at": "2026-09-28T10:00:00.000Z",
      "digest": "a956a6ec56c1861f94eb51c270eb620bf3c94b457240e4ce5cfbb7fa4af0a15f",
      "previous_digest": null,
      "has_isdoc": true,
      "has_supplier": true,
      "pdf_sha256": null,
      "snapshot": {
        "document": {
          "kind": "invoice_out",
          "number": "FV20260025",
          "series_code": null,
          "status": "issued",
          "issue_date": "2026-09-28",
          "taxable_date": "2026-09-28",
          "accounting_date": "2026-09-28",
          "vat_date": "2026-09-28",
          "due_date": "2026-10-12",
          "received_date": null,
          "original_number": null,
          "variable_symbol": "20260025",
          "constant_symbol": null,
          "specific_symbol": null,
          "currency": "CZK",
          "exchange_rate": "1.0",
          "rate_date": null,
          "vat_mode": "domestic",
          "rc_code": null,
          "kh_section": null,
          "simplified": false,
          "regime_44": false,
          "prices_include_vat": false,
          "payment_method": "bank",
          "bank_account_id": 2,
          "payee_account": null,
          "payee_iban": null,
          "related_document_id": null,
          "description": "Správa webu – září",
          "note": null,
          "cost_center": null,
          "project": null,
          "round_whole": null,
          "total_net": "19800.0",
          "total_vat": "4158.0",
          "total_gross": "23958.0",
          "rounding": "0.0",
          "total_payable": "23958.0",
          "total_net_czk": "19800.0",
          "total_vat_czk": "4158.0",
          "total_gross_czk": "23958.0"
        },
        "partner": {
          "name": "Nordwood Studio s.r.o.",
          "ico": "90000013",
          "dic": "CZ90000013",
          "street": "Korunní 1208/74",
          "city": "Praha 10",
          "zip": "10100",
          "country": "CZ"
        },
        "lines": [
          {
            "description": "Správa webu – září",
            "quantity": "12.0",
            "unit": "hod",
            "unit_price": "1650.0",
            "discount_percent": "0.0",
            "vat_rate": "21.0",
            "vat_kind": "standard",
            "stated_vat": null,
            "account_code": "602",
            "credit_account": null,
            "deduction": "full",
            "asset": false,
            "net": "19800.0",
            "vat": "4158.0",
            "gross": "23958.0",
            "net_czk": "19800.0",
            "vat_czk": "4158.0"
          }
        ],
        "entries": [
          {
            "date": "2026-09-28",
            "debit": "311",
            "credit": "602",
            "amount": "19800.0",
            "text": "Faktura · FV20260025 · Nordwood Studio s.r.o."
          },
          {
            "date": "2026-09-28",
            "debit": "311",
            "credit": "343",
            "amount": "4158.0",
            "text": "Faktura · FV20260025 · Nordwood Studio s.r.o."
          }
        ]
      },
      "changes": []
    },
    {
      "number": 2,
      "action": "updated",
      "action_label": "Oprava",
      "user": "ukazka",
      "api_key": {
        "name": "Dokumentace API",
        "hint": "…2Udf"
      },
      "created_at": "2026-09-28T10:00:00.000Z",
      "digest": "257082d36a92c4ff5dd97123c08d61e3ffeddbfbfa6bf61c270e59c0d0f54e78",
      "previous_digest": "a956a6ec56c1861f94eb51c270eb620bf3c94b457240e4ce5cfbb7fa4af0a15f",
      "has_isdoc": true,
      "has_supplier": true,
      "pdf_sha256": null,
      "snapshot": {
        "document": {
          "kind": "invoice_out",
          "number": "FV20260025",
          "series_code": null,
          "status": "issued",
          "issue_date": "2026-09-28",
          "taxable_date": "2026-09-28",
          "accounting_date": "2026-09-28",
          "vat_date": "2026-09-28",
          "due_date": "2026-10-19",
          "received_date": null,
          "original_number": null,
          "variable_symbol": "20260025",
          "constant_symbol": null,
          "specific_symbol": null,
          "currency": "CZK",
          "exchange_rate": "1.0",
          "rate_date": null,
          "vat_mode": "domestic",
          "rc_code": null,
          "kh_section": null,
          "simplified": false,
          "regime_44": false,
          "prices_include_vat": false,
          "payment_method": "bank",
          "bank_account_id": 2,
          "payee_account": null,
          "payee_iban": null,
          "related_document_id": null,
          "description": "Správa webu – září",
          "note": null,
          "cost_center": null,
          "project": null,
          "round_whole": null,
          "total_net": "19800.0",
          "total_vat": "4158.0",
          "total_gross": "23958.0",
          "rounding": "0.0",
          "total_payable": "23958.0",
          "total_net_czk": "19800.0",
          "total_vat_czk": "4158.0",
          "total_gross_czk": "23958.0"
        },
        "partner": {
          "name": "Nordwood Studio s.r.o.",
          "ico": "90000013",
          "dic": "CZ90000013",
          "street": "Korunní 1208/74",
          "city": "Praha 10",
          "zip": "10100",
          "country": "CZ"
        },
        "lines": [
          {
            "description": "Správa webu – září",
            "quantity": "12.0",
            "unit": "hod",
            "unit_price": "1650.0",
            "discount_percent": "0.0",
            "vat_rate": "21.0",
            "vat_kind": "standard",
            "stated_vat": null,
            "account_code": "602",
            "credit_account": null,
            "deduction": "full",
            "asset": false,
            "net": "19800.0",
            "vat": "4158.0",
            "gross": "23958.0",
            "net_czk": "19800.0"
…

GET ISDOC uložené verze vydaného dokladu

/entities/{entity_id}/documents/{id}/versions/{number}/isdoc

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí ISDOC (XML) vydané faktury, dobropisu, zálohové faktury nebo daňového dokladu k platbě přesně v podobě uložené při vystavení nebo opravě dané verze.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID firmy. Příklad 1.
idcestacelé čísloanoID dokladu. Příklad 431.
numbercestacelé čísloanoČíslo verze z GET …/versions. Příklad 1.

Odpověď

200 application/xml Soubor ISDOC ke stažení (číslo-dokladu-verze-N.isdoc).

Chyby této operace

StavKódKdy
404–Verze neexistuje, nebo k ní ISDOC uložený není („K této verzi se ISDOC neukládal“)

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions/1/isdoc

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions/1/isdoc', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="http://isdoc.cz/namespace/2013" version="6.0.2">
  <DocumentType>1</DocumentType>
  <ID>FV20260025</ID>
  <UUID>5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422</UUID>
  <IssuingSystem>Saldo – TechTools.cz</IssuingSystem>
  <IssueDate>2026-09-28</IssueDate>
  <TaxPointDate>2026-09-28</TaxPointDate>
  <VATApplicable>true</VATApplicable>
  <ElectronicPossibilityAgreementReference/>
  <LocalCurrencyCode>CZK</LocalCurrencyCode>
  <CurrRate>1</CurrRate>
  <RefCurrRate>1</RefCurrRate>
  <AccountingSupplierParty>
    <Party>
      <PartyIdentification>
        <ID>99999994</ID>
      </PartyIdentification>
      <PartyName>
        <Name>Ukázková firma s.r.o.</Name>
      </PartyName>
      <PostalAddress>
        <StreetName>Na Příkopě</StreetName>
        <BuildingNumber>859/22</BuildingNumber>
        <CityName>Praha</CityName>
        <PostalZone>11000</PostalZone>
        <Country>
          <IdentificationCode>CZ</IdentificationCode>
          <Name>Česká republika</Name>
        </Country>
      </PostalAddress>
      <PartyTaxScheme>
        <CompanyID>CZ99999994</CompanyID>
        <TaxScheme>VAT</TaxScheme>
      </PartyTaxScheme>
      <RegisterIdentification>
        <Preformatted>Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).</Preformatted>
      </RegisterIdentification>
      <Contact>
        <Telephone>+420 777 000 000</Telephone>
        <ElectronicMail>demo@example.cz</ElectronicMail>
      </Contact>
    </Party>
  </AccountingSupplierParty>
  <AccountingCustomerParty>
    <Party>
      <PartyIdentification>
        <ID>90000013</ID>
      </PartyIdentification>
      <PartyName>
        <Name>Nordwood Studio s.r.o.</Name>
      </PartyName>
      <PostalAddress>
        <StreetName>Korunní</StreetName>
        <BuildingNumber>1208/74</BuildingNumber>
        <CityName>Praha 10</CityName>
        <PostalZone>10100</PostalZone>
        <Country>
          <IdentificationCode>CZ</IdentificationCode>
          <Name>Česká republika</Name>
        </Country>
      </PostalAddress>
      <PartyTaxScheme>
        <CompanyID>CZ90000013</CompanyID>
        <TaxScheme>VAT</TaxScheme>
      </PartyTaxScheme>
      <Contact>
        <ElectronicMail>fakturace@example.cz</ElectronicMail>
      </Contact>
    </Party>
  </AccountingCustomerParty>
  <InvoiceLines>
    <InvoiceLine>
      <ID>1</ID>
      <InvoicedQuantity unitCode="hod">12</InvoicedQuantity>
      <LineExtensionAmount>19800.00</LineExtensionAmount>
      <LineExtensionAmountTaxInclusive>23958.00</LineExtensionAmountTaxInclusive>
      <LineExtensionTaxAmount>4158.00</LineExtensionTaxAmount>
      <UnitPrice>1650</UnitPrice>
      <UnitPriceTaxInclusive>1996.5</UnitPriceTaxInclusive>
      <ClassifiedTaxCategory>
        <Percent>21</Percent>
        <VATCalculationMethod>0</VATCalculationMethod>
        <VATApplicable>true</VATApplicable>
      </ClassifiedTaxCategory>
      <Item>
  
…

POST Uložení originálu PDF vydané faktury

/entities/{entity_id}/documents/{id}/original

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Uloží PDF, které dostal odběratel, k poslední vystavené verzi faktury, zálohové faktury, dobropisu nebo daňového dokladu k záloze (verze nese údaje dodavatele z doby vystavení). Saldo PDF vytváří v prohlížeči, proto ho aplikace pošle sama při prvním stažení PDF, odeslání nebo vytvoření sdíleného odkazu. Uloží se jen první soubor: další volání vrátí už uložený originál a nic nemění, takže opakování nevytvoří duplicitu. Originál nejde změnit ani smazat; zmizí jen se smazáním celé firmy a je v archivu firmy. Oprava vydaného dokladu vytvoří novou verzi, ke které se uloží nový originál, a starý zůstane u své verze.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID firmy. Příklad 1.
idcestacelé čísloanoID dokladu. Příklad 431.

Tělo požadavku

Formát multipart/form-data.

PoleTypPovinnéPopis
filesouboranoPDF dokladu (se strukturou PDF), nejvýše 15 MB.

Odpověď

201 application/json { original: { version, sha256, byte_size, created_at }, created }; 200 s created: false, když už originál uložený byl.

Chyby této operace

StavKódKdy
400–Chybí pole file („Vyberte soubor PDF“)
413–Soubor je větší než 15 MB
422NO_ISSUED_VERSIONDoklad není vystavená faktura, zálohová faktura, dobropis ani daňový doklad k záloze, je koncept, nebo byl vystaven dřív, než Saldo vystavené verze ukládalo
422–Soubor nemá strukturu PDF („Soubor nemá základní strukturu PDF“)
403SUBMITTER_ONLYRole Nahrává doklady

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Uloží soubor do úložiště, zapíše jeho SHA-256 k verzi a událost document.original_archived (verze, sha256). Nic nezaúčtuje.
Opakování
Další volání vrátí uložený originál (200, created false) a nic nezapíše.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -F "file=@faktura.pdf" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/original

JavaScript

const form = new FormData();
form.append('file', fileInput.files[0], 'faktura.pdf');
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/original', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST',
  body: form
});
const data = await response.json();
Odpověď 201 Created
{
  "original": {
    "version": 1,
    "sha256": "90cb36527e84479c6eed80dc9d4d4edbd0100fcd7ebb090ce96c91bc1462baa5",
    "byte_size": 152,
    "created_at": "2026-09-28T10:00:00.000Z"
  },
  "created": true
}

GET Originál PDF verze vydaného dokladu

/entities/{entity_id}/documents/{id}/versions/{number}/pdf

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí originál PDF uložený k verzi vydaného dokladu (POST …/original) beze změny. Před odesláním ověří jeho SHA-256; hlavička X-Saldo-SHA256 nese otisk.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID firmy. Příklad 1.
idcestacelé čísloanoID dokladu. Příklad 431.
numbercestacelé čísloanoČíslo verze z GET …/versions (pdf_sha256 není null). Příklad 1.

Odpověď

200 application/pdf Soubor PDF ke stažení (číslo-dokladu-verze-N.pdf).

Chyby této operace

StavKódKdy
404–Verze neexistuje, nebo k ní originál uložený není („K této verzi se originál PDF neuložil“)
409ORIGINAL_CHANGEDUložený soubor nesouhlasí se svým otiskem SHA-256
403SUBMITTER_ONLYRole Nahrává doklady

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

Ukázka nejdřív uloží originál PDF vydané faktury.

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions/1/pdf

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/versions/1/pdf', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
application/pdf, 152 bajtů (soubor FV20260025-verze-1.pdf)

POST Zaznamenání odeslané upomínky

/entities/{entity_id}/documents/{id}/remind

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Zvýší počítadlo upomínek dokladu o 1 a nastaví datum poslední upomínky na dnešek. Upomínku nikam neposílá – jen zaznamená, že ji firma odeslala (podklady vrací getDocumentReminder). Stejně jako hromadná akce remind jen u vystavené faktury nebo zálohové faktury po splatnosti.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Detail dokladu jako v getDocument, ale bez approval.

Chyby této operace

StavKódKdy
422–Doklad není faktura ani zálohová faktura po splatnosti (dobropis, koncept, zaplacený): „Upomínku lze zaznamenat jen u vystavené faktury nebo zálohové faktury po splatnosti“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Zvýší reminders_sent, nastaví last_reminder_on a zapíše document.reminded.
Opakování
Každé volání zaznamená další upomínku.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/130/remind

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/130/remind', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 130,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260026",
  "variable_symbol": "20260026",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-08-31",
  "taxable_date": "2026-08-31",
  "due_date": "2026-09-14",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 0.0,
  "remaining": 23958.0,
  "payment_state": "overdue",
  "days_overdue": 14,
  "description": "Konzultace – srpen",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 1,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "73627D73-9935-4F92-8928-F62DE05B6E66",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-08-31",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-08-31",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 131,
      "position": 0,
      "description": "Konzultace – srpen",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": []
}

POST Zúčtování uhrazené zálohy úhradou faktury

/entities/{entity_id}/documents/{id}/settle

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Uhradí fakturu z uhrazené zálohové faktury, ke které není vystavený daňový doklad k záloze (typicky u neplátce DPH): k faktuře zaznamená úhradu způsobem „Uhrazeno zálohou“ ve výši menší z uhrazené zálohy a zbývající částky faktury, s datem vystavení faktury a kurzem, za který byla záloha přijata. Existuje-li daňový doklad k záloze, záloha se místo toho odečte řádkem na konečné faktuře (prepareFinalInvoice). Zálohová faktura musí mít stejný směr (proforma_out k invoice_out, proforma_in k invoice_in), kontakt a měnu jako faktura a započte se jen ta část zálohy, kterou ještě nezapočetly jiné faktury.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID vystavené faktury (dokladu s úhradou) Příklad 1532.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
proforma_idcelé čísloanoID zálohové faktury firmy (proforma_out nebo proforma_in); jiný druh vrátí 404

Odpověď

200 application/json Detail faktury s novou úhradou jako v getDocument, ale bez approval.

Chyby této operace

StavKódKdy
422–Zálohová faktura nemá úhradu: „Zálohová faktura zatím není uhrazená“
422–Jiný směr, kontakt nebo měna: „Zálohu lze započíst jen na fakturu stejného směru, odběratele či dodavatele a měny“
422–Tato záloha už je na faktuře zúčtovaná: „Záloha už byla vyúčtována“
422–Celou zálohu už započetly jiné faktury: „Záloha je už celá započtená na jiných fakturách“
422–K záloze existuje vystavený daňový doklad: „K záloze je vystavený daňový doklad – odečtěte ji na konečné faktuře“
422–Faktura už odečítá zálohu řádkem: „Záloha je už odečtená v položkách faktury“
422–Na faktuře nic nezbývá: „Faktura už je uhrazená“
422–Faktura není vystavená nebo nemá úhrady: „Doklad není vystavený“, „K tomuto dokladu se úhrady neevidují“
422–Datum vystavení faktury v uzamčeném období: „Období do … je uzamčeno – úhradu z … nelze měnit“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Vytvoří úhradu faktury (payment_method advance, poznámka = číslo zálohové faktury), v podvojném účetnictví zaúčtuje MD 324 / D 311 (u přijaté faktury MD 321 / D 314) a případný kurzový rozdíl, přepočte uhrazenou částku faktury a zapíše payment.recorded.
Opakování
Druhé volání se stejnou fakturou a zálohou vrátí 422 „Záloha už byla vyúčtována“.

Příklad

Ukázková zálohová faktura je uhrazená a nemá vystavený daňový doklad k záloze, takže se faktura uhradí zálohou (úhrada advance s číslem zálohové faktury v poznámce).

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"proforma_id":134}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/settle

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/settle', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "proforma_id": 134
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 129,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260025",
  "variable_symbol": "20260025",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 23958.0,
  "remaining": 0.0,
  "payment_state": "paid",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": "2026-09-28",
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 130,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": {
    "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
    "shared_at": "2026-09-28T10:00:00.000Z",
    "viewed_at": null,
    "views": 0
  },
  "payments": [
    {
      "id": 111,
      "document_id": 129,
      "bank_transaction_id": null,
      "bank_account_id": null,
      "paid_on": "2026-09-28",
      "amount": 23958.0,
      "amount_czk": 23958.0,
      "exchange_rate": 1.0,
      "payment_method": "advance",
      "note": "ZV20260002",
      "counter_document_id": null,
      "settlement_key": null,
      "account_code": null,
      "counter_number": null
    }
  ],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": []
}

GET Kopie dokladu jako nový koncept

/entities/{entity_id}/documents/{id}/duplicate

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí neuložený koncept stejného druhu: kontakt, měna a kurz (u cizí měny kurz ČNB k DUZP kopie, rate_date; když ČNB neodpoví, kurz zdroje a věta v notices; dobropis vždy kurz původního dokladu), režim DPH, kód PDP, ceny s DPH, způsob úhrady, bankovní účet, popis, poznámka, jazyk, středisko, projekt, konstantní symbol a řádky; řádky odečtu zálohy (Odpočet zálohy – daňový doklad č. …) se nekopírují. Datum vystavení a u daňových dokladů DUZP je dnešní, splatnost dnes + splatnost kontaktu (jinak firmy). Částky nejsou přepočítané (součty 0) – dopočítají se při uložení přes createDocument. Připojí number_preview. Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID kopírovaného dokladu Příklad 1532.

Odpověď

200 application/json Koncept ve tvaru getDocument (id null, bez approval) a navíc number_preview.

PoleVýznam
number_previewNáhled čísla z řady druhu k dnešku

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/duplicate

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/duplicate', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "FV20260027",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ],
  "notices": []
}

GET Dobropis k faktuře jako nový koncept

/entities/{entity_id}/documents/{id}/credit_note

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

K faktuře vydané (invoice_out) vrátí koncept opravného daňového dokladu vydaného (credit_out), k faktuře přijaté (invoice_in) koncept přijatého (credit_in): kopii faktury jako v prepareDocumentCopy se zápornými množstvími, vazbou related_document na fakturu a poznámkou „Opravný daňový doklad k dokladu č. … ze dne …“. Stav faktury se nekontroluje. Částky nejsou přepočítané. Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID faktury Příklad 1532.

Odpověď

200 application/json Koncept dobropisu ve tvaru getDocument (id null, bez approval) a navíc number_preview.

Chyby této operace

StavKódKdy
422–Doklad není invoice_out ani invoice_in: „Dobropis lze vystavit jen k faktuře“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/credit_note

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/credit_note', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "credit_out",
  "kind_label": "Opravný daňový doklad vydaný",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": 129,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": "Opravný daňový doklad k dokladu č. FV20260025 ze dne 28. 9. 2026.",
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": -12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": {
    "id": 129,
    "number": "FV20260025",
    "kind": "invoice_out",
    "currency": "CZK",
    "remaining": 23958.0
  },
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "OV20260002",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "OV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ],
  "notices": []
}

GET Konečná faktura k zálohové faktuře jako koncept

/entities/{entity_id}/documents/{id}/final_invoice

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

K zálohové faktuře vrátí koncept konečné faktury (proforma_out → invoice_out, proforma_in → invoice_in): kopii zálohové faktury s vazbou na ni, poznámkou zálohové faktury doplněnou o větu „Vyúčtování zálohové faktury č. …“ a řádkem odpočtu (množství −1, cena s DPH nebo bez podle prices_include_vat) za každý řádek každého vystaveného daňového dokladu k záloze, který ještě není odečtený na nestornovaném dokladu (ani na konceptu). Odpočet jde v podvojném účetnictví na účet 324 (přijaté zálohy) nebo 314 (poskytnuté zálohy), v daňové evidenci do kategorie hlavního řádku zálohové faktury. Částky nejsou přepočítané. Řádek odpočtu smí odečíst nejvýš to, co daňový doklad zdanil (po sazbách, ve stejné měně), jinak vystavení odpoví 422; v cizí měně se odpočet přepočte Kč z daňového dokladu a kurzem konečné faktury (ČNB k jejímu DUZP) jen zbytek. Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID zálohové faktury Příklad 1490.

Odpověď

200 application/json Koncept konečné faktury ve tvaru getDocument (id null, bez approval) a navíc number_preview.

Chyby této operace

StavKódKdy
422–Doklad není zálohová faktura: „Vyúčtovat lze jen zálohovou fakturu“
422–Existuje vystavená konečná faktura a není co dalšího odečíst: „Záloha už je vyúčtovaná dokladem …“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

Ukázková zálohová faktura je uhrazená, ale nemá vystavený daňový doklad k záloze ani konečnou fakturu, takže koncept neobsahuje řádek odpočtu.

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/134/final_invoice

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/134/final_invoice', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Záloha na e-shop",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": 134,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": "Vyúčtování zálohové faktury č. ZV20260002.",
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "Záloha na e-shop (50 %)",
      "quantity": 1.0,
      "unit": "ks",
      "unit_price": 40000.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": {
    "id": 134,
    "number": "ZV20260002",
    "kind": "proforma_out",
    "currency": "CZK",
    "remaining": 0.0
  },
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "FV20260027",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "FV",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ],
  "notices": []
}

GET Daňový doklad k přijaté platbě zálohy jako koncept

/entities/{entity_id}/documents/{id}/advance_document

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

K uhrazené zálohové faktuře vrátí koncept daňového dokladu k platbě (advance_out u vydané, advance_in u přijaté) pro nejstarší den platby, kterou dosud nepokrývají vystavené daňové doklady k této záloze: každý den platby má vlastní doklad (§ 21 odst. 1 ZDPH). DUZP je den platby, datum vystavení u vydané zálohy dnešek (ne zpětně), u přijaté den platby. Režim DPH a kód § 92a se převezmou ze zálohové faktury; v cizí měně se použije kurz ČNB ke dni platby (rate_date). Ceny jsou včetně DPH a částka se rozdělí do sazeb DPH v poměru řádků zálohové faktury (účet 324, resp. 314). notices vysvětlí zbývající platby, kurz a pozdní vystavení. Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID zálohové faktury Příklad 1490.

Odpověď

200 application/json Koncept daňového dokladu k záloze ve tvaru getDocument (id null, bez approval) a navíc number_preview, series a notices.

PoleVýznam
noticesUpozornění k návrhu: další platby bez daňového dokladu, použitý kurz ČNB, uplynulá lhůta 15 dnů

Chyby této operace

StavKódKdy
422–Doklad není zálohová faktura nebo nemá úhradu: „Daňový doklad lze vystavit jen k uhrazené zálohové faktuře“
422–Záloha v režimu § 92a, dodání zboží do EU, vývozu, třístranného obchodu, dovozu nebo mimo DPH: „Z platby této zálohy se daň nepřiznává – …“
422–Všechny platby už mají daňový doklad: „Ke všem přijatým platbám zálohy už daňový doklad existuje“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

Vyžaduje uhrazenou zálohovou fakturu, jejíž platby ještě nemají daňový doklad.

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/134/advance_document

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/134/advance_document', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "advance_out",
  "kind_label": "Daňový doklad k přijaté platbě",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-15",
  "due_date": null,
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": null,
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": 134,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": true,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": null,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": "Daňový doklad k přijaté platbě ze dne 15. 9. 2026 k zálohové faktuře č. ZV20260002.",
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-15",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "Záloha dle zálohové faktury č. ZV20260002",
      "quantity": 1.0,
      "unit": null,
      "unit_price": 48400.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "324",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": null,
  "related_document": {
    "id": 134,
    "number": "ZV20260002",
    "kind": "proforma_out",
    "currency": "CZK",
    "remaining": 0.0
  },
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "DZ20260002",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "DZ",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ],
  "notices": []
}

GET Penalizační faktura z úroku z prodlení jako koncept

/entities/{entity_id}/documents/{id}/penalty_invoice

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

K vystavené vydané faktuře, která je po splatnosti nebo byla zaplacena po splatnosti, vrátí koncept faktury v Kč s položkou úroku z prodlení podle NV č. 351/2013 Sb. (ze zbývající částky do dneška, u zaplacené faktury z celé částky do dne úhrady; cizí měna kurzem ČNB k dnešku) a u odběratele s IČO s náklady spojenými s uplatněním pohledávky 1 200 Kč. Položky nejsou předmětem DPH (vat_kind not_subject), účty 644 a 648 (v daňové evidenci P03); related_document je původní faktura. Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID vydané faktury Příklad 1532.

Odpověď

200 application/json Koncept faktury ve tvaru getDocument (id null, bez approval) a navíc number_preview a series.

Chyby této operace

StavKódKdy
422–Doklad není vystavená vydaná faktura: „Penalizační fakturu lze vystavit jen k vystavené vydané faktuře“
422–Faktura nebyla po splatnosti: „Faktura nebyla po splatnosti – úrok z prodlení ani náklady na uplatnění pohledávky nevznikly“
422–Prodlení před rokem 2014 nebo mimo data repo sazeb (hláška výpočtu úroku)

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje. U faktury v cizí měně se dotáže na kurz ČNB.

Příklad

Ukázková faktura :invoice_out je zaplacená včas, takže úrok nevzniká; postup ukazuje příručka v kapitole Vydané faktury → Upomínka a úrok z prodlení.

GET Podklady pro upomínku dokladu

/entities/{entity_id}/documents/{id}/reminder

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí doklad, údaje firmy, pořadí příští upomínky a výpočet úroku z prodlení k dnešku ze zbývající částky podle NV č. 351/2013 Sb.: repo sazba ČNB platná první den pololetí, v němž prodlení začalo, + 8 p. b., za dny od dne po splatnosti do dneška; náklady spojené s uplatněním pohledávky 1 200 Kč jen u kontaktu s IČO, a to až po splatnosti. interest je null, když doklad nemá splatnost, nic nezbývá uhradit nebo výpočet nejde (např. splatnost před rokem 2014). Nic nezaznamenává.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Podklady pro upomínku.

PoleVýznam
documentDetail dokladu (bez approval)
entityÚdaje firmy
next_levelPořadí příští upomínky (zaznamenané upomínky + 1)
interest.principalJistina = zbývající částka dokladu
interest.currencyMěna jistiny a úroku = měna dokladu
interest.delay_fromPrvní den prodlení, nebo null, když prodlení ještě nenastalo
interest.daysPočet dní prodlení
interest.reference_datePrvní den pololetí, podle kterého se bere repo sazba
interest.repo_rateRepo sazba ČNB v %
interest.rateRoční sazba úroku v % (repo + 8)
interest.periods[]{ from, to, days, rate, interest } po kalendářních pololetích
interest.interestÚrok celkem (2 desetinná místa)
interest.recovery_costNáklady uplatnění pohledávky v Kč (i u dokladu v cizí měně): 1200 u kontaktu s IČO, když prodlení už nastalo, jinak 0
interest.basis[]Právní podklady výpočtu (texty)

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/reminder

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/reminder', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "document": {
    "id": 129,
    "kind": "invoice_out",
    "kind_label": "Faktura vydaná",
    "status": "issued",
    "number": "FV20260025",
    "variable_symbol": "20260025",
    "original_number": null,
    "partner_id": 1,
    "partner_name": "Nordwood Studio s.r.o.",
    "partner_ico": "90000013",
    "issue_date": "2026-09-28",
    "taxable_date": "2026-09-28",
    "due_date": "2026-10-12",
    "currency": "CZK",
    "total_net": 19800.0,
    "total_vat": 4158.0,
    "total_payable": 23958.0,
    "total_gross_czk": 23958.0,
    "paid_amount": 0.0,
    "remaining": 23958.0,
    "payment_state": "unpaid",
    "days_overdue": 0,
    "description": "Správa webu – září",
    "vat_mode": "domestic",
    "source": "manual",
    "tags": null,
    "related_document_id": null,
    "reminders_sent": 0,
    "outcome": null,
    "attachments_count": 0,
    "approval_state": null,
    "created_by_id": 1,
    "created_by_name": "ukazka",
    "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
    "constant_symbol": null,
    "specific_symbol": null,
    "received_date": null,
    "vat_date": "2026-09-28",
    "exchange_rate": 1.0,
    "rate_date": null,
    "rc_code": null,
    "prices_include_vat": false,
    "simplified": false,
    "regime_44": false,
    "payment_method": "bank",
    "bank_account_id": 2,
    "rounding": 0.0,
    "total_gross": 23958.0,
    "total_net_czk": 19800.0,
    "total_vat_czk": 4158.0,
    "note": null,
    "internal_note": null,
    "language": "cs",
    "kh_section": null,
    "cost_center": null,
    "project": null,
    "paid_on": null,
    "round_whole": null,
    "payee_account": null,
    "payee_iban": null,
    "payee_bic": null,
    "series_code": null,
    "created_at": "2026-09-28T10:00:00.000Z",
    "updated_at": "2026-09-28T10:00:00.000Z",
    "accounting_date": "2026-09-28",
    "payee_mismatch": null,
    "partner": {
      "name": "Nordwood Studio s.r.o.",
      "ico": "90000013",
      "dic": "CZ90000013",
      "street": "Korunní 1208/74",
      "city": "Praha 10",
      "zip": "10100",
      "country": "CZ",
      "email": "fakturace@example.cz",
      "phone": null
    },
    "lines": [
      {
        "id": 130,
        "position": 0,
        "description": "Správa webu – září",
        "quantity": 12.0,
        "unit": "hod",
        "unit_price": 1650.0,
        "discount_percent": 0.0,
        "vat_rate": 21.0,
        "vat_kind": "standard",
        "account_code": "602",
        "credit_account": null,
        "asset": false,
        "deduction": "full",
        "vat_share": 100.0,
        "advance_document_id": null,
        "stated_vat": null,
        "net": 19800.0,
        "vat": 4158.0,
        "gross": 23958.0,
        "net_czk": 19800.0,
        "vat_czk": 4158.0
      }
    ],
    "attachments": [],
    "share": {
      "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
      "shared_at": "2026-09-28T10:00:00.000Z",
      "viewed_at": null,
      "views": 0
    },
    "payments": [],
    "vat_recap": [
      {
        "rate": 21.0,
        "net": 19800.0,
        "vat": 4158.0,
        "gross": 23958.0,
        "net_czk": 19800.0,
        "vat_czk": 4158.0
      }
    ],
    "bank_account": {
      "id": 2,
      "account_code": "221001",
      "archived": false,
      "bank_code": "2010",
      "bank_connection_id": null,
      "bic": "FIOBCZPP",
      "created_at": "2026-09-28T10:00:00.000Z",
      "currency": "CZK",
      "iban": "CZ3820100000002900001227",
      "is_default": true,
      "kind": "bank",
      "name": "Provozní účet",
      "number": "2900001227",
      "opening_balance": 420000.0,
      "opening_date": "2026-01-01",
      "provider_account_ref": null,
      "sync_error": null,
      "synced_at": null,
      "updated_at": "2026-09-28T10:00:00.000Z",
      "display_number": "2900001227/2010",
      "balance": null,
      "api_connected": false
    },
    "related_document": null,
    "open_credits": [],
    "recurrence": null,
    "vat_filed": null,
    "vat_corrections": []
  },
  "interest": {
    "principal": 23958.0,
    "currency": "CZK",
    "delay_from": null,
    "days": 0,
    "reference_date": "2026-07-01",
    "repo_rate": 3.75,
    "rate": 11.75,
    "periods": [],
    "interest": 0.0,
    "recovery_cost": 0.0,
    "basis": [
      "§ 2 odst. 1 nařízení vlády č. 351/2013 Sb. (repo sazba ČNB platná první den kalendářního pololetí, v němž došlo k prodlení, + 8 p. b., po celou dobu prodlení)",
      "§ 3 nařízení vlády č. 351/2013 Sb. (vzájemný závazek podnikatelů nebo podnikatele a veřejného zadavatele)"
    ]
  },
  "entity": {
    "id": 1,
    "accent_color": null,
    "archived": false,
    "bookkeeping": "double_entry",
    "city": "Praha",
    "company_id": null,
    "country": "CZ",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "databox": null,
    "default_due_days": 14,
    "dic": "CZ99999994",
    "email": "demo@example.cz",
    "first_name": null,
    "fiscal_year_start": 1,
    "flat_expense_rate": null,
    "house_number": "859",
    "ico": "99999994",
    "invoice_footer": null,
    "last_name": null,
    "legal_form": "sro",
    "locked_until": null,
    "nace": "621000",
    "name": "Ukázková firma s.r.o.",
    "orientation_number": "22",
    "owner_id": 1,
    "phone": "+420 777 000 000",
    "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
    "responsible_id": null,
    "street": "Na Příkopě",
    "tax_office_code": "451",
    "tax_office_workplace": "2001",
    "title": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "vat_registered_on": "2023-01-01",
    "vat_status": "monthly",
    "web": null,
    "zip": "11000",
    "settings": {
      "round_total": "always",
      "invoice_language": "cs",
      "number_format": "{prefix}{yyyy}{nnnn}",
      "reminder_days": [
        3,
        14
      ],
      "show_qr": true,
      "invoice_style": "plain",
      "invoice_font": "auto",
   
…

Dlouhé seznamy jsou v ukázce zkrácené na první položky.

GET Řetězec QR Platby k dokladu

/entities/{entity_id}/documents/{id}/qr

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí řetězec QR Platby (SPAYD 1.0) k zaplacení zbytku vystavené faktury nebo zálohové faktury (invoice_out, proforma_out): účet (IBAN a BIC) bankovního účtu dokladu, není-li v měně dokladu aktivní účet v této měně, u pokladny nebo bez účtu výchozí nebo první aktivní bankovní účet firmy; částka = zbývající částka; dále měna, splatnost, variabilní, konstantní a specifický symbol, jméno firmy a zpráva „druh a číslo dokladu“. Vrátí spayd null s vysvětlením v reason u konceptu, přijatého dokladu, dobropisu, zaplaceného dokladu (zbytek není kladný), měny jiné než CZK a EUR a když takto vybraný účet nemá IBAN ani číslo účtu s kódem banky (nebo firma aktivní bankovní účet nemá). Obrázek QR kódu API nevytváří.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Objekt s řetězcem QR Platby.

PoleVýznam
spaydNapř. SPD*1.0*ACC:CZ…*AM:15972.00*CC:CZK*…, nebo null
reasonProč QR Platba není (jen když spayd je null)

Chyby této operace

StavKódKdy
422–Neplatný účet firmy: „Neplatný IBAN: …“ nebo „Neplatný BIC: …“
422–Částka nad limit QR Platby: „Částka pro QR Platbu smí být nejvýše 9 999 999,99“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/qr

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/qr', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "spayd": "SPD*1.0*ACC:CZ3820100000002900001227+FIOBCZPP*AM:23958.00*CC:CZK*RN:Uk%C3%A1zkov%C3%A1 firma s.r.o.*DT:20261012*MSG:Faktura FV20260025*X-VS:20260025",
  "reason": null
}

GET Stažení dokladu ve formátu ISDOC

/entities/{entity_id}/documents/{id}/isdoc

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí vydaný doklad (invoice_out, credit_out, proforma_out, advance_out) jako soubor ISDOC (XML) ke stažení s názvem „číslo.isdoc“. Dodavatel je firma, odběratel kontakt dokladu, platební údaje jsou z bankovního účtu dokladu, a není-li v měně dokladu, z aktivního účtu v této měně (jinak výchozího účtu firmy). U vydaného dokladu vystaveného v Saldu vrátí ISDOC uložený s jeho poslední vystavenou verzí (dodavatel a účet z doby vystavení, stejné UUID); sestavuje ho znovu jen u dokladů vystavených dřív, než Saldo verze ukládalo. Režim § 92a nese LocalReverseCharge s kódem a LocalReverseChargeFlag, osvobozená plnění a plnění bez české daně mají sazbu 0 % s důvodem ve VATNote, konečná faktura uvádí odečtené daňové doklady k zálohám jako TaxedDeposits a zálohy uhrazené bez daňového dokladu jako NonTaxedDeposits. Doklad musí mít číslo (tedy být někdy vystaven) a řádky; dobropis musí odkazovat na původní doklad. Vydaná faktura, zálohová faktura, dobropis a daňový doklad k záloze dostanou UUID při vystavení; starší doklad bez uloženého UUID dostane při každém stažení nové náhodné UUID.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/xml Soubor ISDOC (Content-Disposition attachment).

Chyby této operace

StavKódKdy
422–Jiný druh než vydaná faktura, zálohová faktura, dobropis nebo daňový doklad k záloze: „ISDOC lze vytvořit jen pro vydané doklady“
422–Koncept bez čísla: „Doklad nemá číslo“
422–„Doklad nemá žádné položky“, „Dodavatel nemá název“, „Opravný doklad musí odkazovat na původní doklad“, „Doklad v cizí měně musí mít kladný kurz“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/isdoc

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/isdoc', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="http://isdoc.cz/namespace/2013" version="6.0.2">
  <DocumentType>1</DocumentType>
  <ID>FV20260025</ID>
  <UUID>5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422</UUID>
  <IssuingSystem>Saldo – TechTools.cz</IssuingSystem>
  <IssueDate>2026-09-28</IssueDate>
  <TaxPointDate>2026-09-28</TaxPointDate>
  <VATApplicable>true</VATApplicable>
  <ElectronicPossibilityAgreementReference/>
  <LocalCurrencyCode>CZK</LocalCurrencyCode>
  <CurrRate>1</CurrRate>
  <RefCurrRate>1</RefCurrRate>
  <AccountingSupplierParty>
    <Party>
      <PartyIdentification>
        <ID>99999994</ID>
      </PartyIdentification>
      <PartyName>
        <Name>Ukázková firma s.r.o.</Name>
      </PartyName>
      <PostalAddress>
        <StreetName>Na Příkopě</StreetName>
        <BuildingNumber>859/22</BuildingNumber>
        <CityName>Praha</CityName>
        <PostalZone>11000</PostalZone>
        <Country>
          <IdentificationCode>CZ</IdentificationCode>
          <Name>Česká republika</Name>
        </Country>
      </PostalAddress>
      <PartyTaxScheme>
        <CompanyID>CZ99999994</CompanyID>
        <TaxScheme>VAT</TaxScheme>
      </PartyTaxScheme>
      <RegisterIdentification>
        <Preformatted>Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).</Preformatted>
      </RegisterIdentification>
      <Contact>
        <Telephone>+420 777 000 000</Telephone>
        <ElectronicMail>demo@example.cz</ElectronicMail>
      </Contact>
    </Party>
  </AccountingSupplierParty>
  <AccountingCustomerParty>
    <Party>
      <PartyIdentification>
        <ID>90000013</ID>
      </PartyIdentification>
      <PartyName>
        <Name>Nordwood Studio s.r.o.</Name>
      </PartyName>
      <PostalAddress>
        <StreetName>Korunní</StreetName>
        <BuildingNumber>1208/74</BuildingNumber>
        <CityName>Praha 10</CityName>
        <PostalZone>10100</PostalZone>
        <Country>
          <IdentificationCode>CZ</IdentificationCode>
          <Name>Česká republika</Name>
        </Country>
      </PostalAddress>
      <PartyTaxScheme>
        <CompanyID>CZ90000013</CompanyID>
        <TaxScheme>VAT</TaxScheme>
      </PartyTaxScheme>
      <Contact>
        <ElectronicMail>fakturace@example.cz</ElectronicMail>
      </Contact>
    </Party>
  </AccountingCustomerParty>
  <InvoiceLines>
    <InvoiceLine>
      <ID>1</ID>
      <InvoicedQuantity unitCode="hod">12</InvoicedQuantity>
      <LineExtensionAmount>19800.00</LineExtensionAmount>
      <LineExtensionAmountTaxInclusive>23958.00</LineExtensionAmountTaxInclusive>
      <LineExtensionTaxAmount>4158.00</LineExtensionTaxAmount>
      <UnitPrice>1650</UnitPrice>
      <UnitPriceTaxInclusive>1996.5</UnitPriceTaxInclusive>
      <ClassifiedTaxCategory>
        <Percent>21</Percent>
        <VATCalculationMethod>0</VATCalculationMethod>
        <VATApplicable>true</VATApplicable>
      </ClassifiedTaxCategory>
      <Item>
  
…

POST Zaznamenání úhrady dokladu

/entities/{entity_id}/documents/{id}/payments

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

K vystavenému dokladu s úhradou (faktura, zálohová faktura, dobropis – vydané i přijaté) zaznamená úhradu v měně dokladu: záporná částka je vratka, nulová se odmítne, přeplatek se nekontroluje. V podvojném účetnictví musí peněžní úhrada (bank, cash, card, cod, other) mít bank_account_id – úhrada bez účtu se odmítne, aby nevznikl zůstatek syntetického účtu 221 bez banky. U dokladu v cizí měně lze v amount_czk zadat skutečně připsanou nebo odepsanou částku v Kč, jinak se ocení kurzem ČNB ke dni úhrady; rozdíl proti kurzu dokladu se v podvojném účetnictví zaúčtuje jako kurzový zisk (663) nebo ztráta (563); u zálohové faktury se celá částka v Kč zaúčtuje proti 324/314 bez kurzového rozdílu. Vratka se zaúčtuje kladnou částkou na opačné strany. payment_method offset zapíše zápočet s dokladem counter_document_id (stejný kontakt nebo IČO, stejná měna, zbytek opačným směrem; částka výchozí menší ze zbytků): úhradu u obou dokladů se stejným settlement_key, zaúčtovanou přes 395 (MD 395 / D 311, MD 321 / D 395), u cizí měny kurzem ČNB ke dni zápočtu. payment_method write_off odepíše zbytek (výchozí celý) do 100 Kč na 548 (vám chybí) nebo 648 (ve váš prospěch), s fee bankovní poplatek do 1 000 Kč na 568. Úhrada není spárovaná s bankovním pohybem. Vrátí celý doklad s přepočtenou uhrazenou částkou.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
amountčísloneČástka v měně dokladu (2 desetinná místa; nečíselná hodnota se bere jako 0); povinná kromě offset a write_off, kde výchozí je celá možná částka
paid_ondatumneDatum úhrady (výchozí dnes)
payment_methodtextneZpůsob úhrady; výchozí cash, je-li bank_account_id pokladna, jinak bank. Vnitřní způsoby (úhrada zálohou, počáteční stav) vznikají jen vyúčtováním zálohy a převodem počátečních stavů, API je odmítne Hodnoty: bank, cash, card, cod, offset, write_off, other.
bank_account_idcelé čísloneBankovní účet nebo pokladna firmy; určuje peněžní účet zápisu. V podvojném účetnictví povinný u bank, cash, card, cod a other
counter_document_idcelé čísloneJen offset – doklad, se kterým se započítává (kandidáty vrací listDocumentOffsets)
feeano/neneJen write_off – rozdíl je bankovní poplatek (568, do 1 000 Kč)
amount_czkčísloneSkutečná částka v Kč, jen pro doklad v cizí měně; bez ní se přepočte kurzem ČNB dne úhrady. U dokladu v Kč se nepoužije – částka v Kč je vždy amount.
notetextnePoznámka k úhradě

Odpověď

201 application/json Detail dokladu jako v getDocument, ale bez approval (úhrada je v payments[]).

Chyby této operace

StavKódKdy
422–Doklad není vystavený: „Doklad není vystavený“
422–Jiný způsob úhrady než výše: „Způsob úhrady … nejde zapsat – použijte bank, cash, card, cod, other, offset nebo write_off“
422–Druh bez úhrad (pokladní, interní, obchodní doklad, daňový doklad k záloze): „K tomuto dokladu se úhrady neevidují“
422–Částka je 0 nebo nečíselná: „Částka úhrady nesmí být nulová“
422–Datum úhrady v uzamčeném období: „Období do … je uzamčeno – úhradu z … nelze měnit“
422–Peněžní úhrada bez účtu v podvojném účetnictví: „Vyberte bankovní účet nebo pokladnu, kam peníze přišly nebo odkud odešly…“
422–Kurz ČNB chybí u cizí měny bez amount_czk: „Kurz ČNB pro … ke dni … se nepodařilo načíst – zadejte částku v Kč“
422–Zápočet nejde: „Započíst lze jen pohledávku proti závazku …“, „… téhož partnera“, „… ve stejné měně“, „Započíst lze nejvýše …“
422–Odpis nejde: „Odepsat lze jen drobný rozdíl do 100,00 Kč …“, „Bankovní poplatek lze odepsat jen tam, kde vám peníze chybí“
404–counter_document_id nebo bank_account_id nepatří firmě

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Vytvoří úhradu (u zápočtu dvě), v podvojném účetnictví její účetní zápis (např. MD 221 / D 311, u vydané zálohové faktury D 324, u přijaté faktury MD 321 / D 221) a případný kurzový rozdíl, přepočte uhrazenou částku a datum úhrady dokladu a zapíše payment.recorded.
Opakování
Každé volání zaznamená další úhradu.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":1000,"paid_on":"2026-09-28","bank_account_id":2,"note":"Částečná úhrada"}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/payments

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/payments', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "amount": 1000,
    "paid_on": "2026-09-28",
    "bank_account_id": 2,
    "note": "Částečná úhrada"
  })
});
const data = await response.json();
Odpověď 201 Created
{
  "id": 129,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260025",
  "variable_symbol": "20260025",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": "2026-09-28",
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 19800.0,
  "total_vat": 4158.0,
  "total_payable": 23958.0,
  "total_gross_czk": 23958.0,
  "paid_amount": 1000.0,
  "remaining": 22958.0,
  "payment_state": "partial",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "5BBA9B65-AA9C-4A77-A0A6-BFFB7E519422",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-28",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 23958.0,
  "total_net_czk": 19800.0,
  "total_vat_czk": 4158.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 130,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "attachments": [],
  "share": {
    "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
    "shared_at": "2026-09-28T10:00:00.000Z",
    "viewed_at": null,
    "views": 0
  },
  "payments": [
    {
      "id": 111,
      "document_id": 129,
      "bank_transaction_id": null,
      "bank_account_id": 2,
      "paid_on": "2026-09-28",
      "amount": 1000.0,
      "amount_czk": 1000.0,
      "exchange_rate": 1.0,
      "payment_method": "bank",
      "note": "Částečná úhrada",
      "counter_document_id": null,
      "settlement_key": null,
      "account_code": null,
      "counter_number": null
    }
  ],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 19800.0,
      "vat": 4158.0,
      "gross": 23958.0,
      "net_czk": 19800.0,
      "vat_czk": 4158.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": []
}

GET Doklady k zápočtu

/entities/{entity_id}/documents/{id}/offsets

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí otevřené vystavené faktury a dobropisy téhož kontaktu (nebo kontaktu se stejným IČO) ve stejné měně, jejichž zbytek běží opačným směrem než u tohoto dokladu (pohledávka proti závazku), takže je lze započíst. Dobropis k tomuto dokladu (nebo doklad, ke kterému je tento dobropis) je první, ostatní podle splatnosti. Zálohové faktury se nezapočítávají. Doklad bez kontaktu nebo bez zbytku vrátí prázdné rows.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Kandidáti a limity odpisu.

PoleVýznam
rows[]Doklady { id, number, kind, kind_label, original_number, variable_symbol, partner_name, due_date, currency, remaining, payment_state, days_overdue, scheme, account, problem }
write_off_limitNejvyšší odpis haléřového rozdílu v Kč (100)
fee_limitNejvyšší odpis bankovního poplatku v Kč (1 000)

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/offsets

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/offsets', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "rows": [],
  "write_off_limit": 100.0,
  "fee_limit": 1000.0
}

DELETE Zrušení úhrady dokladu

/entities/{entity_id}/documents/{id}/payments/{payment_id}

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Smaže úhradu dokladu s jejími účetními zápisy a přepočte uhrazenou částku. Vznikla-li úhrada spárováním s bankovním pohybem, pohyb se vrátí mezi nespárované, pokud ho jiné úhrady nepokrývají. Úhradu s datem v uzamčeném období zrušit nelze. Vrátí celý doklad.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.
payment_idcestacelé čísloanoID úhrady tohoto dokladu (jiná vrátí 404) Příklad 884.

Odpověď

200 application/json Detail dokladu jako v getDocument, ale bez approval.

Chyby této operace

StavKódKdy
422–Úhrada v uzamčeném období: „Období do … je uzamčeno – úhradu z … nelze měnit“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Smaže úhradu a její účetní zápisy, u spárovaného bankovního pohybu přepočte jeho stav (matched / unmatched), přepočte uhrazenou částku dokladu a zapíše payment.deleted. Úhrada zápočtem se smaže i s druhou polovinou na druhém dokladu (stejný settlement_key).
Opakování
Druhé volání vrátí 404.

Příklad

cURL

curl \
  -X DELETE \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/1/payments/1

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/1/payments/1', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'DELETE'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 1,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260001",
  "variable_symbol": "20260001",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-01-04",
  "taxable_date": "2026-01-04",
  "due_date": "2026-01-18",
  "currency": "CZK",
  "total_net": 75900.0,
  "total_vat": 15939.0,
  "total_payable": 91839.0,
  "total_gross_czk": 91839.0,
  "paid_amount": 0.0,
  "remaining": 91839.0,
  "payment_state": "overdue",
  "days_overdue": 253,
  "description": "Návrh a vývoj webové aplikace",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "B76C23AC-C138-4976-A149-13EF22111560",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-01-04",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 91839.0,
  "total_net_czk": 75900.0,
  "total_vat_czk": 15939.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": "Praha",
  "project": "Web a e-shop Nordwood",
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-01-04",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 1,
      "position": 0,
      "description": "Návrh a vývoj webové aplikace",
      "quantity": 46.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 75900.0,
      "vat": 15939.0,
      "gross": 91839.0,
      "net_czk": 75900.0,
      "vat_czk": 15939.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 75900.0,
      "vat": 15939.0,
      "gross": 91839.0,
      "net_czk": 75900.0,
      "vat_czk": 15939.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": []
}

GET Náhled zrušení úhrad dokladu

/entities/{entity_id}/documents/{id}/unpay

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Řekne, co udělá unpayDocument: kolik úhrad a jakou částku zruší, kolik z nich vzniklo spárováním s bankou (pohyby se vrátí mezi nespárované), u kterých dokladů se zruší i druhá polovina zápočtu a které úhrady Saldo nechá s důvodem (úhrada počátečního stavu, platba z banky zčásti zaúčtovaná jinam). blocker je důvod, proč zrušení nejde vůbec (doklad bez úhrad, uzamčené období, záloha už započtená na konečné faktuře nebo s daňovým dokladem k platbě). Zápočet zálohy na konečné faktuře (payment_method advance) není platba: zůstane a je v advances; jen s reopen=true (náhled pro reopenDocument s cancel_payments) patří mezi rušené úhrady.

Parametry

NázevKdeTypPovinnýPopis
reopendotazano/nenetrue = náhled pro vrácení do konceptu, zruší i zápočet zálohy (po novém vystavení se započte znovu)
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Plán zrušení úhrad.

PoleVýznam
document_idID dokladu
numberČíslo dokladu
currencyMěna dokladu a částek
double_entrytrue = podvojné účetnictví (úhrady se odúčtují), false = daňová evidence
countPočet úhrad, které se zruší
amountJejich součet v měně dokladu
payments[]Rušené úhrady { id, paid_on, amount, payment_method, bank, counter_number }
kept[]Úhrady, které Saldo nechá, se stejnými poli a reason (důvod česky)
advances[]Zápočty zálohy, které zůstanou, se stejnými poli a proforma (číslo zálohové faktury)
counter_documents[]Čísla dokladů, u kterých se zruší druhá polovina zápočtu
bankPočet rušených úhrad spárovaných s bankovním pohybem
blockerDůvod, proč zrušení nejde, nebo null

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/1/unpay

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/1/unpay', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "document_id": 1,
  "number": "FV20260001",
  "currency": "CZK",
  "double_entry": true,
  "count": 1,
  "amount": 91839.0,
  "payments": [
    {
      "id": 1,
      "paid_on": "2026-01-18",
      "amount": 91839.0,
      "payment_method": "bank",
      "bank": true,
      "counter_number": null
    }
  ],
  "kept": [],
  "advances": [],
  "counter_documents": [],
  "bank": 1,
  "blocker": null
}

POST Označení dokladu jako nezaplaceného

/entities/{entity_id}/documents/{id}/unpay

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Zruší úhrady dokladu podle previewDocumentUnpay, každou stejně jako deleteDocumentPayment: smaže ji s účetními zápisy, bankovní pohyb vrátí mezi nespárované a zápočet zruší na obou dokladech. Úhrady z kept nechá. Buď se zruší všechny úhrady z plánu, nebo žádná. Pro omylem zaznamenanou úhradu; skutečnou platbu pak zapište znovu.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Detail dokladu jako v getDocument a unpaid s plánem, který se provedl (bez blocker).

Chyby této operace

StavKódKdy
422–Doklad bez úhrad: „Doklad nemá žádné úhrady“; koncept nebo stornovaný doklad: „Úhrady lze zrušit jen u vystaveného dokladu“
422–Úhrada (i druhá polovina zápočtu) v uzamčeném období: „Období do … je uzamčeno – úhradu z … nelze zrušit“
422–Zálohová faktura započtená na konečné faktuře nebo s daňovým dokladem k platbě
422–Všechny úhrady jsou v kept: „Úhrady dokladu Saldo samo nezruší – …“
422–Doklad má jen zápočet zálohy: „Doklad je uhrazený jen zálohou … – zápočet zálohy není platba a zůstane“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Pro každou úhradu payment.deleted, smazané zápisy úhrady, přepočtený stav bankovního pohybu a uhrazená částka dokladu; nakonec document.unpaid s počtem a částkou.
Opakování
Druhé volání vrátí 422 „Doklad nemá žádné úhrady“.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/1/unpay

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/1/unpay', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 1,
  "kind": "invoice_out",
  "kind_label": "Faktura vydaná",
  "status": "issued",
  "number": "FV20260001",
  "variable_symbol": "20260001",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-01-04",
  "taxable_date": "2026-01-04",
  "due_date": "2026-01-18",
  "currency": "CZK",
  "total_net": 75900.0,
  "total_vat": 15939.0,
  "total_payable": 91839.0,
  "total_gross_czk": 91839.0,
  "paid_amount": 0.0,
  "remaining": 91839.0,
  "payment_state": "overdue",
  "days_overdue": 253,
  "description": "Návrh a vývoj webové aplikace",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": "B76C23AC-C138-4976-A149-13EF22111560",
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-01-04",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 91839.0,
  "total_net_czk": 75900.0,
  "total_vat_czk": 15939.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": "Praha",
  "project": "Web a e-shop Nordwood",
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-01-04",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 1,
      "position": 0,
      "description": "Návrh a vývoj webové aplikace",
      "quantity": 46.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 75900.0,
      "vat": 15939.0,
      "gross": 91839.0,
      "net_czk": 75900.0,
      "vat_czk": 15939.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 75900.0,
      "vat": 15939.0,
      "gross": 91839.0,
      "net_czk": 75900.0,
      "vat_czk": 15939.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "uploaded_by": null,
  "approval": null,
  "versions_count": 1,
  "attachments_locked": false,
  "issued_version": {
    "number": 1,
    "action": "issued",
    "created_at": "2026-09-28T10:00:00.000Z",
    "digest": "498992fee1696f21043cd2f5be4cff700fb8e73fbf49f15090ca3925be4d695e",
    "supplier": {
      "name": "Ukázková firma s.r.o.",
      "street": "Na Příkopě",
      "house_number": "859",
      "orientation_number": "22",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ",
      "ico": "99999994",
      "dic": "CZ99999994",
      "register_note": "Zapsáno v obchodním rejstříku vedeném Městským soudem v Praze, oddíl C, vložka 999999 (ukázková data).",
      "email": "demo@example.cz",
      "phone": "+420 777 000 000",
      "web": null,
      "vat_status": "monthly",
      "invoice_footer": null,
      "logo_data": null,
      "accent_color": null,
      "settings": {
        "invoice_style": "plain",
        "invoice_font": "auto",
        "invoice_density": "normal",
        "invoice_table": "auto",
        "invoice_corners": "auto",
        "invoice_logo_size": "m",
        "show_qr": true,
        "invoice_logo_name": false,
        "invoice_row_numbers": false,
        "invoice_paid_stamp": true,
        "invoice_contacts": true,
        "invoice_credit": true
      },
      "vat_payer": true,
      "bank_account": {
        "number": "2900001227",
        "bank_code": "2010",
        "iban": "CZ3820100000002900001227",
        "bic": "FIOBCZPP",
        "currency": "CZK"
      }
    },
    "original": null
  },
  "unpaid": {
    "document_id": 1,
    "number": "FV20260001",
    "currency": "CZK",
    "double_entry": true,
    "count": 1,
    "amount": 91839.0,
    "payments": [
      {
        "id": 1,
        "paid_on": "2026-01-18",
        "amount": 91839.0,
        "payment_method": "bank",
        "bank": true,
        "counter_number": null
      }
    ],
    "kept": [],
    "advances": [],
    "counter_documents": [],
    "bank": 1
  }
}

GET Převod dokladu na jiný druh jako koncept

/entities/{entity_id}/documents/{id}/convert

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Z vystaveného dokladu vrátí koncept jiného druhu jako kopii (viz prepareDocumentCopy) s vazbou na zdroj a poznámkou jen „Dle dokladu … č. …“ (text zdroje, např. platnost nabídky, se nepřenáší). Povolené převody: cenová nabídka (quote_out) → faktura vydaná, zálohová faktura vydaná, dodací list nebo přijatá objednávka (order_in); přijatá objednávka → faktura vydaná, zálohová faktura vydaná nebo dodací list; objednávka (order_out) → faktura přijatá; faktura vydaná → dodací list; dodací list → faktura vydaná. Když se faktura, zálohová faktura nebo přijatá objednávka vytvořená z nabídky vystaví, nabídka se označí jako přijatá; faktura, zálohová faktura nebo dodací list z přijaté objednávky ji označí jako vyřízenou (nemá-li zdroj ještě výsledek). Nic neukládá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID zdrojového dokladu Příklad 1601.
kinddotaztextanoDruh nového dokladu Hodnoty: invoice_out, proforma_out, delivery_out, order_in, invoice_in. Příklad invoice_out.

Odpověď

200 application/json Koncept ve tvaru getDocument (id null, bez approval) a navíc number_preview.

Chyby této operace

StavKódKdy
422–Převod mezi druhy není povolen: „Z tohoto dokladu nelze vytvořit zvolený doklad“
422–Zdroj není vystavený: „Vytvořit doklad lze jen z vystaveného dokladu“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  "https://techtools.cz/ucetnictvi-api/entities/1/documents/129/convert?kind=delivery_out"

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/convert?kind=delivery_out', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
{
  "id": null,
  "kind": "delivery_out",
  "kind_label": "Dodací list",
  "status": "draft",
  "number": null,
  "variable_symbol": null,
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-28",
  "taxable_date": null,
  "due_date": "2026-10-12",
  "currency": "CZK",
  "total_net": 0.0,
  "total_vat": 0.0,
  "total_payable": 0.0,
  "total_gross_czk": 0.0,
  "paid_amount": 0.0,
  "remaining": 0.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Správa webu – září",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": 129,
  "reminders_sent": 0,
  "outcome": null,
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": null,
  "created_by_name": null,
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": null,
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": 2,
  "rounding": 0.0,
  "total_gross": 0.0,
  "total_net_czk": 0.0,
  "total_vat_czk": 0.0,
  "note": "Dle dokladu faktura vydaná č. FV20260025.",
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": null,
  "updated_at": null,
  "accounting_date": "2026-09-28",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": null,
      "position": 0,
      "description": "Správa webu – září",
      "quantity": 12.0,
      "unit": "hod",
      "unit_price": 1650.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 0.0,
      "vat": 0.0,
      "gross": 0.0,
      "net_czk": 0.0,
      "vat_czk": 0.0
    }
  ],
  "bank_account": {
    "id": 2,
    "account_code": "221001",
    "archived": false,
    "bank_code": "2010",
    "bank_connection_id": null,
    "bic": "FIOBCZPP",
    "created_at": "2026-09-28T10:00:00.000Z",
    "currency": "CZK",
    "iban": "CZ3820100000002900001227",
    "is_default": true,
    "kind": "bank",
    "name": "Provozní účet",
    "number": "2900001227",
    "opening_balance": 420000.0,
    "opening_date": "2026-01-01",
    "provider_account_ref": null,
    "sync_error": null,
    "synced_at": null,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "display_number": "2900001227/2010",
    "balance": null,
    "api_connected": false
  },
  "related_document": {
    "id": 129,
    "number": "FV20260025",
    "kind": "invoice_out",
    "currency": "CZK",
    "remaining": 23958.0
  },
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": [],
  "number_preview": "DL20260001",
  "series": [
    {
      "code": "",
      "label": "Hlavní řada",
      "prefix": "DL",
      "format": "{prefix}{yyyy}{nnnn}"
    }
  ],
  "notices": []
}

POST Výsledek cenové nabídky nebo přijaté objednávky

/entities/{entity_id}/documents/{id}/outcome

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

U cenové nabídky (quote_out) zaznamená, zda ji zákazník přijal (accepted) nebo odmítl (rejected), u přijaté objednávky (order_in), zda je vyřízená (fulfilled) nebo zrušená (rejected); prázdná nebo chybějící hodnota výsledek smaže. Stav dokladu se nekontroluje. Vystavení faktury, zálohové faktury nebo dodacího listu z přijaté objednávky ji označí jako vyřízenou samo.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID nabídky Příklad 1601.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
outcometextneaccepted = přijato (nabídka), fulfilled = vyřízeno (objednávka), rejected = odmítnuto / zrušeno, prázdné = bez výsledku Hodnoty: accepted, rejected, fulfilled, "".

Odpověď

200 application/json Detail nabídky jako v getDocument, ale bez approval.

Chyby této operace

StavKódKdy
422–Doklad není nabídka ani přijatá objednávka: „Výsledek se eviduje jen u nabídek a přijatých objednávek“
422–Hodnota, která k druhu dokladu nepatří: „Neznámý výsledek dokladu“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Změní výsledek nabídky a zapíše document.outcome.
Opakování
Opakování se stejnou hodnotou nic nezmění, jen zapíše další událost.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"outcome":"accepted"}' \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/135/outcome

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/135/outcome', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "outcome": "accepted"
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "id": 135,
  "kind": "quote_out",
  "kind_label": "Cenová nabídka",
  "status": "issued",
  "number": "NA20260001",
  "variable_symbol": "20260001",
  "original_number": null,
  "partner_id": 1,
  "partner_name": "Nordwood Studio s.r.o.",
  "partner_ico": "90000013",
  "issue_date": "2026-09-20",
  "taxable_date": null,
  "due_date": null,
  "currency": "CZK",
  "total_net": 456000.0,
  "total_vat": 95760.0,
  "total_payable": 551760.0,
  "total_gross_czk": 551760.0,
  "paid_amount": 0.0,
  "remaining": 551760.0,
  "payment_state": "na",
  "days_overdue": 0,
  "description": "Nabídka – správa webu na rok 2027",
  "vat_mode": "domestic",
  "source": "manual",
  "tags": null,
  "related_document_id": null,
  "reminders_sent": 0,
  "outcome": "accepted",
  "attachments_count": 0,
  "approval_state": null,
  "created_by_id": 1,
  "created_by_name": "ukazka",
  "uuid": null,
  "constant_symbol": null,
  "specific_symbol": null,
  "received_date": null,
  "vat_date": "2026-09-20",
  "exchange_rate": 1.0,
  "rate_date": null,
  "rc_code": null,
  "prices_include_vat": false,
  "simplified": false,
  "regime_44": false,
  "payment_method": "bank",
  "bank_account_id": null,
  "rounding": 0.0,
  "total_gross": 551760.0,
  "total_net_czk": 456000.0,
  "total_vat_czk": 95760.0,
  "note": null,
  "internal_note": null,
  "language": "cs",
  "kh_section": null,
  "cost_center": null,
  "project": null,
  "paid_on": null,
  "round_whole": null,
  "payee_account": null,
  "payee_iban": null,
  "payee_bic": null,
  "series_code": null,
  "created_at": "2026-09-28T10:00:00.000Z",
  "updated_at": "2026-09-28T10:00:00.000Z",
  "accounting_date": "2026-09-20",
  "payee_mismatch": null,
  "partner": {
    "name": "Nordwood Studio s.r.o.",
    "ico": "90000013",
    "dic": "CZ90000013",
    "street": "Korunní 1208/74",
    "city": "Praha 10",
    "zip": "10100",
    "country": "CZ",
    "email": "fakturace@example.cz",
    "phone": null
  },
  "lines": [
    {
      "id": 136,
      "position": 0,
      "description": "Správa a údržba webu – měsíční paušál",
      "quantity": 12.0,
      "unit": "měs",
      "unit_price": 38000.0,
      "discount_percent": 0.0,
      "vat_rate": 21.0,
      "vat_kind": "standard",
      "account_code": "602",
      "credit_account": null,
      "asset": false,
      "deduction": "full",
      "vat_share": 100.0,
      "advance_document_id": null,
      "stated_vat": null,
      "net": 456000.0,
      "vat": 95760.0,
      "gross": 551760.0,
      "net_czk": 456000.0,
      "vat_czk": 95760.0
    }
  ],
  "attachments": [],
  "share": null,
  "payments": [],
  "vat_recap": [
    {
      "rate": 21.0,
      "net": 456000.0,
      "vat": 95760.0,
      "gross": 551760.0,
      "net_czk": 456000.0,
      "vat_czk": 95760.0
    }
  ],
  "bank_account": null,
  "related_document": null,
  "open_credits": [],
  "recurrence": null,
  "vat_filed": null,
  "vat_corrections": []
}

POST Zapnutí veřejného odkazu na doklad

/entities/{entity_id}/documents/{id}/share

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Vytvoří neuhádnutelný token (32 znaků) pro veřejný odkaz na doklad, který lze otevřít bez účtu: zákazník ho vidí na stránce saldo.techtools.cz/faktura/#<token>, data vrací getSharedDocument (/share/{token}; doklad bez interních údajů, firma, bankovní účet a QR Platba) a ISDOC getSharedDocumentIsdoc (/share/{token}/isdoc). Jen u vystaveného dokladu druhu invoice_out, proforma_out, credit_out nebo advance_out. Token nemá omezenou platnost: platí, dokud se odkaz nezruší; dokud doklad není vystavený (storno, vrácení do konceptu), odkaz vrací 404 a po novém vystavení funguje znovu. Změna odběratele (partner_id) token zruší a zapíše document.unshared, takže původní příjemce neuvidí doklad jiného odběratele. Už sdílený doklad si token ponechá.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Stav sdílení.

PoleVýznam
tokenToken veřejného odkazu (32 znaků A–Z, a–z, 0–9, _ a -)
shared_atKdy bylo sdílení zapnuto
viewed_atPrvní zobrazení někým, kdo není členem firmy, nebo null
viewsPočet takových zobrazení

Chyby této operace

StavKódKdy
422–Doklad není vystavený nebo je jiného druhu: „Odkaz lze sdílet jen u vystavené faktury, zálohové faktury, dobropisu nebo daňového dokladu k přijaté záloze“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Při prvním sdílení uloží token a čas; při každém volání zapíše document.shared.
Opakování
Opakované volání vrátí stejný token a zapíše další událost.

Příklad

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/share

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/share', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'POST'
});
const data = await response.json();
Odpověď 200 OK
{
  "token": "TQhjQpbN1MrEuV0Fs49OGYBjZuJNjmYe",
  "shared_at": "2026-09-28T10:00:00.000Z",
  "viewed_at": null,
  "views": 0
}

DELETE Zrušení veřejného odkazu na doklad

/entities/{entity_id}/documents/{id}/share

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Smaže token – veřejná stránka pak vrací 404 – a vynuluje čas sdílení, první zobrazení a počet zobrazení. Funguje u jakéhokoli dokladu firmy, i nesdíleného. Nové sdílení vytvoří jiný token.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID dokladu Příklad 1532.

Odpověď

200 application/json Stav sdílení po zrušení – token, shared_at a viewed_at null, views 0.

PoleVýznam
tokennull
views0

Chování

Co změní
Smaže token a statistiky zobrazení a zapíše document.unshared.
Opakování
Opakované volání vrátí stejnou odpověď a zapíše další událost.

Příklad

cURL

curl \
  -X DELETE \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/documents/129/share

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/share', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'DELETE'
});
const data = await response.json();
Odpověď 200 OK
{
  "token": null,
  "shared_at": null,
  "viewed_at": null,
  "views": 0
}

GET Seznam opakovaných faktur

/entities/{entity_id}/recurrences

Oprávnění
Každý člen firmy včetně role Jen čtení
Klíč jen pro čtení
Stačí

Vrátí všechna pravidla opakování firmy (aktivní i ukončená) seřazená podle data příštího vytvoření. Každé pravidlo nese souhrn vzorového dokladu (template, null, pokud vzor už neexistuje). Odpověď je pole.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.

Odpověď

200 application/json Pole pravidel opakování.

PoleVýznam
[].idID pravidla
[].template_document_idID vzorového dokladu
[].frequencymonthly, quarterly, half_yearly, yearly
[].next_onDatum příštího vytvoření
[].ends_onPoslední možné datum vytvoření, nebo null
[].auto_issueVytvořený doklad rovnou vystavit
[].activePravidlo je aktivní
[].last_generated_onPlánované datum posledního vytvořeného dokladu
[].created_atZaloženo
[].updated_atZměněno
[].templateSouhrn vzorového dokladu jako řádek listDocuments, nebo null

Chování

Co změní
Nic nezapisuje.

Příklad

cURL

curl \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/recurrences

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/recurrences', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();
Odpověď 200 OK
[
  {
    "id": 1,
    "active": true,
    "auto_issue": false,
    "created_at": "2026-09-28T10:00:00.000Z",
    "ends_on": null,
    "frequency": "monthly",
    "last_generated_on": null,
    "next_on": "2026-10-03",
    "template_document_id": 22,
    "updated_at": "2026-09-28T10:00:00.000Z",
    "template": {
      "id": 22,
      "kind": "invoice_out",
      "kind_label": "Faktura vydaná",
      "status": "issued",
      "number": "FV20260022",
      "variable_symbol": "20260022",
      "original_number": null,
      "partner_id": 2,
      "partner_name": "Kavárna U Zeleného stromu s.r.o.",
      "partner_ico": "90000021",
      "issue_date": "2026-09-15",
      "taxable_date": "2026-09-15",
      "due_date": "2026-09-25",
      "currency": "CZK",
      "total_net": 64000.0,
      "total_vat": 13440.0,
      "total_payable": 77440.0,
      "total_gross_czk": 77440.0,
      "paid_amount": 77440.0,
      "remaining": 0.0,
      "payment_state": "paid",
      "days_overdue": 0,
      "description": "UX audit a doporučení",
      "vat_mode": "domestic",
      "source": "manual",
      "tags": null,
      "related_document_id": null,
      "reminders_sent": 0,
      "outcome": null,
      "attachments_count": 0,
      "approval_state": null,
      "created_by_id": 1,
      "created_by_name": "ukazka"
    }
  }
]

POST Založení opakované faktury

/entities/{entity_id}/recurrences

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Nastaví pravidelné vytváření kopie dokladu template_document_id – monthly (měsíčně), quarterly (čtvrtletně), half_yearly (pololetně), yearly (ročně) – poprvé k datu next_on; doklady vytváří runRecurrences a automatizace. Vzorem může být doklad jakéhokoli druhu a stavu. Jeden doklad smí mít jen jedno aktivní pravidlo. Pole jsou na nejvyšší úrovni těla (bez obalu).

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
template_document_idcelé čísloanoID vzorového dokladu firmy (cizí nebo neexistující vrátí 404)
frequencytextneFrekvence (výchozí monthly) Hodnoty: monthly, quarterly, half_yearly, yearly. Výchozí monthly.
next_ondatumanoDatum prvního vytvoření, 1. 1. 2000 – 31. 12. 2100
ends_ondatumnePoslední možné datum vytvoření (stejný rozsah); po jeho překročení se pravidlo ukončí. Nečitelné datum se bez chyby uloží jako prázdné (pravidlo bez konce).
auto_issueano/neneVytvořený doklad rovnou vystavit (výchozí false = koncept) Výchozí false.
activeano/nenePravidlo je aktivní (výchozí true) Výchozí true.

Odpověď

201 application/json Pravidlo ve tvaru listRecurrences včetně template.

Chyby této operace

StavKódKdy
422–Doklad už má aktivní pravidlo: „Tato faktura už má automatické pravidlo – upravte to stávající“ (tvar { error, errors })
422–next_on chybí nebo je neplatné či mimo roky 2000–2100 (i ends_on): „… musí ležet v letech 2000 až 2100“ (tvar { error, errors })

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Vytvoří pravidlo a zapíše recurrence.created; doklad zatím nevytváří.
Opakování
Druhé volání pro stejný doklad vrátí 422, dokud je první pravidlo aktivní.

Příklad

Vzor nesmí mít jiné aktivní pravidlo (ukázková firma už má jedno pro poslední fakturu v Kč).

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_document_id":1,"frequency":"monthly","next_on":"2026-11-01","auto_issue":false}' \
  https://techtools.cz/ucetnictvi-api/entities/1/recurrences

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/recurrences', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "template_document_id": 1,
    "frequency": "monthly",
    "next_on": "2026-11-01",
    "auto_issue": false
  })
});
const data = await response.json();
Odpověď 201 Created
{
  "id": 3,
  "active": true,
  "auto_issue": false,
  "created_at": "2026-09-28T10:00:00.000Z",
  "ends_on": null,
  "frequency": "monthly",
  "last_generated_on": null,
  "next_on": "2026-11-01",
  "template_document_id": 1,
  "updated_at": "2026-09-28T10:00:00.000Z",
  "template": {
    "id": 1,
    "kind": "invoice_out",
    "kind_label": "Faktura vydaná",
    "status": "issued",
    "number": "FV20260001",
    "variable_symbol": "20260001",
    "original_number": null,
    "partner_id": 1,
    "partner_name": "Nordwood Studio s.r.o.",
    "partner_ico": "90000013",
    "issue_date": "2026-01-04",
    "taxable_date": "2026-01-04",
    "due_date": "2026-01-18",
    "currency": "CZK",
    "total_net": 75900.0,
    "total_vat": 15939.0,
    "total_payable": 91839.0,
    "total_gross_czk": 91839.0,
    "paid_amount": 91839.0,
    "remaining": 0.0,
    "payment_state": "paid",
    "days_overdue": 0,
    "description": "Návrh a vývoj webové aplikace",
    "vat_mode": "domestic",
    "source": "manual",
    "tags": null,
    "related_document_id": null,
    "reminders_sent": 0,
    "outcome": null,
    "attachments_count": 0,
    "approval_state": null,
    "created_by_id": 1,
    "created_by_name": "ukazka"
  }
}

PATCH Úprava opakované faktury

/entities/{entity_id}/recurrences/{id}

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Změní frekvenci, datum příštího vytvoření, konec, automatické vystavení nebo aktivitu pravidla (vzorový doklad změnit nelze). Znovu aktivované pravidlo nesmí kolidovat s jiným aktivním pravidlem téhož dokladu. Pole jsou na nejvyšší úrovni těla.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID pravidla opakování Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
frequencytextneFrekvence Hodnoty: monthly, quarterly, half_yearly, yearly.
next_ondatumneDatum příštího vytvoření (2000–2100)
ends_ondatumnePoslední možné datum vytvoření, nebo null; nečitelné datum se bez chyby uloží jako null
auto_issueano/neneVytvořený doklad rovnou vystavit
activeano/nenePravidlo je aktivní

Odpověď

200 application/json Pravidlo ve tvaru listRecurrences včetně template.

Chyby této operace

StavKódKdy
422–Aktivace při jiném aktivním pravidle téhož dokladu: „Tato faktura už má automatické pravidlo – upravte to stávající“
422–Datum mimo roky 2000–2100: „… musí ležet v letech 2000 až 2100“

Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.

Chování

Co změní
Uloží změny pravidla; když se něco změnilo, zapíše do historie událost recurrence.updated se změnami.
Opakování
Opakování se stejným tělem nic dalšího nezmění.

Příklad

cURL

curl \
  -X PATCH \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency":"quarterly","auto_issue":true}' \
  https://techtools.cz/ucetnictvi-api/entities/1/recurrences/1

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/recurrences/1', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'PATCH',
  body: JSON.stringify({
    "frequency": "quarterly",
    "auto_issue": true
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "frequency": "quarterly",
  "auto_issue": true,
  "id": 1,
  "active": true,
  "created_at": "2026-09-28T10:00:00.000Z",
  "ends_on": null,
  "last_generated_on": null,
  "next_on": "2026-10-03",
  "template_document_id": 22,
  "updated_at": "2026-09-28T10:00:00.000Z",
  "template": {
    "id": 22,
    "kind": "invoice_out",
    "kind_label": "Faktura vydaná",
    "status": "issued",
    "number": "FV20260022",
    "variable_symbol": "20260022",
    "original_number": null,
    "partner_id": 2,
    "partner_name": "Kavárna U Zeleného stromu s.r.o.",
    "partner_ico": "90000021",
    "issue_date": "2026-09-15",
    "taxable_date": "2026-09-15",
    "due_date": "2026-09-25",
    "currency": "CZK",
    "total_net": 64000.0,
    "total_vat": 13440.0,
    "total_payable": 77440.0,
    "total_gross_czk": 77440.0,
    "paid_amount": 77440.0,
    "remaining": 0.0,
    "payment_state": "paid",
    "days_overdue": 0,
    "description": "UX audit a doporučení",
    "vat_mode": "domestic",
    "source": "manual",
    "tags": null,
    "related_document_id": null,
    "reminders_sent": 0,
    "outcome": null,
    "attachments_count": 0,
    "approval_state": null,
    "created_by_id": 1,
    "created_by_name": "ukazka"
  }
}

DELETE Smazání opakované faktury

/entities/{entity_id}/recurrences/{id}

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Smaže pravidlo opakování. Doklady podle něj už vytvořené zůstanou beze změny.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.
idcestacelé čísloanoID pravidla opakování Příklad 12.

Odpověď

204 Prázdná odpověď.

Chování

Co změní
Smaže pravidlo a zapíše do historie událost recurrence.deleted s jeho údaji.
Opakování
Druhé volání vrátí 404.

Příklad

cURL

curl \
  -X DELETE \
  -H "X-API-Key: $SALDO_API_KEY" \
  https://techtools.cz/ucetnictvi-api/entities/1/recurrences/1

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/recurrences/1', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY },
  method: 'DELETE'
});
const data = await response.json();
Odpověď 204 No Content
soubor, 0 bajtů

POST Vytvoření splatných opakovaných faktur

/entities/{entity_id}/recurrences/run

Oprávnění
Vlastník, účetní nebo editor
Klíč jen pro čtení
Nestačí, vrátí 403 READ_ONLY_KEY

Pro každé aktivní pravidlo s datem příštího vytvoření nejpozději on (výchozí dnes; pozdější datum se zkrátí na dnešek) vytvoří kopii vzorového dokladu (viz prepareDocumentCopy) se zdrojem recurring: DUZP daňových dokladů = plánované datum, datum vystavení = on (skutečný den běhu, nikdy dřív než plánované datum), splatnost podle kontaktu nebo firmy od data vystavení; období v textech (měsíc, čtvrtletí, rozsah dat, „rok 2026“, „1. 9. 2026 – 30. 9. 2026“, „za září“) se posunou o počet měsíců od vzoru. U cizí měny načte kurz ČNB k DUZP; když není k dispozici, doklad zůstane konceptem s kurzem vzoru a varováním ve warnings. Zmeškaná období dožene, nejvýše 24 dokladů na pravidlo za volání, a posune datum příštího vytvoření na stejný den v měsíci (den zkrácený na konec kratšího měsíce se v delším vrátí: 31. 1., 28. 2., 31. 3.); za koncem pravidlo ukončí. S auto_issue doklad hned vystaví, přijatý výdaj, na který se vztahuje schvalování, ale jen odešle ke schválení (běh nikdy neschvaluje); jinak zůstane konceptem. Doklad, jehož termín je víc než 15 dnů pryč nebo jehož DUZP leží v uzamčeném období, vznikne vždy jen jako koncept s varováním ve warnings.

Parametry

NázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 7.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
ondatumneVytvořit, co je splatné do tohoto dne (výchozí dnes, nejvýše dnes)

Odpověď

200 application/json Vytvořené doklady.

PoleVýznam
created[]Souhrny vytvořených dokladů jako řádky listDocuments
countPočet vytvořených dokladů
failedPravidla, která se nepovedla: recurrence_id, template (číslo vzoru), error – např. doklad nejde s auto_issue vystavit (chybí položka nebo odběratel, uzamčené období) nebo vzorová faktura už neexistuje; ostatní pravidla běh vytvoří
warningsVěty o dokladech vytvořených pozdě jen jako koncept (termín, DUZP, dodatečné přiznání)

Chování

Co změní
Vytvoří doklady (document.created, s auto_issue i vystavení a zaúčtování jako issueDocument, nebo odeslání ke schválení) a u pravidel posune next_on, last_generated_on a případně je ukončí. Dotazuje kurzy ČNB u vzorů v cizí měně. Každý vytvořený doklad se ukládá samostatně: při chybě zůstanou doklady vytvořené před ní.
Limity
Nejvýše 24 dokladů na jedno pravidlo za volání.
Opakování
Druhé volání se stejným on nic nevytvoří, protože pravidla už mají příští datum později (jen pravidlo, které narazilo na limit 24 dokladů, pokračuje dalšími zmeškanými obdobími); souběžné běhy si totéž období nezdvojí.

Příklad

Ukázkové pravidlo má příští datum v příštím měsíci, takže odpověď je prázdná (count 0).

cURL

curl \
  -X POST \
  -H "X-API-Key: $SALDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"on":"2026-09-28"}' \
  https://techtools.cz/ucetnictvi-api/entities/1/recurrences/run

JavaScript

const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/recurrences/run', {
  headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
  method: 'POST',
  body: JSON.stringify({
    "on": "2026-09-28"
  })
});
const data = await response.json();
Odpověď 200 OK
{
  "created": [],
  "count": 0,
  "failed": [],
  "warnings": []
}