Mzdy

Operace ve skupině Mzdy.

Základní URLhttps://api.damedoklad.cz/v1Přihlášení Chyby a limity Konvence

GET/v1/payroll/accident-insurance
POST/v1/payroll/accident-insurance
GET/v1/payroll/accident-insurance.pdf
POST/v1/payroll/accident-insurance/{id}/cancel
GET/v1/payroll/annual/tax
GET/v1/payroll/annual/tax.pdf
GET/v1/payroll/annual/tax.xml
GET/v1/payroll/annual/tax/corrections
POST/v1/payroll/annual/tax/corrections
PATCH/v1/payroll/annual/tax/corrections/{id}
DEL/v1/payroll/annual/tax/corrections/{id}
GET/v1/payroll/annual/tax/filed
POST/v1/payroll/annual/tax/filed
POST/v1/payroll/annual/tax/supplementary.xml
GET/v1/payroll/annual/withholding.xml
GET/v1/payroll/attendance
PUT/v1/payroll/attendance/{contractId}/{year}/{month}
GET/v1/payroll/bonus-requests
POST/v1/payroll/bonus-requests
DEL/v1/payroll/bonus-requests/{id}
GET/v1/payroll/bonus-requests/{id}/request.pdf
GET/v1/payroll/bonus-requests/{id}/request.xml
GET/v1/payroll/bonus-requests/preview
DEL/v1/payroll/contract-amendments/{id}
GET/v1/payroll/contract-amendments/{id}/amendment.pdf
GET/v1/payroll/contracts
POST/v1/payroll/contracts
GET/v1/payroll/contracts/{id}
PATCH/v1/payroll/contracts/{id}
DEL/v1/payroll/contracts/{id}
GET/v1/payroll/contracts/{id}/allocation
PUT/v1/payroll/contracts/{id}/allocation
GET/v1/payroll/contracts/{id}/amendment.pdf
GET/v1/payroll/contracts/{id}/amendments
POST/v1/payroll/contracts/{id}/amendments
GET/v1/payroll/contracts/{id}/contract.pdf
GET/v1/payroll/contracts/{id}/registration
GET/v1/payroll/contracts/{id}/registration.pdf
GET/v1/payroll/contracts/{id}/registration.xml
GET/v1/payroll/contracts/{id}/service-confirmation.pdf
POST/v1/payroll/contracts/{id}/sick-benefit.xml
GET/v1/payroll/contracts/{id}/unemployment-confirmation.pdf
GET/v1/payroll/contracts/{id}/wage-notice.pdf
GET/v1/payroll/declaration-changes
POST/v1/payroll/declaration-changes/{id}/approve
POST/v1/payroll/declaration-changes/{id}/reject
GET/v1/payroll/deductions
POST/v1/payroll/deductions
PATCH/v1/payroll/deductions/{id}
DEL/v1/payroll/deductions/{id}
GET/v1/payroll/document-templates
PUT/v1/payroll/document-templates/{kind}
DEL/v1/payroll/document-templates/{kind}
GET/v1/payroll/employees
POST/v1/payroll/employees
GET/v1/payroll/employees/{id}
PATCH/v1/payroll/employees/{id}
DEL/v1/payroll/employees/{id}
PUT/v1/payroll/employees/{id}/children
GET/v1/payroll/employees/{id}/discount-notice.xml
GET/v1/payroll/employees/{id}/eldp.pdf
GET/v1/payroll/employees/{id}/income-confirmation.pdf
POST/v1/payroll/employees/{id}/protected-account
GET/v1/payroll/employees/{id}/protected-account.pdf
POST/v1/payroll/employees/{id}/protected-account/end
GET/v1/payroll/employees/{id}/record.pdf
GET/v1/payroll/employees/{id}/self-service-links
POST/v1/payroll/employees/{id}/self-service-links
POST/v1/payroll/employees/import
GET/v1/payroll/employees/import-template.xlsx
POST/v1/payroll/employees/onboard
GET/v1/payroll/health-changes
POST/v1/payroll/health-changes.xdp
POST/v1/payroll/health-changes.xml
POST/v1/payroll/health-changes/marks
DEL/v1/payroll/health-changes/marks/{id}
GET/v1/payroll/holidays
GET/v1/payroll/opening-months
DEL/v1/payroll/opening-months/{id}
GET/v1/payroll/pay-items
POST/v1/payroll/pay-items
PATCH/v1/payroll/pay-items/{id}
DEL/v1/payroll/pay-items/{id}
PUT/v1/payroll/pay-items/{id}/assignments
GET/v1/payroll/pay-items/statutory
GET/v1/payroll/payments
POST/v1/payroll/payments/{id}/paid
POST/v1/payroll/payments/{id}/unpaid
POST/v1/payroll/preview/gross-to-net
POST/v1/payroll/preview/net-to-gross
GET/v1/payroll/rates
GET/v1/payroll/reports/annual
GET/v1/payroll/reports/costs
GET/v1/payroll/reports/wage-sheet
GET/v1/payroll/reports/wage-sheet.pdf
GET/v1/payroll/runs
POST/v1/payroll/runs
GET/v1/payroll/runs/{id}
PATCH/v1/payroll/runs/{id}
DEL/v1/payroll/runs/{id}
GET/v1/payroll/runs/{id}/filings
POST/v1/payroll/runs/{id}/filings/{kind}/submitted
GET/v1/payroll/runs/{id}/filings/health.aap
GET/v1/payroll/runs/{id}/filings/health.pdf
GET/v1/payroll/runs/{id}/filings/health.xml
GET/v1/payroll/runs/{id}/filings/jmhz.xml
GET/v1/payroll/runs/{id}/filings/social.pdf
GET/v1/payroll/runs/{id}/filings/tax.pdf
POST/v1/payroll/runs/{id}/lock
POST/v1/payroll/runs/{id}/payment-orders
GET/v1/payroll/runs/{id}/payslips/{itemId}/pdf
POST/v1/payroll/runs/{id}/payslips/{itemId}/send
POST/v1/payroll/runs/{id}/payslips/send
POST/v1/payroll/runs/{id}/recalculate
POST/v1/payroll/runs/{id}/reopen
POST/v1/payroll/runs/{id}/review
POST/v1/payroll/runs/{id}/unlock
POST/v1/payroll/self-service-links/{id}/revoke
GET/v1/payroll/settings
PUT/v1/payroll/settings
GET/v1/payroll/settlements
POST/v1/payroll/settlements
GET/v1/payroll/settlements/{id}
PATCH/v1/payroll/settlements/{id}
DEL/v1/payroll/settlements/{id}
POST/v1/payroll/settlements/{id}/approve
POST/v1/payroll/settlements/{id}/calculate
GET/v1/payroll/settlements/{id}/calculation.pdf
POST/v1/payroll/settlements/{id}/reopen
POST/v1/payroll/settlements/preview
GET/v1/payroll/sick-notes
POST/v1/payroll/sick-notes/{id}/hzupn.xml
GET/v1/payroll/sick-notes/direct
POST/v1/payroll/sick-notes/direct
POST/v1/payroll/sick-notes/direct/{id}/poll
POST/v1/payroll/sick-notes/import
POST/v1/payroll/sick-notes/insert

Statutory employer liability insurance of a year (vyhláška 125/1993 Sb.), by quarter: what is raised, what would be raised, and why not yet. The decree has no advances and no annual settlement: each quarter stands on the previous quarter's bases

GET/v1/payroll/accident-insurance

Statutory employer liability insurance of a year (vyhláška 125/1993 Sb.), by quarter: what is raised, what would be raised, and why not yet. The decree has no advances and no annual settlement: each quarter stands on the previous quarter's bases

Nástroj MCP: get-payroll-accident-insurance

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

yearintegerpovinné

insurernull | stringpovinné

okecnull | stringpovinné

ratePermillenull | numberpovinné

quartersobject[]povinné

quarterinteger | nullpovinné

premiumanypovinné

Null in every recorded response.

previewnull | objectpovinné

yearintegerpovinné

quarterinteger | nullpovinné

basisstringpovinné

baseHalerinteger | nullpovinné

ratePermillenumberpovinné

amountHalerinteger | nullpovinné

minimumAppliedbooleanpovinné

dueDatenull | stringpovinnédate

problemsstring[]povinné

totalHalerinteger | nullpovinné

GET/v1/payroll/accident-insurance

curl https://api.damedoklad.cz/v1/payroll/accident-insurance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/accident-insurance', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/accident-insurance",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Raise a quarter's premium as an Ostatní závazek to the insurer: MD 548 / D 325 in double entry, an expense when paid in the cash book. Goes on a payment order like any other payable. A company that moved here mid-year states the previous quarter's base

POST/v1/payroll/accident-insurance

Raise a quarter's premium as an Ostatní závazek to the insurer: MD 548 / D 325 in double entry, an expense when paid in the cash book. Goes on a payment order like any other payable. A company that moved here mid-year states the previous quarter's base

Nástroj MCP: create-payroll-accident-premium

Tělo požadavku

yearintegerpovinnémin 2000max 2100

quarterintegerpovinnémin 1max 4

baseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

yearintegerpovinné

quarterintegerpovinné

insurerstringpovinné

basisstringpovinné

baseHalerintegerpovinné

ratePermillenumberpovinné

amountHalerintegerpovinné

dueDatestringpovinnédate

documentIdstringpovinné

documentNumbernull | stringpovinné

POST/v1/payroll/accident-insurance

curl -X POST https://api.damedoklad.cz/v1/payroll/accident-insurance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "quarter": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/accident-insurance', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "quarter": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/accident-insurance",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "quarter": 1
    },
)
data = response.json()

Overview of a year's premiums as PDF. An employer must be able to prove what was paid and how it was worked out (§ 12 odst. 7 vyhlášky 125/1993 Sb.)

GET/v1/payroll/accident-insurance.pdf

Overview of a year's premiums as PDF. An employer must be able to prove what was paid and how it was worked out (§ 12 odst. 7 vyhlášky 125/1993 Sb.)

Nástroj MCP: get-payroll-accident-insurance-pdf

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/accident-insurance.pdf

curl https://api.damedoklad.cz/v1/payroll/accident-insurance.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/accident-insurance.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/accident-insurance.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Withdraw a raised premium, so a wrong quarter can be raised again: cancels its Ostatní závazek, which must not be paid

POST/v1/payroll/accident-insurance/{id}/cancel

Withdraw a raised premium, so a wrong quarter can be raised again: cancels its Ostatní závazek, which must not be paid

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: cancel-payroll-accident-premium

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

POST/v1/payroll/accident-insurance/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/payroll/accident-insurance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/accident-insurance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/accident-insurance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Figures for the annual tax settlement (Vyúčtování daně) by month, from locked runs

GET/v1/payroll/annual/tax

Figures for the annual tax settlement (Vyúčtování daně) by month, from locked runs

Nástroj MCP: get-payroll-annual-tax

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

yearintegerpovinné

monthsobject[]povinné

runIdnull | stringpovinné

monthinteger | nullpovinné

employeeCountintegerpovinné

taxableHalerintegerpovinné

advanceHalerintegerpovinné

bonusHalerintegerpovinné

advancePayableHalerintegerpovinné

withholdingTaxHalerintegerpovinné

GET/v1/payroll/annual/tax

curl https://api.damedoklad.cz/v1/payroll/annual/tax \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/tax",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Working paper for the annual tax settlement as PDF. The EPO file is `tax.xml`

GET/v1/payroll/annual/tax.pdf

Working paper for the annual tax settlement as PDF. The EPO file is `tax.xml`

Nástroj MCP: get-payroll-annual-tax-pdf

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/annual/tax.pdf

curl https://api.damedoklad.cz/v1/payroll/annual/tax.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/tax.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Vyúčtování daně z příjmů ze závislé činnosti as EPO XML (DPZVD6 09.03.01) for a whole year, with Přílohy 1 to 4. Valid against the official XSD; the portal runs further checks. Refused from 2027, when the Vyúčtování is abolished. A dodatečné one is a separate operation

GET/v1/payroll/annual/tax.xml

Vyúčtování daně z příjmů ze závislé činnosti as EPO XML (DPZVD6 09.03.01) for a whole year, with Přílohy 1 to 4. Valid against the official XSD; the portal runs further checks. Refused from 2027, when the Vyúčtování is abolished. A dodatečné one is a separate operation

Nástroj MCP: get-payroll-annual-tax-xml

Parametry dotazu

yearintegerpovinnémin 2000max 2100

type"B" | "O"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/annual/tax.xml

curl https://api.damedoklad.cz/v1/payroll/annual/tax.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/tax.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Corrections of advances, tax, and bonuses under § 38i ZDP that go on Příloha 3 and 4 of the Vyúčtování

GET/v1/payroll/annual/tax/corrections

Corrections of advances, tax, and bonuses under § 38i ZDP that go on Příloha 3 and 4 of the Vyúčtování

Nástroj MCP: list-payroll-tax-corrections

Parametry dotazu

yearintegermin 2000max 2100

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"payroll_tax_correction"povinné

idstringpovinné

employeeIdnull | stringpovinné

subjectstringpovinné

wrongYearintegerpovinné

wrongMonthinteger | nullpovinné

dueDatenull | stringpovinnédate

correctedYearintegerpovinné

correctedMonthintegerpovinné

settledOnnull | stringpovinnédate

bonusRequestedOnstring | nullpovinné

amountHalerintegerpovinné

notenull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/annual/tax/corrections

curl https://api.damedoklad.cz/v1/payroll/annual/tax/corrections \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/corrections', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/corrections",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record a correction under § 38i ZDP. A returned amount is negative, a debt positive, as the annex states it. It does not change a locked run or pay anything

POST/v1/payroll/annual/tax/corrections

Record a correction under § 38i ZDP. A returned amount is negative, a debt positive, as the annex states it. It does not change a locked run or pay anything

Nástroj MCP: create-payroll-tax-correction

Tělo požadavku

employeeIdstring | null

ID of the employee.

subject"advance" | "tax" | "monthly_bonus" | "settlement_bonus"povinné

wrongYearintegerpovinnémin 2000max 2100

wrongMonthinteger | null

dueDatestring | null

Date as YYYY-MM-DD.

correctedYearintegerpovinnémin 2000max 2100

correctedMonthintegerpovinnémin 1max 12

settledOnstring | null

Date as YYYY-MM-DD.

bonusRequestedOnstring | null

Date as YYYY-MM-DD.

amountHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

notestring | null

Odpověď · 201

idstringpovinné

employeeIdnull | stringpovinné

subjectstringpovinné

wrongYearintegerpovinné

wrongMonthinteger | nullpovinné

dueDatenull | stringpovinnédate

correctedYearintegerpovinné

correctedMonthintegerpovinné

settledOnnull | stringpovinnédate

bonusRequestedOnstring | nullpovinné

amountHalerintegerpovinné

notenull | stringpovinné

POST/v1/payroll/annual/tax/corrections

curl -X POST https://api.damedoklad.cz/v1/payroll/annual/tax/corrections \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "advance",
  "wrongYear": 2026,
  "correctedYear": 2026,
  "correctedMonth": 1,
  "amountHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/corrections', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "subject": "advance",
    "wrongYear": 2026,
    "correctedYear": 2026,
    "correctedMonth": 1,
    "amountHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/corrections",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "subject": "advance",
        "wrongYear": 2026,
        "correctedYear": 2026,
        "correctedMonth": 1,
        "amountHaler": 1210000
    },
)
data = response.json()

Change a recorded correction under § 38i ZDP

PATCH/v1/payroll/annual/tax/corrections/{id}

Change a recorded correction under § 38i ZDP

Nástroj MCP: update-payroll-tax-correction

Parametry v cestě

idstringpovinné

Tělo požadavku

employeeIdstring | null

ID of the employee.

subject"advance" | "tax" | "monthly_bonus" | "settlement_bonus"

wrongYearintegermin 2000max 2100

wrongMonthinteger | null

dueDatestring | null

Date as YYYY-MM-DD.

correctedYearintegermin 2000max 2100

correctedMonthintegermin 1max 12

settledOnstring | null

Date as YYYY-MM-DD.

bonusRequestedOnstring | null

Date as YYYY-MM-DD.

amountHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

notestring | null

Odpověď · 200

idstringpovinné

employeeIdnull | stringpovinné

subjectstringpovinné

wrongYearintegerpovinné

wrongMonthinteger | nullpovinné

dueDatenull | stringpovinnédate

correctedYearintegerpovinné

correctedMonthintegerpovinné

settledOnnull | stringpovinnédate

bonusRequestedOnstring | nullpovinné

amountHalerintegerpovinné

notenull | stringpovinné

PATCH/v1/payroll/annual/tax/corrections/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "subject": "advance",
  "wrongYear": 2026
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "subject": "advance",
    "wrongYear": 2026
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "subject": "advance",
        "wrongYear": 2026
    },
)
data = response.json()

Delete a recorded correction under § 38i ZDP

DELETE/v1/payroll/annual/tax/corrections/{id}

Delete a recorded correction under § 38i ZDP

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-tax-correction

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/annual/tax/corrections/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/corrections/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Recorded filings of the Vyúčtování for a year, with what each of them said

GET/v1/payroll/annual/tax/filed

Recorded filings of the Vyúčtování for a year, with what each of them said

Nástroj MCP: list-payroll-annual-tax-filings

Parametry dotazu

yearintegerpovinnémin 2000max 2100

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"payroll_annual_tax_filing"povinné

idstringpovinné

yearintegerpovinné

typestringpovinné

submittedAtnull | stringpovinnédate-time

notestring | nullpovinné

column9integer[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/annual/tax/filed

curl https://api.damedoklad.cz/v1/payroll/annual/tax/filed \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/filed', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/filed",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record that a Vyúčtování was filed and keep what it said, so a dodatečné one can be compared to it. DameDoklad does not submit it for you

POST/v1/payroll/annual/tax/filed

Record that a Vyúčtování was filed and keep what it said, so a dodatečné one can be compared to it. DameDoklad does not submit it for you

Nástroj MCP: record-payroll-annual-tax-filing

Tělo požadavku

yearintegerpovinnémin 2000max 2100

type"B" | "O" | "D" | "E"

filedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

yearintegerpovinné

typestringpovinné

submittedAtnull | stringpovinnédate-time

notestring | nullpovinné

column9integer[]povinné

POST/v1/payroll/annual/tax/filed

curl -X POST https://api.damedoklad.cz/v1/payroll/annual/tax/filed \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "filedOn": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/filed', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "filedOn": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/filed",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "filedOn": "2026-10-30"
    },
)
data = response.json()

