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.
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
kind | dotaz | text | ne | Druhy 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. |
status | dotaz | text | ne | Stav dokladu – koncept, vystavený, stornovaný; jiná hodnota nic nenajde Hodnoty: draft, issued, cancelled. Příklad issued. |
state | dotaz | text | ne | Stav ú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. |
approval | dotaz | text | ne | waiting = 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_id | dotaz | celé číslo | ne | Jen doklady tohoto kontaktu Příklad 118. |
from | dotaz | datum | ne | Datum vystavení od (včetně), ISO YYYY-MM-DD Příklad 2026-09-01. |
to | dotaz | datum | ne | Datum vystavení do (včetně), ISO YYYY-MM-DD Příklad 2026-09-30. |
year | dotaz | celé číslo | ne | Hospodář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. |
q | dotaz | text | ne | Hledaný 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. |
page | dotaz | celé číslo | ne | Číslo stránky; hodnota menší než 1 znamená 1 Výchozí 1. Rozsah od 1. Příklad 1. |
per | dotaz | celé číslo | ne | Poč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).
| Pole | Význam |
|---|---|
total | Počet dokladů odpovídajících filtrům (všechny stránky) |
page | Vrácená stránka |
per | Použitý počet řádků na stránce |
sums.net_czk | Součet základů v Kč za celý výběr |
sums.vat_czk | Součet DPH v Kč za celý výběr |
sums.gross_czk | Součet částek s DPH v Kč za celý výběr |
sums.count | Počet vystavených dokladů, které součty zahrnují |
rows[].id | ID dokladu |
rows[].kind | Druh dokladu (invoice_out, invoice_in, …) |
rows[].kind_label | Český název druhu, např. Faktura vydaná |
rows[].status | draft (koncept), issued (vystavený), cancelled (stornovaný) |
rows[].number | Číslo z číselné řady; null u konceptu, který ještě nebyl vystaven |
rows[].variable_symbol | Variabilní symbol |
rows[].original_number | Číslo dokladu dodavatele (u přijatých dokladů) |
rows[].partner_id | ID kontaktu |
rows[].partner_name | Jméno kontaktu – u vystaveného dokladu ze snímku při vystavení |
rows[].partner_ico | IČO kontaktu |
rows[].issue_date | Datum vystavení |
rows[].taxable_date | Datum uskutečnění zdanitelného plnění (DUZP) |
rows[].due_date | Datum splatnosti |
rows[].currency | Měna dokladu (ISO 4217) |
rows[].total_net | Základ v měně dokladu |
rows[].total_vat | DPH 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_amount | Uhrazeno v měně dokladu |
rows[].remaining | Zbývá uhradit (total_payable − paid_amount) |
rows[].payment_state | na (nevystavený doklad nebo druh bez úhrad), unpaid, partial, overdue, paid |
rows[].days_overdue | Počet dní po splatnosti (0, není-li overdue) |
rows[].description | Popis dokladu |
rows[].vat_mode | Režim DPH |
rows[].source | Původ dokladu: manual, recurring, isdoc, pohoda, import |
rows[].tags | Štítky (text) |
rows[].related_document_id | ID souvisejícího dokladu (např. faktura u dobropisu) |
rows[].reminders_sent | Počet zaznamenaných upomínek |
rows[].outcome | Výsledek nabídky: accepted, rejected nebo null |
rows[].attachments_count | Počet příloh |
rows[].approval_state | Uložený stav schvalování (pending, approved, returned, changed) nebo null |
rows[].created_by_id | ID uživatele, který doklad založil (null u starších a importovaných) |
rows[].created_by_name | Zobrazované nebo uživatelské jméno toho, kdo doklad založil |
rows[].uploaded_by | Jmé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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
document | objekt | ano | |
document. | text | ano | Druh 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. | celé číslo | ne | ID kontaktu (odběratel nebo dodavatel); ID, které firmě nepatří, se uloží jako prázdné |
document. | datum | ano | Datum vystavení; určuje rok číselné řady |
document. | datum | ne | DUZP; u daňových dokladů se při vystavení doplní datem vystavení, pokud chybí |
document. | datum | ne | Datum splatnosti; nesmí být dříve než datum vystavení |
document. | datum | ne | Datum přijetí dokladu (u přijatých dokladů) |
document. | datum | ne | Datum 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. | datum | ne | Datum úč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. | text | ne | Kód měny ze tří písmen (převede se na velká); výchozí CZK |
document. | číslo | ne | Kurz 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. | datum | ne | Datum, ke kterému je kurz (informativní; posouzení limitu schvalování podle něj hledá kurz ČNB) |
document. | text | ne | Rež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. | text | ne | Kód předmětu plnění u přenesené daňové povinnosti (číselník rc_codes v /codebooks; hodnota se neověřuje) |
document. | ano/ne | ne | Ceny řádků jsou včetně DPH (výchozí false) |
document. | ano/ne | ne | Zjednodušený daňový doklad (výchozí false) |
document. | ano/ne | ne | Oprava 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. | text | ne | Způ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. | celé číslo | ne | ID bankovního účtu nebo pokladny firmy pro úhradu; cizí ID se uloží jako prázdné |
document. | text | ne | Variabilní symbol; nečíselné znaky se odstraní, nejvýše 10 číslic. U prodeje se při vystavení doplní z čísla dokladu |
document. | text | ne | Konstantní symbol, nejvýše 10 číslic |
document. | text | ne | Specifický symbol, nejvýše 10 číslic |
document. | text | ne | Číslo dokladu dodavatele (u přijatých dokladů); používá se ke kontrole duplicit |
document. | text | ne | Popis dokladu |
document. | text | ne | Text na dokladu (vidí ho i zákazník) |
document. | text | ne | Interní poznámka; na sdílené stránce dokladu se nezobrazí |
document. | text | ne | Jazyk dokladu (výchozí cs) Hodnoty: cs, en. |
document. | text | ne | Oddíl kontrolního hlášení; jen se uloží, výpočty ho nečtou |
document. | text | ne | Středisko (podmínka pravidel schvalování) |
document. | text | ne | Projekt / zakázka |
document. | text | ne | Štítky jako text |
document. | celé číslo | ne | ID souvisejícího dokladu firmy (např. původní faktura dobropisu); cizí ID se uloží jako prázdné |
document. | text | ne | Úč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. | text | ne | IBAN dodavatele z dokladu (přednost před payee_account u plateb SEPA) |
document. | text | ne | BIC dodavatele z dokladu |
document. | ano/ne | ne | Zaokrouhlení 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. | text | ne | Kód další číselné řady druhu (listNumberSeries); prázdný nebo neznámý = hlavní řada |
document. | text | ne | Vlastní čí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. | pole (objekt) | ne | Řádky dokladu v pořadí, v jakém se mají zobrazit |
document. | text | ne | Text položky, nejvýše 500 znaků |
document. | číslo | ne | Množství, nesmí být 0 (záporné u dobropisu nebo odpočtu); výchozí 1 |
document. | text | ne | Jednotka, např. ks, hod |
document. | číslo | ne | Jednotková cena (bez DPH, nebo s DPH při prices_include_vat), 4 desetinná místa |
document. | číslo | ne | Sleva v procentech 0–100 |
document. | číslo | ne | Sazba DPH v procentech 0–100; bez hodnoty 0 |
document. | text | ne | Druh 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. | text | ne | Úč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. | ano/ne | ne | Pořízení dlouhodobého majetku (u nákupu plátce i ř. 47 přiznání k DPH) |
document. | text | ne | Nárok na odpočet DPH u nákupu – plný, krácený koeficientem, žádný (výchozí full) Hodnoty: full, proportional, none. |
document. | číslo | ne | Podí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. | celé číslo | ne | Odpočet zálohy – ID daňového dokladu k záloze (advance_out/advance_in); jiné ID se uloží jako prázdné |
document. | číslo | ne | Jen customs_in: DPH řádku podle rozhodnutí celního úřadu; bez hodnoty se spočítá ze základu |
document. | text | ne | Jen internal: účet Dal řádku (account_code je MD); při vystavení povinný a jiný než MD |
issue | ano/ne | ne | true = po uložení doklad vystavit (nebo odeslat ke schválení) |
capture_key | text | ne | Volitelný 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
| Stav | Kód | Kdy |
|---|---|---|
| 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 |
| 403 | SUBMITTER_ONLY | Role 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/documentsJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › Detail faktury
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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č.
| Pole | Význam |
|---|---|
uuid | UUID dokladu (u importu z ISDOC), jinak null |
constant_symbol | Konstantní symbol |
specific_symbol | Specifický symbol |
received_date | Datum přijetí |
vat_date | Datum pro DPH |
accounting_date | Datum účetního případu (zaúčtování) |
payee_account | Účet dodavatele z dokladu (také payee_iban, payee_bic) |
payee_mismatch | U nákupu { printed, known }, když se účet z dokladu liší od účtu kontaktu, jinak null |
exchange_rate | Kurz CZK za jednotku měny |
rate_date | Datum kurzu |
rc_code | Kód předmětu plnění PDP |
prices_include_vat | Ceny včetně DPH |
simplified | Zjednodušený daňový doklad |
regime_44 | Oprava podle § 44 ZDPH |
payment_method | Způsob úhrady |
bank_account_id | ID účtu pro úhradu |
rounding | Zaokrouhlení částky k úhradě |
total_gross | Částka s DPH v měně dokladu (před zaokrouhlením) |
total_net_czk | Základ v Kč |
total_vat_czk | DPH v Kč |
note | Text na dokladu |
internal_note | Interní poznámka |
language | cs nebo en |
kh_section | Uložený oddíl kontrolního hlášení |
cost_center | Středisko |
project | Projekt |
paid_on | Datum poslední úhrady, když je doklad plně uhrazen (u pokladního dokladu datum vystavení), jinak null |
created_at | Založeno |
updated_at | Naposledy změněno |
partner | Kontakt { 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 } |
share | Veř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_account | Bankovní úč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é |
recurrence | Aktivní 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_filed | Př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 |
approval | Stav 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_code | Kód další číselné řady, nebo null (hlavní řada) |
series[] | Jen u konceptu: číselné řady druhu { code, label, prefix, format } |
advance_tax | Jen 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_count | Počet uložených verzí dokladu (GET …/versions); koncepty a obchodní doklady 0 |
issued_version | Jen 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_locked | true, 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/129JavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
document | objekt | ano | |
document. | celé číslo | ne | ID kontaktu; cizí ID se uloží jako prázdné |
document. | datum | ne | Datum vystavení |
document. | datum | ne | DUZP |
document. | datum | ne | Datum splatnosti; nesmí být dříve než datum vystavení |
document. | datum | ne | Datum přijetí |
document. | datum | ne | Datum 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. | datum | ne | Datum účetního případu; bez hodnoty DUZP, do uzamčeného období první otevřený den (viz createDocument) |
document. | text | ne | Kód měny |
document. | číslo | ne | Kurz CZK za jednotku měny (> 0); u CZK vždy 1 |
document. | datum | ne | Datum kurzu |
document. | text | ne | Režim DPH (viz createDocument) Hodnoty: domestic, reverse_charge, eu_goods, eu_services, import, export, exempt, non_vat, triangular. |
document. | text | ne | Kód předmětu plnění PDP |
document. | ano/ne | ne | Ceny včetně DPH |
document. | ano/ne | ne | Zjednodušený daňový doklad |
document. | ano/ne | ne | Oprava podle § 44 ZDPH |
document. | text | ne | Způsob úhrady Hodnoty: bank, cash, card, cod, offset, advance, other. |
document. | celé číslo | ne | ID bankovního účtu nebo pokladny; cizí ID se uloží jako prázdné |
document. | text | ne | Variabilní symbol (jen číslice, nejvýše 10) |
document. | text | ne | Konstantní symbol, nejvýše 10 číslic |
document. | text | ne | Specifický symbol, nejvýše 10 číslic |
document. | text | ne | Číslo dokladu dodavatele |
document. | text | ne | Popis |
document. | text | ne | Text na dokladu |
document. | text | ne | Interní poznámka |
document. | text | ne | Jazyk dokladu Hodnoty: cs, en. |
document. | text | ne | Oddíl kontrolního hlášení (jen se uloží) |
document. | text | ne | Středisko |
document. | text | ne | Projekt |
document. | text | ne | Štítky |
document. | celé číslo | ne | ID souvisejícího dokladu; cizí ID se uloží jako prázdné |
document. | pole (objekt) | ne | Změny řádků – s id úprava, s id a _destroy smazání, bez id nový řádek |
document. | celé číslo | ne | ID existujícího řádku dokladu |
document. | ano/ne | ne | true = řádek odebrat |
document. | text | ne | Text položky, nejvýše 500 znaků |
document. | číslo | ne | Množství, nesmí být 0 |
document. | text | ne | Jednotka |
document. | číslo | ne | Jednotková cena |
document. | číslo | ne | Sleva 0–100 % |
document. | číslo | ne | Sazba DPH 0–100 % |
document. | text | ne | Druh plnění Hodnoty: standard, exempt_with_credit, exempt_without_credit, not_subject. |
document. | text | ne | Účet nebo kategorie daňové evidence |
document. | ano/ne | ne | Pořízení dlouhodobého majetku |
document. | text | ne | Nárok na odpočet Hodnoty: full, proportional, none. |
document. | číslo | ne | Podíl pro podnikání v procentech (poměrný odpočet § 75 ZDPH), výchozí 100 |
document. | celé číslo | ne | ID odečítaného daňového dokladu k záloze |
issue | ano/ne | ne | true = 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
| Stav | Kód | Kdy |
|---|---|---|
| 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) |
| 403 | SUBMITTER_ONLY | Role 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/132JavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1540. |
Odpověď
204 Prázdná odpověď.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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“ |
| 403 | SUBMITTER_ONLY | Role 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/132JavaScript
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();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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
kind | dotaz | text | ne | Druh 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.
| Pole | Význam |
|---|---|
number_preview | Ná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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
kind | dotaz | text | ne | Druh 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. |
date | dotaz | datum | ne | Datum vystavení, ke kterému se číslo počítá (výchozí dnes) Příklad 2026-09-28. |
series | dotaz | text | ne | Kód další číselné řady; prázdný nebo neznámý = hlavní řada Příklad eshop. |
Odpověď
200 application/json Objekt s náhledem čísla.
| Pole | Vý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();{
"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čí
- V příručce
- Nastavení a integrace › Číselné řady
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
year | dotaz | celé číslo | ne | Rok (výchozí letošní) Příklad 2026. |
Odpověď
200 application/json Rok a řady po druzích dokladů.
| Pole | Význam |
|---|---|
year | Rok |
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();{
"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 - V příručce
- Nastavení a integrace › Číselné řady
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | text | ano | Druh 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.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Rok, kterého se týká numbers (výchozí letošní) |
prefix | text | ne | Předpona hlavní řady, nejvýše 10 znaků (písmena, číslice, - / _ .); prázdná = bez předpony |
format | text | ne | Formát čísel druhu, např. {prefix}{yy}-{nnnnn}; musí obsahovat {n…}; prázdný = formát firmy |
extra | pole (objekt) | ne | Další řady druhu |
extra[] | text | ne | Kód řady, 1–20 malých písmen, číslic nebo pomlček |
extra[] | text | ne | Název řady (do 40 znaků) |
extra[] | text | ne | Předpona řady |
extra[] | text | ne | Vlastní formát řady (nepovinné) |
numbers | objekt | ne | Další číslo podle kódu řady, např. { "": 138, "eshop": 1 } |
Odpověď
200 application/json Řady druhu ve tvaru kinds[] z listNumberSeries.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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_outJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › Doplňování z historie
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
q | dotaz | text | ne | Hledaná slova Příklad konzultace. |
kind | dotaz | text | ne | Druh 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.
| Pole | Význam |
|---|---|
rows[].description | Text položky |
rows[].unit | Jednotka |
rows[].unit_price | Jednotková cena z posledního použití |
rows[].vat_rate | Sazba DPH |
rows[].vat_kind | Druh plnění |
rows[].account_code | Účet / kategorie |
rows[].discount_percent | Sleva |
rows[].currency | Měna dokladu, kde byla položka naposledy |
rows[].prices_include_vat | Zda byla cena včetně DPH |
rows[].count | Kolikrát byla položka použita |
rows[].last_used | Datum vystavení posledního dokladu s položkou |
rows[].score | Skó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();{
"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čí
- V příručce
- Vydané faktury › Doplňování z historie
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
partner_id | dotaz | celé číslo | ano | ID kontaktu firmy Příklad 118. |
kind | dotaz | text | ne | Druh 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.
| Pole | Význam |
|---|---|
partner_id | ID kontaktu |
based_on | { id, number, kind, issue_date } dokladu, ze kterého hodnoty pocházejí (number u konceptu je text Koncept), nebo null |
currency | Měna |
payment_method | Způsob úhrady |
language | Jazyk |
vat_mode | Režim DPH |
rc_code | Kód PDP |
prices_include_vat | Ceny s DPH |
constant_symbol | Konstantní symbol |
bank_account_id | Aktivní bankovní účet posledního dokladu nebo null |
due_days | Splatnost ve dnech nebo null |
account_code | U 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_source | Odkud 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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
kind | dotaz | text | ne | Druh 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_id | dotaz | celé číslo | ne | ID dodavatele; bez něj (nebo s cizím ID) je výsledek null Příklad 131. |
original_number | dotaz | text | ne | Číslo dokladu dodavatele Příklad 2026090815. |
issue_date | dotaz | datum | ne | Datum vystavení (pro shodu podle částky) Příklad 2026-09-20. |
total | dotaz | číslo | ne | Částka k úhradě v měně dokladu (pro shodu podle částky; 0 nebo prázdná shodu podle částky vypne) Příklad 17545. |
currency | dotaz | text | ne | Kó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. |
id | dotaz | celé číslo | ne | ID právě upravovaného dokladu, který se má z porovnání vynechat Příklad 1540. |
Odpověď
200 application/json Pravděpodobná duplicita nebo null.
| Pole | Význam |
|---|---|
duplicate_of | null, nebo { id, number, kind, status, original_number, issue_date, total_payable, currency, partner, reason, message } |
duplicate_of.reason | number (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¤cy=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¤cy=CZK', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
ids | dotaz | text | ne | ID 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.
| Pole | Význam |
|---|---|
days | Počet dní po splatnosti z nastavení automatizace (reminder_days) |
entity | Údaje firmy pro hlavičku upomínky |
skipped | S ids počet uvedených ID, které nejsou vydanou fakturou nebo zálohovou fakturou po splatnosti (i cizí ID); bez ids 0 |
rows[].document | Detail dokladu (bez approval) |
rows[].interest | Výpočet úroku jako v getDocumentReminder, nebo null, když výpočet nejde |
rows[].next_level | Poř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/remindersJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
operation | text | ano | Hromadná akce Hodnoty: issue, pay, remind, recode, delete. |
ids | pole (celé číslo) | ano | ID dokladů firmy (lze i jeden řetězec s ID oddělenými čárkou); ID jiných firem se tiše vynechají |
paid_on | datum | ne | Jen pay – datum úhrady (výchozí dnes) |
bank_account_id | celé číslo | ne | Jen pay – bankovní účet nebo pokladna, na kterou se úhrada zaznamená; ID, které firmě nepatří, vrátí 422 a nic se nezaplatí |
account_code | text | ne | Jen recode – nový účet řádků (musí být v účtovém rozvrhu firmy) |
from_account | text | ne | Jen recode s account_code – změnit jen řádky s tímto účtem |
cost_center | text | ne | Jen recode – nové středisko (nejvýš 80 znaků) |
project | text | ne | Jen recode – nová zakázka (nejvýš 80 znaků) |
Odpověď
200 application/json Výsledek akce po dokladech.
| Pole | Význam |
|---|---|
operation | Provedená akce |
done | Poč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
| Stav | Kód | Kdy |
|---|---|---|
| 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/bulkJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID konceptu Příklad 1540. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
fingerprint | text | ne | Otisk 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
| Stav | Kód | Kdy |
|---|---|---|
| 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/issueJavaScript
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();{
"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 - V příručce
- Vydané faktury › Stornovat fakturu
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Detail stornovaného dokladu jako v getDocument.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/cancelJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
cancel_payments | ano/ne | ne | true = 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
| Stav | Kód | Kdy |
|---|---|---|
| 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/reopenJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › Verze dokladu
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID firmy. Příklad 1. |
id | cesta | celé číslo | ano | ID dokladu. Příklad 431. |
Odpověď
200 application/json Objekt s polem versions a příznakem intact.
| Pole | Význam |
|---|---|
intact | true, když každý otisk odpovídá svému snímku a otisku předchozí verze |
versions[].number | Pořadí verze od 1 |
versions[].action | original, issued, updated, cancelled nebo reopened; action_label je český název |
versions[].user | Kdo verzi uložil; api_key { name, hint }, když přes API klíč |
versions[].created_at | Čas uložení |
versions[].digest | SHA-256 z otisku předchozí verze a snímku (previous_digest) |
versions[].has_isdoc | K verzi je uložený ISDOC (vydané doklady při vystavení a opravě) |
versions[].has_supplier | Verze 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_sha256 | SHA-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[].changes | Změ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/versionsJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › Verze dokladu
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID firmy. Příklad 1. |
id | cesta | celé číslo | ano | ID dokladu. Příklad 431. |
number | cesta | celé číslo | ano | Čí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
| Stav | Kód | Kdy |
|---|---|---|
| 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/isdocJavaScript
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();<?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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID firmy. Příklad 1. |
id | cesta | celé číslo | ano | ID dokladu. Příklad 431. |
Tělo požadavku
Formát multipart/form-data.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
file | soubor | ano | PDF 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
| Stav | Kód | Kdy |
|---|---|---|
| 400 | – | Chybí pole file („Vyberte soubor PDF“) |
| 413 | – | Soubor je větší než 15 MB |
| 422 | NO_ISSUED_VERSION | Doklad 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“) |
| 403 | SUBMITTER_ONLY | Role 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/originalJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID firmy. Příklad 1. |
id | cesta | celé číslo | ano | ID dokladu. Příklad 431. |
number | cesta | celé číslo | ano | Čí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
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Verze neexistuje, nebo k ní originál uložený není („K této verzi se originál PDF neuložil“) |
| 409 | ORIGINAL_CHANGED | Uložený soubor nesouhlasí se svým otiskem SHA-256 |
| 403 | SUBMITTER_ONLY | Role 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/pdfJavaScript
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();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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Detail dokladu jako v getDocument, ale bez approval.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/remindJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID vystavené faktury (dokladu s úhradou) Příklad 1532. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
proforma_id | celé číslo | ano | ID 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
| Stav | Kód | Kdy |
|---|---|---|
| 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/settleJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › Duplikovat fakturu
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID kopírovaného dokladu Příklad 1532. |
Odpověď
200 application/json Koncept ve tvaru getDocument (id null, bez approval) a navíc number_preview.
| Pole | Význam |
|---|---|
number_preview | Ná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/duplicateJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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
| Stav | Kód | Kdy |
|---|---|---|
| 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_noteJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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
| Stav | Kód | Kdy |
|---|---|---|
| 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_invoiceJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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.
| Pole | Význam |
|---|---|
notices | Upozornění k návrhu: další platby bez daňového dokladu, použitý kurz ČNB, uplynulá lhůta 15 dnů |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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_documentJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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
| Stav | Kód | Kdy |
|---|---|---|
| 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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Podklady pro upomínku.
| Pole | Význam |
|---|---|
document | Detail dokladu (bez approval) |
entity | Údaje firmy |
next_level | Pořadí příští upomínky (zaznamenané upomínky + 1) |
interest.principal | Jistina = zbývající částka dokladu |
interest.currency | Měna jistiny a úroku = měna dokladu |
interest.delay_from | První den prodlení, nebo null, když prodlení ještě nenastalo |
interest.days | Počet dní prodlení |
interest.reference_date | První den pololetí, podle kterého se bere repo sazba |
interest.repo_rate | Repo sazba ČNB v % |
interest.rate | Roč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_cost | Ná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/reminderJavaScript
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();{
"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čí
- V příručce
- Vydané faktury › QR Platba na faktuře
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Objekt s řetězcem QR Platby.
| Pole | Význam |
|---|---|
spayd | Např. SPD*1.0*ACC:CZ…*AM:15972.00*CC:CZK*…, nebo null |
reason | Proč QR Platba není (jen když spayd je null) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/qrJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/xml Soubor ISDOC (Content-Disposition attachment).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/isdocJavaScript
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();<?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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
amount | číslo | ne | Čá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_on | datum | ne | Datum úhrady (výchozí dnes) |
payment_method | text | ne | Způ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_id | celé číslo | ne | Bankovní úč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_id | celé číslo | ne | Jen offset – doklad, se kterým se započítává (kandidáty vrací listDocumentOffsets) |
fee | ano/ne | ne | Jen write_off – rozdíl je bankovní poplatek (568, do 1 000 Kč) |
amount_czk | číslo | ne | Skuteč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. |
note | text | ne | Poznámka k úhradě |
Odpověď
201 application/json Detail dokladu jako v getDocument, ale bez approval (úhrada je v payments[]).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/paymentsJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Kandidáti a limity odpisu.
| Pole | Vý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_limit | Nejvyšší odpis haléřového rozdílu v Kč (100) |
fee_limit | Nejvyšší 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/offsetsJavaScript
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();{
"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 - V příručce
- Vydané faktury › Zrušit úhradu
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
payment_id | cesta | celé číslo | ano | ID ú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
| Stav | Kód | Kdy |
|---|---|---|
| 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/1JavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
reopen | dotaz | ano/ne | ne | true = náhled pro vrácení do konceptu, zruší i zápočet zálohy (po novém vystavení se započte znovu) |
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID dokladu Příklad 1532. |
Odpověď
200 application/json Plán zrušení úhrad.
| Pole | Význam |
|---|---|
document_id | ID dokladu |
number | Číslo dokladu |
currency | Měna dokladu a částek |
double_entry | true = podvojné účetnictví (úhrady se odúčtují), false = daňová evidence |
count | Počet úhrad, které se zruší |
amount | Jejich 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 |
bank | Počet rušených úhrad spárovaných s bankovním pohybem |
blocker | Dů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/unpayJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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
| Stav | Kód | Kdy |
|---|---|---|
| 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/unpayJavaScript
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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID zdrojového dokladu Příklad 1601. |
kind | dotaz | text | ano | Druh 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
| Stav | Kód | Kdy |
|---|---|---|
| 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();{
"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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID nabídky Příklad 1601. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
outcome | text | ne | accepted = 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
| Stav | Kód | Kdy |
|---|---|---|
| 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/outcomeJavaScript
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();{
"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": []
}
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
Odpověď
200 application/json Pole pravidel opakování.
| Pole | Význam |
|---|---|
[].id | ID pravidla |
[].template_document_id | ID vzorového dokladu |
[].frequency | monthly, quarterly, half_yearly, yearly |
[].next_on | Datum příštího vytvoření |
[].ends_on | Poslední možné datum vytvoření, nebo null |
[].auto_issue | Vytvořený doklad rovnou vystavit |
[].active | Pravidlo je aktivní |
[].last_generated_on | Plánované datum posledního vytvořeného dokladu |
[].created_at | Založeno |
[].updated_at | Změněno |
[].template | Souhrn 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/recurrencesJavaScript
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();[
{
"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 - V příručce
- Vydané faktury › Opakovaná faktura
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
template_document_id | celé číslo | ano | ID vzorového dokladu firmy (cizí nebo neexistující vrátí 404) |
frequency | text | ne | Frekvence (výchozí monthly) Hodnoty: monthly, quarterly, half_yearly, yearly. Výchozí monthly. |
next_on | datum | ano | Datum prvního vytvoření, 1. 1. 2000 – 31. 12. 2100 |
ends_on | datum | ne | Poslední 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_issue | ano/ne | ne | Vytvořený doklad rovnou vystavit (výchozí false = koncept) Výchozí false. |
active | ano/ne | ne | Pravidlo je aktivní (výchozí true) Výchozí true. |
Odpověď
201 application/json Pravidlo ve tvaru listRecurrences včetně template.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/recurrencesJavaScript
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();{
"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 - V příručce
- Vydané faktury › Opakovaná faktura
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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID pravidla opakování Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
frequency | text | ne | Frekvence Hodnoty: monthly, quarterly, half_yearly, yearly. |
next_on | datum | ne | Datum příštího vytvoření (2000–2100) |
ends_on | datum | ne | Poslední možné datum vytvoření, nebo null; nečitelné datum se bez chyby uloží jako null |
auto_issue | ano/ne | ne | Vytvořený doklad rovnou vystavit |
active | ano/ne | ne | Pravidlo je aktivní |
Odpověď
200 application/json Pravidlo ve tvaru listRecurrences včetně template.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 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/1JavaScript
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();{
"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 - V příručce
- Vydané faktury › Opakovaná faktura
Smaže pravidlo opakování. Doklady podle něj už vytvořené zůstanou beze změny.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
id | cesta | celé číslo | ano | ID 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/1JavaScript
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();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ázev | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
on | datum | ne | Vytvořit, co je splatné do tohoto dne (výchozí dnes, nejvýše dnes) |
Odpověď
200 application/json Vytvořené doklady.
| Pole | Význam |
|---|---|
created[] | Souhrny vytvořených dokladů jako řádky listDocuments |
count | Počet vytvořených dokladů |
failed | Pravidla, 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ří |
warnings | Vě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/runJavaScript
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();{
"created": [],
"count": 0,
"failed": [],
"warnings": []
}