SaldoDokumentace
Otevřít Saldo

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.

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

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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.

Odpověď

200 application/json Pole účtů (bez obalového objektu).

PoleVýznam
[].idIdentifikátor účtu pro úpravu a smazání.
[].codeKód účtu nebo kategorie.
[].nameNázev.
[].kindDruh (asset, liability, equity, expense, revenue, closing, off_balance, neutral); kind_label je český název.
[].tax_relevantZda je účet daňový.
[].statement_lineRuční přiřazení řádku rozvahy nebo výkazu zisku a ztráty, jinak null.
[].activeZda 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/accounts

JavaScript

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();
Odpověď 200 OK
[
  {
    "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
accountobjektano
account.codetextanoKód: 1–12 znaků, číslice, velká písmena, tečka a pomlčka; první znak číslice nebo písmeno.
account.nametextanoNázev, nejvýše 160 znaků.
account.kindtextanoDruh úč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.tax_relevantano/neneDaňový účet (výchozí true).
account.statement_linetextneRuč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.activeano/neneAktivní účet (výchozí true).

Odpověď

201 application/json Založený účet ve stejném tvaru jako v seznamu účtů.

Chyby této operace

StavKódKdy
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/accounts

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoÚčet firmy (id ze seznamu účtů). Příklad 815.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
accountobjektano
account.nametextneNázev, nejvýše 160 znaků.
account.kindtextneDruh účtu. Hodnoty: asset, liability, equity, expense, revenue, closing, off_balance, neutral.
account.tax_relevantano/neneDaňový účet.
account.statement_linetextneRuční přiřazení řádku rozvahy nebo výsledovky z číselníku statement_lines; prázdná hodnota přiřazení zruší.
account.activeano/neneAktivní účet.

Odpověď

200 application/json Upravený účet.

Chyby této operace

StavKódKdy
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/431

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoÚčet firmy. Příklad 902.

Odpověď

204 Bez obsahu.

Chyby této operace

StavKódKdy
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/432

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.
fromdotazdatumneZačátek období (YYYY-MM-DD); výchozí je první den účetního období year. Příklad 2026-09-01.
todotazdatumneKonec období včetně (YYYY-MM-DD); výchozí je poslední den účetního období year. Příklad 2026-09-30.
accountdotaztextneKód účtu nebo jeho začátek; zápis se vrátí, pokud jím začíná strana MD nebo Dal. Příklad 221.
qdotaztextneHledaný 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_iddotazcelé čísloneJen zápisy tohoto dokladu. Příklad 431.
source_typedotaztextneZdroje 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.
pagedotazcelé čísloneStránka od 1. Výchozí 1. Rozsah od 1. Příklad 1.
perdotazcelé číslonePoč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.

PoleVýznam
totalPočet všech vyhovujících zápisů.
sumSoučet částek všech vyhovujících zápisů v Kč.
pageVrácená stránka; per je velikost stránky.
rowsZá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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
entryobjektano
entry.datedatumanoDatum zápisu (YYYY-MM-DD); chybějící nebo neplatné datum vrátí 400.
entry.debit_accounttextanoÚčet strany MD (1–12 znaků, číslice, písmena, tečka, pomlčka).
entry.credit_accounttextanoÚčet strany Dal; musí se lišit od MD.
entry.amountčísloneČástka v Kč; přijme i desetinnou čárku („1500,50“).
entry.texttextneText zápisu; delší než 250 znaků se zkrátí.
entry.openingano/nenetrue = 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

StavKódKdy
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/entries

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoRuční zápis nebo počáteční stav bez zdroje. Příklad 5120.

Odpověď

204 Bez obsahu.

Chyby této operace

StavKódKdy
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/323

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
reportcestatextanoSestava. 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

StavKódKdy
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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚč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

PoleVýznam
months12 měsíců – month, label (MM/YYYY), revenue, costs, profit; totals je jejich součet.
moneyZůstatky účtů a pokladen k dnešku (jako sestava money).
receivablesOtevř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é.
vatU plátce DPH odhad za běžné období – from, to, frequency, output, input, due, deadline; u neplátce null.
countsdrafts (koncepty), unmatched (nespárované pohyby), partners, documents (doklady období).
alertsUpozornění – level, key, title, detail, amount, action; obsahuje i nejvýše 6 kontrol ze sestavy compliance.
top_customers5 odběratelů s nejvyšším základem v Kč za období – partner_id, name, amount; top_suppliers totéž pro dodavatele.
recent8 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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚčetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
fromdotazdatumneZačátek období; výchozí je začátek účetního období year. Příklad 2026-01-01.
todotazdatumneKonec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30.
groupdotaztextneSečíst analytiky do syntetických účtů (řádek pak nese analytics – počet analytik). Hodnoty: synthetic. Příklad synthetic.

Pole odpovědi

PoleVýznam
rowscode, name, kind, opening, debit, credit, closing, analytic (analytický účet).
classesSoučty za účtové třídy – account_class, label, opening, debit, credit, closing.
totalsdebit, credit, balanced (MD = Dal), opening, closing.
rangePouž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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
codedotaztextanoKód účtu nebo jeho začátek (převede se na velká písmena); bez něj vrátí 400. Příklad 311.
yeardotazcelé čísloneÚčetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
fromdotazdatumneZačátek období; výchozí je začátek účetního období year. Příklad 2026-01-01.
todotazdatumneKonec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30.

Pole odpovědi

PoleVýznam
codeKód z dotazu; name je název účtu s přesně tímto kódem, jinak null.
openingPočáteční stav k začátku období.
linesZápisy jako v deníku doplněné o debit, credit a balance (průběžný zůstatek).
debitObrat MD; credit obrat Dal; closing konečný stav.
rangePouž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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
sidedotaztextnereceivables = vydané faktury a dobropisy, payables = přijaté; jiná hodnota znamená receivables. Hodnoty: receivables, payables. Výchozí receivables. Příklad payables.
as_ofdotazdatumneDatum, ke kterému se saldokonto počítá; výchozí je dnešek. Příklad 2026-09-30.

Pole odpovědi

PoleVýznam
partnersKontakty 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).
bucketsSoučty podle stáří – not_due, d30, d60, d90, d90plus (key, label, total_czk).
total_czkSoučet otevřených položek v Kč.
reconciliationJen 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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚč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

PoleVýznam
rozvahascope, full, aktiva, pasiva, aktiva_total, pasiva_total, cizi_zdroje, balanced, difference.
vzzVýkaz zisku a ztráty – layout, lines a result (provozni, financni, pred_dani, dan, po_dani, za_obdobi, cisty_obrat).
cashflowPř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).
resultvh_za_obdobi, vh_za_obdobi_prev, vh_pred_zdanenim.
checksKontroly výkazů; unmapped jsou účty se zůstatkem bez přiřazeného řádku.
row_mapPřiřazení účtů k řádkům (derived u řádků rozdělených podle protiúčtu); line_options jsou platné hodnoty statement_line pro účty.
notesUpozornění k zařazení účtů, která Saldo samo nerozhodne (např. tržby z prodeje dlouhodobého finančního majetku na 661).
periodObdobí {from, to}; category je kategorie účetní jednotky, opening_difference nevyrovnaný zůstatek účtu 701.
accountsKoneč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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚčetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
fromdotazdatumneZačátek období; výchozí je začátek účetního období year. Příklad 2026-01-01.
todotazdatumneKonec období včetně; výchozí je konec účetního období year. Příklad 2026-09-30.