Dodatečné or dodatečné opravné Vyúčtování (§ 141 daňového řádu) as EPO XML: all months in full, sloupec 10 as the difference against what was filed, and the reasons. Needs a recorded filing of that year or the filed sloupec 9 by month

POST/v1/payroll/annual/tax/supplementary.xml

Dodatečné or dodatečné opravné Vyúčtování (§ 141 daňového řádu) as EPO XML: all months in full, sloupec 10 as the difference against what was filed, and the reasons. Needs a recorded filing of that year or the filed sloupec 9 by month

Nástroj MCP: create-payroll-supplementary-tax-xml

Tělo požadavku

yearintegerpovinnémin 2000max 2100

type"D" | "E"

discoveredOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

reasonsstringpovinnémax 5000 chars

filedColumn9integer[]

Odpověď · 200

Vrací soubor application/xml.

POST/v1/payroll/annual/tax/supplementary.xml

curl -X POST https://api.damedoklad.cz/v1/payroll/annual/tax/supplementary.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "discoveredOn": "2026-10-30",
  "reasons": "string"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/tax/supplementary.xml', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "discoveredOn": "2026-10-30",
    "reasons": "string"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/annual/tax/supplementary.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "discoveredOn": "2026-10-30",
        "reasons": "string"
    },
)
content = response.content

Vyúčtování daně vybírané srážkou as EPO XML (DPSVD2 09.04.01) for income of natural persons in a whole year. Valid against the official XSD; the portal runs further checks

GET/v1/payroll/annual/withholding.xml

Vyúčtování daně vybírané srážkou as EPO XML (DPSVD2 09.04.01) for income of natural persons in a whole year. Valid against the official XSD; the portal runs further checks

Nástroj MCP: get-payroll-annual-withholding-xml

Parametry dotazu

yearintegerpovinnémin 2000max 2100

type"B" | "O"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/annual/withholding.xml

curl https://api.damedoklad.cz/v1/payroll/annual/withholding.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/annual/withholding.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/annual/withholding.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Get the attendance grid of a month: calendar with holidays and one row per contract, with hours and remaining vacation

GET/v1/payroll/attendance

Get the attendance grid of a month: calendar with holidays and one row per contract, with hours and remaining vacation

Nástroj MCP: get-payroll-attendance

Parametry dotazu

yearintegerpovinnémin 2000max 2100

monthintegerpovinnémin 1max 12

Odpověď · 200

yearintegerpovinné

monthinteger | nullpovinné

lockedbooleanpovinné

fundDaysintegerpovinné

calendarobject[]povinné

dayintegerpovinné

weekdayintegerpovinné

isWeekendbooleanpovinné

holidaynull | stringpovinné

rowsobject[]povinné

contractIdnull | stringpovinné

allocationMethodstringpovinné

employeeIdnull | stringpovinné

employeeNamestringpovinné

typestringpovinné

positionnull | stringpovinné

wageTypestringpovinné

scheduledbooleanpovinné

dailyMilliintegerpovinné

startDatestringpovinnédate

endDatestring | nullpovinné

daysobjectpovinné

workedHoursMilliintegerpovinné

extraShiftsintegerpovinné

overtimeMilliintegerpovinné

nightMilliintegerpovinné

weekendMilliintegerpovinné

holidayWorkedMilliintegerpovinné

difficultMilliintegerpovinné

bonusHalerintegerpovinné

otherTaxableHalerintegerpovinné

otherExemptHalerintegerpovinné

allocationany[]povinné

notestring | nullpovinné

summarynull | objectpovinné

fromstringpovinnédate

tostringpovinnédate

activebooleanpovinné

employedDaysintegerpovinné

calendarDaysintegerpovinné

fundFullMilliintegerpovinné

fundEmployedMilliintegerpovinné

workedMilliintegerpovinné

weekendWorkedMilliintegerpovinné

holidayWorkedMilliintegerpovinné

holidayMilliintegerpovinné

vacationMilliintegerpovinné

sickPaidMilliintegerpovinné

sickUnpaidMilliintegerpovinné

ocrMilliintegerpovinné

paidLeaveMilliintegerpovinné

unpaidLeaveMilliintegerpovinné

absentMilliintegerpovinné

obstacleMilliintegerpovinné

absenceInFundMilliintegerpovinné

sickDaysintegerpovinné

ocrDaysintegerpovinné

healthExcludedDaysintegerpovinné

workedDaysintegerpovinné

shiftsintegerpovinné

sickStreakAtEndintegerpovinné

vacationEntitlementMilliintegerpovinné

vacationUsedMilliintegerpovinné

earlierMonthsany[]

tipsHalerinteger

severanceHalerinteger

damagesHalerinteger

tipsExemptHalerinteger | null

GET/v1/payroll/attendance

curl https://api.damedoklad.cz/v1/payroll/attendance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/attendance', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/attendance",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save a contract's attendance for a month: day codes (vacation, sick, ocr, paid_leave, unpaid_leave, ...), overtime, premiums, bonus

PUT/v1/payroll/attendance/{contractId}/{year}/{month}

Save a contract's attendance for a month: day codes (vacation, sick, ocr, paid_leave, unpaid_leave, ...), overtime, premiums, bonus

Nástroj MCP: save-payroll-attendance

Parametry v cestě

contractIdstringpovinné

ID of the contract. Find it with list-contracts.

yearstringpovinné

monthstringpovinné

Tělo požadavku

daysobject

workedHoursMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

extraShiftsintegermin 0max 62

overtimeMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

nightMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

weekendMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

holidayWorkedMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

difficultMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

bonusHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

otherTaxableHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

otherExemptHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

severanceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

damagesHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

tipsHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

tipsExemptHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

earlierMonthsobject[]

monthintegerpovinnémin 1max 11

taxableHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

allocationobject[]

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

hoursMilliintegerpovinnémin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

notestring | null

Odpověď · 200

idstringpovinné

contractIdstringpovinné

yearintegerpovinné

monthintegerpovinné

daysobjectpovinné

workedHoursMilliintegerpovinné

extraShiftsintegerpovinné

overtimeMilliintegerpovinné

nightMilliintegerpovinné

weekendMilliintegerpovinné

holidayWorkedMilliintegerpovinné

difficultMilliintegerpovinné

bonusHalerintegerpovinné

otherTaxableHalerintegerpovinné

otherExemptHalerintegerpovinné

allocationobject[]povinné

centerIdstring | nullpovinné

activityIdnull | stringpovinné

projectIdstring | nullpovinné

hoursMilliintegerpovinné

notestring | nullpovinné

summarynull | objectpovinné

fromstringpovinnédate

tostringpovinnédate

activebooleanpovinné

employedDaysintegerpovinné

calendarDaysintegerpovinné

fundFullMilliintegerpovinné

fundEmployedMilliintegerpovinné

workedMilliintegerpovinné

weekendWorkedMilliintegerpovinné

holidayWorkedMilliintegerpovinné

holidayMilliintegerpovinné

vacationMilliintegerpovinné

sickPaidMilliintegerpovinné

sickUnpaidMilliintegerpovinné

ocrMilliintegerpovinné

paidLeaveMilliintegerpovinné

unpaidLeaveMilliintegerpovinné

absentMilliintegerpovinné

obstacleMilliintegerpovinné

absenceInFundMilliintegerpovinné

sickDaysintegerpovinné

ocrDaysintegerpovinné

healthExcludedDaysintegerpovinné

workedDaysintegerpovinné

shiftsintegerpovinné

sickStreakAtEndintegerpovinné

earlierMonthsobject[]

monthintegerpovinné

taxableHalerintegerpovinné

tipsHalerinteger

severanceHalerinteger

damagesHalerinteger

tipsExemptHalerinteger | null

PUT/v1/payroll/attendance/{contractId}/{year}/{month}

curl -X PUT https://api.damedoklad.cz/v1/payroll/attendance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "days": {},
  "workedHoursMilli": 1000,
  "extraShifts": 0
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/attendance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "days": {},
    "workedHoursMilli": 1000,
    "extraShifts": 0
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/attendance/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "days": {},
        "workedHoursMilli": 1000,
        "extraShifts": 0
    },
)
data = response.json()

List requests for a tax bonus paid from own funds

GET/v1/payroll/bonus-requests

List requests for a tax bonus paid from own funds

Nástroj MCP: list-payroll-bonus-requests

Parametry dotazu

yearintegerpovinnémin 2000max 2100

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/bonus-requests

curl https://api.damedoklad.cz/v1/payroll/bonus-requests \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record a request for a tax bonus paid from own funds. The amount then stops counting against later months' advances. Refused once the next month has already taken it off. You file the XML yourself

POST/v1/payroll/bonus-requests

Record a request for a tax bonus paid from own funds. The amount then stops counting against later months' advances. Refused once the next month has already taken it off. You file the XML yourself

Nástroj MCP: create-payroll-bonus-request

Tělo požadavku

kind"monthly" | "settlement"povinné

type"regular" | "additional"

yearintegerpovinnémin 2000max 2100

monthintegermin 1max 12

requestedHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

filedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

kindstringpovinné

typestringpovinné

yearintegerpovinné

monthinteger | nullpovinné

totalHalerintegerpovinné

fromAdvancesHalerintegerpovinné

ownFundsHalerintegerpovinné

requestedHalerintegerpovinné

paidOnnull | stringpovinnédate

filedOnstringpovinnédate

POST/v1/payroll/bonus-requests

curl -X POST https://api.damedoklad.cz/v1/payroll/bonus-requests \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "monthly",
  "year": 2026
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "monthly",
    "year": 2026
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "monthly",
        "year": 2026
    },
)
data = response.json()

Remove a recorded request, so the amount counts against later advances again

DELETE/v1/payroll/bonus-requests/{id}

Remove a recorded request, so the amount counts against later advances again

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-bonus-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/bonus-requests/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

The request as a PDF working paper by the lines of forms 25 5241 and 25 5246. Not the printed form

GET/v1/payroll/bonus-requests/{id}/request.pdf

The request as a PDF working paper by the lines of forms 25 5241 and 25 5246. Not the printed form

Nástroj MCP: get-payroll-bonus-request-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/bonus-requests/{id}/request.pdf

curl https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

The request as an EPO file: DPZMB1 for a month, DPZDB1 for a settlement. Valid against the published XSD. With keep=true the money stays for tax due (line d), otherwise it comes back to the company's default bank account. You file it: nothing goes to the portal from here

GET/v1/payroll/bonus-requests/{id}/request.xml

The request as an EPO file: DPZMB1 for a month, DPZDB1 for a settlement. Valid against the published XSD. With keep=true the money stays for tax due (line d), otherwise it comes back to the company's default bank account. You file it: nothing goes to the portal from here

Nástroj MCP: get-payroll-bonus-request-xml

Parametry v cestě

idstringpovinné

Parametry dotazu

keep"true" | "false"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/bonus-requests/{id}/request.xml

curl https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/request.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

What a request for a tax bonus paid from own funds would say: for a month (§ 35d odst. 5 ZDP) or a settlement's doplatek (§ 35d odst. 9). Without a request the app takes the amount off later months' advances, until December

GET/v1/payroll/bonus-requests/preview

What a request for a tax bonus paid from own funds would say: for a month (§ 35d odst. 5 ZDP) or a settlement's doplatek (§ 35d odst. 9). Without a request the app takes the amount off later months' advances, until December

Nástroj MCP: get-payroll-bonus-request-preview

Parametry dotazu

kind"monthly" | "settlement"povinné

yearintegerpovinnémin 2000max 2100

monthintegermin 1max 12

Odpověď · 200

kindstringpovinné

yearintegerpovinné

monthinteger | nullpovinné

totalHalerinteger | nullpovinné

fromAdvancesHalerintegerpovinné

ownFundsHalerintegerpovinné

paidOnnull | stringpovinnédate

problemsany[]povinné

GET/v1/payroll/bonus-requests/preview

curl https://api.damedoklad.cz/v1/payroll/bonus-requests/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/bonus-requests/preview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/bonus-requests/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Withdraw the newest amendment of a contract and put back what it changed. Refused when a locked run has used it or a later amendment stands on it

DELETE/v1/payroll/contract-amendments/{id}

Withdraw the newest amendment of a contract and put back what it changed. Refused when a locked run has used it or a later amendment stands on it

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-contract-amendment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/contract-amendments/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

A recorded amendment as a PDF in Czech, with the values it replaced

GET/v1/payroll/contract-amendments/{id}/amendment.pdf

A recorded amendment as a PDF in Czech, with the values it replaced

Nástroj MCP: get-payroll-contract-amendment-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contract-amendments/{id}/amendment.pdf

curl https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List employment contracts (HPP, DPČ, DPP). One person can hold several at once

GET/v1/payroll/contracts

List employment contracts (HPP, DPČ, DPP). One person can hold several at once

Nástroj MCP: list-payroll-contracts

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

employeeIdstring

ID of the employee.

active"true" | "false"

Odpověď · 200

dataobject[]povinné

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/contracts

curl https://api.damedoklad.cz/v1/payroll/contracts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create an employment contract: type, dates, wage, work time fund, vacation entitlement

POST/v1/payroll/contracts

Create an employment contract: type, dates, wage, work time fund, vacation entitlement

Nástroj MCP: create-payroll-contract

Tělo požadavku

employeeIdstringpovinné

ID of the employee.

type"hpp" | "dpc" | "dpp"povinné

positionstring | null

qualificationstring | null

exposureNotestring | null

signedOnstring | null

Date as YYYY-MM-DD.

startDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

endDatestring | null

Date as YYYY-MM-DD.

endReasonstring | null

wageType"monthly" | "hourly"

baseWageHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

hourlyRateHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

weeklyHoursMilliintegermin 0max 168000

Integer thousandths: 1500 means 1.5.

irregularScheduleboolean

vacationHoursMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

smallScopeboolean | null

averageHourlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

mealAllowancePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployerPerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployeePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

idPpvstring | null

iscoCodestring | null

employmentStatusCodestring

workModeCode"1" | "2" | "3" | "4"

workCitystring | null

workMunicipalityCodestring | null

registeredAtstring | null

deregisteredAtstring | null

deregistrationobject | null

noDataReason"2" | "3" | null

employmentKind"1" | "2"

endReasonCodeintegermin 1max 15

averageNetMonthlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

severanceDueboolean

severancePaidInFullboolean

severanceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

replacementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionFromstring | null

Date as YYYY-MM-DD.

pensionTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

POST/v1/payroll/contracts

curl -X POST https://api.damedoklad.cz/v1/payroll/contracts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "type": "hpp",
  "startDate": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "type": "hpp",
    "startDate": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/contracts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "type": "hpp",
        "startDate": "2026-10-30"
    },
)
data = response.json()

Get an employment contract

GET/v1/payroll/contracts/{id}

Get an employment contract

Nástroj MCP: get-payroll-contract

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

GET/v1/payroll/contracts/{id}

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Update an employment contract. Locked payroll runs keep the values they were calculated with

PATCH/v1/payroll/contracts/{id}

Update an employment contract. Locked payroll runs keep the values they were calculated with

Nástroj MCP: update-payroll-contract

Parametry v cestě

idstringpovinné

Tělo požadavku

type"hpp" | "dpc" | "dpp"

positionstring | null

qualificationstring | null

exposureNotestring | null

signedOnstring | null

Date as YYYY-MM-DD.

startDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

endDatestring | null

Date as YYYY-MM-DD.

endReasonstring | null

wageType"monthly" | "hourly"

baseWageHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

hourlyRateHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

weeklyHoursMilliintegermin 0max 168000

Integer thousandths: 1500 means 1.5.

irregularScheduleboolean

vacationHoursMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

smallScopeboolean | null

averageHourlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

mealAllowancePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployerPerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployeePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

idPpvstring | null

iscoCodestring | null

employmentStatusCodestring

workModeCode"1" | "2" | "3" | "4"

workCitystring | null

workMunicipalityCodestring | null

registeredAtstring | null

deregisteredAtstring | null

deregistrationobject | null

noDataReason"2" | "3" | null

employmentKind"1" | "2"

endReasonCodeintegermin 1max 15

averageNetMonthlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

severanceDueboolean

severancePaidInFullboolean

severanceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

replacementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionFromstring | null

Date as YYYY-MM-DD.

pensionTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

PATCH/v1/payroll/contracts/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "hpp",
  "position": "string",
  "qualification": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "hpp",
    "position": "string",
    "qualification": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "type": "hpp",
        "position": "string",
        "qualification": "string"
    },
)
data = response.json()

Delete a contract that has never been paid

DELETE/v1/payroll/contracts/{id}

Delete a contract that has never been paid

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-contract

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/contracts/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

How a contract's wage is split across cost centers, activities, and projects

GET/v1/payroll/contracts/{id}/allocation

How a contract's wage is split across cost centers, activities, and projects

Nástroj MCP: get-payroll-cost-allocation

Parametry v cestě

idstringpovinné

Odpověď · 200

contractIdstringpovinné

methodnull | stringpovinné

rowsobject[]povinné

idstringpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdnull | stringpovinné

shareBpintegerpovinné

GET/v1/payroll/contracts/{id}/allocation

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Split a contract's wage: fixed percentages that add up to 100 %, hours from each month's attendance, or the contract's own dimensions

PUT/v1/payroll/contracts/{id}/allocation

Split a contract's wage: fixed percentages that add up to 100 %, hours from each month's attendance, or the contract's own dimensions

Nástroj MCP: replace-payroll-cost-allocation

Parametry v cestě

idstringpovinné

Tělo požadavku

method"default" | "fixed" | "attendance"povinné

rowsobject[]

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

shareBpintegerpovinnémin 1max 10000

Odpověď · 200

contractIdstringpovinné

methodnull | stringpovinné

rowsobject[]povinné

idstringpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdnull | stringpovinné

shareBpintegerpovinné

PUT/v1/payroll/contracts/{id}/allocation

curl -X PUT https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "default"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "method": "default"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/allocation",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "method": "default"
    },
)
data = response.json()

Amendment to a contract as a PDF template in Czech (§ 40 of the Labour Code): what changes and from when. This paper alone changes nothing in the app: POST /payroll/contracts/:id/amendments records it on the contract

GET/v1/payroll/contracts/{id}/amendment.pdf

