Reference API
Účetní knihy a výkazy
Účtový rozvrh nebo kategorie daňové evidence, účetní zápisy, sestavy (předvaha, hlavní kniha, saldokonto, peněžní deník, výkazy, přehledy) a kroky měsíční a roční uzávěrky.
GET Účtový rozvrh nebo kategorie daňové evidence
/entities/{entity_id}/accounts
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí všechny účty firmy seřazené podle kódu, včetně neaktivních. V podvojném účetnictví je to účtový rozvrh (např. 221, 311, 518, 602), v daňové evidenci kategorie příjmů a výdajů (např. P02, V05).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
Odpověď
200 application/json Pole účtů (bez obalového objektu).
| Pole | Význam |
|---|---|
[].id | Identifikátor účtu pro úpravu a smazání. |
[].code | Kód účtu nebo kategorie. |
[].name | Název. |
[].kind | Druh (asset, liability, equity, expense, revenue, closing, off_balance, neutral); kind_label je český název. |
[].tax_relevant | Zda je účet daňový. |
[].statement_line | Ruční přiřazení řádku rozvahy nebo výkazu zisku a ztráty, jinak null. |
[].active | Zda je účet aktivní. |
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/accountsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accounts', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"code": "012",
"name": "Nehmotné výsledky vývoje",
"kind": "asset",
"tax_relevant": true,
"statement_line": null,
"active": true,
"kind_label": "Aktivní"
},
{
"id": 2,
"code": "013",
"name": "Software",
"kind": "asset",
"tax_relevant": true,
"statement_line": null,
"active": true,
"kind_label": "Aktivní"
}
]
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Založení účtu nebo kategorie
/entities/{entity_id}/accounts
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Přidá do účtového rozvrhu (nebo mezi kategorie daňové evidence) nový účet, typicky analytický účet jako 518100. Kód se převede na velká písmena a musí být ve firmě jedinečný. Platné hodnoty statement_line nabízí číselník statement_lines v /codebooks a sestava statements v poli line_options (řádky rozvahy ak:…, pa:… i výkazu zisku a ztráty vz:…).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
account | objekt | ano | |
account. | text | ano | Kód: 1–12 znaků, číslice, velká písmena, tečka a pomlčka; první znak číslice nebo písmeno. |
account. | text | ano | Název, nejvýše 160 znaků. |
account. | text | ano | Druh účtu – aktivní, pasivní, vlastní kapitál, nákladový, výnosový, závěrkový, podrozvahový, neutrální. Hodnoty: asset, liability, equity, expense, revenue, closing, off_balance, neutral. |
account. | ano/ne | ne | Daňový účet (výchozí true). |
account. | text | ne | Ruční přiřazení řádku výkazů – hodnota z číselníku statement_lines, např. ak:C.II.2.4.6 nebo vz:n_vs_sluzby; bez něj se řádek určí podle syntetického účtu. Starý kód pa:A.IV.2 (neuhrazená ztráta) se čte jako pa:A.IV.1. |
account. | ano/ne | ne | Aktivní účet (výchozí true). |
Odpověď
201 application/json Založený účet ve stejném tvaru jako v seznamu účtů.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | statement_line není řádek rozvahy ani výsledovky z číselníku statement_lines („není řádek rozvahy ani výsledovky – vyberte ho ze seznamu“), nebo kód už ve firmě existuje. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Založí účet a zapíše událost account.created do historie změn. Nic nezaúčtuje.
- Opakování
- Druhé založení se stejným kódem skončí chybou validace 422 (kód už existuje).
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":{"code":"518100","name":"Software a cloudové služby","kind":"expense","tax_relevant":true}}' \
https://techtools.cz/ucetnictvi-api/entities/1/accountsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accounts', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"account": {
"code": "518100",
"name": "Software a cloudové služby",
"kind": "expense",
"tax_relevant": true
}
})
});
const data = await response.json();{
"id": 433,
"code": "518100",
"name": "Software a cloudové služby",
"kind": "expense",
"tax_relevant": true,
"statement_line": null,
"active": true,
"kind_label": "Nákladový"
}
PATCH Úprava účtu nebo kategorie
/entities/{entity_id}/accounts/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní název, druh, daňovost, přiřazení k řádku výkazů nebo aktivitu účtu; kód změnit nelze (pole code se tiše ignoruje). Sestavy se počítají z aktuálních údajů účtu, proto druh, daňovost ani řádek výkazu nejde změnit, když má účet zápis, položku dokladu nebo zaúčtovaný pohyb v uzamčeném období (název a aktivitu ano). Nepoužívaný účet raději deaktivujte (active: false) než mažte.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Účet firmy (id ze seznamu účtů). Příklad 815. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
account | objekt | ano | |
account. | text | ne | Název, nejvýše 160 znaků. |
account. | text | ne | Druh účtu. Hodnoty: asset, liability, equity, expense, revenue, closing, off_balance, neutral. |
account. | ano/ne | ne | Daňový účet. |
account. | text | ne | Ruční přiřazení řádku rozvahy nebo výsledovky z číselníku statement_lines; prázdná hodnota přiřazení zruší. |
account. | ano/ne | ne | Aktivní účet. |
Odpověď
200 application/json Upravený účet.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | statement_line není řádek rozvahy ani výsledovky z číselníku statement_lines. |
| 422 | – | PERIOD_LOCKED: změna druhu, řádku výkazu nebo daňovosti účtu s použitím v uzamčeném období („Účet … má zápisy 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í
- Změní účet a nic nezaúčtuje. Když se něco změnilo, zapíše do historie událost account.updated se změnami.
- Opakování
- Stejný požadavek vede ke stejnému stavu.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":{"name":"Ostatní služby – provoz","active":true}}' \
https://techtools.cz/ucetnictvi-api/entities/1/accounts/431JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accounts/431', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"account": {
"name": "Ostatní služby – provoz",
"active": true
}
})
});
const data = await response.json();{
"id": 431,
"code": "518900",
"name": "Ostatní služby – provoz",
"kind": "expense",
"tax_relevant": true,
"statement_line": null,
"active": true,
"kind_label": "Nákladový"
}
DELETE Smazání nepoužitého účtu
/entities/{entity_id}/accounts/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže účet, pokud jeho kód není v žádném účetním zápisu (MD ani Dal), na řádku dokladu (účet ani protiúčet), u bankovního účtu či pokladny, u zaúčtovaného bankovního pohybu, v pravidle pro banku, u majetku ani jako výchozí účet kontaktu; porovnává se přesná shoda kódu. Použitý účet lze jen deaktivovat.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Účet firmy. Příklad 902. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Kód je někde použitý („Účet je použitý v zápisech – můžete ho jen deaktivovat“, „…na řádcích dokladů…“, „…u bankovního účtu nebo pokladny…“, „…u zaúčtovaných bankovních pohybů…“, „…v pravidle pro banku…“, „…u majetku…“, „…jako výchozí účet kontaktu…“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže účet a zapíše do historie událost account.deleted s jeho údaji.
- Opakování
- Druhé volání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/accounts/432JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accounts/432', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
GET Účetní deník
/entities/{entity_id}/entries
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí účetní zápisy za období chronologicky (datum, pak pořadí vzniku) po stránkách, se součtem částek všech vyhovujících zápisů. Filtry lze kombinovat: účet (prefix na straně MD nebo Dal, takže 311 zahrne i 311xxx), text zápisu, doklad a zdroj zápisu. Volající bez přístupu ke mzdám dostane mzdové zápisy (source_type payroll) s textem „Mzdy M/RRRR“ místo jména zaměstnance, se stejnými částkami a účty; hledání textu u nich prohledává jen tento text.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Nečíselná hodnota se bere jako aktuální rok, mimo rozsah se ořízne. Rozsah od 2000 do 2100. Příklad 2026. |
from | dotaz | datum | ne | Začátek období (YYYY-MM-DD); výchozí je první den účetního období year. Příklad 2026-09-01. |
to | dotaz | datum | ne | Konec období včetně (YYYY-MM-DD); výchozí je poslední den účetního období year. Příklad 2026-09-30. |
account | dotaz | text | ne | Kód účtu nebo jeho začátek; zápis se vrátí, pokud jím začíná strana MD nebo Dal. Příklad 221. |
q | dotaz | text | ne | Hledaný text v textu zápisu bez ohledu na velikost písmen a diakritiku: text „Úhrada“ najde dotaz „úhrada“, „Úhrada“ i „uhrada“. Příklad nájem. |
document_id | dotaz | celé číslo | ne | Jen zápisy tohoto dokladu. Příklad 431. |
source_type | dotaz | text | ne | Zdroje oddělené čárkou: document, payment, bank, asset (odpisy), asset_movement (pohyby majetku), trip (cestovní příkazy), payroll, manual, opening, closing, revaluation. Neznámé hodnoty se vynechají; když žádná neplatí, výsledek je prázdný. Lze i opakovat source_type[]. Příklad manual,opening. |
page | dotaz | celé číslo | ne | Stránka od 1. Výchozí 1. Rozsah od 1. Příklad 1. |
per | dotaz | celé číslo | ne | Počet zápisů na stránce. Výchozí 200. Rozsah od 1 do 1000. Příklad 50. |
Odpověď
200 application/json Stránka zápisů se součty.
| Pole | Význam |
|---|---|
total | Počet všech vyhovujících zápisů. |
sum | Součet částek všech vyhovujících zápisů v Kč. |
page | Vrácená stránka; per je velikost stránky. |
rows | Zápisy: id, date, text, debit_account (MD), credit_account (Dal), amount (Kč), source_type, document_id, document_number, variable_symbol, currency a amount_currency (u cizí měny). |
Chování
- Co změní
- Nic nezapisuje.
- Limity
- Nejvýše 1000 zápisů na stránce.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/entries?account=221&per=5"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/entries?account=221&per=5', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"total": 106,
"sum": 4658026.4,
"page": 1,
"per": 5,
"rows": [
{
"id": 1,
"date": "2026-01-01",
"text": "Počáteční stav – Provozní účet",
"debit_account": "221001",
"credit_account": "701",
"amount": 420000.0,
"source_type": "opening",
"document_id": null,
"document_number": null,
"variable_symbol": null,
"currency": null,
"amount_currency": null
},
{
"id": 89,
"date": "2026-01-14",
"text": "Úhrada · FP20260001 · Coworking Karlín s.r.o.",
"debit_account": "321",
"credit_account": "221001",
"amount": 17545.0,
"source_type": "payment",
"document_id": 30,
"document_number": "FP20260001",
"variable_symbol": "64364537",
"currency": "CZK",
"amount_currency": null
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Ruční účetní zápis
/entities/{entity_id}/entries
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Vytvoří jeden účetní zápis MD/Dal v Kč (interní doklad, dohadná položka, oprava) nebo s opening: true počáteční stav. Kódy účtů se převedou na velká písmena; oba účty musí být v účtovém rozvrhu firmy a strany se musí lišit. Částka se zaokrouhlí na haléře; chybějící, nečíselná nebo nulová částka je odmítnuta, záporná (červené storno) se přijme. Datum v uzamčeném období je odmítnuto.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
entry | objekt | ano | |
entry. | datum | ano | Datum zápisu (YYYY-MM-DD); chybějící nebo neplatné datum vrátí 400. |
entry. | text | ano | Účet strany MD (1–12 znaků, číslice, písmena, tečka, pomlčka). |
entry. | text | ano | Účet strany Dal; musí se lišit od MD. |
entry. | číslo | ne | Částka v Kč; přijme i desetinnou čárku („1500,50“). |
entry. | text | ne | Text zápisu; delší než 250 znaků se zkrátí. |
entry. | ano/ne | ne | true = počáteční stav (zdroj opening), jinak ruční zápis (manual). |
Odpověď
201 application/json Všechny sloupce vytvořeného zápisu: id, entity_id, date, debit_account, credit_account, amount, text, source_type (manual nebo opening), source_id, document_id, partner_id, currency, amount_currency, cost_center, variable_symbol, created_at, updated_at.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Datum leží v uzamčeném období („Období je uzamčeno“). |
| 422 | – | Účet není v účtovém rozvrhu („Účet … v účtovém rozvrhu firmy není“). |
| 422 | – | Chybí částka nebo je nulová („Zadejte nenulovou částku zápisu“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří jeden účetní zápis a zapíše událost entry.created do historie změn.
- Opakování
- Každé volání vytvoří další zápis; duplicity se nekontrolují.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"entry":{"date":"2026-08-31","debit_account":"518","credit_account":"389","amount":4200,"text":"Dohadná položka – energie za minulý měsíc"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/entriesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/entries', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"entry": {
"date": "2026-08-31",
"debit_account": "518",
"credit_account": "389",
"amount": 4200,
"text": "Dohadná položka – energie za minulý měsíc"
}
})
});
const data = await response.json();{
"id": 325,
"amount": 4200.0,
"amount_currency": null,
"cost_center": null,
"created_at": "2026-09-28T10:00:00.000Z",
"credit_account": "389",
"currency": null,
"date": "2026-08-31",
"debit_account": "518",
"document_id": null,
"entity_id": 1,
"partner_id": null,
"source_id": null,
"source_type": "manual",
"text": "Dohadná položka – energie za minulý měsíc",
"updated_at": "2026-09-28T10:00:00.000Z",
"variable_symbol": null
}
DELETE Smazání ručního zápisu
/entities/{entity_id}/entries/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže ruční zápis nebo počáteční stav, který nevznikl z jiného záznamu (source_type manual nebo opening bez source_id, tedy i počáteční stavy z importu předvahy). Zápisy z dokladů, úhrad, banky, odpisů, mezd, uzávěrky, kurzových rozdílů a počáteční stavy bankovních účtů tudy smazat nelze – vrátí 404. Zápis v uzamčeném období je odmítnut.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Ruční zápis nebo počáteční stav bez zdroje. Příklad 5120. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Datum zápisu leží v uzamčeném období („Období je uzamčeno“). |
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ápis a zapíše událost entry.deleted do historie změn s celým obsahem smazaného zápisu v details.entry (§ 35 odst. 3 zákona o účetnictví).
- Opakování
- Druhé volání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/entries/323JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/entries/323', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
GET Účetní sestava
/entities/{entity_id}/reports/{report}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí jednu sestavu podle hodnoty report. Každá sestava má vlastní parametry a strukturu odpovědi (viz variants). Sestavy jen čtou data a nic nezaúčtují.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
report | cesta | text | ano | Sestava. Hodnoty: dashboard, trial_balance, account, saldokonto, statements, cash_book, money, compliance, forecast, projects, insights. Příklad trial_balance. |
Odpověď
200 application/json Obsah sestavy podle varianty.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Neznámá hodnota report („Neznámá sestava“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nic nezapisuje. Sestavy s účty nebo doklady v cizí měně (money, dashboard, forecast, insights) mohou načíst kurz ČNB.
/entities/{entity_id}/reports/dashboard – Přehled firmy za účetní období
Tržby, náklady a zisk po 12 měsících účetního období (v podvojném účetnictví ze zápisů na účtech tříd 6 a 5 bez 59x, v daňové evidenci z peněžního deníku), peníze na účtech, otevřené pohledávky a závazky, odhad DPH za běžné období, počty, upozornění, 5 největších odběratelů a dodavatelů a 8 posledních dokladů.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
months | 12 měsíců – month, label (MM/YYYY), revenue, costs, profit; totals je jejich součet. |
money | Zůstatky účtů a pokladen k dnešku (jako sestava money). |
receivables | Otevřené vydané faktury a dobropisy v Kč – total, count, overdue, overdue_count, due_soon a due_soon_count (do 7 dní); payables totéž pro přijaté. |
vat | U plátce DPH odhad za běžné období – from, to, frequency, output, input, due, deadline; u neplátce null. |
counts | drafts (koncepty), unmatched (nespárované pohyby), partners, documents (doklady období). |
alerts | Upozornění – level, key, title, detail, amount, action; obsahuje i nejvýše 6 kontrol ze sestavy compliance. |
top_customers | 5 odběratelů s nejvyšším základem v Kč za období – partner_id, name, amount; top_suppliers totéž pro dodavatele. |
recent | 8 posledních dokladů všech druhů podle data vystavení, včetně konceptů (souhrn dokladu jako v seznamu dokladů). |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/dashboard?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/dashboard?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"months": [
{
"month": "2026-01-01",
"label": "01/2026",
"revenue": 153912.0,
"costs": 120138.9,
"profit": 33773.1
},
{
"month": "2026-02-01",
"label": "02/2026",
"revenue": 170076.0,
"costs": 126778.5,
"profit": 43297.5
}
],
"totals": {
"revenue": 2010755.1,
"costs": 1084021.5,
"profit": 926733.6
},
"money": {
"accounts": [
{
"id": 2,
"name": "Provozní účet",
"kind": "bank",
"currency": "CZK",
"number": "2900001227/2010",
"iban": "CZ3820100000002900001227",
"account_code": "221001",
"balance": 887525.6,
"balance_czk": 887525.6
},
{
"id": 6,
"name": "Rezervní účet",
"kind": "bank",
"currency": "CZK",
"number": "2900005005/2010",
"iban": null,
"account_code": "221002",
"balance": 0.0,
"balance_czk": 0.0
}
],
"total_czk": 897732.6
},
"receivables": {
"total": 198436.0,
"count": 4,
"overdue": 96558.0,
"overdue_count": 2,
"due_soon": 0.0,
"due_soon_count": 0
},
"payables": {
"total": 17545.0,
"count": 1,
"overdue": 0.0,
"overdue_count": 0,
"due_soon": 0.0,
"due_soon_count": 0
},
"vat": {
"from": "2026-09-01",
"to": "2026-09-30",
"frequency": "monthly",
"output": 57219.23,
"input": 13663.13,
"due": 43556.1,
"deadline": "2026-10-26"
},
"counts": {
"drafts": 2,
"unmatched": 6,
"partners": 17,
"documents": 79
},
"alerts": [
{
"level": "critical",
"key": "overdue",
"title": "2 faktury po splatnosti",
"detail": "Pošlete upomínku, dlužníci platí nejdřív tomu, kdo se ozve.",
"amount": 96558.0,
"action": "receivables"
},
{
"level": "warning",
"key": "unmatched",
"title": "6 nespárovaných bankovních pohybů",
"detail": "Přiřaďte je k fakturám nebo je zaúčtujte.",
"action": "bank"
}
],
"top_customers": [
{
"partner_id": 1,
"name": "Nordwood Studio s.r.o.",
"amount": 467200.0
},
{
"partner_id": 5,
"name": "Hafenlicht GmbH",
"amount": 389600.0
}
],
"top_suppliers": [
{
"partner_id": 12,
"name": "Autocentrum Morava s.r.o.",
"amount": 689000.0
},
{
"partner_id": 10,
"name": "Cloudwerk GmbH",
"amount": 252022.5
}
],
"recent": [
{
"id": 132,
"kind": "invoice_out",
"kind_label": "Faktura vydaná",
"status": "draft",
"number": null,
"variable_symbol": null,
"original_number": null,
"partner_id": 1,
"partner_name": "Nordwood Studio s.r.o.",
"partner_ico": "90000013",
"issue_date": "2026-09-28",
"taxable_date": "2026-09-28",
"due_date": "2026-10-12",
"currency": "CZK",
"total_net": 19800.0,
"total_vat": 4158.0,
"total_payable": 23958.0,
"total_gross_czk": 23958.0,
"paid_amount": 0.0,
"remaining": 23958.0,
"payment_state": "na",
"days_overdue": 0,
"description": "Návrh úvodní stránky",
"vat_mode": "domestic",
"source": "manual",
"tags": null,
"related_document_id": null,
"reminders_sent": 0,
"outcome": null,
"attachments_count": 0,
"approval_state": null,
"created_by_id": 1,
"created_by_name": "ukazka"
},
{
"id": 129,
"kind": "invoice_out",
"kind_label": "Faktura vydaná",
"status": "issued",
"number": "FV20260025",
"variable_symbol": "20260025",
"original_number": null,
"partner_id": 1,
"partner_name": "Nordwood Studio s.r.o.",
"partner_ico": "90000013",
"issue_date": "2026-09-28",
"taxable_date": "2026-09-28",
"due_date": "2026-10-12",
"currency": "CZK",
"total_net": 19800.0,
"total_vat": 4158.0,
"total_payable": 23958.0,
"total_gross_czk": 23958.0,
"paid_amount": 0.0,
"remaining": 23958.0,
"payment_state": "unpaid",
"days_overdue": 0,
"description": "Správa webu – září",
"vat_mode": "domestic",
"source": "manual",
"tags": null,
"related_document_id": null,
"reminders_sent": 0,
"outcome": null,
"attachments_count": 0,
"approval_state": null,
"created_by_id": 1,
"created_by_name": "ukazka"
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/trial_balance – Obratová předvaha
Po účtech tak, jak jsou v zápisech (analytické účty zvlášť): počáteční stav k začátku období, obraty MD a Dal a konečný stav. Počáteční stav rozvahových účtů zahrnuje převedený výsledek minulých let (428 nebo 429, se zapnutým držením výsledku 431) a počáteční stavy zapsané k prvnímu dni období (ty nejsou v obratech); výsledkové účty začínají od začátku účetního období. Účty bez stavu i obratů se vynechají.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
from | dotaz | datum | ne | Začátek období; výchozí je začátek účetního období year. Příklad 2026-01-01. |
to | dotaz | datum | ne | Konec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30. |
group | dotaz | text | ne | Sečíst analytiky do syntetických účtů (řádek pak nese analytics – počet analytik). Hodnoty: synthetic. Příklad synthetic. |
Pole odpovědi
| Pole | Význam |
|---|---|
rows | code, name, kind, opening, debit, credit, closing, analytic (analytický účet). |
classes | Součty za účtové třídy – account_class, label, opening, debit, credit, closing. |
totals | debit, credit, balanced (MD = Dal), opening, closing. |
range | Použité období {from, to}. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/trial_balance?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/trial_balance?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"rows": [
{
"code": "022",
"name": "Hmotné movité věci a jejich soubory",
"kind": "asset",
"opening": 0.0,
"debit": 773990.0,
"credit": 0.0,
"closing": 773990.0,
"analytic": false
},
{
"code": "211001",
"name": "Pokladna",
"kind": "asset",
"opening": 15000.0,
"debit": 6462.0,
"credit": 11255.0,
"closing": 10207.0,
"analytic": true
}
],
"totals": {
"debit": 8680557.8,
"credit": 8680557.8,
"balanced": true,
"opening": 0.0,
"closing": 0.0
},
"classes": [
{
"account_class": "0",
"label": "Dlouhodobý majetek",
"opening": 0.0,
"debit": 773990.0,
"credit": 0.0,
"closing": 773990.0
},
{
"account_class": "2",
"label": "Krátkodobý finanční majetek a peněžní prostředky",
"opening": 435000.0,
"debit": 2359238.0,
"credit": 1896505.4,
"closing": 897732.6
}
],
"range": {
"from": "2026-01-01",
"to": "2026-12-31"
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/account – Hlavní kniha účtu
Zápisy jednoho účtu za období chronologicky s průběžným zůstatkem. Kód se bere jako začátek, takže 311 zahrne i analytické účty 311xxx; počáteční stav se počítá stejně jako v předvaze.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
code | dotaz | text | ano | Kód účtu nebo jeho začátek (převede se na velká písmena); bez něj vrátí 400. Příklad 311. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
from | dotaz | datum | ne | Začátek období; výchozí je začátek účetního období year. Příklad 2026-01-01. |
to | dotaz | datum | ne | Konec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30. |
Pole odpovědi
| Pole | Význam |
|---|---|
code | Kód z dotazu; name je název účtu s přesně tímto kódem, jinak null. |
opening | Počáteční stav k začátku období. |
lines | Zápisy jako v deníku doplněné o debit, credit a balance (průběžný zůstatek). |
debit | Obrat MD; credit obrat Dal; closing konečný stav. |
range | Použité období {from, to}. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/account?code=311"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/account?code=311', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"code": "311",
"name": "Odběratelé",
"opening": 0.0,
"lines": [
{
"id": 5,
"date": "2026-01-04",
"text": "Faktura · FV20260001 · Nordwood Studio s.r.o.",
"debit_account": "311",
"credit_account": "602",
"amount": 75900.0,
"source_type": "document",
"document_id": 1,
"document_number": "FV20260001",
"variable_symbol": "20260001",
"currency": "CZK",
"amount_currency": null,
"debit": 75900.0,
"credit": 0.0,
"balance": 75900.0
},
{
"id": 6,
"date": "2026-01-04",
"text": "Faktura · FV20260001 · Nordwood Studio s.r.o.",
"debit_account": "311",
"credit_account": "343",
"amount": 15939.0,
"source_type": "document",
"document_id": 1,
"document_number": "FV20260001",
"variable_symbol": "20260001",
"currency": "CZK",
"amount_currency": null,
"debit": 15939.0,
"credit": 0.0,
"balance": 91839.0
}
],
"debit": 2315255.0,
"credit": 2116819.0,
"closing": 198436.0,
"range": {
"from": "2026-01-01",
"to": "2026-12-31"
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/saldokonto – Saldokonto pohledávek nebo závazků
Otevřené vystavené faktury a dobropisy k datu as_of podle úhrad do tohoto dne, po kontaktech a s rozdělením podle dnů po splatnosti. V podvojném účetnictví je zůstatek v Kč u dokladu podle zápisů na 311 nebo 321 (i s kurzovými rozdíly) a reconciliation porovná součet dokladů se stavem účtu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
side | dotaz | text | ne | receivables = vydané faktury a dobropisy, payables = přijaté; jiná hodnota znamená receivables. Hodnoty: receivables, payables. Výchozí receivables. Příklad payables. |
as_of | dotaz | datum | ne | Datum, ke kterému se saldokonto počítá; výchozí je dnešek. Příklad 2026-09-30. |
Pole odpovědi
| Pole | Význam |
|---|---|
partners | Kontakty seřazené podle dlužné částky – partner_id, name, ico, total_czk, overdue_czk a items (document_id, number, kind, issue_date, due_date, currency, total, remaining, remaining_czk, days_overdue, bucket). |
buckets | Součty podle stáří – not_due, d30, d60, d90, d90plus (key, label, total_czk). |
total_czk | Součet otevřených položek v Kč. |
reconciliation | Jen v podvojném účetnictví – account (311 nebo 321), ledger_total_czk, open_items_total_czk, difference_czk, reconciled. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/saldokonto?side=receivables"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/saldokonto?side=receivables', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"side": "receivables",
"as_of": "2026-09-28",
"partners": [
{
"partner_id": 5,
"name": "Hafenlicht GmbH",
"ico": null,
"total_czk": 77920.0,
"overdue_czk": 0.0,
"items": [
{
"document_id": 23,
"number": "FV20260023",
"kind": "invoice_out",
"issue_date": "2026-09-21",
"due_date": "2026-10-21",
"currency": "EUR",
"total": 3200.0,
"remaining": 3200.0,
"remaining_czk": 77920.0,
"days_overdue": 0,
"bucket": "not_due",
"partner_id": 5,
"partner_name": "Hafenlicht GmbH",
"partner_ico": null
}
]
},
{
"partner_id": 3,
"name": "Atelier Lumen s.r.o.",
"ico": "90000030",
"total_czk": 72600.0,
"overdue_czk": 72600.0,
"items": [
{
"document_id": 27,
"number": "FV20260024",
"kind": "invoice_out",
"issue_date": "2026-09-13",
"due_date": "2026-09-27",
"currency": "CZK",
"total": 72600.0,
"remaining": 72600.0,
"remaining_czk": 72600.0,
"days_overdue": 1,
"bucket": "d30",
"partner_id": 3,
"partner_name": "Atelier Lumen s.r.o.",
"partner_ico": "90000030"
}
]
}
],
"buckets": [
{
"key": "not_due",
"label": "Do splatnosti",
"total_czk": 101878.0
},
{
"key": "d30",
"label": "1–30 dní",
"total_czk": 96558.0
}
],
"total_czk": 198436.0,
"reconciliation": {
"account": "311",
"ledger_total_czk": 198436.0,
"open_items_total_czk": 198436.0,
"difference_czk": 0.0,
"reconciled": true
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/statements – Rozvaha a výkaz zisku a ztráty
Rozvaha a výkaz zisku a ztráty v druhovém členění za účetní období year s údaji minulého období, v rozsahu podle kategorie účetní jednotky z nastavení (mikro a malá zkrácený, střední a velká plný se všemi řádky vyhlášky; výchozí mikro; s povinným auditem vždy plný, § 3a odst. 1 vyhlášky). Počítá se ze zápisů s převodem výsledku; minulé období zahrnuje i počáteční stavy zapsané k prvnímu dni roku. Přečerpaný bankovní účet je v C.II.2, účty 559 a 561 se rozdělí podle protiúčtu (opravné položky k majetku E.1.2, k zásobám E.2, k pohledávkám E.3; prodané podíly G, ostatní dlouhodobý finanční majetek H, krátkodobý K) a rezerva na daň z příjmů se v B.2 sníží o zaplacené zálohy (§ 16 odst. 3). Určeno pro podvojné účetnictví, způsob vedení kód nekontroluje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
rozvaha | scope, full, aktiva, pasiva, aktiva_total, pasiva_total, cizi_zdroje, balanced, difference. |
vzz | Výkaz zisku a ztráty – layout, lines a result (provozni, financni, pred_dani, dan, po_dani, za_obdobi, cisty_obrat). |
cashflow | Přehled o peněžních tocích nepřímou metodou z rozvahy a výsledovky – rows (mark, label, value, kind), penize_zacatek, penize_konec, zmena, ties a note. Zaplacená daň = daň z výsledovky upravená o změnu účtu 341, vyplacené podíly ze změny výsledku minulých let a závazků ke společníkům; když přehled nenavazuje na stav peněz, je ties false a rozdíl má řádek X. equity je přehled o změnách vlastního kapitálu (rows s pocatek, zmena, konec a total). |
result | vh_za_obdobi, vh_za_obdobi_prev, vh_pred_zdanenim. |
checks | Kontroly výkazů; unmapped jsou účty se zůstatkem bez přiřazeného řádku. |
row_map | Přiřazení účtů k řádkům (derived u řádků rozdělených podle protiúčtu); line_options jsou platné hodnoty statement_line pro účty. |
notes | Upozornění k zařazení účtů, která Saldo samo nerozhodne (např. tržby z prodeje dlouhodobého finančního majetku na 661). |
period | Období {from, to}; category je kategorie účetní jednotky, opening_difference nevyrovnaný zůstatek účtu 701. |
accounts | Konečné zůstatky účtů – code, closing, previous. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/statements?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/statements?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"rozvaha": {
"scope": "zkraceny_mikro",
"full": false,
"aktiva": [
{
"code": "A",
"mark": "A.",
"label": "Pohledávky za upsaný základní kapitál",
"level": 0,
"visible": true,
"current": 0.0,
"prev": 0.0,
"korekce": 0.0,
"brutto": 0.0
},
{
"code": "B",
"mark": "B.",
"label": "Stálá aktiva",
"level": 0,
"visible": true,
"current": 773990.0,
"prev": 0.0,
"korekce": 0.0,
"brutto": 773990.0
}
],
"pasiva": [
{
"code": "A",
"mark": "A.",
"label": "Vlastní kapitál",
"level": 0,
"visible": true,
"current": 1361733.6,
"prev": 435000.0
},
{
"code": "A.I",
"mark": "A.I.",
"label": "Základní kapitál",
"level": 1,
"visible": false,
"current": 200000.0,
"prev": 200000.0
}
],
"aktiva_total": 1870158.6,
"pasiva_total": 1870158.6,
"cizi_zdroje": 508425.0,
"balanced": true,
"difference": 0.0
},
"cashflow": {
"rows": [
{
"mark": "P.",
"label": "Stav peněžních prostředků a peněžních ekvivalentů na začátku účetního období",
"value": 435000.0,
"kind": "sub"
},
{
"mark": "Z.",
"label": "Účetní zisk nebo ztráta před zdaněním",
"value": 926733.6,
"kind": "item"
}
],
"penize_zacatek": 435000.0,
"penize_konec": 897732.6,
"zmena": 462732.6,
"ties": true,
"note": "Nepřímá metoda z rozvahy (běžné a minulé období) a výkazu zisku a ztráty. Zaplacená daň je daň z výsledovky upravená o změnu závazku na účtu 341, vyplacené podíly se odvozují ze změny výsledku minulých let a závazků ke společníkům. Vyžaduje vyplněný sloupec „minulé období“."
},
"equity": {
"rows": [
{
"code": "A.I",
"label": "Základní kapitál",
"pocatek": 200000.0,
"zmena": 0.0,
"konec": 200000.0
},
{
"code": "A.II",
"label": "Ážio a kapitálové fondy",
"pocatek": 0.0,
"zmena": 0.0,
"konec": 0.0
}
],
"total": {
"label": "Vlastní kapitál celkem",
"pocatek": 435000.0,
"zmena": 926733.6,
"konec": 1361733.6
},
"note": "Změny vlastního kapitálu mezi minulým a běžným rozvahovým dnem. Vyžaduje vyplněný sloupec „minulé období\" v předvaze."
},
"vzz": {
"layout": "druhove",
"lines": [
{
"code": "v_trzby_vyrobky",
"mark": "I.",
"label": "Tržby z prodeje výrobků a služeb",
"level": 1,
"kind": "vynos",
"visible": true,
"current": 2003050.0,
"prev": 0.0
},
{
"code": "v_trzby_zbozi",
"mark": "II.",
"label": "Tržby za prodej zboží",
"level": 1,
"kind": "vynos",
"visible": true,
"current": 5340.0,
"prev": 0.0
}
],
"result": {
"provozni": 924558.6,
"financni": 2175.0,
"pred_dani": 926733.6,
"dan": 0.0,
"po_dani": 926733.6,
"za_obdobi": 926733.6,
"cisty_obrat": 2010755.1
}
},
"result": {
"vh_za_obdobi": 926733.6,
"vh_za_obdobi_prev": 0.0,
"vh_pred_zdanenim": 926733.6
},
"checks": [
{
"key": "predvaha",
"ok": true,
"detail": "Σ MD 2954180.10 vs Σ Dal 2954180.10 (rozdíl 0.00)"
},
{
"key": "bilance",
"ok": true,
"detail": "AKTIVA 1870158.60 vs PASIVA 1870158.60 (rozdíl 0.00)"
}
],
"unmapped": [],
"row_map": [
{
"id": 1,
"account_code": "022",
"target": "ak:B.II.2",
"label": "B.II.2. Hmotné movité věci a jejich soubory",
"auto": true
},
{
"id": 2,
"account_code": "211001",
"target": "ak:C.IV.1",
"label": "C.IV.1. Peněžní prostředky v pokladně",
"auto": true
}
],
"line_options": [
{
"value": "ak:A",
"group": "Rozvaha – aktiva",
"label": "A. Pohledávky za upsaný základní kapitál"
},
{
"value": "ak:B",
"group": "Rozvaha – aktiva",
"label": "B. Stálá aktiva"
}
],
"year": 2026,
"period": {
"from": "2026-01-01",
"to": "2026-12-31"
},
"category": "mikro",
"opening_difference": -0.0,
"accounts": [
{
"code": "022",
"closing": 773990.0,
"previous": 0.0
},
{
"code": "211001",
"closing": 10207.0,
"previous": 15000.0
}
],
"notes": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/cash_book – Peněžní deník
Příjmy a výdaje podle dne úhrady: úhrady faktur rozdělené podle položek a kategorií, pokladní doklady podle data vystavení a přímo zaúčtované bankovní pohyby; u plátce DPH se odděluje DPH. Určeno pro daňovou evidenci, způsob vedení kód nekontroluje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
from | dotaz | datum | ne | Začátek období; výchozí je začátek účetního období year. Příklad 2026-01-01. |
to | dotaz | datum | ne | Konec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30. |
Pole odpovědi
| Pole | Význam |
|---|---|
rows | date, number, text, partner, category, category_name, kind, tax_relevant, amount (příjem kladně, výdaj záporně), vat, base, source (Úhrada, Pokladna, Banka), document_id. |
categories | Součty po kategoriích – code, name, kind, tax_relevant, income, expense. |
totals | income, expense a profit (jen daňové kategorie), cash_in, cash_out, vat_net. |
range | Použité období {from, to}. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/2/reports/cash_book?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/2/reports/cash_book?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"rows": [
{
"date": "2026-01-07",
"number": "…alth-2025-12",
"text": "Záloha ZP prosinec 2025",
"partner": "Všeobecná zdravotní pojišťovna ČR",
"category": "V91",
"category_name": "Pojistné OSVČ – sociální a zdravotní",
"kind": "neutral",
"tax_relevant": false,
"amount": -3143.0,
"vat": 0.0,
"base": -3143.0,
"source": "Banka",
"document_id": null
},
{
"date": "2026-01-13",
"number": "VP20260001",
"text": "Kancelářské a výtvarné potřeby",
"partner": "Papírnictví Dvořák",
"category": "V01",
"category_name": "Nákup materiálu",
"kind": "expense",
"tax_relevant": true,
"amount": -678.0,
"vat": -0.0,
"base": -678.0,
"source": "Pokladna",
"document_id": 99
}
],
"categories": [
{
"code": "P01",
"name": "Příjmy z prodeje zboží",
"kind": "revenue",
"tax_relevant": true,
"income": 5340.0,
"expense": 0.0
},
{
"code": "P02",
"name": "Příjmy z prodeje výrobků a služeb",
"kind": "revenue",
"tax_relevant": true,
"income": 604500.0,
"expense": 22800.0
}
],
"totals": {
"income": 587040.0,
"expense": 71205.9,
"profit": 515834.1,
"cash_in": 609840.0,
"cash_out": 270764.8,
"vat_net": 0.0,
"uncategorized": {
"income": 0.0,
"expense": -0.0,
"count": 0,
"codes": []
}
},
"range": {
"from": "2026-01-01",
"to": "2026-12-31"
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/money – Peníze na účtech a v pokladnách
Zůstatky aktivních bankovních účtů a pokladen k datu on. V podvojném účetnictví se zůstatek účtu v Kč bere ze zápisů na jeho účtu 21x/22x; v daňové evidenci a u účtů v cizí měně z počátečního stavu, pohybů, ručních úhrad a pokladních dokladů. balance_czk účtu v cizí měně je v podvojném účetnictví účetní hodnota, v daňové evidenci přepočet kurzem ČNB k datu (bez kurzu null).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
on | dotaz | datum | ne | Datum zůstatků; výchozí je dnešek. Příklad 2026-09-30. |
Pole odpovědi
| Pole | Význam |
|---|---|
accounts | id, name, kind (bank nebo cash), currency, number, iban, account_code, balance (v měně účtu), balance_czk. |
total_czk | Součet balance_czk. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/reports/moneyJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/money', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"accounts": [
{
"id": 2,
"name": "Provozní účet",
"kind": "bank",
"currency": "CZK",
"number": "2900001227/2010",
"iban": "CZ3820100000002900001227",
"account_code": "221001",
"balance": 887525.6,
"balance_czk": 887525.6
},
{
"id": 6,
"name": "Rezervní účet",
"kind": "bank",
"currency": "CZK",
"number": "2900005005/2010",
"iban": null,
"account_code": "221002",
"balance": 0.0,
"balance_czk": 0.0
}
],
"total_czk": 897732.6
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/compliance – Kontroly lhůt a limitů
Kontroly k dnešku: oprava odpočtu DPH u faktur 6 měsíců po splatnosti (§ 74b ZDPH), daňové doklady vystavené po lhůtě, čísla dodavatelů delší než 60 znaků pro kontrolní hlášení, hotovostní platby nad 270 000 Kč, nespolehliví plátci a kontakty v insolvenci podle uloženého stavu kontaktů (bez dotazu do registrů), registrace k DPH u neplátce, povinnost identifikované osoby u neplátce (§ 6h a § 6i ZDPH: přijatá nebo poskytnutá služba s partnerem z jiného státu EU za posledních 12 měsíců, jinak karetní platby Googlu, Mety, Adobe a podobných ve výpisu) a vratka záloh OSVČ v roce 2026. Kontroly DPH běží jen u plátce.
Pole odpovědi
| Pole | Význam |
|---|---|
checks | level (critical, warning, info), key (vat_74b, issue_15, advance_tax_document – platba zálohy plátce bez daňového dokladu, register_note – firmě v rejstříku chybí zápis na fakturách, kh_number, cash_limit, unreliable, insolvency, vat_registration, identified_person, sp_refund_2026), title, detail, document_id, number. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/reports/complianceJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/compliance', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"checks": [
{
"level": "warning",
"key": "advance_tax_document",
"title": "K platbě zálohy ZV20260002 chybí daňový doklad",
"detail": "Platba 48 400,00 Kč přijatá 15. 9. 2026 zakládá povinnost přiznat DPH k tomuto dni (§ 21 odst. 1 ZDPH). Daňový doklad k přijaté platbě se vystavuje do 15 dnů, tedy do 30. 9. 2026 (§ 28 odst. 8 ZDPH). V zálohové faktuře zvolte ⋯ → Daňový doklad k přijaté platbě.",
"document_id": 134,
"number": "ZV20260002"
}
]
}
/entities/{entity_id}/reports/forecast – Výhled peněz na dny dopředu
Dnešní zůstatek všech účtů a pokladen plus očekávané příjmy a výdaje: neuhrazené vystavené faktury, zálohové faktury a dobropisy k datu splatnosti (po splatnosti odhadem za 7 dní u pohledávek a za 3 dny u závazků), aktivní opakované faktury, DPH a zálohy OSVČ jako v Platbách úřadům (zaplacené se nepočítají) a mzdy podle posledního měsíce (čisté 15., odvody 20. následujícího měsíce, každá platba do svého dne). Vrací denní průběh, týdenní součty a nejnižší bod.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
days | dotaz | celé číslo | ne | Horizont ve dnech; mimo rozsah se ořízne. Výchozí 90. Rozsah od 14 do 180. Příklad 30. |
Pole odpovědi
| Pole | Význam |
|---|---|
opening | Dnešní zůstatek v Kč; closing zůstatek na konci horizontu (until). |
inflow | Součet očekávaných příjmů; outflow výdajů (záporně). |
low | Den s nejnižším zůstatkem {date, change, balance}. |
series | Každý den horizontu včetně dneška – date, change, balance. |
weeks | Po týdnech – week (pondělí), inflow, outflow. |
items | Nejvýše 60 položek – date, amount, kind (receivable, payable, recurring, vat, payroll, zp, sp), estimated, label, u faktur document_id a overdue; count je jejich celkový počet. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/forecast?days=30"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/forecast?days=30', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"today": "2026-09-28",
"until": "2026-10-28",
"opening": 897732.6,
"closing": 1034431.6,
"inflow": 275876.0,
"outflow": -139177.0,
"low": {
"date": "2026-09-28",
"change": 0.0,
"balance": 897732.6
},
"series": [
{
"date": "2026-09-28",
"change": 0.0,
"balance": 897732.6
},
{
"date": "2026-09-29",
"change": 0.0,
"balance": 897732.6
}
],
"weeks": [
{
"week": "2026-10-05",
"inflow": 96558.0,
"outflow": -17545.0
},
{
"week": "2026-10-12",
"inflow": 101398.0,
"outflow": -49230.0
}
],
"items": [
{
"date": "2026-10-05",
"amount": 72600.0,
"kind": "receivable",
"estimated": true,
"label": "FV20260024 · Atelier Lumen s.r.o.",
"document_id": 27,
"overdue": true
},
{
"date": "2026-10-05",
"amount": 23958.0,
"kind": "receivable",
"estimated": true,
"label": "FV20260026 · Nordwood Studio s.r.o.",
"document_id": 130,
"overdue": true
}
],
"count": 9
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/projects – Zakázky a střediska
Výnosy, náklady a marže po zakázkách nebo střediscích z vystavených dokladů účetního období podle DUZP (jinak data vystavení). U neplátce DPH a u neodpočitatelné DPH se DPH počítá do nákladů. Doklady bez zakázky nebo střediska tvoří vlastní řádek. S only=values vrátí jen seznam použitých hodnot.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
dimension | dotaz | text | ne | project = zakázka, cost_center = středisko; jiná hodnota znamená project. Hodnoty: project, cost_center. Výchozí project. Příklad cost_center. |
only | dotaz | text | ne | values = vrátit jen {values}. Hodnoty: values. Příklad values. |
Pole odpovědi
| Pole | Význam |
|---|---|
rows | key, label, revenue, costs, margin, margin_share (%), documents_count, months (12 měsíčních výsledků) a documents (nejvýše 200 nejnovějších – id, number, kind, partner, date, amount). |
totals | revenue, costs, margin, margin_share. |
values | Použité hodnoty {project: [], cost_center: []}, každé nejvýše 500. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/projects?dimension=cost_center"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/projects?dimension=cost_center', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"dimension": "cost_center",
"rows": [
{
"key": "Praha",
"label": "Praha",
"revenue": 1199090.0,
"costs": 532612.5,
"margin": 666477.5,
"margin_share": 55.6,
"documents_count": 58,
"months": [
103257.5,
-48702.5
],
"documents": [
{
"id": 23,
"number": "FV20260023",
"kind": "invoice_out",
"partner": "Hafenlicht GmbH",
"date": "2026-09-21",
"amount": 77920.0
},
{
"id": 70,
"number": "VP20260005",
"kind": "cash_out",
"partner": "Papírnictví Dvořák",
"date": "2026-09-13",
"amount": -1860.0
}
]
},
{
"key": "Morava",
"label": "Morava",
"revenue": 769700.0,
"costs": 689000.0,
"margin": 80700.0,
"margin_share": 10.5,
"documents_count": 12,
"months": [
0.0,
-519400.0
],
"documents": [
{
"id": 22,
"number": "FV20260022",
"kind": "invoice_out",
"partner": "Kavárna U Zeleného stromu s.r.o.",
"date": "2026-09-15",
"amount": 64000.0
},
{
"id": 27,
"number": "FV20260024",
"kind": "invoice_out",
"partner": "Atelier Lumen s.r.o.",
"date": "2026-09-13",
"amount": 120000.0
}
]
}
],
"values": {
"project": [
"Rebranding kavárny",
"Redesign e-shopu Lumen"
],
"cost_center": [
"Morava",
"Praha"
]
},
"totals": {
"revenue": 2008390.0,
"costs": 1236112.5,
"margin": 772277.5,
"margin_share": 38.5
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
/entities/{entity_id}/reports/insights – Přehled pro majitele
Kolik peněz je opravdu k dispozici po odečtení DPH, rezervy na daň z příjmů a závazků splatných do 14 dnů (available); u OSVČ kolik si měsíčně odkládat na daň a pojistné (set_aside); průměrné měsíční spalování a na jak dlouho peníze vystačí podle posledních 6 ukončených měsíců (runway); srovnání tržeb, nákladů, marže a doby úhrady faktur s loňskem (health).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
year | dotaz | celé číslo | ne | Účetní období pro health; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
Pole odpovědi
| Pole | Význam |
|---|---|
available | total, total_with_receivables, horizon, money, vat, reserve, payables, receivables. U s.r.o. má reserve kind dppo, profit (účetní zisk), base (zaokrouhlený základ daně, ze kterého se počítá), rate, tax, paid a amount. |
set_aside | Jen u fyzické osoby, jinak null. |
runway | months_used, from, to, burn, money, months, until, series. |
health | Srovnání s loňskem včetně dso a dpo; null, pokud účetní období ještě nezačalo. |
segment | Segment z profilu firmy (osvc, startup, small, growing, accountant); natural_person je boolean. |
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/reports/insights?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/insights?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"today": "2026-09-28",
"segment": "small",
"natural_person": false,
"available": {
"total": 674721.6,
"total_with_receivables": 698679.6,
"horizon": "2026-10-12",
"money": {
"total": 897732.6,
"accounts": [
{
"id": 2,
"name": "Provozní účet",
"kind": "bank",
"currency": "CZK",
"balance": 887525.6,
"balance_czk": 887525.6
},
{
"id": 6,
"name": "Rezervní účet",
"kind": "bank",
"currency": "CZK",
"balance": 0.0,
"balance_czk": 0.0
}
]
},
"vat": {
"due": 43556.0,
"refund": 0.0,
"periods": [
{
"key": "2026-09",
"label": "září 2026",
"deadline": "2026-10-26",
"complete": false,
"own_tax": 43556.0,
"excess_deduction": 0.0,
"paid": false
}
]
},
"reserve": {
"kind": "dppo",
"amount": 161910.0,
"tax": 161910.0,
"paid": 0.0,
"profit": 926733.6,
"base": 771000.0,
"rate": 0.21,
"from": "2026-01-01",
"to": "2026-09-28"
},
"payables": {
"amount": 17545.0,
"count": 1,
"overdue_amount": 0.0,
"overdue_count": 0
},
"receivables": {
"amount": 23958.0,
"count": 1,
"overdue_amount": 0.0,
"overdue_count": 0
}
},
"set_aside": null,
"runway": {
"months_used": 6,
"from": "2026-03-01",
"to": "2026-08-31",
"burn": -39578.85,
"money": 897732.6,
"months": null,
"until": null,
"series": [
{
"month": "2026-03-01",
"inflow": 329786.0,
"outflow": 1019307.4,
"financing": 0.0,
"net": -689521.4
},
{
"month": "2026-04-01",
"inflow": 315145.0,
"outflow": 94277.5,
"financing": 0.0,
"net": 220867.5
}
]
},
"health": {
"from": "2026-01-01",
"to": "2026-09-28",
"previous_from": "2025-01-01",
"previous_to": "2025-09-28",
"current": {
"revenue": 2010755.1,
"costs": 1080821.5,
"result": 929933.6,
"sales": 2008390.0,
"direct_costs": 464522.5
},
"previous": {
"revenue": 0.0,
"costs": 0.0,
"result": 0.0,
"sales": 0.0,
"direct_costs": 0.0
},
"has_previous": false,
"change": {
"revenue": null,
"costs": null,
"result": null
},
"difference": {
"revenue": 2010755.1,
"costs": 1080821.5,
"result": 929933.6
},
"gross_margin": {
"share": 76.9,
"previous": null
},
"dso": {
"days": 15,
"count": 24,
"terms": 17,
"previous": null
},
"dpo": {
"days": 9,
"count": 38,
"terms": 11,
"previous": null
}
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Kontrolní seznam roční uzávěrky
/entities/{entity_id}/closing
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí kroky roční uzávěrky účetního období se stavem každého kroku (banka, koncepty, pohledávky po splatnosti, odpisy, kurzové rozdíly, mzdy, DPH, daň z příjmů, výkazy, uzamčení), náhled kurzových rozdílů k rozvahovému dni a vypočtenou a zaúčtovanou daň z příjmů právnické osoby. Kroky, které se firmy netýkají, se vynechají: odpisy, kurzové rozdíly a výkazy v daňové evidenci, odpisy také bez odpisovaného majetku, banka bez bankovního účtu, mzdy bez pracovníků, DPH bez registrace k DPH a daň z příjmů mimo právnické osoby v podvojném účetnictví.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Stav roční uzávěrky.
| Pole | Význam |
|---|---|
date | Rozvahový den (poslední den účetního období); finished říká, zda už minul, locked, zda je uzamčený. |
double_entry | Zda firma vede podvojné účetnictví. |
steps | Kroky – key (bank, drafts, receivables, depreciation, revaluation, payroll, vat, income_tax, statements, lock), title, state (done, todo, warning, info, waiting), detail, action (lock, depreciation, revaluation, income_tax nebo null) a link do aplikace. |
revaluation | Náhled kurzových rozdílů (jako odpověď postFxRevaluation); do rozvahového dne včetně {future: true, rows: [], posted: false}; v daňové evidenci null. |
income_tax | computed (daň podle výpočtu, celé Kč), posted (zaúčtováno 591), entry_date, up_to_date; null mimo právnické osoby v podvojném účetnictví. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | U právnické osoby v podvojném účetnictví pro rok, pro který Saldo nemá zákonné sazby daně z příjmů – výpočet daně selže („Pro rok RRRR nejsou k dispozici zákonné sazby“) a kontrolní seznam se nevrátí. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nic nezapisuje. Po rozvahovém dni načítá kurzy ČNB k náhledu kurzových rozdílů.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"date": "2026-12-31",
"finished": false,
"locked": false,
"double_entry": true,
"steps": [
{
"key": "bank",
"title": "Bankovní výpisy za celý rok",
"state": "todo",
"detail": "6 nespárovaných pohybů v tomto účetním roce. Provozní účet: poslední pohyb 25. 9. 2026 · Rezervní účet: žádné pohyby",
"action": null,
"link": "#/banka?year=2026"
},
{
"key": "drafts",
"title": "Koncepty dokladů",
"state": "warning",
"detail": "2 koncepty s datem v roce 2026 – koncepty se nezaúčtují, dokud je nevystavíte.",
"action": null,
"link": "#/doklady/prijate?state=draft&year=2026"
}
],
"revaluation": {
"future": true,
"rows": [],
"posted": false
},
"income_tax": {
"computed": 161910.0,
"posted": 0.0,
"entry_date": "2026-12-31",
"up_to_date": false,
"reserve": 0.0
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Kontrolní seznam měsíční uzávěrky
/entities/{entity_id}/closing/month
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí kroky měsíční uzávěrky zvoleného měsíce: banka za celý měsíc (nespárované pohyby a pokrytí výpisy; účet bez jediného výpisu za měsíc je úkol), přechodné účty v podvojném účetnictví (261, 395 a syntetické 221/211 musí mít k poslednímu dni měsíce nulový zůstatek), koncepty, skeny přijatých dokladů, záporná pokladna, přiznání k DPH a kontrolní hlášení (u plátce), souhrnné hlášení (klíč sh, jen v období s dodáním zboží nebo službou do jiného státu EU), mzdy a uzamčení. Kroky, které se firmy netýkají, se vynechají.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Kalendářní rok; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ano | Měsíc 1–12. Rozsah od 1 do 12. Příklad 8. |
Odpověď
200 application/json Stav měsíční uzávěrky.
| Pole | Význam |
|---|---|
from | První den měsíce; date poslední den, finished zda měsíc skončil, locked zda je uzamčený. |
steps | Kroky – key (bank, clearing, drafts, attachments, cash, vat, kh, payroll, lock), title, state (done, todo, warning, info, waiting), detail, action (lock nebo null), link. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 400 | – | month chybí nebo není 1–12 („Zvolte měsíc 1–12“). |
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/closing/month?year=2026&month=1"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/month?year=2026&month=1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"month": 1,
"from": "2026-01-01",
"date": "2026-01-31",
"finished": true,
"locked": false,
"steps": [
{
"key": "bank",
"title": "Banka za celý měsíc",
"state": "todo",
"detail": "Za celý měsíc chybí výpis účtu Provozní účet, Rezervní účet – nahrajte datový export a PDF výpis, i když se na účtu nic nedělo. Provozní účet: poslední pohyb 30. 1. 2026 · Rezervní účet: zatím žádné pohyby",
"action": null,
"link": "#/banka?year=2026"
},
{
"key": "clearing",
"title": "Přechodné účty",
"state": "done",
"detail": "Peníze na cestě (261), vnitřní zúčtování (395) i syntetické účty 221 a 211 jsou vyrovnané.",
"action": null,
"link": null
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Zaúčtování kurzových rozdílů k rozvahovému dni
/entities/{entity_id}/closing/revaluation
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Přecení otevřené vydané a přijaté faktury a dobropisy v cizí měně (podle zůstatku na 311/321) a bankovní účty a pokladny v cizí měně kurzem ČNB k rozvahovému dni a rozdíly zaúčtuje na 563/663. U faktur se k prvnímu dni dalšího období zaúčtuje storno (pokud není uzamčeno), u účtů a pokladen ne. Účet v cizí měně s nespárovanými pohyby do rozvahového dne se nepřecení. Dřívější přecenění téhož roku se nejdřív smaže, výsledek tedy nahrazuje předchozí.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Náhled přecenění po zaúčtování.
| Pole | Význam |
|---|---|
date | Rozvahový den; reversal_date den storna u faktur. |
rows | Položky – type (document nebo money), id, label, account, currency, open_amount, book_value, book_rate, rate, new_value, difference, effect, reverse, number, kind, blocked (důvod, proč se nepřecenila). |
gain | Kurzové zisky; loss ztráty; net výsledek přecenění. |
missing_rates | Měny bez kurzu ČNB (při zaúčtování vedou k chybě). |
blocked | Počet účtů čekajících na spárování pohybů. |
posted | Zda k rozvahovému dni existuje aspoň jeden zápis přecenění – bez nenulového rozdílu zůstane false i po zaúčtování; posted_on je čas vytvoření posledního zápisu. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví („Kurzové rozdíly k rozvahovému dni se účtují jen v podvojném účetnictví“). |
| 422 | – | Rozvahový den je v uzamčeném období („Období k … je uzamčeno – kurzové rozdíly už nelze měnit“). |
| 422 | – | Rozvahový den ještě nenastal („Kurzové rozdíly se účtují až po rozvahovém dni …“). |
| 422 | – | Pro některou měnu chybí kurz ČNB („Chybí kurz ČNB k … pro …“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže dřívější zápisy přecenění k rozvahovému dni a ke dni storna, vytvoří nové zápisy 563/663 (zdroj revaluation) a u faktur jejich storna, zapíše událost closing.revaluation do historie změn. Načítá kurzy ČNB.
- Opakování
- Opakování vede ke stejnému zaúčtování (staré zápisy se nahradí), pokaždé ale přibude událost v historii.
Příklad
Ukázková firma nemá ke konci roku 2025 položky v cizí měně, výsledek proto nemá řádky, nic se nezaúčtuje a posted zůstane false.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/revaluation?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/revaluation?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"year": 2025,
"date": "2025-12-31",
"reversal_date": "2026-01-01",
"rows": [],
"gain": 0.0,
"loss": 0.0,
"net": 0.0,
"missing_rates": [],
"blocked": 0,
"posted": false,
"posted_on": null,
"posted_net": 0.0
}
DELETE Zrušení kurzových rozdílů k rozvahovému dni
/entities/{entity_id}/closing/revaluation
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže zápisy přecenění k rozvahovému dni a jejich storna ke dni následujícímu. Platí stejné podmínky jako pro zaúčtování, včetně toho, že rozvahový den už musí minout.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Náhled přecenění po zrušení (stejný tvar jako u postFxRevaluation, posted false).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví („Kurzové rozdíly k rozvahovému dni se účtují jen v podvojném účetnictví“). |
| 422 | – | Rozvahový den je v uzamčeném období („Období k … je uzamčeno – kurzové rozdíly už nelze měnit“). |
| 422 | – | Rozvahový den ještě nenastal („Kurzové rozdíly se účtují až po rozvahovém dni …“). |
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 zdroje revaluation k rozvahovému dni a ke dni storna a zapíše událost closing.revaluation_removed do historie změn. Načítá kurzy ČNB pro náhled.
- Opakování
- Opakování nic dalšího nesmaže, ale pokaždé zapíše událost do historie.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/revaluation?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/revaluation?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();{
"year": 2025,
"date": "2025-12-31",
"reversal_date": "2026-01-01",
"rows": [],
"gain": 0.0,
"loss": 0.0,
"net": 0.0,
"missing_rates": [],
"blocked": 0,
"posted": false,
"posted_on": null,
"posted_net": 0.0
}
POST Zaúčtování daně z příjmů právnické osoby
/entities/{entity_id}/closing/income_tax
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Spočítá daň z příjmů právnických osob za účetní období (zaokrouhlenou na celé Kč) a zaúčtuje ji jedním zápisem 591/341 k rozvahovému dni; dřívější zápis daně téhož období se nejdřív smaže. Nulová daň se nezaúčtuje. Zaúčtovat jde až po rozvahovém dni (zrušit kdykoli).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Stav daně po zaúčtování.
| Pole | Význam |
|---|---|
computed | Daň podle aktuálního výpočtu v celých Kč. |
posted | Součet zaúčtované daně (591) v období. |
entry_date | Datum zápisu (rozvahový den). |
up_to_date | Zda zaúčtovaná daň odpovídá výpočtu. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma není právnická osoba v podvojném účetnictví („Daň z příjmů se takto účtuje jen u právnických osob v podvojném účetnictví“). |
| 422 | – | Rozvahový den je v uzamčeném období („Rok … je uzamčený – zaúčtování daně už nelze měnit“). |
| 422 | – | Období ještě neskončilo („Daň z příjmů za rok … se účtuje až po rozvahovém dni …“). |
| 422 | – | Pro rok nejsou v Saldu zákonné sazby daně z příjmů („Pro rok RRRR nejsou k dispozici zákonné sazby“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže dřívější zápisy daně (zdroj closing, MD 591) v období, vytvoří nový zápis 591/341 a zapíše událost closing.income_tax do historie změn.
- Opakování
- Opakování nahradí zápis aktuálně vypočtenou daní; pokaždé přibude událost v historii.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/income_tax?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/income_tax?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"computed": 0.0,
"posted": 0.0,
"entry_date": "2025-12-31",
"up_to_date": true,
"reserve": 0.0
}
DELETE Zrušení zaúčtované daně z příjmů
/entities/{entity_id}/closing/income_tax
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže zápisy daně z příjmů (591) daného účetního období. Platí stejné podmínky jako pro zaúčtování, jen období nemusí být skončené.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Stav daně po zrušení (computed, posted 0, entry_date, up_to_date).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma není právnická osoba v podvojném účetnictví („Daň z příjmů se takto účtuje jen u právnických osob v podvojném účetnictví“). |
| 422 | – | Rozvahový den je v uzamčeném období („Rok … je uzamčený – zaúčtování daně už nelze měnit“). |
| 422 | – | Pro rok nejsou v Saldu zákonné sazby daně z příjmů („Pro rok RRRR nejsou k dispozici zákonné sazby“) – podmínky se ověřují výpočtem daně, takže ani zrušení neproběhne. |
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 daně období a zapíše událost closing.income_tax_removed do historie změn.
- Opakování
- Opakování nic dalšího nesmaže, ale pokaždé zapíše událost do historie.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/income_tax?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/income_tax?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();{
"computed": 161910.0,
"posted": 0.0,
"entry_date": "2026-12-31",
"up_to_date": false,
"reserve": 0.0
}
GET Časové rozlišení, dohadné položky a rezervy
/entities/{entity_id}/accruals
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Seznam uzávěrkových operací firmy – časové rozlišení s měsíčním plánem rozpuštění (381 náklady a 384 výnosy příštích období), výdaje a příjmy příštích období (383, 385), dohadné položky (389, 388) a rezervy (459, 451, 453) – s tím, co je zaúčtované a co zbývá. Se zadaným rokem vrátí otevřené položky a položky se zápisy v tom roce.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Volitelně kalendářní rok, jehož položky chcete vidět (otevřené se vrátí vždy). Rozsah od 2000 do 2100. Příklad 2026. |
Odpověď
200 application/json Druhy operací (kinds s popisem a výchozími účty) a položky (accruals).
| Pole | Význam |
|---|---|
kinds | Klíč druhu → label, balance (výchozí rozvahový účet), result (výchozí výsledkový účet), spread (zda má měsíční plán). |
accruals | Položky ve stejném tvaru jako u getAccrual. |
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/accruals?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"kinds": {
"prepaid_expense": {
"label": "Náklady příštích období",
"balance": "381",
"result": "518",
"spread": true
},
"deferred_revenue": {
"label": "Výnosy příštích období",
"balance": "384",
"result": "602",
"spread": true
},
"accrued_expense": {
"label": "Výdaje příštích období",
"balance": "383",
"result": "518",
"spread": false
},
"accrued_revenue": {
"label": "Příjmy příštích období",
"balance": "385",
"result": "602",
"spread": false
},
"estimate_payable": {
"label": "Dohadná položka pasivní",
"balance": "389",
"result": "518",
"spread": false
},
"estimate_receivable": {
"label": "Dohadná položka aktivní",
"balance": "388",
"result": "602",
"spread": false
},
"provision": {
"label": "Rezerva",
"balance": "459",
"result": "554",
"spread": false
}
},
"accruals": [
{
"id": 1,
"kind": "estimate_payable",
"kind_label": "Dohadná položka pasivní",
"title": "Elektřina září – dohad",
"balance_account": "389",
"result_account": "502",
"amount": 3200.0,
"start_on": "2026-09-30",
"end_on": null,
"initial_on": null,
"post_initial": true,
"initial_posted": true,
"released": 0.0,
"remaining": 3200.0,
"open": true,
"years": [
2026
],
"cost_center": null,
"note": null,
"document": null,
"partner": null,
"plan": [],
"entries": [
{
"id": 324,
"date": "2026-09-30",
"debit_account": "502",
"credit_account": "389",
"amount": 3200.0,
"text": "Dohadná položka pasivní – Elektřina září – dohad"
}
]
}
]
}
POST Nové časové rozlišení, dohad nebo rezerva
/entities/{entity_id}/accruals
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Jen v podvojném účetnictví. Založí položku a zaúčtuje úvodní zápis k initial_on (jinak start_on): u aktivních druhů MD rozvahový účet / D výsledkový účet, u pasivních obráceně (například dohad MD 518 / D 389, rezerva MD 554 / D 459). Časové rozlišení s plánem (prepaid_expense, deferred_revenue) úvodní zápis vynechá, když post_initial je false – faktura je zaúčtovaná rovnou na 381 nebo 384. Plán rozpouští stejnou částku každý celý měsíc od start_on do end_on, jinak podle dnů.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
accrual | objekt | ano | |
accrual. | text | ano | Druh operace. Hodnoty: prepaid_expense, deferred_revenue, accrued_expense, accrued_revenue, estimate_payable, estimate_receivable, provision. |
accrual. | text | ano | Popis, nejvýš 200 znaků. |
accrual. | číslo | ano | Částka v Kč, kladná. |
accrual. | datum | ano | Začátek období (u plánu) nebo den vzniku dohadu či rezervy. |
accrual. | datum | ne | Konec období plánu (jen prepaid_expense a deferred_revenue, nejvýš 10 let). |
accrual. | datum | ne | Den úvodního zápisu, nejpozději start_on (např. 31. 12. pro část pojištění na příští rok). |
accrual. | ano/ne | ne | Jen u plánu – zaúčtovat úvodní přeúčtování (výchozí true). |
accrual. | text | ne | Rozvahový účet (výchozí podle druhu; rezerva 451, 453 nebo 459). |
accrual. | text | ne | Nákladový (5xx) nebo výnosový (6xx) účet podle druhu, výchozí 518, 554 nebo 602; u rezervy na daň z příjmů (453) výchozí 591 a povinně účet skupiny 59, ostatní rezervy skupinu 59 mít nesmí (ČÚS č. 004, bod 4.1). |
accrual. | celé číslo | ne | Doklad firmy, ke kterému položka patří. |
accrual. | celé číslo | ne | Kontakt firmy. |
accrual. | text | ne | Středisko. |
accrual. | text | ne | Poznámka. |
Odpověď
201 application/json Založená položka ve tvaru getAccrual.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví, účty neodpovídají druhu nebo nejsou v účtovém rozvrhu firmy, plán nemá konec po začátku, doklad nebo kontakt nepatří k firmě, nebo úvodní zápis padá do uzamčeného období. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Založí položku, zaúčtuje úvodní zápis (zdroj accrual) a zapíše událost accrual.created.
- Opakování
- Každé volání založí další položku.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"accrual":{"kind":"prepaid_expense","title":"Pojištění vozidel 7/2026–6/2027","amount":12000,"result_account":"548","start_on":"2026-07-01","end_on":"2027-06-30"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/accrualsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"accrual": {
"kind": "prepaid_expense",
"title": "Pojištění vozidel 7/2026–6/2027",
"amount": 12000,
"result_account": "548",
"start_on": "2026-07-01",
"end_on": "2027-06-30"
}
})
});
const data = await response.json();{
"id": 2,
"kind": "prepaid_expense",
"kind_label": "Náklady příštích období",
"title": "Pojištění vozidel 7/2026–6/2027",
"balance_account": "381",
"result_account": "548",
"amount": 12000.0,
"start_on": "2026-07-01",
"end_on": "2027-06-30",
"initial_on": null,
"post_initial": true,
"initial_posted": true,
"released": 0.0,
"remaining": 12000.0,
"open": true,
"years": [
2026,
2027
],
"cost_center": null,
"note": null,
"document": null,
"partner": null,
"plan": [
{
"date": "2026-07-31",
"amount": 1000.0,
"posted": false
},
{
"date": "2026-08-31",
"amount": 1000.0,
"posted": false
}
],
"entries": [
{
"id": 325,
"date": "2026-07-01",
"debit_account": "381",
"credit_account": "548",
"amount": 12000.0,
"text": "Náklady příštích období – Pojištění vozidel 7/2026–6/2027"
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Detail uzávěrkové operace
/entities/{entity_id}/accruals/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Položka s plánem, zápisy a zbývající částkou.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Položka uzávěrkových operací (id ze seznamu). Příklad 31. |
Odpověď
200 application/json Položka.
| Pole | Význam |
|---|---|
id | Identifikátor; kind (prepaid_expense, deferred_revenue, accrued_expense, accrued_revenue, estimate_payable, estimate_receivable, provision) a kind_label. |
title | Popis; balance_account a result_account účty, amount částka, start_on, end_on (plán) a initial_on (datum úvodního zápisu). |
released | Zúčtováno nebo rozpuštěno; remaining zbývá, open zda něco zbývá. |
plan | Měsíční plán rozpuštění (date, amount, posted) u časového rozlišení 381 a 384, jinak prázdný. |
entries | Zápisy položky (date, debit_account, credit_account, amount, text); document a partner navázaný doklad a kontakt. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Položka 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í
- Nic nezapisuje.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/accruals/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"kind": "estimate_payable",
"kind_label": "Dohadná položka pasivní",
"title": "Elektřina září – dohad",
"balance_account": "389",
"result_account": "502",
"amount": 3200.0,
"start_on": "2026-09-30",
"end_on": null,
"initial_on": null,
"post_initial": true,
"initial_posted": true,
"released": 0.0,
"remaining": 3200.0,
"open": true,
"years": [
2026
],
"cost_center": null,
"note": null,
"document": null,
"partner": null,
"plan": [],
"entries": [
{
"id": 324,
"date": "2026-09-30",
"debit_account": "502",
"credit_account": "389",
"amount": 3200.0,
"text": "Dohadná položka pasivní – Elektřina září – dohad"
}
]
}
DELETE Smazání uzávěrkové operace i se zápisy
/entities/{entity_id}/accruals/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže položku a všechny její zápisy (úvodní i rozpuštění a zúčtování).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Položka uzávěrkových operací (id ze seznamu). Příklad 31. |
Odpověď
204 Bez obsahu.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Některý zápis je 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 položku a její zápisy, zapíše událost accrual.deleted.
- Opakování
- Druhé volání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/accruals/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Zaúčtování rozpuštění časového rozlišení podle plánu
/entities/{entity_id}/accruals/release
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaúčtuje všechna plánovaná měsíční rozpuštění 381 a 384 s datem do until, která ještě zaúčtovaná nejsou (měsíce v uzamčeném období přeskočí): u nákladů příštích období MD nákladový účet / D 381, u výnosů příštích období MD 384 / D výnosový účet, vždy k poslednímu dni měsíce.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
until | dotaz | datum | ne | Poslední den, do kterého se rozpouští; výchozí je dnešek. Příklad 2026-09-30. |
Odpověď
200 application/json Počet zaúčtovaných zápisů.
| Pole | Význam |
|---|---|
posted | Počet nových zápisů. |
until | Použité datum. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří zápisy zdroje accrual a zapíše událost accrual.released, když něco zaúčtuje.
- Opakování
- Druhé volání se stejným datem nic nezaúčtuje (posted 0).
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/accruals/release?until=2026-09-30"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals/release?until=2026-09-30', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"posted": 0,
"until": "2026-09-30"
}
POST Zúčtování dohadu, výdaje příštích období nebo čerpání rezervy
/entities/{entity_id}/accruals/{id}/settle
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zúčtuje část nebo celou položku bez plánu k zadanému dni obráceným zápisem (dohad pasivní MD 389 / D 518, rezerva MD 459 / D 554). Volitelně se naváže na doklad, který dohad nahradil (skutečná faktura se účtuje sama). Víc, než zbývá, zúčtovat nejde.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
id | cesta | celé číslo | ano | Položka uzávěrkových operací (id ze seznamu). Příklad 31. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
amount | číslo | ne | Zúčtovaná částka v Kč. |
date | datum | ne | Den zúčtování; výchozí dnešek. |
document_id | celé číslo | ne | Doklad firmy, který položku nahradil. |
Odpověď
200 application/json Položka po zúčtování ve tvaru getAccrual.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví, položka má plán (rozpouští se jinak), částka není kladná, převyšuje zbytek („Zbývá jen …“), nebo je den v uzamčeném období. |
| 404 | – | Položka nebo doklad nepatří k firmě. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří zápis zdroje accrual a zapíše událost accrual.settled.
- Opakování
- Každé volání zúčtuje další částku, dokud něco zbývá.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":3200,"date":"2026-10-05"}' \
https://techtools.cz/ucetnictvi-api/entities/1/accruals/1/settleJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/accruals/1/settle', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"amount": 3200,
"date": "2026-10-05"
})
});
const data = await response.json();{
"id": 1,
"kind": "estimate_payable",
"kind_label": "Dohadná položka pasivní",
"title": "Elektřina září – dohad",
"balance_account": "389",
"result_account": "502",
"amount": 3200.0,
"start_on": "2026-09-30",
"end_on": null,
"initial_on": null,
"post_initial": true,
"initial_posted": true,
"released": 3200.0,
"remaining": 0.0,
"open": false,
"years": [
2026
],
"cost_center": null,
"note": null,
"document": null,
"partner": null,
"plan": [],
"entries": [
{
"id": 324,
"date": "2026-09-30",
"debit_account": "502",
"credit_account": "389",
"amount": 3200.0,
"text": "Dohadná položka pasivní – Elektřina září – dohad"
},
{
"id": 325,
"date": "2026-10-05",
"debit_account": "389",
"credit_account": "502",
"amount": 3200.0,
"text": "Zúčtování (zúčtování) – Elektřina září – dohad"
}
]
}
GET Návrh zákonných opravných položek k pohledávkám
/entities/{entity_id}/closing/provisions
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Pro neuhrazené vydané faktury a dobropisy k rozvahovému dni navrhne zákonnou opravnou položku: 50 % po více než 18 měsících a 100 % po více než 30 měsících od splatnosti (§ 8a zákona o rezervách), 100 % u pohledávek do 50 000 Kč nejméně 12 měsíců po splatnosti (§ 8c; u každého dlužníka vybere takové pohledávky v součtu do 50 000 Kč, přednostně ty, ke kterým § 8a dává méně; za roky do 2025 hranice 30 000 Kč). Porovná ji se zaúčtovaným zůstatkem 391 k dokladu. Ostatní podmínky zákona (spojené osoby, promlčení, insolvence) Saldo neověřuje – návrh zkontrolujte.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Návrh.
| Pole | Význam |
|---|---|
date | Rozvahový den; locked zda je uzamčený, posted zda k němu už jsou zápisy 391. |
rows | document_id, number, partner, due_date, months_overdue, open (otevřeno v Kč), rule (§ 8a, § 8c), percent, required (požadovaná OP), existing (zaúčtovaná), difference (k zaúčtování). |
required | Součet požadovaných OP; existing zaúčtovaných, difference změna. |
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/closing/provisions?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/provisions?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"date": "2026-12-31",
"double_entry": true,
"locked": false,
"rows": [],
"required": 0.0,
"existing": 0.0,
"difference": 0.0,
"posted": false
}
POST Zaúčtování zákonných opravných položek
/entities/{entity_id}/closing/provisions
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaúčtuje rozdíly z návrhu k rozvahovému dni na 558/391 s vazbou na doklad (snížení obráceně MD 391 / D 558), takže po úhradě pohledávky další návrh opravnou položku rozpustí.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Návrh po zaúčtování (difference 0).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví, nebo je rok uzamčený. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří zápisy zdroje closing (558/391) a zapíše událost closing.provisions.
- Opakování
- Druhé volání nic nezaúčtuje, rozdíly už jsou nulové.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/provisions?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/provisions?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"year": 2026,
"date": "2026-12-31",
"double_entry": true,
"locked": false,
"rows": [],
"required": 0.0,
"existing": 0.0,
"difference": 0.0,
"posted": false
}
GET Účetní kniha jako sešit Excelu
/entities/{entity_id}/reports/{report}/xlsx
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Stáhne účetní deník (journal), obratovou předvahu (trial_balance, se součty tříd), hlavní knihu účtu (account, s code) nebo saldokonto (saldokonto, s side a as_of) jako sešit .xlsx s jedním listem. Období určují year, from a to stejně jako u sestav. Bez přístupu ke mzdám mají mzdové zápisy v deníku a hlavní knize text „Mzdy M/RRRR“.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
report | cesta | text | ano | Kniha. Hodnoty: journal, trial_balance, account, saldokonto. Příklad trial_balance. |
year | dotaz | celé číslo | ne | Účetní období; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
from | dotaz | datum | ne | Začátek období (výchozí začátek účetního období). Příklad 2026-01-01. |
to | dotaz | datum | ne | Konec období včetně (výchozí konec účetního období). Příklad 2026-03-31. |
code | dotaz | text | ne | Jen account – účet, syntetický zahrne analytiky. Příklad 518. |
group | dotaz | text | ne | Jen trial_balance – analytiky sečíst do syntetických účtů. Hodnoty: synthetic. Příklad synthetic. |
Odpověď
200 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet Sešit ke stažení (Content-Disposition attachment), první řádek záhlaví, částky jako čísla, data jako data.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | Neznámá kniha („Neznámá sestava – exportovat jde journal, trial_balance, account a saldokonto“). |
| 400 | – | Chybí code u account. |
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/reports/trial_balance/xlsx?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/reports/trial_balance/xlsx?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, 4122 bajtů (soubor obratova-predvaha-2026-01-01-2026-12-31.xlsx)
GET Rozdělení výsledku hospodaření – stav a náhled
/entities/{entity_id}/closing/distribution
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Výsledek hospodaření účetního období, účet, ze kterého se rozděluje (431 se zapnutým držením výsledku do schválení, jinak 428, u ztráty 429), podíly na zisku zadané v Daních (listProfitDistributions), zaúčtované zápisy rozdělení a se zadaným date také náhled zápisů podle parametrů jako u postResultDistribution.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
date | dotaz | datum | ne | Den rozhodnutí; s ním odpověď obsahuje preview. Příklad 2026-06-30. |
reserve_fund | dotaz | číslo | ne | Příděl do rezervního fondu pro náhled. Příklad 10000. |
Odpověď
200 application/json Stav rozdělení.
| Pole | Význam |
|---|---|
result | Výsledek hospodaření období (zisk kladně); period_end konec období, on_431 a source_account. |
dividends | Podíly na zisku za období z Daní (id, decided_on, source_account, posted, amount, tax, net). |
posted | Zaúčtované zápisy rozdělení (id, date, debit_account, credit_account, amount, text); locked zda jsou v uzamčeném období. |
preview | Jen s date – navrhované zápisy (debit, credit, amount, label). |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Náhled s datem před koncem období, zápornými částkami nebo rozdělením nad výsledek. |
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/closing/distribution?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/distribution?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2025,
"period_end": "2025-12-31",
"result": 0.0,
"on_431": false,
"source_account": "428",
"dividends": [
{
"id": 1,
"decided_on": "2026-06-15",
"source_account": "431",
"posted": false,
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
}
],
"posted": [],
"locked": false
}
POST Zaúčtování rozdělení výsledku hospodaření
/entities/{entity_id}/closing/distribution
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Podle rozhodnutí valné hromady zaúčtuje k date příděly do fondů (421, 423) a u účtu 431 zbytek po podílech na zisku na 428; ztrátu z 431 převede na 429. Podíly na zisku se srážkovou daní se zadávají a účtují v Daních (createProfitDistribution, postProfitDistribution) a rozdělení s nimi počítá. Dřívější rozdělení téhož období nahradí. Rozdělit jde nejvýš výsledek po podílech (z účtu 428 jeho zůstatek); zákonné testy rozdělení (§ 34 a § 40 zákona o obchodních korporacích) Saldo neověřuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
date | datum | ne | Den rozhodnutí valné hromady, po konci účetního období. |
reserve_fund | číslo | ne | Příděl do rezervního fondu (421). |
other_funds | číslo | ne | Příděl do statutárních fondů (423). |
Odpověď
200 application/json Stav po zaúčtování ve tvaru getResultDistribution.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Chybí den rozhodnutí, je před koncem období nebo v uzamčeném období, částka je záporná nebo převyšuje výsledek po podílech, požadavek obsahuje dividends („Podíly na zisku zadejte v Daních …“), podíly z 431 převyšují výsledek, firma nevede podvojné účetnictví, nebo ztráta už je na 429. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže dřívější zápisy rozdělení období, vytvoří nové (zdroj closing) a zapíše událost closing.distribution.
- Opakování
- Opakování nahradí zápisy stejnými.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-06-30","reserve_fund":10000}' \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/distribution?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/distribution?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"date": "2026-06-30",
"reserve_fund": 10000
})
});
const data = await response.json();{
"year": 2025,
"period_end": "2025-12-31",
"result": 0.0,
"on_431": false,
"source_account": "428",
"dividends": [
{
"id": 1,
"decided_on": "2026-06-15",
"source_account": "431",
"posted": false,
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
}
],
"posted": [
{
"id": 325,
"date": "2026-06-30",
"debit_account": "428",
"credit_account": "421",
"amount": 10000.0,
"text": "Rozdělení výsledku hospodaření 2025 – příděl do rezervního fondu"
}
],
"locked": false
}
DELETE Zrušení zaúčtovaného rozdělení výsledku
/entities/{entity_id}/closing/distribution
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže zápisy rozdělení výsledku daného období.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Stav po zrušení ve tvaru getResultDistribution.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Zápis rozdělení je 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 closing.distribution_removed.
- Opakování
- Opakování nic dalšího nesmaže, ale zapíše událost.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/distribution?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/distribution?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();{
"year": 2025,
"period_end": "2025-12-31",
"result": 0.0,
"on_431": false,
"source_account": "428",
"dividends": [
{
"id": 1,
"decided_on": "2026-06-15",
"source_account": "431",
"posted": false,
"amount": 120000.0,
"tax": 18000.0,
"net": 102000.0
}
],
"posted": [],
"locked": false
}
GET Uzavírací a otevírací zápisy
/entities/{entity_id}/closing/books
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Seznam uzavíracích zápisů k poslednímu dni období (výsledkové účty na 710, výsledek na 702, rozvahové účty na 702) a otevíracích zápisů k prvnímu dni dalšího období (rozvahové účty z 701, výsledek na 431 nebo 428/429). Saldo je neúčtuje – počáteční stavy počítá ze zápisů –, seznam slouží auditorovi a pro převod do jiného programu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Zápisy.
| Pole | Význam |
|---|---|
closing | Uzavírací zápisy (date, debit_account, credit_account, amount, text); opening otevírací. |
result | Výsledek hospodaření období; date a opening_date dny zápisů. |
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/closing/books?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/books?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"date": "2026-12-31",
"opening_date": "2027-01-01",
"result": 926733.6,
"closing": [
{
"date": "2026-12-31",
"debit_account": "710",
"credit_account": "501",
"amount": 9300.0,
"text": "Uzavření účtu 501"
},
{
"date": "2026-12-31",
"debit_account": "710",
"credit_account": "502",
"amount": 23900.0,
"text": "Uzavření účtu 502"
}
],
"opening": [
{
"date": "2027-01-01",
"debit_account": "022",
"credit_account": "701",
"amount": 773990.0,
"text": "Otevření účtu 022"
},
{
"date": "2027-01-01",
"debit_account": "211001",
"credit_account": "701",
"amount": 10207.0,
"text": "Otevření účtu 211001"
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Předání do nástroje Účetní závěrka
/entities/{entity_id}/closing/handoff
- Oprávnění
- Vlastník nebo účetní
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Založí volajícímu v nástroji Účetní závěrka (techtools.cz) novou závěrku firmy za období se zůstatky účtů běžného a minulého období a s ručně nastavenými řádky výkazů. Tam doplníte přílohu, schválení valnou hromadou a soubory pro sbírku listin. Firmu z registru Moje firmy připojí jen tehdy, když ji volající v registru má.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
201 application/json Odkaz na založenou závěrku.
| Pole | Význam |
|---|---|
statement_id | Číslo závěrky v nástroji Účetní závěrka; url adresa nástroje; rows počet převedených účtů. |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví („Účetní závěrku sestavíte jen z podvojného účetnictví“). |
| 403 | – | Volající není vlastník ani účetní. |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Založí závěrku v nástroji Účetní závěrka a zapíše událost closing.handoff.
- Opakování
- Každé volání založí další závěrku.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/handoff?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/handoff?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"statement_id": 1,
"url": "https://techtools.cz/tools/ucetni-zaverka/",
"rows": 25
}
GET Inventurní soupisy k rozvahovému dni
/entities/{entity_id}/closing/inventory
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Podklady inventarizace (§ 29 a 30 zákona o účetnictví): pokladny a bankovní účty s účetním stavem, zůstatkem výpisu k rozvahovému dni a sečteným stavem, neuhrazené pohledávky a závazky ze saldokonta, majetek v užívání s oprávkami a v podvojném účetnictví zůstatky účtů majetku a oprávek, plus uložené údaje inventury (komise, data).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Odpověď
200 application/json Soupisy.
| Pole | Význam |
|---|---|
cash | Pokladny – key, name, account_code, currency, book, counted, difference; bank stejně se statement (zůstatek výpisu). |
receivables | Pohledávky – rows (number, partner, due_date, remaining, remaining_czk, days_overdue), total_czk, ledger_czk, reconciled; payables stejně. |
assets | Majetek – rows (inventory_number, name, account_code, in_use_from, price, accumulated, net), price, accumulated, ledger. |
committee | Inventarizační komise (chair, members, responsible); started_on a finished_on. |
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/closing/inventory?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/inventory?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2025,
"date": "2025-12-31",
"double_entry": true,
"locked": false,
"committee": {},
"started_on": null,
"finished_on": null,
"cash": [],
"bank": [],
"receivables": {
"rows": [],
"total_czk": 0.0,
"ledger_czk": 0.0,
"reconciled": true
},
"payables": {
"rows": [],
"total_czk": 0.0,
"ledger_czk": 0.0,
"reconciled": true
},
"assets": {
"rows": [],
"price": 0.0,
"accumulated": 0.0,
"ledger": {
"cost": 0.0,
"accumulated": -0.0
}
}
}
PATCH Uložení inventury
/entities/{entity_id}/closing/inventory
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uloží sečtené stavy pokladen a bank (klíče cash-ID a bank-ID), inventarizační komisi a data zahájení a ukončení inventury k rozvahovému dni. Nic nezaúčtuje – inventarizační rozdíl (manko, přebytek) zaúčtujte ručně.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | Účetní jednotka (firma). Příklad 12. |
year | dotaz | celé číslo | ne | Účetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
inventory | objekt | ano | |
inventory. | objekt | ne | Sečtené stavy, například {"cash-5": 2400}. |
inventory. | objekt | ne | chair (předseda), members (členové), responsible (hmotně odpovědná osoba). |
inventory. | datum | ne | Zahájení inventury. |
inventory. | datum | ne | Ukončení inventury. |
Odpověď
200 application/json Soupisy po uložení ve tvaru getInventory.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Rok je uzamčený („Rok … je uzamčený – inventuru už nelze měnit“). |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží inventuru a zapíše událost closing.inventory.
- Opakování
- Opakování přepíše uložené údaje.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inventory":{"committee":{"chair":"Jana Nováková","members":"Petr Malý"},"started_on":"2026-01-02","finished_on":"2026-01-05"}}' \
"https://techtools.cz/ucetnictvi-api/entities/1/closing/inventory?year=2025"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/closing/inventory?year=2025', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"inventory": {
"committee": {
"chair": "Jana Nováková",
"members": "Petr Malý"
},
"started_on": "2026-01-02",
"finished_on": "2026-01-05"
}
})
});
const data = await response.json();{
"year": 2025,
"date": "2025-12-31",
"double_entry": true,
"locked": false,
"committee": {
"chair": "Jana Nováková",
"members": "Petr Malý"
},
"started_on": "2026-01-02",
"finished_on": "2026-01-05",
"cash": [],
"bank": [],
"receivables": {
"rows": [],
"total_czk": 0.0,
"ledger_czk": 0.0,
"reconciled": true
},
"payables": {
"rows": [],
"total_czk": 0.0,
"ledger_czk": 0.0,
"reconciled": true
},
"assets": {
"rows": [],
"price": 0.0,
"accumulated": 0.0,
"ledger": {
"cost": 0.0,
"accumulated": -0.0
}
}
}