Pole odpovědi

PoleVýznam
rowsdate, 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.
categoriesSoučty po kategoriích – code, name, kind, tax_relevant, income, expense.
totalsincome, expense a profit (jen daňové kategorie), cash_in, cash_out, vat_net.
rangePouž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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
ondotazdatumneDatum zůstatků; výchozí je dnešek. Příklad 2026-09-30.

Pole odpovědi

PoleVýznam
accountsid, name, kind (bank nebo cash), currency, number, iban, account_code, balance (v měně účtu), balance_czk.
total_czkSoučet balance_czk.

Příklad

cURL

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

JavaScript

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();
Odpověď 200 OK
{
  "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

PoleVýznam
checkslevel (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/compliance

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
daysdotazcelé čísloneHorizont ve dnech; mimo rozsah se ořízne. Výchozí 90. Rozsah od 14 do 180. Příklad 30.

Pole odpovědi

PoleVýznam
openingDnešní zůstatek v Kč; closing zůstatek na konci horizontu (until).
inflowSoučet očekávaných příjmů; outflow výdajů (záporně).
lowDen s nejnižším zůstatkem {date, change, balance}.
seriesKaždý den horizontu včetně dneška – date, change, balance.
weeksPo týdnech – week (pondělí), inflow, outflow.
itemsNejvýš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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚčetní období začínající v tomto roce; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
dimensiondotaztextneproject = zakázka, cost_center = středisko; jiná hodnota znamená project. Hodnoty: project, cost_center. Výchozí project. Příklad cost_center.
onlydotaztextnevalues = vrátit jen {values}. Hodnoty: values. Příklad values.

Pole odpovědi

PoleVýznam
rowskey, 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).
totalsrevenue, costs, margin, margin_share.
valuesPouž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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
yeardotazcelé čísloneÚčetní období pro health; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.

Pole odpovědi

PoleVýznam
availabletotal, 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_asideJen u fyzické osoby, jinak null.
runwaymonths_used, from, to, burn, money, months, until, series.
healthSrovnání s loňskem včetně dso a dpo; null, pokud účetní období ještě nezačalo.
segmentSegment 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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleVýznam
dateRozvahový den (poslední den účetního období); finished říká, zda už minul, locked, zda je uzamčený.
double_entryZda firma vede podvojné účetnictví.
stepsKroky – 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.
revaluationNá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_taxcomputed (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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneKalendářní rok; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
monthdotazcelé čísloanoMěsíc 1–12. Rozsah od 1 do 12. Příklad 8.

Odpověď

200 application/json Stav měsíční uzávěrky.

PoleVýznam
fromPrvní den měsíce; date poslední den, finished zda měsíc skončil, locked zda je uzamčený.
stepsKroky – 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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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í.

PoleVýznam
dateRozvahový den; reversal_date den storna u faktur.
rowsPolož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).
gainKurzové zisky; loss ztráty; net výsledek přecenění.
missing_ratesMěny bez kurzu ČNB (při zaúčtování vedou k chybě).
blockedPočet účtů čekajících na spárování pohybů.
postedZda 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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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í.

PoleVýznam
computedDaň podle aktuálního výpočtu v celých Kč.
postedSoučet zaúčtované daně (591) v období.
entry_dateDatum zápisu (rozvahový den).
up_to_dateZda zaúčtovaná daň odpovídá výpočtu.

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneVolitelně 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).