Amendment to a contract as a PDF template in Czech (§ 40 of the Labour Code): what changes and from when. This paper alone changes nothing in the app: POST /payroll/contracts/:id/amendments records it on the contract

Nástroj MCP: get-payroll-amendment-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

effectiveFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

positionstringmax 200 chars

workCitystringmax 200 chars

baseWageHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

hourlyRateHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

weeklyHoursMilliintegermax 60000

Integer thousandths: 1500 means 1.5.

endDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/amendment.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendment.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Amendments recorded on a contract, newest first

GET/v1/payroll/contracts/{id}/amendments

Amendments recorded on a contract, newest first

Nástroj MCP: list-payroll-contract-amendments

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"payroll_contract_amendment"povinné

idstringpovinné

contractIdstringpovinné

effectiveFromstringpovinnédate

signedOnnull | stringpovinnédate

changesobjectpovinné

positionnull | string

baseWageHalerinteger

workCitynull | string

beforeobjectpovinné

positionnull | string

baseWageHalerinteger

workCitynull | string

statusstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/contracts/{id}/amendments

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record an amendment (§ 40 of the Labour Code) and change the contract: at once when it is due, otherwise on its date. Runs of earlier months keep the old values. A change of wage or hours may start on any day: that month is paid pro rata, each part by the wage and hours it had. A locked run from that date on blocks it

POST/v1/payroll/contracts/{id}/amendments

Record an amendment (§ 40 of the Labour Code) and change the contract: at once when it is due, otherwise on its date. Runs of earlier months keep the old values. A change of wage or hours may start on any day: that month is paid pro rata, each part by the wage and hours it had. A locked run from that date on blocks it

Nástroj MCP: create-payroll-contract-amendment

Parametry v cestě

idstringpovinné

Tělo požadavku

effectiveFromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

signedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

positionstringmax 200 chars

workCitystringmax 200 chars

baseWageHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

hourlyRateHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

weeklyHoursMilliintegermax 60000

Integer thousandths: 1500 means 1.5.

endDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

contractIdstringpovinné

effectiveFromstringpovinnédate

signedOnnull | stringpovinnédate

changesobjectpovinné

positionnull | string

baseWageHalerinteger

workCitynull | string

beforeobjectpovinné

positionnull | string

baseWageHalerinteger

workCitynull | string

statusstringpovinné

POST/v1/payroll/contracts/{id}/amendments

curl -X POST https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "effectiveFrom": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "effectiveFrom": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/amendments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "effectiveFrom": "2026-10-30"
    },
)
data = response.json()

Employment contract, or the DPP or DPČ agreement, as a PDF template in Czech with what § 34, § 37, § 75, § 76 and § 77a of the Labour Code require. A probation period up to 4 months, 8 for a manager (§ 35)

GET/v1/payroll/contracts/{id}/contract.pdf

Employment contract, or the DPP or DPČ agreement, as a PDF template in Czech with what § 34, § 37, § 75, § 76 and § 77a of the Labour Code require. A probation period up to 4 months, 8 for a manager (§ 35)

Nástroj MCP: get-payroll-contract-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

probationMonthsintegermin 1max 8

managerial"true" | "false"

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/contract.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/contract.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/contract.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/contract.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

What is still missing before the přihláška or odhláška of a contract can be exported

GET/v1/payroll/contracts/{id}/registration

What is still missing before the přihláška or odhláška of a contract can be exported

Nástroj MCP: check-payroll-registration

Parametry v cestě

idstringpovinné

Parametry dotazu

action"start" | "end"povinné

schemaVersion"1.4" | "1.5"

Odpověď · 200

actionstringpovinné

averageNetHalerinteger | nullpovinné

problemsstring[]povinné

GET/v1/payroll/contracts/{id}/registration

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Přihláška or odhláška of an employee as PDF

GET/v1/payroll/contracts/{id}/registration.pdf

Přihláška or odhláška of an employee as PDF

Nástroj MCP: get-payroll-registration-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

action"start" | "end"povinné

schemaVersion"1.4" | "1.5"

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/registration.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Export a přihláška (start) or odhláška (end) of an employee as XML, which replaced the ONZ form from April 2026: REGZEC 1.4.0.4, or REGZEC27 1.5 from 1 January 2027 or when asked for by `schemaVersion`. An odhláška carries the data for unemployment support

GET/v1/payroll/contracts/{id}/registration.xml

Export a přihláška (start) or odhláška (end) of an employee as XML, which replaced the ONZ form from April 2026: REGZEC 1.4.0.4, or REGZEC27 1.5 from 1 January 2027 or when asked for by `schemaVersion`. An odhláška carries the data for unemployment support

Nástroj MCP: get-payroll-registration-xml

Parametry v cestě

idstringpovinné

Parametry dotazu

action"start" | "end"povinné

schemaVersion"1.4" | "1.5"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/contracts/{id}/registration.xml

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/registration.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Potvrzení o zaměstnání, the zápočtový list, as a PDF in Czech with the points of § 313 odst. 1 of the Labour Code, for a job that has ended

GET/v1/payroll/contracts/{id}/service-confirmation.pdf

Potvrzení o zaměstnání, the zápočtový list, as a PDF in Czech with the points of § 313 odst. 1 of the Labour Code, for a job that has ended

Nástroj MCP: get-payroll-service-confirmation-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/service-confirmation.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/service-confirmation.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/service-confirmation.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/service-confirmation.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

NEMPRI25: the employer's attachment to a benefit claim for any of the six kinds (NEM, OSE, VPM, PPM, OPP, DLO), with the reckoning period from locked runs. Valid against the official XSD; ČSSZ's logical checks are partly reproduced

POST/v1/payroll/contracts/{id}/sick-benefit.xml

NEMPRI25: the employer's attachment to a benefit claim for any of the six kinds (NEM, OSE, VPM, PPM, OPP, DLO), with the reckoning period from locked runs. Valid against the official XSD; ČSSZ's logical checks are partly reproduced

Nástroj MCP: create-payroll-sick-benefit-xml

Parametry v cestě

idstringpovinné

Tělo požadavku

kind"NEM" | "OSE" | "VPM" | "PPM" | "OPP" | "DLO"povinné

eventDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

decisionNumberstringmax 18 chars

correctionboolean

probableIncomeHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

detailobjectpovinné

workedboolean

workedHoursnumbermin 0max 24

scheduleHoursnumbermin 0max 24

smallScopeIncomeintegermin 0max 9007199254740991

studentboolean

holidaysboolean

pensionerboolean

pensionType"A" | "B" | "C" | "I1" | "I3" | "S"

firstJobLeaveboolean

unpaidLeaveboolean

unpaidLeaveFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

unpaidLeaveTostringYYYY-MM-DD

Date as YYYY-MM-DD.

transferredboolean

transferredOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

startsMaternityboolean

childBirthDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

attachmentboolean

insolvencyboolean

stage"start" | "continues" | "end"

paymentobject

lastDayScheduleHoursnumbermin 0max 24

lastDayWorkedHoursnumbermin 0max 24

plannedShiftsboolean

plannedShiftsWorkedboolean

returnedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

workedDaysobject[]

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

leaveboolean

leaveDaysobject[]

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

claimobject

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

personobject

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

takeoverReason"DOH" | "ONE" | "ROZ" | "UMR"

childrenobject[]

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

paternityReason"OTC" | "ZEM" | "PEC"

childobject

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

relationCodestring

alternatingboolean

caredPersonallyboolean

caredDaysobject[]

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

reason"ill" | "quarantine" | "carer_unable" | "school_closed"

schoolNamestring | null

schoolIcostring

Czech company number (IČO), 8 digits.

sameHouseholdboolean

singleParentboolean

caresForChildUnder16boolean

maternityByOtherboolean

Odpověď · 200

Vrací soubor application/xml.

POST/v1/payroll/contracts/{id}/sick-benefit.xml

curl -X POST https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sick-benefit.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "NEM",
  "eventDate": "2026-10-30",
  "detail": {
    "worked": false,
    "workedHours": 0,
    "scheduleHours": 0
  }
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sick-benefit.xml', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "NEM",
    "eventDate": "2026-10-30",
    "detail": {
      "worked": false,
      "workedHours": 0,
      "scheduleHours": 0
    }
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sick-benefit.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "NEM",
        "eventDate": "2026-10-30",
        "detail": {
            "worked": False,
            "workedHours": 0,
            "scheduleHours": 0
        }
    },
)
content = response.content

Confirmation for the Úřad práce (§ 313 odst. 2 of the Labour Code) as a PDF with the data of its form S 15: the job, the average monthly net earnings by § 356 odst. 3, and how it ended

GET/v1/payroll/contracts/{id}/unemployment-confirmation.pdf

Confirmation for the Úřad práce (§ 313 odst. 2 of the Labour Code) as a PDF with the data of its form S 15: the job, the average monthly net earnings by § 356 odst. 3, and how it ended

Nástroj MCP: get-payroll-unemployment-confirmation-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

reasonTextstringmax 200 chars

averageNetMonthlyHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/unemployment-confirmation.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unemployment-confirmation.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unemployment-confirmation.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unemployment-confirmation.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Mzdový výměr as a PDF in Czech (§ 113 odst. 4 of the Labour Code): how the employee is paid, when, and where

GET/v1/payroll/contracts/{id}/wage-notice.pdf

Mzdový výměr as a PDF in Czech (§ 113 odst. 4 of the Labour Code): how the employee is paid, when, and where

Nástroj MCP: get-payroll-wage-notice-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

validFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/contracts/{id}/wage-notice.pdf

curl https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/wage-notice.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/wage-notice.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/wage-notice.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List tax declaration changes handed in by employees, newest first

GET/v1/payroll/declaration-changes

List tax declaration changes handed in by employees, newest first

Nástroj MCP: list-payroll-declaration-changes

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"pending" | "approved" | "rejected"

Odpověď · 200

dataobject[]povinné

object"payroll_declaration_change"povinné

idstringpovinné

employeeIdstringpovinné

employeeNamestring

statusstringpovinné

submittedAtstringpovinnédate-time

decidedAtnull | stringpovinnédate-time

decisionNotenull | stringpovinné

changeobjectpovinné

ztppboolean

addChildrenobject[]

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumberstring

birthDatenull | stringpovinnédate

birthNumberMaskednull | string

requestSettlementYearinteger

disabilitystring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/declaration-changes

curl https://api.damedoklad.cz/v1/payroll/declaration-changes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/declaration-changes', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/declaration-changes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Apply a declaration change to the personal card. A child counts from the month after the change was handed in, a newborn from the month of birth (§ 38k ZDP). A request for the annual settlement starts one

POST/v1/payroll/declaration-changes/{id}/approve

Apply a declaration change to the personal card. A child counts from the month after the change was handed in, a newborn from the month of birth (§ 38k ZDP). A request for the annual settlement starts one

Nástroj MCP: approve-payroll-declaration-change

Parametry v cestě

idstringpovinné

Tělo požadavku

notestring | null

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestring

statusstringpovinné

submittedAtstringpovinnédate-time

decidedAtnull | stringpovinnédate-time

decisionNotenull | stringpovinné

changeobjectpovinné

ztppboolean

addChildrenobject[]

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumberstring

birthDatenull | stringpovinnédate

birthNumberMaskednull | string

requestSettlementYearinteger

disabilitystring

POST/v1/payroll/declaration-changes/{id}/approve

curl -X POST https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "note": "string"
    },
)
data = response.json()

Turn down a declaration change. Nothing on the personal card changes

POST/v1/payroll/declaration-changes/{id}/reject

Turn down a declaration change. Nothing on the personal card changes

Nástroj MCP: reject-payroll-declaration-change

Parametry v cestě

idstringpovinné

Tělo požadavku

notestring | null

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestring

statusstringpovinné

submittedAtstringpovinnédate-time

decidedAtnull | stringpovinnédate-time

decisionNotenull | stringpovinné

changeobjectpovinné

ztppboolean

addChildrenobject[]

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumberstring

birthDatenull | stringpovinnédate

birthNumberMaskednull | string

requestSettlementYearinteger

disabilitystring

POST/v1/payroll/declaration-changes/{id}/reject

curl -X POST https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reject \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reject', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/declaration-changes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reject",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "note": "string"
    },
)
data = response.json()

List wage deductions: attachments of earnings, agreements, advances

GET/v1/payroll/deductions

List wage deductions: attachments of earnings, agreements, advances

Nástroj MCP: list-payroll-deductions

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

employeeIdstring

ID of the employee.

Odpověď · 200

dataobject[]povinné

object"payroll_deduction"povinné

idstringpovinné

employeeIdstringpovinné

kindstringpovinné

namestringpovinné

amountHalerintegerpovinné

remainingHalerinteger | nullpovinné

receivedOnnull | stringpovinnédate

accountNumbernull | stringpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

isActivebooleanpovinné

notenull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/deductions

curl https://api.damedoklad.cz/v1/payroll/deductions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/deductions', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/deductions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a wage deduction. Attachments are limited by the protected amount each month

POST/v1/payroll/deductions

Add a wage deduction. Attachments are limited by the protected amount each month

Nástroj MCP: create-payroll-deduction

Tělo požadavku

employeeIdstringpovinné

ID of the employee.

kind"attachment_priority" | "attachment_other" | "agreement" | "advance" | "other"povinné

namestringpovinnémax 200 chars

amountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

remainingHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

receivedOnstring | null

Date as YYYY-MM-DD.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

variableSymbolstring | null

specificSymbolstring | null

isActiveboolean

notestring | null

Odpověď · 201

idstringpovinné

employeeIdstringpovinné

kindstringpovinné

namestringpovinné

amountHalerintegerpovinné

remainingHalerinteger | nullpovinné

receivedOnnull | stringpovinnédate

accountNumbernull | stringpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

isActivebooleanpovinné

notenull | stringpovinné

POST/v1/payroll/deductions

curl -X POST https://api.damedoklad.cz/v1/payroll/deductions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "kind": "attachment_priority",
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/deductions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "kind": "attachment_priority",
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/deductions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "kind": "attachment_priority",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Update a wage deduction

PATCH/v1/payroll/deductions/{id}

Update a wage deduction

Nástroj MCP: update-payroll-deduction

Parametry v cestě

idstringpovinné

Tělo požadavku

kind"attachment_priority" | "attachment_other" | "agreement" | "advance" | "other"

namestringmax 200 chars

amountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

remainingHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

receivedOnstring | null

Date as YYYY-MM-DD.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

variableSymbolstring | null

specificSymbolstring | null

isActiveboolean

notestring | null

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

kindstringpovinné

namestringpovinné

amountHalerintegerpovinné

remainingHalerinteger | nullpovinné

receivedOnnull | stringpovinnédate

accountNumbernull | stringpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

isActivebooleanpovinné

notenull | stringpovinné

PATCH/v1/payroll/deductions/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "attachment_priority",
  "name": "Pekárna U Lípy s.r.o.",
  "amountHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "attachment_priority",
    "name": "Pekárna U Lípy s.r.o.",
    "amountHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "attachment_priority",
        "name": "Pekárna U Lípy s.r.o.",
        "amountHaler": 1210000
    },
)
data = response.json()

Delete a wage deduction

DELETE/v1/payroll/deductions/{id}

Delete a wage deduction

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-deduction

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/deductions/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/deductions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

The wording of the personnel documents this company can change, with the default of each passage and what each has to keep. Rows the law requires are written by the app and are not here

GET/v1/payroll/document-templates

The wording of the personnel documents this company can change, with the default of each passage and what each has to keep. Rows the law requires are written by the app and are not here

Nástroj MCP: list-payroll-document-templates

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"payroll_document_template"povinné

kindstringpovinné

labelnull | stringpovinné

customizedbooleanpovinné

placeholdersstring[]povinné

blocksobject[]povinné

keystringpovinné

labelnull | stringpovinné

defaultTextstringpovinné

textstringpovinné

placeholdersstring[]povinné

mentionsstring[]povinné

extraSectionsobject[]povinné

textstringpovinné

headingstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/document-templates

curl https://api.damedoklad.cz/v1/payroll/document-templates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/document-templates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/document-templates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save a company's wording of one document and its own extra sections. Refused with the reasons when a passage drops what it has to keep, is empty, or names a figure the app does not know

PUT/v1/payroll/document-templates/{kind}

Save a company's wording of one document and its own extra sections. Refused with the reasons when a passage drops what it has to keep, is empty, or names a figure the app does not know

Nástroj MCP: save-payroll-document-template

Parametry v cestě

kindstringpovinné

Tělo požadavku

blocksobject

extraSectionsobject[]

headingstringpovinnémax 200 chars

textstringpovinnémax 4000 chars

Odpověď · 200

kindstringpovinné

labelnull | stringpovinné

customizedbooleanpovinné

placeholdersstring[]povinné

blocksobject[]povinné

keystringpovinné

labelnull | stringpovinné

defaultTextstringpovinné

textstringpovinné

placeholdersstring[]povinné

mentionsstring[]povinné

extraSectionsobject[]povinné

textstringpovinné

headingstringpovinné

PUT/v1/payroll/document-templates/{kind}

