Reference API
Majetek, mzdy a cesty
Evidence dlouhodobého majetku a odpisů, zaměstnanci, výpočet a zaúčtování mezd, měsíční hlášení JMHZ a cestovní náhrady.
GET Seznam dlouhodobého majetku s odpisy za rok
/entities/{entity_id}/assets
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí všechny karty dlouhodobého majetku firmy včetně drobného a vyřazeného majetku, seřazené podle data uvedení do užívání a ID. Ke každé kartě připojí účet oprávek, číslo dokladu o pořízení a o prodeji a odpisy za zvolený kalendářní rok: daňový odpis podle odpisové skupiny (celá částka, u osobního automobilu M1 před krácením na uznatelnou část), účetní odpis (součet měsíčních odpisů v roce), zůstatek daňové vstupní ceny na konci roku a oprávky a účetní zůstatkovou cenu k 31. 12. pro inventurní soupis. Karta uložená před kontrolou údajů, pro kterou nejde spočítat plán, nezpůsobí chybu celého seznamu: má nulové odpisy a pole plan_error s popisem, co opravit.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Kalendářní rok pro odpisy a stav k 31. 12. Bez parametru nebo při nečíselné hodnotě aktuální rok; hodnoty mimo rozsah se zarovnají na 2000 až 2100. Rozsah od 2000 do 2100. Příklad 2026. |
Odpověď
200 application/json Pole karet majetku.
| Pole | Význam |
|---|---|
id, name, inventory_number, note, location, responsible_person, serial_number | Identifikace karty a údaje pro inventuru |
category | tangible (hmotný), intangible (nehmotný) nebo low_value (drobný – neodpisuje se) |
account_code, accumulated_account, depreciable | Účet majetku, účet oprávek (null u pozemků 031 a uměleckých děl 032) a zda se karta odpisuje |
acquired_on, in_use_from, placement_account | Pořízení, uvedení do užívání a účet pořízení 041 nebo 042 (null = pořízení přímo na účet majetku) |
price, residual_value, useful_life_months, improvements | Vstupní cena, zbytková hodnota, doba účetního odpisování a technická zhodnocení |
tax_group, tax_method, vehicle_m1, tax_increased_first_year, tax_interrupted_years | Parametry daňového odpisování |
disposed_on, disposal_kind, disposal_document_id, disposal_compensation, disposal_deductible | Vyřazení |
document_id, document_number, disposal_document_number | Doklad o pořízení a doklad o prodeji |
tax_this_year | Daňový odpis v zadaném roce; 0, když se v roce daňově neodpisuje |
tax_deductible_this_year | Část daňového odpisu roku, která jde do výdajů (u osobního auta M1 nad 2 mil. Kč krácená) |
accounting_this_year | Účetní odpis v zadaném roce; 0, když se v roce neodpisuje |
remaining_tax | Zůstatek daňové vstupní ceny po odpisu roku; null, když rok v daňovém plánu není |
accumulated_at_year_end, book_value_at_year_end | Účetní oprávky a zůstatková cena k 31. 12. roku |
plan_error | Jen u karty s neplatnými údaji: co opravit; odpisy jsou pak 0 |
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/assets?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 2,
"account_code": "022",
"acquired_on": "2026-02-23",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"disposal_kind": null,
"disposed_on": null,
"document_id": 72,
"improvements": [],
"in_use_from": "2026-02-25",
"inventory_number": "DM-002",
"location": null,
"name": "Osobní automobil Škoda Octavia Combi",
"note": null,
"placement_account": null,
"price": 689000.0,
"residual_value": 120000.0,
"responsible_person": null,
"serial_number": null,
"tax_group": 2,
"tax_increased_first_year": null,
"tax_interrupted_years": [],
"tax_method": "accelerated",
"updated_at": "2026-09-28T10:00:00.000Z",
"useful_life_months": 60,
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": "FP20260038",
"disposal_document_number": null,
"tax_this_year": 137800.0,
"tax_deductible_this_year": 137800.0,
"accounting_this_year": 94840.0,
"remaining_tax": 551200.0,
"accumulated_at_year_end": 94840.0,
"book_value_at_year_end": 594160.0
},
{
"id": 1,
"account_code": "022",
"acquired_on": "2026-03-03",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"disposal_kind": null,
"disposed_on": null,
"document_id": 71,
"improvements": [],
"in_use_from": "2026-03-05",
"inventory_number": "DM-001",
"location": null,
"name": "Notebook MacBook Pro 16\"",
"note": null,
"placement_account": null,
"price": 84990.0,
"residual_value": 0.0,
"responsible_person": null,
"serial_number": null,
"tax_group": 1,
"tax_increased_first_year": null,
"tax_interrupted_years": [],
"tax_method": "straight",
"updated_at": "2026-09-28T10:00:00.000Z",
"useful_life_months": 36,
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": "FP20260037",
"disposal_document_number": null,
"tax_this_year": 16998.0,
"tax_deductible_this_year": 16998.0,
"accounting_this_year": 21249.0,
"remaining_tax": 67992.0,
"accumulated_at_year_end": 21249.0,
"book_value_at_year_end": 63741.0
}
]
POST Zařazení majetku do evidence
/entities/{entity_id}/assets
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Založí kartu dlouhodobého majetku a vrátí ji s odpisovými plány a zápisy pohybů. Účetní odpisy jsou rovnoměrné měsíční od měsíce následujícího po uvedení do užívání po dobu useful_life_months ze základu vstupní cena minus zbytková hodnota, zaokrouhlené na celé koruny nahoru (u majetku uvedeného do užívání před 1. 1. 2026 matematicky); poslední měsíc dorovná zbytek. Technické zhodnocení zvýší základ od měsíce po dokončení a zbytek se rozpustí na zbývající (případně prodlouženou) dobu. Daňový plán se počítá jen se zadanou odpisovou skupinou, rovnoměrně (§ 31 ZDP) nebo zrychleně (§ 32 ZDP), se zvýšeným odpisem v prvním roce, přerušením (§ 26 odst. 8 ZDP) a technickým zhodnocením od roku dokončení. Pozemky (031) a umělecká díla (032) se neodpisují vůbec, drobný majetek (low_value) nemá plány ani zápisy. V podvojném účetnictví Saldo zaúčtuje pohyby (zdroj asset_movement): zařazení MD účet majetku / D 041 nebo 042 k datu zařazení, technické zhodnocení pořízené přes 041 nebo 042 a vyřazení (viz updateAsset). Daňové odpisy nehmotného majetku podle § 32a ZDP, leasing a evidenci zásob API nepodporuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
asset | objekt | ano | |
asset. | text | ano | Název majetku, nejvýše 200 znaků |
asset. | text | ne | Inventární číslo (jedinečnost se nekontroluje) |
asset. | text | ne | Druh majetku: tangible hmotný, intangible nehmotný, low_value drobný (bez odpisových plánů a bez zápisů). Se zadanou skupinou se i nehmotný majetek odpisuje daňově podle § 31 nebo § 32 ZDP. Hodnoty: tangible, intangible, low_value. Výchozí tangible. |
asset. | text | ne | Účet majetku 012 až 019, 021 až 029, 031 nebo 032, případně s analytikou (nejvýše 9 číslic). Účet oprávek se odvodí: 01x → 07x, 02x → 08x; pozemky a umělecká díla oprávky nemají a neodpisují se. Výchozí 022. |
asset. | datum | ne | Datum pořízení; jen evidence, odpisy se počítají od in_use_from |
asset. | datum | ano | Datum uvedení do užívání, nejdřív acquired_on (jinak 422) – účetní odpisy začínají následujícím měsícem, daňové rokem uvedení |
asset. | číslo | ano | Vstupní cena v Kč, větší než 0; základ účetních i daňových odpisů |
asset. | text | ne | Účet, na kterém je pořízení zaúčtované (nedokončený majetek). Saldo k datu zařazení zaúčtuje MD account_code / D placement_account ve výši price. Bez hodnoty se zařazení neúčtuje (pořízení je přímo na účtu majetku). Když pole v požadavku chybí a document_id ukazuje na doklad s řádkem na účtu 041 nebo 042, vyplní se samo. Hodnoty: 041, 042. |
asset. | celé číslo | ne | Odpisová skupina podle přílohy č. 1 ZDP; null = daňově se neodpisuje. U účtů 031 a 032 nejde zadat Hodnoty: 1, 2, 3, 4, 5, 6. |
asset. | text | ne | Daňové odpisování: straight rovnoměrné (§ 31 ZDP), accelerated zrychlené (§ 32 ZDP) Hodnoty: straight, accelerated. Výchozí straight. |
asset. | celé číslo | ne | Zvýšený odpis v prvním roce o 10, 15 nebo 20 % (§ 31 odst. 1 písm. b) až d) ZDP), jen skupiny 1 až 3 Hodnoty: 10, 15, 20. |
asset. | pole (celé číslo) | ne | Roky přerušení daňového odpisování (§ 26 odst. 8 ZDP); jen se skupinou, od roku zařazení |
asset. | celé číslo | ne | Doba účetního odpisování v měsících Výchozí 36. Rozsah od 1 do 1200. |
asset. | číslo | ne | Zbytková hodnota vyloučená z účetních odpisů, 0 až vstupní cena Výchozí 0. |
asset. | pole (objekt) | ne | Technická zhodnocení; celé pole nahradí dosavadní seznam |
asset. | datum | ano | Dokončení, od zařazení do vyřazení |
asset. | číslo | ano | Částka v Kč, větší než 0 |
asset. | text | ne | Účet pořízení; Saldo pak k datu zaúčtuje MD account_code / D tento účet Hodnoty: 041, 042. |
asset. | celé číslo | ne | O kolik měsíců se prodlouží účetní odpisování; po skončení odpisů povinné Rozsah od 0 do 1200. |
asset. | celé číslo | ne | Doklad této firmy |
asset. | text | ne | Poznámka |
asset. | datum | ne | Datum vyřazení; nesmí být před in_use_from |
asset. | text | ne | Důvod vyřazení: prodej, likvidace, škoda nebo manko, dar; s disposed_on povinný Hodnoty: sale, scrap, damage, gift. |
asset. | celé číslo | ne | Doklad o prodeji (vydaná faktura této firmy) |
asset. | číslo | ne | U škody přijatá náhrada (pojistné plnění) – do její výše je daňová zůstatková cena výdajem |
asset. | ano/ne | ne | U škody: živelní pohroma nebo neznámý pachatel potvrzený policií – celá daňová zůstatková cena je výdajem Výchozí false. |
asset. | celé číslo | ne | ID dokladu o pořízení v této firmě; doklad jiné firmy vrátí 422 |
asset. | text | ne | Umístění (inventura) |
asset. | text | ne | Odpovědná osoba (inventura) |
asset. | text | ne | Výrobní číslo |
asset. | text | ne | Poznámka |
asset. | ano/ne | ne | Osobní automobil kategorie M1: je-li uveden do užívání od zdaňovacího období začínajícího 1. 1. 2024, do daňových výdajů jde jen poměrná část odpisu 2 000 000 Kč / vstupní cena (pole deductible v daňovém plánu). Výchozí false. |
Odpověď
201 application/json Založená karta majetku s odpisovými plány a zápisy pohybů.
| Pole | Význam |
|---|---|
id, name, category, account_code, accumulated_account, in_use_from, price, … | Pole karty jako v seznamu majetku |
tax | Daňový plán po letech: year, rate_or_coefficient, kind (first_year, following_year, increased_price, interrupted, disposal), amount, deductible, accumulated, remaining |
accounting | Účetní plán po měsících: month (první den měsíce), year, amount, accumulated, remaining (cena včetně zhodnocení minus oprávky) |
accounting_yearly | Účetní plán sečtený po kalendářních letech: year, amount, accumulated, remaining |
movements | Zápisy pohybů, které Saldo zaúčtuje: date, debit_account, credit_account, amount, text (v daňové evidenci prázdné) |
disposal | U vyřazené karty: cost_account, total_cost, accumulated, accounting_residual, tax_residual, tax_deductible, kind_label |
warnings | Upozornění, např. doklad o pořízení zaúčtovaný na 042 bez zařazení nebo movitá věc do 80 000 Kč s odpisovou skupinou |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Neplatné údaje karty, s chybou u pole: zbytková hodnota mimo 0 až vstupní cenu, vyřazení před zařazením nebo bez důvodu, účet mimo dlouhodobý majetek, odpisová skupina u pozemku, technické zhodnocení mimo dobu užívání nebo po skončení odpisů bez prodloužení, doklad jiné firmy |
| 422 | – | Zápis pohybu by padl do uzamčeného období – „Období do D. M. RRRR je uzamčeno – do něj nelze účtovat“; karta se neuloží |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří kartu majetku a zapíše událost asset.created. V podvojném účetnictví zaúčtuje pohyby (zařazení, technické zhodnocení přes 041/042 a u vyřazené karty odpis roku vyřazení a vyřazení); odpisy ostatních let zaúčtuje až POST /entities/{entity_id}/assets/depreciate.
- Opakování
- Každé volání založí novou kartu; duplicity se nekontrolují.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asset":{"name":"Server Dell PowerEdge T160","inventory_number":"DM-010","category":"tangible","account_code":"022","acquired_on":"2026-02-10","in_use_from":"2026-02-15","price":145000,"placement_account":"042","tax_group":1,"tax_method":"straight","useful_life_months":48,"residual_value":0,"location":"Serverovna Praha"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/assetsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"asset": {
"name": "Server Dell PowerEdge T160",
"inventory_number": "DM-010",
"category": "tangible",
"account_code": "022",
"acquired_on": "2026-02-10",
"in_use_from": "2026-02-15",
"price": 145000,
"placement_account": "042",
"tax_group": 1,
"tax_method": "straight",
"useful_life_months": 48,
"residual_value": 0,
"location": "Serverovna Praha"
}
})
});
const data = await response.json();{
"id": 4,
"account_code": "022",
"acquired_on": "2026-02-10",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"disposal_kind": null,
"disposed_on": null,
"document_id": null,
"improvements": [],
"in_use_from": "2026-02-15",
"inventory_number": "DM-010",
"location": "Serverovna Praha",
"name": "Server Dell PowerEdge T160",
"note": null,
"placement_account": "042",
"price": 145000.0,
"residual_value": 0.0,
"responsible_person": null,
"serial_number": null,
"tax_group": 1,
"tax_increased_first_year": null,
"tax_interrupted_years": [],
"tax_method": "straight",
"updated_at": "2026-09-28T10:00:00.000Z",
"useful_life_months": 48,
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": null,
"disposal_document_number": null,
"warnings": [],
"tax": [
{
"year": 2026,
"rate_or_coefficient": 20.0,
"kind": "first_year",
"amount": 29000.0,
"deductible": 29000.0,
"accumulated": 29000.0,
"remaining": 116000.0
},
{
"year": 2027,
"rate_or_coefficient": 40.0,
"kind": "following_year",
"amount": 58000.0,
"deductible": 58000.0,
"accumulated": 87000.0,
"remaining": 58000.0
}
],
"accounting": [
{
"month": "2026-03-01",
"year": 2026,
"amount": 3021.0,
"accumulated": 3021.0,
"remaining": 141979.0
},
{
"month": "2026-04-01",
"year": 2026,
"amount": 3021.0,
"accumulated": 6042.0,
"remaining": 138958.0
}
],
"accounting_yearly": [
{
"year": 2026,
"amount": 30210.0,
"accumulated": 30210.0,
"remaining": 114790.0
},
{
"year": 2027,
"amount": 36252.0,
"accumulated": 66462.0,
"remaining": 78538.0
}
],
"movements": [
{
"date": "2026-02-15",
"debit_account": "022",
"credit_account": "042",
"amount": 145000.0,
"text": "Zařazení do užívání – Server Dell PowerEdge T160",
"document_id": null
}
],
"disposal": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Detail majetku s odpisovými plány a pohyby
/entities/{entity_id}/assets/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí kartu majetku s daňovým odpisovým plánem po letech, účetním plánem po měsících a jeho ročním souhrnem, zápisy pohybů, výpočtem vyřazení a upozorněními. Stejná data vrací GET /entities/{entity_id}/assets/{id}/schedule. Karta s neplatnými údaji vrátí prázdné plány a plan_error.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID karty majetku Příklad 5. |
Odpověď
200 application/json Karta majetku s plány tax, accounting, accounting_yearly a s movements, disposal a warnings (tvar jako při založení).
| Pole | Význam |
|---|---|
tax | Daňový plán po letech; prázdný bez odpisové skupiny, u drobného majetku a u pozemků |
accounting | Účetní plán po měsících; prázdný u drobného majetku a u pozemků |
accounting_yearly | Účetní odpisy po kalendářních letech |
movements, disposal, warnings | Zápisy pohybů, výpočet vyřazení a upozornění |
plan_error | Jen u karty s neplatnými údaji |
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/assets/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"account_code": "022",
"acquired_on": "2026-03-03",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"disposal_kind": null,
"disposed_on": null,
"document_id": 71,
"improvements": [],
"in_use_from": "2026-03-05",
"inventory_number": "DM-001",
"location": null,
"name": "Notebook MacBook Pro 16\"",
"note": null,
"placement_account": null,
"price": 84990.0,
"residual_value": 0.0,
"responsible_person": null,
"serial_number": null,
"tax_group": 1,
"tax_increased_first_year": null,
"tax_interrupted_years": [],
"tax_method": "straight",
"updated_at": "2026-09-28T10:00:00.000Z",
"useful_life_months": 36,
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": "FP20260037",
"disposal_document_number": null,
"warnings": [],
"tax": [
{
"year": 2026,
"rate_or_coefficient": 20.0,
"kind": "first_year",
"amount": 16998.0,
"deductible": 16998.0,
"accumulated": 16998.0,
"remaining": 67992.0
},
{
"year": 2027,
"rate_or_coefficient": 40.0,
"kind": "following_year",
"amount": 33996.0,
"deductible": 33996.0,
"accumulated": 50994.0,
"remaining": 33996.0
}
],
"accounting": [
{
"month": "2026-04-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 2361.0,
"remaining": 82629.0
},
{
"month": "2026-05-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 4722.0,
"remaining": 80268.0
}
],
"accounting_yearly": [
{
"year": 2026,
"amount": 21249.0,
"accumulated": 21249.0,
"remaining": 63741.0
},
{
"year": 2027,
"amount": 28332.0,
"accumulated": 49581.0,
"remaining": 35409.0
}
],
"movements": [],
"disposal": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Úprava nebo vyřazení karty majetku
/entities/{entity_id}/assets/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní zaslaná pole karty (neposlaná zůstanou beze změny) a vrátí kartu s přepočtenými plány. Vyřazení se zadává polem disposed_on s důvodem disposal_kind. V podvojném účetnictví Saldo k datu vyřazení zaúčtuje účetní odpis roku vyřazení (MD 551 / D oprávky, místo k 31. 12.), zůstatkovou cenu MD 541 (prodej), 551 (likvidace), 549 (škoda nebo manko) nebo 543 (dar) / D oprávky a vyřazení MD oprávky / D účet majetku ve výši vstupní ceny včetně zhodnocení; pozemek a umělecké dílo MD 541 až 543 / D 031 nebo 032. Tržbu z prodeje (641, v daňové evidenci P04) zaúčtujte vydanou fakturou. Pohyby, které se nezměnily, zůstanou beze změny i v uzamčeném období. Daňová zůstatková cena (u osobního auta M1 jako by se odpisovalo bez přerušení) jde do výdajů u prodeje a likvidace, u škody do výše náhrady, u daru ne; rozdíl proti účetní zůstatkové ceně Saldo uvede v DPPO na ř. 40 nebo ř. 160, u OSVČ v daňové evidenci ji přičte k výdajům.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID karty majetku Příklad 5. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
asset | objekt | ano | |
asset. | text | ne | Název majetku, nejvýše 200 znaků |
asset. | text | ne | Inventární číslo |
asset. | text | ne | Druh majetku (low_value = drobný bez odpisů) Hodnoty: tangible, intangible, low_value. |
asset. | text | ne | Účet majetku 012 až 019, 021 až 029, 031 nebo 032 (s analytikou) |
asset. | datum | ne | Datum pořízení |
asset. | datum | ne | Datum uvedení do užívání, nejdřív acquired_on (kontroluje se při změně jednoho z obou dat) |
asset. | číslo | ne | Vstupní cena v Kč, větší než 0 |
asset. | text | ne | Účet pořízení; null zápis zařazení zruší Hodnoty: 041, 042. |
asset. | celé číslo | ne | Odpisová skupina; null zruší daňové odpisy Hodnoty: 1, 2, 3, 4, 5, 6. |
asset. | text | ne | Rovnoměrné nebo zrychlené daňové odpisování Hodnoty: straight, accelerated. |
asset. | celé číslo | ne | Zvýšený odpis v prvním roce; null bez něj Hodnoty: 10, 15, 20. |
asset. | pole (celé číslo) | ne | Roky přerušení daňového odpisování; prázdné pole přerušení zruší |
asset. | celé číslo | ne | Doba účetního odpisování v měsících Rozsah od 1 do 1200. |
asset. | číslo | ne | Zbytková hodnota, 0 až vstupní cena |
asset. | pole (objekt) | ne | Technická zhodnocení (tvar jako při založení); celé pole nahradí dosavadní seznam |
asset. | datum | ne | Datum vyřazení; null vyřazení i jeho zápisy zruší |
asset. | text | ne | Důvod vyřazení; s disposed_on povinný Hodnoty: sale, scrap, damage, gift. |
asset. | celé číslo | ne | Doklad o prodeji |
asset. | číslo | ne | Náhrada škody |
asset. | ano/ne | ne | Škoda živelní pohromou nebo neznámým pachatelem |
asset. | celé číslo | ne | Doklad o pořízení v této firmě |
asset. | text | ne | Umístění |
asset. | text | ne | Odpovědná osoba |
asset. | text | ne | Výrobní číslo |
asset. | text | ne | Poznámka |
asset. | ano/ne | ne | Osobní automobil M1 s krácením daňově uznatelného odpisu |
Odpověď
200 application/json Upravená karta s plány, pohyby, výpočtem vyřazení a upozorněními.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Neplatné údaje karty (jako u založení); nic se neuloží |
| 422 | – | Změna by smazala nebo vytvořila zápis v uzamčeném období – „Období do D. M. RRRR je uzamčeno …“; nic se neuloží |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží změny karty, zapíše událost asset.updated a přeúčtuje pohyby majetku a u vyřazení odpis roku vyřazení (u zrušeného vyřazení i odpis dřívějšího roku vyřazení, pokud už byl zaúčtovaný). Odpisy ostatních let se nezmění – přepočte je POST /entities/{entity_id}/assets/depreciate za dotčený rok.
- Opakování
- Opakování se stejnými daty kartu ani zápisy nezmění, ale pokaždé zapíše událost asset.updated.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asset":{"location":"Kancelář Brno","responsible_person":"Anna Ukázková","disposed_on":"2026-09-30","disposal_kind":"sale"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/assets/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"asset": {
"location": "Kancelář Brno",
"responsible_person": "Anna Ukázková",
"disposed_on": "2026-09-30",
"disposal_kind": "sale"
}
})
});
const data = await response.json();{
"disposed_on": "2026-09-30",
"disposal_kind": "sale",
"location": "Kancelář Brno",
"responsible_person": "Anna Ukázková",
"improvements": [],
"tax_interrupted_years": [],
"placement_account": null,
"price": 84990.0,
"residual_value": 0.0,
"useful_life_months": 36,
"document_id": 71,
"in_use_from": "2026-03-05",
"acquired_on": "2026-03-03",
"id": 1,
"account_code": "022",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"inventory_number": "DM-001",
"name": "Notebook MacBook Pro 16\"",
"note": null,
"serial_number": null,
"tax_group": 1,
"tax_increased_first_year": null,
"tax_method": "straight",
"updated_at": "2026-09-28T10:00:00.000Z",
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": "FP20260037",
"disposal_document_number": null,
"warnings": [],
"tax": [
{
"year": 2026,
"rate_or_coefficient": 20.0,
"kind": "disposal",
"amount": 0.0,
"deductible": 0.0,
"accumulated": 0.0,
"remaining": 84990.0
}
],
"accounting": [
{
"month": "2026-04-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 2361.0,
"remaining": 82629.0
},
{
"month": "2026-05-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 4722.0,
"remaining": 80268.0
}
],
"accounting_yearly": [
{
"year": 2026,
"amount": 14166.0,
"accumulated": 14166.0,
"remaining": 70824.0
}
],
"movements": [
{
"date": "2026-09-30",
"debit_account": "541",
"credit_account": "082",
"amount": 70824.0,
"text": "Zůstatková cena (prodej) – Notebook MacBook Pro 16\"",
"document_id": null
},
{
"date": "2026-09-30",
"debit_account": "082",
"credit_account": "022",
"amount": 84990.0,
"text": "Vyřazení (prodej) – Notebook MacBook Pro 16\"",
"document_id": null
}
],
"disposal": {
"cost_account": "541",
"total_cost": 84990.0,
"accumulated": 14166.0,
"accounting_residual": 70824.0,
"tax_residual": 84990.0,
"tax_deductible": 84990.0,
"kind_label": "Prodej"
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Smazání majetku včetně jeho zápisů
/entities/{entity_id}/assets/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže kartu majetku spolu se všemi účetními zápisy jejích odpisů a pohybů ze všech let. Leží-li kterýkoli z těchto zápisů v uzamčeném období, nic nesmaže. Prodaný nebo zlikvidovaný majetek nemažte, vyřaďte ho polem disposed_on.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID karty majetku Příklad 5. |
Odpověď
204 Prázdná odpověď.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Některý zápis majetku leží v uzamčeném období – „Období do D. M. RRRR je uzamčeno – zaúčtování nelze změnit“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže kartu a všechny její zápisy (zdroje asset a asset_movement) bez ohledu na rok a zapíše událost asset.deleted. Doklad o pořízení a jeho zaúčtování zůstanou.
- Opakování
- Druhé smazání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/assets/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Zaúčtování ročních účetních odpisů majetku
/entities/{entity_id}/assets/depreciate
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaúčtuje účetní odpisy všech karet majetku za kalendářní rok year: každé kartě jeden zápis MD 551 / D účet oprávek ve výši součtu měsíčních odpisů roku, k 31. 12., u majetku vyřazeného v tomto roce k datu vyřazení. Zápis, který už odpovídá, nechá beze změny, jinak ho smaže a vytvoří znovu. Doplní i chybějící zápisy pohybů majetku s datem v roce (zařazení, technické zhodnocení, vyřazení). Karty bez odpisu v roce (drobný majetek, pozemky, doodepsaný nebo dosud nezařazený majetek) se vynechají. Daňové odpisy se neúčtují – slouží výpočtu daně z příjmů. Funguje jen v podvojném účetnictví; hospodářský rok firmy se nezohledňuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Kalendářní rok odpisů. Bez parametru nebo při nečíselné hodnotě aktuální rok; hodnoty mimo rozsah se zarovnají na 2000 až 2100. Budoucí rok se neodmítá. Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ne | Zaúčtovat po měsících od ledna do konce tohoto měsíce: každý měsíc zvláštním zápisem k jeho poslednímu dni (u vyřazeného majetku k datu vyřazení) s textem „Účetní odpis M/RRRR – název“. Roční zápis se tím nahradí. Má-li rok měsíční zápisy, volání bez month pokračuje po měsících do prosince. Rozsah od 1 do 12. Příklad 6. |
Odpověď
200 application/json Souhrn zaúčtovaných odpisů.
| Pole | Význam |
|---|---|
year | Zaúčtovaný rok |
month | Poslední zaúčtovaný měsíc při účtování po měsících, jinak null |
posted | Odpisy roku: asset_id, name, amount |
total | Součet odpisů v Kč |
warnings | Upozornění, např. karta pořízená dokladem na 042 bez zaúčtovaného zařazení |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Firma nevede podvojné účetnictví – „Odpisy se účtují jen v podvojném účetnictví“ |
| 422 | – | 31. 12. zadaného roku, nebo poslední den měsíce month, leží v uzamčeném období – „Rok RRRR je uzamčený …“ / „Měsíc M/RRRR je uzamčený – odpisy už nelze měnit“ |
| 422 | – | month mimo 1 až 12 – „Měsíc musí být 1 až 12“ |
| 422 | – | Některá karta má neplatné údaje – „Majetek „…“ má neplatné údaje: … Opravte kartu v Majetku.“; nic se nezaúčtuje |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- V jedné transakci upraví odpisové zápisy (zdroj asset) a zápisy pohybů (zdroj asset_movement) s datem v daném roce a zapíše událost asset.depreciated. Nic nevyplácí ani nepodává.
- Opakování
- Opakované volání bez změny karet zápisy nezmění; každé volání zapíše novou událost do historie.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/assets/depreciate?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets/depreciate?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"year": 2026,
"month": null,
"posted": [
{
"asset_id": 1,
"name": "Notebook MacBook Pro 16\"",
"amount": 21249.0
},
{
"asset_id": 2,
"name": "Osobní automobil Škoda Octavia Combi",
"amount": 94840.0
}
],
"total": 116089.0,
"warnings": []
}
GET Odpisové plány majetku
/entities/{entity_id}/assets/{id}/schedule
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí totéž co detail majetku (GET /entities/{entity_id}/assets/{id}): kartu s daňovým plánem po letech (tax), účetním plánem po měsících (accounting), účetními odpisy po kalendářních letech (accounting_yearly), pohyby, vyřazením a upozorněními.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID karty majetku Příklad 5. |
Odpověď
200 application/json Karta majetku s plány tax, accounting a accounting_yearly.
| Pole | Význam |
|---|---|
tax | year, rate_or_coefficient (sazba v % nebo koeficient), kind, amount, deductible (u M1 po krácení), accumulated, remaining |
accounting | month, year, amount, accumulated, remaining |
accounting_yearly | year, amount, accumulated, remaining |
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/assets/1/scheduleJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/assets/1/schedule', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"account_code": "022",
"acquired_on": "2026-03-03",
"category": "tangible",
"created_at": "2026-09-28T10:00:00.000Z",
"disposal_compensation": null,
"disposal_deductible": false,
"disposal_document_id": null,
"disposal_kind": null,
"disposed_on": null,
"document_id": 71,
"improvements": [],
"in_use_from": "2026-03-05",
"inventory_number": "DM-001",
"location": null,
"name": "Notebook MacBook Pro 16\"",
"note": null,
"placement_account": null,
"price": 84990.0,
"residual_value": 0.0,
"responsible_person": null,
"serial_number": null,
"tax_group": 1,
"tax_increased_first_year": null,
"tax_interrupted_years": [],
"tax_method": "straight",
"updated_at": "2026-09-28T10:00:00.000Z",
"useful_life_months": 36,
"vehicle_m1": false,
"accumulated_account": "082",
"depreciable": true,
"document_number": "FP20260037",
"disposal_document_number": null,
"warnings": [],
"tax": [
{
"year": 2026,
"rate_or_coefficient": 20.0,
"kind": "first_year",
"amount": 16998.0,
"deductible": 16998.0,
"accumulated": 16998.0,
"remaining": 67992.0
},
{
"year": 2027,
"rate_or_coefficient": 40.0,
"kind": "following_year",
"amount": 33996.0,
"deductible": 33996.0,
"accumulated": 50994.0,
"remaining": 33996.0
}
],
"accounting": [
{
"month": "2026-04-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 2361.0,
"remaining": 82629.0
},
{
"month": "2026-05-01",
"year": 2026,
"amount": 2361.0,
"accumulated": 4722.0,
"remaining": 80268.0
}
],
"accounting_yearly": [
{
"year": 2026,
"amount": 21249.0,
"accumulated": 21249.0,
"remaining": 63741.0
},
{
"year": 2027,
"amount": 28332.0,
"accumulated": 49581.0,
"remaining": 35409.0
}
],
"movements": [],
"disposal": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Seznam pracovníků
/entities/{entity_id}/employees
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí všechny pracovníky firmy včetně těch s ukončeným vztahem, seřazené podle příjmení a jména. Obsahuje i osobní údaje z karty (údaje pro JMHZ v details, číslo účtu). Pro výběr cestujícího nebo řidiče stačí jména z GET /entities/{entity_id}/employees/names.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Odpověď
200 application/json Pole karet pracovníků.
| Pole | Význam |
|---|---|
id, first_name, last_name, full_name, personal_number | Identifikace pracovníka |
contract | hpp, dpc nebo dpp |
gross_wage | Sjednaná měsíční mzda nebo odměna v Kč |
started_on, ended_on | Trvání pracovněprávního vztahu |
declaration, disability, ztpp, student | Údaje pro slevy na dani a pojistné |
health_insurer, bank_account, email, note | Kontaktní a evidenční údaje |
children | Děti pro daňové zvýhodnění |
details | Údaje pro JMHZ a další příznaky (objekt); null, dokud nebyly zadány |
terms, terms_timeline | Mzdový výměr s platností: uložené změny (from = RRRR-MM, null = od nástupu) a přehled hodnot od každého měsíce se seznamem změněných klíčů |
current_terms, default_valid_from | Výměr platný v aktuálním měsíci a měsíc, od kterého platí změna karty bez valid_from (po poslední pásce) |
deductions | Srážky ze mzdy: id, kind, label, reference, received_on, total, monthly, account, symboly |
vacation, ended | Orientační dovolená v aktuálním roce (entitlement, taken, remaining v hodinách; jen HPP) a příznak skončeného vztahu |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
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/employeesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 3,
"bank_account": null,
"children": [],
"contract": "dpp",
"created_at": "2026-09-28T10:00:00.000Z",
"declaration": false,
"deductions": [],
"details": null,
"disability": null,
"email": null,
"ended_on": null,
"first_name": "Tereza",
"gross_wage": 6000.0,
"health_insurer": "111",
"last_name": "Nová",
"note": null,
"personal_number": null,
"started_on": "2026-10-01",
"student": false,
"terms": [],
"updated_at": "2026-09-28T10:00:00.000Z",
"ztpp": false,
"full_name": "Tereza Nová",
"terms_timeline": [],
"default_valid_from": null,
"current_terms": {
"gross_wage": 6000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": false,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"vacation": null,
"ended": false
},
{
"id": 1,
"bank_account": "7385178468/0800",
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"contract": "hpp",
"created_at": "2026-09-28T10:00:00.000Z",
"declaration": true,
"deductions": [],
"details": {
"birth_date": "1990-04-12"
},
"disability": null,
"email": null,
"ended_on": null,
"first_name": "Anna",
"gross_wage": 52000.0,
"health_insurer": "111",
"last_name": "Ukázková",
"note": null,
"personal_number": null,
"started_on": "2025-04-01",
"student": false,
"terms": [],
"updated_at": "2026-09-28T10:00:00.000Z",
"ztpp": false,
"full_name": "Anna Ukázková",
"terms_timeline": [],
"default_valid_from": "2026-10",
"current_terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"vacation": {
"year": 2026,
"weeks": 4.0,
"entitlement": 160.0,
"taken": 0.0,
"remaining": 160.0
},
"ended": false
}
]
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Nový pracovník
/entities/{entity_id}/employees
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Založí kartu pracovníka s druhem pracovněprávního vztahu (HPP, DPČ nebo DPP), sjednanou mzdou a údaji pro výpočet mzdy a pro hlášení JMHZ. Karta sama nevytvoří výplatní pásku ani nepřihlásí pracovníka u ČSSZ či zdravotní pojišťovny – pásky vzniknou voláním POST /entities/{entity_id}/payslips/generate.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
employee | objekt | ano | |
employee. | text | ano | Jméno, nejvýše 80 znaků |
employee. | text | ano | Příjmení, nejvýše 80 znaků |
employee. | text | ne | Osobní číslo |
employee. | text | ne | hpp pracovní poměr, dpc dohoda o pracovní činnosti, dpp dohoda o provedení práce Hodnoty: hpp, dpc, dpp. Výchozí hpp. |
employee. | číslo | ne | Sjednaná měsíční hrubá mzda (HPP) nebo měsíční odměna (DPČ, DPP), nejméně 0. Z ní vychází generování pásek; u HPP a DPČ se při vztahu jen po část měsíce krátí podle pracovních dnů (pondělí až pátek) a hodin nepřítomností a zaokrouhlí na celé Kč nahoru, u DPP ne. Výchozí 0. |
employee. | datum | ano | Datum nástupu, povinné; neplatné datum se uloží jako prázdné a založení skončí chybou 422 |
employee. | datum | ne | Datum ukončení, ne před nástupem; pásky se generují jen za měsíce, kdy vztah trval |
employee. | ano/ne | ne | Podepsané prohlášení poplatníka. Bez něj se měsíčně neuplatní slevy ani daňové zvýhodnění a z příjmu pod zákonným limitem (DPP, malý rozsah) se sráží 15% srážková daň. Výchozí true. |
employee. | text | ne | Invalidita: first I. nebo II. stupně (základní sleva), third III. stupně (rozšířená sleva); prázdné = žádná Hodnoty: first, third. |
employee. | ano/ne | ne | Držitel průkazu ZTP/P (sleva na dani, bez minimálního vyměřovacího základu ZP) Výchozí false. |
employee. | ano/ne | ne | Student – projeví se jen ve zdravotním pojištění (bez minimálního vyměřovacího základu) Výchozí false. |
employee. | text | ne | Kód zdravotní pojišťovny (111 VZP, 201 VoZP, 205 ČPZP, 207 OZP, 209 ZPŠ, 211 ZPMV, 213 RBP) Hodnoty: 111, 201, 205, 207, 209, 211, 213. |
employee. | text | ne | Číslo účtu pracovníka (jen evidence, Saldo mzdy nevyplácí) |
employee. | text | ne | E-mail v platném tvaru |
employee. | text | ne | Poznámka |
employee. | pole (objekt) | ne | Děti pro daňové zvýhodnění; odeslaný seznam nahradí uložený celý |
employee. | celé číslo | ne | Pořadí dítěte 1, 2 nebo 3; určuje výši zvýhodnění. Jiná hodnota skončí chybou 422 |
employee. | ano/ne | ne | Dítě je držitelem průkazu ZTP/P |
employee. | pole (celé číslo) | ne | Měsíce 1–12, za které se zvýhodnění uplatní v každém roce; bez pole každý měsíc (raději from a to) |
employee. | text | ne | Zvýhodnění od měsíce RRRR-MM (například narození); prázdné = od nástupu |
employee. | text | ne | Zvýhodnění do měsíce RRRR-MM (například konec studia); prázdné = bez konce |
employee. | text | ne | Jméno dítěte (pro JMHZ) |
employee. | text | ne | Příjmení dítěte (pro JMHZ) |
employee. | datum | ne | Datum narození dítěte (pro JMHZ) |
employee. | text | ne | Rodné číslo dítěte (pro JMHZ); neplatné skončí chybou 422 |
employee. | pole (objekt) | ne | Srážky ze mzdy; odeslaný seznam nahradí uložený celý, nová srážka dostane id |
employee. | text | ne | Identifikátor srážky (posílejte zpět u existujících, podle něj se sčítá zaplacená částka) |
employee. | text | ne | Výživné, jiná přednostní pohledávka, exekuce (nepřednostní), insolvence – oddlužení, dohoda o srážkách Hodnoty: maintenance, priority, execution, insolvency, agreement. |
employee. | text | ne | Plátce nebo věřitel, povinné |
employee. | text | ne | Spisová značka |
employee. | datum | ne | Datum doručení – pořadí a začátek srážek (od dalšího měsíce); povinné kromě dohody |
employee. | číslo | ne | Dlužná částka; prázdné = bez omezení |
employee. | číslo | ne | Měsíční částka (běžné výživné, dohoda); u dohody povinná |
employee. | text | ne | Účet plátce ve tvaru [předčíslí-]číslo/kód banky |
employee. | text | ne | Variabilní symbol platby |
employee. | text | ne | Specifický symbol |
employee. | text | ne | Konstantní symbol |
employee. | text | ne | Srážet od měsíce RRRR-MM (jinak od měsíce po doručení) |
employee. | text | ne | Srážet do měsíce RRRR-MM |
employee. | objekt | ne | Údaje pro JMHZ a další příznaky. Při úpravě se slučují s uloženými: odeslaný klíč přepíše uložený, prázdná hodnota (null, "" nebo prázdný objekt) klíč odstraní, neposlané klíče zůstanou; neznámé klíče se zahodí. |
employee. | text | ne | OIČ (IK MPSV) z registrace zaměstnance – 10 číslic |
employee. | text | ne | ID pracovněprávního vztahu z registrace – až 22 číslic |
employee. | datum | ne | Datum narození |
employee. | text | ne | Rodné číslo bez lomítka; spojuje karty téže osoby (maximální základ, úhrn DPP, jedna záloha); neplatné skončí chybou 422 |
employee. | text | ne | Druh činnosti podle registrace (1–9 pracovní poměr, A–J DPČ, T–ZC DPP) |
employee. | text | ne | Kód ELDP |
employee. | ano/ne | ne | Primární pracovněprávní vztah u zaměstnavatele |
employee. | objekt | ne | Místo výkonu práce |
employee. | text | ne | Obec |
employee. | text | ne | Kód obce, 6 číslic (číselník ČSÚ) |
employee. | text | ne | Stát, dvoupísmenný kód (např. CZ) |
employee. | číslo | ne | Sjednaná týdenní pracovní doba (hodin, nejvýše 40); fond pracovní doby, krácení a doplatek do minimální mzdy |
employee. | text | ne | Druh mzdy; hourly = hourly_rate × odpracované hodiny Hodnoty: monthly, hourly. |
employee. | číslo | ne | Stravenkový paušál v Kč za směnu (bez daně do limitu roku) |
employee. | objekt | ne | Služební auto i pro soukromé účely (nepeněžní příjem 1 %, 0,5 % nízkoemisní, 0,25 % bezemisní, aspoň 1 000 Kč) |
employee. | číslo | ne | Vstupní cena včetně DPH |
employee. | text | ne | Druh pohonu Hodnoty: standard, low, zero. |
employee. | celé číslo | ne | Karta majetku firmy (cizí karta skončí chybou 422) |
employee. | číslo | ne | Nárok na dovolenou v týdnech za rok (prázdné = 4) |
employee. | celé číslo | ne | Počet vyživovaných osob pro nezabavitelnou částku (prázdné = počet dětí) |
employee. | číslo | ne | Stanovená týdenní pracovní doba podle § 79 zákoníku práce |
employee. | číslo | ne | Sjednaný rozsah dohody za měsíc (hodin) |
employee. | číslo | ne | Hodinová mzda nebo odměna z dohody (Kč) |
employee. | číslo | ne | Průměrný hodinový výdělek (Kč); prázdné = Saldo ho spočítá z předchozího čtvrtletí |
employee. | ano/ne | ne | Srážky ze mzdy vedené mimo Saldo (srážky v deductions hlášení vykáže samo) |
employee. | ano/ne | ne | Tytéž děti vyživuje i jiná osoba ve společné domácnosti |
employee. | objekt | ne | Jiná osoba vyživující tytéž děti |
employee. | text | ne | Jméno |
employee. | text | ne | Příjmení |
employee. | datum | ne | Datum narození |
employee. | text | ne | Rodné číslo |
employee. | ano/ne | ne | Funkční požitky podle § 6 odst. 10 ZDP |
employee. | ano/ne | ne | Poživatel starobního důchodu – sleva 6,5 % na sociálním pojistném zaměstnance (od 2025) |
employee. | ano/ne | ne | Po celý měsíc neplatí minimální vyměřovací základ zdravotního pojištění |
Odpověď
201 application/json Založená karta pracovníka (stejná pole jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Neplatná karta – chybí nástup, ukončení před nástupem, pořadí dítěte mimo 1–3, neplatné rodné číslo, měsíc mimo RRRR-MM, neplatná srážka nebo auto; v errors po polích |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří kartu pracovníka a zapíše událost employee.created. Pásky ani účetní zápisy nevytváří.
- Opakování
- Každé volání založí nového pracovníka; duplicity se nekontrolují.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"employee":{"first_name":"Jana","last_name":"Nováková","contract":"hpp","gross_wage":42000,"started_on":"2026-03-01","declaration":true,"health_insurer":"111","children":[{"first_name":"Tomáš","last_name":"Novák","birth_date":"2018-05-12","order":1}],"details":{"weekly_hours":40,"workplace":{"municipality":"Brno","municipality_code":"582786","country":"CZ"}}}}' \
https://techtools.cz/ucetnictvi-api/entities/1/employeesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"employee": {
"first_name": "Jana",
"last_name": "Nováková",
"contract": "hpp",
"gross_wage": 42000,
"started_on": "2026-03-01",
"declaration": true,
"health_insurer": "111",
"children": [
{
"first_name": "Tomáš",
"last_name": "Novák",
"birth_date": "2018-05-12",
"order": 1
}
],
"details": {
"weekly_hours": 40,
"workplace": {
"municipality": "Brno",
"municipality_code": "582786",
"country": "CZ"
}
}
}
})
});
const data = await response.json();{
"id": 4,
"bank_account": null,
"children": [
{
"first_name": "Tomáš",
"last_name": "Novák",
"birth_date": "2018-05-12",
"order": 1
}
],
"contract": "hpp",
"created_at": "2026-09-28T10:00:00.000Z",
"declaration": true,
"deductions": [],
"details": {
"weekly_hours": 40,
"workplace": {
"municipality": "Brno",
"municipality_code": "582786",
"country": "CZ"
}
},
"disability": null,
"email": null,
"ended_on": null,
"first_name": "Jana",
"gross_wage": 42000.0,
"health_insurer": "111",
"last_name": "Nováková",
"note": null,
"personal_number": null,
"started_on": "2026-03-01",
"student": false,
"terms": [],
"updated_at": "2026-09-28T10:00:00.000Z",
"ztpp": false,
"full_name": "Jana Nováková",
"terms_timeline": [],
"default_valid_from": null,
"current_terms": {
"gross_wage": 42000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": 40.0,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"vacation": {
"year": 2026,
"weeks": 4.0,
"entitlement": 135.0,
"taken": 0.0,
"remaining": 135.0
},
"ended": false
}
GET Jména pracovníků
/entities/{entity_id}/employees/names
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí jen ID a jméno každého pracovníka firmy (i s ukončeným vztahem), seřazené podle příjmení a jména. Slouží k výběru cestujícího v cestovním příkazu a řidiče v knize jízd; osobní údaje, mzdy ani údaje pro JMHZ neobsahuje, a proto ho smí každý člen firmy i bez přístupu ke mzdám.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Odpověď
200 application/json Pole pracovníků.
| Pole | Význam |
|---|---|
id | ID pracovníka (employee_id v cestách a jízdách) |
full_name | Jméno a příjmení |
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/employees/namesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees/names', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 3,
"full_name": "Tereza Nová"
},
{
"id": 1,
"full_name": "Anna Ukázková"
}
]
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Úprava karty pracovníka
/entities/{entity_id}/employees/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní zaslaná pole karty. Pole children a deductions se nahradí celým odeslaným seznamem; details se slučují s uloženými (odeslané klíče přepíší, prázdné hodnoty odstraní, neposlané zůstanou; příznaky se převedou na true/false). Změna mzdového výměru (gross_wage, declaration, disability, ztpp, student a v details wage_kind, hourly_rate, weekly_hours, monthly_hours, pensioner, health_minimum_exempt, meal_allowance_rate, company_car) platí od měsíce valid_from; bez parametru od měsíce po poslední pásce pracovníka, s valid_from „start“ pro celou historii. Pásky se přepočítají až výpočtem měsíce a každý měsíc použije výměr platný v něm.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
employee | objekt | ano | |
employee. | text | ne | Jméno, nejvýše 80 znaků |
employee. | text | ne | Příjmení, nejvýše 80 znaků |
employee. | text | ne | Osobní číslo |
employee. | text | ne | hpp pracovní poměr, dpc dohoda o pracovní činnosti, dpp dohoda o provedení práce Hodnoty: hpp, dpc, dpp. |
employee. | číslo | ne | Sjednaná měsíční hrubá mzda (HPP) nebo měsíční odměna (DPČ, DPP), nejméně 0 |
employee. | datum | ne | Datum nástupu; neplatné datum se uloží jako prázdné |
employee. | datum | ne | Datum ukončení; pásky se generují jen za měsíce, kdy vztah trval |
employee. | ano/ne | ne | Podepsané prohlášení poplatníka |
employee. | text | ne | Invalidita: first I. nebo II. stupně, third III. stupně; prázdné = žádná Hodnoty: first, third. |
employee. | ano/ne | ne | Držitel průkazu ZTP/P |
employee. | ano/ne | ne | Student – projeví se jen ve zdravotním pojištění |
employee. | text | ne | Kód zdravotní pojišťovny Hodnoty: 111, 201, 205, 207, 209, 211, 213. |
employee. | text | ne | Číslo účtu pracovníka (jen evidence) |
employee. | text | ne | E-mail v platném tvaru |
employee. | text | ne | Poznámka |
employee. | pole (objekt) | ne | Děti pro daňové zvýhodnění; odeslaný seznam nahradí uložený celý |
employee. | celé číslo | ne | Pořadí dítěte 1, 2 nebo 3; jiná hodnota skončí chybou 422 |
employee. | text | ne | Zvýhodnění od měsíce RRRR-MM |
employee. | text | ne | Zvýhodnění do měsíce RRRR-MM |
employee. | ano/ne | ne | Dítě je držitelem průkazu ZTP/P |
employee. | pole (celé číslo) | ne | Měsíce 1–12, za které se zvýhodnění uplatní; bez pole každý měsíc |
employee. | text | ne | Jméno dítěte |
employee. | text | ne | Příjmení dítěte |
employee. | datum | ne | Datum narození dítěte |
employee. | text | ne | Rodné číslo dítěte |
employee. | objekt | ne | Údaje pro JMHZ a příznaky se stejnými klíči jako při založení (oic, employment_id, birth_date, birth_number, activity_code, eldp_code, primary, workplace, weekly_hours, standard_weekly_hours, monthly_hours, hourly_rate, average_hourly_earnings, garnishment, shared_children, other_parent, functional_emoluments, pensioner, health_minimum_exempt, wage_kind, meal_allowance_rate, company_car, vacation_weeks, dependants). Odeslané klíče přepíší uložené, prázdná hodnota (null, "" nebo prázdný objekt) klíč odstraní, neposlané klíče zůstanou, příznaky se převedou na true/false a neznámé klíče se zahodí. |
valid_from | text | ne | Mimo objekt employee: měsíc RRRR-MM, od kterého platí změna výměru; „start“ nebo prázdné = oprava od nástupu; bez parametru měsíc po poslední pásce. Uzavřený měsíc skončí chybou 422 |
valid_note | text | ne | Mimo objekt employee: poznámka ke změně výměru (nejvýše 200 znaků) |
valid_keys | pole (text) | ne | Mimo objekt employee: klíče výměru (např. monthly_hours), které platí od valid_from, i když je karta už má, třeba od pozdějšího měsíce |
Odpověď
200 application/json Upravená karta pracovníka (s terms a terms_timeline).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Neplatná karta (jako při založení), valid_from není RRRR-MM, nebo změna výměru od uzavřeného měsíce – „Mzdy za 8/2026 jsou uzavřené – změnu výměru zadejte od prvního otevřeného měsíce.“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží kartu pracovníka a historii výměru; výplatní pásky ani zaúčtování nemění. Když se něco změnilo, zapíše událost employee.updated s původními a novými hodnotami; osobní číslo, bankovní účet, děti, údaje JMHZ, výměr a srážky jen jako hidden.
- Opakování
- Opakování se stejnými daty vede ke stejnému stavu.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"valid_from":"2026-12","employee":{"gross_wage":54000,"details":{"weekly_hours":40,"pensioner":false}}}' \
https://techtools.cz/ucetnictvi-api/entities/1/employees/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"valid_from": "2026-12",
"employee": {
"gross_wage": 54000,
"details": {
"weekly_hours": 40,
"pensioner": false
}
}
})
});
const data = await response.json();{
"gross_wage": 54000.0,
"details": {
"birth_date": "1990-04-12",
"weekly_hours": 40.0
},
"terms": [
{
"from": null,
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
{
"from": "2026-12",
"gross_wage": 54000.0,
"weekly_hours": 40.0,
"recorded_at": "2026-09-28T10:00:00Z"
}
],
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"id": 1,
"bank_account": "7385178468/0800",
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"contract": "hpp",
"created_at": "2026-09-28T10:00:00.000Z",
"deductions": [],
"email": null,
"ended_on": null,
"first_name": "Anna",
"health_insurer": "111",
"last_name": "Ukázková",
"note": null,
"personal_number": null,
"started_on": "2025-04-01",
"updated_at": "2026-09-28T10:00:00.000Z",
"full_name": "Anna Ukázková",
"terms_timeline": [
{
"from": null,
"values": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"changes": [],
"note": null
},
{
"from": "2026-12",
"values": {
"gross_wage": 54000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": 40.0,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"changes": [
"gross_wage",
"weekly_hours"
],
"note": null
}
],
"default_valid_from": "2026-10",
"current_terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"vacation": {
"year": 2026,
"weeks": 4.0,
"entitlement": 160.0,
"taken": 0.0,
"remaining": 160.0
},
"ended": false
}
DELETE Smazání pracovníka bez výplatních pásek
/entities/{entity_id}/employees/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže kartu pracovníka, který nemá žádnou výplatní pásku. Pracovníka s páskami nelze smazat – ukončete vztah polem ended_on. Cestovní příkazy s tímto pracovníkem zůstanou (s uloženým jménem cestujícího, employee_name bude null).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
Odpověď
204 Prázdná odpověď.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Pracovník má aspoň jednu výplatní pásku – „Pracovník má výplatní pásky – nastavte datum ukončení“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže kartu pracovníka. Do historie zapíše událost employee.deleted s jeho údaji (osobní identifikátory jen jako hidden).
- Opakování
- Druhé smazání vrátí 404.
Příklad
Maže pracovníka bez výplatních pásek; pracovníka s páskami API odmítne s chybou 422.
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/employees/3JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees/3', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
GET Mzdový list pracovníka za rok
/entities/{entity_id}/employees/{id}/sheet
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí mzdový list podle § 38j zákona o daních z příjmů: hlavičku pracovníka a měsíce roku s páskami se zúčtovaným příjmem, pojistným, základem daně, zálohou před slevami, slevami, daňovým zvýhodněním, bonusem, zálohou, srážkovou daní, čistou mzdou, srážkami a hodinami, s ročními součty a měsíci, za které platilo prohlášení poplatníka.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
year | dotaz | celé číslo | ne | Rok; bez parametru aktuální rok Rozsah od 2000 do 2100. Příklad 2026. |
Odpověď
200 application/json Mzdový list.
| Pole | Význam |
|---|---|
employee | id, name, personal_number, birth_number, birth_date, contract, started_on, ended_on, insurer, children, terms (výměr v prosinci) |
rows | Měsíce s páskou: month, gross, taxable, insurable, social_base, health_base, employee_social, employee_health, tax_kind, tax_base, advance_before_credits, credits, child_benefit, advance, withholding, bonus, net, deductions, payout, declaration, hours, lines |
totals | Roční součty částek |
credits, child_benefit, declaration_months, hours | Roční součty slev a zvýhodnění, měsíce s prohlášením a hodiny |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
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/employees/1/sheet?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/employees/1/sheet?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"employee": {
"id": 1,
"name": "Anna Ukázková",
"personal_number": null,
"birth_number": null,
"birth_date": "1990-04-12",
"contract": "hpp",
"started_on": "2025-04-01",
"ended_on": null,
"insurer": "111",
"children": [
{
"first_name": "Eliška",
"last_name": "Ukázková",
"order": 1
}
],
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
}
},
"rows": [
{
"payslip_id": 1,
"employee_id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"insurer": "111",
"status": "posted",
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"social_base": 52000.0,
"health_base": 52000.0,
"employee_social": 3692.0,
"employee_health": 2340.0,
"employer_social": 12896.0,
"employer_health": 4680.0,
"advance": 3963.0,
"withholding": 0.0,
"bonus": 0.0,
"net": 42005.0,
"deductions": 0.0,
"exempt": 0.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"month": 1,
"tax_kind": "advance",
"tax_base": 52000.0,
"advance_before_credits": 7800.0,
"credits": {
"taxpayer": 2570.0
},
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"declaration": true,
"hours": {
"worked": 168.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0
},
"lines": [
{
"label": "Mzda",
"amount": 52000.0
}
]
},
{
"payslip_id": 2,
"employee_id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"insurer": "111",
"status": "posted",
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"social_base": 52000.0,
"health_base": 52000.0,
"employee_social": 3692.0,
"employee_health": 2340.0,
"employer_social": 12896.0,
"employer_health": 4680.0,
"advance": 3963.0,
"withholding": 0.0,
"bonus": 0.0,
"net": 42005.0,
"deductions": 0.0,
"exempt": 0.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"month": 2,
"tax_kind": "advance",
"tax_base": 52000.0,
"advance_before_credits": 7800.0,
"credits": {
"taxpayer": 2570.0
},
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"declaration": true,
"hours": {
"worked": 160.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0
},
"lines": [
{
"label": "Mzda",
"amount": 52000.0
}
]
}
],
"totals": {
"gross": 468000.0,
"taxable": 468000.0,
"insurable": 468000.0,
"social_base": 468000.0,
"health_base": 468000.0,
"employee_social": 33228.0,
"employee_health": 21060.0,
"employer_social": 116064.0,
"employer_health": 42120.0,
"advance": 35667.0,
"withholding": 0.0,
"bonus": 0.0,
"net": 378045.0,
"deductions": 0.0,
"exempt": 0.0,
"payout": 378045.0,
"employer_cost": 626184.0
},
"credits": {
"taxpayer": 23130.0,
"disability": 0.0,
"disability_third_degree": 0.0,
"ztpp": 0.0
},
"child_benefit": {
"total": 11403.0,
"as_credit": 11403.0,
"bonus": 0.0
},
"declaration_months": [
1,
2
],
"hours": {
"worked": 1504.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0
}
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Výplatní pásky za rok nebo měsíc
/entities/{entity_id}/payslips
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí výplatní pásky firmy za kalendářní rok, volitelně jen za jeden měsíc, seřazené podle měsíce a ID pracovníka. Páska nese hrubou a čistou mzdu, náklady zaměstnavatele, stav (draft koncept, approved schváleno, posted zaúčtováno) a v data celý výpočet: pojistné, daň, účetní předpis, krácení, docházku a upozornění.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok pásek; bez parametru nebo při nečíselné hodnotě aktuální rok, mimo rozsah se zarovná na 2000 až 2100. Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ne | Měsíc 1–12; bez něj vrátí pásky celého roku. Příklad 8. |
Odpověď
200 application/json Pole výplatních pásek.
| Pole | Význam |
|---|---|
id, employee_id, employee_name, year, month | Páska a pracovník |
gross, net, employer_cost | Hrubá mzda, čistá mzda a celkové náklady zaměstnavatele v Kč |
status | draft, approved nebo posted |
data | Výpočet: lines (složky mzdy: kind, label, amount, hours), taxable, insurable, exempt, insured, assessment_base, employee, employer, health_min_base_topup, tax, net, payout (k výplatě po srážkách; záporná = doplatek zaměstnance), deductions, average, hours, inputs (výměr a děti, ze kterých se páska spočítala), postings, warnings, absences, items, případně proration, gross_override a attendance |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
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/payslips?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Mzda",
"amount": 52000.0
}
],
"base_gross": 52000.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 176.0,
"worked": 168.0,
"holiday": 8.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hourly": 298.99,
"source": "probable",
"quarter": "2025-Q4"
},
"inputs": {
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"children": [
{
"order": 1
}
],
"contract": "hpp",
"started_on": "2025-04-01",
"ended_on": null,
"person": "employee:1",
"primary": true
}
},
"employee_id": 1,
"employer_cost": 69576.0,
"gross": 52000.0,
"month": 1,
"net": 42005.0,
"status": "posted",
"updated_at": "2026-09-28T10:00:00.000Z",
"year": 2026,
"employee_name": "Anna Ukázková"
},
{
"id": 2,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Mzda",
"amount": 52000.0
}
],
"base_gross": 52000.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 160.0,
"worked": 160.0,
"holiday": 0.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hourly": 298.99,
"source": "probable",
"quarter": "2025-Q4"
},
"inputs": {
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
…
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Orientační výpočet mzdy bez uložení
/entities/{entity_id}/payslips/calculate
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Spočítá výplatní pásku z anonymních vstupů bez vazby na pracovníka a nic neuloží: pojistné zaměstnance i zaměstnavatele, zálohu nebo srážkovou daň se slevami a daňovým zvýhodněním, čistou mzdu, částku k výplatě, náklady zaměstnavatele a účetní předpis. Přijímá i agreed_wage, ytd_social_base, employed_days, pensioner_discount a health_minimum_exempt jako veřejná kalkulačka POST /calc/payroll. Nepřítomnosti, benefity a srážky počítá jen výpočet skutečné pásky.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Rok sazeb; bez hodnoty aktuální rok |
month | celé číslo | ne | Měsíc 1–12; bez hodnoty aktuální měsíc; jiná hodnota skončí chybou 422 |
contract | text | ne | Druh pracovněprávního vztahu; jiná hodnota skončí chybou 422 Hodnoty: hpp, dpc, dpp. Výchozí hpp. |
gross | číslo | ne | Hrubá mzda v Kč, nezáporná (záporná skončí chybou 422); bez hodnoty nebo nečíselná 0 |
pensioner_discount | ano/ne | ne | Sleva 6,5 % pro pracujícího důchodce |
health_minimum_exempt | ano/ne | ne | Bez doplatku do minimálního vyměřovacího základu ZP |
agreed_wage | číslo | ne | Sjednaná částka pro účast zaměstnání malého rozsahu |
ytd_social_base | číslo | ne | Vyměřovací základ sociálního pojištění od začátku roku (pro maximální základ) |
employed_days | celé číslo | ne | Kalendářní dny zaměstnání v měsíci (krácení minimálního základu ZP) |
declaration | ano/ne | ne | Podepsané prohlášení poplatníka Výchozí true. |
disability | text | ne | Stupeň invalidity; first/second a 1/2 = I. a II. stupeň, third a 3 = III. stupeň, 0 nebo prázdné = žádná Hodnoty: first, second, third, 1, 2, 3, 0. |
ztpp | ano/ne | ne | Držitel průkazu ZTP/P Výchozí false. |
student | ano/ne | ne | Student Výchozí false. |
children | pole (objekt) | ne | Děti pro daňové zvýhodnění (uplatní se ve všech měsících) |
children[] | celé číslo | ne | Pořadí dítěte (1, 2, 3) |
children[] | ano/ne | ne | Dítě je držitelem průkazu ZTP/P |
children[] | pole (celé číslo) | ne | Měsíce, za které se zvýhodnění uplatní |
Odpověď
200 application/json Výpočet výplatní pásky.
| Pole | Význam |
|---|---|
gross, taxable, insurable | Hrubá mzda, zdanitelný příjem a příjem pro pojistné (zde stejné) |
insured | Účast na pojištění: social, health |
assessment_base | Vyměřovací základy: social, health |
employee, employer | Pojistné zaměstnance a zaměstnavatele: social, health, total |
health_min_base_topup | Doplatek zdravotního pojistného do minimálního vyměřovacího základu |
tax | Daň: base, rounded_base, rate_split, advance_before_credits, credits, child_benefit (total, as_credit, bonus), advance, withholding, kind (advance nebo withholding) |
net | Čistá mzda |
payout | K výplatě: čistá mzda plus daňový bonus |
employer_cost | Hrubá mzda plus pojistné zaměstnavatele |
postings | Účetní předpis, který by se zaúčtoval: debit, credit, amount, text |
warnings | Upozornění (česky) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Pro zadaný rok nejsou v Saldu zákonné sazby – „Pro rok RRRR nejsou k dispozici zákonné sazby“ |
| 422 | – | Vstup, který výpočet odmítne: záporná gross, month mimo 1–12, neznámý contract nebo disability, nečíselné children[].order – error s českým popisem |
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 \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"month":9,"contract":"hpp","gross":52000,"declaration":true,"children":[{"order":1}]}' \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/calculateJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/calculate', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2026,
"month": 9,
"contract": "hpp",
"gross": 52000,
"declaration": true,
"children": [
{
"order": 1
}
]
})
});
const data = await response.json();{
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Vygenerování výplatních pásek za měsíc
/entities/{entity_id}/payslips/generate
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
V jedné transakci vytvoří nebo přepočítá výplatní pásky všech pracovníků, jejichž vztah v daném měsíci trval aspoň jeden den, a smaže nezaúčtované pásky pracovníků, kteří v měsíci už nepracovali. Základem je mzdový výměr platný v daném měsíci; u HPP a DPČ trvajících jen část měsíce se mzda krátí podle pracovních dnů (pondělí až pátek) a hodin nepřítomností, u DPP ne. Vztahy téže osoby (rodné číslo) počítá společně: úhrn DPP pro účast na pojištění, úhrny pro srážkovou daň, jednu zálohu z úhrnu a jeden doplatek do minima ZP. Zachová nepřítomnosti, složky mzdy, ruční hrubou mzdu, docházku a roční zúčtování pásky a nezaúčtované pásky vrátí do stavu draft. Zaúčtované pásky ponechá beze změny. Uzavřený nebo uzamčený měsíc odmítne. Rok se zadává v query, měsíc v těle.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok pásek; bez parametru nebo při nečíselné hodnotě aktuální rok, mimo rozsah se zarovná na 2000 až 2100. Rozsah od 2000 do 2100. Příklad 2026. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
month | celé číslo | ano | Měsíc pásek 1–12; chybějící měsíc vrátí 400, jiná hodnota 422 Rozsah od 1 do 12. |
Odpověď
201 application/json Pásky měsíce po generování.
| Pole | Význam |
|---|---|
year, month | Období |
payslips | Pásky pracovníků, jejichž vztah v měsíci trval (nové, přepočtené i nezměněné zaúčtované), ve tvaru jako v seznamu |
calculated, skipped | Počet spočítaných pásek a jména pracovníků se zaúčtovanou páskou, kterou výpočet přeskočil |
removed, stale_posted | Jména pracovníků, jejichž nezaúčtovanou pásku výpočet smazal, a těch, jejichž zaúčtovaná páska mimo vztah zůstala |
warnings | Upozornění: výpočet dopředu, podané hlášení JMHZ za měsíc |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Pro rok nejsou v Saldu zákonné sazby – „Pro rok RRRR nejsou k dispozici zákonné sazby“ |
| 422 | – | Měsíc je uzavřený nebo uzamčený („Mzdy za 7/2026 jsou uzavřené …“, „Období je uzamčeno do …“), nebo výpočet některé pásky selže – „Mzdu pracovníka … nelze spočítat: …“; nic se neuloží |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří, přepíše nebo smaže nezaúčtované výplatní pásky měsíce (stav draft) a zapíše událost payroll.generated. Nic nezaúčtuje, nevyplatí ani nepodá (JMHZ se připravuje zvlášť).
- Opakování
- Duplicitní pásky nevzniknou (jedna páska na pracovníka a měsíc); opakované volání znovu přepočítá nezaúčtované pásky a zapíše novou událost.
Příklad
Prosinec aktuálního roku ukázková firma ještě nemá, takže příklad vytvoří nové pásky ve stavu draft.
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"month":12}' \
"https://techtools.cz/ucetnictvi-api/entities/1/payslips/generate?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/generate?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"month": 12
})
});
const data = await response.json();{
"year": 2026,
"month": 12,
"payslips": [
{
"id": 18,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Mzda",
"amount": 52000.0
}
],
"base_gross": 52000.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 184.0,
"worked": 168.0,
"holiday": 16.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hourly": 304.69,
"source": "quarter",
"quarter": "2026-Q3",
"wage": 156000.0,
"hours": 512.0
},
"inputs": {
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"contract": "hpp",
"started_on": "2025-04-01",
"ended_on": null,
"person": "employee:1",
"primary": true
}
},
"employee_id": 1,
"employer_cost": 69576.0,
"gross": 52000.0,
"month": 12,
"net": 42005.0,
"status": "draft",
"updated_at": "2026-09-28T10:00:00.000Z",
"year": 2026,
"employee_name": "Anna Ukázková"
},
{
"id": 19,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 8500.0,
"taxable": 8500.0,
"insurable": 8500.0,
"insured": {
"social": false,
"health": false
},
"assessment_base": {
"social": 0.0,
"health": 0.0
},
"employee": {
"social": 0.0,
"health": 0.0,
"total": 0.0
},
"employer": {
"social": 0.0,
"health": 0.0,
"total": 0.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 8500.0,
"rounded_base": 8500.0,
"rate_split": [
{
"rate": 0.15,
"base": 8500.0,
"tax": 1275.0
}
],
"advance_before_credits": 0.0,
"credits": [],
"child_benefit": {
"total": 0.0,
"as_credit": 0.0,
"bonus": 0.0
},
"advance": 0.0,
"withholding": 1275.0,
"kind": "withholding"
},
"net": 7225.0,
"payout": 7225.0,
"employer_cost": 8500.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 8500.0,
"text": "Hrubá mzda"
},
{
"debit": "331",
"credit": "342",
"amount": 1275.0,
"text": "Srážková daň z příjmů ze závislé činnosti"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Odměna z dohody",
"amount": 8500.0
}
],
"base_gross": 8500.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 184.0,
"worked": 184.0,
"holiday": 16.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hou
…
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Úprava výplatní pásky – nepřítomnosti, složky mzdy, ruční mzda, stav a docházka
/entities/{entity_id}/payslips/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Pole se posílají přímo v těle bez obalu. absences, items, gross a bonuses pásku uloží a přepočítají (spolu s ostatními vztahy téže osoby v měsíci) a vrátí do stavu draft; neposlané pole zůstane. absences a items nahradí uložený seznam celý. gross nastaví ruční základní mzdu místo výměru (null ji zruší), bonuses jednorázové prémie. status přepne draft/approved (jiné hodnoty se ignorují). attendance nahradí ruční docházku pro JMHZ, výpočet mzdy nemění. U zaúčtované pásky lze měnit jen docházku; v uzavřeném nebo uzamčeném měsíci nic.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID výplatní pásky Příklad 41. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
absences | pole (objekt) | ne | Nepřítomnosti v měsíci pásky |
absences[] | text | ne | Nemoc/karanténa, dovolená, OČR, mateřská/rodičovská, neplacené volno, placené volno, překážka na straně zaměstnavatele Hodnoty: sick, vacation, ocr, maternity, unpaid, paid_leave, employer_obstacle. |
absences[] | datum | ne | První den (v měsíci pásky) |
absences[] | datum | ne | Poslední den; prázdné = from |
absences[] | číslo | ne | Hodiny místo celých pracovních dnů |
absences[] | datum | ne | U nemoci pokračující z minulého měsíce její začátek (14 dní náhrady) |
items | pole (objekt) | ne | Složky mzdy |
items[] | text | ne | Druh složky Hodnoty: worked_hours, overtime, night, weekend, holiday_work, bonus, bonus_regular, other, meal_allowance, benefit_taxable, benefit_exempt. |
items[] | číslo | ne | Hodiny (worked_hours, overtime, night, weekend, holiday_work) |
items[] | číslo | ne | Částka v Kč (bonus, bonus_regular, other, benefit_taxable, benefit_exempt) |
items[] | číslo | ne | Počet směn (meal_allowance) |
items[] | číslo | ne | Sazba stravenkového paušálu za směnu (jinak z karty) |
items[] | text | ne | Druh osvobozeného benefitu Hodnoty: leisure, health. |
items[] | text | ne | Popis na pásce |
gross | číslo | ne | Ruční základní hrubá mzda pásky v Kč místo výměru; null nebo prázdné ji zruší |
bonuses | číslo | ne | Jednorázové prémie v Kč (stejné jako složka bonus) |
status | text | ne | Stav pásky; zaúčtování provede POST …/post_entries Hodnoty: draft, approved. |
attendance | objekt | ne | Docházka pro JMHZ; prázdné hodnoty se vynechají, desetinná čárka je dovolena, jiné klíče se zahodí |
attendance. | číslo | ne | Odpracované hodiny |
attendance. | číslo | ne | Přesčasové hodiny (z odpracovaných) |
attendance. | číslo | ne | Příplatky za práci přesčas (Kč) |
attendance. | číslo | ne | Hodiny čerpané dovolené |
attendance. | číslo | ne | Náhrada mzdy za dovolenou (Kč) |
attendance. | číslo | ne | Hodiny neplaceného volna |
Odpověď
200 application/json Upravená výplatní páska (tvar jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Páska je zaúčtovaná a požadavek mění něco jiného než docházku – „Zaúčtovanou pásku nelze měnit – smažte ji a vytvořte znovu“ |
| 422 | – | Měsíc je uzavřený nebo uzamčený, nepřítomnost mimo měsíc pásky nebo neznámého druhu, záporné hodiny či částka, nebo přepočet selže („Mzdu pracovníka … nelze spočítat“); nic se neuloží |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží pásku (přepočet, stav, docházku) a zapíše událost payroll.updated. Účetní zápisy nemění – změněnou pásku je třeba znovu zaúčtovat.
- Opakování
- Opakování se stejnými hodnotami vede ke stejnému výsledku; každé volání zapíše událost payroll.updated.
Příklad
Docházku lze zapsat i do zaúčtované pásky; změna gross nebo bonuses vyžaduje nezaúčtovanou pásku.
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"attendance":{"worked_hours":160,"overtime_hours":4,"vacation_hours":8,"vacation_pay":2150}}' \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/16JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/16', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"attendance": {
"worked_hours": 160,
"overtime_hours": 4,
"vacation_hours": 8,
"vacation_pay": 2150
}
})
});
const data = await response.json();{
"id": 16,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Mzda",
"amount": 52000.0
}
],
"base_gross": 52000.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 176.0,
"worked": 168.0,
"holiday": 8.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hourly": 319.67,
"source": "quarter",
"quarter": "2026-Q2",
"wage": 156000.0,
"hours": 488.0
},
"inputs": {
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"contract": "hpp",
"started_on": "2025-04-01",
"ended_on": null,
"person": "employee:1",
"primary": true
},
"attendance": {
"worked_hours": 160.0,
"overtime_hours": 4.0,
"vacation_hours": 8.0,
"vacation_pay": 2150.0
}
},
"employee_id": 1,
"employer_cost": 69576.0,
"gross": 52000.0,
"month": 9,
"net": 42005.0,
"status": "draft",
"updated_at": "2026-09-28T10:00:00.000Z",
"year": 2026,
"employee_name": "Anna Ukázková"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Smazání výplatní pásky
/entities/{entity_id}/payslips/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže výplatní pásku včetně jejích účetních zápisů; u zaúčtované pásky pak přepočte zápis zaokrouhlení sociálního pojistného zaměstnavatele za měsíc. V uzamčeném období ani v uzavřených mzdách nelze.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID výplatní pásky Příklad 41. |
Odpověď
204 Prázdná odpověď.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Poslední den měsíce pásky leží v uzamčeném období – „Období je uzamčeno – pásku nelze smazat“ – nebo jsou mzdy za měsíc uzavřené |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- V jedné transakci smaže účetní zápisy pásky (zdroj payroll), pásku samotnou a u zaúčtované pásky přepočte zápis zaokrouhlení sociálního pojistného zaměstnavatele za měsíc; zapíše událost payroll.deleted.
- Opakování
- Druhé smazání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/16JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/16', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Zaúčtování výplatní pásky
/entities/{entity_id}/payslips/{id}/post_entries
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaúčtuje mzdový předpis pásky k poslednímu dni jejího měsíce a nastaví stav posted; schválení se nevyžaduje. Zápisy vzniknou z výpočtu pásky (data.postings): hrubá mzda MD 521 / D 331, pojistné zaměstnavatele MD 524 / D 336, pojistné zaměstnance MD 331 / D 336, záloha nebo srážková daň MD 331 / D 342, daňový bonus MD 342 / D 331. Pak přepočte zápis zaokrouhlení sociálního pojistného zaměstnavatele za měsíc (rozdíl mezi součtem z pásek a pojistným zaokrouhleným jednou z úhrnu vyměřovacích základů, jako v hlášení ČSSZ). Mzdu nevyplácí ani neodvádí pojistné a daň – úhrady se párují z banky.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID výplatní pásky Příklad 41. |
Odpověď
200 application/json Zaúčtovaná výplatní páska se stavem posted.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Firma nevede podvojné účetnictví – „Mzdy se účtují jen v podvojném účetnictví“ |
| 422 | – | Poslední den měsíce pásky 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í
- V jedné transakci smaže dřívější zápisy pásky, vytvoří nové účetní zápisy (zdroj payroll) s datem posledního dne měsíce, nastaví stav posted a přepočte zápis zaokrouhlení sociálního pojistného zaměstnavatele za měsíc; zapíše událost payroll.posted.
- Opakování
- Opakované zaúčtování nahradí zápisy pásky stejnými novými; stav zůstane posted.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/16/post_entriesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/16/post_entries', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"status": "posted",
"employee_id": 1,
"year": 2026,
"month": 9,
"gross": 52000.0,
"id": 16,
"created_at": "2026-09-28T10:00:00.000Z",
"data": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"insured": {
"social": true,
"health": true
},
"assessment_base": {
"social": 52000.0,
"health": 52000.0
},
"employee": {
"social": 3692.0,
"health": 2340.0,
"total": 6032.0
},
"employer": {
"social": 12896.0,
"health": 4680.0,
"total": 17576.0
},
"health_min_base_topup": 0.0,
"tax": {
"base": 52000.0,
"rounded_base": 52000.0,
"rate_split": [
{
"rate": 0.15,
"base": 52000.0,
"tax": 7800.0
}
],
"advance_before_credits": 7800.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"amount": 2570.0,
"entitlement": 2570.0
}
],
"child_benefit": {
"total": 1267.0,
"as_credit": 1267.0,
"bonus": 0.0
},
"advance": 3963.0,
"withholding": 0.0,
"kind": "advance"
},
"net": 42005.0,
"payout": 42005.0,
"employer_cost": 69576.0,
"postings": [
{
"debit": "521",
"credit": "331",
"amount": 52000.0,
"text": "Hrubá mzda"
},
{
"debit": "524",
"credit": "336",
"amount": 12896.0,
"text": "Sociální pojištění hrazené zaměstnavatelem"
}
],
"warnings": [],
"lines": [
{
"kind": "wage",
"label": "Mzda",
"amount": 52000.0
}
],
"base_gross": 52000.0,
"exempt": 0.0,
"hours": {
"daily": 8.0,
"fund": 176.0,
"worked": 168.0,
"holiday": 8.0,
"overtime": 0.0,
"vacation": 0.0,
"sick_paid": 0.0,
"sick_unpaid": 0.0,
"ocr": 0.0,
"maternity": 0.0,
"unpaid": 0.0,
"paid_leave": 0.0,
"employer_obstacle": 0.0,
"absent": 0.0
},
"average": {
"hourly": 319.67,
"source": "quarter",
"quarter": "2026-Q2",
"wage": 156000.0,
"hours": 488.0
},
"inputs": {
"terms": {
"gross_wage": 52000.0,
"wage_kind": "monthly",
"hourly_rate": null,
"weekly_hours": null,
"monthly_hours": null,
"declaration": true,
"disability": null,
"ztpp": false,
"student": false,
"pensioner": false,
"health_minimum_exempt": false,
"meal_allowance_rate": null,
"company_car": null
},
"children": [
{
"order": 1,
"first_name": "Eliška",
"last_name": "Ukázková",
"birth_number": "1855120003"
}
],
"contract": "hpp",
"started_on": "2025-04-01",
"ended_on": null,
"person": "employee:1",
"primary": true
}
},
"employer_cost": 69576.0,
"net": 42005.0,
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Uzavření mezd do měsíce
/entities/{entity_id}/payslips/close
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uzavře mzdy do zadaného měsíce včetně (nastavení payroll_closed_until): pásky uzavřených měsíců nejde spočítat, přepočítat, upravit ani smazat a výměr nejde změnit od uzavřeného měsíce. V daňové evidenci tím je hotový krok Mzdy v uzávěrce. Měsíc musí mít aspoň jednu pásku.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok; bez parametru aktuální rok Příklad 2026. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
month | celé číslo | ano | Měsíc 1–12 Rozsah od 1 do 12. |
Odpověď
200 application/json Poslední uzavřený den.
| Pole | Význam |
|---|---|
closed_until | Poslední den uzavřených mezd (RRRR-MM-DD) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Za měsíc nejsou spočítané žádné pásky, nebo neplatný měsíc |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží payroll_closed_until do nastavení firmy a zapíše událost payroll.closed.
- Opakování
- Opakování se stejným měsícem nic nezmění; uzavření dřívějšího měsíce uzávěrku nezkrátí.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"month":1}' \
"https://techtools.cz/ucetnictvi-api/entities/1/payslips/close?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/close?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"month": 1
})
});
const data = await response.json();{
"closed_until": "2026-01-31"
}
POST Otevření uzavřených mezd od měsíce
/entities/{entity_id}/payslips/reopen
- Oprávnění
- Vlastník nebo účetní
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Otevře mzdy od zadaného měsíce: uzavřené zůstanou jen měsíce před ním. V uzamčeném období nelze.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok; bez parametru aktuální rok Příklad 2026. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
month | celé číslo | ano | Měsíc 1–12, od kterého se mzdy otevřou Rozsah od 1 do 12. |
Odpověď
200 application/json Poslední uzavřený den.
| Pole | Význam |
|---|---|
closed_until | Poslední den mezd, které zůstaly uzavřené |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 403 | – | Volá jiná role než vlastník nebo účetní |
| 422 | – | Mzdy za měsíc nejsou uzavřené, nebo je měsíc 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í
- Uloží payroll_closed_until do nastavení firmy a zapíše událost payroll.reopened.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"month":1}' \
"https://techtools.cz/ucetnictvi-api/entities/1/payslips/reopen?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/reopen?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"month": 1
})
});
const data = await response.json();{
"closed_until": "2025-12-31"
}
GET Rekapitulace mezd, přehled pro zdravotní pojišťovny a oznámení za měsíc
/entities/{entity_id}/payslips/summary
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí rekapitulaci mezd za měsíc (řádek za každou pásku a součty), pojistné po zdravotních pojišťovnách jako podklad pro přehled o platbě pojistného, souhrn sociálního pojištění podle JMHZ, zálohy a srážkovou daň, nástupy a skončení s lhůtou pro hromadné oznámení zaměstnavatele a seznam výplat a srážek s účty příjemců.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok; bez parametru aktuální rok Příklad 2026. |
month | dotaz | celé číslo | ano | Měsíc Rozsah od 1 do 12. Příklad 8. |
Odpověď
200 application/json Přehledy mezd za měsíc.
| Pole | Význam |
|---|---|
year, month, due_date, closed, drafts | Období, splatnost odvodů, uzavřené mzdy a počet pásek ve stavu draft |
rows, totals | Pásky (gross, taxable, insurable, social_base, health_base, pojistné, advance, withholding, bonus, net, deductions, exempt, payout, employer_cost) a součty |
insurers | Po pojišťovnách: code, name, employees, base, employer, employee, total, names |
social, tax | Pojistné ČSSZ jako v JMHZ (base, employer, employee, discount, payable) a daň (advance, bonus, payable, withholding) |
notices | Nástupy a skončení v měsíci: name, insurer, event (start, end), date, deadline |
payments | Výplaty (kind wage) a srážky (kind deduction): name, account, amount, variable_symbol, specific_symbol, message |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 400 | – | Chybí parametr month |
| 422 | – | Neplatný měsíc |
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/payslips/summary?year=2026&month=1"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/summary?year=2026&month=1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"month": 1,
"due_date": "2026-02-20",
"closed": false,
"drafts": 0,
"rows": [
{
"payslip_id": 1,
"employee_id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"insurer": "111",
"status": "posted",
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"social_base": 52000.0,
"health_base": 52000.0,
"employee_social": 3692.0,
"employee_health": 2340.0,
"employer_social": 12896.0,
"employer_health": 4680.0,
"advance": 3963.0,
"withholding": 0.0,
"bonus": 0.0,
"net": 42005.0,
"deductions": 0.0,
"exempt": 0.0,
"payout": 42005.0,
"employer_cost": 69576.0
}
],
"totals": {
"gross": 52000.0,
"taxable": 52000.0,
"insurable": 52000.0,
"social_base": 52000.0,
"health_base": 52000.0,
"employee_social": 3692.0,
"employee_health": 2340.0,
"employer_social": 12896.0,
"employer_health": 4680.0,
"advance": 3963.0,
"withholding": 0.0,
"bonus": 0.0,
"net": 42005.0,
"deductions": 0.0,
"exempt": 0.0,
"payout": 42005.0,
"employer_cost": 69576.0
},
"insurers": [
{
"code": "111",
"name": "Všeobecná zdravotní pojišťovna ČR",
"employees": 1,
"base": 52000.0,
"employer": 4680.0,
"employee": 2340.0,
"total": 7020.0,
"names": [
"Anna Ukázková"
]
}
],
"social": {
"base": 52000.0,
"employer": 12896.0,
"employee": 3692.0,
"total": 16588.0,
"discount_persons": 0,
"discount_base": 0.0,
"discount": 0.0,
"payable": 16588.0
},
"tax": {
"advance": 3963.0,
"bonus": 0.0,
"payable": 3963.0,
"withholding": 0.0
},
"notices": [],
"payments": [
{
"kind": "wage",
"name": "Anna Ukázková",
"account": "7385178468/0800",
"amount": 42005.0,
"message": "Mzda 1/2026"
}
]
}
POST Příkaz k úhradě mezd (ABO)
/entities/{entity_id}/payslips/payment_order
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Vytvoří hromadný příkaz k úhradě ve formátu ABO (KPC, Windows-1250) z bankovního účtu firmy v CZK: částky k výplatě na účty pracovníků a srážky ze mzdy na účty plátců za měsíc, s levies true i odvody za měsíc (sociální pojištění ČSSZ, zdravotní pojištění po pojišťovnách, zálohy a srážková daň) s účty a symboly z Plateb úřadům. Pracovníky bez čísla účtu vynechá a vyjmenuje je v hlavičce X-Saldo-Skipped. Nic nezaplatí ani neoznačí jako zaplacené.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Rok; bez hodnoty aktuální rok |
month | celé číslo | ano | Měsíc pásek Rozsah od 1 do 12. |
bank_account_id | celé číslo | ano | Bankovní účet firmy v CZK, ze kterého se platí |
execution_date | datum | ne | Datum splatnosti příkazu, ne v minulosti; bez hodnoty dnes (posunuto na pracovní den) |
levies | ano/ne | ne | Přidat odvody za měsíc z Plateb úřadům Výchozí false. |
Odpověď
200 text/plain; charset=windows-1250 Soubor prikaz-mzdy-RRRR-MM.kpc k nahrání do internetového bankovnictví.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 404 | – | Bankovní účet nepatří firmě |
| 422 | – | Chybí účet, za měsíc není co vyplatit, žádná platba nemá účet, účet příjemce neprošel kontrolou, pokladna nebo datum v minulosti; v problems seznam |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Zapíše událost payroll.payment_order. Pásky, platby ani účetní zápisy nemění.
- Opakování
- Každé volání vytvoří nový soubor se stejnými platbami.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"month":1,"bank_account_id":2}' \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/payment_orderJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/payment_order', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2026,
"month": 1,
"bank_account_id": 2
})
});
const data = await response.json();UHL1280926UKAZKOVA FIRMA S.R.O2900001227001999111111222222
1 1501 001000 2010
2 2900001227 00000004200500 290926
7385178468 000004200500 0000000000 08000000 0000000000 AV:Mzda 1/2026
3 +
5 +
GET Kontrola a stav hlášení JMHZ za měsíc
/entities/{entity_id}/payslips/jmhz
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Zkontroluje data pro jednotné měsíční hlášení zaměstnavatele (JMHZ) za měsíc a vrátí jeho stav: chyby, které brání sestavení XML, upozornění, lhůtu pro podání (20. den následujícího měsíce posunutý na pracovní den, za leden až březen 2026 do 30. 6. 2026), lhůtu pro storno (do konce lhůty pro podání; za leden až březen 2026 storno nejde), souhrny daně a pojistného z pásek, druh hlášení, které by se teď vytvořilo, a historii uložených podání. Údaje pracovníků bere z pásky, ze které byla spočítaná (výměr a děti platné v měsíci). Hlášení se podává za měsíce od ledna 2026 a až po skončení měsíce.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok hlášení; bez parametru nebo při nečíselné hodnotě aktuální rok, mimo rozsah se zarovná na 2000 až 2100. Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ano | Měsíc hlášení Rozsah od 1 do 12. Příklad 8. |
Odpověď
200 application/json Stav a kontrola hlášení JMHZ.
| Pole | Význam |
|---|---|
year, month, period | Období; period ve tvaru RRRR-MM |
state | none (nic uloženo), draft (připraveno), filed (řádné označeno jako podané), cancelled (stornováno) |
kind | Druh, který by se teď vytvořil: regular, nebo corrective po podaném řádném hlášení |
ready | true, když kontrola nenašla chyby |
errors, warnings | Nálezy kontroly: level, code, subject, field, message, employee_id |
due_date, cancellation_deadline, can_cancel | Lhůta podání, poslední den pro storno (null, když storno nejde) a zda lze ještě stornovat |
payroll_closed | true, když jsou mzdy za měsíc uzavřené |
totals | Souhrny: tax, insurance, payslips a employer_rounding; null pro rok bez sazeb |
employments, persons | Počet pracovněprávních vztahů a osob v hlášení |
submission_id, proof_state | GUID řádného podání a stav doložení posledního podaného hlášení |
plan | Jen pro opravné hlášení: corrected, added, cancelled, stale (vztahy podle názvu) |
filings | Uložená podání JMHZ měsíce od nejnovějšího: id, filing_type (B, O, S), status, proof_state, filed_on, submission_id, forms (počet formulářů), filled_at |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Chybí nebo je neplatný měsíc – „Měsíc hlášení musí být číslo 1 až 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
Ukázková firma má pro leden vyplněné údaje pro JMHZ, kontrola proto nenašla chyby (ready true) a vrací jen upozornění na uplynulou lhůtu a chybějící OIČ.
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz?year=2026&month=1"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz?year=2026&month=1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"month": 1,
"period": "2026-01",
"state": "none",
"kind": "regular",
"proof_state": null,
"payroll_closed": false,
"due_date": "2026-06-30",
"cancellation_deadline": null,
"can_cancel": false,
"ready": true,
"errors": [],
"warnings": [
{
"level": "warning",
"code": "late",
"subject": "Zaměstnavatel",
"field": null,
"message": "Lhůta pro hlášení za 1/2026 uplynula 30. 6. 2026; podejte je bez odkladu.",
"employee_id": null
},
{
"level": "warning",
"code": "unidentified",
"subject": "Anna Ukázková (HPP)",
"field": "oic",
"message": "Chybí OIČ a ID pracovněprávního vztahu z registrace zaměstnance – formulář se podá se jménem, datem narození, datem nástupu a druhem činnosti a ČSSZ jej ztotožní; po přidělení je doplňte.",
"employee_id": 1
}
],
"totals": {
"tax": {
"advance": 3963.0,
"bonus": 0.0,
"withholding": 0.0,
"withholding_base": 0.0
},
"insurance": {
"base": 52000.0,
"employer": 12896.0,
"employee": 3692.0,
"total": 16588.0,
"discount_persons": 0,
"discount_base": 0.0,
"discount": 0.0,
"payable": 16588.0
},
"payslips": {
"gross": 52000.0,
"employer_social": 12896.0,
"employee_social": 3692.0,
"employer_health": 4680.0,
"employee_health": 2340.0,
"net": 42005.0
},
"employer_rounding": 0.0
},
"employments": 1,
"persons": 1,
"submission_id": null,
"plan": null,
"filings": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Stažení XML hlášení JMHZ a jeho uložení jako podání
/entities/{entity_id}/payslips/jmhz/xml
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Přestože jde o GET, požadavek zakládá podání, a proto ho odmítne i API klíč jen pro čtení (403 READ_ONLY_KEY) a požadavek z cizího webu podle hlavičky Sec-Fetch-Site (403 CROSS_SITE). Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví XML jednotného měsíčního hlášení zaměstnavatele podle schématu ČSSZ jmhzPodani 1.4.3, uloží je jako podání JMHZ ve stavu draft a vrátí jako soubor. Řádné hlášení (regular) jde vytvořit, dokud řádné hlášení měsíce není označené jako podané, a znovu po podaném stornu; opravné (corrective) a storno (cancellation) navazují na podané řádné hlášení a přebírají jeho GUID. Opravné hlášení opraví známé formuláře, přidá nové a formuláře vztahů, které z hlášení zmizely, do lhůty pro storno stornuje. Storno ruší celé hlášení a lze je jen do 20. dne následujícího měsíce. ČSSZ nic neodesílá – podání se označí jako podané až přes PATCH /entities/{entity_id}/filings/{id} se status filed.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok hlášení; bez parametru nebo při nečíselné hodnotě aktuální rok, mimo rozsah se zarovná na 2000 až 2100. Rozsah od 2000 do 2100. Příklad 2026. |
month | dotaz | celé číslo | ano | Měsíc hlášení Rozsah od 1 do 12. Příklad 8. |
kind | dotaz | text | ne | Druh hlášení – řádné, opravné nebo storno Hodnoty: regular, corrective, cancellation. Výchozí regular. Příklad regular. |
Odpověď
200 application/xml XML hlášení jako příloha jmhz-RRRR-MM-radne.xml, jmhz-RRRR-MM-opravne.xml nebo jmhz-RRRR-MM-storno.xml.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Kontrola JMHZ našla chyby (neukončený měsíc, období před lednem 2026, chybějící údaje, storno po lhůtě) – error „Hlášení nelze sestavit – nejprve opravte chyby z kontroly JMHZ.“ a pole issues s nálezy kontroly |
| 422 | – | Chybí nebo je neplatný měsíc – „Měsíc hlášení musí být číslo 1 až 12.“ |
| 422 | – | Neznámý druh – „Druh hlášení musí být regular, corrective nebo cancellation.“ |
| 422 | – | XML neprošlo oficiálním XSD jmhzPodani 1.4.3.6 (config/ucetnictvi/jmhz) – „XML neodpovídá oficiální struktuře JMHZ 1.4.3.6, ČSSZ by ho odmítla: …“ s prvními třemi chybami; nic se neuloží |
| 422 | – | Řádné hlášení je už podané – „Řádné hlášení za M/RRRR je podané – změny podejte opravným hlášením…“ |
| 422 | – | Opravné hlášení nebo storno bez řádného hlášení – „Za M/RRRR zatím není řádné hlášení – … navazuje na podané řádné hlášení.“ |
| 422 | – | Řádné hlášení není označené jako podané – „Řádné hlášení za M/RRRR není označené jako podané – …“ |
| 422 | – | Hlášení je stornované a chce se opravné nebo storno – „Hlášení za M/RRRR je stornované – podejte nové řádné hlášení.“ |
| 403 | READ_ONLY_KEY | API klíč jen pro čtení |
| 403 | CROSS_SITE | Hlavička Sec-Fetch-Site je jiná než same-origin nebo none |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří nebo přepíše podání JMHZ (kind jmhz, period RRRR-MM, filing_type B řádné, O opravné, S storno, stav draft) s XML, GUID podání, seznamem formulářů a časem vyplnění; zapíše událost payroll.jmhz. ČSSZ nic neodesílá ani nepodává, účetnictví nemění.
- Limity
- Jeden soubor pojme nejvýše 1 500 formulářů pracovněprávních vztahů; větší hlášení tento endpoint nesestaví a skončí chybou 500.
- Opakování
- Dokud je podání daného druhu ve stavu draft, opakované stažení přepíše totéž podání novým XML a časem vyplnění a zachová GUID podání. GUID formulářů zůstanou u řádného hlášení, u formulářů známých z podaných hlášení i u vztahů nově přidaných v rozpracovaném opravném hlášení. Nové podání vznikne, jen když rozpracované podání daného druhu neexistuje (například další opravné hlášení po podaném opravném nebo nové řádné po podaném stornu).
Příklad
Ukázková firma má pro leden vyplněné údaje pro JMHZ, příklad proto vrací XML řádného hlášení a uloží je jako podání ve stavu draft.
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz/xml?year=2026&month=1&kind=regular"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz/xml?year=2026&month=1&kind=regular', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();<?xml version="1.0" encoding="UTF-8"?>
<n1:jmhz xmlns:n1="http://schemas.cssz.cz/JMHZ/podani/1.0" xmlns:so="http://schemas.cssz.cz/JMHZ/souhrn/1.0" xmlns:pvpoj="http://schemas.cssz.cz/JMHZ/PVPOJ/1.0" xmlns:form="http://schemas.cssz.cz/JMHZ/form/1.0">
<n1:VENDOR productName="Saldo" productVersion="1.0"/>
<n1:hlavicka>
<n1:idPodani>01a136e3-86af-7bab-8b8c-08374ede90b2</n1:idPodani>
<n1:typPodani>R</n1:typPodani>
<n1:variabilniSymbol>1234567890</n1:variabilniSymbol>
<n1:mesic>1</n1:mesic>
<n1:rok>2026</n1:rok>
<n1:datumVyplneni>2026-09-28T10:00:00Z</n1:datumVyplneni>
<n1:balikPoradi>1</n1:balikPoradi>
<n1:balikyPocet>1</n1:balikyPocet>
<n1:formularePocetVBaliku>3</n1:formularePocetVBaliku>
<n1:formularePocetCelkem>3</n1:formularePocetCelkem>
</n1:hlavicka>
<so:souhrn>
<so:danUdajeMesic>
<so:danZalohaPoSleve>3963</so:danZalohaPoSleve>
<so:danBonus>0</so:danBonus>
</so:danUdajeMesic>
</so:souhrn>
<pvpoj:PVPOJ>
<pvpoj:pojistne>
<pvpoj:zakladZamestnavateleA>52000</pvpoj:zakladZamestnavateleA>
<pvpoj:pojistneZamestnavateleA>12896</pvpoj:pojistneZamestnavateleA>
<pvpoj:zakladZamestnavateleB>0</pvpoj:zakladZamestnavateleB>
<pvpoj:pojistneZamestnavateleB>0</pvpoj:pojistneZamestnavateleB>
<pvpoj:zakladZamestnavateleC>0</pvpoj:zakladZamestnavateleC>
<pvpoj:pojistneZamestnavateleC>0</pvpoj:pojistneZamestnavateleC>
<pvpoj:pojistneZamestnavateleCelkem>12896</pvpoj:pojistneZamestnavateleCelkem>
<pvpoj:pojistneZamestnance>3692</pvpoj:pojistneZamestnance>
<pvpoj:pojistneCelkem>16588</pvpoj:pojistneCelkem>
</pvpoj:pojistne>
<pvpoj:pojistneUhrada>16588</pvpoj:pojistneUhrada>
</pvpoj:PVPOJ>
<n1:formulareOsob>
<n1:formularOsoby>
<n1:hlavicka>
<n1:idFormulare>01a136e3-86ae-784e-b2f9-2e5862fcad8e</n1:idFormulare>
<n1:typFormulare>R</n1:typFormulare>
<n1:primarniPpv>true</n1:primarniPpv>
</n1:hlavicka>
<form:bezPriznaku>
<form:identifikace>
<form:prijmeni>Ukázková</form:prijmeni>
<form:jmeno>Anna</form:jmeno>
<form:datumNarozeni>1990-04-12</form:datumNarozeni>
<form:datumNastupu>2025-04-01</form:datumNastupu>
<form:druhCinnosti>1</form:druhCinnosti>
</form:identifikace>
<form:souhrnDataZec>
<form:prijmy>
<form:zuctovanoCelkem>52000</form:zuctovanoCelkem>
</form:prijmy>
<form:zalohaNaDan>
<form:zakladDane>52000</form:zakladDane>
<form:vypoctenaZaloha>7800</form:vypoctenaZaloha>
<form:danZalohaPoSleve>3963</form:danZalohaPoSleve>
<form:danBonus>0</form:danBonus>
</form:zalohaNaDan>
<form:prohlaseniPoplatnika>true</form:prohlaseniPoplatnika>
<form:prohlaseniPoplatnikaDane>
<form:zakladniSleva>2570</form:zakladniSleva>
<form:danoveZvyhodneniDetiMesic>1267</form:danoveZvyhodneni
…
POST Předběžná kontrola hlášení JMHZ validační službou ČSSZ
/entities/{entity_id}/payslips/jmhz/validation
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Sestaví XML hlášení JMHZ stejně jako stažení, ale neuloží je, a odešle je anonymní validační službě ČSSZ ePodaniValidace. Vrátí, zda služba hlášení přijala bez chyb, a její nálezy s přiřazeným pracovníkem. Nic nepodává. Parametry year, month a kind se posílají v těle JSON.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
year | celé číslo | ne | Rok hlášení; bez hodnoty aktuální rok, mimo rozsah se zarovná Rozsah od 2000 do 2100. |
month | celé číslo | ano | Měsíc hlášení Rozsah od 1 do 12. |
kind | text | ne | Druh hlášení; bez hodnoty regular, nebo corrective, je-li řádné hlášení podané Hodnoty: regular, corrective, cancellation. |
Odpověď
200 application/json Výsledek kontroly ČSSZ.
| Pole | Význam |
|---|---|
ok | true, když služba vrátila výsledek OK |
request_id | ID požadavku u ČSSZ |
errors | Nálezy služby: category, code (číslo chyby ČSSZ), message, form (GUID formuláře), employee (pracovník a vztah) |
kind | Kontrolovaný druh hlášení |
checked_at | Čas kontroly |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 502 | – | Validační služba ČSSZ je nedostupná, neodpověděla včas, vrátila chybu nebo odpověď bez výsledku (česká zpráva v error) |
| 422 | – | Kontrola JMHZ našla chyby – error „Hlášení nelze sestavit – nejprve opravte chyby z kontroly JMHZ.“ a pole issues |
| 422 | – | Chybí nebo je neplatný měsíc – „Měsíc hlášení musí být číslo 1 až 12.“ |
| 422 | – | Neznámý druh – „Druh hlášení musí být regular, corrective nebo cancellation.“ |
| 422 | – | Druh neodpovídá stavu podání (řádné už podané, opravné nebo storno bez podaného řádného, stornované hlášení) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Odešle XML hlášení včetně osobních údajů zaměstnanců na produkční validační službu ČSSZ (https://epodani.cssz.cz/ePodaniValidace.svc), která je jen zkontroluje. Nic nepodá ani neuloží jako podání; zapíše událost payroll.jmhz_validation do historie.
- Limity
- Časové limity spojení se službou ČSSZ – navázání 10 s, odeslání 20 s, čekání na odpověď 45 s. Hlášení nad 1 500 formulářů se nesestaví (chyba 500).
- Opakování
- Každé volání znovu odešle XML ke kontrole a zapíše novou událost.
Příklad
Ukázková firma má pro leden vyplněné údaje pro JMHZ. Volání služby ČSSZ se při záznamu příkladu nahrazuje smyšlenou odpovědí ve formátu služby (výsledek OK).
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"month":1}' \
https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz/validationJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/payslips/jmhz/validation', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"year": 2026,
"month": 1
})
});
const data = await response.json();{
"ok": true,
"request_id": "6649AE42-D62E-4614-B287-099B191081C2",
"errors": [],
"kind": "regular",
"checked_at": "2026-09-28T10:00:00.000Z"
}
Odpověď externí služby (ČSSZ, hlášení JMHZ) je v ukázce nahrazená smyšlenými údaji ve formátu, který služba vrací.
GET Roční zúčtování záloh – přehled zaměstnanců za rok
/entities/{entity_id}/annual_settlements
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí lidi, kterým firma v roce vyplatila mzdu (více smluv téže osoby podle rodného čísla jako jeden řádek), se stavem ročního zúčtování záloh a daňového zvýhodnění podle § 38ch ZDP: missing (chybí žádost), no_declaration (v roce nepodepsal prohlášení – zúčtování jen po dodatečném podpisu podle § 38k odst. 7 ZDP), blocked (nelze provést), requested (podal žádost), computed (spočteno), done (spočteno, nic se nevrací), scheduled (vrátí se ve mzdě), returned (vráceno ve mzdě), outside (vráceno mimo mzdu). Přidá lhůty roku (žádost do 15. 2., výpočet do 31. 3., vrácení nejpozději ve mzdě za březen), počty podle stavu a součet částek k vrácení.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Zdaňovací období, za které se zúčtovává; bez parametru aktuální rok. Saldo počítá od roku 2025. Rozsah od 2025 do 2100. Příklad 2025. |
Odpověď
200 application/json Přehled za rok.
| Pole | Význam |
|---|---|
year | Zdaňovací období |
deadlines | request (žádost a doklady), settlement (výpočet), refund_month a refund_year (nejpozdější mzda pro vrácení) |
rows | employee_id (karta, u které jsou podklady), name, contract, ended_on, status, status_label, blockers (počet důvodů, proč nelze), payout, refund_month |
counts | Počet lidí v každém stavu |
refunds | Součet částek naplánovaných nebo vrácených zaměstnancům |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 422 | – | Rok před 2025 nebo bez sazeb („Roční zúčtování za rok … Saldo nepočí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.
Příklad
Ukázková firma má výplatní pásky jen za rok 2026, proto ukázky ročního zúčtování pracují s tímto rokem.
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"deadlines": {
"request": "2027-02-15",
"settlement": "2027-03-31",
"refund_month": 3,
"refund_year": 2027
},
"rows": [
{
"employee_id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"ended_on": null,
"status": "missing",
"status_label": "Chybí žádost",
"blockers": 0,
"payout": 0.0,
"refund_month": null
},
{
"employee_id": 2,
"name": "Petr Vzorový",
"contract": "dpp",
"ended_on": null,
"status": "no_declaration",
"status_label": "Bez prohlášení",
"blockers": 0,
"payout": 0.0,
"refund_month": null
}
],
"counts": {
"missing": 1,
"no_declaration": 1,
"blocked": 0,
"requested": 0,
"computed": 0,
"done": 0,
"scheduled": 0,
"returned": 0,
"outside": 0
},
"refunds": 0
}
GET Roční zúčtování jednoho zaměstnance – podklady, výsledek, potvrzení
/entities/{entity_id}/annual_settlements/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Stačí
Vrátí uložené podklady (bez nich předvyplněné z karty: invalidita, ZTP/P a děti s měsíci nároku), součty z výplatních pásek roku (příjem a zálohy zdaněné zálohou, bonusy, měsíce, příjmy zdaněné srážkovou daní, koncepty), průběžný výsledek v řádcích tiskopisu MFin 5460/1 Výpočet daně a daňového zvýhodnění (vzor č. 29), důvody, proč zúčtování provést nelze (§ 38ch odst. 1 a 3, § 38g odst. 2 ZDP), upozornění, uložený výpočet s datem, vrácení a data pro Potvrzení o zdanitelných příjmech ze závislé činnosti (§ 38j odst. 3 ZDP, MFin 5460 vzor č. 33).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka (kterékoli jeho karty; podklady jsou u jedné karty osoby) Příklad 3. |
year | dotaz | celé číslo | ne | Zdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025. |
Odpověď
200 application/json Roční zúčtování zaměstnance.
| Pole | Význam |
|---|---|
status, status_label, saved | Stav jako v přehledu; saved = podklady jsou uložené |
inputs | Podklady ve tvaru těla PATCH |
own | Z pásek firmy: income, advances, bonuses, months, withholding_income, withholding_tax, drafts |
result | Průběžný výpočet: rows (klíče '1' až '32b' podle tiskopisu, null = řádek se nevyplňuje), deductions, credits, children, tax, payout, payout_tax, payout_bonus, total, bonus_allowed, warnings |
blockers, warnings | Důvody, proč nelze (code, message), a upozornění |
computed, changed | Uložený výpočet (on, by, result) a zda se od něj pásky nebo podklady změnily |
refund | month nebo outside_on, payslip_id, payslip_status, applied |
deadlines, refund_months, abolished | Lhůty, měsíce pro vrácení a zrušené odpočty (odbory, zkoušky) |
certificate | Data potvrzení o příjmech: declaration_months, months, income, advances, bonuses, children (orders po pořadí, ztpp), disability, settlement |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 404 | – | Pracovník nepatří firmě |
| 422 | – | Rok před 2025 |
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/annual_settlements/1?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"year": 2026,
"employee": {
"id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"birth_number": null,
"started_on": "2025-04-01",
"ended_on": null
},
"status": "missing",
"status_label": "Chybí žádost",
"saved": false,
"inputs": {
"requested_on": null,
"declaration_signed": false,
"late_declaration": false,
"files_return": false,
"other_income": 0,
"execution_credit": 0,
"disability": "",
"disability_months": 0,
"ztpp_months": 0,
"spouse": null,
"children": [
{
"name": "Eliška Ukázková",
"birth_number": "1855120003",
"order": 1,
"months": 12,
"ztpp_months": 0
}
],
"deductions": {},
"employers": [],
"note": null
},
"own": {
"income": 468000.0,
"advances": 35667.0,
"bonuses": 0.0,
"months": [
1,
2
],
"withholding_income": 0.0,
"withholding_tax": 0.0,
"drafts": 1
},
"result": {
"year": 2026,
"income": 468000.0,
"own_income": 468000.0,
"other_income": 0.0,
"deductions": [],
"deductions_total": 0.0,
"reduced_base": 468000.0,
"tax": 70200.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "15",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"credits_total": 30840.0,
"tax_after_credits": 39360.0,
"advances": 35667.0,
"children": [
{
"order": 1,
"months": 12,
"ztpp": false,
"amount": 15204.0,
"name": "Eliška Ukázková",
"birth_number": "1855120003"
}
],
"child_entitlement": 15204.0,
"child_credit": 15204.0,
"bonus": 0.0,
"bonus_allowed": true,
"tax_after_child_credit": 24156.0,
"tax_difference": 11511.0,
"bonuses_paid": 0.0,
"bonus_difference": 0.0,
"total": 11511.0,
"payout": 11511.0,
"payout_tax": 11511.0,
"payout_bonus": 0.0,
"paid": true,
"rows": {
"1": 468000.0,
"2": 0.0,
"3": 0.0,
"5": 0.0,
"6": 0.0,
"7": 0.0,
"8": 0.0,
"9": 0.0,
"10": 0.0,
"11": 0.0,
"12": 468000.0,
"13": 70200.0,
"14": 0.0,
"15": 30840.0,
"16": 0.0,
"17": 0.0,
"18": 0.0,
"19": 0.0,
"20": 30840.0,
"21": 39360.0,
"22": 35667.0,
"23": null,
"24": 15204.0,
"25": 15204.0,
"26": 0.0,
"27": 24156.0,
"28": 11511.0,
"29": 0.0,
"30": 0.0,
"31": 11511.0,
"32a": 11511.0,
"32b": 0.0
},
"warnings": []
},
"blockers": [
{
"code": "no_request",
"message": "Chybí žádost o roční zúčtování. Zaměstnanec ji podává do 15. 2. 2027 (§ 38ch odst. 1 ZDP)."
},
{
"code": "no_declaration",
"message": "Zaměstnanec nepodepsal prohlášení poplatníka k dani za rok 2026 (§ 38k odst. 4 a 5 ZDP). Podepsat ho může dodatečně, nejpozději do 15. 2. 2027 (§ 38k odst. 7 ZDP)."
}
],
"warnings": [
"1 páska roku je zatím koncept – výsledek se může změnit."
],
"computed": null,
"changed": false,
"refund": null,
"deadlines": {
"request": "2027-02-15",
"settlement": "2027-03-31",
"refund_month": 3,
"refund_year": 2027
},
"refund_months": [
1,
2
],
"certificate": {
"year": 2026,
"declaration_months": "1–9",
"declaration_year": true,
"income": 468000.0,
"months": "1–9",
"advances": 35667.0,
"bonuses": 0.0,
"children": [
{
"name": "",
"birth_number": null,
"orders": {
"1": "1–8"
},
"ztpp": ""
},
{
"name": "Eliška Ukázková",
"birth_number": "1855120003",
"orders": {
"1": "9"
},
"ztpp": ""
}
],
"disability": [],
"settlement": null
},
"abolished": [
"Odpočet členských příspěvků odborové organizaci byl od roku 2024 zrušen (zákon č. 349/2023 Sb.).",
"Odpočet úhrad za zkoušky ověřující výsledky dalšího vzdělávání byl od roku 2024 zrušen (zákon č. 349/2023 Sb.)."
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Uložení žádosti a podkladů ročního zúčtování
/entities/{entity_id}/annual_settlements/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. Zapisuje role se zápisem. API klíč má přístup svého uživatele. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Uloží žádost, prohlášení a podklady zaměstnance za rok (celé nahradí) a vrátí stejný tvar jako GET. Uložení zruší uložený výpočet a naplánované vrácení; nezaúčtovanou pásku, ve které vrácení bylo, přepočítá bez něj. Částky nesmějí být záporné, měsíce jsou 0 až 12 (u ZTP/P nejvýš počet měsíců slevy), rodná čísla se kontrolují, nejvýš 10 dětí a 10 dalších plátců.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
year | dotaz | celé číslo | ne | Zdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
settlement | objekt | ne | Podklady |
settlement. | datum | ne | Den žádosti (lhůta 15. 2., § 38ch odst. 1) |
settlement. | ano/ne | ne | Prohlášení k dani za rok podepsané (§ 38k odst. 4 a 5) |
settlement. | ano/ne | ne | Prohlášení podepsané dodatečně – zahrnout i příjmy zdaněné srážkovou daní (§ 38k odst. 7) |
settlement. | ano/ne | ne | Podá nebo je povinen podat daňové přiznání |
settlement. | číslo | ne | Jiné příjmy podle § 7 až 10 (nad 20 000 Kč nelze) |
settlement. | číslo | ne | Sleva za zastavenou exekuci (§ 35 odst. 4) |
settlement. | text | ne | Invalidita I./II. nebo III. stupně Hodnoty: "", first, third. |
settlement. | celé číslo | ne | Měsíce slevy na invaliditu |
settlement. | celé číslo | ne | Měsíce slevy na držitele ZTP/P |
settlement. | objekt | ne | Sleva na manžela: name, birth_number, income (vlastní příjem za rok), months, ztpp_months, child_under_three |
settlement. | pole | ne | Děti: name, birth_number, order (1–3), months, ztpp_months |
settlement. | objekt | ne | Nezdanitelné části: gifts, mortgage_interest, mortgage_months, mortgage_before_2021, pension_supplementary, pension_supplementary_months, pension_savings, pension_savings_months, pension_institution, life_insurance, dip, long_term_care (zaplacené částky) |
settlement. | pole | ne | Jiní plátci podle potvrzení: name, ico, from, to (měsíce), income (ř. 2), advances (ř. 6), bonuses (ř. 9), declaration, certificate, concurrent |
settlement. | text | ne | Poznámka (nejvýš 500 znaků) |
Odpověď
200 application/json Roční zúčtování zaměstnance (tvar jako GET).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám; odpověď neobsahuje žádná data |
| 403 | – | Role bez zápisu |
| 404 | – | Pracovník nepatří firmě |
| 422 | – | Neplatné datum, záporná částka, měsíce mimo 0 až 12, neplatné rodné číslo nebo IČO, víc než 10 řádků, nebo je vrácení už v zaúčtované pásce |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží podklady ke kartě, zruší uložený výpočet a vrácení (přepočte nezaúčtovanou pásku) a zapíše událost payroll.settlement_saved.
- Opakování
- Opakování se stejnými podklady vede ke stejnému stavu; každé volání zapíše událost.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"settlement":{"requested_on":"2027-02-08","declaration_signed":true,"deductions":{"gifts":6000}}}' \
"https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"settlement": {
"requested_on": "2027-02-08",
"declaration_signed": true,
"deductions": {
"gifts": 6000
}
}
})
});
const data = await response.json();{
"year": 2026,
"employee": {
"id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"birth_number": null,
"started_on": "2025-04-01",
"ended_on": null
},
"status": "requested",
"status_label": "Podal žádost",
"saved": true,
"inputs": {
"declaration_signed": true,
"late_declaration": false,
"files_return": false,
"requested_on": "2027-02-08",
"other_income": 0,
"execution_credit": 0,
"disability": "",
"disability_months": 0,
"ztpp_months": 0,
"spouse": null,
"children": [],
"deductions": {
"gifts": 6000.0,
"mortgage_interest": 0,
"pension_supplementary": 0,
"pension_savings": 0,
"pension_institution": 0,
"life_insurance": 0,
"dip": 0,
"long_term_care": 0,
"mortgage_months": 12,
"pension_supplementary_months": 12,
"pension_savings_months": 12,
"mortgage_before_2021": false
},
"employers": [],
"note": null,
"updated_at": "2026-09-28T10:00:00Z"
},
"own": {
"income": 468000.0,
"advances": 35667.0,
"bonuses": 0.0,
"months": [
1,
2
],
"withholding_income": 0.0,
"withholding_tax": 0.0,
"drafts": 1
},
"result": {
"year": 2026,
"income": 468000.0,
"own_income": 468000.0,
"other_income": 0.0,
"deductions": [
{
"key": "gifts",
"label": "Bezúplatná plnění (dary)",
"row": "2",
"claimed": 6000.0,
"allowed": 6000.0,
"basis": "§ 15 odst. 1 ZDP; strop 30 % základu daně za zdaňovací období 2022 až 2026 podle § 1 odst. 1 zákona č. 128/2022 Sb., ve znění zákona č. 24/2025 Sb.",
"note": null
}
],
"deductions_total": 6000.0,
"reduced_base": 462000.0,
"tax": 69300.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "15",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"credits_total": 30840.0,
"tax_after_credits": 38460.0,
"advances": 35667.0,
"children": [],
"child_entitlement": 0.0,
"child_credit": 0.0,
"bonus": 0.0,
"bonus_allowed": true,
"tax_after_child_credit": 38460.0,
"tax_difference": -2793.0,
"bonuses_paid": 0.0,
"bonus_difference": 0.0,
"total": -2793.0,
"payout": 0.0,
"payout_tax": 0.0,
"payout_bonus": 0.0,
"paid": false,
"rows": {
"1": 468000.0,
"2": 6000.0,
"3": 0.0,
"5": 0.0,
"6": 0.0,
"7": 0.0,
"8": 0.0,
"9": 0.0,
"10": 0.0,
"11": 6000.0,
"12": 462000.0,
"13": 69300.0,
"14": 0.0,
"15": 30840.0,
"16": 0.0,
"17": 0.0,
"18": 0.0,
"19": 0.0,
"20": 30840.0,
"21": 38460.0,
"22": 35667.0,
"23": -2793.0,
"24": null,
"25": null,
"26": null,
"27": null,
"28": null,
"29": null,
"30": null,
"31": null,
"32a": null,
"32b": null
},
"warnings": [
"Nedoplatek 2 793 Kč se zaměstnanci nesráží (§ 38ch odst. 5 a § 35d odst. 8 ZDP)."
]
},
"blockers": [],
"warnings": [
"1 páska roku je zatím koncept – výsledek se může změnit.",
"Nedoplatek 2 793 Kč se zaměstnanci nesráží (§ 38ch odst. 5 a § 35d odst. 8 ZDP)."
],
"computed": null,
"changed": false,
"refund": null,
"deadlines": {
"request": "2027-02-15",
"settlement": "2027-03-31",
"refund_month": 3,
"refund_year": 2027
},
"refund_months": [
1,
2
],
"certificate": {
"year": 2026,
"declaration_months": "1–9",
"declaration_year": true,
"income": 468000.0,
"months": "1–9",
"advances": 35667.0,
"bonuses": 0.0,
"children": [
{
"name": "",
"birth_number": null,
"orders": {
"1": "1–8"
},
"ztpp": ""
},
{
"name": "Eliška Ukázková",
"birth_number": "1855120003",
"orders": {
"1": "9"
},
"ztpp": ""
}
],
"disability": [],
"settlement": null
},
"abolished": [
"Odpočet členských příspěvků odborové organizaci byl od roku 2024 zrušen (zákon č. 349/2023 Sb.).",
"Odpočet úhrad za zkoušky ověřující výsledky dalšího vzdělávání byl od roku 2024 zrušen (zákon č. 349/2023 Sb.)."
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Smazání podkladů ročního zúčtování
/entities/{entity_id}/annual_settlements/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. Zapisuje role se zápisem. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže podklady, výpočet i vrácení zaměstnance za rok; nezaúčtovanou pásku s vrácením přepočte bez něj. Vrácení v zaúčtované pásce smazání odmítne.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
year | dotaz | celé číslo | ne | Zdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025. |
Odpověď
204 Smazáno (i když nic uloženo nebylo).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám |
| 404 | – | Pracovník nepatří firmě |
| 422 | – | Vrácení je v zaúčtované pásce |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže podklady roku a zapíše událost payroll.settlement_deleted.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Výpočet ročního zúčtování
/entities/{entity_id}/annual_settlements/{id}/compute
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. Zapisuje role se zápisem. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Spočítá roční zúčtování z uložených podkladů a výplatních pásek roku a uloží výsledek s datem a autorem (pro tiskopis Výpočet daně a daňového zvýhodnění). Postup podle § 38ch odst. 4 a § 35d odst. 6 a 7 ZDP: úhrn příjmů od všech plátců, nezdanitelné části s limity roku, základ zaokrouhlený na sta Kč dolů, daň 15 % a 23 % nad 36násobek průměrné mzdy, slevy (základní za celý rok, ostatní po měsících), zvýhodnění na děti jako sleva a bonus (bonus jen při příjmu aspoň šestinásobku minimální mzdy a alespoň 100 Kč), porovnání se sraženými zálohami a vyplacenými bonusy; vrací se jen úhrn vyšší než 50 Kč, nedoplatek se nesráží. Ruší naplánované vrácení.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
year | dotaz | celé číslo | ne | Zdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025. |
Odpověď
200 application/json Roční zúčtování zaměstnance s computed (tvar jako GET).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám |
| 404 | – | Pracovník nepatří firmě |
| 422 | – | Podklady nejsou uložené, nebo zúčtování nelze provést – odpověď vyjmenuje důvody (pozdní žádost, chybí prohlášení, přiznání, jiné příjmy nad 20 000 Kč, souběh, chybí potvrzení, nebyl posledním plátcem), nebo je vrácení v zaúčtované pásce |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží výsledek a zapíše událost payroll.settlement_computed; účetní zápisy nemění.
- Opakování
- Opakování přepíše výsledek novým výpočtem a zruší naplánované vrácení.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1/compute?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/annual_settlements/1/compute?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"year": 2026,
"employee": {
"id": 1,
"name": "Anna Ukázková",
"contract": "hpp",
"birth_number": null,
"started_on": "2025-04-01",
"ended_on": null
},
"status": "done",
"status_label": "Spočteno, nic se nevrací",
"saved": true,
"inputs": {
"declaration_signed": true,
"late_declaration": false,
"files_return": false,
"requested_on": "2027-02-08",
"other_income": 0,
"execution_credit": 0,
"disability": "",
"disability_months": 0,
"ztpp_months": 0,
"spouse": null,
"children": [],
"deductions": {
"gifts": 6000.0,
"mortgage_interest": 0,
"pension_supplementary": 0,
"pension_savings": 0,
"pension_institution": 0,
"life_insurance": 0,
"dip": 0,
"long_term_care": 0,
"mortgage_months": 12,
"pension_supplementary_months": 12,
"pension_savings_months": 12,
"mortgage_before_2021": false
},
"employers": [],
"note": null,
"updated_at": "2026-09-28T10:00:00Z"
},
"own": {
"income": 468000.0,
"advances": 35667.0,
"bonuses": 0.0,
"months": [
1,
2
],
"withholding_income": 0.0,
"withholding_tax": 0.0,
"drafts": 1
},
"result": {
"year": 2026,
"income": 468000.0,
"own_income": 468000.0,
"other_income": 0.0,
"deductions": [
{
"key": "gifts",
"label": "Bezúplatná plnění (dary)",
"row": "2",
"claimed": 6000.0,
"allowed": 6000.0,
"basis": "§ 15 odst. 1 ZDP; strop 30 % základu daně za zdaňovací období 2022 až 2026 podle § 1 odst. 1 zákona č. 128/2022 Sb., ve znění zákona č. 24/2025 Sb.",
"note": null
}
],
"deductions_total": 6000.0,
"reduced_base": 462000.0,
"tax": 69300.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "15",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"credits_total": 30840.0,
"tax_after_credits": 38460.0,
"advances": 35667.0,
"children": [],
"child_entitlement": 0.0,
"child_credit": 0.0,
"bonus": 0.0,
"bonus_allowed": true,
"tax_after_child_credit": 38460.0,
"tax_difference": -2793.0,
"bonuses_paid": 0.0,
"bonus_difference": 0.0,
"total": -2793.0,
"payout": 0.0,
"payout_tax": 0.0,
"payout_bonus": 0.0,
"paid": false,
"rows": {
"1": 468000.0,
"2": 6000.0,
"3": 0.0,
"5": 0.0,
"6": 0.0,
"7": 0.0,
"8": 0.0,
"9": 0.0,
"10": 0.0,
"11": 6000.0,
"12": 462000.0,
"13": 69300.0,
"14": 0.0,
"15": 30840.0,
"16": 0.0,
"17": 0.0,
"18": 0.0,
"19": 0.0,
"20": 30840.0,
"21": 38460.0,
"22": 35667.0,
"23": -2793.0,
"24": null,
"25": null,
"26": null,
"27": null,
"28": null,
"29": null,
"30": null,
"31": null,
"32a": null,
"32b": null
},
"warnings": [
"Nedoplatek 2 793 Kč se zaměstnanci nesráží (§ 38ch odst. 5 a § 35d odst. 8 ZDP)."
]
},
"blockers": [],
"warnings": [
"1 páska roku je zatím koncept – výsledek se může změnit.",
"Nedoplatek 2 793 Kč se zaměstnanci nesráží (§ 38ch odst. 5 a § 35d odst. 8 ZDP)."
],
"computed": {
"on": "2026-09-28",
"by": "ukazka",
"result": {
"year": 2026,
"income": 468000.0,
"own_income": 468000.0,
"other_income": 0.0,
"deductions": [
{
"key": "gifts",
"label": "Bezúplatná plnění (dary)",
"row": "2",
"claimed": 6000.0,
"allowed": 6000.0,
"basis": "§ 15 odst. 1 ZDP; strop 30 % základu daně za zdaňovací období 2022 až 2026 podle § 1 odst. 1 zákona č. 128/2022 Sb., ve znění zákona č. 24/2025 Sb.",
"note": null
}
],
"deductions_total": 6000.0,
"reduced_base": 462000.0,
"tax": 69300.0,
"credits": [
{
"key": "taxpayer",
"label": "Základní sleva na poplatníka",
"row": "15",
"months": 12,
"amount": 30840.0,
"basis": "§ 35ba odst. 1 písm. a) ZDP"
}
],
"credits_total": 30840.0,
"tax_after_credits": 38460.0,
"advances": 35667.0,
"children": [],
"child_entitlement": 0.0,
"child_credit": 0.0,
"bonus": 0.0,
"bonus_allowed": true,
"tax_after_child_credit": 38460.0,
"tax_difference": -2793.0,
"bonuses_paid": 0.0,
"bonus_difference": 0.0,
"total": -2793.0,
"payout": 0.0,
"payout_tax": 0.0,
"payout_bonus": 0.0,
"paid": false,
"rows": {
"1": 468000.0,
"2": 6000.0,
"3": 0.0,
"5": 0.0,
"6": 0.0,
"7": 0.0,
"8": 0.0,
"9": 0.0,
"10": 0.0,
"11": 6000.0,
"12": 462000.0,
"13": 69300.0,
"14": 0.0,
"15": 30840.0,
"16": 0.0,
"17": 0.0,
"18": 0.0,
"19": 0.0,
"20": 30840.0,
"21": 38460.0,
"22": 35667.0,
"23": -2793.0,
"24": null,
"25": null,
"26": null,
"27": null,
"28": null,
"29": null,
"30": null,
"31": null,
"32a": null,
"32b": null
},
"warnings": [
"Nedoplatek 2 793 Kč se zaměstnanci nesráží (§ 38ch odst. 5 a § 35d odst. 8 ZDP)."
]
}
},
"changed": false,
"refund": null,
"deadlines": {
"request": "2027-02-15",
"settlement": "2027-03-31",
"refund_month": 3,
"refund_year": 2027
},
"refund_months": [
1,
2
],
"certificate": {
"year": 2026,
"declaration_months": "1–9",
"declaration_year": true,
"income": 468000.0,
"months": "1–9",
"advances": 35667.0,
"bonuses": 0.0,
"childr
…
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Vrácení přeplatku ze zúčtování ve mzdě nebo mimo ni
/entities/{entity_id}/annual_settlements/{id}/refund
- Oprávnění
- Vlastník, účetní nebo editor
- Pravidlo
- Mzdy smí jen vlastník, účetní a člen se zapnutým přístupem ke mzdám (Vidí mzdy v Nastavení → Uživatelé); ostatní dostanou 403
PAYROLL_ACCESSbez dat. Zapisuje role se zápisem. - Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Naplánuje vrácení spočteného doplatku ze zúčtování ve výplatní pásce za leden až duben následujícího roku (zákon požaduje nejpozději mzdu za březen, § 38ch odst. 5 a § 35d odst. 8 ZDP), nebo zapíše vrácení mimo mzdu s datem (zaměstnanec bez pásky). Existující nezaúčtovaná páska měsíce se hned přepočítá: částka se přičte k výplatě a zaúčtuje MD 342 / D 331 (přeplatek na dani a doplatek na daňovém bonusu zvlášť); páska spočítaná později ji zahrne sama. Platby úřadům o vrácené částky sníží odvod záloh v měsíci vrácení a co nestačí, odečtou v dalších měsících (§ 38ch odst. 5, § 35d odst. 9 ZDP).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID pracovníka Příklad 3. |
year | dotaz | celé číslo | ne | Zdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
month | celé číslo | ne | Měsíc výplatní pásky následujícího roku (1 až 4) |
outside_on | datum | ne | Místo month: den vrácení mimo mzdu v následujícím roce |
Odpověď
200 application/json Roční zúčtování zaměstnance s refund (tvar jako GET).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 403 | PAYROLL_ACCESS | Volající je editor nebo Jen čtení bez přístupu ke mzdám |
| 404 | – | Pracovník nepatří firmě |
| 422 | – | Zúčtování není spočtené, nic se nevrací, měsíc mimo leden až duben, datum mimo následující rok, páska měsíce je zaúčtovaná, nebo jsou mzdy měsíce uzavřené či období uzamčené |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Uloží vrácení, přepočte nezaúčtovanou pásku měsíce a zapíše událost payroll.settlement_refund.
- Opakování
- Opakování se stejným měsícem vede ke stejnému stavu; jiný měsíc vrácení přesune.
Příklad
Vrácení potřebuje spočtené zúčtování uzavřeného roku s přeplatkem; ukázková firma má mzdy jen za běžný rok 2026.
GET Seznam cestovních příkazů
/entities/{entity_id}/trips
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí cestovní příkazy firmy od nejpozdějšího odjezdu, každý s uloženými vstupy a výsledkem výpočtu náhrad. S parametrem year jen cesty s odjezdem v hospodářském roce firmy začínajícím v tomto roce (u kalendářního roku 1. 1. až 31. 12.).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok odjezdu; bez parametru cesty všech let, nečíselná hodnota znamená aktuální rok. Rozsah od 2000 do 2100. Příklad 2026. |
Odpověď
200 application/json Pole cestovních příkazů.
| Pole | Význam |
|---|---|
id, number, employee_id, employee_name, traveller_name | Příkaz, jeho číslo (CP + rok + pořadí, přidělené při vyúčtování) a cestující |
purpose, destination, departed_at, returned_at | Účel, místo a čas cesty (departed_at a returned_at v UTC) |
departure_local, arrival_local | Odjezd a návrat v českém místním čase, jak byly zadány |
status, status_label | draft (koncept), approved (schváleno), settled (vyúčtováno), paid (proplaceno), cancelled (stornováno) |
approved_at, approved_by_id, settled_on, paid_on, cancelled_at | Kdy a kdo příkaz schválil, vyúčtoval, proplatil nebo stornoval |
advance_amount, advance_paid_on | Vyplacená záloha v Kč a den výplaty |
total | Náhrady celkem v Kč včetně zahraničního stravného přepočteného kurzem |
input, result | Uložené vstupy formuláře a výsledek výpočtu (tvar jako u výpočtu) |
Chování
- Co změní
- Nic nezapisuje.
- Limity
- Vrátí nejvýše 500 cest, bez stránkování.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/trips?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 2,
"advance_amount": 0.0,
"advance_paid_on": null,
"approved_at": null,
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-09-24T05:00:00.000Z",
"destination": "Plzeň",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Školení",
"destination": "Plzeň",
"departure": "2026-09-24T07:00",
"arrival": "2026-09-24T16:30"
},
"number": null,
"paid_on": null,
"purpose": "Školení",
"result": {
"duration_hours": 9.5,
"per_diem": {
"band": "short",
"rate": 155.0,
"reductions": 0.0,
"amount": 155.0,
"days": [
{
"date": "2026-09-24",
"dates": [
"2026-09-24"
],
"hours": 9.5,
"band": "short",
"range": {
"min": 155.0,
"max": 185.0
},
"rate": 155.0,
"meals": 0,
"reductions": 0.0,
"amount": 155.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 0.0,
"km": 0.0,
"amount": 0.0
},
"fuel": {
"type": null,
"price": null,
"consumption": 0.0,
"amount": 0.0
},
"accommodation": 0.0,
"other": 0.0,
"total": 155.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-09-24T14:30:00.000Z",
"settled_on": null,
"status": "draft",
"total": 155.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Koncept",
"departure_local": "2026-09-24T07:00",
"arrival_local": "2026-09-24T16:30"
},
{
"id": 1,
"advance_amount": 0.0,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-08-12T04:40:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"number": null,
"paid_on": null,
"purpose": "Workshop u klienta",
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-08-12T17:05:00.000Z",
"settled_on": null,
"status": "approved",
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Schváleno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05"
}
]
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Nový cestovní příkaz s výpočtem náhrad
/entities/{entity_id}/trips
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Spočítá náhrady stejně jako POST /entities/{entity_id}/trips/calculate a uloží cestovní příkaz se vstupy, výsledkem, celkovou částkou a zálohou jako koncept (draft). Stav mění jen akce schválit, vyúčtovat, proplatit a stornovat; pole status se ignoruje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
trip | objekt | ano | |
trip. | celé číslo | ne | Pracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee |
trip. | text | ne | Jméno cestujícího; bez hodnoty jméno pracovníka |
trip. | text | ne | employee zaměstnanec nebo jednatel (náhrady podle zákoníku práce), self_employed OSVČ (výdaje podle § 24 odst. 2 písm. k) ZDP). Bez hodnoty employee, je-li zadán employee_id nebo jde o právnickou osobu, jinak self_employed. Hodnoty: employee, self_employed. |
trip. | text | ne | Účel cesty; výpočet neovlivní |
trip. | text | ano | Místo cesty; při uložení povinné, nejvýše 200 znaků |
trip. | text | ano | Odjezd, datum a čas ISO 8601 (např. 2026-09-21T06:30) v českém místním čase (Europe/Prague); čas s posunem (+02:00) se převede. Podle místního času se cesta dělí na kalendářní dny. |
trip. | text | ano | Návrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm |
trip. | text | ne | Výše stravného: minimum (zákonné minimum, výchozí u zaměstnance) nebo maximum (horní hranice osvobozená od daně, vždy u OSVČ) Hodnoty: minimum, maximum. |
trip. | číslo | ne | Ujeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá |
trip. | text | ne | Soukromé vozidlo; truck má u zaměstnance dvojnásobnou sazbu osobního auta, electric počítá s elektřinou Hodnoty: car, motorcycle, truck, electric. Výchozí car. |
trip. | číslo | ne | Průměrná spotřeba na 100 km podle technického průkazu (l nebo kWh) |
trip. | text | ne | Druh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95. |
trip. | číslo | ne | Cena paliva za litr nebo kWh podle dokladu; bez ní průměrná cena z vyhlášky platná v den odjezdu. Palivo bez průměrné ceny (např. lpg) bez fuel_price dá náhradu za PHM 0 a upozornění. |
trip. | číslo | ne | Ubytování v Kč, nezáporné |
trip. | číslo | ne | Ostatní nutné vedlejší výdaje v Kč, nezáporné |
trip. | text | ne | Kód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné |
trip. | číslo | ne | Hodiny strávené v zahraničí, nejvýš délka cesty; přechod hranice se umístí doprostřed cesty. Místo nich lze poslat border_out a border_in |
trip. | text | ne | Přechod hranice při výjezdu, datum a čas v místním čase |
trip. | text | ne | Přechod hranice při návratu, datum a čas v místním čase |
trip. | číslo | ne | Kurz Kč za jednotku měny cílové země. Bez něj Saldo použije kurz ČNB ke dni nástupu cesty, při vyplacené záloze ke dni jejího vyplacení (§ 184 zákoníku práce); nedostupný kurz ČNB nechá částku v Kč prázdnou. |
trip. | ano/ne | ne | Kapesné 40 % zahraničního stravného (§ 180 zákoníku práce) |
trip. | pole (objekt) | ne | Bezplatně poskytnutá jídla po dnech, která krátí stravné |
trip. | datum | ano | Den cesty (RRRR-MM-DD) |
trip. | celé číslo | ano | Počet jídel v daném dni, 0 až 3 |
trip. | ano/ne | ne | true = jídlo krátí zahraniční stravné, false tuzemské; bez hodnoty podle toho, které stravné za den náleží |
trip. | číslo | ne | Vyplacená záloha v Kč (výplatu zaúčtujte z banky nebo pokladny na účet 335) |
trip. | datum | ne | Den výplaty zálohy |
Odpověď
201 application/json Uložený cestovní příkaz (tvar jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | employee_id nepatří pracovníkovi této firmy – „Záznam nebyl nalezen“ |
| 422 | – | Neplatný vstup (zprávy jako u výpočtu) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří cestovní příkaz a zapíše událost trip.created. Nic nezaúčtuje.
- Opakování
- Každé volání založí nový příkaz; duplicity se nekontrolují.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"trip":{"employee_id":1,"destination":"Brno","purpose":"Jednání s klientem","departure":"2026-09-21T06:30","arrival":"2026-09-21T19:10","km":420,"vehicle_kind":"car","consumption":6.1,"fuel":"diesel","advance_amount":2000,"advance_paid_on":"2026-09-18"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/tripsJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"trip": {
"employee_id": 1,
"destination": "Brno",
"purpose": "Jednání s klientem",
"departure": "2026-09-21T06:30",
"arrival": "2026-09-21T19:10",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel",
"advance_amount": 2000,
"advance_paid_on": "2026-09-18"
}
})
});
const data = await response.json();{
"id": 3,
"advance_amount": 2000.0,
"advance_paid_on": "2026-09-18",
"approved_at": null,
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-09-21T04:30:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Jednání s klientem",
"destination": "Brno",
"departure": "2026-09-21T06:30",
"arrival": "2026-09-21T19:10",
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel",
"km": 420
},
"number": null,
"paid_on": null,
"purpose": "Jednání s klientem",
"result": {
"duration_hours": 12.67,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-09-21",
"dates": [
"2026-09-21"
],
"hours": 12.67,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-09-21T17:10:00.000Z",
"settled_on": null,
"status": "draft",
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Koncept",
"departure_local": "2026-09-21T06:30",
"arrival_local": "2026-09-21T19:10"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Detail cestovního příkazu se zaúčtováním
/entities/{entity_id}/trips/{id}
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí cestovní příkaz ve tvaru jako v seznamu a jeho účetní zápisy (zdroj trip).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Odpověď
200 application/json Cestovní příkaz.
| Pole | Význam |
|---|---|
id, number, status, … | Pole jako v seznamu cest |
entries | Účetní zápisy vyúčtování: date, debit_account, credit_account, amount, text; prázdné před vyúčtováním a v daňové evidenci |
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/trips/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();{
"id": 1,
"advance_amount": 0.0,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-08-12T04:40:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"number": null,
"paid_on": null,
"purpose": "Workshop u klienta",
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-08-12T17:05:00.000Z",
"settled_on": null,
"status": "approved",
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Schváleno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05",
"entries": []
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
PATCH Přepočet a úprava cestovního příkazu
/entities/{entity_id}/trips/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Znovu spočítá náhrady z odeslaného formuláře a přepíše jím celý příkaz: pole, která v trip chybí, se vymažou (například purpose nebo vazba na pracovníka); záloha zůstane, pokud advance_amount ani advance_paid_on nepošlete. Posílejte proto vždy celý formulář. Měnit jde jen koncept a schválený příkaz; vyúčtovaný nejdřív vraťte k úpravě (POST …/trips/{id}/reopen), proplacený jen stornujte.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
trip | objekt | ano | |
trip. | celé číslo | ne | Pracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee |
trip. | text | ne | Jméno cestujícího; bez hodnoty jméno pracovníka |
trip. | text | ne | employee zaměstnanec nebo jednatel (náhrady podle zákoníku práce), self_employed OSVČ (výdaje podle § 24 odst. 2 písm. k) ZDP). Bez hodnoty employee, je-li zadán employee_id nebo jde o právnickou osobu, jinak self_employed. Hodnoty: employee, self_employed. |
trip. | text | ne | Účel cesty; výpočet neovlivní |
trip. | text | ano | Místo cesty; při uložení povinné, nejvýše 200 znaků |
trip. | text | ano | Odjezd, datum a čas ISO 8601 (např. 2026-09-21T06:30) v českém místním čase (Europe/Prague); čas s posunem (+02:00) se převede. Podle místního času se cesta dělí na kalendářní dny. |
trip. | text | ano | Návrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm |
trip. | text | ne | Výše stravného: minimum (zákonné minimum, výchozí u zaměstnance) nebo maximum (horní hranice osvobozená od daně, vždy u OSVČ) Hodnoty: minimum, maximum. |
trip. | číslo | ne | Ujeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá |
trip. | text | ne | Soukromé vozidlo; truck má u zaměstnance dvojnásobnou sazbu osobního auta, electric počítá s elektřinou Hodnoty: car, motorcycle, truck, electric. Výchozí car. |
trip. | číslo | ne | Průměrná spotřeba na 100 km podle technického průkazu (l nebo kWh) |
trip. | text | ne | Druh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95. |
trip. | číslo | ne | Cena paliva za litr nebo kWh podle dokladu; bez ní průměrná cena z vyhlášky platná v den odjezdu. Palivo bez průměrné ceny (např. lpg) bez fuel_price dá náhradu za PHM 0 a upozornění. |
trip. | číslo | ne | Ubytování v Kč, nezáporné |
trip. | číslo | ne | Ostatní nutné vedlejší výdaje v Kč, nezáporné |
trip. | text | ne | Kód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné |
trip. | číslo | ne | Hodiny strávené v zahraničí, nejvýš délka cesty; přechod hranice se umístí doprostřed cesty. Místo nich lze poslat border_out a border_in |
trip. | text | ne | Přechod hranice při výjezdu, datum a čas v místním čase |
trip. | text | ne | Přechod hranice při návratu, datum a čas v místním čase |
trip. | číslo | ne | Kurz Kč za jednotku měny cílové země. Bez něj Saldo použije kurz ČNB ke dni nástupu cesty, při vyplacené záloze ke dni jejího vyplacení (§ 184 zákoníku práce); nedostupný kurz ČNB nechá částku v Kč prázdnou. |
trip. | ano/ne | ne | Kapesné 40 % zahraničního stravného (§ 180 zákoníku práce) |
trip. | pole (objekt) | ne | Bezplatně poskytnutá jídla po dnech, která krátí stravné |
trip. | datum | ano | Den cesty (RRRR-MM-DD) |
trip. | celé číslo | ano | Počet jídel v daném dni, 0 až 3 |
trip. | ano/ne | ne | true = jídlo krátí zahraniční stravné, false tuzemské; bez hodnoty podle toho, které stravné za den náleží |
trip. | číslo | ne | Vyplacená záloha v Kč |
trip. | datum | ne | Den výplaty zálohy |
Odpověď
200 application/json Přepočtený cestovní příkaz.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 404 | – | employee_id nepatří pracovníkovi této firmy – „Záznam nebyl nalezen“ |
| 422 | – | Příkaz je vyúčtovaný, proplacený nebo stornovaný – „Cestovní příkaz je … a nejde měnit …“ |
| 422 | – | Neplatný vstup (zprávy jako u výpočtu) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Přepíše cestovní příkaz a zapíše událost trip.updated; když se něco změnilo, nese details.changes s původními a novými hodnotami. Nic nezaúčtuje.
- Opakování
- Opakování se stejným formulářem vede ke stejnému výsledku.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"trip":{"employee_id":1,"destination":"Brno","purpose":"Workshop u klienta","departure":"2026-09-12T06:40","arrival":"2026-09-12T19:05","km":420,"consumption":6.1,"fuel":"diesel"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/trips/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"trip": {
"employee_id": 1,
"destination": "Brno",
"purpose": "Workshop u klienta",
"departure": "2026-09-12T06:40",
"arrival": "2026-09-12T19:05",
"km": 420,
"consumption": 6.1,
"fuel": "diesel"
}
})
});
const data = await response.json();{
"employee_id": 1,
"traveller_name": "Anna Ukázková",
"purpose": "Workshop u klienta",
"destination": "Brno",
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-09-12T06:40",
"arrival": "2026-09-12T19:05",
"consumption": 6.1,
"fuel": "diesel",
"km": 420
},
"departed_at": "2026-09-12T04:40:00.000Z",
"returned_at": "2026-09-12T17:05:00.000Z",
"total": 3855.0,
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-09-12",
"dates": [
"2026-09-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"advance_amount": 0.0,
"id": 1,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"number": null,
"paid_on": null,
"settled_on": null,
"status": "approved",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Schváleno",
"departure_local": "2026-09-12T06:40",
"arrival_local": "2026-09-12T19:05"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
DELETE Smazání cestovního příkazu
/entities/{entity_id}/trips/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže koncept nebo schválený cestovní příkaz. Vyúčtovaný, proplacený nebo stornovaný příkaz je účetní doklad a smazat nejde.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Odpověď
204 Prázdná odpověď.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz je vyúčtovaný, proplacený nebo stornovaný – „Vyúčtovaný nebo stornovaný cestovní příkaz nejde smazat …“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže cestovní příkaz a zapíše událost trip.deleted s jeho údaji (details.changes).
- Opakování
- Druhé smazání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/trips/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Výpočet cestovních náhrad bez uložení
/entities/{entity_id}/trips/calculate
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Spočítá náhrady za pracovní cestu (celou cestu od odjezdu do návratu bere jako jeden úsek) a nic neuloží: tuzemské stravné po kalendářních dnech krácené o poskytnutá jídla, zahraniční stravné v měně cílové země krácené o jídla a přepočtené kurzem na Kč, kapesné, základní náhradu za soukromé vozidlo, náhradu za pohonné hmoty, ubytování a ostatní výdaje. Zaměstnanci počítá minimální nebo nejvyšší sazby stravného podle per_diem_level a celkovou částku zaokrouhlí na koruny nahoru; OSVČ počítá horní hranici sazeb a jen dny delší než 12 hodin. Sazby se berou podle roku a dne odjezdu.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
advance_paid_on | dotaz | datum | ne | Den výplaty zálohy; kurz ČNB pro zahraniční stravné se pak bere k tomuto dni Příklad 2026-09-18. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
trip | objekt | ano | |
trip. | celé číslo | ne | Pracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee |
trip. | text | ne | Jméno cestujícího; bez hodnoty jméno pracovníka |
trip. | text | ne | employee zaměstnanec nebo jednatel (náhrady podle zákoníku práce), self_employed OSVČ (výdaje podle § 24 odst. 2 písm. k) ZDP). Bez hodnoty employee, je-li zadán employee_id nebo jde o právnickou osobu, jinak self_employed. Hodnoty: employee, self_employed. |
trip. | text | ne | Účel cesty; výpočet neovlivní |
trip. | text | ne | Místo cesty; při uložení povinné, nejvýše 200 znaků |
trip. | text | ano | Odjezd, datum a čas ISO 8601 (např. 2026-09-21T06:30) v českém místním čase (Europe/Prague); čas s posunem (+02:00) se převede. Podle místního času se cesta dělí na kalendářní dny. |
trip. | text | ano | Návrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm |
trip. | text | ne | Výše stravného: minimum (zákonné minimum, výchozí u zaměstnance) nebo maximum (horní hranice osvobozená od daně, vždy u OSVČ) Hodnoty: minimum, maximum. |
trip. | číslo | ne | Ujeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá |
trip. | text | ne | Soukromé vozidlo; truck má u zaměstnance dvojnásobnou sazbu osobního auta, electric počítá s elektřinou Hodnoty: car, motorcycle, truck, electric. Výchozí car. |
trip. | číslo | ne | Průměrná spotřeba na 100 km podle technického průkazu (l nebo kWh) |
trip. | text | ne | Druh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95. |
trip. | číslo | ne | Cena paliva za litr nebo kWh podle dokladu; bez ní průměrná cena z vyhlášky platná v den odjezdu. Palivo bez průměrné ceny (např. lpg) bez fuel_price dá náhradu za PHM 0 a upozornění. |
trip. | číslo | ne | Ubytování v Kč, nezáporné |
trip. | číslo | ne | Ostatní nutné vedlejší výdaje v Kč, nezáporné |
trip. | text | ne | Kód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné |
trip. | číslo | ne | Hodiny strávené v zahraničí, nejvýš délka cesty; přechod hranice se umístí doprostřed cesty. Místo nich lze poslat border_out a border_in |
trip. | text | ne | Přechod hranice při výjezdu, datum a čas v místním čase |
trip. | text | ne | Přechod hranice při návratu, datum a čas v místním čase |
trip. | číslo | ne | Kurz Kč za jednotku měny cílové země. Bez něj Saldo použije kurz ČNB ke dni nástupu cesty, při vyplacené záloze ke dni jejího vyplacení (§ 184 zákoníku práce); nedostupný kurz ČNB nechá částku v Kč prázdnou. |
trip. | ano/ne | ne | Kapesné 40 % zahraničního stravného (§ 180 zákoníku práce) |
trip. | pole (objekt) | ne | Bezplatně poskytnutá jídla po dnech, která krátí stravné |
trip. | datum | ano | Den cesty (RRRR-MM-DD) |
trip. | celé číslo | ano | Počet jídel v daném dni, 0 až 3 |
trip. | ano/ne | ne | true = jídlo krátí zahraniční stravné, false tuzemské; bez hodnoty podle toho, které stravné za den náleží |
Odpověď
200 application/json Výpočet cestovních náhrad.
| Pole | Význam |
|---|---|
duration_hours | Délka cesty v hodinách |
per_diem | Tuzemské stravné: band, rate, reductions, amount a days (po dnech: date, dates, hours, band short/medium/long, range, rate, meals, reductions, amount) |
foreign_per_diem | Zahraniční stravné (nebo null): country, country_name, currency, base_rate, days, amount, pocket_money_max, pocket_money, exchange_rate a amount_czk (null, když kurz není k dispozici) |
mileage | Základní náhrada: base_rate, km, amount |
fuel | Náhrada za PHM: type, price, consumption, amount |
accommodation, other | Zadané výdaje |
total | Náhrady celkem v Kč včetně zahraničního stravného a kapesného v Kč |
traveller, exchange_rate_source, exchange_rate_date | employee nebo self_employed; zdroj kurzu cnb nebo manual a den kurzu ČNB |
basis | Právní základ použitých sazeb |
warnings | Upozornění (česky) |
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Chybí nebo je nečitelný odjezd či návrat – „Zadejte odjezd i návrat“ |
| 422 | – | Návrat není po odjezdu – „Návrat musí být po odjezdu“ |
| 422 | – | Cesta je delší než 366 dní – „Cesta smí trvat nejvýš 366 dní“ |
| 422 | – | Pro rok odjezdu nejsou v Saldu sazby – „Pro rok RRRR nejsou k dispozici zákonné sazby“ |
| 422 | – | Neplatný vstup s českou zprávou: jídlo mimo dny cesty nebo víc než 3 za den, neznámé vozidlo nebo palivo, záporné km, ubytování či ostatní výdaje, země CZ, zahraniční cesta bez hodin v zahraničí a bez přechodu hranic, doba v zahraničí delší než cesta, nekladný kurz |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nic nezapisuje. U zahraniční cesty bez exchange_rate se zeptá ČNB na kurz (výsledek se ukládá do mezipaměti).
- Limity
- Cesta smí trvat nejvýš 366 dní a má jedno místo a jednu cílovou zemi.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"trip":{"destination":"Brno","purpose":"Jednání s klientem","departure":"2026-09-21T06:30","arrival":"2026-09-22T19:10","km":420,"vehicle_kind":"car","consumption":6.1,"fuel":"diesel","accommodation":1200,"meals":[{"date":"2026-09-22","count":1}]}}' \
https://techtools.cz/ucetnictvi-api/entities/1/trips/calculateJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/calculate', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"trip": {
"destination": "Brno",
"purpose": "Jednání s klientem",
"departure": "2026-09-21T06:30",
"arrival": "2026-09-22T19:10",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel",
"accommodation": 1200,
"meals": [
{
"date": "2026-09-22",
"count": 1
}
]
}
})
});
const data = await response.json();{
"duration_hours": 36.67,
"per_diem": {
"band": "multi_day",
"rate": 606.0,
"reductions": 92.5,
"amount": 513.5,
"days": [
{
"date": "2026-09-21",
"dates": [
"2026-09-21"
],
"hours": 17.5,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
},
{
"date": "2026-09-22",
"dates": [
"2026-09-22"
],
"hours": 19.17,
"band": "long",
"range": {
"min": 370.0,
"max": 442.0
},
"rate": 370.0,
"meals": 1,
"reductions": 92.5,
"amount": 277.5
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 1200.0,
"other": 0.0,
"total": 5332.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Schválení cestovního příkazu
/entities/{entity_id}/trips/{id}/approve
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Označí koncept cestovního příkazu jako schválený a uloží, kdo a kdy ho schválil. Nic neúčtuje.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Odpověď
200 application/json Schválený cestovní příkaz (tvar jako v seznamu).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz není koncept – „Schválit jde jen koncept cestovního příkazu“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nastaví stav approved, approved_at a approved_by_id a zapíše událost trip.approved.
- Opakování
- Druhé volání vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/trips/2/approveJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/2/approve', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"status": "approved",
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": 1,
"advance_amount": 0.0,
"id": 2,
"advance_paid_on": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-09-24T05:00:00.000Z",
"destination": "Plzeň",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Školení",
"destination": "Plzeň",
"departure": "2026-09-24T07:00",
"arrival": "2026-09-24T16:30"
},
"number": null,
"paid_on": null,
"purpose": "Školení",
"result": {
"duration_hours": 9.5,
"per_diem": {
"band": "short",
"rate": 155.0,
"reductions": 0.0,
"amount": 155.0,
"days": [
{
"date": "2026-09-24",
"dates": [
"2026-09-24"
],
"hours": 9.5,
"band": "short",
"range": {
"min": 155.0,
"max": 185.0
},
"rate": 155.0,
"meals": 0,
"reductions": 0.0,
"amount": 155.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 0.0,
"km": 0.0,
"amount": 0.0
},
"fuel": {
"type": null,
"price": null,
"consumption": 0.0,
"amount": 0.0
},
"accommodation": 0.0,
"other": 0.0,
"total": 155.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-09-24T14:30:00.000Z",
"settled_on": null,
"total": 155.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Schváleno",
"departure_local": "2026-09-24T07:00",
"arrival_local": "2026-09-24T16:30"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Vyúčtování cestovního příkazu
/entities/{entity_id}/trips/{id}/settle
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Přepočítá náhrady (u zahraniční cesty s kurzem ČNB, pokud kurz není zadaný), přidělí číslo CP + rok + pořadí (např. CP20260001) a v podvojném účetnictví k datu vyúčtování zaúčtuje cestovné: u zaměstnance nebo jednatele MD 512 / D 335 do výše zálohy a zbytek MD 512 / D 333; u vlastní cesty OSVČ stravné, náhradu za vozidlo a zahraniční stravné MD 512 / D 491 (ubytování a jízdné zaplacené z účtu podnikání jsou už v nákladech). Přeplacenou zálohu (vrátí cestující) nechá na 335. V daňové evidenci nic neúčtuje; vyúčtované vlastní cesty OSVČ se v roce vyúčtování započtou do výdajů v dani z příjmů (§ 24 odst. 2 písm. k) ZDP).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
settled_on | dotaz | datum | ne | Datum vyúčtování a zápisů, nejdřív den návratu; bez něj dnešek, nebo den návratu, je-li v budoucnu. Číslo CP nese rok tohoto data Příklad 2026-09-30. |
Odpověď
200 application/json Vyúčtovaný cestovní příkaz se zápisy (tvar jako detail).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz není koncept ani schválený – „Vyúčtovat jde jen koncept nebo schválený cestovní příkaz“ |
| 422 | – | settled_on před dnem návratu – „Cestu lze vyúčtovat nejdřív v den návratu …“ |
| 422 | – | Zahraniční cesta bez kurzu a ČNB kurz nevrátila – „Kurz ČNB … se nepodařilo načíst – zadejte kurz ručně a vyúčtujte znovu“ |
| 422 | – | Datum vyúčtování leží v uzamčeném období – „Období do D. M. RRRR je uzamčeno – do něj nelze účtovat“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nastaví stav settled, settled_on a číslo, zaúčtuje cestovné (zdroj trip) a zapíše událost trip.settled.
- Opakování
- Druhé volání vrátí 422; po vrácení k úpravě (reopen) zůstane číslo stejné.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/trips/1/settle?settled_on=2026-09-30"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1/settle?settled_on=2026-09-30', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"departed_at": "2026-08-12T04:40:00.000Z",
"returned_at": "2026-08-12T17:05:00.000Z",
"total": 3855.0,
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"status": "settled",
"settled_on": "2026-09-30",
"number": "CP20260001",
"advance_amount": 0.0,
"id": 1,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"paid_on": null,
"purpose": "Workshop u klienta",
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Vyúčtováno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05",
"entries": [
{
"date": "2026-09-30",
"debit_account": "512",
"credit_account": "333",
"amount": 3855.0,
"text": "Cestovní příkaz CP20260001 – Brno (doplatek)"
}
]
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Vrácení vyúčtování k úpravě
/entities/{entity_id}/trips/{id}/reopen
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zruší zaúčtování vyúčtovaného, dosud neproplaceného cestovního příkazu a vrátí ho do stavu schváleno (nebo koncept, pokud nebyl schválený). Číslo příkazu zůstane.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Odpověď
200 application/json Cestovní příkaz vrácený k úpravě.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz není vyúčtovaný (např. už je proplacený) – „Vrátit k úpravě jde jen vyúčtovaný, dosud neproplacený cestovní příkaz“ |
| 422 | – | Zápisy vyúčtování leží v uzamčeném období |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže zápisy vyúčtování (zdroj trip), vymaže settled_on a zapíše událost trip.reopened.
- Opakování
- Druhé volání vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/trips/1/reopenJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1/reopen', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"status": "approved",
"settled_on": null,
"advance_amount": 0.0,
"number": "CP20260001",
"id": 1,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-08-12T04:40:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"paid_on": null,
"purpose": "Workshop u klienta",
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-08-12T17:05:00.000Z",
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Schváleno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Označení cestovního příkazu jako proplaceného
/entities/{entity_id}/trips/{id}/pay
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zaznamená den proplacení vyúčtovaného cestovního příkazu a tím ho uzamkne – pak jde jen stornovat. Platbu samu nezaúčtuje: doplatek zaplaťte z banky nebo pokladny a zaúčtujte na účet 333, vrácenou zálohu na účet 335.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
paid_on | dotaz | datum | ne | Den proplacení, ne před vyúčtováním a ne v budoucnu; bez něj dnešek Příklad 2026-09-30. |
Odpověď
200 application/json Proplacený cestovní příkaz.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz není vyúčtovaný – „Proplatit jde jen vyúčtovaný cestovní příkaz“ |
| 422 | – | Den proplacení je před vyúčtováním nebo v budoucnu |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Nastaví stav paid a paid_on a zapíše událost trip.paid.
- Opakování
- Druhé volání vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/trips/1/pay?paid_on=2026-09-28"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1/pay?paid_on=2026-09-28', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"status": "paid",
"paid_on": "2026-09-28",
"advance_amount": 0.0,
"number": "CP20260001",
"id": 1,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-08-12T04:40:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"purpose": "Workshop u klienta",
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-08-12T17:05:00.000Z",
"settled_on": "2026-09-25",
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Proplaceno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
POST Storno cestovního příkazu
/entities/{entity_id}/trips/{id}/cancel
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Stornuje cestovní příkaz v jakémkoli stavu kromě stornovaného: smaže jeho zápisy vyúčtování a ponechá ho v seznamu se stavem stornováno a s dosavadním číslem. Platby (záloha, doplatek) zaúčtované z banky nebo pokladny nemění.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID cestovního příkazu Příklad 7. |
Odpověď
200 application/json Stornovaný cestovní příkaz.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Příkaz už je stornovaný – „Cestovní příkaz už je stornovaný“ |
| 422 | – | Zápisy vyúčtování leží v uzamčeném období |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Smaže zápisy vyúčtování (zdroj trip), nastaví stav cancelled a cancelled_at a zapíše událost trip.cancelled.
- Opakování
- Druhé volání vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/trips/1/cancelJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/trips/1/cancel', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"status": "cancelled",
"cancelled_at": "2026-09-28T10:00:00.000Z",
"advance_amount": 0.0,
"id": 1,
"advance_paid_on": null,
"approved_at": "2026-09-28T10:00:00.000Z",
"approved_by_id": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-08-12T04:40:00.000Z",
"destination": "Brno",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Workshop u klienta",
"destination": "Brno",
"departure": "2026-08-12T06:40",
"arrival": "2026-08-12T19:05",
"km": 420,
"vehicle_kind": "car",
"consumption": 6.1,
"fuel": "diesel"
},
"number": null,
"paid_on": null,
"purpose": "Workshop u klienta",
"result": {
"duration_hours": 12.42,
"per_diem": {
"band": "medium",
"rate": 236.0,
"reductions": 0.0,
"amount": 236.0,
"days": [
{
"date": "2026-08-12",
"dates": [
"2026-08-12"
],
"hours": 12.42,
"band": "medium",
"range": {
"min": 236.0,
"max": 284.0
},
"rate": 236.0,
"meals": 0,
"reductions": 0.0,
"amount": 236.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 420.0,
"amount": 2478.0
},
"fuel": {
"type": "diesel",
"price": 44.5,
"consumption": 6.1,
"amount": 1140.09
},
"accommodation": 0.0,
"other": 0.0,
"total": 3855.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-08-12T17:05:00.000Z",
"settled_on": null,
"total": 3855.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Stornováno",
"departure_local": "2026-08-12T06:40",
"arrival_local": "2026-08-12T19:05"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.
GET Kniha jízd
/entities/{entity_id}/rides
- Oprávnění
- Každý člen firmy včetně role Jen čtení
- Klíč jen pro čtení
- Stačí
Vrátí jízdy z knihy jízd od nejstarší (datum, čas odjezdu, ID), každou s vozidlem, řidičem, trasou, účelem, stavem tachometru, kilometry, příznakem soukromé jízdy a vazbou na cestovní příkaz.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
year | dotaz | celé číslo | ne | Rok jízdy (hospodářský rok firmy začínající v tomto roce); bez parametru všechny jízdy Rozsah od 2000 do 2100. Příklad 2026. |
vehicle | dotaz | text | ne | Jen jízdy vozidla s tímto názvem (přesná shoda) Příklad Škoda Fabia 2AB 3456. |
Odpověď
200 application/json Pole jízd.
| Pole | Význam |
|---|---|
id, driven_on, start_time, end_time | Jízda, datum a časy HH:MM |
vehicle, asset_id | Vozidlo a případně karta firemního auta z Majetku |
driver_name, employee_id | Řidič a případně pracovník z Mezd |
origin, destination, purpose, note | Trasa, účel a poznámka |
km, odometer_start, odometer_end | Ujeté kilometry a stav tachometru |
private_use | true = soukromá jízda |
trip_id, trip_number, trip_status | Cestovní příkaz vytvořený z jízdy |
Chování
- Co změní
- Nic nezapisuje.
- Limity
- Vrátí nejvýše 2 000 jízd, bez stránkování.
Příklad
cURL
curl \
-H "X-API-Key: $SALDO_API_KEY" \
"https://techtools.cz/ucetnictvi-api/entities/1/rides?year=2026"JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/rides?year=2026', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY }
});
const data = await response.json();[
{
"id": 1,
"asset_id": null,
"created_at": "2026-09-28T10:00:00.000Z",
"destination": "Olomouc",
"driven_on": "2026-09-15",
"driver_name": "Anna Ukázková",
"employee_id": 1,
"end_time": null,
"km": 560.0,
"note": null,
"odometer_end": 48770,
"odometer_start": 48210,
"origin": "Praha",
"private_use": false,
"purpose": "Schůzka s klientem",
"start_time": null,
"trip_id": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"vehicle": "Škoda Fabia 2AB 3456",
"trip_number": null,
"trip_status": null
}
]
POST Zápis jízdy do knihy jízd
/entities/{entity_id}/rides
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Zapíše jízdu. S asset_id se vozidlo pojmenuje podle karty majetku, s employee_id řidič podle pracovníka; se stavem tachometru na začátku i na konci se dopočítají kilometry. Kniha jízd nic neúčtuje; slouží k prokázání služebních jízd (výdaje na firemní auto, § 24 zákona o daních z příjmů) a jako podklad pro cestovní příkaz.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ride | objekt | ano | |
ride. | celé číslo | ne | Karta vozidla z Majetku této firmy |
ride. | text | ne | Název vozidla (značka a SPZ), nejvýše 120 znaků; bez asset_id povinný |
ride. | celé číslo | ne | Řidič – pracovník této firmy |
ride. | text | ne | Jméno řidiče, když není pracovníkem |
ride. | datum | ano | Den jízdy |
ride. | text | ne | Čas odjezdu HH:MM |
ride. | text | ne | Čas příjezdu HH:MM, ne dřív než odjezd |
ride. | text | ne | Odkud |
ride. | text | ano | Kam, povinné |
ride. | text | ne | Účel jízdy |
ride. | číslo | ne | Ujeté km, větší než 0 a nejvýš 5 000; se stavem tachometru se musí shodovat |
ride. | celé číslo | ne | Stav tachometru na začátku |
ride. | celé číslo | ne | Stav tachometru na konci, vyšší než na začátku |
ride. | ano/ne | ne | Soukromá jízda Výchozí false. |
ride. | text | ne | Poznámka |
Odpověď
201 application/json Zapsaná jízda (tvar jako v knize jízd).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Chybí datum nebo cíl, km mimo 0 až 5 000 nebo nesouhlasí s tachometrem, čas není HH:MM nebo příjezd je před odjezdem, vozidlo, pracovník nebo cestovní příkaz jiné firmy |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří jízdu a zapíše událost ride.created. Nic nezaúčtuje.
- Opakování
- Každé volání zapíše novou jízdu.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ride":{"vehicle":"Škoda Fabia 2AB 3456","employee_id":1,"driven_on":"2026-09-21","start_time":"07:30","end_time":"15:10","origin":"Praha","destination":"Brno","purpose":"Jednání s klientem","odometer_start":48770,"odometer_end":49192}}' \
https://techtools.cz/ucetnictvi-api/entities/1/ridesJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/rides', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'POST',
body: JSON.stringify({
"ride": {
"vehicle": "Škoda Fabia 2AB 3456",
"employee_id": 1,
"driven_on": "2026-09-21",
"start_time": "07:30",
"end_time": "15:10",
"origin": "Praha",
"destination": "Brno",
"purpose": "Jednání s klientem",
"odometer_start": 48770,
"odometer_end": 49192
}
})
});
const data = await response.json();{
"id": 2,
"asset_id": null,
"created_at": "2026-09-28T10:00:00.000Z",
"destination": "Brno",
"driven_on": "2026-09-21",
"driver_name": "Anna Ukázková",
"employee_id": 1,
"end_time": "15:10",
"km": 422.0,
"note": null,
"odometer_end": 49192,
"odometer_start": 48770,
"origin": "Praha",
"private_use": false,
"purpose": "Jednání s klientem",
"start_time": "07:30",
"trip_id": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"vehicle": "Škoda Fabia 2AB 3456",
"trip_number": null,
"trip_status": null
}
PATCH Úprava jízdy
/entities/{entity_id}/rides/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Změní zaslaná pole jízdy (pravidla jako při zápisu).
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID jízdy Příklad 3. |
Tělo požadavku
Formát application/json.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ride | objekt | ano | |
ride. | text | ne | Účel jízdy |
ride. | číslo | ne | Ujeté km |
ride. | ano/ne | ne | Soukromá jízda |
ride. | text | ne | Poznámka; ostatní pole jako při zápisu |
Odpověď
200 application/json Upravená jízda.
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Neplatné údaje (jako při zápisu) |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Upraví jízdu a zapíše událost ride.updated. Cestovní příkaz vytvořený z jízdy se nezmění.
- Opakování
- Opakování se stejnými daty jízdu nezmění.
Příklad
cURL
curl \
-X PATCH \
-H "X-API-Key: $SALDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ride":{"purpose":"Schůzka s klientem a předání zakázky"}}' \
https://techtools.cz/ucetnictvi-api/entities/1/rides/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/rides/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY, 'Content-Type': 'application/json' },
method: 'PATCH',
body: JSON.stringify({
"ride": {
"purpose": "Schůzka s klientem a předání zakázky"
}
})
});
const data = await response.json();{
"purpose": "Schůzka s klientem a předání zakázky",
"km": 560.0,
"odometer_start": 48210,
"odometer_end": 48770,
"id": 1,
"asset_id": null,
"created_at": "2026-09-28T10:00:00.000Z",
"destination": "Olomouc",
"driven_on": "2026-09-15",
"driver_name": "Anna Ukázková",
"employee_id": 1,
"end_time": null,
"note": null,
"origin": "Praha",
"private_use": false,
"start_time": null,
"trip_id": null,
"updated_at": "2026-09-28T10:00:00.000Z",
"vehicle": "Škoda Fabia 2AB 3456",
"trip_number": null,
"trip_status": null
}
DELETE Smazání jízdy
/entities/{entity_id}/rides/{id}
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Smaže jízdu z knihy jízd. Cestovní příkaz, který z ní vznikl, zůstane.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID jízdy Příklad 3. |
Odpověď
204 Prázdná odpověď.
Chování
- Co změní
- Smaže jízdu a zapíše událost ride.deleted.
- Opakování
- Druhé smazání vrátí 404.
Příklad
cURL
curl \
-X DELETE \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/rides/1JavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/rides/1', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'DELETE'
});
const data = await response.json();soubor, 0 bajtů
POST Cestovní příkaz z jízdy
/entities/{entity_id}/rides/{id}/trip
- Oprávnění
- Vlastník, účetní nebo editor
- Klíč jen pro čtení
- Nestačí, vrátí 403
READ_ONLY_KEY
Ze služební jízdy vytvoří koncept cestovního příkazu: řidič, místo, účel, odjezd a příjezd v den jízdy (bez časů 8:00 až 16:00) a u vozidla, které není kartou z Majetku, ujeté kilometry pro náhradu za vlastní auto (spotřebu a palivo doplňte v příkazu). Jízdu s příkazem propojí.
Parametry
| Název | Kde | Typ | Povinný | Popis |
|---|---|---|---|---|
entity_id | cesta | celé číslo | ano | ID účetní jednotky (firmy) Příklad 12. |
id | cesta | celé číslo | ano | ID jízdy Příklad 3. |
Odpověď
201 application/json Vytvořený cestovní příkaz (tvar jako v seznamu cest).
Chyby této operace
| Stav | Kód | Kdy |
|---|---|---|
| 422 | – | Jízda už cestovní příkaz má – „Jízda už má cestovní příkaz …“ |
| 422 | – | Soukromá jízda – „Ze soukromé jízdy cestovní příkaz nevzniká“ |
Společné chyby všech operací (přihlášení, oprávnění, limity) popisuje Chyby a limity.
Chování
- Co změní
- Vytvoří cestovní příkaz ve stavu koncept, propojí ho s jízdou a zapíše událost trip.created.
- Opakování
- Druhé volání vrátí 422.
Příklad
cURL
curl \
-X POST \
-H "X-API-Key: $SALDO_API_KEY" \
https://techtools.cz/ucetnictvi-api/entities/1/rides/1/tripJavaScript
const response = await fetch('https://techtools.cz/ucetnictvi-api/entities/1/rides/1/trip', {
headers: { 'X-API-Key': process.env.SALDO_API_KEY },
method: 'POST'
});
const data = await response.json();{
"id": 3,
"advance_amount": 0.0,
"advance_paid_on": null,
"approved_at": null,
"approved_by_id": null,
"cancelled_at": null,
"created_at": "2026-09-28T10:00:00.000Z",
"departed_at": "2026-09-15T06:00:00.000Z",
"destination": "Olomouc",
"employee_id": 1,
"input": {
"employee_id": 1,
"purpose": "Schůzka s klientem",
"destination": "Olomouc",
"departure": "2026-09-15T08:00",
"arrival": "2026-09-15T16:00",
"km": "560.0",
"vehicle_kind": "car"
},
"number": null,
"paid_on": null,
"purpose": "Schůzka s klientem",
"result": {
"duration_hours": 8.0,
"per_diem": {
"band": "short",
"rate": 155.0,
"reductions": 0.0,
"amount": 155.0,
"days": [
{
"date": "2026-09-15",
"dates": [
"2026-09-15"
],
"hours": 8.0,
"band": "short",
"range": {
"min": 155.0,
"max": 185.0
},
"rate": 155.0,
"meals": 0,
"reductions": 0.0,
"amount": 155.0
}
]
},
"foreign_per_diem": null,
"mileage": {
"base_rate": 5.9,
"km": 560.0,
"amount": 3304.0
},
"fuel": {
"type": "petrol95",
"price": 34.7,
"consumption": 0.0,
"amount": 0.0
},
"accommodation": 0.0,
"other": 0.0,
"total": 3459.0,
"basis": [
"§ 163 odst. 1 až 3 zákoníku práce, vyhláška č. 573/2025 Sb. § 2",
"§ 6 odst. 7 písm. a) ZDP, § 176 odst. 1 zákoníku práce, vyhláška č. 573/2025 Sb. § 3"
],
"warnings": [
"Bez spotřeby z technického průkazu nelze spočítat náhradu za pohonné hmoty; zadejte spotřebu pro kombinovaný provoz (§ 158 odst. 4 zákoníku práce)."
],
"traveller": "employee",
"exchange_rate_source": null,
"exchange_rate_date": null
},
"returned_at": "2026-09-15T14:00:00.000Z",
"settled_on": null,
"status": "draft",
"total": 3459.0,
"traveller_name": "Anna Ukázková",
"updated_at": "2026-09-28T10:00:00.000Z",
"employee_name": "Anna Ukázková",
"status_label": "Koncept",
"departure_local": "2026-09-15T08:00",
"arrival_local": "2026-09-15T16:00"
}
Dlouhé seznamy jsou v ukázce zkrácené na první položky.