Reference API
Daně, podání a doručenky
Daňové sestavy, XML pro EPO a přehledy OSVČ, kontrola na portálu finanční správy a předběžná kontrola přehledu u ČSSZ, platby úřadům, evidence podání, doručenky a výjimky bez doručenky a daňový kalendář. Saldo samo nic úřadu nepodává.
GET Daňový výkaz nebo přehled podle hodnoty report
/entities/{entity_id}/taxes/{report}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
- V příručce
- Daně a pojistné › Platby úřadům; Daně a pojistné › Zaplatit platbu QR kódem; Daně a pojistné › DPH a hlášení; Daně a pojistné › Zkontrolovat přiznání a hlášení k DPH; Daně a pojistné › Opravné, dodatečné a následné podání; Daně a pojistné › Daň a pojistné OSVČ; Daně a pojistné › Porovnat skutečné výdaje, paušál a paušální daň; Daně a pojistné › Daň z příjmů s.r.o. a jiných právnických osob; Daně a pojistné › Roční přiznání a přehledy; Nastavení a integrace › Historie registrace k DPH
Sestaví a vrátí jeden daňový výkaz z aktuálních dat účetní jednotky; který, určuje hodnota report (viz varianty). Počítá se při každém volání z vystavených dokladů, účetních zápisů, bankovních pohybů a nastavení firmy. Operace nic neukládá a nic nepodává – XML, kontrolu v EPO a uložení podání obstarávají operace …/xml, …/epo, …/filing a /filings.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
report | cesta | text | ano | Druh výkazu (viz varianty) Hodnoty: vat_return, control_statement, recap_statement, income_tax, regime, filings_check, depreciation, payments, vat_coefficient, vat_book, registration_deduction. Příklad vat_return. |
Odpověď
200 application/json JSON podle varianty.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Neznámá hodnota report (error „Neznámý daňový výkaz“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nic nezapisuje.
/entities/{entity_id}/taxes/vat_return – Přiznání k DPH za období
Sestaví přiznání k DPH (řádky formuláře DPHDP3) z vystavených dokladů druhů invoice_out, invoice_in, credit_out, credit_in, advance_out, advance_in, cash_in, cash_out a customs_in (JSD, ř. 42), jejichž datum pro DPH spadá do období; koncepty a stornované doklady se nezapočítají. Přijaté faktury v režimu import (dovoz ze třetí země) do přiznání nevstupují, u faktury bez JSD přibude upozornění import_without_customs. Období určí period; bez něj year a month, u čtvrtletního plátce bez month čtvrtletí quarter. Výchozí je běžící měsíc (čtvrtletí) aktuálního roku, u jiného roku prosinec (4. čtvrtletí). Bez period má identifikovaná osoba vždy měsíční období.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období ve tvaru YYYY-MM nebo YYYY-Qn (např. 2026-08, 2026-Q3); má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
year | dotaz | celé číslo | ne | Rok období, když chybí period; výchozí (i při nečíselné hodnotě) aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ne | Měsíc období, když chybí period; mimo 1–12 vrátí 422 Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí; použije se jen u čtvrtletního plátce, když chybí period i month Rozsah od 1 do 4. Příklad 3. |
filing_type | dotaz | text | ne | D nebo E přidá náhled dodatečného (opravného dodatečného) přiznání v poli supplementary; jiná hodnota nic nemění Hodnoty: B, O, D, E. Příklad D. |
Pole odpovědi
| Pole | Význam |
|---|---|
period | Období: year, month, quarter, from, to, label, deadline (lhůta pro podání), key |
report.period | Období, za které je přiznání sestavené (stejné jako period) |
report.form | Označení tiskopisu přiznání, podle kterého jsou řádky sestavené (např. „25 5401 MFin 5401 vzor č. 26“) |
report.rows | Částky podle čísel řádků přiznání |
report.own_tax | Vlastní daňová povinnost (řádek 64) |
report.excess_deduction | Nadměrný odpočet (řádek 65) |
report.documents | Číslo řádku → ID dokladů, které do něj přispěly |
report.warnings | Upozornění k dokladům, které se nepodařilo zařadit nebo vyžadují kontrolu |
filed | Poslední podání přiznání za období označené jako podané, porovnané s aktuálními doklady, nebo null: filing_id, filing_type, filed_on, changed, suggested_type (O před koncem lhůty, D po ní), deadline_passed, filed_tax a current_tax (ř. 62 − ř. 63, záporné = nadměrný odpočet), tax_change, difference (rozdíly řádků) a rows (čísla změněných řádků) |
checks[] | Lhůty a opravy k vyřízení z kontrol firmy: oprava odpočtu podle § 74b (vat_74b), vrácení opravy po úhradě (vat_74b_reclaim), dlouhé číslo dokladu pro KH (kh_number) { level, key, title, detail, document_id, number } |
report.settlement | Jen v posledním období roku s kráceným odpočtem: automatické vypořádání ř. 53 { coefficient, change }, jinak null |
supplementary | Jen s filing_type D nebo E: náhled dodatečného přiznání – baseline_filing_id, baseline_filing_type, baseline_filed_on, rows (rozdíly, které nese XML), tax_change (ř. 66), changed; nebo error s důvodem, proč ho sestavit nejde |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Účetní jednotka není plátcem ani identifikovanou osobou (vat_status none) – „Účetní jednotka není registrovaná k DPH“ |
| 422 | – | Neplatné period, month nebo quarter („Neplatné období …“, „Neplatný měsíc …“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_return?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_return?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"report": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"filed": {
"filing_id": 1,
"filing_type": "B",
"filed_on": "2026-09-24",
"deadline_passed": true,
"suggested_type": null,
"changed": false,
"filed_tax": 44226.0,
"current_tax": 44226.0,
"tax_change": 0.0,
"difference": {
"1": {
"base": 0.0,
"tax": 0.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 0.0,
"tax": 0.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 0.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 0.0,
"63": 0.0,
"64": null,
"65": null,
"66": 0.0
},
"rows": []
},
"supplementary": null,
"checks": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/control_statement – Kontrolní hlášení za období
Sestaví kontrolní hlášení (oddíly A.1–A.5 a B.1–B.3) ze stejných dokladů jako přiznání k DPH a přidá kontrolní součty proti řádkům přiznání. Období se volí stejně jako u vat_return. Identifikovaná osoba kontrolní hlášení nepodává (422 IDENTIFIED_KH); právnická osoba ho podává za každý měsíc, čtvrtletní období proto odmítne (422 MONTHLY_KH).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
year | dotaz | celé číslo | ne | Rok období, když chybí period; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ne | Měsíc období, když chybí period Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí u čtvrtletního plátce – jen pro fyzickou osobu Rozsah od 1 do 4. Příklad 3. |
Pole odpovědi
| Pole | Význam |
|---|---|
period | Období (jako u vat_return) |
report.sections | Oddíly a1, a2, a3, a4, b1, b2 jako seznamy dokladů; a5 a b3 jako souhrnné částky s document_ids |
report.control | Kontrolní součty: base a return_rows – řádky přiznání, se kterými se porovnávají |
report.warnings | Upozornění k dokladům |
filed | Poslední podané kontrolní hlášení za období porovnané s doklady, nebo null: filing_id, filing_type, filed_on, changed, suggested_type (O před koncem lhůty, N po ní), added, removed (počty řádků) a totals (oddíly A.5, B.3 se změněným součtem) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Účetní jednotka není registrovaná k DPH |
| 422 | IDENTIFIED_KH | Identifikovaná osoba kontrolní hlášení nepodává (§ 101c ZDPH) |
| 422 | MONTHLY_KH | Právnická osoba zvolila čtvrtletí – kontrolní hlášení podává za každý měsíc (§ 101e ZDPH) |
| 422 | – | Neplatné period, month nebo quarter |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/control_statement?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/control_statement?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"report": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"sections": {
"a1": [],
"a2": [
{
"document_id": 65,
"country": "DE",
"vat_id": "998877665",
"number": "2026083526",
"dppd": "2026-08-07",
"base1": 28002.5,
"tax1": 5880.53,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0
}
],
"a3": [],
"a4": [
{
"document_id": 20,
"partner_dic": "90000013",
"number": "FV20260020",
"dppd": "2026-08-15",
"base1": 115500.0,
"tax1": 24255.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"bad_debt": false
},
{
"document_id": 130,
"partner_dic": "90000013",
"number": "FV20260026",
"dppd": "2026-08-31",
"base1": 19800.0,
"tax1": 4158.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"bad_debt": false
}
],
"a5": {
"base1": 96000.0,
"tax1": 20160.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"document_ids": [
19
]
},
"b1": [],
"b2": [
{
"document_id": 62,
"partner_dic": "90000056",
"number": "2026085713",
"dppd": "2026-08-02",
"base1": 14500.0,
"tax1": 3045.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"proportional": false,
"bad_debt": false
}
],
"b3": {
"base1": 6200.0,
"tax1": 1302.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"document_ids": [
63,
64
]
}
},
"control": {
"a4_a5_basic": {
"base": 231300.0,
"return_rows": [
1
]
},
"a4_a5_reduced": {
"base": 0.0,
"return_rows": [
2
]
},
"b2_b3_basic": {
"base": 20700.0,
"return_rows": [
40
]
},
"b2_b3_reduced": {
"base": 0.0,
"return_rows": [
41
]
},
"a1": {
"base": 0.0,
"return_rows": [
25
]
},
"b1_basic": {
"base": 0.0,
"return_rows": [
10
]
},
"b1_reduced": {
"base": 0.0,
"return_rows": [
11
]
},
"a2": {
"base": 28002.5,
"return_rows": [
3,
4
]
}
},
"warnings": []
},
"filed": null,
"supplementary": null,
"checks": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/recap_statement – Souhrnné hlášení za období
Sestaví souhrnné hlášení VIES z vystavených prodejních dokladů v režimu dodání zboží, poskytnutí služby nebo třístranného obchodu do jiného státu EU, seskupených podle státu, DIČ odběratele a kódu plnění. Období se volí stejně jako u vat_return.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
year | dotaz | celé číslo | ne | Rok období, když chybí period; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ne | Měsíc období, když chybí period Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí u čtvrtletního plátce Rozsah od 1 do 4. Příklad 3. |
Pole odpovědi
| Pole | Význam |
|---|---|
report.rows | Řádky: country, vat_id, code (kód plnění), count, value (Kč), document_ids |
report.total_value | Součet hodnot všech řádků |
report.warnings | Upozornění, např. čtvrtletní období u dodání zboží |
filed | Poslední podané souhrnné hlášení za období porovnané s doklady, nebo null: filing_id, filing_type, filed_on, changed, suggested_type (N), added, removed |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Účetní jednotka není registrovaná k DPH |
| 422 | – | Neplatné period, month nebo quarter |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/recap_statement?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/recap_statement?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"report": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"rows": [],
"total_value": 0.0,
"warnings": []
},
"filed": null,
"supplementary": null,
"checks": []
}
/entities/{entity_id}/taxes/income_tax – Výpočet daně z příjmů za rok
Spočítá daň z příjmů za rok year. U OSVČ (kind dpfo) z peněžního deníku nebo účetnictví a daňového profilu: základ daně, slevy, daňové zvýhodnění, sociální a zdravotní pojištění a zálohy na další rok. U právnické osoby (kind dppo) z účetní závěrky za účetní období začínající v roce year: úpravy základu daně včetně rozdílu účetních a daňových odpisů, daň, zálohy a doplatek. Rok bez zákonných sazeb v Saldu (mimo 2024–2026) vrátí 422.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Zdaňovací období (rok); výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
kind | dpfo (OSVČ) nebo dppo (právnická osoba) |
books | Jen dpfo: income, expenses, depreciation a source (peněžní deník nebo účetnictví) |
result | Výpočet: mimo jiné tax, form_rows (řádky přiznání) a warnings; u dpfo také sp, zp, tax_advances a tax_balance, u dppo advances a balance |
profile | Údaje pro přiznání za rok year, ze kterých výpočet vychází (viz GET …/taxes/profile) |
statements_result | Jen dppo: výsledek hospodaření z výkazu zisku a ztráty |
non_deductible | Jen dppo: položky zvyšující základ daně (nedaňové náklady podle účtů, ř. 50 odpisy, ruční úpravy) s řádkem row |
non_taxable | Jen dppo: položky snižující základ daně (ř. 150 daňové odpisy nad účetními, ruční úpravy) s řádkem row |
result.losses | Jen dppo: ztráty z minulých let po letech – year, amount, applied, remaining, last_year, expired |
statements | Jen dppo: účetní závěrka (rozvaha a výkaz zisku a ztráty) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Pro rok nejsou v Saldu zákonné sazby („Pro rok … nejsou k dispozici zákonné sazby“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"kind": "dpfo",
"books": {
"income": 587040.0,
"expenses": 71205.9,
"depreciation": 16998.0,
"asset_disposals": 0.0,
"trip_allowances": 0.0,
"source": "peněžní deník",
"uncategorized": {
"income": 0.0,
"expense": -0.0,
"count": 0,
"codes": []
}
},
"result": {
"year": 2026,
"income": 587040.0,
"expenses": 88203.9,
"expense_method": {
"kind": "actual",
"parts": []
},
"profit": 498836.1,
"employment_income": 0.0,
"tax_base": 498836.1,
"partial_bases_total": 498836.1,
"loss_applied": 0.0,
"deductions": [],
"tax_base_rounded": 498800.0,
"tax_before_credits": 74820.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "64",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"child_benefit": {
"total": 15204.0,
"used_as_credit": 15204.0,
"bonus": 0.0,
"children": [
{
"order": 1,
"months": 12,
"ztpp": false,
"amount": 15204.0
}
]
},
"tax": 28776.0,
"bonus": 0.0,
"tax_withheld": 0.0,
"tax_advances_paid": 0.0,
"tax_balance": 28776.0,
"tax_advances": {
"last_known_tax": 28776.0,
"frequency": "none",
"amount": 0.0,
"period": {
"from": "2027-05-04",
"to": "2028-05-02"
},
"schedule": [],
"basis": "§ 38a ZDP"
},
"sp": {
"participates": true,
"decisive_amount": null,
"assessment_base": 274360.0,
"minimum_base": 205668.0,
"maximum_base": 2350416.0,
"applied_base": 274360.0,
"rate": 0.292,
"premium": 80114.0,
"discount": 0.0,
"premium_after_discount": 80114.0,
"advances_paid": 0.0,
"balance": 80114.0,
"monthly_advance_next": 6677.0,
"sickness": null,
"basis": "§ 5b, § 7 odst. 1 písm. e) bod 1, § 14 a § 15a zákona č. 589/1992 Sb."
},
"zp": {
"minimum_applies": true,
"assessment_base": 249418.05,
"minimum_base": 293802.0,
"applied_base": 293802.0,
"rate": 0.135,
"premium": 39664.0,
"advances_paid": 0.0,
"balance": 39664.0,
"monthly_advance_next": 3488.0,
"basis": "§ 2, § 3a a § 8 zákona č. 592/1992 Sb."
},
"total_levies": 148554.0,
"net_income": 350282.1,
"effective_rate": 0.2531,
"form_rows": {
"37": 498836.1,
"41": 498836.1,
"42": 498836.1,
"45": 498836.1,
"55": 498836.1,
"56": 498800.0,
"57": 74820.0,
"58": 74820.0,
"60": 74820.0,
"70": 30840.0,
"71": 43980.0,
"72": 15204.0,
"73": 15204.0,
"74": 28776.0,
"75": 28776.0,
"77": 28776.0,
"91": 28776.0,
"64": 30840.0,
"101": 587040.0,
"102": 88203.9,
"104": 498836.1,
"113": 498836.1
},
"warnings": [
"Minimální a nejvyšší nové zálohy vycházejí z vyhlášené průměrné mzdy pro rok 2027 (51 663 Kč); ostatní sazby roku 2027 zatím nejsou vyhlášené.",
"Minimální zálohy hlavní činnosti za leden až červen 2026 činily 5 720 Kč (40 % průměrné mzdy). Zákon č. 90/2026 Sb. snížil minimum od 1. 7. 2026 na 35 % (5 005 Kč) a přehled za rok 2026 se počítá s minimem 35 % za celý rok. Kdo měl platit minimální zálohu, může do 31. 12. 2026 písemně požádat o vrácení rozdílu, jinak se přeplatek zohlední v přehledu; nedoplatek do výše rozdílu a penále z něj zanikly, byla-li zaplacena aspoň nová výše zálohy (čl. II body 2, 3 a 5)."
],
"other_income": {
"capital": 0.0,
"rental": {
"income": 0.0,
"expenses": 0.0,
"flat": false,
"base": 0.0,
"shared": false
},
"other": [],
"other_base": 0.0,
"loss": 0.0
}
},
"profile": {
"birth_number": "8001010006",
"ossz_code": "110",
"cssz_variable_symbol": "12345678",
"health_insurer": "111",
"main_activity": true,
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
]
},
"expense_method": "actual",
"flat_tax": null
}
/entities/{entity_id}/taxes/regime – Srovnání daňových režimů OSVČ za rok
Porovná za rok year odvody OSVČ (daň, sociální a zdravotní pojištění) při skutečných výdajích, výdajových paušálech a paušální dani a doporučí nejvýhodnější variantu, na kterou má nárok. Vychází z příjmů a výdajů v knihách a z daňového profilu. U právnické osoby se volání neodmítne, výsledek má ale smysl jen u OSVČ.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Rok srovnání; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
year | Rok srovnání |
income | Příjmy za rok |
actual_expenses | Skutečné výdaje včetně daňových odpisů |
income_kind | Druh příjmů pro výdajový paušál (např. trade) |
current | Klíč současného režimu: actual_expenses, flat_rate_80, flat_rate_60, flat_rate_40, flat_rate_30 (výdajový paušál v procentech), flat_rate_mixed nebo flat_tax |
recommended | Klíč doporučeného režimu (stejné hodnoty jako current) |
savings | Úspora doporučeného režimu proti současnému |
options | Všechny varianty s odvody, eligible a savings_vs_current |
summary | Slovní shrnutí |
warnings | Upozornění |
books | Příjmy a výdaje z knih, ze kterých srovnání vychází |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Pro rok nejsou v Saldu zákonné sazby |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/regime?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/regime?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"income": 587040.0,
"actual_expenses": 88203.9,
"income_kind": "trade",
"current": "actual_expenses",
"recommended": "flat_rate_60",
"savings": 59658.0,
"options": [
{
"key": "flat_rate_60",
"label": "Výdajový paušál 60 %",
"eligible": true,
"rank": 1,
"basis": "§ 7 odst. 7 písm. b) ZDP",
"expenses": 352224.0,
"profit": 234816.0,
"tax": 0.0,
"bonus": 10824.0,
"sp": 60056.0,
"zp": 39664.0,
"sickness": 0.0,
"total_levies": 88896.0,
"net_income": 409940.1,
"effective_rate": 0.1514,
"reasons": [],
"notes": [
"Minimální a nejvyšší nové zálohy vycházejí z vyhlášené průměrné mzdy pro rok 2027 (51 663 Kč); ostatní sazby roku 2027 zatím nejsou vyhlášené.",
"Minimální zálohy hlavní činnosti za leden až červen 2026 činily 5 720 Kč (40 % průměrné mzdy). Zákon č. 90/2026 Sb. snížil minimum od 1. 7. 2026 na 35 % (5 005 Kč) a přehled za rok 2026 se počítá s minimem 35 % za celý rok. Kdo měl platit minimální zálohu, může do 31. 12. 2026 písemně požádat o vrácení rozdílu, jinak se přeplatek zohlední v přehledu; nedoplatek do výše rozdílu a penále z něj zanikly, byla-li zaplacena aspoň nová výše zálohy (čl. II body 2, 3 a 5)."
],
"savings_vs_current": 59658.0
},
{
"key": "flat_tax",
"label": "Paušální daň – 1. pásmo",
"eligible": true,
"rank": 2,
"basis": "§ 2a, § 7a a § 38lk ZDP",
"band": 1,
"monthly": 9162.0,
"tax": 1200.0,
"bonus": 0.0,
"sp": 69072.0,
"zp": 39672.0,
"sickness": 0.0,
"total_levies": 109944.0,
"net_income": 388892.1,
"effective_rate": 0.1873,
"reasons": [
"Na rok 2026 se vstup oznamoval do 12. 1. 2026 (u nové činnosti nejpozději v den jejího zahájení, § 38lc odst. 1 a 2 ZDP). Pokud jste ho oznámili, platíte paušální daň; jinak ji můžete zvolit nejdříve od roku 2027 – oznámení podejte do 11. 1. 2027."
],
"notes": [
"Paušální daň zahrnuje daň, sociální i zdravotní pojištění; je-li vaše daň rovna paušální dani, nepodáváte daňové přiznání ani přehledy pro ČSSZ a zdravotní pojišťovnu (§ 38lh ZDP, § 15 odst. 1 zákona č. 589/1992 Sb., § 24 odst. 2 zákona č. 592/1992 Sb.).",
"V paušálním režimu nelze uplatnit slevy na dani, daňové zvýhodnění na děti, daňový bonus ani odpočty od základu daně."
],
"available": false,
"savings_vs_current": 38610.0
}
],
"summary": "Nejvýhodnější je výdajový paušál 60 %: odvody 88 896 Kč ročně, o 59 658 Kč méně než současný režim (skutečné výdaje v daňové evidenci).",
"warnings": [],
"flat_tax_entry": {
"open": false,
"deadline": "2026-01-12",
"closed_year": false,
"next_year": 2027,
"next_deadline": "2027-01-11",
"basis": "§ 38lc odst. 1 a 2 ZDP"
},
"tip": null,
"books": {
"income": 587040.0,
"expenses": 71205.9,
"depreciation": 16998.0,
"asset_disposals": 0.0,
"trip_allowances": 0.0,
"source": "peněžní deník",
"uncategorized": {
"income": 0.0,
"expense": -0.0,
"count": 0,
"codes": []
}
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/filings_check – Připravenost ročních podání za rok
Zkusí za rok year sestavit přiznání k dani z příjmů (DPFDP7 u OSVČ, DPPDP9 u právnické osoby) a u OSVČ i přehled pro ČSSZ (OSVC25) a pro zdravotní pojišťovnu (formát v6). U každého formuláře vrátí, co chybí a kde to doplnit, upozornění, souhrn částek, lhůtu podle způsobu podání, adresáta a už uložená podání. Mezi problémy se objeví i omezení Salda: DPFO jen za roky 2024–2025, přehledy jen za rok 2025 a DPPO za celé zdaňovací období 2026 zatím ne. Nic neukládá ani nepodává.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Rok podání; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2025. |
Pole odpovědi
| Pole | Význam |
|---|---|
year | Rok |
forms | Formuláře: kind (dpfo, dppo, prehled_sp, prehled_zp), title, form, ready, problems, warnings, summary, deadline, recipient, filings |
forms[].problems | message a fix – kde údaj doplnit: settings (nastavení firmy), profile (daňový profil), books (účetnictví) nebo null; u přehledů i field |
forms[].deadline | date, mode, label a options – lhůty pro jednotlivé způsoby podání, posunuté na pracovní den |
forms[].filings | Uložená podání tohoto druhu za rok |
options | Jen OSVČ: seznam správ sociálního zabezpečení a zdravotních pojišťoven; jinak prázdný objekt |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Pro rok nejsou v Saldu zákonné sazby |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
Rok 2025 je poslední, za který Saldo sestaví všechny tři formuláře OSVČ.
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/filings_check?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/filings_check?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2025,
"forms": [
{
"kind": "dpfo",
"title": "Daňové přiznání",
"form": "DPFDP7",
"ready": true,
"unsupported": false,
"problems": [],
"warnings": [
"Daňový bonus nenáleží: příjmy podle § 6 a § 7 nedosáhly 6násobku minimální mzdy (124 800 Kč, § 35c ZDP).",
"Minimální záloha hlavní činnosti činila v roce 2026 do června 5 720 Kč, od července 5 005 Kč (čl. I a čl. II bod 1 zákona č. 90/2026 Sb.)."
],
"summary": [
{
"label": "Daň",
"value": 0.0
},
{
"label": "Doplatek daně",
"value": 0.0
}
],
"deadline": {
"date": "2026-05-04",
"mode": "electronic",
"label": "elektronicky",
"options": [
{
"mode": "paper",
"label": "do 1. dubna",
"date": "2026-04-01"
},
{
"mode": "electronic",
"label": "elektronicky",
"date": "2026-05-04"
}
]
},
"recipient": {
"name": "Finanční správa – EPO",
"portal": "https://mojedane.gov.cz/",
"channel": "epo",
"office": "Finanční úřad pro hlavní město Prahu, Územní pracoviště pro Prahu 2"
},
"filings": []
},
{
"kind": "prehled_sp",
"title": "Přehled pro ČSSZ",
"form": "OSVC25",
"ready": false,
"unsupported": false,
"problems": [
{
"message": "Chybí zaplacené zálohy na sociální pojištění za rok 2025; při hlavní činnosti se platí povinně. Zadejte je, i když byly 0 Kč.",
"fix": "profile",
"field": "a_sp"
}
],
"warnings": [],
"summary": [],
"deadline": {
"date": "2026-05-04",
"mode": "paper",
"label": "přiznání podané do 1. dubna",
"options": [
{
"mode": "paper",
"label": "přiznání podané do 1. dubna",
"date": "2026-05-04"
},
{
"mode": "electronic",
"label": "přiznání podané elektronicky po 1. dubnu",
"date": "2026-06-04"
}
]
},
"recipient": {
"name": "Česká správa sociálního zabezpečení – e-Podání",
"databox": "5ffu6xk",
"portal": "https://eportal.cssz.cz/web/portal/-/tiskopisy/osvc-2025",
"office": {
"code": "110",
"name": "PSSZ Praha 10"
}
},
"filings": []
}
],
"options": {
"offices": [
{
"code": "110",
"name": "PSSZ Praha 10"
},
{
"code": "111",
"name": "PSSZ Praha 1"
}
],
"insurers": [
{
"code": "111",
"name": "Všeobecná zdravotní pojišťovna ČR",
"databox": "i48ae3q"
},
{
"code": "201",
"name": "Vojenská zdravotní pojišťovna ČR",
"databox": "p3aaext"
}
]
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/depreciation – Daňové odpisy za rok
Vrátí součet daňově uznatelných odpisů za rok year z veškerého odpisovaného majetku, který má daňovou odpisovou skupinu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Rok; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
year | Rok |
amount | Daňové odpisy celkem (Kč) |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/depreciation?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/depreciation?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"amount": 154798.0
}
/entities/{entity_id}/taxes/vat_book – Kniha DPH – co který doklad přispěl do kterého řádku přiznání
Za období (jako u vat_return) vrátí pro každý doklad a řádek přiznání jeho částky před zaokrouhlením řádku na celé koruny (base, tax, full, reduced nebo value podle řádku), údaje dokladu a oddíl kontrolního hlášení, do kterého doklad patří. Ruční úpravy přiznání v knize nejsou. S format=csv vrátí soubor CSV (středník, UTF-8 s BOM) kniha-dph-{období}.csv a zapíše událost tax.vat_book.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn Příklad 2026-08. |
row | dotaz | celé číslo | ne | Jen jeden řádek přiznání Příklad 40. |
format | dotaz | text | ne | csv vrátí soubor místo JSON Hodnoty: json, csv. Příklad json. |
Pole odpovědi
| Pole | Význam |
|---|---|
rows[] | { document_id, row, base, tax, full, reduced, value, number, original_number, kind, kind_label, partner_name, partner_dic, taxable_date, vat_date, vat_mode, kh_section } |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Účetní jednotka není registrovaná k DPH |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_book?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_book?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"rows": [
{
"document_id": 19,
"row": 1,
"base": 96000.0,
"tax": 20160.0,
"number": "FV20260019",
"original_number": null,
"kind": "invoice_out",
"kind_label": "Faktura vydaná",
"partner_name": "Jana Veselá – Bistro Na Rohu",
"partner_dic": null,
"taxable_date": "2026-08-04",
"vat_date": "2026-08-04",
"vat_mode": "domestic",
"kh_section": "A.5"
},
{
"document_id": 20,
"row": 1,
"base": 115500.0,
"tax": 24255.0,
"number": "FV20260020",
"original_number": null,
"kind": "invoice_out",
"kind_label": "Faktura vydaná",
"partner_name": "Nordwood Studio s.r.o.",
"partner_dic": "CZ90000013",
"taxable_date": "2026-08-15",
"vat_date": "2026-08-15",
"vat_mode": "domestic",
"kh_section": "A.4"
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/registration_deduction – Přijatá plnění pro odpočet daně při registraci (§ 79)
Vypíše přijaté doklady s DPH (faktury, výdajové pokladní doklady, dobropisy) s DUZP za 12 měsíců před datem registrace a období, do jehož přiznání odpočet patří (ř. 45). Které z nich plátce ke dni registrace ještě má a používá, a krácení u dlouhodobého majetku (§ 79 odst. 4 ZDPH) posoudí uživatel; odpočet zapíše ruční úpravou ř. 45 (POST …/vat_adjustments).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
date | dotaz | datum | ne | Den registrace; výchozí dnes Příklad 2026-07-01. |
Pole odpovědi
| Pole | Význam |
|---|---|
date | Den registrace |
from | Začátek 12 měsíců před registrací |
period | Období přiznání, kam odpočet patří (podle historie registrace) |
rows[] | { document_id, number, original_number, partner_name, taxable_date, vat, asset } |
total | Součet daně všech dokladů |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/registration_deduction?date=2026-09-01"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/registration_deduction?date=2026-09-01', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"date": "2026-09-01",
"from": "2025-09-01",
"period": {
"year": 2026,
"month": 9,
"quarter": null,
"from": "2026-09-01",
"to": "2026-09-30",
"label": "září 2026",
"deadline": "2026-10-26",
"key": "2026-09"
},
"rows": [
{
"document_id": 30,
"number": "FP20260001",
"original_number": "2026013190",
"partner_name": "Coworking Karlín s.r.o.",
"taxable_date": "2026-01-02",
"vat": 3045.0,
"asset": false
},
{
"document_id": 31,
"number": "FP20260002",
"original_number": "2026011322",
"partner_name": "Serverovna Holešovice s.r.o.",
"taxable_date": "2026-01-05",
"vat": 819.0,
"asset": false
}
],
"total": 198876.3
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/taxes/vat_coefficient – Koeficient pro krácený odpočet DPH spočítaný z přiznání roku
Sestaví přiznání k DPH všech období roku year (bez vypořádání) a spočítá z nich koeficient podle § 76 odst. 4 ZDPH: plnění s nárokem na odpočet (ř. 1 a 2 základ, ř. 20–26 a 31) proti nim a plněním osvobozeným bez nároku (ř. 50). Vrátí i krácenou daň roku a odpočet uplatněný na ř. 52; z nich Saldo v posledním období roku samo vypočte vypořádání na ř. 53, pokud ho nezadáte ručně. Výpočet z dokladů nezohlední plnění, která v Saldu nejsou, a ř. 51; před použitím ho zkontrolujte.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Rok; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
year | Rok |
with_credit | Plnění s nárokem na odpočet (Kč) |
without_credit | Plnění osvobozená bez nároku na odpočet (ř. 50, Kč) |
computed | Vypočtený koeficient v % na dvě desetinná místa, nebo null bez plnění |
coefficient | Koeficient zaokrouhlený nahoru na celá %, od 95 % 100 (§ 76 odst. 3 a 5) |
reduced_tax | Daň u přijatých plnění s kráceným odpočtem za rok (součet ř. 46 krácený) |
claimed | Odpočet uplatněný na ř. 52 za rok |
setting | Koeficient zadaný v nastavení firmy |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_coefficient?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/vat_coefficient?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"with_credit": 2008390.0,
"without_credit": 0.0,
"computed": 100.0,
"coefficient": 100.0,
"reduced_tax": 0.0,
"claimed": 0.0,
"setting": null
}
/entities/{entity_id}/taxes/payments – Platby finančnímu úřadu, ČSSZ a zdravotním pojišťovnám
Vrátí platby se splatností v měsících from–to: DPH nebo nadměrný odpočet, zálohy na daň z příjmů, paušální daň, zálohy OSVČ na sociální a zdravotní pojištění, nemocenské pojištění, odvody za zaměstnance, srážkovou a silniční daň. DPH období s podaným přiznáním (s uloženými řádky) má částku z posledního podaného řádného nebo opravného přiznání a poznámku, když se od podání změnily doklady; dodatečné přiznání, které daň zvýšilo, je samostatná položka vat-<období>-d se splatností do konce měsíce po dni zjištění (§ 141 daňového řádu). U každé platby účet, IBAN, symboly, termín posunutý na pracovní den, QR Platbu (SPAYD) a stav. Za zaplacenou se platba považuje, když mezi odchozími bankovními pohyby v Kč je pohyb se správnou částkou a shodným účtem nebo variabilním symbolem, s datem od začátku sledovaného období do 60 dnů po splatnosti (u silniční daně bez částky musí sedět účet i symbol). Pohyb patří k měsíci ze zprávy pro příjemce, jinak k položce se splatností nejblíž dni platby; když je ta položka už zaplacená nebo pohyb patří ke staršímu měsíci, žádné jiné položce se nepřiřadí, takže stav nezávisí na zvoleném rozsahu. Chybějící údaje vrátí v missing, u OSVČ i s návrhem nalezeným v jejích platbách. Odvody za zaměstnance vidí každý člen se stejnými částkami (jsou i v účetních knihách); jména zaměstnanců v poznámce ke zdravotnímu pojištění jen vlastník, účetní a člen s přístupem ke mzdám.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
from | dotaz | text | ne | První měsíc ve tvaru YYYY-MM (nebo datum YYYY-MM-DD; použije se jeho měsíc); výchozí předchozí měsíc Příklad 2026-08. |
to | dotaz | text | ne | Poslední měsíc ve tvaru YYYY-MM (nebo datum YYYY-MM-DD; použije se konec jeho měsíce); výchozí měsíc o dva po aktuálním Příklad 2026-11. |
Pole odpovědi
| Pole | Význam |
|---|---|
from | První den rozsahu |
to | Poslední den rozsahu |
today | Dnešní datum, ke kterému je stav plateb spočten |
next | Klíč nejbližší nezaplacené platby (přednostně po splatnosti) |
summary | Počet a součet plateb podle stavu due, overdue, paid, refund a počet odhadů (estimate) |
items | Platby: key, kind, authority (fu, cssz, zp), title, period, due_date, statutory_date, shifted, shift_basis, recipient, account, iban, bic, amount, currency, variable_symbol, constant_symbol, specific_symbol, message, basis, source, status, paid, accepts a reduced (další částky, které se také uznají jako úhrada), ready, explanation, spayd, estimate, estimate_note, missing, notes |
items[].status | paid (spárováno s pohybem), due, overdue, nothing (nic k platbě), refund (vratka nadměrného odpočtu) |
missing | Chybějící údaje: field, label, fix, where, items a suggestion (value, display, count, last_on) nalezený v bankovních pohybech |
notes | Poznámky k výpočtu |
options | Číselníky správ sociálního zabezpečení a pojišťoven a zvolené hodnoty |
sources | Zdroje čísel účtů a symbolů |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Konec rozsahu je před začátkem („Konec období musí být po jeho začátku“) |
| 422 | – | Rozsah je delší než 24 měsíců |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Limity
- Nejvýše 24 měsíců v jednom dotazu.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/payments?from=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/payments?from=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"from": "2026-08-01",
"to": "2026-11-30",
"today": "2026-09-28",
"next": "social-2026-09",
"summary": {
"due": {
"count": 5,
"total": 21627.0
},
"overdue": {
"count": 0,
"total": 0.0
},
"paid": {
"count": 3,
"total": 11617.0
},
"refund": {
"count": 0,
"total": 0.0
},
"estimate": 0
},
"items": [
{
"key": "health-2026-07",
"kind": "health_advance",
"authority": "zp",
"title": "Záloha na zdravotní pojištění",
"period": {
"key": "2026-07",
"label": "červenec 2026",
"phrase": "za červenec 2026"
},
"due_date": "2026-08-10",
"statutory_date": "2026-08-08",
"shifted": true,
"recipient": {
"name": "Všeobecná zdravotní pojišťovna ČR",
"short": "VZP",
"code": "111"
},
"account": "1112001221/0710",
"iban": "CZ7407100000001112001221",
"bic": "CNBACZPP",
"amount": 3306.0,
"currency": "CZK",
"variable_symbol": "8001010006",
"constant_symbol": "558",
"specific_symbol": null,
"message": "Záloha ZP červenec 2026",
"basis": "§ 7 odst. 2 zákona č. 592/1992 Sb.: záloha je splatná od prvního dne měsíce, za který se platí, do osmého dne následujícího měsíce; Pojistné samoplátců (OSVČ, OBZP) na účet VZP podle kraje; VS zpravidla rodné číslo, případně číslo přidělené pojišťovnou; KS 558 pro převodní příkaz",
"source": "https://www.vzp.cz/platci/cisla-uctu",
"shift_basis": "Připadne-li poslední den splatnosti na sobotu, neděli nebo svátek, je posledním dnem nejbližší pracovní den (metodika VZP 2.2 a 2.4, RBP)",
"missing": [],
"notes": [
"Minimální záloha. Pokud vám pojišťovna podle přehledu stanovila vyšší zálohu, platíte ji.",
"VZP má pro každý kraj jiný účet – Saldo vybralo účet podle vašeho finančního úřadu (Finanční úřad pro hlavní město Prahu). Pokud jste u pobočky v jiném kraji, ověřte účet na https://www.vzp.cz/platci/cisla-uctu."
],
"estimate": false,
"estimate_note": null,
"status": "paid",
"accepts": [],
"reduced": null,
"paid": {
"on": "2026-08-07",
"amount": 3306.0,
"transaction_id": 168,
"bank_account_id": 4,
"late": false,
"partial": false,
"manual": false
},
"ready": true,
"explanation": "Záloha na zdravotní pojištění za červenec 2026 – splatné do 10. 8. (8. 8. je sobota)",
"spayd": "SPD*1.0*ACC:CZ7407100000001112001221*AM:3306.00*CC:CZK*RN:Vseobecna zdravotni pojistovna CR*MSG:Zaloha ZP cervenec 2026*X-VS:8001010006*X-KS:558"
},
{
"key": "social-2026-08",
"kind": "social_advance",
"authority": "cssz",
"title": "Záloha na sociální pojištění",
"period": {
"key": "2026-08",
"label": "srpen 2026",
"phrase": "za srpen 2026"
},
"due_date": "2026-08-31",
"statutory_date": "2026-08-31",
"shifted": false,
"recipient": {
"name": "PSSZ Praha 10",
"short": "PSSZ Praha 10",
"code": "110"
},
"account": "1011-7921101/0710",
"iban": "CZ0707100010110007921101",
"bic": "CNBACZPP",
"amount": 5005.0,
"currency": "CZK",
"variable_symbol": "12345678",
"constant_symbol": null,
"specific_symbol": null,
"message": "Záloha SP srpen 2026",
"basis": "§ 14a odst. 1 zákona č. 589/1992 Sb.: záloha je splatná od prvního do posledního dne kalendářního měsíce, za který se platí; záloha za měsíc zahájení činnosti je splatná do konce následujícího měsíce",
"source": "https://www.cssz.gov.cz/web/cz/kontakty/region/ossz/praha",
"shift_basis": null,
"missing": [],
"notes": [
"Minimální záloha hlavní činnosti. Pokud vám správa podle přehledu stanovila vyšší zálohu, platíte ji.",
"ČSSZ doporučuje zadat příkaz nejpozději 26. dne měsíce; za den platby se považuje den připsání na účet správy"
],
"estimate": false,
"estimate_note": null,
"status": "paid",
"accepts": [],
"reduced": null,
"paid": {
"on": "2026-08-28",
"amount": 5005.0,
"transaction_id": 169,
"bank_account_id": 4,
"late": false,
"partial": false,
"manual": false
},
"ready": true,
"explanation": "Záloha na sociální pojištění za srpen 2026 – splatné do 31. 8.",
"spayd": "SPD*1.0*ACC:CZ0707100010110007921101*AM:5005.00*CC:CZK*RN:PSSZ Praha 10*MSG:Zaloha SP srpen 2026*X-VS:12345678"
}
],
"missing": [],
"notes": [
"Zálohy na daň z příjmů: Saldo nemá účetnictví za rok 2025, poslední známou daň proto nezná. Přesáhla-li 30 000 Kč, platíte zálohy (§ 38a ZDP) na účet 721-77628031/0710."
],
"options": {
"offices": [
{
"code": "110",
"name": "PSSZ Praha 10"
},
{
"code": "111",
"name": "PSSZ Praha 1"
}
],
"insurers": [
{
"code": "111",
"name": "Všeobecná zdravotní pojišťovna ČR"
},
{
"code": "201",
"name": "Vojenská zdravotní pojišťovna ČR"
}
],
"ossz_code": "110",
"employer_ossz_code": null,
"health_insurer": "111",
"employer_variable_symbol": null
},
"sources": {
"offices": "https://financnisprava.gov.cz/assets/cs/prilohy/d-placeni-dani/Priloha_1_bankovni_ucty_fu_sfu_01012026.pdf",
"prefixes": "https://financnisprava.gov.cz/assets/cs/prilohy/d-placeni-dani/Priloha_2_pbu_fu_mimo_sfu_01012026.pdf",
"symbols": "https://financnisprava.gov.cz/assets/cs/prilohy/d-placeni-dani/Jak_spravne_zaplatit_dan_FU_v_roce_2026.pdf",
"cssz": "https://www.cssz.gov.cz/web/cz/kontakty/region/ossz",
"health_insurers": {
"111": "https://www.vzp.cz/platci/cisla-uctu",
"201": "https://www.vozp.cz/bankovni-spojeni",
"205": "https://www.cpzp.cz/cl
…
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET XML podání pro EPO nebo přehled OSVČ ke stažení
/entities/{entity_id}/taxes/{report}/xml
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Sestaví a vrátí soubor XML s podáním: přiznání k DPH, kontrolní a souhrnné hlášení a přiznání k dani z příjmů ve formátu EPO (portál Moje daně), přehledy OSVČ ve formátech ČSSZ a zdravotních pojišťoven. Soubor se jen vrátí ke stažení: Saldo ho nikam neposílá a jako podání ho neukládá (k tomu slouží POST /filings a POST …/taxes/{report}/filing). Na rozdíl od GET …/taxes/vat_return operace nekontroluje registraci k DPH; u firmy neregistrované k DPH vznikne u dph, kh a sh podání bez dokladů.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
report | cesta | text | ano | Druh podání (viz varianty) Hodnoty: dph, kh, sh, income_tax, prehled_sp, prehled_zp. Příklad dph. |
year | dotaz | celé číslo | ne | Rok – u DPH, když chybí period; u daně z příjmů a přehledů zdaňovací období; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
filing_type | dotaz | text | ne | Druh podání: B řádné, O opravné, D dodatečné, E opravné dodatečné, N následné. Který druh formulář zná, se liší podle varianty (viz varianty); u DPH, KH, SH a daně z příjmů (jen B, O, D, E) vrátí jiný druh 422. Hodnoty: B, O, D, E, N. Výchozí B. Příklad B. |
date | dotaz | datum | ne | Datum podání (vyplnění) uvedené v XML; výchozí dnešní datum Příklad 2026-09-25. |
reasons_found_on | dotaz | datum | ne | Den zjištění důvodů pro dodatečné či následné podání (u přehledu ČSSZ datum zjištění nové výše vyměřovacího základu u opravného přehledu) Příklad 2026-09-10. |
reasons | dotaz | text | ne | Jen dodatečné přiznání k DPH (D, E) – důvody pro jeho podání (§ 141 odst. 6 daňového řádu); v XML jako textová příloha oddílu D (VetaR), řádky po nejvýše 72 znacích Příklad Dodavatel doručil fakturu za srpen až po podání přiznání.. |
Odpověď
200 application/xml Soubor XML (Content-Disposition attachment). Název: {druh}-{DIČ nebo IČO}-{období}.xml u DPH, KH, SH a daně z příjmů (druh dph, kh, sh, dpfo, dppo), prehled-osvc-{rok}-cssz.xml a prehled-osvc-{rok}-{pojišťovna}.xml u přehledů (u opravného s příponou -opravny).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Nelze sestavit XML (chybí nebo je neplatný údaj firmy či dokladu, chybí den zjištění důvodů u dodatečného podání, rok není podporovaný…); error obsahuje důvod česky |
| 422 | – | Neznámá hodnota report („Neznámý typ podání“) |
| 422 | – | XML přiznání nebo hlášení (DPH, KH, SH, DPFO, DPPO) neprojde oficiálním XSD formuláře („XML neodpovídá oficiální struktuře formuláře …“ s prvními třemi chybami); Saldo takové XML nevydá |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Po úspěšném sestavení zapíše do historie firmy událost tax.xml („Vytvořeno XML …“), a to i při GET, u člena jen pro čtení a u API klíče jen pro čtení. Nic jiného neukládá a nic nikam neposílá.
/entities/{entity_id}/taxes/dph/xml – Přiznání k DPH (DPHDP3) jako XML
XML přiznání k DPH ve formátu EPO DPHDP3 verze 03.01 za období zvolené jako u GET …/taxes/vat_return. filing_type: B řádné, O opravné, D dodatečné, E opravné dodatečné. Řádné a opravné nesou celé řádky. Dodatečné (D) nese jen rozdíly každého řádku proti poslednímu podanému přiznání za období (podání ve stavu filed, nejnovější podle filed_on – řádné, opravné i dřívější dodatečné), ř. 64 a 65 nevyplní a na ř. 66 uvede rozdíl oproti poslední známé dani (rozdíl ř. 62 − rozdíl ř. 63). Opravné dodatečné (E) počítá rozdíly od stejného přiznání jako dodatečné, které nahrazuje. U D a E je povinný reasons_found_on, důvody (reasons) se zapíší jako textová příloha.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
month | dotaz | celé číslo | ne | Měsíc, když chybí period Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí čtvrtletního plátce, když chybí period i month Rozsah od 1 do 4. Příklad 3. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Dodatečné podání bez reasons_found_on („Dodatečné či následné podání vyžaduje den zjištění důvodů pro jeho podání“) |
| 422 | – | Dodatečné přiznání, ale za období není v Saldu podané přiznání („… označte uložené přiznání jako podané“), opravné dodatečné bez podaného dodatečného, nebo se oproti poslední známé dani nic nezměnilo |
| 422 | – | filing_type N nebo S („Přiznání k DPH se podává jako řádné, opravné, dodatečné nebo opravné dodatečné“) |
| 422 | – | Neplatné DIČ, finanční úřad, územní pracoviště nebo kód CZ-NACE firmy |
| 422 | – | Neplatné period, month nebo quarter |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/dph/xml?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/dph/xml?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<Pisemnost nazevSW="Saldo" verzeSW="1.0">
<DPHDP3 verzePis="03.01">
<VetaD dokument="DP3" k_uladis="DPH" typ_platce="P" dapdph_forma="B" rok="2026" mesic="8" d_poddp="28.09.2026" c_okec="621000" trans="A"/>
<VetaP c_ufo="451" c_pracufo="2001" dic="99999994" typ_ds="P" zkrobchjm="Ukázková firma s.r.o." ulice="Na Příkopě" c_pop="859" c_orient="22" naz_obce="Praha" psc="11000" stat="ČESKÁ REPUBLIKA" email="demo@example.cz" c_telef="+420777000000" opr_jmeno="Jana" opr_prijmeni="Ukázková" opr_postaveni="jednatelka" sest_jmeno="Jana" sest_prijmeni="Ukázková"/>
<Veta1 obrat23="231300" dan23="48573" p_sl23_e="28003" dan_psl23_e="5881"/>
<Veta4 pln23="20700" odp_tuz23_nar="4347" nar_zdp23="28003" od_zdp23="5881" odp_sum_nar="10228"/>
<Veta6 dan_zocelk="54454" odp_zocelk="10228" dano_da="44226"/>
</DPHDP3>
</Pisemnost>
/entities/{entity_id}/taxes/kh/xml – Kontrolní hlášení (DPHKH1) jako XML
XML kontrolního hlášení ve formátu EPO DPHKH1 verze 03.01. filing_type: B řádné, O opravné, N následné, E opravné následné; D vrátí 422. Následné hlášení nese všechny řádky, ne rozdíly (Pokyny k vyplnění KH). U N a E je povinný reasons_found_on. Identifikované osobě a právnické osobě se čtvrtletním obdobím vrátí 422 – na rozdíl od GET …/taxes/control_statement bez pole code.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
month | dotaz | celé číslo | ne | Měsíc, když chybí period Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí, když chybí period i month (jen fyzická osoba) Rozsah od 1 do 4. Příklad 3. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Identifikovaná osoba („Identifikovaná osoba kontrolní hlášení nepodává (§ 101c ZDPH).“) |
| 422 | – | Právnická osoba a čtvrtletní období („Právnická osoba podává kontrolní hlášení za kalendářní měsíc (§ 101e odst. 1 ZDPH)“) |
| 422 | – | Dokladu v hlášení chybí DIČ partnera, evidenční číslo nebo kód předmětu plnění |
| 422 | – | Neplatné period, month nebo quarter |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/kh/xml?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/kh/xml?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<Pisemnost nazevSW="Saldo" verzeSW="1.0">
<DPHKH1 verzePis="03.01">
<VetaD dokument="KH1" k_uladis="DPH" rok="2026" mesic="8" d_poddp="28.09.2026" khdph_forma="B"/>
<VetaP c_ufo="451" c_pracufo="2001" dic="99999994" typ_ds="P" zkrobchjm="Ukázková firma s.r.o." ulice="Na Příkopě" c_pop="859" c_orient="22" naz_obce="Praha" psc="11000" stat="ČESKÁ REPUBLIKA" email="demo@example.cz" c_telef="+420777000000" opr_jmeno="Jana" opr_prijmeni="Ukázková" opr_postaveni="jednatelka" sest_jmeno="Jana" sest_prijmeni="Ukázková"/>
<VetaA2 k_stat="DE" vatid_dod="998877665" c_evid_dd="2026083526" dppd="07.08.2026" zakl_dane1="28002.50" dan1="5880.53"/>
<VetaA4 dic_odb="90000013" c_evid_dd="FV20260020" dppd="15.08.2026" zakl_dane1="115500.00" dan1="24255.00" kod_rezim_pl="0" zdph_44="N"/>
<VetaA4 dic_odb="90000013" c_evid_dd="FV20260026" dppd="31.08.2026" zakl_dane1="19800.00" dan1="4158.00" kod_rezim_pl="0" zdph_44="N"/>
<VetaA5 zakl_dane1="96000.00" dan1="20160.00"/>
<VetaB2 dic_dod="90000056" c_evid_dd="2026085713" dppd="02.08.2026" zakl_dane1="14500.00" dan1="3045.00" pomer="N" zdph_44="N"/>
<VetaB3 zakl_dane1="6200.00" dan1="1302.00"/>
<VetaC obrat23="231300.00" pln23="20700.00" celk_zd_a2="28002.50"/>
</DPHKH1>
</Pisemnost>
/entities/{entity_id}/taxes/sh/xml – Souhrnné hlášení (DPHSHV) jako XML
XML souhrnného hlášení ve formátu EPO DPHSHV verze 02.01. filing_type B vytvoří řádné hlášení (R), N následné (N); jiný druh vrátí 422. Následné hlášení nese jen změny proti poslednímu podanému souhrnnému hlášení za období: řádek, který zmizel nebo se změnil, jako storno řádek (k_storno A, s původními údaji) a nový nebo opravený řádek se správnými údaji. Den zjištění důvodů se nevyžaduje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
period | dotaz | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. Příklad 2026-08. |
month | dotaz | celé číslo | ne | Měsíc, když chybí period Rozsah od 1 do 12. Příklad 8. |
quarter | dotaz | celé číslo | ne | Čtvrtletí, když chybí period i month Rozsah od 1 do 4. Příklad 3. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | filing_type jiný než B a N („Souhrnné hlášení se podává jako řádné nebo následné“) |
| 422 | – | Následné hlášení bez podaného souhrnného hlášení za období, nebo beze změny proti němu |
| 422 | – | Odběratel nemá platné DIČ („Souhrnné hlášení – neplatné DIČ pořizovatele …“) |
| 422 | – | Neplatné period, month nebo quarter |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/taxes/sh/xml?period=2026-08"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/sh/xml?period=2026-08', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<Pisemnost nazevSW="Saldo" verzeSW="1.0">
<DPHSHV verzePis="02.01">
<VetaD k_uladis="DPH" dokument="SHV" rok="2026" mesic="8" shvies_forma="R" d_poddp="28.09.2026"/>
<VetaP c_ufo="451" c_pracufo="2001" dic="99999994" typ_ds="P" zkrobchjm="Ukázková firma s.r.o." ulice="Na Příkopě" c_pop="859" c_orient="22" naz_obce="Praha" psc="11000" stat="ČESKÁ REPUBLIKA" opr_jmeno="Jana" opr_prijmeni="Ukázková" opr_postaveni="jednatelka" sest_jmeno="Jana" sest_prijmeni="Ukázková"/>
</DPHSHV>
</Pisemnost>
/entities/{entity_id}/taxes/income_tax/xml – Přiznání k dani z příjmů (DPFDP7 nebo DPPDP9) jako XML
XML přiznání k dani z příjmů za rok year: u OSVČ DPFDP7 verze 01.01.02 (jen roky 2024–2025), u právnické osoby DPPDP9 verze 05.01.01 s rozvahou a výkazem zisku a ztráty. DPPO vyžaduje vyrovnanou rozvahu; za celé zdaňovací období 2026 ho Saldo zatím odmítne, struktura formuláře pokrývá rok 2026 jen pro jeho části. filing_type: B, O, D, E (N se zapíše jako D); u D, E i N je povinný reasons_found_on a last_known_tax.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
last_known_tax | dotaz | číslo | ne | Poslední známá daň – povinná u dodatečného přiznání (D, E, N) Příklad 48210. |
publish | dotaz | ano/ne | ne | Jen DPPO – false (také „false“, 0 nebo off) vynechá žádost o zveřejnění rozvahy a výkazu zisku a ztráty ve sbírce listin; bez parametru se žádost ponechá Výchozí true. Příklad true. |
accounts_approved | dotaz | ano/ne | ne | Jen DPPO – true uvede, že účetní závěrka je schválená Výchozí false. Příklad false. |
accounts_audited | dotaz | ano/ne | ne | Jen DPPO s povinným auditem – true uvede, že závěrka je ověřená auditorem Výchozí false. Příklad false. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Rok mimo formulář („… lze sestavit jen za roky 2024–2025“ u DPFO, 2021–2026 u DPPO) nebo bez zákonných sazeb v Saldu |
| 422 | – | DPPO za celé zdaňovací období 2026 („Přiznání za celé zdaňovací období 2026 zatím sestavit nelze …“) |
| 422 | – | Chybějící údaje („Doplňte DIČ v Nastavení → Firma; …“), nevyrovnaná rozvaha nebo neúplné údaje zástupce |
| 422 | – | Dodatečné přiznání (D, E, N) bez last_known_tax nebo bez reasons_found_on |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/xml?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/xml?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<Pisemnost nazevSW="Saldo" verzeSW="1.0">
<DPFDP7 verzePis="01.01.02">
<VetaD dokument="DP7" k_uladis="DPF" dap_typ="B" rok="2025" c_ufo_cil="451" pln_moc="N" audit="N" zdobd_od="01.01.2025" zdobd_do="31.12.2025" m_deti="12" kc_op15_1a="30840" uhrn_slevy35ba="30840" kc_dazvyhod="15204"/>
<VetaP c_pracufo="2002" dic="8001010006" prijmeni="Ukázka" jmeno="Jan" ulice="Vinohradská" c_pop="1" naz_obce="Praha" psc="12000" stat="ČESKÁ REPUBLIKA" email="demo@example.cz" c_telef="+420777000000" rod_c="8001010006" k_stat="CZ"/>
<VetaA vyzdite_jmeno="Eliška" vyzdite_prijmeni="Ukázková" vyzdite_r_cislo="1855120003" vyzdite_pocmes="12"/>
<VetaB priloha1="1" priloh_celk="1"/>
<VetaT c_nace="741200" m_podnik="12" vyd7proc="N" uc_soust="1"/>
</DPFDP7>
</Pisemnost>
/entities/{entity_id}/taxes/prehled_sp/xml – Přehled OSVČ pro ČSSZ (OSVC25) jako XML
XML přehledu o příjmech a výdajích OSVČ pro ČSSZ ve formátu e-Podání OSVC25 (jmenný prostor http://schemas.cssz.cz/OSVC2025). Jen pro OSVČ a jen za rok 2025. filing_type O vytvoří opravný přehled (vyžaduje reasons_found_on a reason), jakákoli jiná hodnota řádný. Před vrácením projde XML kontrolami podle pravidel ČSSZ; nalezené problémy vrátí v poli problems.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
reason | dotaz | text | ne | Důvod opravného přehledu (povinný u filing_type O) Příklad Opravné daňové přiznání. |
tax_return | dotaz | text | ne | Jak se podává daňové přiznání (ovlivní lhůtu přehledu); výchozí advisor, má-li firma v nastavení daňového poradce, jinak standard; neznámá hodnota se ignoruje Hodnoty: standard, electronic, advisor, none, extended. Příklad electronic. |
tax_return_extended_until | dotaz | datum | ne | Den, do kterého finanční úřad prodloužil lhůtu – povinný u tax_return extended Příklad 2026-07-01. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma není OSVČ („Přehledy pro ČSSZ a zdravotní pojišťovnu podává jen OSVČ“) |
| 422 | – | Rok jiný než 2025, chybějící údaje daňového profilu nebo nesplněné kontroly ČSSZ; odpověď { error, problems } s jednotlivými nálezy |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/xml?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/xml?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<OSVC xmlns="http://schemas.cssz.cz/OSVC2025" version="1.0">
<VENDOR productName="Saldo" productVersion="1.0"/>
<prehledosvc vsdp="12345678" for="prehledosvc" dep="110" rok="2025" typ="N">
<client>
<name sur="Ukázka" fir="Jan" tit=""/>
<birth bno="8001010006" den="1980-01-01"/>
<adr str="Vinohradská" num="1" pnu="12000" cit="Praha" cnt="CZ"/>
<email>demo@example.cz</email>
<tel>+420 777 000 000</tel>
<druc>H</druc>
<hlavc>
<m1/>
<m2/>
<m3/>
<m4/>
<m5/>
<m6/>
<m7/>
<m8/>
<m9/>
<m10/>
<m11/>
<m12/>
<m13>A</m13>
</hlavc>
<vedc>
<m1/>
<m2/>
<m3/>
<m4/>
<m5/>
<m6/>
<m7/>
<m8/>
<m9/>
<m10/>
<m11/>
<m12/>
<m13/>
<zam/>
<duchod/>
<pdite/>
<ppm/>
<pece/>
<ndite/>
</vedc>
<narok>
<m1/>
<m2/>
<m3/>
<m4/>
<m5/>
<m6/>
<m7/>
<m8/>
<m9/>
<m10/>
<m11/>
<m12/>
<m13/>
</narok>
<sleva>
<m1/>
<m2/>
<m3/>
<m4/>
<m5/>
<m6/>
<m7/>
<m8/>
<m9/>
<m10/>
<m11/>
<m12/>
<m13/>
</sleva>
<vzpm/>
</client>
<pvv pri="0">
<mesc h="12" v=""/>
<mesv h="12" v=""/>
<mesp>0</mesp>
<rdza h="0" v="0"/>
<vvz h="0" v="0"/>
<dvz h="0" v="0"/>
<mvz>195540</mvz>
<uvz>195540</uvz>
<vzza/>
<vzsu>195540</vzsu>
<vzsvc>195540</vzsvc>
<poj>57098</poj>
<slev>0</slev>
<pojposlev>57098</pojposlev>
<zal>0</zal>
<ned>57098</ned>
</pvv>
<prihldp/>
<zal ved="H" pau="" vzpm="" duch="" vz="17139" dp="5005" np="0"/>
<pre vra="0" kam="">
<rok/>
<iban/>
<bs pu="" cu="" kb="" ss="" vs=""/>
<adr str="" num="" pnu="" cit="" cnt=""/>
</pre>
<prizn>
<pau/>
<pov>A</pov>
<elektr>N</elektr>
<por>N</por>
<meldat/>
</prizn>
<opr datopr="" duvod=""/>
<spo bno="" den="">
<name sur="" fir="" tit=""/>
<adr str="" num="" pnu="" cit="" cnt=""/>
</spo>
<dat dre="2026-09-28"/>
</prehledosvc>
</OSVC>
/entities/{entity_id}/taxes/prehled_zp/xml – Přehled OSVČ pro zdravotní pojišťovnu jako XML
XML přehledu OSVČ pro zdravotní pojišťovnu ve společném formátu pojišťoven (prehledOSVC v6, jmenný prostor http://xmlns.vzp.cz/prehledOSVC/v6). Jen pro OSVČ a jen za rok 2025. filing_type O vytvoří opravný přehled, jiná hodnota řádný. Před vrácením projde XML kontrolami; problémy vrátí v poli problems.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
tax_return | dotaz | text | ne | Jak se podává daňové přiznání; výchozí advisor nebo standard podle nastavení firmy Hodnoty: standard, electronic, advisor, none, extended. Příklad electronic. |
tax_return_extended_until | dotaz | datum | ne | Den, do kterého finanční úřad prodloužil lhůtu – povinný u tax_return extended Příklad 2026-07-01. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma není OSVČ |
| 422 | – | Rok jiný než 2025, chybějící údaje daňového profilu nebo nesplněné kontroly; odpověď { error, problems } |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_zp/xml?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_zp/xml?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<prehledOSVC xmlns="http://xmlns.vzp.cz/prehledOSVC/v6">
<identifikacePredmetuPodaniText>Přehled OSVČ pro ZP 2026+</identifikacePredmetuPodaniText>
<identifikacePredmetuPodaniKod>3e0520e9-2dea-4073-8252-ed57cb5d1c89</identifikacePredmetuPodaniKod>
<kodZdravotniPojistovny>111</kodZdravotniPojistovny>
<rokPrehledu>2025</rokPrehledu>
<typPrehledu>radny</typPrehledu>
<pojistenec>
<cisloPojistence>8001010006</cisloPojistence>
<ic>99999986</ic>
<prijmeni>Ukázka</prijmeni>
<jmeno>Jan</jmeno>
<adresa>
<ulice>Vinohradská</ulice>
<cisloDomu>1</cisloDomu>
<psc>12000</psc>
<obec>Praha</obec>
</adresa>
<telefon>420777000000</telefon>
<email>demo@example.cz</email>
</pojistenec>
<prohlaseniRezimPojistneho>
<prohlaseni>
<klicProhlaseni>prohlaseniPp</klicProhlaseni>
<seznamMesicu/>
</prohlaseni>
</prohlaseniRezimPojistneho>
<prohlaseniPojistenceDP>
<zpusobPodaniDP>priznaniDPFO</zpusobPodaniDP>
</prohlaseniPojistenceDP>
<stanovenePojistneOSVC>
<radekHodnoty>
<klicRadku>3</klicRadku>
<hodnotaRadku>0.00</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>4</klicRadku>
<hodnotaRadku>12</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>5</klicRadku>
<hodnotaRadku>12</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>6</klicRadku>
<hodnotaRadku>12</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>9</klicRadku>
<hodnotaRadku>279342.00</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>14</klicRadku>
<hodnotaRadku>279342.00</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>16</klicRadku>
<hodnotaRadku>37712</hodnotaRadku>
</radekHodnoty>
</stanovenePojistneOSVC>
<vyrovnaniZalohPojistne>
<seznamRadku>
<radekHodnoty>
<klicRadku>41</klicRadku>
<hodnotaRadku>0</hodnotaRadku>
</radekHodnoty>
<radekHodnoty>
<klicRadku>43</klicRadku>
<hodnotaRadku>-37712</hodnotaRadku>
</radekHodnoty>
</seznamRadku>
</vyrovnaniZalohPojistne>
<vyseZalohy>
<seznamRadkuSekceZalohy>
<radekHodnoty>
<klicRadku>51</klicRadku>
<hodnotaRadku>0</hodnotaRadku>
</radekHodnoty>
</seznamRadkuSekceZalohy>
<typZalohy>zalohaMinimalni</typZalohy>
<novaVyseZalohy>3306</novaVyseZalohy>
</vyseZalohy>
</prehledOSVC>
POST Kontrola podání v EPO nebo otevření předvyplněného formuláře
/entities/{entity_id}/taxes/{report}/epo
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví XML podání stejně jako GET …/taxes/{report}/xml a předá ho rozhraní EPO portálu Moje daně. S check=true ho portál jen zkontroluje v testovacím režimu a vrátí nalezené chyby. Bez check portál vrátí odkaz na formulář předvyplněný tímto XML. Ani jedna možnost nic nepodá: podání odešle až uživatel sám v portálu Moje daně a Saldo o tom nic neví. Stav podání v Saldu se nemění a podání se neukládá. Vstupy lze poslat v těle JSON i v query stringu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
report | cesta | text | ano | Druh podání; prehled_sp a prehled_zp vrátí 422 Hodnoty: dph, kh, sh, income_tax. Příklad dph. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
check | ano/ne | ne | true = jen kontrola v testovacím režimu EPO; false = odkaz na předvyplněný formulář Výchozí false. |
year | celé číslo | ne | Rok (u DPH, když chybí period; u daně z příjmů zdaňovací období); výchozí aktuální rok |
filing_type | text | ne | Druh podání jako u GET …/xml; výchozí B Hodnoty: B, O, D, E, N. |
date | datum | ne | Datum podání uvedené v XML; výchozí dnešní datum |
reasons_found_on | datum | ne | Den zjištění důvodů – povinný u dodatečného či následného podání |
Odpověď
200 application/json S check=true výsledek kontroly (errors, raw), jinak odkaz na formulář (url, valid_until). Chyby nalezené portálem vrací operace se stavem 200 v poli errors.
| Pole | Význam |
|---|---|
errors | Jen s check=true: chyby hlášené portálem ve tvaru „Typ: text“; prázdné pole = bez chyb |
raw | Jen s check=true: odpověď portálu, nejvýše 4000 znaků |
url | Jen bez check: adresa předvyplněného formuláře na mojedane.gov.cz |
valid_until | Jen bez check: čas volání + 30 minut – platnost odkazu, jak ji předpokládá Saldo (portál ji nevrací) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | report je prehled_sp nebo prehled_zp („Přehledy OSVČ se podávají ČSSZ a zdravotní pojišťovně, ne přes portál Moje daně“); XML se sestaví dřív, takže chybějící údaje přehledu vrátí 422 s problems |
| 422 | – | Nelze sestavit XML – stejné důvody jako u GET …/taxes/{report}/xml |
| 422 | – | Neznámá hodnota report („Neznámý typ podání“) |
| 502 | – | Portál Moje daně je nedostupný nebo odpověděl chybovým stavem HTTP („Portál Moje daně …“), nebo bez check nevrátil odkaz na formulář (error pak obsahuje první chybu hlášenou portálem) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Pošle XML metodou POST na https://mojedane.gov.cz/dpr/epo_podani: s check=true s parametrem test=1 (kontrolní hlášení zabalené do ZIP jako podani.xml), bez check s parametrem otevriFormular=1. Saldo tím podání neodesílá: test=1 je kontrola v testovacím režimu, otevriFormular=1 formulář jen předvyplní a odeslat ho musí uživatel v portálu; o odeslání se Saldo nedozví. Po úspěšné odpovědi portálu zapíše do historie událost tax.epo; jinak nezapisuje nic.
- Limity
- Spojení s portálem má limit 10 s na navázání a 40 s na odpověď.
- Opakování
- Každé volání znovu kontaktuje portál a zapíše novou událost; nic se nehromadí ani nepodává.
/entities/{entity_id}/taxes/dph/epo – Přiznání k DPH v EPO
XML přiznání k DPH (DPHDP3) za zvolené období.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
period | text | ne | Období YYYY-MM nebo YYYY-Qn; má přednost před year, month a quarter. Neplatná hodnota vrátí 422. |
month | celé číslo | ne | Měsíc 1–12, když chybí period |
quarter | celé číslo | ne | Čtvrtletí 1–4 čtvrtletního plátce, když chybí period i month |
Příklad
Volání portálu Moje daně je v ukázce nahrazeno záznamem.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period":"2026-08","check":true}' \
https://techtools.cz/ucetnictvi-api/entities/1/taxes/dph/epoJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/dph/epo', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"period": "2026-08",
"check": true
})
});
const data = await response.json();{
"errors": [],
"raw": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Odpoved><Vysledek>Kontrola proběhla bez chyb.</Vysledek></Odpoved>"
}
Odpověď externí služby (portál Moje daně) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
/entities/{entity_id}/taxes/kh/epo – Kontrolní hlášení v EPO
XML kontrolního hlášení (DPHKH1). Pro kontrolu (check=true) se posílá zabalené do ZIP. Identifikovaná osoba a právnická osoba se čtvrtletním obdobím dostanou 422.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
period | text | ne | Období YYYY-MM nebo YYYY-Qn. Neplatná hodnota vrátí 422. |
month | celé číslo | ne | Měsíc 1–12, když chybí period |
quarter | celé číslo | ne | Čtvrtletí 1–4, když chybí period i month (jen fyzická osoba) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Identifikovaná osoba nebo právnická osoba se čtvrtletním obdobím |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
Volání portálu Moje daně je v ukázce nahrazeno záznamem.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period":"2026-08","check":true}' \
https://techtools.cz/ucetnictvi-api/entities/1/taxes/kh/epoJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/kh/epo', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"period": "2026-08",
"check": true
})
});
const data = await response.json();{
"errors": [],
"raw": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Odpoved><Vysledek>Kontrola proběhla bez chyb.</Vysledek></Odpoved>"
}
Odpověď externí služby (portál Moje daně) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
/entities/{entity_id}/taxes/sh/epo – Souhrnné hlášení v EPO
XML souhrnného hlášení (DPHSHV); filing_type E vrátí 422.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
period | text | ne | Období YYYY-MM nebo YYYY-Qn. Neplatná hodnota vrátí 422. |
month | celé číslo | ne | Měsíc 1–12, když chybí period |
quarter | celé číslo | ne | Čtvrtletí 1–4, když chybí period i month |
Příklad
Bez check – vrátí odkaz na předvyplněný formulář. Volání portálu je v ukázce nahrazeno záznamem.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period":"2026-08"}' \
https://techtools.cz/ucetnictvi-api/entities/1/taxes/sh/epoJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/sh/epo', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"period": "2026-08"
})
});
const data = await response.json();{
"url": "https://adisspr.mfcr.cz/pmd/epo/formular/ukazka",
"valid_until": "2026-09-28T10:30:00.000Z"
}
Odpověď externí služby (portál Moje daně) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
/entities/{entity_id}/taxes/income_tax/epo – Přiznání k dani z příjmů v EPO
XML přiznání k dani z příjmů (DPFDP7 u OSVČ, DPPDP9 u právnické osoby) se stejnými omezeními jako u GET …/xml.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
last_known_tax | číslo | ne | Poslední známá daň – povinná u dodatečného přiznání (D, E, N) |
publish | text | ne | Jen DPPO – řetězec "false" vynechá žádost o zveřejnění závěrky. Hodnota se porovnává jako text: JSON false se nerozpozná a závěrka se zveřejní. Bez pole se zveřejní. Hodnoty: false. |
accounts_approved | ano/ne | ne | Jen DPPO – závěrka je schválená; výchozí false |
accounts_audited | ano/ne | ne | Jen DPPO s auditem – závěrka je ověřená; výchozí false |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | DPFO mimo roky 2024–2025, DPPO za celé zdaňovací období 2026, chybějící údaje nebo nevyrovnaná rozvaha |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
Bez check – vrátí odkaz na předvyplněný formulář. Volání portálu je v ukázce nahrazeno záznamem.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025}' \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/epoJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/epo', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025
})
});
const data = await response.json();{
"url": "https://adisspr.mfcr.cz/pmd/epo/formular/ukazka",
"valid_until": "2026-09-28T10:30:00.000Z"
}
Odpověď externí služby (portál Moje daně) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
POST Předběžná kontrola přehledu OSVČ u ČSSZ
/entities/{entity_id}/taxes/{report}/validate
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví XML přehledu OSVČ pro ČSSZ (jako GET …/taxes/prehled_sp/xml) a pošle ho k anonymní předběžné kontrole validační službě ČSSZ. Vrátí, zda přehled kontrolou prošel, a nálezy s kódy ČSSZ. Přehled se tím nepodává a v Saldu se neukládá. Jiná hodnota report než prehled_sp vrátí 422. Vstupy lze poslat v těle JSON i v query stringu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
report | cesta | text | ano | Jediná podporovaná hodnota Hodnoty: prehled_sp. Příklad prehled_sp. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Rok přehledu – Saldo sestaví jen rok 2025; výchozí aktuální rok |
filing_type | text | ne | O = opravný přehled, jinak řádný |
date | datum | ne | Datum vyplnění; výchozí dnešní datum |
reasons_found_on | datum | ne | Datum zjištění nové výše vyměřovacího základu (u opravného) |
reason | text | ne | Důvod opravného přehledu |
tax_return | text | ne | Jak se podává daňové přiznání Hodnoty: standard, electronic, advisor, none, extended. |
tax_return_extended_until | datum | ne | Prodloužená lhůta – povinná u tax_return extended |
Odpověď
200 application/json Výsledek kontroly ČSSZ.
| Pole | Význam |
|---|---|
ok | true, když služba vrátila výsledek OK |
findings | Nálezy: category, code (kód chyby ČSSZ), message, form |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | report není prehled_sp („Předběžnou kontrolu nabízí jen ČSSZ pro přehled OSVČ“) |
| 422 | – | XML přehledu nelze sestavit (firma není OSVČ, rok jiný než 2025, chybějící údaje); odpověď { error, problems } |
| 502 | – | Validační služba ČSSZ neodpověděla včas, je nedostupná nebo nevrátila výsledek |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Pošle XML přehledu na https://epodani.cssz.cz/ePodaniValidace.svc (SOAP ValidujPodani, bez přihlášení). Služba přehled jen kontroluje, nic se nepodá. Po odpovědi služby zapíše do historie událost tax.validate.
- Limity
- Spojení se službou ČSSZ má limit 10 s na navázání a 40 s na odpověď.
- Opakování
- Každé volání pošle přehled ke kontrole znovu a zapíše novou událost.
Příklad
Volání služby ČSSZ je v ukázce nahrazeno záznamem.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025}' \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/validateJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/validate', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025
})
});
const data = await response.json();{
"ok": true,
"findings": []
}
Odpověď externí služby (ČSSZ) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
POST Uložení podání daně z příjmů nebo přehledu OSVČ
/entities/{entity_id}/taxes/{report}/filing
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví XML jako GET …/taxes/{report}/xml a uloží ho jako podání ve stavu draft (Připraveno) spolu se snímkem výpočtu. Podání tím nikam neodchází; odeslání uživatel potvrdí později přes PATCH /filings/{id} se stavem filed. Podání k DPH (dph, kh, sh) se ukládají přes POST /filings. Vstupy lze poslat v těle JSON i v query stringu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
report | cesta | text | ano | Druh podání; jiné hodnoty vrátí 422 Hodnoty: income_tax, prehled_sp, prehled_zp. Příklad income_tax. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Zdaňovací období (rok); výchozí aktuální rok |
filing_type | text | ne | Druh podání (viz varianty); výchozí B. U daně z příjmů jen B, O, D nebo E, jiný vrátí 422 |
date | datum | ne | Datum podání uvedené v XML; výchozí dnešní datum |
reasons_found_on | datum | ne | Den zjištění důvodů (dodatečné přiznání, opravný přehled ČSSZ) |
Odpověď
201 application/json Uložené podání (bez XML).
| Pole | Význam |
|---|---|
id | ID podání |
kind | dpfo, dppo, prehled_sp nebo prehled_zp |
period | Rok (YYYY) |
filing_type | Druh podání |
status | draft |
data | Snímek výpočtu (u daně výsledek výpočtu, u přehledu řádky přehledu) |
proof_state | draft |
has_xml | true |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | report není income_tax, prehled_sp ani prehled_zp („Podání k DPH ukládejte přes /filings“) |
| 422 | – | XML nelze sestavit – stejné důvody jako u GET …/taxes/{report}/xml |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří záznam podání (kind dpfo nebo dppo podle firmy, případně prehled_sp nebo prehled_zp) ve stavu draft s XML a daty a zapíše událost filing.created. Nic nikam neposílá, nic neúčtuje.
- Opakování
- Každé volání vytvoří nové podání; duplicity se nekontrolují.
/entities/{entity_id}/taxes/income_tax/filing – Uložení přiznání k dani z příjmů
Uloží přiznání DPFO (OSVČ) nebo DPPO (právnická osoba) za rok year. filing_type se uloží tak, jak přišel (B, O, D, E, N, S), XML ale zná jen B, O, D a E – N se v XML zapíše jako D a S jako B.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
last_known_tax | číslo | ne | Poslední známá daň – povinná u dodatečného přiznání (D, E, N) |
publish | text | ne | Jen DPPO – řetězec "false" vynechá žádost o zveřejnění závěrky. Hodnota se porovnává jako text: JSON false se nerozpozná a závěrka se zveřejní. Bez pole se zveřejní. Hodnoty: false. |
accounts_approved | ano/ne | ne | Jen DPPO – závěrka je schválená; výchozí false |
accounts_audited | ano/ne | ne | Jen DPPO s auditem – závěrka je ověřená; výchozí false |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | DPFO mimo roky 2024–2025, DPPO za celé zdaňovací období 2026, chybějící údaje nebo nevyrovnaná rozvaha |
| 422 | – | filing_type mimo B, O, D, E, N, S – validace podání { error, errors } |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025}' \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/filingJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/income_tax/filing', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"year": 2025,
"income": 0.0,
"expenses": 0.0,
"expense_method": {
"kind": "actual",
"parts": []
},
"profit": 0.0,
"employment_income": 0.0,
"tax_base": 0.0,
"partial_bases_total": 0.0,
"loss_applied": 0.0,
"deductions": [],
"tax_base_rounded": 0.0,
"tax_before_credits": 0.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "64",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"child_benefit": {
"total": 15204.0,
"used_as_credit": 0.0,
"bonus": 0.0,
"children": [
{
"order": 1,
"months": 12,
"ztpp": false,
"amount": 15204.0
}
]
},
"tax": 0.0,
"bonus": 0.0,
"tax_withheld": 0.0,
"tax_advances_paid": 0.0,
"tax_balance": 0.0,
"tax_advances": {
"last_known_tax": 0.0,
"frequency": "none",
"amount": 0.0,
"period": {
"from": "2026-05-05",
"to": "2027-05-03"
},
"schedule": [],
"basis": "§ 38a ZDP"
},
"sp": {
"participates": true,
"decisive_amount": null,
"assessment_base": 0.0,
"minimum_base": 195540.0,
"maximum_base": 2234736.0,
"applied_base": 195540.0,
"rate": 0.292,
"premium": 57098.0,
"discount": 0.0,
"premium_after_discount": 57098.0,
"advances_paid": 0.0,
"balance": 57098.0,
"monthly_advance_next": 5005.0,
"sickness": null,
"basis": "§ 5b, § 7 odst. 1 písm. e) bod 1, § 14 a § 15a zákona č. 589/1992 Sb."
},
"zp": {
"minimum_applies": true,
"assessment_base": 0.0,
"minimum_base": 279342.0,
"applied_base": 279342.0,
"rate": 0.135,
"premium": 37712.0,
"advances_paid": 0.0,
"balance": 37712.0,
"monthly_advance_next": 3306.0,
"basis": "§ 2, § 3a a § 8 zákona č. 592/1992 Sb."
},
"total_levies": 94810.0,
"net_income": -94810.0,
"effective_rate": 0.0,
"form_rows": {
"37": 0.0,
"41": 0.0,
"42": 0.0,
"45": 0.0,
"55": 0.0,
"56": 0.0,
"57": 0.0,
"58": 0.0,
"60": 0.0,
"70": 30840.0,
"71": 0.0,
"72": 15204.0,
"74": 0.0,
"75": 0.0,
"91": 0.0,
"64": 30840.0,
"101": 0.0,
"102": 0.0,
"104": 0.0,
"113": 0.0
},
"warnings": [
"Daňový bonus nenáleží: příjmy podle § 6 a § 7 nedosáhly 6násobku minimální mzdy (124 800 Kč, § 35c ZDP).",
"Minimální záloha hlavní činnosti činila v roce 2026 do června 5 720 Kč, od července 5 005 Kč (čl. I a čl. II bod 1 zákona č. 90/2026 Sb.)."
],
"other_income": {
"capital": 0.0,
"rental": {
"income": 0.0,
"expenses": 0.0,
"flat": false,
"base": 0.0,
"shared": false
},
"other": [],
"other_base": 0.0,
"loss": 0.0
}
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": null,
"filing_type": "B",
"first_filed_at": null,
"kind": "dpfo",
"period": "2025",
"status": "draft",
"submission_version": 0,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k dani z příjmů FO",
"has_xml": true,
"proof_state": "draft",
"evidence_count": 0,
"databox": null
}
/entities/{entity_id}/taxes/prehled_sp/filing – Uložení přehledu OSVČ pro ČSSZ
Uloží přehled pro ČSSZ za rok 2025; filing_type O uloží opravný přehled (typ O), cokoli jiného řádný (typ B).
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
reason | text | ne | Důvod opravného přehledu (povinný u O) |
tax_return | text | ne | Jak se podává daňové přiznání Hodnoty: standard, electronic, advisor, none, extended. |
tax_return_extended_until | datum | ne | Prodloužená lhůta – povinná u tax_return extended |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Rok jiný než 2025, chybějící údaje nebo nesplněné kontroly; odpověď { error, problems } |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025}' \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/filingJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_sp/filing', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"druc": "H",
"pri": 0.0,
"mesc": {
"h": 12,
"v": 0
},
"mesv": {
"h": 12,
"v": 0
},
"mesp": 0.0,
"rdza": {
"h": 0.0,
"v": 0.0
},
"vvz": {
"h": 0.0,
"v": 0.0
},
"dvz": {
"h": 0.0,
"v": 0.0
},
"mvz": 195540.0,
"uvz": 195540.0,
"vzza": null,
"vzsu": 195540.0,
"vzsvc": 195540.0,
"poj": 57098.0,
"slev": 0.0,
"pojposlev": 57098.0,
"zal": 0.0,
"ned": 57098.0,
"secondary_participates": false,
"decisive_amount": null,
"maximum_base": 2234736.0,
"next_year": {
"ved": "H",
"pau": "",
"vzpm": "",
"duch": "",
"vz": 17139.0,
"dp": 5005.0,
"np": 0.0
}
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": null,
"filing_type": "B",
"first_filed_at": null,
"kind": "prehled_sp",
"period": "2025",
"status": "draft",
"submission_version": 0,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přehled pro ČSSZ",
"has_xml": true,
"proof_state": "draft",
"evidence_count": 0,
"databox": null
}
/entities/{entity_id}/taxes/prehled_zp/filing – Uložení přehledu OSVČ pro zdravotní pojišťovnu
Uloží přehled pro zdravotní pojišťovnu za rok 2025; filing_type O uloží opravný přehled, cokoli jiného řádný.
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
tax_return | text | ne | Jak se podává daňové přiznání Hodnoty: standard, electronic, advisor, none, extended. |
tax_return_extended_until | datum | ne | Prodloužená lhůta – povinná u tax_return extended |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Rok jiný než 2025, chybějící údaje nebo nesplněné kontroly; odpověď { error, problems } |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025}' \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_zp/filingJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/prehled_zp/filing', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"3": 0.0,
"4": 12,
"5": 12,
"6": 12,
"9": 279342.0,
"14": 279342.0,
"16": 37712.0,
"41": 0.0,
"43": -37712.0,
"51": 0.0,
"advance_type": "minimum",
"new_advance": 3306.0,
"minimum_advance": 3306.0,
"monthly_minimum_base": 23278.5
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": null,
"filing_type": "B",
"first_filed_at": null,
"kind": "prehled_zp",
"period": "2025",
"status": "draft",
"submission_version": 0,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přehled pro zdravotní pojišťovnu",
"has_xml": true,
"proof_state": "draft",
"evidence_count": 0,
"databox": null
}
POST Doplnění daňového profilu OSVČ z bankovních pohybů
/entities/{entity_id}/taxes/profile_from_bank
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Projde odchozí bankovní pohyby OSVČ za posledních 24 měsíců a podle plateb na účty správ sociálního zabezpečení a zdravotních pojišťoven najde kód OSSZ, variabilní symbol ČSSZ, zdravotní pojišťovnu a rodné číslo. Do daňového profilu zapíše jen údaje, které v něm chybějí (rodné číslo ne, je-li DIČ rodným číslem). U právnické osoby nebo bez nálezu vrátí prázdné applied a nic nezmění. Stejné návrhy ukazuje GET …/taxes/payments v missing[].suggestion.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json Doplněné údaje.
| Pole | Význam |
|---|---|
applied | Pole → zobrazená hodnota: ossz_code, cssz_variable_symbol, health_insurer, birth_number (ve tvaru 850101/1233) |
Chování
- Co změní
- Uloží nalezené hodnoty do nastavení firmy (settings.tax_profile) a zapíše událost entity.updated („Z výpisu z banky doplněno: …“). Nic neúčtuje.
- Opakování
- Opakované volání už nic nedoplní, protože údaje v profilu jsou; vrátí prázdné applied.
Příklad
Ukázková OSVČ má profil vyplněný, proto vrátí prázdné applied.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile_from_bankJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile_from_bank', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"applied": {}
}
GET Údaje pro přiznání za jeden rok
/entities/{entity_id}/taxes/profile
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí údaje pro daňové přiznání za rok year tak, jak z nich počítá daň z příjmů, přehledy OSVČ a Platby úřadům. U OSVČ: společné osobní údaje (rodné číslo, OSSZ, variabilní symbol ČSSZ, pojišťovna, rok zahájení podnikání, způsob vrácení přeplatku) z nastavení firmy a údaje roku (měsíce činnosti, děti, manžel(ka), odpočty, zaplacené zálohy…). Rok bez vlastního záznamu převezme okolnosti (hlavní činnost, děti, manžel(ka), invalidita, způsob uplatnění výdajů) z nejbližšího dřívějšího uloženého roku; částky (zálohy, odpočty, příjmy) nepřebírá nikdy. U právnické osoby: ztráty z minulých let po letech vzniku, dary, zaplacené zálohy, poslední známá daň a další úpravy základu daně; nic se nepřebírá. suggestions.paid_advances ukazuje zálohy zaplacené za rok podle výpisů z banky (platby na účty ČSSZ, zdravotní pojišťovny a finančního úřadu; doplatky a penále se nezapočítají), u firmy suggestions.losses zůstatek ztrát po přiznání za předchozí rok. Rodná čísla, data narození a účet pro vrácení přeplatku (OSVČ, manžel(ka), děti) dostane jen vlastník nebo účetní a nikdy přes klíč jen pro čtení; ostatním v odpovědi chybějí.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
year | dotaz | celé číslo | ne | Zdaňovací období; výchozí aktuální rok Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Údaje roku a návrhy z banky.
| Pole | Význam |
|---|---|
year | Rok, pro který údaje platí |
kind | person (OSVČ) nebo company (právnická osoba) |
saved | true, když je pro rok uložený vlastní záznam |
source | year (vlastní záznam), carried (okolnosti převzaté z roku carried_from) nebo shared (jen společné údaje) |
carried_from | Rok, ze kterého se okolnosti převzaly, jinak null |
profile | Údaje, se kterými výpočty za rok počítají |
years | Roky, pro které je uložený vlastní záznam |
suggestions.paid_advances | Po druzích (sp, zp, tax): label, amount, count, payments (datum, částka, zpráva) a excluded (doplatky a penále) |
suggestions.losses | Jen firma: ztráty, které po přiznání za předchozí rok zbývá odečíst (year, amount) |
options.adjustment_rows | Jen firma: řádky přiznání pro další úpravy základu daně (row, label, direction increase nebo decrease) |
Chování
- Co změní
- Nic nezapisuje.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2025,
"kind": "person",
"saved": false,
"source": "shared",
"carried_from": null,
"profile": {
"birth_number": "8001010006",
"ossz_code": "110",
"cssz_variable_symbol": "12345678",
"health_insurer": "111",
"main_activity": true,
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
]
},
"years": [],
"suggestions": {
"paid_advances": {
"sp": {
"label": "sociální pojištění",
"amount": 0.0,
"count": 0,
"payments": [],
"excluded": []
},
"zp": {
"label": "zdravotní pojištění",
"amount": 3143.0,
"count": 1,
"payments": [
{
"date": "2026-01-07",
"amount": 3143.0,
"message": "Záloha ZP prosinec 2025",
"variable_symbol": "8001010006",
"transaction_id": 154
}
],
"excluded": []
},
"tax": {
"label": "daň z příjmů",
"amount": 0.0,
"count": 0,
"payments": [],
"excluded": []
}
}
},
"options": {}
}
PATCH Uložení údajů pro přiznání za jeden rok
/entities/{entity_id}/taxes/profile
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uloží údaje pro přiznání za rok year (povinný parametr). Přijímá stejná pole, jaká vrací GET …/taxes/profile v profile; záznam roku se nahradí celý. U OSVČ se společné osobní údaje (rodné číslo, OSSZ, variabilní symbol ČSSZ, pojišťovna, rok zahájení podnikání, způsob vrácení přeplatku) zapíší do nastavení firmy a platí pro všechny roky, ostatní jen pro rok year; expense_method (books podle vedení, actual skutečné výdaje, flat výdajový paušál) volí způsob uplatnění výdajů v přiznání. U právnické osoby: losses (pole year a amount – kolik z ztráty daného roku zbývá odečíst), gifts (pole částek), paid_advances, last_known_tax (jen když se liší od vypočtené daně) a adjustments (row, label, amount – řádky 20–62 zvyšují a 100–162 snižují základ daně). Stejně funguje PUT.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
year | dotaz | celé číslo | ano | Zdaňovací období, pro které údaje platí Příklad 2025. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
profile | objekt | ano | |
profile. | objekt | ne | OSVČ: zaplacené zálohy tax, sp, zp; firma: jedna částka |
profile. | objekt | ne | OSVČ: odečitatelné položky gifts, mortgage_interest, pension, life_insurance, dip, long_term_care |
profile. | pole | ne | OSVČ: vyživované děti (first_name, last_name, birth_number, birth_date, order, months, ztpp) |
profile. | celé číslo | ne | OSVČ: počet měsíců činnosti v roce |
profile. | text | ne | OSVČ: způsob uplatnění výdajů v přiznání Hodnoty: books, actual, flat. |
profile. | číslo | ne | OSVČ: příjmy roku před začátkem vedení v Saldu |
profile. | číslo | ne | OSVČ: výdaje roku před začátkem vedení v Saldu |
profile. | číslo | ne | OSVČ: dílčí základ z kapitálového majetku (§ 8, ř. 38) |
profile. | objekt | ne | OSVČ: nájem (§ 9) – income, expenses, flat (paušál 30 %), shared (společné jmění manželů) |
profile. | pole | ne | OSVČ: ostatní příjmy (§ 10) – code A až H, label, income, expenses, mark S/Z/N |
profile. | číslo | ne | OSVČ: ztráta z minulých let k odečtení (ř. 44) |
profile. | pole | ne | Firma: ztráty z minulých let – year (rok vzniku, před year) a amount |
profile. | pole | ne | Firma: dary, každý zvlášť |
profile. | číslo | ne | Firma: poslední známá daň pro zálohy, když se liší od vypočtené |
profile. | pole | ne | Firma: další úpravy základu daně – row, label, amount |
Odpověď
200 application/json Uložené údaje stejně jako v GET …/taxes/profile.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 422 | – | Chybí year, rok je mimo sazby Saldo, částka je záporná nebo není číslo, ztráta vznikla v roce year nebo později, neznámý řádek úpravy |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží záznam roku do settings.tax_years (u OSVČ společné osobní údaje do settings.tax_profile) a zapíše událost entity.updated („Upraveny údaje pro přiznání za rok …“). Nic neúčtuje; výpočty daně, přehledů a plateb se změní hned.
- Opakování
- Stejný požadavek vede ke stejnému stavu; každé volání přidá do historie změn nový záznam.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"profile":{"months":12,"paid_advances":{"tax":0,"sp":57108,"zp":37716},"deductions":{"gifts":3000}}}' \
"https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/taxes/profile?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"profile": {
"months": 12,
"paid_advances": {
"tax": 0,
"sp": 57108,
"zp": 37716
},
"deductions": {
"gifts": 3000
}
}
})
});
const data = await response.json();{
"year": 2025,
"kind": "person",
"saved": true,
"source": "year",
"carried_from": null,
"profile": {
"birth_number": "8001010006",
"ossz_code": "110",
"cssz_variable_symbol": "12345678",
"health_insurer": "111",
"main_activity": true,
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"months": 12,
"deductions": {
"gifts": 3000
},
"paid_advances": {
"tax": 0,
"sp": 57108,
"zp": 37716
}
},
"years": [
2025
],
"suggestions": {
"paid_advances": {
"sp": {
"label": "sociální pojištění",
"amount": 0.0,
"count": 0,
"payments": [],
"excluded": []
},
"zp": {
"label": "zdravotní pojištění",
"amount": 3143.0,
"count": 1,
"payments": [
{
"date": "2026-01-07",
"amount": 3143.0,
"message": "Záloha ZP prosinec 2025",
"variable_symbol": "8001010006",
"transaction_id": 154
}
],
"excluded": []
},
"tax": {
"label": "daň z příjmů",
"amount": 0.0,
"count": 0,
"payments": [],
"excluded": []
}
}
},
"options": {}
}
GET Pohyby z výpisu, které mohou zaplatit platbu úřadům
/entities/{entity_id}/taxes/payments/candidates
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Pro jednu položku Plateb úřadům (key z GET …/taxes/payments) vrátí nejvýš 20 odchozích pohybů v Kč od měsíce před začátkem jejího období do 120 dnů po splatnosti, nejbližší ke splatnosti první; pohyby ručně přiřazené k jiné položce vynechá. Okno from a to musí položku obsahovat (jako u GET …/taxes/payments).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
key | dotaz | text | ano | Klíč položky, např. social-2026-09 nebo vat-2026-08 Příklad vat-2026-08. |
from | dotaz | text | ne | První měsíc YYYY-MM Příklad 2026-09. |
to | dotaz | text | ne | Poslední měsíc YYYY-MM Příklad 2026-10. |
Odpověď
200 application/json Klíč a kandidáti.
| Pole | Význam |
|---|---|
candidates | id, booked_on, amount (kladně), counterparty_account, counterparty_bank_code, variable_symbol, message, linked |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Položka v zadaném období není („Platba v tomto období není“) |
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/taxes/payments/candidates?key=vat-2026-08&from=2026-09&to=2026-10"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/payments/candidates?key=vat-2026-08&from=2026-09&to=2026-10', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"key": "vat-2026-08",
"candidates": [
{
"id": 102,
"booked_on": "2026-09-24",
"amount": 40068.0,
"counterparty_account": "705-77628031",
"counterparty_bank_code": "0710",
"variable_symbol": "99999994",
"message": "DPH srpen 2026",
"linked": false
},
{
"id": 63,
"booked_on": "2026-09-23",
"amount": 4120.0,
"counterparty_account": "1599688387",
"counterparty_bank_code": "0710",
"variable_symbol": "0000000001",
"message": "Platba daně – finanční úřad",
"linked": false
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Ruční přiřazení platby k platbě úřadům
/entities/{entity_id}/taxes/payments/link
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Přiřadí odchozí bankovní pohyb k položce Plateb úřadům. Ruční přiřazení má přednost před automatickým párováním; nižší částka je částečné zaplacení. Položka může mít jen jeden ručně přiřazený pohyb. Nic neúčtuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
transaction_id | celé číslo | ano | ID odchozího bankovního pohybu firmy |
key | text | ano | Klíč položky Plateb úřadům |
Odpověď
200 application/json Všechna ruční přiřazení firmy (links – ID pohybu → klíč položky).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Přístup jen pro čtení |
| 404 | – | Pohyb patří jiné firmě, neexistuje nebo je příchozí |
| 422 | – | Neplatný klíč položky |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží přiřazení do nastavení firmy (settings.tax_payment_links) a zapíše událost tax.payment_linked.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_id":102,"key":"vat-2026-08"}' \
https://techtools.cz/ucetnictvi-api/entities/1/taxes/payments/linkJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/payments/link', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"transaction_id": 102,
"key": "vat-2026-08"
})
});
const data = await response.json();{
"links": {
"102": "vat-2026-08"
}
}
DELETE Zrušení ručního přiřazení platby
/entities/{entity_id}/taxes/payments/link
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zruší ruční přiřazení bankovního pohybu; položku pak znovu páruje automatické párování.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
transaction_id | celé číslo | ano | ID bankovního pohybu |
Odpověď
200 application/json Zbývající ruční přiřazení.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Přístup jen pro čtení |
| 404 | – | Pohyb patří jiné firmě nebo neexistuje |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Upraví settings.tax_payment_links a zapíše událost tax.payment_linked.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_id":102}' \
https://techtools.cz/ucetnictvi-api/entities/1/taxes/payments/linkJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/taxes/payments/link', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'DELETE',
body: JSON.stringify({
"transaction_id": 102
})
});
const data = await response.json();{
"links": {}
}
GET Rozdělení zisku a srážková daň z podílů
/entities/{entity_id}/profit_distributions
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí rozhodnutí o rozdělení zisku firmy od nejnovějšího. U každého společníka podíl, základ zaokrouhlený na celé koruny dolů (u podílu představovaného kmenovým listem na haléře dolů, § 36 odst. 3 ZDP), srážkovou daň (15 %, 35 % u rezidenta státu bez smlouvy, 0 % podle smlouvy nebo u osvobozeného podílu mateřské společnosti, zaokrouhlenou dolů, § 36 ZDP) a částku k výplatě; dále součty, den sražení (výplata, nejpozději konec 3. měsíce po rozhodnutí), splatnost odvodu (konec následujícího měsíce, § 38d ZDP) a zda je zaúčtované. Jen právnická osoba; OSVČ dostane 422.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json Pole rozdělení zisku.
| Pole | Význam |
|---|---|
[].recipients | name, kind, kind_label, amount, rate, exempt, certificate, base, tax, net, payer_tax (withholding_individual nebo withholding_corporate) |
[].totals | amount, tax, net |
[].withheld_on | Den sražení daně: výplata, nejpozději withholding_deadline |
[].payment_due | Splatnost odvodu srážkové daně finančnímu úřadu |
[].posted | true, když je rozdělení zaúčtované |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Účetní jednotka je OSVČ |
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/profit_distributionsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": null,
"source_account": "431",
"note": null,
"posted_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"kind_label": "Fyzická osoba – daňový rezident ČR",
"amount": 120000.0,
"rate": 15.0,
"exempt": false,
"certificate": false,
"base": 120000.0,
"tax": 18000.0,
"net": 102000.0,
"payer_tax": "withholding_individual"
}
],
"totals": {
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
},
"withholding_deadline": "2026-09-30",
"withheld_on": "2026-09-30",
"payment_due": "2026-10-31",
"posted": false
}
]
POST Nové rozdělení zisku
/entities/{entity_id}/profit_distributions
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uloží rozhodnutí valné hromady o rozdělení zisku a podíly společníků. Srážková daň se objeví v Platbách úřadům (GET …/taxes/payments) jako „Srážková daň z podílů na zisku“ na účet s předčíslím 7720 (fyzické osoby) nebo 7712 (právnické osoby). Nic neúčtuje – to dělá POST …/posting.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ano | Rok, za který se zisk rozděluje |
decided_on | datum | ano | Den rozhodnutí valné hromady |
paid_on | datum | ne | Den výplaty podílů (nepovinné) |
source_account | text | ne | Účet, ze kterého se zisk rozděluje Hodnoty: 431, 428. |
note | text | ne | Poznámka Nejvýše 200 znaků. |
recipients | pole | ano | Společníci: name, kind (person, company, foreign_person, foreign_company), amount, rate (0, 15, 35), exempt (jen právnická osoba), certificate (podíl je představován kmenovým listem: základ se zaokrouhlí na haléře dolů) |
Odpověď
201 application/json Uložené rozdělení stejně jako v seznamu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 422 | – | Chybí společník, jméno, kladná částka, neznámý druh nebo sazba, osvobození u fyzické osoby, výplata před rozhodnutím, OSVČ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží rozdělení a zapíše událost profit_distribution.created.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025,"decided_on":"2026-06-15","paid_on":"2026-06-30","recipients":[{"name":"Jana Ukázková","kind":"person","amount":120000},{"name":"Ukázka Holding a.s.","kind":"company","amount":280000,"exempt":true}]}' \
https://techtools.cz/ucetnictvi-api/entities/1/profit_distributionsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": "2026-06-30",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"amount": 120000
},
{
"name": "Ukázka Holding a.s.",
"kind": "company",
"amount": 280000,
"exempt": true
}
]
})
});
const data = await response.json();{
"id": 2,
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": "2026-06-30",
"source_account": "431",
"note": null,
"posted_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"kind_label": "Fyzická osoba – daňový rezident ČR",
"amount": 120000.0,
"rate": 15.0,
"exempt": false,
"certificate": false,
"base": 120000.0,
"tax": 18000.0,
"net": 102000.0,
"payer_tax": "withholding_individual"
},
{
"name": "Ukázka Holding a.s.",
"kind": "company",
"kind_label": "Právnická osoba – daňový rezident ČR",
"amount": 280000.0,
"rate": 0.0,
"exempt": true,
"certificate": false,
"base": 280000.0,
"tax": 0.0,
"net": 280000.0,
"payer_tax": "withholding_corporate"
}
],
"totals": {
"amount": 400000.0,
"tax": 18000.0,
"net": 382000.0
},
"withholding_deadline": "2026-09-30",
"withheld_on": "2026-06-30",
"payment_due": "2026-07-31",
"posted": false
}
PATCH Úprava rozdělení zisku
/entities/{entity_id}/profit_distributions/{id}
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní nezaúčtované rozdělení zisku; pole jako při založení, poslané recipients nahradí celý seznam. Zaúčtované rozdělení vrátí 422 – nejdřív zrušte zaúčtování. Stejně funguje PUT.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID rozdělení zisku Příklad 3. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
paid_on | datum | ne | Den výplaty podílů |
note | text | ne | Poznámka Nejvýše 200 znaků. |
Odpověď
200 application/json Uložené rozdělení.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 404 | – | Rozdělení patří jiné firmě nebo neexistuje |
| 422 | – | Rozdělení je zaúčtované nebo údaje neprojdou kontrolou |
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 událost profit_distribution.updated.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"paid_on":"2026-07-10","note":"Výplata převodem"}' \
https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"paid_on": "2026-07-10",
"note": "Výplata převodem"
})
});
const data = await response.json();{
"id": 1,
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": "2026-07-10",
"source_account": "431",
"note": "Výplata převodem",
"posted_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"kind_label": "Fyzická osoba – daňový rezident ČR",
"amount": 120000.0,
"rate": 15.0,
"exempt": false,
"certificate": false,
"base": 120000.0,
"tax": 18000.0,
"net": 102000.0,
"payer_tax": "withholding_individual"
}
],
"totals": {
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
},
"withholding_deadline": "2026-09-30",
"withheld_on": "2026-07-10",
"payment_due": "2026-08-31",
"posted": false
}
DELETE Smazání rozdělení zisku
/entities/{entity_id}/profit_distributions/{id}
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže rozdělení zisku i s jeho zaúčtováním; v uzamčeném období vrátí 422.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID rozdělení zisku Příklad 3. |
Odpověď
204 Smazáno.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 404 | – | Rozdělení patří jiné firmě nebo neexistuje |
| 422 | – | Zaúčtování leží v uzamčeném období |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže rozdělení a jeho zápisy a zapíše událost profit_distribution.deleted.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Zaúčtování rozdělení zisku
/entities/{entity_id}/profit_distributions/{id}/posting
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaúčtuje rozhodnutí 431 (nebo 428) / 364 v celkové výši podílů ke dni rozhodnutí a sraženou daň 364 / 342 ke dni sražení. Opakované volání zápisy nahradí. Výplatu podílů a odvod daně účtujte z banky.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID rozdělení zisku Příklad 3. |
Odpověď
200 application/json Rozdělení s posted true.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 404 | – | Rozdělení patří jiné firmě nebo neexistuje |
| 422 | – | Den rozhodnutí nebo sražení leží v uzamčeném období |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Zapíše účetní zápisy (zdroj distribution) a událost profit_distribution.posted.
- Opakování
- Opakované volání zápisy smaže a založí znovu.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1/postingJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1/posting', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"id": 1,
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": null,
"source_account": "431",
"note": null,
"posted_at": "2026-09-28T10:00:00.000Z",
"created_at": "2026-09-28T10:00:00.000Z",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"kind_label": "Fyzická osoba – daňový rezident ČR",
"amount": 120000.0,
"rate": 15.0,
"exempt": false,
"certificate": false,
"base": 120000.0,
"tax": 18000.0,
"net": 102000.0,
"payer_tax": "withholding_individual"
}
],
"totals": {
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
},
"withholding_deadline": "2026-09-30",
"withheld_on": "2026-09-30",
"payment_due": "2026-10-31",
"posted": true
}
DELETE Zrušení zaúčtování rozdělení zisku
/entities/{entity_id}/profit_distributions/{id}/posting
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže zápisy rozdělení zisku; rozdělení samo zůstane. V uzamčeném období vrátí 422.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID rozdělení zisku Příklad 3. |
Odpověď
200 application/json Rozdělení s posted false.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 404 | – | Rozdělení patří jiné firmě nebo neexistuje |
| 422 | – | Zápisy leží v uzamčeném období |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže zápisy a zapíše událost profit_distribution.unposted.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1/postingJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/profit_distributions/1/posting', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();{
"id": 1,
"year": 2025,
"decided_on": "2026-06-15",
"paid_on": null,
"source_account": "431",
"note": null,
"posted_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"recipients": [
{
"name": "Jana Ukázková",
"kind": "person",
"kind_label": "Fyzická osoba – daňový rezident ČR",
"amount": 120000.0,
"rate": 15.0,
"exempt": false,
"certificate": false,
"base": 120000.0,
"tax": 18000.0,
"net": 102000.0,
"payer_tax": "withholding_individual"
}
],
"totals": {
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
},
"withholding_deadline": "2026-09-30",
"withheld_on": "2026-09-30",
"payment_due": "2026-10-31",
"posted": false
}
GET Seznam uložených podání
/entities/{entity_id}/filings
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
- V příručce
- Daně a pojistné › Záložka Podání
Vrátí uložená podání firmy všech druhů (DPH, KH, SH, daň z příjmů, přehledy OSVČ i JMHZ) od nejnověji vytvořeného, bez XML. U každého podání je stav v Saldu (status draft nebo filed) a zvlášť stav doložení doručení proof_state – status filed je jen tvrzení uživatele, že podání odeslal. Podání JMHZ obsahují údaje zaměstnanců, a proto je člen bez přístupu ke mzdám nevidí ani tady, ani v detailu, změně a doručenkách (404 jako neexistující podání).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json Pole podání.
| Pole | Význam |
|---|---|
[].id | ID podání |
[].kind | dph, kh, sh, dpfo, dppo, prehled_sp, prehled_zp, jmhz; kind_label česky |
[].period | Období: YYYY-MM, YYYY-Qn nebo YYYY |
[].filing_type | B řádné, O opravné, D dodatečné, E opravné dodatečné, N následné, S storno |
[].status | draft (Připraveno) nebo filed (označeno jako odeslané) |
[].filed_on | Datum odeslání zadané uživatelem |
[].first_filed_at | Kdy bylo podání poprvé označeno jako odeslané |
[].submission_version | Kolikrát bylo podání označeno jako odeslané (zvyšuje se při každém přechodu na filed) |
[].proof_state | draft; awaiting_proof (odesláno bez ověřené doručenky či výjimky); verified (ověřená doručenka nebo potvrzení přijetí k aktuálnímu XML a verzi odeslání); exception (schváleno bez doručenky) |
[].exception_approved_at | Schválení bez doručenky: kdy, kdo (exception_approved_by_id) a proč (exception_reason) |
[].evidence_count | Počet přiložených důkazních souborů včetně vyřazených |
[].data | Snímek výkazu nebo výpočtu z doby přípravy |
[].has_xml | Zda je uložené XML |
Chování
- Co změní
- Nic nezapisuje.
- Limity
- Nejvýše 200 nejnovějších podání; stránkování není.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/filingsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": "2026-09-24",
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-08",
"status": "filed",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "awaiting_proof",
"evidence_count": 1,
"databox": null
},
{
"id": 2,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"sections": {
"a1": [],
"a2": [
{
"document_id": 65,
"country": "DE",
"vat_id": "998877665",
"number": "2026083526",
"dppd": "2026-08-07",
"base1": 28002.5,
"tax1": 5880.53,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0
}
],
"a3": [],
"a4": [
{
"document_id": 20,
"partner_dic": "90000013",
"number": "FV20260020",
"dppd": "2026-08-15",
"base1": 115500.0,
"tax1": 24255.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"bad_debt": false
},
{
"document_id": 130,
"partner_dic": "90000013",
"number": "FV20260026",
"dppd": "2026-08-31",
"base1": 19800.0,
"tax1": 4158.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"bad_debt": false
}
],
"a5": {
"base1": 96000.0,
"tax1": 20160.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"document_ids": [
19
]
},
"b1": [],
"b2": [
{
"document_id": 62,
"partner_dic": "90000056",
"number": "2026085713",
"dppd": "2026-08-02",
"base1": 14500.0,
"tax1": 3045.0,
"base2": 0.0,
"tax2": 0.0,
"base3": 0.0,
"tax3": 0.0,
"proportional": false,
"bad_debt": false
}
],
"b3": {
"base1": 6200.0,
"tax1"
…
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Uložení podání k DPH (přiznání, kontrolní nebo souhrnné hlášení)
/entities/{entity_id}/filings
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví výkaz a XML přiznání k DPH, kontrolního nebo souhrnného hlášení za období a uloží je jako podání ve stavu draft (Připraveno). Podání nikam neodchází; že bylo odesláno, potvrdí uživatel přes PATCH /filings/{id}. Datum podání v XML je vždy dnešní. Operace nekontroluje registraci k DPH.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
kind | text | ano | Druh podání Hodnoty: dph, kh, sh. |
period | text | ano | Období YYYY-MM nebo YYYY-Qn; neplatná hodnota vrátí 422 |
filing_type | text | ne | Druh podání: u dph B, O, D, E; u kh B, O, N, E; u sh B, N. Jiný druh vrátí 422. Dodatečné přiznání k DPH nese rozdíly proti poslednímu podanému přiznání (viz GET …/taxes/{report}/xml) Hodnoty: B, O, D, E, N. Výchozí B. |
reasons_found_on | datum | ne | Den zjištění důvodů – povinný u dodatečného přiznání k DPH a následného KH |
reasons | text | ne | Důvody dodatečného přiznání k DPH (D, E); zapíší se do XML jako textová příloha |
Odpověď
201 application/json Uložené podání bez XML (tvar jako v GET /filings).
| Pole | Význam |
|---|---|
id | ID podání |
status | draft |
data | Sestavený výkaz (přiznání, kontrolní nebo souhrnné hlášení) s celými řádky |
data.difference | Jen dodatečné přiznání k DPH: rozdíly řádků, které nese XML |
data.tax_change | Jen dodatečné přiznání k DPH: ř. 66, rozdíl oproti poslední známé dani (kladný = doplatek) |
data.baseline_filing_id | Jen dodatečné přiznání k DPH: ID podání, od kterého se rozdíly počítají |
proof_state | draft |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | kind není dph, kh ani sh („Tento typ podání zatím nelze připravit“) |
| 422 | – | XML nelze sestavit – druh podání, který formulář nezná, identifikovaná osoba u KH, právnická osoba se čtvrtletním KH, chybí den zjištění důvodů, dodatečné přiznání k DPH bez podaného přiznání za období nebo beze změny, neplatné údaje firmy nebo dokladu, XML neprojde oficiálním XSD formuláře (podání se neuloží) |
| 422 | – | Neplatný formát period |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří podání (Filing) ve stavu draft s daty výkazu a XML a zapíše událost filing.created. Nic nikam neposílá, nic neúčtuje.
- Opakování
- Každé volání vytvoří nové podání, i za stejné období a druh.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"dph","period":"2026-08","filing_type":"B"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filingsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"kind": "dph",
"period": "2026-08",
"filing_type": "B"
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": null,
"filing_type": "B",
"first_filed_at": null,
"kind": "dph",
"period": "2026-08",
"status": "draft",
"submission_version": 0,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "draft",
"evidence_count": 0,
"databox": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Náhled opravy DPH u nedobytné pohledávky (§ 46) nebo závazku po splatnosti (§ 74b)
/entities/{entity_id}/documents/{id}/vat_correction
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
U vystavené tuzemské faktury plátce s daní spočítá, co by oprava DPH obsahovala: u vydané faktury snížení daně na výstupu u neuhrazené pohledávky (§ 46 ZDPH), u přijaté snížení odpočtu u závazku neuhrazeného 6 měsíců po splatnosti (§ 74b ZDPH); operation=reclaim spočítá vrácení opravy po úhradě. Nic neukládá.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID faktury (invoice_out nebo invoice_in) Příklad 31. |
operation | dotaz | text | ne | correct = oprava neuhrazené části, reclaim = vrácení opravy po úhradě Hodnoty: correct, reclaim. Výchozí correct. Příklad correct. |
Odpověď
200 application/json Náhled opravy.
| Pole | Význam |
|---|---|
kind | Druh opravného dokladu: credit_out nebo credit_in |
date | Výchozí datum opravy (u § 74b den po uplynutí 6 měsíců od splatnosti, nejpozději dnes) |
ratio | Podíl faktury, kterého se oprava týká (neuhrazená, nebo nově uhrazená část) |
vat | Daň v opravě v Kč (záporná u opravy, kladná u vrácení) |
corrections[] | Dosavadní opravy DPH k faktuře { id, number, issue_date, total_vat_czk } |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma není plátce DPH, doklad není vystavená faktura, plnění není tuzemské s daní, faktura je uhrazená, oprava už existuje (correct) nebo žádná není (reclaim) |
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/vat_correction?operation=correct"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/129/vat_correction?operation=correct', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"action": "correct",
"kind": "credit_out",
"date": "2026-09-28",
"ratio": 1.0,
"vat": -4158.0,
"corrections": []
}
POST Vystavení opravy DPH u nedobytné pohledávky (§ 46) nebo závazku po splatnosti (§ 74b)
/entities/{entity_id}/documents/{id}/vat_correction
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Vystaví a zaúčtuje opravný daňový doklad (credit_out nebo credit_in) s příznakem regime_44 k faktuře: řádky neuhrazené (u reclaim nově uhrazené) části se záporným (kladným) množstvím, u přijaté faktury stejné evidenční číslo dodavatele a DUZP jako faktura a období DPH podle data opravy. Zaúčtuje jen daň: věřitel MD 343 / D 311, dlužník MD 321 / D 343 (vrácení opačně), zápisy patří k původní faktuře, jejíž pohledávka nebo závazek trvá. Opravný doklad se neplatí (payment_state na). V přiznání jde do ř. 1 a 33 (věřitel) nebo ř. 40 a 34 (dlužník), v kontrolním hlášení do A.4 nebo B.2 s příznakem zdph_44 = P.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID faktury Příklad 31. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
operation | text | ne | correct (výchozí) nebo reclaim Hodnoty: correct, reclaim. |
date | datum | ne | Datum opravy; bez něj výchozí z náhledu. Nesmí být před DUZP faktury |
Odpověď
201 application/json Vystavený opravný doklad (tvar jako GET …/documents/{id}).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Stejné důvody jako u náhledu, neplatné datum nebo datum před DUZP faktury |
| 403 | – | Člen jen pro čtení nebo API klíč jen pro čtení |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří, očísluje a zaúčtuje opravný doklad a zapíše události document.created, document.issued a document.vat_correction.
- Opakování
- Druhá oprava téže faktury se odmítne, dokud se po úhradě nevrátí.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation":"correct","date":"2026-09-28"}' \
https://techtools.cz/ucetnictvi-api/entities/1/documents/131/vat_correctionJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/documents/131/vat_correction', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"operation": "correct",
"date": "2026-09-28"
})
});
const data = await response.json();{
"id": 136,
"kind": "credit_in",
"kind_label": "Opravný daňový doklad přijatý",
"status": "issued",
"number": "OP20260001",
"variable_symbol": "2026090417",
"original_number": "2026090417",
"partner_id": 6,
"partner_name": "Coworking Karlín s.r.o.",
"partner_ico": "90000056",
"issue_date": "2026-09-28",
"taxable_date": "2026-09-25",
"due_date": null,
"currency": "CZK",
"total_net": -14500.0,
"total_vat": -3045.0,
"total_payable": -17545.0,
"total_gross_czk": -17545.0,
"paid_amount": 0.0,
"remaining": -17545.0,
"payment_state": "na",
"days_overdue": 0,
"description": "Oprava odpočtu – závazek po splatnosti 2026090417",
"vat_mode": "domestic",
"source": "manual",
"tags": null,
"related_document_id": 131,
"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": "2026-09-28",
"vat_date": "2026-09-28",
"exchange_rate": 1.0,
"rate_date": null,
"rc_code": null,
"prices_include_vat": false,
"simplified": false,
"regime_44": true,
"payment_method": "bank",
"bank_account_id": null,
"rounding": 0.0,
"total_gross": -17545.0,
"total_net_czk": -14500.0,
"total_vat_czk": -3045.0,
"note": "Oprava odpočtu daně u neuhrazeného závazku (§ 74b ZDPH) k dokladu č. FP20260039 (číslo dodavatele 2026090417) ze dne 25. 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": "2026-09-28T10:00:00.000Z",
"updated_at": "2026-09-28T10:00:00.000Z",
"accounting_date": "2026-09-25",
"payee_mismatch": null,
"partner": {
"name": "Coworking Karlín s.r.o.",
"ico": "90000056",
"dic": "CZ90000056",
"street": "Pernerova 697/35",
"city": "Praha 8",
"zip": "18600",
"country": "CZ",
"email": null,
"phone": null
},
"lines": [
{
"id": 137,
"position": 0,
"description": "Oprava odpočtu – závazek po splatnosti: Nájem kancelářského místa – říjen",
"quantity": -1.0,
"unit": null,
"unit_price": 14500.0,
"discount_percent": 0.0,
"vat_rate": 21.0,
"vat_kind": "standard",
"account_code": "518",
"credit_account": null,
"asset": false,
"deduction": "full",
"vat_share": 100.0,
"advance_document_id": null,
"stated_vat": null,
"net": -14500.0,
"vat": -3045.0,
"gross": -17545.0,
"net_czk": -14500.0,
"vat_czk": -3045.0
}
],
"attachments": [],
"share": null,
"payments": [],
"vat_recap": [
{
"rate": 21.0,
"net": -14500.0,
"vat": -3045.0,
"gross": -17545.0,
"net_czk": -14500.0,
"vat_czk": -3045.0
}
],
"bank_account": null,
"related_document": {
"id": 131,
"number": "FP20260039",
"kind": "invoice_in",
"currency": "CZK",
"remaining": 17545.0
},
"open_credits": [],
"recurrence": null,
"vat_filed": null,
"vat_corrections": []
}
GET Ruční úpravy řádků přiznání k DPH
/entities/{entity_id}/vat_adjustments
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
- V příručce
- Daně a pojistné › Ruční úpravy přiznání
Vrátí ruční úpravy přiznání k DPH (nejvýše 500, podle řádku). Úprava přičte částku k jednomu sloupci řádku přiznání za období; přiznání (GET …/taxes/vat_return), jeho XML i uložená podání ji obsahují.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
period | dotaz | text | ne | Jen úpravy období YYYY-MM nebo YYYY-Qn Příklad 2026-07. |
Odpověď
200 application/json Seznam úprav.
| Pole | Význam |
|---|---|
[].id | ID úpravy |
[].period | Období YYYY-MM nebo YYYY-Qn |
[].row | Řádek přiznání |
[].column | Sloupec: base, tax, full, reduced, value, with_credit, without_credit, change nebo coefficient |
[].amount | Částka v Kč (u coefficient procenta), přičte se k řádku |
[].reason | Důvod úpravy |
[].document_id | Doklad, ke kterému se úprava vztahuje (např. omezení odpočtu u auta), nebo null |
[].label | Popis, např. „ř. 40 · Odpočet v plné výši“ |
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/vat_adjustments?period=2026-07"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_adjustments?period=2026-07', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"amount": -800.0,
"column": "value",
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"document_id": null,
"period": "2026-07",
"reason": "Úprava odpočtu podle § 78 ZDPH",
"row": 60,
"updated_at": "2026-09-28T10:00:00.000Z",
"label": "ř. 60 · Hodnota"
}
]
POST Ruční úprava řádku přiznání k DPH
/entities/{entity_id}/vat_adjustments
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY - V příručce
- Daně a pojistné › Ruční úpravy přiznání
Přičte částku k jednomu sloupci řádku přiznání k DPH za období: řádky bez zdroje v dokladech (ř. 7–9, 14, 23, 24, 32, 45, 48, 51, 53, 60, 61) nebo omezení odpočtu, např. u osobního automobilu na 420 000 Kč daně (§ 72 odst. 3 ZDPH; upozornění car_vat_cap v přiznání nese v poli fix, které úpravy udělat). Řádky 46, 52 a 62–66 se počítají z ostatních, ty upravit nejde. Úprava s document_id potlačí upozornění car_vat_cap u toho dokladu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
period | text | ano | Období YYYY-MM nebo YYYY-Qn |
row | celé číslo | ano | Řádek přiznání |
column | text | ano | Sloupec řádku; řádky bez sloupců mají value Hodnoty: base, tax, full, reduced, value, with_credit, without_credit, change, coefficient. |
amount | číslo | ano | Částka v Kč, nesmí být 0; snížení se znaménkem minus. U coefficient (ř. 53) procenta, která řádek nahradí |
reason | text | ano | Důvod, 5–500 znaků |
document_id | celé číslo | ne | Doklad téže firmy, ke kterému se úprava vztahuje (nepovinné) |
Odpověď
201 application/json Uložená úprava (tvar jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Řádek, který se počítá z ostatních, sloupec, který řádek nemá, nulová částka, krátký důvod, neplatné období nebo doklad jiné firmy |
| 403 | – | Člen jen pro čtení nebo API klíč jen pro čtení |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží úpravu a zapíše událost vat_adjustment.created s jejími údaji. Změní přiznání za období, jeho XML a porovnání s podaným přiznáním.
- Opakování
- Každé volání přidá další úpravu; stejné úpravy se sčítají.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period":"2026-07","row":61,"column":"value","amount":1500,"reason":"Vrácení daně podle § 84 ZDPH"}' \
https://techtools.cz/ucetnictvi-api/entities/1/vat_adjustmentsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_adjustments', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"period": "2026-07",
"row": 61,
"column": "value",
"amount": 1500,
"reason": "Vrácení daně podle § 84 ZDPH"
})
});
const data = await response.json();{
"id": 2,
"amount": 1500.0,
"column": "value",
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"document_id": null,
"period": "2026-07",
"reason": "Vrácení daně podle § 84 ZDPH",
"row": 61,
"updated_at": "2026-09-28T10:00:00.000Z",
"label": "ř. 61 · Hodnota"
}
DELETE Zrušení ruční úpravy přiznání k DPH
/entities/{entity_id}/vat_adjustments/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY - V příručce
- Daně a pojistné › Ruční úpravy přiznání
Smaže ruční úpravu; řádek přiznání se vrátí na hodnotu z dokladů.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID úpravy Příklad 3. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Úprava neexistuje nebo patří jiné firmě |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže úpravu a zapíše událost vat_adjustment.deleted s jejími údaji.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/vat_adjustments/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_adjustments/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
GET Historie registrace k DPH
/entities/{entity_id}/vat_registrations
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí záznamy historie registrace k DPH podle data: od valid_from je firma měsíční (monthly) nebo čtvrtletní (quarterly) plátce, identifikovaná osoba (identified), nebo není registrovaná (none). Když historie existuje, výkazy DPH berou jen doklady s datem DPH v době registrace a měsíc nebo čtvrtletí volí podle roku; bez historie platí stav firmy od vat_registered_on.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json Záznamy od nejstaršího.
| Pole | Význam |
|---|---|
[].id | ID záznamu |
[].status | monthly, quarterly, identified nebo none |
[].status_label | Stav česky |
[].valid_from | Od kdy stav platí |
[].note | Poznámka |
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/vat_registrationsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"note": "Stav před vedením historie",
"status": "monthly",
"updated_at": "2026-09-28T10:00:00.000Z",
"valid_from": "2023-01-01",
"status_label": "Plátce DPH – měsíčně"
},
{
"id": 2,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"note": "Přechod na čtvrtletí",
"status": "quarterly",
"updated_at": "2026-09-28T10:00:00.000Z",
"valid_from": "2027-01-01",
"status_label": "Plátce DPH – čtvrtletně"
}
]
POST Nový záznam historie registrace k DPH
/entities/{entity_id}/vat_registrations
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Přidá stav registrace platný od data. Prvnímu záznamu firmy, která už registrovaná je, Saldo předřadí dosavadní stav od vat_registered_on (poznámka „Stav před vedením historie“), aby se minulá období nezměnila. Změna mezi měsíčním a čtvrtletním obdobím musí platit od 1. ledna (§ 99a ZDPH). Po změně Saldo nastaví vat_status a vat_registered_on firmy podle dnešního stavu; vat_status pak přes PATCH firmy změnit nejde.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
status | text | ano | Stav od valid_from Hodnoty: monthly, quarterly, identified, none. |
valid_from | datum | ano | Od kdy stav platí |
note | text | ne | Poznámka, nejvýše 200 znaků |
Odpověď
201 application/json Uložený záznam (tvar jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Neznámý stav, datum, které v historii už je, nebo změna mezi měsícem a čtvrtletím jinde než od 1. ledna |
| 403 | – | Jen vlastník nebo účetní |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží záznam, upraví vat_status a vat_registered_on firmy a zapíše událost vat_registration.created.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"none","valid_from":"2028-01-01","note":"Zrušení registrace"}' \
https://techtools.cz/ucetnictvi-api/entities/1/vat_registrationsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"status": "none",
"valid_from": "2028-01-01",
"note": "Zrušení registrace"
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"note": "Zrušení registrace",
"status": "none",
"updated_at": "2026-09-28T10:00:00.000Z",
"valid_from": "2028-01-01",
"status_label": "Neplátce DPH"
}
PATCH Oprava záznamu historie registrace k DPH
/entities/{entity_id}/vat_registrations/{id}
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní stav, datum nebo poznámku záznamu se stejnými pravidly jako při založení.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID záznamu Příklad 2. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
status | text | ne | Stav Hodnoty: monthly, quarterly, identified, none. |
valid_from | datum | ne | Od kdy |
note | text | ne | Poznámka |
Odpověď
200 application/json Upravený záznam.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Stejné důvody jako při založení |
| 404 | – | Záznam patří jiné firmě |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Upraví záznam a stav firmy, zapíše událost vat_registration.updated s původními údaji.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"note":"Přechod na čtvrtletí oznámen v lednu"}' \
https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations/2JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations/2', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"note": "Přechod na čtvrtletí oznámen v lednu"
})
});
const data = await response.json();{
"id": 2,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"note": "Přechod na čtvrtletí oznámen v lednu",
"status": "quarterly",
"updated_at": "2026-09-28T10:00:00.000Z",
"valid_from": "2027-01-01",
"status_label": "Plátce DPH – čtvrtletně"
}
DELETE Smazání záznamu historie registrace k DPH
/entities/{entity_id}/vat_registrations/{id}
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže záznam; výkazy DPH a stav firmy se přepočítají podle zbylé historie.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID záznamu Příklad 2. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Záznam patří jiné firmě |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže záznam, upraví stav firmy a zapíše událost vat_registration.deleted.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations/2JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/vat_registrations/2', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
GET Detail podání nebo jeho uložené XML
/entities/{entity_id}/filings/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
- V příručce
- Daně a pojistné › Záložka Podání
Vrátí podání včetně uloženého XML v poli xml. S format=xml (nebo koncovkou .xml v cestě) vrátí přímo uložený soubor XML – přesně ten, který byl sestaven při přípravě podání.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
format | dotaz | text | ne | xml = vrátit soubor XML místo JSON Hodnoty: xml. Příklad xml. |
Odpověď
200 application/json Podání (pole jako v GET /filings) a navíc xml. S format=xml soubor application/xml s názvem {kind}-{period}.xml (Content-Disposition attachment).
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/filings/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filed_on": "2026-09-24",
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-08",
"status": "filed",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Pisemnost nazevSW=\"Saldo\" verzeSW=\"1.0\">\n <DPHDP3 verzePis=\"03.01\">\n <VetaD dokument=\"DP3\" k_uladis=\"DPH\" typ_platce=\"P\" dapdph_forma=\"B\" rok=\"2026\" mesic=\"8\" d_poddp=\"28.09.2026\" c_okec=\"621000\" trans=\"A\"/>\n <VetaP c_ufo=\"451\" c_pracufo=\"2001\" dic=\"99999994\" typ_ds=\"P\" zkrobchjm=\"Ukázková firma s.r.o.\" ulice=\"Na Příkopě\" c_pop=\"859\" c_orient=\"22\" naz_obce=\"Praha\" psc=\"11000\" stat=\"ČESKÁ REPUBLIKA\" email=\"demo@example.cz\" c_telef=\"+420777000000\" opr_jmeno=\"Jana\" opr_prijmeni=\"Ukázková\" opr_postaveni=\"jednatelka\" sest_jmeno=\"Jana\" sest_prijmeni=\"Uk…",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "awaiting_proof",
"evidence_count": 1,
"databox": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Označení podání jako odeslaného nebo vrácení mezi připravená
/entities/{entity_id}/filings/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní stav podání evidovaný v Saldu. status filed znamená, že uživatel prohlašuje, že podání odeslal (Saldo to neověřuje a samo nic neposílá); doložení doručení je samostatný krok přes …/evidences a …/verify. Při přechodu z draft na filed se zvýší submission_version, takže dřívější ověřené doručenky přestanou platit a proof_state je znovu awaiting_proof. status draft vrátí podání mezi připravená, smaže filed_on a zruší schválenou výjimku bez doručenky; přiložené soubory zůstanou.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
status | text | ano | Nový stav Hodnoty: draft, filed. |
filed_on | datum | ne | Datum odeslání (jen se status filed), nejpozději dnešek a nejdřív první den období podání; bez něj zůstane dosavadní datum u už odeslaného podání, jinak dnešní datum |
Odpověď
200 application/json Podání po změně (tvar jako v GET /filings).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | status není draft ani filed („Neplatný stav podání“) |
| 422 | – | Změněné filed_on je v budoucnosti („Datum podání nemůže být v budoucnosti“) nebo před začátkem období („Datum podání nemůže být před začátkem období 2026-09 (1. 9. 2026)“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží status a filed_on, při prvním odeslání first_filed_at, při přechodu na filed zvýší submission_version; při návratu na draft vymaže schválenou výjimku. Zapíše událost filing.updated s předchozím datem odeslání a případně zrušenou výjimkou. Nic nikam neposílá.
- Opakování
- Opakované filed u už odeslaného podání verzi nezvyšuje (jen případně změní filed_on); každý přechod draft → filed ji zvýší. Každé volání zapíše událost.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"filed","filed_on":"2026-09-24"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"status": "filed",
"filed_on": "2026-09-24"
})
});
const data = await response.json();{
"status": "filed",
"filed_on": "2026-09-24",
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-08",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "awaiting_proof",
"evidence_count": 1,
"databox": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Smazání připraveného podání
/entities/{entity_id}/filings/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže podání, které nikdy nebylo označeno jako odeslané a nemá žádný důkazní soubor. Podání, které už někdy bylo ve stavu filed (i když je teď draft), zůstává kvůli historii.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 56. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Podání je nebo někdy bylo označeno jako odeslané („… nelze smazat; zachovejte jeho historii“) |
| 422 | – | K podání jsou přiložené důkazní soubory („Podání s důkazními soubory nelze smazat“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Zapíše událost filing.deleted a podání smaže včetně XML.
Příklad
Potřebuje podání ve stavu draft, které nikdy nebylo odeslané a nemá důkazy.
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/filings/2JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/2', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Schválení odeslaného podání bez doručenky
/entities/{entity_id}/filings/{id}/exception
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Výslovně schválí, že odeslané podání se pro uzávěrku považuje za doložené, i když k němu není ověřená doručenka; proof_state pak je exception (ověřená doručenka má přednost a proof_state zůstává verified). Vyžaduje stav filed, potvrzení confirmed_without_receipt a důvod. Nové schválení nahradí předchozí.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
confirmed_without_receipt | ano/ne | ano | Musí být true |
reason | text | ano | Důvod schválení, alespoň 10 znaků |
Odpověď
200 application/json Podání po schválení (proof_state exception, pokud nemá ověřenou doručenku).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Podání není ve stavu filed („Nejprve označte podání jako odeslané“) |
| 422 | – | confirmed_without_receipt není true („Potvrďte schválení bez doručenky“) |
| 422 | – | Důvod je kratší než 10 znaků |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží exception_approved_at, exception_approved_by_id a exception_reason a zapíše událost filing.exception_approved s důvodem a případně nahrazenou výjimkou.
- Opakování
- Každé volání přepíše schválení novým (čas, osoba, důvod) a zapíše novou událost.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"confirmed_without_receipt":true,"reason":"Podání je v portálu potvrzené, doručenka zatím nedorazila."}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1/exceptionJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/exception', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"confirmed_without_receipt": true,
"reason": "Podání je v portálu potvrzené, doručenka zatím nedorazila."
})
});
const data = await response.json();{
"exception_approved_at": "2026-09-28T10:00:00.000Z",
"exception_approved_by_id": 1,
"exception_reason": "Podání je v portálu potvrzené, doručenka zatím nedorazila.",
"status": "filed",
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"filed_on": "2026-09-24",
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-08",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "exception",
"evidence_count": 1,
"databox": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Zrušení schválení podání bez doručenky
/entities/{entity_id}/filings/{id}/exception
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zruší schválenou výjimku; podání bez ověřené doručenky se vrátí do stavu awaiting_proof.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
Odpověď
200 application/json Podání po zrušení výjimky.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Výjimka není schválená („Výjimka není schválená“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vymaže údaje výjimky a zapíše událost filing.exception_revoked s jejím původním obsahem.
- Opakování
- Druhé volání vrátí 422, protože výjimka už schválená není.
Příklad
Předpokládá výjimku schválenou přes POST …/exception, jinak vrátí 422.
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1/exceptionJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/exception', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();{
"exception_approved_at": null,
"exception_approved_by_id": null,
"exception_reason": null,
"status": "filed",
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"period": {
"year": 2026,
"month": 8,
"quarter": null,
"from": "2026-08-01",
"to": "2026-08-31",
"label": "srpen 2026",
"deadline": "2026-09-25",
"key": "2026-08"
},
"form": "25 5401 MFin 5401 vzor č. 26",
"rows": {
"1": {
"base": 231300.0,
"tax": 48573.0
},
"2": {
"base": 0.0,
"tax": 0.0
},
"3": {
"base": 0.0,
"tax": 0.0
},
"4": {
"base": 0.0,
"tax": 0.0
},
"5": {
"base": 28003.0,
"tax": 5881.0
},
"6": {
"base": 0.0,
"tax": 0.0
},
"7": {
"base": 0.0,
"tax": 0.0
},
"8": {
"base": 0.0,
"tax": 0.0
},
"9": {
"base": 0.0,
"tax": 0.0
},
"10": {
"base": 0.0,
"tax": 0.0
},
"11": {
"base": 0.0,
"tax": 0.0
},
"12": {
"base": 0.0,
"tax": 0.0
},
"13": {
"base": 0.0,
"tax": 0.0
},
"14": {
"base": 0.0,
"tax": 0.0
},
"20": 0.0,
"21": 0.0,
"22": 0.0,
"23": 0.0,
"24": 0.0,
"25": 0.0,
"26": 0.0,
"30": 0.0,
"31": 0.0,
"32": 0.0,
"33": 0.0,
"34": 0.0,
"40": {
"base": 20700.0,
"full": 4347.0,
"reduced": 0.0
},
"41": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"42": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"43": {
"base": 28003.0,
"full": 5881.0,
"reduced": 0.0
},
"44": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"45": {
"full": 0.0,
"reduced": 0.0
},
"46": {
"full": 10228.0,
"reduced": 0.0
},
"47": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"48": {
"base": 0.0,
"full": 0.0,
"reduced": 0.0
},
"50": 0.0,
"51": {
"with_credit": 0.0,
"without_credit": 0.0
},
"52": {
"coefficient": null,
"deduction": 0.0
},
"53": {
"coefficient": null,
"change": 0.0
},
"60": 0.0,
"61": 0.0,
"62": 54454.0,
"63": 10228.0,
"64": 44226.0,
"65": 0.0,
"66": 0.0
},
"own_tax": 44226.0,
"excess_deduction": 0.0,
"documents": {
"1": [
19,
20
],
"5": [
65
],
"40": [
62,
63
],
"43": [
65
]
},
"warnings": [],
"adjustments": [],
"settlement": null
},
"filed_on": "2026-09-24",
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-08",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": true,
"proof_state": "awaiting_proof",
"evidence_count": 1,
"databox": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Zapíše přiznání podané mimo Saldo
/entities/{entity_id}/filings/external
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zapíše přiznání k DPH, kontrolní nebo souhrnné hlášení, které účetní podala v jiném programu nebo před převzetím firmy do Salda, jako podané (status filed) bez XML. Místo doručenky má výjimku „Podáno mimo Saldo“ schválenou volajícím (proof_state exception), takže ho přehled Účetní jednotky ukáže jako podané a fronta úkolů krok „Podat přiznání …“ vyřeší. Za období, které už má podání se stavem filed, nic nezapíše.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID firmy. Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
kind | text | ano | Druh podání. Hodnoty: dph, kh, sh. |
period | text | ano | Období RRRR-MM nebo RRRR-Q1 až Q4. |
filed_on | datum | ne | Den podání, výchozí dnes; nesmí být v budoucnosti. |
note | text | ne | Poznámka, například odkud se podávalo; přidá se k důvodu výjimky. Nejvýše 200 znaků. |
Odpověď
201 application/json Uložené podání ve stejném tvaru jako v GET …/filings, s data.external true.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní |
| 422 | – | Jiný druh než dph, kh nebo sh, neplatné období, datum v budoucnosti nebo před začátkem období, nebo už podané období („Za toto období už je podání evidované jako podané“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří podání se stavem filed a schválenou výjimkou. Do historie změn zapíše událost filing.external.
- Opakování
- Druhé volání za stejné období vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"dph","period":"2026-07","filed_on":"2026-08-20","note":"Podáno z POHODY"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/externalJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/external', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"kind": "dph",
"period": "2026-07",
"filed_on": "2026-08-20",
"note": "Podáno z POHODY"
})
});
const data = await response.json();{
"id": 3,
"created_at": "2026-09-28T10:00:00.000Z",
"created_by_id": 1,
"data": {
"external": true,
"note": "Podáno z POHODY"
},
"exception_approved_at": "2026-09-28T10:00:00.000Z",
"exception_approved_by_id": 1,
"exception_reason": "Podáno mimo Saldo: Podáno z POHODY",
"filed_on": "2026-08-20",
"filing_type": "B",
"first_filed_at": "2026-09-28T10:00:00.000Z",
"kind": "dph",
"period": "2026-07",
"status": "filed",
"submission_version": 1,
"updated_at": "2026-09-28T10:00:00.000Z",
"kind_label": "Přiznání k DPH",
"has_xml": false,
"proof_state": "exception",
"evidence_count": 0,
"databox": null
}
GET Důkazní soubory podání (doručenky a potvrzení)
/entities/{entity_id}/filings/{filing_id}/evidences
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí všechny soubory přiložené k podání jako doklad o doručení, včetně vyřazených, v pořadí nahrání. U každého je stav ověření; verified je true jen u nevyřazeného ověřeného souboru s uloženým originálem, jehož ověření patří k aktuálnímu XML a aktuální verzi odeslání podání.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
Odpověď
200 application/json Objekt s polem evidences.
| Pole | Význam |
|---|---|
evidences[].id | ID důkazního souboru |
evidences[].kind | delivery_receipt (doručenka), acceptance (potvrzení přijetí), other (jiný podklad); kind_label česky |
evidences[].filename | Původní název souboru; content_type, byte_size, sha256 |
evidences[].delivered_on | Datum doručení zadané při ověření |
evidences[].delivery_reference | Identifikátor podání nebo zprávy zadaný při ověření |
evidences[].verified_at | Kdy a kdo (verified_by_id) ověřil; filing_xml_sha256 a submission_version, ke kterým ověření patří; verification_note |
evidences[].voided_at | Vyřazení: kdy, kdo (voided_by_id), důvod (void_reason) |
evidences[].verified | Ověření platí pro aktuální XML a verzi odeslání a soubor není vyřazený |
evidences[].has_file | Zda je originál uložený |
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/filings/1/evidencesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"evidences": [
{
"id": 1,
"byte_size": 142,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"delivered_on": null,
"delivery_reference": null,
"filename": "potvrzeni-podani.pdf",
"filing_id": 1,
"filing_xml_sha256": null,
"kind": "delivery_receipt",
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"submission_version": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"verification_note": null,
"verified_at": null,
"verified_by_id": null,
"void_reason": null,
"voided_at": null,
"voided_by_id": null,
"kind_label": "Doručenka",
"has_file": true,
"verified": false
}
]
}
POST Přiložení doručenky nebo potvrzení k podání
/entities/{entity_id}/filings/{filing_id}/evidences
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uloží originální soubor dokladující doručení odeslaného podání (PDF, XML nebo ZFO z datové schránky). Typ se určí podle přípony a obsah se zkontroluje (PDF musí mít strukturu PDF, XML být platné XML, ZFO podepsaná obálka CMS – pečeť ani vztah k podání se nekontrolují). Přiložení samo doručení nedokládá: proof_state zůstane awaiting_proof, dokud vlastník nebo účetní soubor neověří přes …/verify.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
Tělo požadavku
Formát multipart/form-data.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
file | soubor | ano | Soubor .pdf, .xml nebo .zfo, 1 B až 15 MB |
kind | text | ne | Druh podkladu; neznámá hodnota se bere jako delivery_receipt Hodnoty: delivery_receipt, acceptance, other. Výchozí delivery_receipt. |
Odpověď
201 application/json Nový důkazní soubor (tvar jako v GET …/evidences). Stejný soubor znovu vrátí 200 s existujícím záznamem.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Podání není ve stavu filed („Nejprve označte podání jako odeslané“) |
| 400 | – | Chybí soubor v poli file („Vyberte doručenku nebo potvrzení“) |
| 413 | – | Soubor je prázdný nebo větší než 15 MB |
| 422 | – | Přípona není .pdf, .xml ani .zfo nebo obsah neodpovídá formátu |
| 422 | – | K podání je už 10 nevyřazených důkazních souborů |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží originál a záznam s jeho SHA-256, typem a nahrávající osobou a zapíše událost filing.evidence_attached. Stav podání ani proof_state nemění.
- Limity
- Soubor nejvýše 15 MB; nejvýše 10 nevyřazených souborů na podání (vyřazené se nepočítají).
- Opakování
- Soubor se stejným obsahem (SHA-256) u téhož podání se znovu neuloží – vrátí 200 s existujícím záznamem, i když je vyřazený, a nezapíše událost.
Příklad
Ukázka nejdřív označí připravené kontrolní hlášení jako odeslané a přiloží k němu soubor, který u něj ještě není.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-F "kind=delivery_receipt" \
-F "file=@potvrzeni-podani.pdf" \
https://techtools.cz/ucetnictvi-api/entities/1/filings/2/evidencesJavaScript
const form = new FormData();
form.append('file', fileInput.files[0], 'potvrzeni-podani.pdf');
form.append('kind', 'delivery_receipt');
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/2/evidences', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST',
body: form
});
const data = await response.json();{
"id": 2,
"byte_size": 142,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"delivered_on": null,
"delivery_reference": null,
"filename": "potvrzeni-podani.pdf",
"filing_id": 2,
"filing_xml_sha256": null,
"kind": "delivery_receipt",
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"submission_version": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"verification_note": null,
"verified_at": null,
"verified_by_id": null,
"void_reason": null,
"voided_at": null,
"voided_by_id": null,
"kind_label": "Doručenka",
"has_file": true,
"verified": false
}
GET Detail důkazního souboru podání
/entities/{entity_id}/filings/{filing_id}/evidences/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí jeden důkazní soubor podání s jeho stavem ověření a vyřazení (bez obsahu souboru).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
id | cesta | celé číslo | ano | ID důkazního souboru Příklad 7. |
Odpověď
200 application/json Důkazní soubor (pole jako v GET …/evidences).
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/filings/1/evidences/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"byte_size": 142,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"delivered_on": null,
"delivery_reference": null,
"filename": "potvrzeni-podani.pdf",
"filing_id": 1,
"filing_xml_sha256": null,
"kind": "delivery_receipt",
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"submission_version": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"verification_note": null,
"verified_at": null,
"verified_by_id": null,
"void_reason": null,
"voided_at": null,
"voided_by_id": null,
"kind_label": "Doručenka",
"has_file": true,
"verified": false
}
GET Stažení originálu doručenky
/entities/{entity_id}/filings/{filing_id}/evidences/{id}/file
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí uložený originál přesně tak, jak byl nahrán, i u vyřazeného souboru. Vždy jako příloha typu application/octet-stream s hlavičkami Cache-Control private, no-store a X-Content-Type-Options nosniff.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
id | cesta | celé číslo | ano | ID důkazního souboru Příklad 7. |
Odpověď
200 application/octet-stream Obsah souboru s původním názvem (Content-Disposition attachment).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | K záznamu není uložený soubor |
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/filings/1/evidences/1/fileJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/file', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();application/octet-stream, 142 bajtů (soubor potvrzeni-podani.pdf)
POST Ověření doručenky k odeslanému podání
/entities/{entity_id}/filings/{filing_id}/evidences/{id}/verify
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY - V příručce
- Daně a pojistné › Ověřit doručení
Vlastník nebo účetní potvrdí, že soubor dokládá doručení právě tohoto podání (subjekt, druh a období souhlasí), a zadá datum doručení a identifikátor podání nebo zprávy. Ověření se váže k aktuálnímu XML podání (SHA-256) a verzi odeslání; po novém označení podání jako odeslaného přestane platit. Podklad druhu other ověřit nelze – pro něj slouží schválení výjimky. Opakované ověření již ověřeného souboru vyžaduje důvod opravy.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
id | cesta | celé číslo | ano | ID důkazního souboru Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
confirmed_match | ano/ne | ano | Musí být true – potvrzení shody subjektu, druhu a období s podáním |
delivery_reference | text | ano | Identifikátor podání nebo zprávy (např. ID datové zprávy) |
delivered_on | datum | ano | Datum doručení; neplatné datum vrátí 422 |
verification_note | text | ne | Poznámka k ověření |
correction_reason | text | ne | Důvod opravy, alespoň 10 znaků – povinný, pokud už soubor ověřený byl |
Odpověď
200 application/json Důkazní soubor po ověření (verified true); proof_state podání je verified.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Soubor je vyřazený („Vyřazený podklad nelze potvrdit“) |
| 422 | – | Soubor je druhu other („Jiný podklad není doručenkou; použijte výslovné schválení účetní“) |
| 422 | – | Chybí původní soubor |
| 422 | – | Podání není ve stavu filed („Podání musí být označené jako odeslané“) |
| 422 | – | confirmed_match není true, chybí delivery_reference nebo delivered_on |
| 422 | – | Opakované ověření bez důvodu opravy alespoň 10 znaky |
| 422 | – | Neplatné datum delivered_on („Neplatné datum – použijte tvar RRRR-MM-DD“) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží datum doručení, identifikátor, poznámku, ověřující osobu a čas a SHA-256 XML a verzi odeslání podání. Zapíše událost filing.evidence_verified s novým i předchozím ověřením. Podání ani soubor nikam neposílá.
- Opakování
- Opakované ověření přepíše údaje, ale jen s důvodem opravy; každé zapíše novou událost.
Příklad
Předpokládá dosud neověřený soubor; u ověřeného je nutný i correction_reason.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"confirmed_match":true,"delivery_reference":"DS-4816235","delivered_on":"2026-09-24","verification_note":"Doručenka z datové schránky"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/verifyJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/verify', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"confirmed_match": true,
"delivery_reference": "DS-4816235",
"delivered_on": "2026-09-24",
"verification_note": "Doručenka z datové schránky"
})
});
const data = await response.json();{
"filing_id": 1,
"delivery_reference": "DS-4816235",
"delivered_on": "2026-09-24",
"verified_by_id": 1,
"verified_at": "2026-09-28T10:00:00.000Z",
"filing_xml_sha256": "012eb9f4caa68c73776a719f98b1fa00f8c002a658fcd12ef96d9a0f307ac609",
"submission_version": 1,
"verification_note": "Doručenka z datové schránky",
"byte_size": 142,
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"id": 1,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"filename": "potvrzeni-podani.pdf",
"kind": "delivery_receipt",
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"void_reason": null,
"voided_at": null,
"voided_by_id": null,
"kind_label": "Doručenka",
"has_file": true,
"verified": true
}
POST Vyřazení chybného důkazního souboru
/entities/{entity_id}/filings/{filing_id}/evidences/{id}/void
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Označí soubor jako vyřazený (např. doručenka patří k jinému podání). Originál ani údaje o dřívějším ověření se nemažou, ověření ale přestane platit a proof_state podání se přepočítá. Vyřazený soubor se nepočítá do limitu 10 souborů.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
id | cesta | celé číslo | ano | ID důkazního souboru Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
reason | text | ano | Důvod vyřazení, alespoň 10 znaků |
Odpověď
200 application/json Důkazní soubor po vyřazení.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Soubor je už vyřazený („Podklad je již vyřazený“) |
| 422 | – | Důvod je kratší než 10 znaků |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží voided_at, voided_by_id a void_reason a zapíše událost filing.evidence_voided s předchozím ověřením.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reason":"Doručenka patří k jinému podání"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/voidJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/void', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"reason": "Doručenka patří k jinému podání"
})
});
const data = await response.json();{
"filing_id": 1,
"voided_at": "2026-09-28T10:00:00.000Z",
"voided_by_id": 1,
"void_reason": "Doručenka patří k jinému podání",
"byte_size": 142,
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"id": 1,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"delivered_on": null,
"delivery_reference": null,
"filename": "potvrzeni-podani.pdf",
"filing_xml_sha256": null,
"kind": "delivery_receipt",
"submission_version": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"verification_note": null,
"verified_at": null,
"verified_by_id": null,
"kind_label": "Doručenka",
"has_file": true,
"verified": false
}
POST Oprava druhu nebo obnovení vyřazeného důkazního souboru
/entities/{entity_id}/filings/{filing_id}/evidences/{id}/correct
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Opraví druh podkladu nebo obnoví omylem vyřazený soubor, aniž by se mazal originál či dřívější události. Oprava vždy zruší vyřazení i dosavadní ověření – soubor je potřeba znovu ověřit přes …/verify.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
filing_id | cesta | celé číslo | ano | ID podání Příklad 55. |
id | cesta | celé číslo | ano | ID důkazního souboru Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
kind | text | ano | Správný druh podkladu; u nevyřazeného souboru musí být jiný než dosavadní Hodnoty: delivery_receipt, acceptance, other. |
reason | text | ano | Důvod opravy, alespoň 10 znaků |
Odpověď
200 application/json Důkazní soubor po opravě (nevyřazený, neověřený).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Důvod je kratší než 10 znaků |
| 422 | – | Neplatný druh („Neplatný typ podkladu“) |
| 422 | – | Stejný druh u nevyřazeného souboru („Zvolte jiný typ nebo obnovte vyřazený podklad“) |
| 422 | – | Obnovení vyřazeného souboru by překročilo 10 nevyřazených souborů |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Změní kind, vymaže údaje o vyřazení i ověření a zapíše událost filing.evidence_corrected s předchozím stavem a důvodem.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"acceptance","reason":"Soubor je potvrzení přijetí, ne doručenka"}' \
https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/correctJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/filings/1/evidences/1/correct', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"kind": "acceptance",
"reason": "Soubor je potvrzení přijetí, ne doručenka"
})
});
const data = await response.json();{
"filing_id": 1,
"kind": "acceptance",
"voided_at": null,
"voided_by_id": null,
"void_reason": null,
"verified_at": null,
"verified_by_id": null,
"delivered_on": null,
"delivery_reference": null,
"filing_xml_sha256": null,
"submission_version": null,
"verification_note": null,
"byte_size": 142,
"sha256": "93e31154c364805a3ef8c904bc257f5ef77600c31b67d392704cd6e1e9cd0657",
"id": 1,
"content_type": "application/pdf",
"created_at": "2026-09-28T10:00:00.000Z",
"filename": "potvrzeni-podani.pdf",
"updated_at": "2026-09-28T10:00:00.000Z",
"uploaded_by_id": 1,
"kind_label": "Potvrzení přijetí",
"has_file": true,
"verified": false
}
GET Daňový kalendář firmy (JSON nebo iCalendar)
/entities/{entity_id}/calendar
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí daňové a pojistné lhůty firmy za rok: DPH a hlášení, daň z příjmů a zálohy, pojistné OSVČ, paušální daň, mzdové odvody a hlášení, daň z nemovitých věcí, silniční daň a účetní závěrku – podle profilu odvozeného z nastavení a dat firmy. Termíny připadající na víkend nebo svátek jsou posunuté na nejbližší následující pracovní den. S format=ics (nebo koncovkou .ics) vrátí soubor iCalendar s celodenními událostmi a připomenutím 3 dny předem. Soubor se stahuje s přihlášením (relace nebo API klíč v hlavičce); veřejný odkaz pro odběr v kalendáři neexistuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
year | dotaz | celé číslo | ne | Kalendářní rok; výchozí (i při nečíselné hodnotě) aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
format | dotaz | text | ne | ics = soubor iCalendar místo JSON Hodnoty: ics. Příklad ics. |
Odpověď
200 application/json JSON s rokem, profilem a událostmi. S format=ics soubor text/calendar; charset=utf-8 s názvem danovy-kalendar-{rok}.ics.
| Pole | Význam |
|---|---|
year | Rok |
profile | Z čeho kalendář vychází: legal_form, vat, recap_statement, recap_goods, fiscal_year_start, employees, advisor, databox, electronic, flat_tax, audit, real_estate, road_tax |
events | Lhůty seřazené podle data: date, statutory_date, shifted, key, title, detail, description, category (income_tax, vat, insurance, payroll, property, accounts, other), basis |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Pro rok nejsou v Saldu zákonné sazby (Saldo je má pro roky 2024–2026) |
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/calendar?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/calendar?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"profile": {
"overview_mode": null,
"legal_form": "sro",
"vat": "monthly",
"recap_statement": true,
"recap_goods": false,
"fiscal_year_start": 1,
"employees": true,
"advisor": false,
"databox": false,
"electronic": true,
"flat_tax": false,
"audit": false,
"real_estate": false,
"road_tax": false
},
"events": [
{
"date": "2026-01-20",
"statutory_date": "2026-01-20",
"shifted": false,
"key": "payroll_2025_12",
"title": "Odvody za zaměstnance a měsíční hlášení",
"detail": "za prosinec 2025",
"description": "Odveďte zálohy na daň ze mzdy, pojistné na sociální pojištění ČSSZ a zdravotní pojištění pojišťovnám spolu s přehledem o platbě pojistného. Podejte přehled o výši pojistného pro ČSSZ. Srážkovou daň odveďte do konce následujícího měsíce.",
"category": "payroll",
"basis": "§ 38h odst. 10 ZDP; § 9 odst. 1 zákona č. 589/1992 Sb.; § 5 odst. 2 a § 25 odst. 3 zákona č. 592/1992 Sb.; § 9 odst. 2 zákona č. 589/1992 Sb. ve znění do 31. 12. 2025; za prosinec 2025 čl. IX bod 1 zákona č. 360/2025 Sb."
},
{
"date": "2026-01-26",
"statutory_date": "2026-01-25",
"shifted": true,
"key": "vat_control_statement_2025_12",
"title": "Kontrolní hlášení DPH",
"detail": "za prosinec 2025",
"description": "Podejte elektronicky kontrolní hlášení s přehledem vydaných a přijatých daňových dokladů. Právnická osoba ho podává vždy za měsíc, fyzická osoba ve lhůtě pro přiznání.",
"category": "vat",
"basis": "§ 101e zákona č. 235/2004 Sb."
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Propojení s datovou schránkou
/entities/{entity_id}/databox
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Stačí
Vrátí, zda je firma propojená se svou datovou schránkou: prostředí, ID a vlastník schránky (název, IČO), práva uživatele, stav poslední kontroly a konec platnosti hesla. Heslo ani uživatelské jméno se nikdy nevrací (jméno jen maskovaně …abc). Přidá doporučení, jaká práva dát uživateli, kterého Saldo používá.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json connection (connected false, nebo údaje o propojení), recommended (doporučení), portal a test_portal (adresy portálu).
| Pole | Význam |
|---|---|
connection | connected, environment (production | test), username (maskovaně), box_id, box_type, owner_name, owner_ico, status (active | error), last_error, privileges[] { key, label }, can_send, can_check_delivery, can_watch, reads, read_confirmed_at, checked_at, synced_at, password_expires_at |
recommended | Doporučená nastavení uživatele v datové schránce |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | – | Volající není vlastník ani účetní firmy |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nic nezapisuje a datovou schránku nevolá.
Příklad
Ukázková data nemají propojenou datovou schránku; propojení vyžaduje skutečné přihlášení do ISDS.
POST Propojí firmu s datovou schránkou
/entities/{entity_id}/databox
- Oprávnění
- Vlastník nebo účetní
- Pravidlo
- Jen člověk přihlášený v prohlížeči (hlavička X-Saldo 1); požadavek s API klíčem vrátí 403 SESSION_ONLY.
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zkušebně se přihlásí do datové schránky jménem a heslem (GetOwnerInfoFromLogin, GetUserInfoFromLogin, GetPasswordInfo; žádná z těchto operací zprávy nedoručí) a uloží propojení. IČO schránky musí sedět s IČO firmy (ve zkušebním prostředí se nekontroluje). Smí-li uživatel číst zprávy, je nutné výslovné potvrzení confirm_read, protože každé načtení seznamu přijatých zpráv by je doručilo. Heslo se ukládá šifrovaně a nikdy se nevrací. Nahradí dřívější propojení.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
environment | text | ne | Ostrý provoz, nebo zkušební prostředí datovka-test.gov.cz Hodnoty: production, test. Výchozí production. |
username | text | ano | Uživatelské jméno do datové schránky Nejvýše 120 znaků. |
password | text | ano | Heslo; uloží se šifrovaně |
confirm_read | ano/ne | ne | Potvrzení, že Saldo smí používat uživatele s právem číst zprávy (načtení zprávy doručí) Výchozí false. |
Odpověď
201 application/json connection ve tvaru jako v GET …/databox. Smí-li uživatel číst zprávy a chybí confirm_read, nic se neuloží a odpověď 200 nese jen confirm_read { code READ_RIGHTS, message } – po potvrzení člověkem pošlete požadavek znovu s confirm_read true.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Chybí jméno nebo heslo, schránka není zpřístupněná, uživatel nesmí odesílat ani zobrazit seznamy, přihlášení selhalo |
| 422 | – | IČO schránky nesedí s IČO firmy nebo schránka IČO nemá (code DATABOX_ICO) |
| 403 | – | API klíč (SESSION_ONLY), člen bez role vlastník nebo účetní, archivovaná firma |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží propojení (heslo šifrovaně) a zapíše událost databox.connected s ID schránky, IČO a právy, bez hesla.
- Opakování
- Nové volání propojení nahradí; při stejné schránce zůstane zarážka načtených zpráv.
Příklad
Propojení vyžaduje skutečné přihlášení do datové schránky.
DELETE Odpojí datovou schránku
/entities/{entity_id}/databox
- Oprávnění
- Vlastník nebo účetní
- Pravidlo
- Jen člověk přihlášený v prohlížeči; API klíč vrátí 403 SESSION_ONLY.
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže uložené přihlašovací údaje. Odeslané a přijaté zprávy i doručenky u podání zůstanou.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Firma nemá propojenou schránku |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže propojení a zapíše databox.disconnected.
Příklad
Vyžaduje propojenou datovou schránku.
POST Znovu ověří propojení s datovou schránkou
/entities/{entity_id}/databox/check
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Znovu se přihlásí, načte práva uživatele a konec platnosti hesla. Pokud schránka, IČO nebo práva už nesedí (třeba uživatel mezitím získal právo číst bez potvrzení), přepne propojení do stavu error a Saldo schránku přestane hlídat.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json connection ve tvaru jako v GET …/databox.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Firma nemá propojenou schránku |
| 422 | – | Přihlášení selhalo nebo schránka je nedostupná |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Aktualizuje práva, stav a konec platnosti hesla, zapíše databox.checked.
Příklad
Vyžaduje propojenou datovou schránku.
POST Zkontroluje datovou schránku hned
/entities/{entity_id}/databox/sync
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Totéž, co plánovaná úloha ucetnictvi:databox_sync pro jednu firmu: nejdřív ověří práva uživatele (s právem číst bez potvrzení skončí dřív, než načte seznam), dohledá odeslání s nejistým výsledkem, stáhne doručenky odeslaných podání a uloží nové přijaté obálky. Uživatel bez práva číst zprávy nedoručí (Provozní řád ISDS, kap. 4; WS ISDS 1.4). U potvrzeného uživatele s právem číst stáhne i obsah zpráv (ZFO).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
Odpověď
200 application/json received (nové přijaté zprávy), delivered (nově doručená podání), connection.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Firma nemá propojenou schránku |
| 502 | – | Kontrola selhala, propojení je ve stavu error (code DATABOX_SYNC) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží nové zprávy (databox.received), upozorní vlastníka, účetní a odpovědnou osobu, přidá krok fronty, u doručených podání uloží ověřenou doručenku (filing.evidence_verified).
- Opakování
- Okno načítání se překrývá o minutu; zprávu uloží jen jednou.
Příklad
Vyžaduje propojenou datovou schránku.
GET Zprávy datové schránky
/entities/{entity_id}/databox/messages
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Stačí
Odeslaná podání a přijaté zprávy od nejnovější (nejvýš 200) se stavem, časem dodání, doručení a dnem fikce.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
direction | dotaz | text | ne | Jen odeslané nebo jen přijaté Hodnoty: out, in. Příklad in. |
state | dotaz | text | ne | open = přijaté zprávy, které ještě nikdo neoznačil jako vyřízené Hodnoty: open. Příklad open. |
Odpověď
200 application/json messages[], open (počet nevyřízených přijatých), connection.
| Pole | Význam |
|---|---|
messages[] | id, direction, dm_id, filing_id, sender_name, recipient_name, annotation, attachment_name, files, status, status_label, dm_status, sent_at, delivered_at, accepted_at, fiction_on, handled_at, evidence_id, has_file, payroll, error |
Chování
- Co změní
- Nic nezapisuje a datovou schránku nevolá.
Příklad
Ukázková data nemají zprávy datové schránky.
POST Označí přijatou zprávu jako vyřízenou
/entities/{entity_id}/databox/messages/{id}/handled
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uzavře krok fronty „Nová zpráva od …“. Na doručení ani lhůty to nemá vliv.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID přijaté zprávy Příklad 3. |
Odpověď
200 application/json Zpráva ve tvaru messages[].
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Cizí, odeslaná nebo neexistující zpráva |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží čas a osobu, zapíše databox.handled.
- Opakování
- Opakované volání nic nezmění.
Příklad
Ukázková data nemají zprávy datové schránky.
DELETE Vrátí přijatou zprávu k vyřízení
/entities/{entity_id}/databox/messages/{id}/handled
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zruší označení vyřízeno, krok fronty se znovu otevře.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID přijaté zprávy Příklad 3. |
Odpověď
200 application/json Zpráva ve tvaru messages[].
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Cizí, odeslaná nebo neexistující zpráva |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Zapíše databox.reopened.
Příklad
Ukázková data nemají zprávy datové schránky.
GET Stažení zprávy datové schránky (ZFO)
/entities/{entity_id}/databox/messages/{id}/file
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Stačí
Vrátí podepsanou zprávu ve formátu ZFO, kterou Saldo stáhlo u potvrzeného uživatele s právem číst. Vždy jako příloha typu application/octet-stream s hlavičkami Cache-Control private, no-store a X-Content-Type-Options nosniff.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID zprávy Příklad 3. |
Odpověď
200 application/octet-stream Soubor zprava-{dm_id}.zfo.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Cizí zpráva nebo zpráva bez staženého obsahu |
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á data nemají zprávy datové schránky.
GET Náhled podání datovou schránkou
/entities/{entity_id}/filings/{id}/databox
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Adresát z registru Salda (finanční úřad firmy, u přehledu OSVČ e-podání ČSSZ) se zdrojem, navržená věc zprávy a příloha (název, velikost, SHA-256 XML). Vlastníkovi a účetní s propojenou schránkou navíc živě ověří adresáta v ISDS (FindDataBox) a vrátí jeho oficiální název, stav propojení a dosavadní zprávy k podání. Ostatním členům slouží jako návod k ručnímu podání.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
recipient | dotaz | text | ne | Jen ve zkušebním prostředí: ID zkušební schránky adresáta Příklad aydaadk. |
Odpověď
200 application/json OK
| Pole | Význam |
|---|---|
recipient | id, name, group (tax_office | cssz | test), source; null, když firma nemá finanční úřad |
live | found, active, name (oficiální název z ISDS), error |
subject | Věc zprávy, např. „Přiznání k DPH za 09/2026 – IČO … – firma“ |
attachment | name, size, sha256 – SHA-256 musí přijít zpět při odeslání |
sendable | Zda lze odeslat; blocked = důvod, proč ne |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Cizí nebo neexistující podání (JMHZ bez přístupu ke mzdám) |
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 propojené schránky volá FindDataBox (nedoručuje).
Příklad
Živé ověření adresáta vyžaduje propojenou datovou schránku.
POST Odešle podání datovou schránkou
/entities/{entity_id}/filings/{id}/databox
- Oprávnění
- Vlastník nebo účetní
- Pravidlo
- Jen člověk přihlášený v prohlížeči (hlavička X-Saldo 1); API klíč vrátí 403 SESSION_ONLY.
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Odešle uložené XML podání z propojené datové schránky firmy (CreateMessage) adresátovi z registru, jen s výslovným potvrzením confirmed a s SHA-256 z náhledu (pokud se podání mezitím změnilo, odmítne). Podání a verze odešle nejvýš jednou: klíč zprávy podle podání a verze, zámek podání a při výpadku spojení stav unknown, který se nejdřív dohledá v odeslaných zprávách (podle čísla jednacího SALDO-…). Po odeslání označí podání jako podané dnešním dnem; doručenku stáhne …/databox/check nebo plánovaná kontrola a uloží ji jako ověřenou doručenku podání.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
confirmed | ano/ne | ano | Výslovné potvrzení odeslání člověkem |
sha256 | text | ano | attachment.sha256 z náhledu |
recipient | text | ne | Jen ve zkušebním prostředí: ID zkušební schránky |
Odpověď
201 application/json message (odeslaná zpráva) a filing (podání ve stavu filed).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Chybí potvrzení (CONFIRMATION_REQUIRED), podání nejde odeslat (NOT_SENDABLE: není připravené, nepodporovaný druh, schránka nepropojená nebo bez práv, chybí finanční úřad), adresát neexistuje nebo nepřijímá zprávy, ISDS zprávu odmítlo |
| 409 | – | Podání se od náhledu změnilo (CHANGED) nebo už se odesílá či bylo odesláno (ALREADY_SENT) |
| 502 | – | Spojení selhalo a výsledek není jistý (SEND_UNKNOWN); znovu odeslat nejde, dokud se zpráva nedohledá |
| 403 | – | API klíč (SESSION_ONLY), člen bez role vlastník nebo účetní |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Odešle datovou zprávu úřadu, uloží zprávu (databox.sending, databox.sent) a označí podání jako podané (filed_on dnes, submission_version + 1).
- Limity
- Věc nejvýš 255 znaků, příloha jedno XML (běžná zpráva do 20 MB).
- Opakování
- Druhé volání pro stejné podání a verzi nic neodešle (422 nebo 409).
Příklad
Odeslání podání úřadu se v ukázkách nikdy nevolá.
POST Zkontroluje doručení podání odeslaného datovou schránkou
/entities/{entity_id}/filings/{id}/databox/check
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Odeslání s nejistým výsledkem dohledá v odeslaných zprávách (nenajde-li ho do 30 minut, uvolní podání k novému odeslání) a u odeslaných zpráv stáhne podepsanou doručenku (GetSignedDeliveryInfo). Je-li zpráva dodána, uloží doručenku ZFO jako ověřenou doručenku podání (číslo zprávy, datum dodání, shoda s verzí a otiskem XML), takže krok „Doložit doručení“ se uzavře sám.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky Příklad 12. |
id | cesta | celé číslo | ano | ID podání Příklad 55. |
Odpověď
200 application/json filing (s proof_state) a messages[] k podání.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Cizí nebo neexistující podání |
| 422 | – | Doručenka patří k jiné zprávě nebo adresátovi |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Aktualizuje stav zprávy, při doručení uloží ověřenou doručenku (filing.evidence_verified).
- Opakování
- Doručenka se uloží jen jednou.
Příklad
Vyžaduje propojenou datovou schránku.