curl -X PUT https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "blocks": {},
  "extraSections": [
    {
      "heading": "string",
      "text": "string"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "blocks": {},
    "extraSections": [
      {
        "heading": "string",
        "text": "string"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "blocks": {},
        "extraSections": [
            {
                "heading": "string",
                "text": "string"
            }
        ]
    },
)
data = response.json()

Go back to the app's wording of one document

DELETE/v1/payroll/document-templates/{kind}

Go back to the app's wording of one document

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: reset-payroll-document-template

Parametry v cestě

kindstringpovinné

Odpověď · 200

kindstringpovinné

labelnull | stringpovinné

customizedbooleanpovinné

placeholdersstring[]povinné

blocksobject[]povinné

keystringpovinné

labelnull | stringpovinné

defaultTextstringpovinné

textstringpovinné

placeholdersstring[]povinné

mentionsstring[]povinné

extraSectionsobject[]povinné

textstringpovinné

headingstringpovinné

DELETE/v1/payroll/document-templates/{kind}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/document-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Seznam: zaměstnanec, mzdy

GET/v1/payroll/employees

List employees. Rodné číslo and bank account are masked here

Nástroj MCP: list-payroll-employees

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

status"active" | "inactive"

Odpověď · 200

dataobject[]povinné

object"employee"povinné

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/employees

curl https://api.damedoklad.cz/v1/payroll/employees \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: zaměstnanec, mzdy

POST/v1/payroll/employees

Create an employee. Rodné číslo is validated and stored encrypted

Nástroj MCP: create-payroll-employee

Tělo požadavku

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

titlestring | null

birthNamestring | null

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

birthPlacestring | null

gender"male" | "female" | null

citizenshipstring2 chars

streetstring | null

houseNumberstring | null

orientationNumberstring | null

citystring | null

postalCodestring | null

countrystring2 chars

emailstring | null

phonestring | null

bankAccountstring | null

healthInsurerCode"111" | "201" | "205" | "207" | "209" | "211" | "213" | null

disability"none" | "first_second" | "third"

ztppboolean

ztpboolean

pensionerboolean

pensionerDiscountFromstring | null

Date as YYYY-MM-DD.

studentboolean

studentUntilstring | null

childrenOtherPersonobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

stateInsuredboolean

selfEmployedMinimumboolean

otherEmployerMinimumboolean

employerDiscountNotifiedboolean

hasDeclarationboolean

declarationSignedOnstring | null

Date as YYYY-MM-DD.

dependentsintegermin 0max 20

ikMpsvstring | null

educationCodestring | null

studentCreditboolean

doctoralStudentboolean

taxNonResidentboolean

foreignTaxIdstring | null

ID of the foreign tax.

foreignTaxIdType"R" | "D" | "S" | "J" | null

identityDocumentNumberstring | null

identityDocumentType"I" | "P" | "D" | "O" | null

identityDocumentCountrystring | null

status"active" | "inactive"

notestring | null

childrenobject[]

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

claimFromstring | null

Date as YYYY-MM-DD.

claimTostring | null

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

POST/v1/payroll/employees

curl -X POST https://api.damedoklad.cz/v1/payroll/employees \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "Pekárna U Lípy s.r.o.",
  "lastName": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "firstName": "Pekárna U Lípy s.r.o.",
    "lastName": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "firstName": "Pekárna U Lípy s.r.o.",
        "lastName": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Detail: zaměstnanec, mzdy

GET/v1/payroll/employees/{id}

Get the personal card of an employee, with the full rodné číslo, bank account, children, and contracts

Nástroj MCP: get-payroll-employee

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

GET/v1/payroll/employees/{id}

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: zaměstnanec, mzdy

PATCH/v1/payroll/employees/{id}

Update the personal card of an employee

Nástroj MCP: update-payroll-employee

Parametry v cestě

idstringpovinné

Tělo požadavku

firstNamestringmax 200 chars

lastNamestringmax 200 chars

titlestring | null

birthNamestring | null

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

birthPlacestring | null

gender"male" | "female" | null

citizenshipstring2 chars

streetstring | null

houseNumberstring | null

orientationNumberstring | null

citystring | null

postalCodestring | null

countrystring2 chars

emailstring | null

phonestring | null

bankAccountstring | null

healthInsurerCode"111" | "201" | "205" | "207" | "209" | "211" | "213" | null

disability"none" | "first_second" | "third"

ztppboolean

ztpboolean

pensionerboolean

pensionerDiscountFromstring | null

Date as YYYY-MM-DD.

studentboolean

studentUntilstring | null

childrenOtherPersonobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

stateInsuredboolean

selfEmployedMinimumboolean

otherEmployerMinimumboolean

employerDiscountNotifiedboolean

hasDeclarationboolean

declarationSignedOnstring | null

Date as YYYY-MM-DD.

dependentsintegermin 0max 20

ikMpsvstring | null

educationCodestring | null

studentCreditboolean

doctoralStudentboolean

taxNonResidentboolean

foreignTaxIdstring | null

ID of the foreign tax.

foreignTaxIdType"R" | "D" | "S" | "J" | null

identityDocumentNumberstring | null

identityDocumentType"I" | "P" | "D" | "O" | null

identityDocumentCountrystring | null

status"active" | "inactive"

notestring | null

Odpověď · 200

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

PATCH/v1/payroll/employees/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "Pekárna U Lípy s.r.o.",
  "lastName": "Pekárna U Lípy s.r.o.",
  "title": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "firstName": "Pekárna U Lípy s.r.o.",
    "lastName": "Pekárna U Lípy s.r.o.",
    "title": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "firstName": "Pekárna U Lípy s.r.o.",
        "lastName": "Pekárna U Lípy s.r.o.",
        "title": "string"
    },
)
data = response.json()

Smazání: zaměstnanec, mzdy

DELETE/v1/payroll/employees/{id}

Delete an employee who has never been paid. Anyone with payroll history must be kept for the statutory period

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-employee

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/employees/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Replace the list of children claimed for the tax credit. Order sets first, second, third child

PUT/v1/payroll/employees/{id}/children

Replace the list of children claimed for the tax credit. Order sets first, second, third child

Nástroj MCP: replace-payroll-employee-children

Parametry v cestě

idstringpovinné

Tělo požadavku

childrenobject[]povinné

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

claimFromstring | null

Date as YYYY-MM-DD.

claimTostring | null

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

PUT/v1/payroll/employees/{id}/children

curl -X PUT https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/children \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "children": [
    {
      "firstName": "Pekárna U Lípy s.r.o.",
      "lastName": "Pekárna U Lípy s.r.o."
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/children', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "children": [
      {
        "firstName": "Pekárna U Lípy s.r.o.",
        "lastName": "Pekárna U Lípy s.r.o."
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/children",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "children": [
            {
                "firstName": "Pekárna U Lípy s.r.o.",
                "lastName": "Pekárna U Lípy s.r.o."
            }
        ]
    },
)
data = response.json()

OZUSPOJ23: the notice of intent to apply the employer discount on social insurance (§ 7b zák. 589/1992 Sb.), for one employee. Valid against the official XSD

GET/v1/payroll/employees/{id}/discount-notice.xml

OZUSPOJ23: the notice of intent to apply the employer discount on social insurance (§ 7b zák. 589/1992 Sb.), for one employee. Valid against the official XSD

Nástroj MCP: get-payroll-discount-notice-xml

Parametry v cestě

idstringpovinné

Parametry dotazu

action"start" | "end" | "cancel"povinné

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/employees/{id}/discount-notice.xml

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/discount-notice.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/discount-notice.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/discount-notice.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Evidenční list důchodového pojištění of an employee for a year, as PDF

GET/v1/payroll/employees/{id}/eldp.pdf

Evidenční list důchodového pojištění of an employee for a year, as PDF

Nástroj MCP: get-payroll-eldp-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/employees/{id}/eldp.pdf

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/eldp.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/eldp.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/eldp.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Potvrzení o zdanitelných příjmech of an employee for a year, as PDF

GET/v1/payroll/employees/{id}/income-confirmation.pdf

Potvrzení o zdanitelných příjmech of an employee for a year, as PDF

Nástroj MCP: get-payroll-income-confirmation-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/employees/{id}/income-confirmation.pdf

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/income-confirmation.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/income-confirmation.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/income-confirmation.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Record that the wage goes to a protected account (chráněný účet, § 304c to § 304e OSŘ): the bank account the confirmation names as its source. From then on a run pays this wage from that account

POST/v1/payroll/employees/{id}/protected-account

Record that the wage goes to a protected account (chráněný účet, § 304c to § 304e OSŘ): the bank account the confirmation names as its source. From then on a run pays this wage from that account

Nástroj MCP: set-payroll-protected-account

Parametry v cestě

idstringpovinné

Tělo požadavku

bankAccountIdstringpovinné

ID of the bank account. Find it with list-bank-accounts.

confirmedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

POST/v1/payroll/employees/{id}/protected-account

curl -X POST https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

The data for the confirmation of a protected account (§ 304d odst. 1 OSŘ) as a PDF working paper. The law wants the ministry's own form, so this is not it

GET/v1/payroll/employees/{id}/protected-account.pdf

The data for the confirmation of a protected account (§ 304d odst. 1 OSŘ) as a PDF working paper. The law wants the ministry's own form, so this is not it

Nástroj MCP: get-payroll-protected-account-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/employees/{id}/protected-account.pdf

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

The employee brought the bank's confirmation that the account is no longer protected (§ 304e odst. 2 OSŘ): the wage is free to leave from any account again

POST/v1/payroll/employees/{id}/protected-account/end

The employee brought the bank's confirmation that the account is no longer protected (§ 304e odst. 2 OSŘ): the wage is free to leave from any account again

Nástroj MCP: clear-payroll-protected-account

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

POST/v1/payroll/employees/{id}/protected-account/end

curl -X POST https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account/end \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account/end', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/protected-account/end",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Evidenční list zaměstnance (personal record) as PDF

GET/v1/payroll/employees/{id}/record.pdf

Evidenční list zaměstnance (personal record) as PDF

Nástroj MCP: get-payroll-employee-record-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/employees/{id}/record.pdf

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/record.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/record.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/record.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List an employee's links with their audit trail. The URL itself cannot be read again

GET/v1/payroll/employees/{id}/self-service-links

List an employee's links with their audit trail. The URL itself cannot be read again

Nástroj MCP: list-payroll-self-service-links

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"payroll_self_service_link"povinné

idstringpovinné

employeeIdstringpovinné

scopesstring[]povinné

expiresAtstringpovinnédate-time

revokedAtnull | stringpovinnédate-time

lastUsedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

activebooleanpovinné

urlstring

sentboolean

eventsobject[]

actionstringpovinné

subjectIdnull | stringpovinné

atstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/employees/{id}/self-service-links

curl https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a link an employee opens without logging in to download payslips and hand in tax declaration changes. The URL is returned once and can be e-mailed

POST/v1/payroll/employees/{id}/self-service-links

Create a link an employee opens without logging in to download payslips and hand in tax declaration changes. The URL is returned once and can be e-mailed

Nástroj MCP: create-payroll-self-service-link

Parametry v cestě

idstringpovinné

Tělo požadavku

scopes"payslips" | "declaration"[]

expiresInDaysintegermin 1max 90

sendboolean

Odpověď · 201

idstringpovinné

employeeIdstringpovinné

scopesstring[]povinné

expiresAtstringpovinnédate-time

revokedAtnull | stringpovinnédate-time

lastUsedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

activebooleanpovinné

urlstring

sentboolean

eventsobject[]

actionstringpovinné

subjectIdnull | stringpovinné

atstringpovinnédate-time

POST/v1/payroll/employees/{id}/self-service-links

curl -X POST https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "scopes": [
    "payslips"
  ],
  "expiresInDays": 1,
  "send": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "scopes": [
      "payslips"
    ],
    "expiresInDays": 1,
    "send": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/self-service-links",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "scopes": [
            "payslips"
        ],
        "expiresInDays": 1,
        "send": False
    },
)
data = response.json()

Import: zaměstnanec, mzdy

POST/v1/payroll/employees/import

Import employees from XLSX for a company coming from POHODA, which does not export them to XML: cards and contracts, and on further sheets children, deductions, attendance and wages of past months. A second row with the same person adds a contract. dryRun only validates. Past months go where past months count: the annual social cap, average earnings, the year-end settlement, ELDP and the income confirmation. They post nothing and are not paid. A month that already has a run here is refused, so nothing counts twice.

Nástroj MCP: import-payroll-employees

Tělo požadavku

fileBase64stringpovinnémax 40000000 chars

File content encoded as base64.

dryRunboolean

Odpověď · 200

dryRunbooleanpovinné

employeesintegerpovinné

contractsintegerpovinné

importedEmployeesintegerpovinné

importedContractsintegerpovinné

errorsobject[]povinné

lineintegerpovinné

messagenull | stringpovinné

namenull | stringpovinné

previewobject[]povinné

namenull | stringpovinné

existingbooleanpovinné

contractsobject[]povinné

typestringpovinné

positionnull | stringpovinné

startDatestringpovinnédate

childreninteger

deductionsinteger

attendanceMonthsinteger

wageMonthsinteger

POST/v1/payroll/employees/import

curl -X POST https://api.damedoklad.cz/v1/payroll/employees/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string"
    },
)
data = response.json()

Download the XLSX template for importing employees and contracts, with an example row

GET/v1/payroll/employees/import-template.xlsx

Download the XLSX template for importing employees and contracts, with an example row

Nástroj MCP: download-payroll-employee-import-template

Odpověď · 200

Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.

GET/v1/payroll/employees/import-template.xlsx

curl https://api.damedoklad.cz/v1/payroll/employees/import-template.xlsx \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/import-template.xlsx', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/employees/import-template.xlsx",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Onboard a new hire in one step: personal card, children, and the first contract

POST/v1/payroll/employees/onboard

Onboard a new hire in one step: personal card, children, and the first contract

Nástroj MCP: onboard-payroll-employee

Tělo požadavku

employeeobjectpovinné

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

titlestring | null

birthNamestring | null

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

birthPlacestring | null

gender"male" | "female" | null

citizenshipstring2 chars

streetstring | null

houseNumberstring | null

orientationNumberstring | null

citystring | null

postalCodestring | null

countrystring2 chars

emailstring | null

phonestring | null

bankAccountstring | null

healthInsurerCode"111" | "201" | "205" | "207" | "209" | "211" | "213" | null

disability"none" | "first_second" | "third"

ztppboolean

ztpboolean

pensionerboolean

pensionerDiscountFromstring | null

Date as YYYY-MM-DD.

studentboolean

studentUntilstring | null

childrenOtherPersonobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

stateInsuredboolean

selfEmployedMinimumboolean

otherEmployerMinimumboolean

employerDiscountNotifiedboolean

hasDeclarationboolean

declarationSignedOnstring | null

Date as YYYY-MM-DD.

dependentsintegermin 0max 20

ikMpsvstring | null

educationCodestring | null

studentCreditboolean

doctoralStudentboolean

taxNonResidentboolean

foreignTaxIdstring | null

ID of the foreign tax.

foreignTaxIdType"R" | "D" | "S" | "J" | null

identityDocumentNumberstring | null

identityDocumentType"I" | "P" | "D" | "O" | null

identityDocumentCountrystring | null

status"active" | "inactive"

notestring | null

childrenobject[]

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

claimFromstring | null

Date as YYYY-MM-DD.

claimTostring | null

Date as YYYY-MM-DD.

contractobjectpovinné

type"hpp" | "dpc" | "dpp"povinné

positionstring | null

qualificationstring | null

exposureNotestring | null

signedOnstring | null

Date as YYYY-MM-DD.

startDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

endDatestring | null

Date as YYYY-MM-DD.

endReasonstring | null

wageType"monthly" | "hourly"

baseWageHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

hourlyRateHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

weeklyHoursMilliintegermin 0max 168000

Integer thousandths: 1500 means 1.5.

irregularScheduleboolean

vacationHoursMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

smallScopeboolean | null

averageHourlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

mealAllowancePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployerPerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

mealVoucherEmployeePerShiftHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

idPpvstring | null

iscoCodestring | null

employmentStatusCodestring

workModeCode"1" | "2" | "3" | "4"

workCitystring | null

workMunicipalityCodestring | null

registeredAtstring | null

deregisteredAtstring | null

deregistrationobject | null

noDataReason"2" | "3" | null

employmentKind"1" | "2"

endReasonCodeintegermin 1max 15

averageNetMonthlyHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

severanceDueboolean

severancePaidInFullboolean

severanceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

replacementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionFromstring | null

Date as YYYY-MM-DD.

pensionTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

namenull | stringpovinné

firstNamestringpovinné

lastNamestringpovinné

titlestring | nullpovinné

birthNamestring | nullpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

birthPlacenull | stringpovinné

gendernull | stringpovinné

citizenshipstringpovinné

streetnull | stringpovinné

houseNumbernull | stringpovinné

orientationNumberstring | nullpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

emailnull | stringpovinné

phonestring | nullpovinné

bankAccountMaskednull | stringpovinné

protectedAccountSourceIdnull | stringpovinné

protectedAccountConfirmedOnnull | stringpovinnédate

healthInsurerCodenull | stringpovinné

healthInsurerNamenull | stringpovinné

disabilitystringpovinné

ztppbooleanpovinné

ztpbooleanpovinné

pensionerbooleanpovinné

pensionerDiscountFromnull | stringpovinnédate

studentbooleanpovinné

studentUntilstring | nullpovinné

stateInsuredbooleanpovinné

selfEmployedMinimumbooleanpovinné

otherEmployerMinimumbooleanpovinné

employerDiscountGroupnull | stringpovinné

employerDiscountNotifiedbooleanpovinné

hasDeclarationbooleanpovinné

declarationSignedOnnull | stringpovinnédate

dependentsintegerpovinné

ikMpsvnull | stringpovinné

educationCodestring | nullpovinné

studentCreditbooleanpovinné

doctoralStudentbooleanpovinné

taxNonResidentbooleanpovinné

foreignTaxIdnull | stringpovinné

foreignTaxIdTypenull | stringpovinné

identityDocumentNumbernull | stringpovinné

identityDocumentTypenull | stringpovinné

identityDocumentCountrynull | stringpovinné

statusstringpovinné

notestring | nullpovinné

contractsobject[]

object"employment_contract"povinné

idstringpovinné

employeeIdstringpovinné

typestringpovinné

positionnull | stringpovinné

signedOnstring | nullpovinné

startDatestringpovinnédate

endDatenull | stringpovinnédate

endReasonstring | nullpovinné

wageTypestringpovinné

baseWageHalerintegerpovinné

hourlyRateHalerintegerpovinné

weeklyHoursMilliintegerpovinné

irregularSchedulebooleanpovinné

vacationHoursMilliintegerpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

mealAllowancePerShiftHalerintegerpovinné

mealVoucherEmployerPerShiftHalerintegerpovinné

mealVoucherEmployeePerShiftHalerintegerpovinné

centerIdnull | stringpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

idPpvnull | stringpovinné

iscoCodenull | stringpovinné

employmentStatusCodestringpovinné

workModeCodestringpovinné

workCitynull | stringpovinné

workMunicipalityCodenull | stringpovinné

registeredAtstring | nullpovinné

deregisteredAtstring | nullpovinné

allocationMethodstringpovinné

deregistrationnull | objectpovinné

severanceDueboolean

endReasonCodeinteger

severanceHalerinteger

severancePaidInFullboolean

noDataReasonstring

averageNetMonthlyHalerinteger

notestring | nullpovinné

employeeNamestring

qualificationnull | string

exposureNotenull | string

onboardingobject

