SaldoDokumentace
Otevřít Saldo

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.

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

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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneKalendář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.

PoleVýznam
id, name, inventory_number, note, location, responsible_person, serial_numberIdentifikace karty a údaje pro inventuru
categorytangible (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_accountPoří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, improvementsVstupní cena, zbytková hodnota, doba účetního odpisování a technická zhodnocení
tax_group, tax_method, vehicle_m1, tax_increased_first_year, tax_interrupted_yearsParametry daňového odpisování
disposed_on, disposal_kind, disposal_document_id, disposal_compensation, disposal_deductibleVyřazení
document_id, document_number, disposal_document_numberDoklad o pořízení a doklad o prodeji
tax_this_yearDaň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_taxZů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_errorJen 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();
Odpověď 200 OK
[
  {
    "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
assetobjektano
asset.nametextanoNázev majetku, nejvýše 200 znaků
asset.inventory_numbertextneInventární číslo (jedinečnost se nekontroluje)
asset.categorytextneDruh 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.account_codetextneÚč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.acquired_ondatumneDatum pořízení; jen evidence, odpisy se počítají od in_use_from
asset.in_use_fromdatumanoDatum 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.pricečísloanoVstupní cena v Kč, větší než 0; základ účetních i daňových odpisů
asset.placement_accounttextneÚč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.tax_groupcelé čísloneOdpisová 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.tax_methodtextneDaňové odpisování: straight rovnoměrné (§ 31 ZDP), accelerated zrychlené (§ 32 ZDP) Hodnoty: straight, accelerated. Výchozí straight.
asset.tax_increased_first_yearcelé čísloneZvýš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.tax_interrupted_yearspole (celé číslo)neRoky přerušení daňového odpisování (§ 26 odst. 8 ZDP); jen se skupinou, od roku zařazení
asset.useful_life_monthscelé čísloneDoba účetního odpisování v měsících Výchozí 36. Rozsah od 1 do 1200.
asset.residual_valuečísloneZbytková hodnota vyloučená z účetních odpisů, 0 až vstupní cena Výchozí 0.
asset.improvementspole (objekt)neTechnická zhodnocení; celé pole nahradí dosavadní seznam
asset.improvements[].datedatumanoDokončení, od zařazení do vyřazení
asset.improvements[].amountčísloanoČástka v Kč, větší než 0
asset.improvements[].accounttextneÚčet pořízení; Saldo pak k datu zaúčtuje MD account_code / D tento účet Hodnoty: 041, 042.
asset.improvements[].monthscelé čísloneO kolik měsíců se prodlouží účetní odpisování; po skončení odpisů povinné Rozsah od 0 do 1200.
asset.improvements[].document_idcelé čísloneDoklad této firmy
asset.improvements[].notetextnePoznámka
asset.disposed_ondatumneDatum vyřazení; nesmí být před in_use_from
asset.disposal_kindtextneDůvod vyřazení: prodej, likvidace, škoda nebo manko, dar; s disposed_on povinný Hodnoty: sale, scrap, damage, gift.
asset.disposal_document_idcelé čísloneDoklad o prodeji (vydaná faktura této firmy)
asset.disposal_compensationčísloneU škody přijatá náhrada (pojistné plnění) – do její výše je daňová zůstatková cena výdajem
asset.disposal_deductibleano/neneU škody: živelní pohroma nebo neznámý pachatel potvrzený policií – celá daňová zůstatková cena je výdajem Výchozí false.
asset.document_idcelé čísloneID dokladu o pořízení v této firmě; doklad jiné firmy vrátí 422
asset.locationtextneUmístění (inventura)
asset.responsible_persontextneOdpovědná osoba (inventura)
asset.serial_numbertextneVýrobní číslo
asset.notetextnePoznámka
asset.vehicle_m1ano/neneOsobní 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ů.

PoleVýznam
id, name, category, account_code, accumulated_account, in_use_from, price, …Pole karty jako v seznamu majetku
taxDaň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
movementsZápisy pohybů, které Saldo zaúčtuje: date, debit_account, credit_account, amount, text (v daňové evidenci prázdné)
disposalU vyřazené karty: cost_account, total_cost, accumulated, accounting_residual, tax_residual, tax_deductible, kind_label
warningsUpozorně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

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

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID 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í).

PoleVýznam
taxDaň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, warningsZápisy pohybů, výpočet vyřazení a upozornění
plan_errorJen 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/1

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID karty majetku Příklad 5.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
assetobjektano
asset.nametextneNázev majetku, nejvýše 200 znaků
asset.inventory_numbertextneInventární číslo
asset.categorytextneDruh majetku (low_value = drobný bez odpisů) Hodnoty: tangible, intangible, low_value.
asset.account_codetextneÚčet majetku 012 až 019, 021 až 029, 031 nebo 032 (s analytikou)
asset.acquired_ondatumneDatum pořízení
asset.in_use_fromdatumneDatum uvedení do užívání, nejdřív acquired_on (kontroluje se při změně jednoho z obou dat)
asset.pricečísloneVstupní cena v Kč, větší než 0
asset.placement_accounttextneÚčet pořízení; null zápis zařazení zruší Hodnoty: 041, 042.
asset.tax_groupcelé čísloneOdpisová skupina; null zruší daňové odpisy Hodnoty: 1, 2, 3, 4, 5, 6.
asset.tax_methodtextneRovnoměrné nebo zrychlené daňové odpisování Hodnoty: straight, accelerated.
asset.tax_increased_first_yearcelé čísloneZvýšený odpis v prvním roce; null bez něj Hodnoty: 10, 15, 20.
asset.tax_interrupted_yearspole (celé číslo)neRoky přerušení daňového odpisování; prázdné pole přerušení zruší
asset.useful_life_monthscelé čísloneDoba účetního odpisování v měsících Rozsah od 1 do 1200.
asset.residual_valuečísloneZbytková hodnota, 0 až vstupní cena
asset.improvementspole (objekt)neTechnická zhodnocení (tvar jako při založení); celé pole nahradí dosavadní seznam
asset.disposed_ondatumneDatum vyřazení; null vyřazení i jeho zápisy zruší
asset.disposal_kindtextneDůvod vyřazení; s disposed_on povinný Hodnoty: sale, scrap, damage, gift.
asset.disposal_document_idcelé čísloneDoklad o prodeji
asset.disposal_compensationčísloneNáhrada škody
asset.disposal_deductibleano/neneŠkoda živelní pohromou nebo neznámým pachatelem
asset.document_idcelé čísloneDoklad o pořízení v této firmě
asset.locationtextneUmístění
asset.responsible_persontextneOdpovědná osoba
asset.serial_numbertextneVýrobní číslo
asset.notetextnePoznámka
asset.vehicle_m1ano/neneOsobní 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

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID karty majetku Příklad 5.

Odpověď

204 Prázdná odpověď.

Chyby této operace

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

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneKalendář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.
monthdotazcelé čísloneZaúč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ů.

PoleVýznam
yearZaúčtovaný rok
monthPoslední zaúčtovaný měsíc při účtování po měsících, jinak null
postedOdpisy roku: asset_id, name, amount
totalSoučet odpisů v Kč
warningsUpozornění, např. karta pořízená dokladem na 042 bez zaúčtovaného zařazení

Chyby této operace

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID karty majetku Příklad 5.

Odpověď

200 application/json Karta majetku s plány tax, accounting a accounting_yearly.

PoleVýznam
taxyear, rate_or_coefficient (sazba v % nebo koeficient), kind, amount, deductible (u M1 po krácení), accumulated, remaining
accountingmonth, year, amount, accumulated, remaining
accounting_yearlyyear, 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/schedule

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Odpověď

200 application/json Pole karet pracovníků.

PoleVýznam
id, first_name, last_name, full_name, personal_numberIdentifikace pracovníka
contracthpp, dpc nebo dpp
gross_wageSjednaná měsíční mzda nebo odměna v Kč
started_on, ended_onTrvání pracovněprávního vztahu
declaration, disability, ztpp, studentÚdaje pro slevy na dani a pojistné
health_insurer, bank_account, email, noteKontaktní a evidenční údaje
childrenDěti pro daňové zvýhodnění
detailsÚdaje pro JMHZ a další příznaky (objekt); null, dokud nebyly zadány
terms, terms_timelineMzdový 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_fromVý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)
deductionsSrážky ze mzdy: id, kind, label, reference, received_on, total, monthly, account, symboly
vacation, endedOrientač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

StavKódKdy
403PAYROLL_ACCESSVolají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

JavaScript

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();
Odpověď 200 OK
[
  {
    "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
employeeobjektano
employee.first_nametextanoJméno, nejvýše 80 znaků
employee.last_nametextanoPříjmení, nejvýše 80 znaků
employee.personal_numbertextneOsobní číslo
employee.contracttextnehpp pracovní poměr, dpc dohoda o pracovní činnosti, dpp dohoda o provedení práce Hodnoty: hpp, dpc, dpp. Výchozí hpp.
employee.gross_wagečísloneSjednaná 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.started_ondatumanoDatum nástupu, povinné; neplatné datum se uloží jako prázdné a založení skončí chybou 422
employee.ended_ondatumneDatum ukončení, ne před nástupem; pásky se generují jen za měsíce, kdy vztah trval
employee.declarationano/nenePodepsané 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.disabilitytextneInvalidita: first I. nebo II. stupně (základní sleva), third III. stupně (rozšířená sleva); prázdné = žádná Hodnoty: first, third.
employee.ztppano/neneDržitel průkazu ZTP/P (sleva na dani, bez minimálního vyměřovacího základu ZP) Výchozí false.
employee.studentano/neneStudent – projeví se jen ve zdravotním pojištění (bez minimálního vyměřovacího základu) Výchozí false.
employee.health_insurertextneKó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.bank_accounttextneČíslo účtu pracovníka (jen evidence, Saldo mzdy nevyplácí)
employee.emailtextneE-mail v platném tvaru
employee.notetextnePoznámka
employee.childrenpole (objekt)neDěti pro daňové zvýhodnění; odeslaný seznam nahradí uložený celý
employee.children[].ordercelé číslonePořadí dítěte 1, 2 nebo 3; určuje výši zvýhodnění. Jiná hodnota skončí chybou 422
employee.children[].ztppano/neneDítě je držitelem průkazu ZTP/P
employee.children[].monthspole (celé číslo)neMě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.children[].fromtextneZvýhodnění od měsíce RRRR-MM (například narození); prázdné = od nástupu
employee.children[].totextneZvýhodnění do měsíce RRRR-MM (například konec studia); prázdné = bez konce
employee.children[].first_nametextneJméno dítěte (pro JMHZ)
employee.children[].last_nametextnePříjmení dítěte (pro JMHZ)
employee.children[].birth_datedatumneDatum narození dítěte (pro JMHZ)
employee.children[].birth_numbertextneRodné číslo dítěte (pro JMHZ); neplatné skončí chybou 422
employee.deductionspole (objekt)neSrážky ze mzdy; odeslaný seznam nahradí uložený celý, nová srážka dostane id
employee.deductions[].idtextneIdentifikátor srážky (posílejte zpět u existujících, podle něj se sčítá zaplacená částka)
employee.deductions[].kindtextneVýživné, jiná přednostní pohledávka, exekuce (nepřednostní), insolvence – oddlužení, dohoda o srážkách Hodnoty: maintenance, priority, execution, insolvency, agreement.
employee.deductions[].labeltextnePlátce nebo věřitel, povinné
employee.deductions[].referencetextneSpisová značka
employee.deductions[].received_ondatumneDatum doručení – pořadí a začátek srážek (od dalšího měsíce); povinné kromě dohody
employee.deductions[].totalčísloneDlužná částka; prázdné = bez omezení
employee.deductions[].monthlyčísloneMěsíční částka (běžné výživné, dohoda); u dohody povinná
employee.deductions[].accounttextneÚčet plátce ve tvaru [předčíslí-]číslo/kód banky
employee.deductions[].variable_symboltextneVariabilní symbol platby
employee.deductions[].specific_symboltextneSpecifický symbol
employee.deductions[].constant_symboltextneKonstantní symbol
employee.deductions[].fromtextneSrážet od měsíce RRRR-MM (jinak od měsíce po doručení)
employee.deductions[].totextneSrážet do měsíce RRRR-MM
employee.detailsobjektneÚ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.details.oictextneOIČ (IK MPSV) z registrace zaměstnance – 10 číslic
employee.details.employment_idtextneID pracovněprávního vztahu z registrace – až 22 číslic
employee.details.birth_datedatumneDatum narození
employee.details.birth_numbertextneRodné číslo bez lomítka; spojuje karty téže osoby (maximální základ, úhrn DPP, jedna záloha); neplatné skončí chybou 422
employee.details.activity_codetextneDruh činnosti podle registrace (1–9 pracovní poměr, A–J DPČ, T–ZC DPP)
employee.details.eldp_codetextneKód ELDP
employee.details.primaryano/nenePrimární pracovněprávní vztah u zaměstnavatele
employee.details.workplaceobjektneMísto výkonu práce
employee.details.workplace.municipalitytextneObec
employee.details.workplace.municipality_codetextneKód obce, 6 číslic (číselník ČSÚ)
employee.details.workplace.countrytextneStát, dvoupísmenný kód (např. CZ)
employee.details.weekly_hoursčísloneSjednaná týdenní pracovní doba (hodin, nejvýše 40); fond pracovní doby, krácení a doplatek do minimální mzdy
employee.details.wage_kindtextneDruh mzdy; hourly = hourly_rate × odpracované hodiny Hodnoty: monthly, hourly.
employee.details.meal_allowance_ratečísloneStravenkový paušál v Kč za směnu (bez daně do limitu roku)
employee.details.company_carobjektneSlužební auto i pro soukromé účely (nepeněžní příjem 1 %, 0,5 % nízkoemisní, 0,25 % bezemisní, aspoň 1 000 Kč)
employee.details.company_car.pricečísloneVstupní cena včetně DPH
employee.details.company_car.emissiontextneDruh pohonu Hodnoty: standard, low, zero.
employee.details.company_car.asset_idcelé čísloneKarta majetku firmy (cizí karta skončí chybou 422)
employee.details.vacation_weeksčísloneNárok na dovolenou v týdnech za rok (prázdné = 4)
employee.details.dependantscelé číslonePočet vyživovaných osob pro nezabavitelnou částku (prázdné = počet dětí)
employee.details.standard_weekly_hoursčísloneStanovená týdenní pracovní doba podle § 79 zákoníku práce
employee.details.monthly_hoursčísloneSjednaný rozsah dohody za měsíc (hodin)
employee.details.hourly_ratečísloneHodinová mzda nebo odměna z dohody (Kč)
employee.details.average_hourly_earningsčíslonePrůměrný hodinový výdělek (Kč); prázdné = Saldo ho spočítá z předchozího čtvrtletí
employee.details.garnishmentano/neneSrážky ze mzdy vedené mimo Saldo (srážky v deductions hlášení vykáže samo)
employee.details.shared_childrenano/neneTytéž děti vyživuje i jiná osoba ve společné domácnosti
employee.details.other_parentobjektneJiná osoba vyživující tytéž děti
employee.details.other_parent.first_nametextneJméno
employee.details.other_parent.last_nametextnePříjmení
employee.details.other_parent.birth_datedatumneDatum narození
employee.details.other_parent.birth_numbertextneRodné číslo
employee.details.functional_emolumentsano/neneFunkční požitky podle § 6 odst. 10 ZDP
employee.details.pensionerano/nenePoživatel starobního důchodu – sleva 6,5 % na sociálním pojistném zaměstnance (od 2025)
employee.details.health_minimum_exemptano/nenePo 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

StavKódKdy
403PAYROLL_ACCESSVolají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/employees

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Odpověď

200 application/json Pole pracovníků.

PoleVýznam
idID pracovníka (employee_id v cestách a jízdách)
full_nameJmé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/names

JavaScript

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();
Odpověď 200 OK
[
  {
    "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
employeeobjektano
employee.first_nametextneJméno, nejvýše 80 znaků
employee.last_nametextnePříjmení, nejvýše 80 znaků
employee.personal_numbertextneOsobní číslo
employee.contracttextnehpp pracovní poměr, dpc dohoda o pracovní činnosti, dpp dohoda o provedení práce Hodnoty: hpp, dpc, dpp.
employee.gross_wagečísloneSjednaná měsíční hrubá mzda (HPP) nebo měsíční odměna (DPČ, DPP), nejméně 0
employee.started_ondatumneDatum nástupu; neplatné datum se uloží jako prázdné
employee.ended_ondatumneDatum ukončení; pásky se generují jen za měsíce, kdy vztah trval
employee.declarationano/nenePodepsané prohlášení poplatníka
employee.disabilitytextneInvalidita: first I. nebo II. stupně, third III. stupně; prázdné = žádná Hodnoty: first, third.
employee.ztppano/neneDržitel průkazu ZTP/P
employee.studentano/neneStudent – projeví se jen ve zdravotním pojištění
employee.health_insurertextneKód zdravotní pojišťovny Hodnoty: 111, 201, 205, 207, 209, 211, 213.
employee.bank_accounttextneČíslo účtu pracovníka (jen evidence)
employee.emailtextneE-mail v platném tvaru
employee.notetextnePoznámka
employee.childrenpole (objekt)neDěti pro daňové zvýhodnění; odeslaný seznam nahradí uložený celý
employee.children[].ordercelé číslonePořadí dítěte 1, 2 nebo 3; jiná hodnota skončí chybou 422
employee.children[].fromtextneZvýhodnění od měsíce RRRR-MM
employee.children[].totextneZvýhodnění do měsíce RRRR-MM
employee.children[].ztppano/neneDítě je držitelem průkazu ZTP/P
employee.children[].monthspole (celé číslo)neMěsíce 1–12, za které se zvýhodnění uplatní; bez pole každý měsíc
employee.children[].first_nametextneJméno dítěte
employee.children[].last_nametextnePříjmení dítěte
employee.children[].birth_datedatumneDatum narození dítěte
employee.children[].birth_numbertextneRodné číslo dítěte
employee.detailsobjektneÚ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_fromtextneMimo 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_notetextneMimo objekt employee: poznámka ke změně výměru (nejvýše 200 znaků)
valid_keyspole (text)neMimo 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

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

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.

Odpověď

204 Prázdná odpověď.

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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/3

JavaScript

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();
Odpověď 204 No Content
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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.
yeardotazcelé čísloneRok; bez parametru aktuální rok Rozsah od 2000 do 2100. Příklad 2026.

Odpověď

200 application/json Mzdový list.

PoleVýznam
employeeid, name, personal_number, birth_number, birth_date, contract, started_on, ended_on, insurer, children, terms (výměr v prosinci)
rowsMě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
totalsRoční součty částek
credits, child_benefit, declaration_months, hoursRoční součty slev a zvýhodnění, měsíce s prohlášením a hodiny

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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.
monthdotazcelé čísloneMě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.

PoleVýznam
id, employee_id, employee_name, year, monthPáska a pracovník
gross, net, employer_costHrubá mzda, čistá mzda a celkové náklady zaměstnavatele v Kč
statusdraft, approved nebo posted
dataVý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

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
[
  {
    "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
yearcelé čísloneRok sazeb; bez hodnoty aktuální rok
monthcelé čísloneMěsíc 1–12; bez hodnoty aktuální měsíc; jiná hodnota skončí chybou 422
contracttextneDruh pracovněprávního vztahu; jiná hodnota skončí chybou 422 Hodnoty: hpp, dpc, dpp. Výchozí hpp.
grossčísloneHrubá mzda v Kč, nezáporná (záporná skončí chybou 422); bez hodnoty nebo nečíselná 0
pensioner_discountano/neneSleva 6,5 % pro pracujícího důchodce
health_minimum_exemptano/neneBez doplatku do minimálního vyměřovacího základu ZP
agreed_wagečísloneSjednaná částka pro účast zaměstnání malého rozsahu
ytd_social_basečísloneVyměřovací základ sociálního pojištění od začátku roku (pro maximální základ)
employed_dayscelé čísloneKalendářní dny zaměstnání v měsíci (krácení minimálního základu ZP)
declarationano/nenePodepsané prohlášení poplatníka Výchozí true.
disabilitytextneStupeň 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.
ztppano/neneDržitel průkazu ZTP/P Výchozí false.
studentano/neneStudent Výchozí false.
childrenpole (objekt)neDěti pro daňové zvýhodnění (uplatní se ve všech měsících)
children[].ordercelé číslonePořadí dítěte (1, 2, 3)
children[].ztppano/neneDítě je držitelem průkazu ZTP/P
children[].monthspole (celé číslo)neMěsíce, za které se zvýhodnění uplatní

Odpověď

200 application/json Výpočet výplatní pásky.

PoleVýznam
gross, taxable, insurableHrubá mzda, zdanitelný příjem a příjem pro pojistné (zde stejné)
insuredÚčast na pojištění: social, health
assessment_baseVyměřovací základy: social, health
employee, employerPojistné zaměstnance a zaměstnavatele: social, health, total
health_min_base_topupDoplatek zdravotního pojistného do minimálního vyměřovacího základu
taxDaň: base, rounded_base, rate_split, advance_before_credits, credits, child_benefit (total, as_credit, bonus), advance, withholding, kind (advance nebo withholding)
netČistá mzda
payoutK výplatě: čistá mzda plus daňový bonus
employer_costHrubá mzda plus pojistné zaměstnavatele
postingsÚčetní předpis, který by se zaúčtoval: debit, credit, amount, text
warningsUpozornění (česky)

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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/calculate

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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.

PoleTypPovinnéPopis
monthcelé čísloanoMě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í.

PoleVýznam
year, monthObdobí
payslipsPá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, skippedPoč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_postedJména pracovníků, jejichž nezaúčtovanou pásku výpočet smazal, a těch, jejichž zaúčtovaná páska mimo vztah zůstala
warningsUpozornění: výpočet dopředu, podané hlášení JMHZ za měsíc

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 201 Created
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID výplatní pásky Příklad 41.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
absencespole (objekt)neNepřítomnosti v měsíci pásky
absences[].kindtextneNemoc/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[].fromdatumnePrvní den (v měsíci pásky)
absences[].todatumnePoslední den; prázdné = from
absences[].hoursčísloneHodiny místo celých pracovních dnů
absences[].began_ondatumneU nemoci pokračující z minulého měsíce její začátek (14 dní náhrady)
itemspole (objekt)neSložky mzdy
items[].kindtextneDruh složky Hodnoty: worked_hours, overtime, night, weekend, holiday_work, bonus, bonus_regular, other, meal_allowance, benefit_taxable, benefit_exempt.
items[].hoursčísloneHodiny (worked_hours, overtime, night, weekend, holiday_work)
items[].amountčísloneČástka v Kč (bonus, bonus_regular, other, benefit_taxable, benefit_exempt)
items[].countčíslonePočet směn (meal_allowance)
items[].ratečísloneSazba stravenkového paušálu za směnu (jinak z karty)
items[].categorytextneDruh osvobozeného benefitu Hodnoty: leisure, health.
items[].labeltextnePopis na pásce
grossčísloneRuční základní hrubá mzda pásky v Kč místo výměru; null nebo prázdné ji zruší
bonusesčísloneJednorázové prémie v Kč (stejné jako složka bonus)
statustextneStav pásky; zaúčtování provede POST …/post_entries Hodnoty: draft, approved.
attendanceobjektneDocházka pro JMHZ; prázdné hodnoty se vynechají, desetinná čárka je dovolena, jiné klíče se zahodí
attendance.worked_hoursčísloneOdpracované hodiny
attendance.overtime_hoursčíslonePřesčasové hodiny (z odpracovaných)
attendance.overtime_payčíslonePříplatky za práci přesčas (Kč)
attendance.vacation_hoursčísloneHodiny čerpané dovolené
attendance.vacation_payčísloneNáhrada mzdy za dovolenou (Kč)
attendance.unpaid_hoursčísloneHodiny neplaceného volna

Odpověď

200 application/json Upravená výplatní páska (tvar jako v seznamu).

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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/16

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID výplatní pásky Příklad 41.

Odpověď

204 Prázdná odpověď.

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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/16

JavaScript

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();
Odpověď 204 No Content
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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID výplatní pásky Příklad 41.

Odpověď

200 application/json Zaúčtovaná výplatní páska se stavem posted.

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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_entries

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok; bez parametru aktuální rok Příklad 2026.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
monthcelé čísloanoMěsíc 1–12 Rozsah od 1 do 12.

Odpověď

200 application/json Poslední uzavřený den.

PoleVýznam
closed_untilPoslední den uzavřených mezd (RRRR-MM-DD)

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok; bez parametru aktuální rok Příklad 2026.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
monthcelé čísloanoMěsíc 1–12, od kterého se mzdy otevřou Rozsah od 1 do 12.

Odpověď

200 application/json Poslední uzavřený den.

PoleVýznam
closed_untilPoslední den mezd, které zůstaly uzavřené

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok; bez parametru aktuální rok Příklad 2026.
monthdotazcelé čísloanoMěsíc Rozsah od 1 do 12. Příklad 8.

Odpověď

200 application/json Přehledy mezd za měsíc.

PoleVýznam
year, month, due_date, closed, draftsObdobí, splatnost odvodů, uzavřené mzdy a počet pásek ve stavu draft
rows, totalsPásky (gross, taxable, insurable, social_base, health_base, pojistné, advance, withholding, bonus, net, deductions, exempt, payout, employer_cost) a součty
insurersPo pojišťovnách: code, name, employees, base, employer, employee, total, names
social, taxPojistné ČSSZ jako v JMHZ (base, employer, employee, discount, payable) a daň (advance, bonus, payable, withholding)
noticesNástupy a skončení v měsíci: name, insurer, event (start, end), date, deadline
paymentsVýplaty (kind wage) a srážky (kind deduction): name, account, amount, variable_symbol, specific_symbol, message

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
yearcelé čísloneRok; bez hodnoty aktuální rok
monthcelé čísloanoMěsíc pásek Rozsah od 1 do 12.
bank_account_idcelé čísloanoBankovní účet firmy v CZK, ze kterého se platí
execution_datedatumneDatum splatnosti příkazu, ne v minulosti; bez hodnoty dnes (posunuto na pracovní den)
leviesano/nenePř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

StavKódKdy
403PAYROLL_ACCESSVolají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_order

JavaScript

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();
Odpověď 200 OK
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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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.
monthdotazcelé čísloanoMěsíc hlášení Rozsah od 1 do 12. Příklad 8.

Odpověď

200 application/json Stav a kontrola hlášení JMHZ.

PoleVýznam
year, month, periodObdobí; period ve tvaru RRRR-MM
statenone (nic uloženo), draft (připraveno), filed (řádné označeno jako podané), cancelled (stornováno)
kindDruh, který by se teď vytvořil: regular, nebo corrective po podaném řádném hlášení
readytrue, když kontrola nenašla chyby
errors, warningsNálezy kontroly: level, code, subject, field, message, employee_id
due_date, cancellation_deadline, can_cancelLhůta podání, poslední den pro storno (null, když storno nejde) a zda lze ještě stornovat
payroll_closedtrue, když jsou mzdy za měsíc uzavřené
totalsSouhrny: tax, insurance, payslips a employer_rounding; null pro rok bez sazeb
employments, personsPočet pracovněprávních vztahů a osob v hlášení
submission_id, proof_stateGUID řádného podání a stav doložení posledního podaného hlášení
planJen pro opravné hlášení: corrected, added, cancelled, stale (vztahy podle názvu)
filingsUlož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

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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.
monthdotazcelé čísloanoMěsíc hlášení Rozsah od 1 do 12. Příklad 8.
kinddotaztextneDruh 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

StavKódKdy
403PAYROLL_ACCESSVolají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í.“
403READ_ONLY_KEYAPI klíč jen pro čtení
403CROSS_SITEHlavič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();
Odpověď 200 OK
<?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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
yearcelé čísloneRok hlášení; bez hodnoty aktuální rok, mimo rozsah se zarovná Rozsah od 2000 do 2100.
monthcelé čísloanoMěsíc hlášení Rozsah od 1 do 12.
kindtextneDruh 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.

PoleVýznam
oktrue, když služba vrátila výsledek OK
request_idID požadavku u ČSSZ
errorsNálezy služby: category, code (číslo chyby ČSSZ), message, form (GUID formuláře), employee (pracovník a vztah)
kindKontrolovaný druh hlášení
checked_atČas kontroly

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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/validation

JavaScript

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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneZdaň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.

PoleVýznam
yearZdaňovací období
deadlinesrequest (žádost a doklady), settlement (výpočet), refund_month a refund_year (nejpozdější mzda pro vrácení)
rowsemployee_id (karta, u které jsou podklady), name, contract, ended_on, status, status_label, blockers (počet důvodů, proč nelze), payout, refund_month
countsPočet lidí v každém stavu
refundsSoučet částek naplánovaných nebo vrácených zaměstnancům

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka (kterékoli jeho karty; podklady jsou u jedné karty osoby) Příklad 3.
yeardotazcelé čísloneZdaň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.

PoleVýznam
status, status_label, savedStav jako v přehledu; saved = podklady jsou uložené
inputsPodklady ve tvaru těla PATCH
ownZ pásek firmy: income, advances, bonuses, months, withholding_income, withholding_tax, drafts
resultPrů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, warningsDůvody, proč nelze (code, message), a upozornění
computed, changedUložený výpočet (on, by, result) a zda se od něj pásky nebo podklady změnily
refundmonth nebo outside_on, payslip_id, payslip_status, applied
deadlines, refund_months, abolishedLhůty, měsíce pro vrácení a zrušené odpočty (odbory, zkoušky)
certificateData potvrzení o příjmech: declaration_months, months, income, advances, bonuses, children (orders po pořadí, ztpp), disability, settlement

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.
yeardotazcelé čísloneZdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
settlementobjektnePodklady
settlement.requested_ondatumneDen žádosti (lhůta 15. 2., § 38ch odst. 1)
settlement.declaration_signedano/neneProhlášení k dani za rok podepsané (§ 38k odst. 4 a 5)
settlement.late_declarationano/neneProhlášení podepsané dodatečně – zahrnout i příjmy zdaněné srážkovou daní (§ 38k odst. 7)
settlement.files_returnano/nenePodá nebo je povinen podat daňové přiznání
settlement.other_incomečísloneJiné příjmy podle § 7 až 10 (nad 20 000 Kč nelze)
settlement.execution_creditčísloneSleva za zastavenou exekuci (§ 35 odst. 4)
settlement.disabilitytextneInvalidita I./II. nebo III. stupně Hodnoty: "", first, third.
settlement.disability_monthscelé čísloneMěsíce slevy na invaliditu
settlement.ztpp_monthscelé čísloneMěsíce slevy na držitele ZTP/P
settlement.spouseobjektneSleva na manžela: name, birth_number, income (vlastní příjem za rok), months, ztpp_months, child_under_three
settlement.childrenpoleneDěti: name, birth_number, order (1–3), months, ztpp_months
settlement.deductionsobjektneNezdanitelné čá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.employerspoleneJiní plátci podle potvrzení: name, ico, from, to (měsíce), income (ř. 2), advances (ř. 6), bonuses (ř. 9), declaration, certificate, concurrent
settlement.notetextnePoznámka (nejvýš 500 znaků)

Odpověď

200 application/json Roční zúčtování zaměstnance (tvar jako GET).

Chyby této operace

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.
yeardotazcelé čísloneZdaň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

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 204 No Content
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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.
yeardotazcelé čísloneZdaň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

StavKódKdy
403PAYROLL_ACCESSVolají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();
Odpověď 200 OK
{
  "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_ACCESS bez 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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID pracovníka Příklad 3.
yeardotazcelé čísloneZdaňovací období; bez parametru aktuální rok Rozsah od 2025 do 2100. Příklad 2025.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
monthcelé čísloneMěsíc výplatní pásky následujícího roku (1 až 4)
outside_ondatumneMí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

StavKódKdy
403PAYROLL_ACCESSVolají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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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ů.

PoleVýznam
id, number, employee_id, employee_name, traveller_namePří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_localOdjezd a návrat v českém místním čase, jak byly zadány
status, status_labeldraft (koncept), approved (schváleno), settled (vyúčtováno), paid (proplaceno), cancelled (stornováno)
approved_at, approved_by_id, settled_on, paid_on, cancelled_atKdy a kdo příkaz schválil, vyúčtoval, proplatil nebo stornoval
advance_amount, advance_paid_onVyplacená záloha v Kč a den výplaty
totalNáhrady celkem v Kč včetně zahraničního stravného přepočteného kurzem
input, resultUlož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();
Odpověď 200 OK
[
  {
    "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
tripobjektano
trip.employee_idcelé číslonePracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee
trip.traveller_nametextneJméno cestujícího; bez hodnoty jméno pracovníka
trip.travellertextneemployee 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.purposetextneÚčel cesty; výpočet neovlivní
trip.destinationtextanoMísto cesty; při uložení povinné, nejvýše 200 znaků
trip.departuretextanoOdjezd, 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.arrivaltextanoNávrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm
trip.per_diem_leveltextneVýš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.kmčísloneUjeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá
trip.vehicle_kindtextneSoukromé 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.consumptiončíslonePrůměrná spotřeba na 100 km podle technického průkazu (l nebo kWh)
trip.fueltextneDruh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95.
trip.fuel_pricečísloneCena 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.accommodationčísloneUbytování v Kč, nezáporné
trip.otherčísloneOstatní nutné vedlejší výdaje v Kč, nezáporné
trip.foreign_countrytextneKód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné
trip.hours_abroadčísloneHodiny 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.border_outtextnePřechod hranice při výjezdu, datum a čas v místním čase
trip.border_intextnePřechod hranice při návratu, datum a čas v místním čase
trip.exchange_ratečísloneKurz 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.pocket_moneyano/neneKapesné 40 % zahraničního stravného (§ 180 zákoníku práce)
trip.mealspole (objekt)neBezplatně poskytnutá jídla po dnech, která krátí stravné
trip.meals[].datedatumanoDen cesty (RRRR-MM-DD)
trip.meals[].countcelé čísloanoPočet jídel v daném dni, 0 až 3
trip.meals[].abroadano/nenetrue = jídlo krátí zahraniční stravné, false tuzemské; bez hodnoty podle toho, které stravné za den náleží
trip.advance_amountčísloneVyplacená záloha v Kč (výplatu zaúčtujte z banky nebo pokladny na účet 335)
trip.advance_paid_ondatumneDen výplaty zálohy

Odpověď

201 application/json Uložený cestovní příkaz (tvar jako v seznamu).

Chyby této operace

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

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Odpověď

200 application/json Cestovní příkaz.

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
tripobjektano
trip.employee_idcelé číslonePracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee
trip.traveller_nametextneJméno cestujícího; bez hodnoty jméno pracovníka
trip.travellertextneemployee 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.purposetextneÚčel cesty; výpočet neovlivní
trip.destinationtextanoMísto cesty; při uložení povinné, nejvýše 200 znaků
trip.departuretextanoOdjezd, 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.arrivaltextanoNávrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm
trip.per_diem_leveltextneVýš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.kmčísloneUjeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá
trip.vehicle_kindtextneSoukromé 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.consumptiončíslonePrůměrná spotřeba na 100 km podle technického průkazu (l nebo kWh)
trip.fueltextneDruh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95.
trip.fuel_pricečísloneCena 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.accommodationčísloneUbytování v Kč, nezáporné
trip.otherčísloneOstatní nutné vedlejší výdaje v Kč, nezáporné
trip.foreign_countrytextneKód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné
trip.hours_abroadčísloneHodiny 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.border_outtextnePřechod hranice při výjezdu, datum a čas v místním čase
trip.border_intextnePřechod hranice při návratu, datum a čas v místním čase
trip.exchange_ratečísloneKurz 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.pocket_moneyano/neneKapesné 40 % zahraničního stravného (§ 180 zákoníku práce)
trip.mealspole (objekt)neBezplatně poskytnutá jídla po dnech, která krátí stravné
trip.meals[].datedatumanoDen cesty (RRRR-MM-DD)
trip.meals[].countcelé čísloanoPočet jídel v daném dni, 0 až 3
trip.meals[].abroadano/nenetrue = jídlo krátí zahraniční stravné, false tuzemské; bez hodnoty podle toho, které stravné za den náleží
trip.advance_amountčísloneVyplacená záloha v Kč
trip.advance_paid_ondatumneDen výplaty zálohy

Odpověď

200 application/json Přepočtený cestovní příkaz.

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Odpověď

204 Prázdná odpověď.

Chyby této operace

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

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
advance_paid_ondotazdatumneDen 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.

PoleTypPovinnéPopis
tripobjektano
trip.employee_idcelé číslonePracovník této firmy; neexistující nebo cizí vrátí 404. Jeho zadání přepne výchozí traveller na employee
trip.traveller_nametextneJméno cestujícího; bez hodnoty jméno pracovníka
trip.travellertextneemployee 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.purposetextneÚčel cesty; výpočet neovlivní
trip.destinationtextneMísto cesty; při uložení povinné, nejvýše 200 znaků
trip.departuretextanoOdjezd, 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.arrivaltextanoNávrat ve stejném tvaru; musí být po odjezdu a nejvýš 366 dní po něm
trip.per_diem_leveltextneVýš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.kmčísloneUjeté km soukromým vozidlem; bez hodnoty nebo 0 se náhrada za vozidlo nepočítá
trip.vehicle_kindtextneSoukromé 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.consumptiončíslonePrůměrná spotřeba na 100 km podle technického průkazu (l nebo kWh)
trip.fueltextneDruh paliva Hodnoty: petrol95, petrol98, diesel, lpg, electricity. Výchozí petrol95.
trip.fuel_pricečísloneCena 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.accommodationčísloneUbytování v Kč, nezáporné
trip.otherčísloneOstatní nutné vedlejší výdaje v Kč, nezáporné
trip.foreign_countrytextneKód cílové země (ISO 3166-1 alpha-2, jiný než CZ); zapne zahraniční stravné
trip.hours_abroadčísloneHodiny 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.border_outtextnePřechod hranice při výjezdu, datum a čas v místním čase
trip.border_intextnePřechod hranice při návratu, datum a čas v místním čase
trip.exchange_ratečísloneKurz 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.pocket_moneyano/neneKapesné 40 % zahraničního stravného (§ 180 zákoníku práce)
trip.mealspole (objekt)neBezplatně poskytnutá jídla po dnech, která krátí stravné
trip.meals[].datedatumanoDen cesty (RRRR-MM-DD)
trip.meals[].countcelé čísloanoPočet jídel v daném dni, 0 až 3
trip.meals[].abroadano/nenetrue = 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.

PoleVýznam
duration_hoursDélka cesty v hodinách
per_diemTuzemské stravné: band, rate, reductions, amount a days (po dnech: date, dates, hours, band short/medium/long, range, rate, meals, reductions, amount)
foreign_per_diemZahranič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)
mileageZákladní náhrada: base_rate, km, amount
fuelNáhrada za PHM: type, price, consumption, amount
accommodation, otherZadané výdaje
totalNáhrady celkem v Kč včetně zahraničního stravného a kapesného v Kč
traveller, exchange_rate_source, exchange_rate_dateemployee nebo self_employed; zdroj kurzu cnb nebo manual a den kurzu ČNB
basisPrávní základ použitých sazeb
warningsUpozornění (česky)

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Odpověď

200 application/json Schválený cestovní příkaz (tvar jako v seznamu).

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.
settled_ondotazdatumneDatum 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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Odpověď

200 application/json Cestovní příkaz vrácený k úpravě.

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.
paid_ondotazdatumneDen 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

StavKódKdy
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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID cestovního příkazu Příklad 7.

Odpověď

200 application/json Stornovaný cestovní příkaz.

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
yeardotazcelé čísloneRok 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.
vehicledotaztextneJen jízdy vozidla s tímto názvem (přesná shoda) Příklad Škoda Fabia 2AB 3456.

Odpověď

200 application/json Pole jízd.

PoleVýznam
id, driven_on, start_time, end_timeJízda, datum a časy HH:MM
vehicle, asset_idVozidlo a případně karta firemního auta z Majetku
driver_name, employee_idŘidič a případně pracovník z Mezd
origin, destination, purpose, noteTrasa, účel a poznámka
km, odometer_start, odometer_endUjeté kilometry a stav tachometru
private_usetrue = soukromá jízda
trip_id, trip_number, trip_statusCestovní 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();
Odpověď 200 OK
[
  {
    "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
rideobjektano
ride.asset_idcelé čísloneKarta vozidla z Majetku této firmy
ride.vehicletextneNázev vozidla (značka a SPZ), nejvýše 120 znaků; bez asset_id povinný
ride.employee_idcelé čísloneŘidič – pracovník této firmy
ride.driver_nametextneJméno řidiče, když není pracovníkem
ride.driven_ondatumanoDen jízdy
ride.start_timetextneČas odjezdu HH:MM
ride.end_timetextneČas příjezdu HH:MM, ne dřív než odjezd
ride.origintextneOdkud
ride.destinationtextanoKam, povinné
ride.purposetextneÚčel jízdy
ride.kmčísloneUjeté km, větší než 0 a nejvýš 5 000; se stavem tachometru se musí shodovat
ride.odometer_startcelé čísloneStav tachometru na začátku
ride.odometer_endcelé čísloneStav tachometru na konci, vyšší než na začátku
ride.private_useano/neneSoukromá jízda Výchozí false.
ride.notetextnePoznámka

Odpověď

201 application/json Zapsaná jízda (tvar jako v knize jízd).

Chyby této operace

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

JavaScript

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();
Odpověď 201 Created
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID jízdy Příklad 3.

Tělo požadavku

Formát application/json.

PoleTypPovinnéPopis
rideobjektano
ride.purposetextneÚčel jízdy
ride.kmčísloneUjeté km
ride.private_useano/neneSoukromá jízda
ride.notetextnePoznámka; ostatní pole jako při zápisu

Odpověď

200 application/json Upravená jízda.

Chyby této operace

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

JavaScript

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();
Odpověď 200 OK
{
  "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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID 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/1

JavaScript

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();
Odpověď 204 No Content
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ázevKdeTypPovinnýPopis
entity_idcestacelé čísloanoID účetní jednotky (firmy) Příklad 12.
idcestacelé čísloanoID jízdy Příklad 3.

Odpověď

201 application/json Vytvořený cestovní příkaz (tvar jako v seznamu cest).

Chyby této operace

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

JavaScript

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();
Odpověď 201 Created
{
  "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.