PoleVýznam
kindsKlíč druhu → label, balance (výchozí rozvahový účet), result (výchozí výsledkový účet), spread (zda má měsíční plán).
accrualsPolož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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
accrualobjektano
accrual.kindtextanoDruh operace. Hodnoty: prepaid_expense, deferred_revenue, accrued_expense, accrued_revenue, estimate_payable, estimate_receivable, provision.
accrual.titletextanoPopis, nejvýš 200 znaků.
accrual.amountčísloanoČástka v Kč, kladná.
accrual.start_ondatumanoZačátek období (u plánu) nebo den vzniku dohadu či rezervy.
accrual.end_ondatumneKonec období plánu (jen prepaid_expense a deferred_revenue, nejvýš 10 let).
accrual.initial_ondatumneDen úvodního zápisu, nejpozději start_on (např. 31. 12. pro část pojištění na příští rok).
accrual.post_initialano/neneJen u plánu – zaúčtovat úvodní přeúčtování (výchozí true).
accrual.balance_accounttextneRozvahový účet (výchozí podle druhu; rezerva 451, 453 nebo 459).
accrual.result_accounttextneNá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.document_idcelé čísloneDoklad firmy, ke kterému položka patří.
accrual.partner_idcelé čísloneKontakt firmy.
accrual.cost_centertextneStředisko.
accrual.notetextnePoznámka.

Odpověď

201 application/json Založená položka ve tvaru getAccrual.

Chyby této operace

StavKódKdy
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/accruals

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoPoložka uzávěrkových operací (id ze seznamu). Příklad 31.

Odpověď

200 application/json Položka.