personalbooleanpovinné

insurerbooleanpovinné

bankbooleanpovinné

contractbooleanpovinné

declarationbooleanpovinné

registeredbooleanpovinné

childrenOtherPersonnull | object

lastNamestringpovinné

birthDatenull | stringpovinnédate

firstNamestringpovinné

birthNumberMaskednull | stringpovinné

birthNumbernull | string

bankAccountnull | string

childrenobject[]

object"employee_child"povinné

idstringpovinné

firstNamenull | stringpovinné

lastNamenull | stringpovinné

birthNumbernull | stringpovinné

birthNumberMaskednull | stringpovinné

birthDatenull | stringpovinnédate

ztppbooleanpovinné

claimFromnull | stringpovinnédate

claimTonull | stringpovinnédate

positioninteger | nullpovinné

POST/v1/payroll/employees/onboard

curl -X POST https://api.damedoklad.cz/v1/payroll/employees/onboard \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employee": {
    "firstName": "Pekárna U Lípy s.r.o.",
    "lastName": "Pekárna U Lípy s.r.o."
  },
  "contract": {
    "type": "hpp",
    "startDate": "2026-10-30"
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/employees/onboard', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employee": {
      "firstName": "Pekárna U Lípy s.r.o.",
      "lastName": "Pekárna U Lípy s.r.o."
    },
    "contract": {
      "type": "hpp",
      "startDate": "2026-10-30"
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/employees/onboard",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employee": {
            "firstName": "Pekárna U Lípy s.r.o.",
            "lastName": "Pekárna U Lípy s.r.o."
        },
        "contract": {
            "type": "hpp",
            "startDate": "2026-10-30"
        }
    },
)
data = response.json()

What a Hromadné oznámení zaměstnavatele of a period says for one insurer, worked out from contracts. Tells where the XML format comes from, whether that insurer itself publishes it, and which form an XDP belongs to

GET/v1/payroll/health-changes

What a Hromadné oznámení zaměstnavatele of a period says for one insurer, worked out from contracts. Tells where the XML format comes from, whether that insurer itself publishes it, and which form an XDP belongs to

Nástroj MCP: get-payroll-health-changes

Parametry dotazu

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

insurerstringpovinné

xmlFormatSourcenull | stringpovinné

linesobject[]povinné

employeeIdnull | stringpovinné

namenull | stringpovinné

codenull | stringpovinné

datestringpovinnédate

uncertainbooleanpovinné

addedobject[]

idstringpovinné

employeeIdnull | stringpovinné

namenull | stringpovinné

codenull | stringpovinné

datestringpovinnédate

skippedobject[]

idstringpovinné

employeeIdnull | stringpovinné

namenull | stringpovinné

codenull | stringpovinné

datestringpovinnédate

xmlFormatPublishedboolean

xdpFormnull | string

GET/v1/payroll/health-changes

curl https://api.damedoklad.cz/v1/payroll/health-changes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/health-changes', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/health-changes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

The data of the insurer's Hromadné oznámení form as an XDP, for VZP, VoZP, ZPŠ, ZP MV and RBP. Adobe Reader opens it together with the PDF it names, and you send that PDF. Refused for ČPZP and OZP, which take the XML, and when a value would be cut by the form

POST/v1/payroll/health-changes.xdp

The data of the insurer's Hromadné oznámení form as an XDP, for VZP, VoZP, ZPŠ, ZP MV and RBP. Adobe Reader opens it together with the PDF it names, and you send that PDF. Refused for ČPZP and OZP, which take the XML, and when a value would be cut by the form

Nástroj MCP: create-payroll-health-changes-xdp

Tělo požadavku

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

extraobject[]

employeeIdstringpovinné

ID of the employee.

code"P" | "A" | "E" | "C" | "O" | "Q" | "M" | "U" | "D" | "H" | "I" | "J" | "G" | "F" | "L" | "T" | "N" | "K" | "S" | "R" | "W" | "V" | "X" | "Y" | "Z"povinné

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

skipobject[]

employeeIdstringpovinné

ID of the employee.

code"P" | "A" | "E" | "C" | "O" | "Q" | "M" | "U" | "D" | "H" | "I" | "J" | "G" | "F" | "L" | "T" | "N" | "K" | "S" | "R" | "W" | "V" | "X" | "Y" | "Z"povinné

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/xml.

POST/v1/payroll/health-changes.xdp

curl -X POST https://api.damedoklad.cz/v1/payroll/health-changes.xdp \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "insurer": "111",
  "from": "2026-10-30",
  "to": "2026-10-30"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/health-changes.xdp', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "insurer": "111",
    "from": "2026-10-30",
    "to": "2026-10-30"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/health-changes.xdp",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "insurer": "111",
        "from": "2026-10-30",
        "to": "2026-10-30"
    },
)
content = response.content

Hromadné oznámení zaměstnavatele as the shared XML (hromadneOznameniZamestnavatele v8), whose schema lists all seven insurers. Valid against the XSD. ČPZP, OZP and RBP publish the schema; for VZP, VoZP, ZPŠ and ZP MV ask the insurer whether it takes the file. You file it on the insurer's portal or to its data box

POST/v1/payroll/health-changes.xml

Hromadné oznámení zaměstnavatele as the shared XML (hromadneOznameniZamestnavatele v8), whose schema lists all seven insurers. Valid against the XSD. ČPZP, OZP and RBP publish the schema; for VZP, VoZP, ZPŠ and ZP MV ask the insurer whether it takes the file. You file it on the insurer's portal or to its data box

Nástroj MCP: create-payroll-health-changes-xml

Tělo požadavku

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

extraobject[]

employeeIdstringpovinné

ID of the employee.

code"P" | "A" | "E" | "C" | "O" | "Q" | "M" | "U" | "D" | "H" | "I" | "J" | "G" | "F" | "L" | "T" | "N" | "K" | "S" | "R" | "W" | "V" | "X" | "Y" | "Z"povinné

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

skipobject[]

employeeIdstringpovinné

ID of the employee.

code"P" | "A" | "E" | "C" | "O" | "Q" | "M" | "U" | "D" | "H" | "I" | "J" | "G" | "F" | "L" | "T" | "N" | "K" | "S" | "R" | "W" | "V" | "X" | "Y" | "Z"povinné

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/xml.

POST/v1/payroll/health-changes.xml

curl -X POST https://api.damedoklad.cz/v1/payroll/health-changes.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "insurer": "111",
  "from": "2026-10-30",
  "to": "2026-10-30"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/health-changes.xml', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "insurer": "111",
    "from": "2026-10-30",
    "to": "2026-10-30"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/health-changes.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "insurer": "111",
        "from": "2026-10-30",
        "to": "2026-10-30"
    },
)
content = response.content

Keep a line on the Hromadné oznámení of its month: `add` a change the contracts cannot show, such as maternity (M, U) or a pension (D, H), or `skip` one they show that is not to be filed. It stays for every later look and file

POST/v1/payroll/health-changes/marks

Keep a line on the Hromadné oznámení of its month: `add` a change the contracts cannot show, such as maternity (M, U) or a pension (D, H), or `skip` one they show that is not to be filed. It stays for every later look and file

Nástroj MCP: create-payroll-health-change-mark

Tělo požadavku

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

employeeIdstringpovinné

ID of the employee.

code"P" | "A" | "E" | "C" | "O" | "Q" | "M" | "U" | "D" | "H" | "I" | "J" | "G" | "F" | "L" | "T" | "N" | "K" | "S" | "R" | "W" | "V" | "X" | "Y" | "Z"povinné

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

action"add" | "skip"povinné

Odpověď · 201

idstringpovinné

employeeIdstringpovinné

namenull | stringpovinné

codestringpovinné

datestringpovinnédate

actionstringpovinné

POST/v1/payroll/health-changes/marks

curl -X POST https://api.damedoklad.cz/v1/payroll/health-changes/marks \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "insurer": "111",
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "code": "P",
  "date": "2026-10-30",
  "action": "add"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/health-changes/marks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "insurer": "111",
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "code": "P",
    "date": "2026-10-30",
    "action": "add"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/health-changes/marks",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "insurer": "111",
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "code": "P",
        "date": "2026-10-30",
        "action": "add"
    },
)
data = response.json()

Take back an added line, or bring back a line that was left out

DELETE/v1/payroll/health-changes/marks/{id}

Take back an added line, or bring back a line that was left out

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-health-change-mark

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/health-changes/marks/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/health-changes/marks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/health-changes/marks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/health-changes/marks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List Czech public holidays of a year

GET/v1/payroll/holidays

List Czech public holidays of a year

Nástroj MCP: list-payroll-holidays

Parametry dotazu

yearintegerpovinnémin 2000max 2100

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

datestringpovinnédate

namenull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/holidays

curl https://api.damedoklad.cz/v1/payroll/holidays \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/holidays', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/holidays",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List past months taken over from the previous program. They count in the annual social cap, averages, the year-end settlement, ELDP and the income confirmation, and post nothing

GET/v1/payroll/opening-months

List past months taken over from the previous program. They count in the annual social cap, averages, the year-end settlement, ELDP and the income confirmation, and post nothing

Nástroj MCP: list-payroll-opening-months

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

employeeIdstring

ID of the employee.

yearintegermin 2000max 2100

Odpověď · 200

dataobject[]povinné

object"payroll_opening_month"povinné

idstringpovinné

employeeIdstringpovinné

contractIdnull | stringpovinné

employeeNamestringpovinné

yearintegerpovinné

monthintegerpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

taxBaseHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingBaseHalerintegerpovinné

withholdingHalerintegerpovinné

socialBaseHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthBaseHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

netHalerintegerpovinné

workedHoursMilliintegerpovinné

workedDaysintegerpovinné

sickDaysintegerpovinné

ocrDaysintegerpovinné

unpaidLeaveMilliintegerpovinné

notestring | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/opening-months

curl https://api.damedoklad.cz/v1/payroll/opening-months \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/opening-months', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/opening-months",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Remove a past month taken over by mistake, so it can be imported again

DELETE/v1/payroll/opening-months/{id}

Remove a past month taken over by mistake, so it can be imported again

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-opening-month

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/opening-months/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/opening-months/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/opening-months/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/opening-months/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List company pay item templates: bonuses, premium rates, meal vouchers, and benefits, with the contracts they apply to

GET/v1/payroll/pay-items

List company pay item templates: bonuses, premium rates, meal vouchers, and benefits, with the contracts they apply to

Nástroj MCP: list-payroll-pay-items

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/pay-items

curl https://api.damedoklad.cz/v1/payroll/pay-items \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/pay-items",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a pay item template. A premium rate below the statutory minimum is refused, except an agreed lower rate for night and weekend work

POST/v1/payroll/pay-items

Create a pay item template. A premium rate below the statutory minimum is refused, except an agreed lower rate for night and weekend work

Nástroj MCP: create-payroll-pay-item

Tělo požadavku

namestringpovinnémax 200 chars

category"bonus" | "premium" | "benefit"povinné

calc"fixed" | "per_shift" | "per_hour" | "percent_of_base" | "percent_of_average"povinné

treatment"taxable" | "benefit" | "health_care" | "meal_allowance" | "meal_voucher"

amountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

employeeAmountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

rateBpintegermin 0max 100000

agreedBelowStatutoryboolean

exemptGroup"none" | "health" | "leisure" | "recreation" | "retirement"

appliesToAllboolean

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

isActiveboolean

notestring | null

Odpověď · 201

idstringpovinné

namestringpovinné

categorystringpovinné

calcstringpovinné

treatmentstringpovinné

amountHalerintegerpovinné

employeeAmountHalerintegerpovinné

rateBpintegerpovinné

hoursBasisstringpovinné

premiumKindnull | stringpovinné

agreedBelowStatutorybooleanpovinné

exemptGroupstringpovinné

appliesToAllbooleanpovinné

validFromnull | stringpovinné

validTonull | stringpovinné

isActivebooleanpovinné

notestring | nullpovinné

assignmentsobject[]povinné

contractIdnull | stringpovinné

amountHalerinteger | nullpovinné

rateBpinteger | nullpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

POST/v1/payroll/pay-items

curl -X POST https://api.damedoklad.cz/v1/payroll/pay-items \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "category": "bonus",
  "calc": "fixed"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "category": "bonus",
    "calc": "fixed"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/pay-items",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "category": "bonus",
        "calc": "fixed"
    },
)
data = response.json()

Update a pay item template. Locked runs keep the values they were calculated with

PATCH/v1/payroll/pay-items/{id}

Update a pay item template. Locked runs keep the values they were calculated with

Nástroj MCP: update-payroll-pay-item

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

category"bonus" | "premium" | "benefit"

calc"fixed" | "per_shift" | "per_hour" | "percent_of_base" | "percent_of_average"

treatment"taxable" | "benefit" | "health_care" | "meal_allowance" | "meal_voucher"

amountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

employeeAmountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

rateBpintegermin 0max 100000

agreedBelowStatutoryboolean

exemptGroup"none" | "health" | "leisure" | "recreation" | "retirement"

appliesToAllboolean

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

isActiveboolean

notestring | null

Odpověď · 200

idstringpovinné

namestringpovinné

categorystringpovinné

calcstringpovinné

treatmentstringpovinné

amountHalerintegerpovinné

employeeAmountHalerintegerpovinné

rateBpintegerpovinné

hoursBasisstringpovinné

premiumKindnull | stringpovinné

agreedBelowStatutorybooleanpovinné

exemptGroupstringpovinné

appliesToAllbooleanpovinné

validFromnull | stringpovinné

validTonull | stringpovinné

isActivebooleanpovinné

notestring | nullpovinné

assignmentsobject[]povinné

contractIdnull | stringpovinné

amountHalerinteger | nullpovinné

rateBpinteger | nullpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

PATCH/v1/payroll/pay-items/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "category": "bonus",
  "calc": "fixed"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "category": "bonus",
    "calc": "fixed"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "category": "bonus",
        "calc": "fixed"
    },
)
data = response.json()

Delete a pay item template and its assignments. Locked runs keep the amounts they already hold

DELETE/v1/payroll/pay-items/{id}

Delete a pay item template and its assignments. Locked runs keep the amounts they already hold

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-pay-item

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/pay-items/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set which contracts a pay item applies to, each optionally with its own amount, rate, and months

PUT/v1/payroll/pay-items/{id}/assignments

Set which contracts a pay item applies to, each optionally with its own amount, rate, and months

Nástroj MCP: replace-payroll-pay-item-assignments

Parametry v cestě

idstringpovinné

Tělo požadavku

assignmentsobject[]povinné

contractIdstringpovinné

ID of the contract. Find it with list-contracts.

amountHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

rateBpinteger | null

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

namestringpovinné

categorystringpovinné

calcstringpovinné

treatmentstringpovinné

amountHalerintegerpovinné

employeeAmountHalerintegerpovinné

rateBpintegerpovinné

hoursBasisstringpovinné

premiumKindnull | stringpovinné

agreedBelowStatutorybooleanpovinné

exemptGroupstringpovinné

appliesToAllbooleanpovinné

validFromnull | stringpovinné

validTonull | stringpovinné

isActivebooleanpovinné

notestring | nullpovinné

assignmentsobject[]povinné

contractIdnull | stringpovinné

amountHalerinteger | nullpovinné

rateBpinteger | nullpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

PUT/v1/payroll/pay-items/{id}/assignments

curl -X PUT https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/assignments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "assignments": [
    {
      "contractId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/assignments', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "assignments": [
      {
        "contractId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/pay-items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/assignments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "assignments": [
            {
                "contractId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Statutory minimum premiums and benefit limits of a year, with the section of the Labour Code or the Income Tax Act

GET/v1/payroll/pay-items/statutory

Statutory minimum premiums and benefit limits of a year, with the section of the Labour Code or the Income Tax Act

Nástroj MCP: get-payroll-statutory-premiums

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

yearintegerpovinné

premiumsobject[]povinné

kindstringpovinné

minimumBpintegerpovinné

basestringpovinné

sectionstringpovinné

agreeablebooleanpovinné

mealExemptPerShiftHalerinteger | nullpovinné

benefitLimitsobjectpovinné

healthobjectpovinné

limitHalerintegerpovinné

sectionstringpovinné

leisureobjectpovinné

limitHalerinteger | nullpovinné

sectionstringpovinné

retirementobjectpovinné

limitHalerintegerpovinné

sectionstringpovinné

recreationobject

limitHalerintegerpovinné

sectionstringpovinné

GET/v1/payroll/pay-items/statutory

curl https://api.damedoklad.cz/v1/payroll/pay-items/statutory \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/pay-items/statutory', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/pay-items/statutory",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Seznam: úhrady, mzdy

GET/v1/payroll/payments

List payroll payments. With status=due this is the list the bank module turns into payment orders: payouts, deductions, ČSSZ, health insurers, tax

Nástroj MCP: list-payroll-payments

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"due" | "paid"

runIdstring

ID of the run.

Odpověď · 200

dataobject[]povinné

object"payroll_payment"povinné

idstringpovinné

runIdstringpovinné

kindstringpovinné

employeeIdnull | stringpovinné

healthInsurerCodenull | stringpovinné

recipientstringpovinné

accountNumbernull | stringpovinné

accountMissingbooleanpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

constantSymbolnull | stringpovinné

amountHalerintegerpovinné

dueDatestringpovinnédate

statusstringpovinné

paidOnnull | stringpovinnédate

journalEntryIdnull | stringpovinné

cashEntryIdnull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/payments

curl https://api.damedoklad.cz/v1/payroll/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/payments', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/payments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Mark a payroll payment as paid by hand. A transfer goes through a bank account, posts MD 331/336/342/379 / D 221xxx on its analytic, and a later statement line takes it over. Cash goes through a register with registerId

POST/v1/payroll/payments/{id}/paid

Mark a payroll payment as paid by hand. A transfer goes through a bank account, posts MD 331/336/342/379 / D 221xxx on its analytic, and a later statement line takes it over. Cash goes through a register with registerId

Nástroj MCP: mark-payroll-payment-paid

Parametry v cestě

idstringpovinné

Tělo požadavku

paidOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

registerIdstring

ID of the register.

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

Odpověď · 200

idstringpovinné

runIdstringpovinné

kindstringpovinné

employeeIdnull | stringpovinné

healthInsurerCodenull | stringpovinné

recipientstringpovinné

accountNumbernull | stringpovinné

accountMissingbooleanpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

constantSymbolnull | stringpovinné

amountHalerintegerpovinné

dueDatestringpovinnédate

statusstringpovinné

paidOnnull | stringpovinnédate

journalEntryIdnull | stringpovinné

cashEntryIdnull | stringpovinné

POST/v1/payroll/payments/{id}/paid

curl -X POST https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/paid \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "paidOn": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/paid', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "paidOn": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/paid",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "paidOn": "2026-10-30"
    },
)
data = response.json()

Undo a payment mark: reverses what it posted, and the hand-typed movement goes with it. A payment paired with a statement line is unpaired there

POST/v1/payroll/payments/{id}/unpaid

Undo a payment mark: reverses what it posted, and the hand-typed movement goes with it. A payment paired with a statement line is unpaired there

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: mark-payroll-payment-unpaid

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

runIdstringpovinné

kindstringpovinné

employeeIdnull | stringpovinné

healthInsurerCodenull | stringpovinné

recipientstringpovinné

accountNumbernull | stringpovinné

accountMissingbooleanpovinné

variableSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

constantSymbolnull | stringpovinné

amountHalerintegerpovinné

dueDatestringpovinnédate

statusstringpovinné

paidOnnull | stringpovinnédate

journalEntryIdnull | stringpovinné

cashEntryIdnull | stringpovinné

POST/v1/payroll/payments/{id}/unpaid

curl -X POST https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unpaid \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unpaid', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unpaid",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Free-form planning: net pay and employer cost for a gross monthly wage. Saves nothing

POST/v1/payroll/preview/gross-to-net

Free-form planning: net pay and employer cost for a gross monthly wage. Saves nothing

Nástroj MCP: preview-payroll-gross-to-net

Tělo požadavku

yearintegerpovinnémin -9007199254740991max 9007199254740991

type"hpp" | "dpc" | "dpp"

personobject

hasDeclarationboolean

childrenobject[]

ztppboolean

disability"none" | "first_second" | "third"

ztppboolean

pensionerDiscountboolean

healthMinimumExemptboolean

grossHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

grossHalerintegerpovinné

netHalerintegerpovinné

resultnull | objectpovinné

yearintegerpovinné

monthinteger | nullpovinné

contractsobject[]povinné

contractIdnull | stringpovinné

typestringpovinné

centerOidanypovinné

Null in every recorded response.

activityOidanypovinné

Null in every recorded response.

projectOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

centerOidanypovinné

Null in every recorded response.

activityOidanypovinné

Null in every recorded response.

projectOidanypovinné

Null in every recorded response.

shareBpintegerpovinné

wageHalerintegerpovinné

mealHalerintegerpovinné

employerHalerintegerpovinné

benefitsany[]povinné

benefitEmployerHalerintegerpovinné

participatesbooleanpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

attendanceobjectpovinné

fromstringpovinnédate

tostringpovinnédate

activebooleanpovinné

employedDaysintegerpovinné

calendarDaysintegerpovinné

fundFullMilliintegerpovinné

fundEmployedMilliintegerpovinné

workedMilliintegerpovinné

weekendWorkedMilliintegerpovinné

holidayWorkedMilliintegerpovinné

holidayMilliintegerpovinné

vacationMilliintegerpovinné

sickPaidMilliintegerpovinné

sickUnpaidMilliintegerpovinné

ocrMilliintegerpovinné

paidLeaveMilliintegerpovinné

unpaidLeaveMilliintegerpovinné

absentMilliintegerpovinné

obstacleMilliintegerpovinné

absenceInFundMilliintegerpovinné

sickDaysintegerpovinné

ocrDaysintegerpovinné

healthExcludedDaysintegerpovinné

workedDaysintegerpovinné

shiftsintegerpovinné

sickStreakAtEndintegerpovinné

componentsarray | nullpovinné

codenull | stringpovinné

amountHalerinteger | nullpovinné

hoursMilliintegerpovinné

taxableHalerintegerpovinné

grossHalerintegerpovinné

sickPayHalerintegerpovinné

mealExemptHalerintegerpovinné

voucherEmployerHalerintegerpovinné

socialBaseHalerintegerpovinné

healthBaseHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

costShareintegerpovinné

insurableHalerinteger

grossHalerintegerpovinné

taxableHalerintegerpovinné

sickPayHalerintegerpovinné

otherExemptHalerintegerpovinné

mealExemptHalerintegerpovinné

voucherEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

benefitEmployerHalerintegerpovinné

settlementanypovinné

Null in every recorded response.

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeBeforeDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdanypovinné

Null in every recorded response.

employerDiscountReasonanypovinné

Null in every recorded response.

healthobjectpovinné

baseHalerinteger | nullpovinné

minimumBaseHalerintegerpovinné

shortfallHalerintegerpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

taxobjectpovinné

withholdingBaseHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateBaseHalerintegerpovinné

separateAdvanceHalerintegerpovinné

advanceTaxableHalerintegerpovinné

advanceBaseHalerintegerpovinné

advanceHalerintegerpovinné

personalCreditHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

childCreditClaimHalerintegerpovinné

childCreditHalerintegerpovinné

bonusHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

deductionsany[]povinné

attachmentLimitsobjectpovinné

protectedHalerintegerpovinné

thirdHalerintegerpovinné

aboveHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherPoolHalerintegerpovinné

deductionsHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

warningsany[]povinné

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/preview/gross-to-net

curl -X POST https://api.damedoklad.cz/v1/payroll/preview/gross-to-net \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "grossHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/preview/gross-to-net', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "grossHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/preview/gross-to-net",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "grossHaler": 1210000
    },
)
data = response.json()

Free-form planning: the smallest gross monthly wage that gives at least the wanted net pay. Saves nothing

POST/v1/payroll/preview/net-to-gross

Free-form planning: the smallest gross monthly wage that gives at least the wanted net pay. Saves nothing

Nástroj MCP: preview-payroll-net-to-gross

Tělo požadavku

yearintegerpovinnémin -9007199254740991max 9007199254740991

type"hpp" | "dpc" | "dpp"

personobject

hasDeclarationboolean

childrenobject[]

ztppboolean

disability"none" | "first_second" | "third"

ztppboolean

pensionerDiscountboolean

healthMinimumExemptboolean

netHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

grossHalerintegerpovinné

netHalerintegerpovinné

resultnull | objectpovinné

yearintegerpovinné

monthinteger | nullpovinné

contractsobject[]povinné

contractIdnull | stringpovinné

typestringpovinné

centerOidanypovinné

Null in every recorded response.

activityOidanypovinné

Null in every recorded response.

projectOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

centerOidanypovinné

Null in every recorded response.

activityOidanypovinné

Null in every recorded response.

projectOidanypovinné

Null in every recorded response.

shareBpintegerpovinné

wageHalerintegerpovinné

mealHalerintegerpovinné

employerHalerintegerpovinné

benefitsany[]povinné

benefitEmployerHalerintegerpovinné

participatesbooleanpovinné

smallScopeboolean | nullpovinné

averageHourlyHalerinteger | nullpovinné

attendanceobjectpovinné

fromstringpovinnédate

tostringpovinnédate

activebooleanpovinné

employedDaysintegerpovinné

calendarDaysintegerpovinné

fundFullMilliintegerpovinné

fundEmployedMilliintegerpovinné

workedMilliintegerpovinné

weekendWorkedMilliintegerpovinné

holidayWorkedMilliintegerpovinné

holidayMilliintegerpovinné

vacationMilliintegerpovinné

sickPaidMilliintegerpovinné

sickUnpaidMilliintegerpovinné

ocrMilliintegerpovinné

paidLeaveMilliintegerpovinné

unpaidLeaveMilliintegerpovinné

absentMilliintegerpovinné

obstacleMilliintegerpovinné

absenceInFundMilliintegerpovinné

sickDaysintegerpovinné

ocrDaysintegerpovinné

healthExcludedDaysintegerpovinné

workedDaysintegerpovinné

shiftsintegerpovinné

sickStreakAtEndintegerpovinné

componentsarray | nullpovinné

codenull | stringpovinné

amountHalerinteger | nullpovinné

hoursMilliintegerpovinné

taxableHalerintegerpovinné

grossHalerintegerpovinné

sickPayHalerintegerpovinné

mealExemptHalerintegerpovinné

voucherEmployerHalerintegerpovinné

socialBaseHalerintegerpovinné

healthBaseHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

costShareintegerpovinné

insurableHalerinteger

grossHalerintegerpovinné

taxableHalerintegerpovinné

sickPayHalerintegerpovinné

otherExemptHalerintegerpovinné

mealExemptHalerintegerpovinné

voucherEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

benefitEmployerHalerintegerpovinné

settlementanypovinné

Null in every recorded response.

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeBeforeDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdanypovinné

Null in every recorded response.

employerDiscountReasonanypovinné

Null in every recorded response.

healthobjectpovinné

baseHalerinteger | nullpovinné

minimumBaseHalerintegerpovinné

shortfallHalerintegerpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

taxobjectpovinné

withholdingBaseHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateBaseHalerintegerpovinné

separateAdvanceHalerintegerpovinné

advanceTaxableHalerintegerpovinné

advanceBaseHalerintegerpovinné

advanceHalerintegerpovinné

personalCreditHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

childCreditClaimHalerintegerpovinné

childCreditHalerintegerpovinné

bonusHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

deductionsany[]povinné

attachmentLimitsobjectpovinné

protectedHalerintegerpovinné

thirdHalerintegerpovinné

aboveHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherPoolHalerintegerpovinné

deductionsHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

warningsany[]povinné

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/preview/net-to-gross

curl -X POST https://api.damedoklad.cz/v1/payroll/preview/net-to-gross \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "netHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/preview/net-to-gross', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "netHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/preview/net-to-gross",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "netHaler": 1210000
    },
)
data = response.json()

Get the legal payroll parameters of a year: average wage, minimum wage, rates, limits

GET/v1/payroll/rates

Get the legal payroll parameters of a year: average wage, minimum wage, rates, limits

Nástroj MCP: get-payroll-rates

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

supportedYearsinteger[]povinné

yearintegerpovinné

averageWageintegerpovinné

minimumWageMonthlyintegerpovinné

minimumWageHourlyHalerintegerpovinné

socialobjectpovinné

employerBpintegerpovinné

employeeBpintegerpovinné

employeeSicknessBpintegerpovinné

employeePensionBpintegerpovinné

maxAssessmentBaseintegerpovinné

pensionerDiscountBpintegerpovinné

employerDiscountobjectpovinné

bpintegerpovinné

minWeeklyHoursintegerpovinné

maxWeeklyHoursintegerpovinné

maxMonthlyBaseintegerpovinné

maxHourlyBaseintegerpovinné

maxMonthlyHoursintegerpovinné

participationobjectpovinné

dppThresholdintegerpovinné

smallScopeThresholdintegerpovinné

healthobjectpovinné

totalBpintegerpovinné

minimumBaseintegerpovinné

taxobjectpovinné

rateBpinteger | nullpovinné

higherRateBpintegerpovinné

monthlyThresholdintegerpovinné

withholdingRateBpintegerpovinné

taxpayerCreditintegerpovinné

disabilityFirstSecondCreditintegerpovinné

disabilityThirdCreditintegerpovinné

ztppCreditintegerpovinné

childCreditsinteger[]povinné

minimumMonthlyBonusintegerpovinné

bonusIncomeThresholdintegerpovinné

separateAdvanceboolean

studentCreditinteger

studentAgeLimitinteger

doctoralAgeLimitinteger

sickPayobjectpovinné

thresholdsHalerinteger[]povinné

weightsBpinteger[]povinné

rateBpinteger | nullpovinné

paidCalendarDaysintegerpovinné

premiumsobjectpovinné

overtimeBpintegerpovinné

nightBpintegerpovinné

weekendBpintegerpovinné

holidayBpintegerpovinné

difficultBpOfMinimumWageintegerpovinné

mealsobjectpovinné

exemptPerShiftHalerinteger | nullpovinné

minimumHoursPerShiftintegerpovinné

attachmentsnull | objectpovinné

baseSumintegerpovinné

debtorShareBpintegerpovinné

dependentDivisorintegerpovinné

fullSeizureThresholdintegerpovinné

insolvencyMonthlyWithVatHalerintegerpovinné

benefitsobjectpovinné

healthLimitHalerintegerpovinné

leisureLimitHalerinteger | nullpovinné

retirementLimitHalerintegerpovinné

recreationLimitHalerinteger

healthCareOutsideIncomeboolean

agreementsobjectpovinné

dppYearlyHoursintegerpovinné

dpcWeeklyHoursintegerpovinné

pendingobject

mealsstringpovinné

attachmentsstringpovinné

tipsobject

exemptShareBpintegerpovinné

GET/v1/payroll/rates

curl https://api.damedoklad.cz/v1/payroll/rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/rates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/rates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Annual totals per employee from locked runs

GET/v1/payroll/reports/annual

Annual totals per employee from locked runs

Nástroj MCP: get-payroll-annual-totals

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

dataobject[]povinné

employeeIdnull | stringpovinné

employeeNamestringpovinné

monthsintegerpovinné

grossHalerintegerpovinné

socialEmployeeHalerintegerpovinné

healthEmployeeHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

netHalerintegerpovinné

employerCostHalerintegerpovinné

totalintegerpovinné

hasMorebooleanpovinné

GET/v1/payroll/reports/annual

curl https://api.damedoklad.cz/v1/payroll/reports/annual \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/reports/annual', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/reports/annual",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Labour cost by month and by cost center, from locked runs

GET/v1/payroll/reports/costs

Labour cost by month and by cost center, from locked runs

Nástroj MCP: get-payroll-cost-overview

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

yearintegerpovinné

monthsobject[]povinné

monthinteger | nullpovinné

grossHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployerHalerintegerpovinné

totalHalerinteger | nullpovinné

centersobject[]povinné

centerIdnull | stringpovinné

totalHalerinteger | nullpovinné

GET/v1/payroll/reports/costs

curl https://api.damedoklad.cz/v1/payroll/reports/costs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/reports/costs', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/reports/costs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Mzdový list: one employee, month by month, from locked runs

GET/v1/payroll/reports/wage-sheet

Mzdový list: one employee, month by month, from locked runs

Nástroj MCP: get-payroll-wage-sheet

Parametry dotazu

yearintegerpovinnémin 2000max 2100

employeeIdstringpovinné

ID of the employee.

Odpověď · 200

yearintegerpovinné

employeeIdnull | stringpovinné

monthsobject[]povinné

monthinteger | nullpovinné

grossHalerintegerpovinné

socialEmployeeHalerintegerpovinné

healthEmployeeHalerintegerpovinné

taxHalerintegerpovinné

withholdingHalerintegerpovinné

bonusHalerintegerpovinné

deductionsHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

GET/v1/payroll/reports/wage-sheet

curl https://api.damedoklad.cz/v1/payroll/reports/wage-sheet \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/reports/wage-sheet', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/reports/wage-sheet",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Mzdový list as PDF

GET/v1/payroll/reports/wage-sheet.pdf

Mzdový list as PDF

Nástroj MCP: get-payroll-wage-sheet-pdf

Parametry dotazu

yearintegerpovinnémin 2000max 2100

employeeIdstringpovinné

ID of the employee.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/reports/wage-sheet.pdf

curl https://api.damedoklad.cz/v1/payroll/reports/wage-sheet.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/reports/wage-sheet.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/reports/wage-sheet.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List monthly payroll runs

GET/v1/payroll/runs

List monthly payroll runs

Nástroj MCP: list-payroll-runs

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

yearintegermin 2000max 2100

Odpověď · 200

dataobject[]povinné

object"payroll_run"povinné

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

socialobjectpovinné

netHalerintegerpovinné

warningsobject[]povinné

contractsobject[]povinné

deductionsobject[]povinné

grossHalerintegerpovinné

settlementnull | objectpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/runs

curl https://api.damedoklad.cz/v1/payroll/runs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Start the payroll of a month as a draft and calculate every employee with a contract in that month

POST/v1/payroll/runs

Start the payroll of a month as a draft and calculate every employee with a contract in that month

Nástroj MCP: create-payroll-run

Tělo požadavku

yearintegerpovinnémin -9007199254740991max 9007199254740991

monthintegerpovinnémin 1max 12

paymentDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

tipFoodIncomeHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 201

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs

curl -X POST https://api.damedoklad.cz/v1/payroll/runs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "month": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "month": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "month": 1
    },
)
data = response.json()

Get a payroll run with the calculation of every employee

GET/v1/payroll/runs/{id}

Get a payroll run with the calculation of every employee

Nástroj MCP: get-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

GET/v1/payroll/runs/{id}

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change the payment date, the note, or the month's food service income behind the exempt tips (§ 6 odst. 9 písm. g) ZDP from 2027) of a payroll run that is not locked. A new income recalculates the run

PATCH/v1/payroll/runs/{id}

Change the payment date, the note, or the month's food service income behind the exempt tips (§ 6 odst. 9 písm. g) ZDP from 2027) of a payroll run that is not locked. A new income recalculates the run

Nástroj MCP: update-payroll-run

Parametry v cestě

idstringpovinné

Tělo požadavku

paymentDatestring | null

Date as YYYY-MM-DD.

notestring | null

tipFoodIncomeHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

PATCH/v1/payroll/runs/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "paymentDate": "2026-10-30",
  "note": "string",
  "tipFoodIncomeHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "paymentDate": "2026-10-30",
    "note": "string",
    "tipFoodIncomeHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "paymentDate": "2026-10-30",
        "note": "string",
        "tipFoodIncomeHaler": 1210000
    },
)
data = response.json()

Delete a payroll run that is not locked

DELETE/v1/payroll/runs/{id}

Delete a payroll run that is not locked

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/runs/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Overview of what a month must report: social insurance, each health insurer, tax, and whether the JMHZ XML is ready

GET/v1/payroll/runs/{id}/filings

Overview of what a month must report: social insurance, each health insurer, tax, and whether the JMHZ XML is ready

Nástroj MCP: get-payroll-filings

Parametry v cestě

idstringpovinné

Odpověď · 200

runIdnull | stringpovinné

statusstringpovinné

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

insurersobject[]povinné

codenull | stringpovinné

namenull | stringpovinné

xmlFilebooleanpovinné

employeeCountintegerpovinné

baseHalerinteger | nullpovinné

premiumHalerintegerpovinné

jmhzProblemsstring[]povinné