PoleVýznam
idIdentifikátor; kind (prepaid_expense, deferred_revenue, accrued_expense, accrued_revenue, estimate_payable, estimate_receivable, provision) a kind_label.
titlePopis; balance_account a result_account účty, amount částka, start_on, end_on (plán) a initial_on (datum úvodního zápisu).
releasedZúčtováno nebo rozpuštěno; remaining zbývá, open zda něco zbývá.
planMěsíční plán rozpuštění (date, amount, posted) u časového rozlišení 381 a 384, jinak prázdný.
entriesZápisy položky (date, debit_account, credit_account, amount, text); document a partner navázaný doklad a kontakt.

Chyby této operace

StavKódKdy
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/1

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoPoložka uzávěrkových operací (id ze seznamu). Příklad 31.

Odpověď

204 Bez obsahu.

Chyby této operace

StavKódKdy
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/1

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
untildotazdatumnePoslední 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ů.

PoleVýznam
postedPočet nových zápisů.
untilPoužité datum.

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
idcestacelé čísloanoPoložka uzávěrkových operací (id ze seznamu). Příklad 31.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
amountčísloneZúčtovaná částka v Kč.
datedatumneDen zúčtování; výchozí dnešek.
document_idcelé čísloneDoklad firmy, který položku nahradil.

Odpověď

200 application/json Položka po zúčtování ve tvaru getAccrual.

Chyby této operace

StavKódKdy
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/settle

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleVýznam
dateRozvahový den; locked zda je uzamčený, posted zda k němu už jsou zápisy 391.
rowsdocument_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í).
requiredSouč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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
reportcestatextanoKniha. Hodnoty: journal, trial_balance, account, saldokonto. Příklad trial_balance.
yeardotazcelé čísloneÚčetní období; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2026.
fromdotazdatumneZačátek období (výchozí začátek účetního období). Příklad 2026-01-01.
todotazdatumneKonec období včetně (výchozí konec účetního období). Příklad 2026-03-31.
codedotaztextneJen account – účet, syntetický zahrne analytiky. Příklad 518.
groupdotaztextneJen 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

StavKódKdy
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();
Odpověď 200 OK
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚčetní období, jehož výsledek se rozděluje; výchozí je aktuální rok. Rozsah od 2000 do 2100. Příklad 2025.
datedotazdatumneDen rozhodnutí; s ním odpověď obsahuje preview. Příklad 2026-06-30.
reserve_funddotazčíslonePříděl do rezervního fondu pro náhled. Příklad 10000.

Odpověď

200 application/json Stav rozdělení.

PoleVýznam
resultVýsledek hospodaření období (zisk kladně); period_end konec období, on_431 a source_account.
dividendsPodíly na zisku za období z Daní (id, decided_on, source_account, posted, amount, tax, net).
postedZaúčtované zápisy rozdělení (id, date, debit_account, credit_account, amount, text); locked zda jsou v uzamčeném období.
previewJen s date – navrhované zápisy (debit, credit, amount, label).

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleTypPovinnéPopis
datedatumneDen rozhodnutí valné hromady, po konci účetního období.
reserve_fundčíslonePříděl do rezervního fondu (421).
other_fundsčíslonePříděl do statutárních fondů (423).

Odpověď

200 application/json Stav po zaúčtování ve tvaru getResultDistribution.

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleVýznam
closingUzavírací zápisy (date, debit_account, credit_account, amount, text); opening otevírací.
resultVý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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleVý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

StavKódKdy
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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleVýznam
cashPokladny – key, name, account_code, currency, book, counted, difference; bank stejně se statement (zůstatek výpisu).
receivablesPohledávky – rows (number, partner, due_date, remaining, remaining_czk, days_overdue), total_czk, ledger_czk, reconciled; payables stejně.
assetsMajetek – rows (inventory_number, name, account_code, in_use_from, price, accumulated, net), price, accumulated, ledger.
committeeInventarizač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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoÚčetní jednotka (firma). Příklad 12.
yeardotazcelé čísloneÚč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.

PoleTypPovinnéPopis
inventoryobjektano
inventory.countsobjektneSečtené stavy, například {"cash-5": 2400}.
inventory.committeeobjektnechair (předseda), members (členové), responsible (hmotně odpovědná osoba).
inventory.started_ondatumneZahájení inventury.
inventory.finished_ondatumneUkončení inventury.

Odpověď

200 application/json Soupisy po uložení ve tvaru getInventory.

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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
    }
  }
}