filingsobject[]povinné

kindstringpovinné

typestringpovinné

guidnull | stringpovinné

generatedAtstringpovinnédate-time

submittedAtnull | stringpovinnédate-time

GET/v1/payroll/runs/{id}/filings

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record that a filing was submitted to the authority. DameDoklad does not submit it for you

POST/v1/payroll/runs/{id}/filings/{kind}/submitted

Record that a filing was submitted to the authority. DameDoklad does not submit it for you

Nástroj MCP: mark-payroll-filing-submitted

Parametry v cestě

idstringpovinné

kindstringpovinné

Tělo požadavku

notestring | null

Odpověď · 200

runIdnull | stringpovinné

kindstringpovinné

submittedAtnull | stringpovinnédate-time

POST/v1/payroll/runs/{id}/filings/{kind}/submitted

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/submitted \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/submitted', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/submitted",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "note": "string"
    },
)
data = response.json()

Přehled o platbě pojistného as the fixed-length file VZP publishes (methodology 3.8.1.2), for VZP only. Other insurers have `health.xml`

GET/v1/payroll/runs/{id}/filings/health.aap

Přehled o platbě pojistného as the fixed-length file VZP publishes (methodology 3.8.1.2), for VZP only. Other insurers have `health.xml`

Nástroj MCP: get-payroll-health-overview-file

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor text/plain.

GET/v1/payroll/runs/{id}/filings/health.aap

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.aap \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.aap', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.aap",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Přehled o platbě pojistného for one health insurer as a working paper in PDF. It is not the insurer's own form; VZP also has the file `health.aap`

GET/v1/payroll/runs/{id}/filings/health.pdf

Přehled o platbě pojistného for one health insurer as a working paper in PDF. It is not the insurer's own form; VZP also has the file `health.aap`

Nástroj MCP: get-payroll-health-overview-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/runs/{id}/filings/health.pdf

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Přehled o platbě pojistného as the shared XML of the insurers (prehledPlatbyZamestnavatele v8), for ČPZP, OZP and ZP MV ČR, which publish it. Valid against the XSD. Refused for an insurer whose own publication of the format was not found

GET/v1/payroll/runs/{id}/filings/health.xml

Přehled o platbě pojistného as the shared XML of the insurers (prehledPlatbyZamestnavatele v8), for ČPZP, OZP and ZP MV ČR, which publish it. Valid against the XSD. Refused for an insurer whose own publication of the format was not found

Nástroj MCP: get-payroll-health-overview-xml

Parametry v cestě

idstringpovinné

Parametry dotazu

insurer"111" | "201" | "205" | "207" | "209" | "211" | "213"povinné

type"radny" | "opravny"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/runs/{id}/filings/health.xml

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/health.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Export the jednotné měsíční hlášení zaměstnavatele as XML: schema MH 1.4.3.6, or MH 1.5.0.3 for months from January 2027. ČSSZ still calls 1.5 a final draft. Requires a locked run, the ČSSZ variable symbol, IK MPSV, and idPpv

GET/v1/payroll/runs/{id}/filings/jmhz.xml

Export the jednotné měsíční hlášení zaměstnavatele as XML: schema MH 1.4.3.6, or MH 1.5.0.3 for months from January 2027. ČSSZ still calls 1.5 a final draft. Requires a locked run, the ČSSZ variable symbol, IK MPSV, and idPpv

Nástroj MCP: get-payroll-jmhz-xml

Parametry v cestě

idstringpovinné

Parametry dotazu

type"R" | "O" | "S"

Odpověď · 200

Vrací soubor application/xml.

GET/v1/payroll/runs/{id}/filings/jmhz.xml

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/jmhz.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/jmhz.xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/jmhz.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Přehled o výši pojistného as PDF. From 2026 this is a working paper, the figures are filed in the JMHZ

GET/v1/payroll/runs/{id}/filings/social.pdf

Přehled o výši pojistného as PDF. From 2026 this is a working paper, the figures are filed in the JMHZ

Nástroj MCP: get-payroll-social-overview-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/runs/{id}/filings/social.pdf

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/social.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/social.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/social.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Monthly tax overview as PDF: advances, bonuses, and withholding tax per employee

GET/v1/payroll/runs/{id}/filings/tax.pdf

Monthly tax overview as PDF: advances, bonuses, and withholding tax per employee

Nástroj MCP: get-payroll-tax-overview-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/runs/{id}/filings/tax.pdf

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/tax.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/tax.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filings/tax.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Lock a reviewed run: posts to the books in double entry and creates the payments that fall due

POST/v1/payroll/runs/{id}/lock

Lock a reviewed run: posts to the books in double entry and creates the payments that fall due

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: lock-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs/{id}/lock

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lock \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lock', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lock",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Put everything a locked run still owes on payment orders: net pay per employee, deductions, ČSSZ, each insurer, tax. One order per day and bank account, with the published accounts and variable symbols unless settings say otherwise. Payments pair when the statement arrives. A wage to a protected account leaves from the account its confirmation names. What has no account comes back in `skipped`

POST/v1/payroll/runs/{id}/payment-orders

Put everything a locked run still owes on payment orders: net pay per employee, deductions, ČSSZ, each insurer, tax. One order per day and bank account, with the published accounts and variable symbols unless settings say otherwise. Payments pair when the statement arrives. A wage to a protected account leaves from the account its confirmation names. What has no account comes back in `skipped`

Nástroj MCP: create-payroll-run-payment-orders

Parametry v cestě

idstringpovinné

Tělo požadavku

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

Odpověď · 201

runIdnull | stringpovinné

ordersobject[]povinné

idstringpovinné

numberinteger | nullpovinné

executionDatestringpovinnédate

totalHalerinteger | nullpovinné

itemCountintegerpovinné

skippedobject[]povinné

paymentIdnull | stringpovinné

kindstringpovinné

recipientstringpovinné

reasonnull | stringpovinné

POST/v1/payroll/runs/{id}/payment-orders

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payment-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payment-orders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payment-orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Download the payslip of one employee as PDF

GET/v1/payroll/runs/{id}/payslips/{itemId}/pdf

Download the payslip of one employee as PDF

Nástroj MCP: get-payroll-payslip-pdf

Parametry v cestě

idstringpovinné

itemIdstringpovinné

ID of the item. Find it with list-items.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/runs/{id}/payslips/{itemId}/pdf

curl https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

E-mail the payslip PDF to one employee. Only a locked run can be sent

POST/v1/payroll/runs/{id}/payslips/{itemId}/send

E-mail the payslip PDF to one employee. Only a locked run can be sent

Nástroj MCP: send-payroll-payslip

Parametry v cestě

idstringpovinné

itemIdstringpovinné

ID of the item. Find it with list-items.

Odpověď · 200

itemIdnull | stringpovinné

statusstringpovinné

errorCodenull | stringpovinné

POST/v1/payroll/runs/{id}/payslips/{itemId}/send

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

E-mail payslips to everyone in a locked run who has an address on file

POST/v1/payroll/runs/{id}/payslips/send

E-mail payslips to everyone in a locked run who has an address on file

Nástroj MCP: send-payroll-payslips

Parametry v cestě

idstringpovinné

Odpověď · 200

resultsobject[]povinné

itemIdnull | stringpovinné

statusstringpovinné

errorCodestring | nullpovinné

POST/v1/payroll/runs/{id}/payslips/send

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/send \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/send', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payslips/send",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Recalculate a draft run from the current contracts, attendance, and deductions

POST/v1/payroll/runs/{id}/recalculate

Recalculate a draft run from the current contracts, attendance, and deductions

Nástroj MCP: recalculate-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs/{id}/recalculate

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/recalculate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/recalculate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/recalculate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Send a run in review back to draft

POST/v1/payroll/runs/{id}/reopen

Send a run in review back to draft

Nástroj MCP: reopen-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs/{id}/reopen

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Recalculate a draft one last time and move it to review

POST/v1/payroll/runs/{id}/review

Recalculate a draft one last time and move it to review

Nástroj MCP: review-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs/{id}/review

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/review \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/review', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/review",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Unlock a run back to review: reverses its journal entry and removes its payments. Refused once a payment is paid

POST/v1/payroll/runs/{id}/unlock

Unlock a run back to review: reverses its journal entry and removes its payments. Refused once a payment is paid

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: unlock-payroll-run

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

periodstringpovinné

statusstringpovinné

paymentDatenull | stringpovinnédate

totalsobjectpovinné

netHalerintegerpovinné

bonusHalerintegerpovinné

grossHalerintegerpovinné

payoutHalerintegerpovinné

advanceHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

employeeCountintegerpovinné

deductionsHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

employerCostHalerintegerpovinné

healthPayableHalerintegerpovinné

socialPayableHalerintegerpovinné

advanceCarryInHalerintegerpovinné

advancePayableHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

withholdingTaxHalerintegerpovinné

advanceCarryOutHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

employerDiscountHalerintegerpovinné

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

settlementBonusTopupHalerintegerpovinné

settlementOverpaymentHalerintegerpovinné

socialEmployeeBeforeDiscountHalerintegerpovinné

journalEntryIdnull | stringpovinné

reviewedAtnull | stringpovinnédate-time

lockedAtnull | stringpovinnédate-time

notenull | stringpovinné

tipFoodIncomeHalerinteger | null

itemsobject[]

object"payroll_run_item"povinné

idstringpovinné

runIdstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

healthInsurerCodenull | stringpovinné

grossHalerintegerpovinné

taxableHalerintegerpovinné

netHalerintegerpovinné

payoutHalerintegerpovinné

employerCostHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

taxHalerintegerpovinné

bonusHalerintegerpovinné

withholdingHalerintegerpovinné

deductionsHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

resultobjectpovinné

taxobjectpovinné

bonusHalerintegerpovinné

advanceHalerintegerpovinné

advanceBaseHalerintegerpovinné

childCreditHalerintegerpovinné

separateBaseHalerintegerpovinné

advanceTaxableHalerintegerpovinné

personalCreditHalerintegerpovinné

withholdingTaxHalerintegerpovinné

separateAdvanceHalerintegerpovinné

withholdingBaseHalerintegerpovinné

childCreditClaimHalerintegerpovinné

advanceAfterCreditsHalerintegerpovinné

personalCreditClaimHalerintegerpovinné

separateDppboolean

separateOtherboolean

multiMonthobject

yearintegerpovinné

monthinteger | nullpovinné

healthobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

shortfallHalerintegerpovinné

minimumBaseHalerintegerpovinné

socialobjectpovinné

baseHalerinteger | nullpovinné

employeeHalerintegerpovinné

employerHalerintegerpovinné

employerDiscountReasonanypovinné

Null in every recorded response.

pensionerDiscountHalerintegerpovinné

employerDiscountBaseHalerintegerpovinné

employerDiscountContractIdnull | stringpovinné

employeeBeforeDiscountHalerintegerpovinné

netHalerintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

amountHalerinteger | null

deductionIdnull | string

contractsobject[]povinné

typestringpovinné

benefitsobject[]povinné

centerOidnull | stringpovinné

costShareintegerpovinné

attendanceobjectpovinné

componentsarray | nullpovinné

contractIdnull | stringpovinné

grossHalerintegerpovinné

projectOidanypovinné

Null in every recorded response.

smallScopeboolean | nullpovinné

activityOidanypovinné

Null in every recorded response.

allocationsobject[]povinné

participatesbooleanpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

healthBaseHalerintegerpovinné

mealExemptHalerintegerpovinné

socialBaseHalerintegerpovinné

averageHourlyHalerinteger | nullpovinné

healthEmployeeHalerintegerpovinné

healthEmployerHalerintegerpovinné

socialEmployeeHalerintegerpovinné

socialEmployerHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployerHalerintegerpovinné

insurableHalerinteger

deductionsobject[]povinné

idnull | stringpovinné

kindstringpovinné

amountHalerinteger | nullpovinné

requestedHalerintegerpovinné

namenull | string

accountNumbernull | string

remainingHalerinteger | null

specificSymbolstring | null

variableSymbolnull | string

grossHalerintegerpovinné

settlementnull | objectpovinné

idstringpovinné

yearintegerpovinné

totalHalerinteger | nullpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

payoutHalerintegerpovinné

sickPayHalerintegerpovinné

taxableHalerintegerpovinné

deductionsHalerintegerpovinné

mealExemptHalerintegerpovinné

attachmentLimitsobjectpovinné

aboveHalerintegerpovinné

thirdHalerintegerpovinné

otherPoolHalerintegerpovinné

protectedHalerintegerpovinné

priorityPoolHalerintegerpovinné

otherExemptHalerintegerpovinné

employerCostHalerintegerpovinné

benefitEmployerHalerintegerpovinné

voucherEmployeeHalerintegerpovinné

voucherEmployerHalerintegerpovinné

reimbursementsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

descriptionnull | stringpovinné

travelOrderIdstringpovinné

reimbursementHalerinteger

reimbursementVatHalerinteger

tipsHalerinteger

tipExemptHalerinteger

POST/v1/payroll/runs/{id}/unlock

curl -X POST https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unlock \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unlock', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/runs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unlock",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Revoke a link at once. Whoever holds it can no longer use it

POST/v1/payroll/self-service-links/{id}/revoke

Revoke a link at once. Whoever holds it can no longer use it

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: revoke-payroll-self-service-link

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

scopesstring[]povinné

expiresAtstringpovinnédate-time

revokedAtnull | stringpovinnédate-time

lastUsedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

activebooleanpovinné

urlstring

sentboolean

eventsobject[]

actionstringpovinné

subjectIdnull | stringpovinné

atstringpovinnédate-time

POST/v1/payroll/self-service-links/{id}/revoke

curl -X POST https://api.damedoklad.cz/v1/payroll/self-service-links/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revoke \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/self-service-links/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revoke', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/self-service-links/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revoke",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Detail: nastavení, mzdy

GET/v1/payroll/settings

Get payroll settings: ČSSZ variable symbol, okresní správa, pay day, and accounts for contributions

Nástroj MCP: get-payroll-settings

Odpověď · 200

idnull | stringpovinné

csszVariableSymbolnull | stringpovinné

csszDistrictCodenull | stringpovinné

taxOfficeCodenull | stringpovinné

taxOfficenull | stringpovinné

accidentInsurernull | stringpovinné

accidentOkecnull | stringpovinné

accidentRatePermillenull | numberpovinné

payDayintegerpovinné

socialAccountnull | stringpovinné

taxAccountstring | nullpovinné

taxVariableSymbolstring | nullpovinné

withholdingAccountstring | nullpovinné

withholdingVariableSymbolstring | nullpovinné

healthAccountsobjectpovinné

notificationEmailstring | nullpovinné

taxWorkplaceCodenull | stringpovinné

taxSubjectTypestringpovinné

taxSubjectFirstNamestring | nullpovinné

taxSubjectLastNamestring | nullpovinné

contactNamenull | stringpovinné

contactPhonenull | stringpovinné

contactEmailnull | stringpovinné

vzpBranchstringpovinné

ownershipFormnull | stringpovinné

collectiveAgreementsstring[]povinné

disabledQuotanull | objectpovinné

disabledFteintegerpovinné

employeesFtenumberpovinné

sharePercentnumberpovinné

GET/v1/payroll/settings

curl https://api.damedoklad.cz/v1/payroll/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: nastavení, mzdy

PUT/v1/payroll/settings

Save payroll settings. An account entered here wins over the one the office publishes. An insurer and a rate here drive the statutory liability insurance

Nástroj MCP: update-payroll-settings

Tělo požadavku

csszVariableSymbolstring | null

csszDistrictCodestring | null

taxOfficeCodestring | null

accidentInsurer"kooperativa" | "generali" | null

accidentOkecstring | null

accidentRatePermillenumber | null

payDayintegermin 1max 28

socialAccountstring | null

taxAccountstring | null

taxVariableSymbolstring | null

withholdingAccountstring | null

withholdingVariableSymbolstring | null

healthAccountsobject

notificationEmailstring | null

taxWorkplaceCodestring | null

taxSubjectType"P" | "F"

taxSubjectFirstNamestring | null

taxSubjectLastNamestring | null

contactNamestring | null

contactPhonestring | null

contactEmailstring | null

vzpBranchstring

ownershipForm"1" | "2" | "3" | "4" | null

collectiveAgreements"1" | "2" | "3" | "4" | "5"[]

disabledQuotaobject | null

employeesFtenumberpovinnémin 0

disabledFtenumberpovinnémin 0

sharePercentnumberpovinnémin 0max 100

Odpověď · 200

idnull | stringpovinné

csszVariableSymbolnull | stringpovinné

csszDistrictCodenull | stringpovinné

taxOfficeCodenull | stringpovinné

taxOfficenull | stringpovinné

accidentInsurernull | stringpovinné

accidentOkecnull | stringpovinné

accidentRatePermillenull | numberpovinné

payDayintegerpovinné

socialAccountnull | stringpovinné

taxAccountstring | nullpovinné

taxVariableSymbolstring | nullpovinné

withholdingAccountstring | nullpovinné

withholdingVariableSymbolstring | nullpovinné

healthAccountsobjectpovinné

notificationEmailstring | nullpovinné

taxWorkplaceCodenull | stringpovinné

taxSubjectTypestringpovinné

taxSubjectFirstNamestring | nullpovinné

taxSubjectLastNamestring | nullpovinné

contactNamenull | stringpovinné

contactPhonenull | stringpovinné

contactEmailnull | stringpovinné

vzpBranchstringpovinné

ownershipFormnull | stringpovinné

collectiveAgreementsstring[]povinné

disabledQuotanull | objectpovinné

disabledFteintegerpovinné

employeesFtenumberpovinné

sharePercentnumberpovinné

PUT/v1/payroll/settings

curl -X PUT https://api.damedoklad.cz/v1/payroll/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "csszVariableSymbol": "string",
  "csszDistrictCode": "string",
  "taxOfficeCode": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settings', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "csszVariableSymbol": "string",
    "csszDistrictCode": "string",
    "taxOfficeCode": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/payroll/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "csszVariableSymbol": "string",
        "csszDistrictCode": "string",
        "taxOfficeCode": "string"
    },
)
data = response.json()

List annual tax settlements (roční zúčtování) by tax year and status

GET/v1/payroll/settlements

List annual tax settlements (roční zúčtování) by tax year and status

Nástroj MCP: list-payroll-tax-settlements

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

yearintegermin 2000max 2100

status"requested" | "calculated" | "approved" | "paid" | "closed"

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/settlements

curl https://api.damedoklad.cz/v1/payroll/settlements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/settlements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record an employee's request for an annual tax settlement, with deductions, credits, and documents from previous payers

POST/v1/payroll/settlements

Record an employee's request for an annual tax settlement, with deductions, credits, and documents from previous payers

Nástroj MCP: create-payroll-tax-settlement

Tělo požadavku

employeeIdstringpovinné

ID of the employee.

taxYearintegerpovinnémin -9007199254740991max 9007199254740991

requestedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

inputsobject

previousPayersobject[]

namestringpovinnémax 200 chars

incomeHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

advancesHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

bonusesHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

documentReceivedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

filesReturnboolean

otherConcurrentPayerboolean

deductionsobject

donationsHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestMonthsintegermin 0max 12

pensionSupplementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

supplementaryPensionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionInstitutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

lifeInsuranceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermInvestmentHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermCareHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

creditsobject

stoppedExecutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

spouseMonthsintegermin 0max 12

spouseZtppMonthsintegermin 0max 12

disabilityFirstSecondMonthsintegermin 0max 12

disabilityThirdMonthsintegermin 0max 12

ztppMonthsintegermin 0max 12

studentMonthsintegermin 0max 12

childPlacementobject[]

childNamestringmax 200 chars

spentHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

householdsintegermin 1max 10

agreedCapHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

spouseobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

childrenobject[] | null

monthsintegerpovinnémin 0max 12

ztppMonthsintegermin 0max 12

Odpověď · 201

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

POST/v1/payroll/settlements

curl -X POST https://api.damedoklad.cz/v1/payroll/settlements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "taxYear": 2026
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "taxYear": 2026
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/settlements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "taxYear": 2026
    },
)
data = response.json()

Get one annual tax settlement with its calculation by the rows of tiskopis 25 5460/1

GET/v1/payroll/settlements/{id}

Get one annual tax settlement with its calculation by the rows of tiskopis 25 5460/1

Nástroj MCP: get-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

GET/v1/payroll/settlements/{id}

curl https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change the request date or the inputs of a settlement that is not approved. Any calculation must be run again

PATCH/v1/payroll/settlements/{id}

Change the request date or the inputs of a settlement that is not approved. Any calculation must be run again

Nástroj MCP: update-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Tělo požadavku

requestedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

inputsobject

previousPayersobject[]

namestringpovinnémax 200 chars

incomeHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

advancesHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

bonusesHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

documentReceivedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

filesReturnboolean

otherConcurrentPayerboolean

deductionsobject

donationsHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestMonthsintegermin 0max 12

pensionSupplementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

supplementaryPensionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionInstitutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

lifeInsuranceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermInvestmentHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermCareHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

creditsobject

stoppedExecutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

spouseMonthsintegermin 0max 12

spouseZtppMonthsintegermin 0max 12

disabilityFirstSecondMonthsintegermin 0max 12

disabilityThirdMonthsintegermin 0max 12

ztppMonthsintegermin 0max 12

studentMonthsintegermin 0max 12

childPlacementobject[]

childNamestringmax 200 chars

spentHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

householdsintegermin 1max 10

agreedCapHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

spouseobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

childrenobject[] | null

monthsintegerpovinnémin 0max 12

ztppMonthsintegermin 0max 12

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

PATCH/v1/payroll/settlements/{id}

curl -X PATCH https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "requestedOn": "2026-10-30",
  "inputs": {
    "previousPayers": [
      {
        "name": "Pekárna U Lípy s.r.o.",
        "incomeHaler": 1210000,
        "advancesHaler": 1210000,
        "documentReceivedOn": "2026-10-30"
      }
    ],
    "filesReturn": false,
    "otherConcurrentPayer": false
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "requestedOn": "2026-10-30",
    "inputs": {
      "previousPayers": [
        {
          "name": "Pekárna U Lípy s.r.o.",
          "incomeHaler": 1210000,
          "advancesHaler": 1210000,
          "documentReceivedOn": "2026-10-30"
        }
      ],
      "filesReturn": false,
      "otherConcurrentPayer": false
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "requestedOn": "2026-10-30",
        "inputs": {
            "previousPayers": [
                {
                    "name": "Pekárna U Lípy s.r.o.",
                    "incomeHaler": 1210000,
                    "advancesHaler": 1210000,
                    "documentReceivedOn": "2026-10-30"
                }
            ],
            "filesReturn": False,
            "otherConcurrentPayer": False
        }
    },
)
data = response.json()

Delete a settlement that has not been approved

DELETE/v1/payroll/settlements/{id}

Delete a settlement that has not been approved

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/payroll/settlements/{id}

curl -X DELETE https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Approve a calculated settlement. A refund is then paid by the next payroll run that locks; with nothing to pay the settlement closes

POST/v1/payroll/settlements/{id}/approve

Approve a calculated settlement. A refund is then paid by the next payroll run that locks; with nothing to pay the settlement closes

Nástroj MCP: approve-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

POST/v1/payroll/settlements/{id}/approve

curl -X POST https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Calculate the settlement from the locked months of the tax year and the entered inputs. Returns whatever bars it in `problems`

POST/v1/payroll/settlements/{id}/calculate

Calculate the settlement from the locked months of the tax year and the entered inputs. Returns whatever bars it in `problems`

Nástroj MCP: calculate-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

POST/v1/payroll/settlements/{id}/calculate

curl -X POST https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Výpočet daně a daňového zvýhodnění of a settlement as PDF, by the rows of tiskopis 25 5460/1 vzor 29. The rows match, the page is not the printed form

GET/v1/payroll/settlements/{id}/calculation.pdf

Výpočet daně a daňového zvýhodnění of a settlement as PDF, by the rows of tiskopis 25 5460/1 vzor 29. The rows match, the page is not the printed form

Nástroj MCP: get-payroll-tax-settlement-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/payroll/settlements/{id}/calculation.pdf

curl https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculation.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculation.pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/calculation.pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Return an approved settlement to calculated. Refused once a locked run has paid it: unlock that run first

POST/v1/payroll/settlements/{id}/reopen

Return an approved settlement to calculated. Refused once a locked run has paid it: unlock that run first

Nástroj MCP: reopen-payroll-tax-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

employeeIdstringpovinné

employeeNamestringpovinné

taxYearintegerpovinné

statusstringpovinné

requestedOnstringpovinnédate

sourcestringpovinné

deadlinesobjectpovinné

requestBystringpovinnédate

calculateBystringpovinnédate

payWithWageOfobjectpovinné

yearintegerpovinné

monthinteger | nullpovinné

inputsobjectpovinné

deductionsobject

interestHalerintegerpovinné

lifeInsuranceHalerinteger

previousPayersobject[]

namenull | stringpovinné

incomeHalerintegerpovinné

advancesHalerintegerpovinné

documentReceivedOnstringpovinnédate

spousenull | objectpovinné

lastNamenull | stringpovinné

firstNamenull | stringpovinné

birthNumberMaskednull | stringpovinné

creditsobject

spouseMonthsintegerpovinné

childrenobject[]

monthsintegerpovinné

resultnull | objectpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

r23integer

r24integer

r25integer

r26integer

r27integer

r28integer

r29integer

r30integer

r31integer

r32ainteger

r32binteger

yearintegerpovinné

monthsintegerpovinné

creditsobjectpovinné

ztppMonthsintegerpovinné

disabilityThirdMonthsintegerpovinné

disabilityFirstSecondMonthsintegerpovinné

studentMonthsinteger

spouseMonthsinteger

childrenobject[]povinné

monthsintegerpovinné

ztppMonthsinteger

problemsobject[]povinné

codenull | stringpovinné

textstringpovinné

payoutHalerintegerpovinné

balanceHalerintegerpovinné

shortfallHalerintegerpovinné

bonusTopupHalerintegerpovinné

overpaymentHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

formPendingboolean

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

calculatedAtnull | stringpovinnédate-time

approvedAtnull | stringpovinnédate-time

payoutRunIdnull | stringpovinné

paidAtnull | stringpovinnédate-time

POST/v1/payroll/settlements/{id}/reopen

curl -X POST https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Work out a settlement without recording it, also for a year whose form is not published yet (2027), with the student credit and the child placement credit (§ 35bc, § 35bd ZDP). Nothing is stored and no form or filing comes of it: `formPending` says so

POST/v1/payroll/settlements/preview

Work out a settlement without recording it, also for a year whose form is not published yet (2027), with the student credit and the child placement credit (§ 35bc, § 35bd ZDP). Nothing is stored and no form or filing comes of it: `formPending` says so

Nástroj MCP: preview-payroll-tax-settlement

Tělo požadavku

employeeIdstringpovinné

ID of the employee.

taxYearintegerpovinnémin -9007199254740991max 9007199254740991

inputsobject

previousPayersobject[]

namestringpovinnémax 200 chars

incomeHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

advancesHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

bonusesHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

documentReceivedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

filesReturnboolean

otherConcurrentPayerboolean

deductionsobject

donationsHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

interestMonthsintegermin 0max 12

pensionSupplementHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

supplementaryPensionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

pensionInstitutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

lifeInsuranceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermInvestmentHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

longTermCareHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

creditsobject

stoppedExecutionHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

spouseMonthsintegermin 0max 12

spouseZtppMonthsintegermin 0max 12

disabilityFirstSecondMonthsintegermin 0max 12

disabilityThirdMonthsintegermin 0max 12

ztppMonthsintegermin 0max 12

studentMonthsintegermin 0max 12

childPlacementobject[]

childNamestringmax 200 chars

spentHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

householdsintegermin 1max 10

agreedCapHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

spouseobject | null

firstNamestringpovinnémax 200 chars

lastNamestringpovinnémax 200 chars

birthNumberstring | null

birthDatestring | null

Date as YYYY-MM-DD.

ztppboolean

childrenobject[] | null

monthsintegerpovinnémin 0max 12

ztppMonthsintegermin 0max 12

Odpověď · 200

employeeIdnull | stringpovinné

taxYearintegerpovinné

monthsintegerpovinné

yearintegerpovinné

formPendingbooleanpovinné

rowsobjectpovinné

r1integerpovinné

r2integerpovinné

r3integerpovinné

r4integerpovinné

r5integerpovinné

r6integerpovinné

r7integerpovinné

r8integerpovinné

r9integerpovinné

r10integerpovinné

r11integerpovinné

r12integerpovinné

r13integerpovinné

r14integerpovinné

r15integerpovinné

r16integerpovinné

r17integerpovinné

r18integerpovinné

r19integerpovinné

r20integerpovinné

r21integerpovinné

r22integerpovinné

studentCreditHalerintegerpovinné

childPlacementHalerintegerpovinné

r23integerpovinné

overpaymentHalerintegerpovinné

bonusTopupHalerintegerpovinné

payoutHalerintegerpovinné

shortfallHalerintegerpovinné

balanceHalerintegerpovinné

belowPayoutMinimumbooleanpovinné

POST/v1/payroll/settlements/preview

curl -X POST https://api.damedoklad.cz/v1/payroll/settlements/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "taxYear": 2026
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/settlements/preview', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "taxYear": 2026
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/settlements/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "taxYear": 2026
    },
)
data = response.json()

List eNeschopenka sick notes

GET/v1/payroll/sick-notes

List eNeschopenka sick notes

Nástroj MCP: list-payroll-sick-notes

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

status"open" | "closed" | "cancelled"

Odpověď · 200

dataobject[]povinné

object"payroll_sick_note"povinné

idstringpovinné

employeeIdnull | stringpovinné

decisionNumberstringpovinné

namenull | stringpovinné

birthDatenull | stringpovinnédate

fromstringpovinnédate

tostringpovinnédate

statusstringpovinné

workAccidentbooleanpovinné

notenull | stringpovinné

insertedAtstring | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payroll/sick-notes

curl https://api.damedoklad.cz/v1/payroll/sick-notes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/sick-notes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

HZUPN20: the employer's report when a sick note ends (§ 97 odst. 4 zák. 187/2006 Sb.), valid against the ČSSZ XSD. You send it: nothing goes to ČSSZ from here

POST/v1/payroll/sick-notes/{id}/hzupn.xml

HZUPN20: the employer's report when a sick note ends (§ 97 odst. 4 zák. 187/2006 Sb.), valid against the ČSSZ XSD. You send it: nothing goes to ČSSZ from here

Nástroj MCP: create-payroll-sick-end-xml

Parametry v cestě

idstringpovinné

Tělo požadavku

returnedbooleanpovinné

returnDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

reasonstringmax 200 chars

hoursWorkednumbermin 0max 24

shiftHoursnumbermin 0max 24

workedIntervalsobject[]

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

correctionboolean

Odpověď · 200

Vrací soubor application/xml.

POST/v1/payroll/sick-notes/{id}/hzupn.xml

curl -X POST https://api.damedoklad.cz/v1/payroll/sick-notes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hzupn.xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "returned": false
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hzupn.xml', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "returned": false
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hzupn.xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "returned": False
    },
)
content = response.content

Whether eNeschopenka notifications can be read straight from ČSSZ (DZDPN20-V2), on which channel, and the latest queries. Off unless the operator enabled it

GET/v1/payroll/sick-notes/direct

Whether eNeschopenka notifications can be read straight from ČSSZ (DZDPN20-V2), on which channel, and the latest queries. Off unless the operator enabled it

Nástroj MCP: get-payroll-dzdpn-status

Odpověď · 200

enabledbooleanpovinné

channelEnabledbooleanpovinné

modenull | stringpovinné

certificateSubjectnull | stringpovinné

certificateNotAfternull | stringpovinnédate-time

queriesobject[]povinné

object"payroll_dzdpn_query"povinné

idstringpovinné

fromstringpovinnédate

tostringpovinnédate

modestringpovinné

statusstringpovinné

messagenull | stringpovinné

notificationCountintegerpovinné

importedCountintegerpovinné

createdAtstringpovinnédate-time

answeredAtnull | stringpovinnédate-time

GET/v1/payroll/sick-notes/direct

curl https://api.damedoklad.cz/v1/payroll/sick-notes/direct \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/direct', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/direct",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Ask ČSSZ for the eNeschopenka notifications of up to 31 days (DZDPN20-V2), signed and encrypted over the cssz_vrep channel. ČSSZ answers later: read it with the poll operation. ČSSZ refuses a repeated request the same day, and so does the app

POST/v1/payroll/sick-notes/direct

Ask ČSSZ for the eNeschopenka notifications of up to 31 days (DZDPN20-V2), signed and encrypted over the cssz_vrep channel. ČSSZ answers later: read it with the poll operation. ČSSZ refuses a repeated request the same day, and so does the app

Nástroj MCP: create-payroll-dzdpn-query

Tělo požadavku

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

fromstringpovinnédate

tostringpovinnédate

modestringpovinné

statusstringpovinné

messagenull | stringpovinné

notificationCountintegerpovinné

importedCountintegerpovinné

createdAtstringpovinnédate-time

answeredAtnull | stringpovinnédate-time

POST/v1/payroll/sick-notes/direct

curl -X POST https://api.damedoklad.cz/v1/payroll/sick-notes/direct \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "2026-10-30",
  "to": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/direct', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "from": "2026-10-30",
    "to": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/direct",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "from": "2026-10-30",
        "to": "2026-10-30"
    },
)
data = response.json()

See whether ČSSZ has answered a query. An answer is decrypted, read into sick notes as a file import would be, and the transaction closed. What was imported is matched to employees; the answer itself is not stored

POST/v1/payroll/sick-notes/direct/{id}/poll

See whether ČSSZ has answered a query. An answer is decrypted, read into sick notes as a file import would be, and the transaction closed. What was imported is matched to employees; the answer itself is not stored

Nástroj MCP: poll-payroll-dzdpn-query

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

fromstringpovinnédate

tostringpovinnédate

modestringpovinné

statusstringpovinné

messagenull | stringpovinné

notificationCountintegerpovinné

importedCountintegerpovinné

createdAtstringpovinnédate-time

answeredAtnull | stringpovinnédate-time

POST/v1/payroll/sick-notes/direct/{id}/poll

curl -X POST https://api.damedoklad.cz/v1/payroll/sick-notes/direct/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/poll \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/direct/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/poll', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/direct/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/poll",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Read eNeschopenka notifications from ČSSZ, a data box XML or a DZDPN20-V2 answer, into sick notes, and match them to employees. Importing the same file again changes nothing. Nothing goes to ČSSZ

POST/v1/payroll/sick-notes/import

Read eNeschopenka notifications from ČSSZ, a data box XML or a DZDPN20-V2 answer, into sick notes, and match them to employees. Importing the same file again changes nothing. Nothing goes to ČSSZ

Nástroj MCP: import-payroll-sick-notes

Tělo požadavku

xmlstringpovinnémax 5000000 chars

Odpověď · 201

notificationCountintegerpovinné

importedintegerpovinné

updatedintegerpovinné

ignoredintegerpovinné

unmatchedobject[]povinné

object"payroll_sick_note"povinné

idstringpovinné

employeeIdnull | stringpovinné

decisionNumberstringpovinné

namenull | stringpovinné

birthDatenull | stringpovinnédate

fromstringpovinnédate

tostringpovinnédate

statusstringpovinné

workAccidentbooleanpovinné

notenull | stringpovinné

insertedAtstring | nullpovinné

POST/v1/payroll/sick-notes/import

curl -X POST https://api.damedoklad.cz/v1/payroll/sick-notes/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "xml": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "xml": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "xml": "string"
    },
)
data = response.json()

Mark the days of matched sick notes as sick in attendance. An open note runs to today, so inserting again extends it. A locked month or another absence on the day is left alone and reported

POST/v1/payroll/sick-notes/insert

Mark the days of matched sick notes as sick in attendance. An open note runs to today, so inserting again extends it. A locked month or another absence on the day is left alone and reported

Nástroj MCP: insert-payroll-sick-notes

Tělo požadavku

noteIdsstring[]

Odpověď · 200

insertedCountintegerpovinné

resultsobject[]povinné

idstringpovinné

namenull | stringpovinné

conflictsstring[]povinné

lockedMonthsstring[]povinné

POST/v1/payroll/sick-notes/insert

curl -X POST https://api.damedoklad.cz/v1/payroll/sick-notes/insert \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "noteIds": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payroll/sick-notes/insert', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "noteIds": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payroll/sick-notes/insert",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "noteIds": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()