Přejít na obsah

Cesty a vozidla

Operace ve skupině Cesty a vozidla.

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

List fuel purchases

GET/v1/fuel-purchases

List fuel purchases

Nástroj MCP: list-fuel-purchases

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.
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Odpověď · 200

dataobject[]povinné
object"vehicle_fuel_purchase"povinné
idstringpovinné
vehicleIdstringpovinné
purchasedOnstringpovinnédate
quantityMilliintegerpovinné
amountHalerintegerpovinné
odometerinteger | null
vendornull | stringpovinné
notenull | string
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/fuel-purchases
curl https://api.damedoklad.cz/v1/fuel-purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does

POST/v1/fuel-purchases

Record a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does

Nástroj MCP: create-fuel-purchase

Tělo požadavku

vehicleIdstringpovinné
ID of the vehicle. Find it with list-vehicles.
purchasedOnstringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
quantityMilliintegerpovinnémin 1max 9007199254740991
Integer thousandths: 1500 means 1.5.
amountHalerintegerpovinnémin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
odometerintegermin 0max 9007199254740991
vendorstringmax 500 chars
notestringmax 2000 chars

Odpověď · 201

idstringpovinné
vehicleIdstringpovinné
purchasedOnstringpovinnédate
quantityMilliintegerpovinné
amountHalerintegerpovinné
odometerinteger | null
vendornull | stringpovinné
notenull | string
POST/v1/fuel-purchases
curl -X POST https://api.damedoklad.cz/v1/fuel-purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "purchasedOn": "2026-10-30",
  "quantityMilli": 1000,
  "amountHaler": 1210000
}'

Delete a fuel purchase

DELETE/v1/fuel-purchases/{id}

Delete a fuel purchase

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

Nástroj MCP: delete-fuel-purchase

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
DELETE/v1/fuel-purchases/{id}
curl -X DELETE https://api.damedoklad.cz/v1/fuel-purchases/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Import a fuel card statement as CSV: date, litres, and amount with VAT required; plate, product, station, card, and odometer optional. dryRun only validates

POST/v1/fuel-purchases/import

Import a fuel card statement as CSV: date, litres, and amount with VAT required; plate, product, station, card, and odometer optional. dryRun only validates. Lines for anything but fuel, such as a car wash, are skipped and listed. Other headers go through columnMap. A purchase already recorded (same vehicle, date, litres, and amount) is skipped. It does not post to the books; the invoice from the card issuer does.

Nástroj MCP: import-fuel-card

Tělo požadavku

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
csvstringmax 4000000 chars
fileBase64stringmax 8000000 chars
File content encoded as base64.
columnMapobject
dryRunboolean

Odpověď · 200

dryRunbooleanpovinné
importedintegerpovinné
validintegerpovinné
duplicatesintegerpovinné
skippedobject[]povinné
lineintegerpovinné
productstringpovinné
errorsobject[]povinné
lineintegerpovinné
messagenull | stringpovinné
totalQuantityMilliintegerpovinné
totalAmountHalerintegerpovinné
headersanypovinné
Null in every recorded response.
missinganypovinné
Null in every recorded response.
POST/v1/fuel-purchases/import
curl -X POST https://api.damedoklad.cz/v1/fuel-purchases/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "csv": "string",
  "fileBase64": "string"
}'

Logbook of a year for the tax authority as a PDF: all trips, monthly km, business share, fuel against the technical certificate, and odometer problems

GET/v1/logbook-export.pdf

Logbook of a year for the tax authority as a PDF: all trips, monthly km, business share, fuel against the technical certificate, and odometer problems. The Income Tax Act prescribes no form for a logbook. The taxpayer proves the expense (§ 92 odst. 3 daňového řádu), so the export states everything that proof rests on. Pass vehicleId for one vehicle.

Nástroj MCP: export-logbook-for-authority-pdf

Parametry dotazu

yearintegerpovinnémin 1990max 2100
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/logbook-export.pdf
curl https://api.damedoklad.cz/v1/logbook-export.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Logbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle

GET/v1/logbook-export.xlsx

Logbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle

Nástroj MCP: export-logbook-for-authority-xlsx

Parametry dotazu

yearintegerpovinnémin 1990max 2100
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Odpověď · 200

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

GET/v1/logbook-export.xlsx
curl https://api.damedoklad.cz/v1/logbook-export.xlsx \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Paušální výdaj na dopravu for a year (§ 24 odst. 2 písm. zt) ZDP): 5 000 Kč per vehicle and month, 4 000 Kč when reduced. The tax module reads this

GET/v1/transport-flat-rate

Paušální výdaj na dopravu for a year (§ 24 odst. 2 písm. zt) ZDP): 5 000 Kč per vehicle and month, 4 000 Kč when reduced. The tax module reads this

Nástroj MCP: get-transport-flat-rate

Parametry dotazu

yearintegerpovinnémin 1990max 2100

Odpověď · 200

yearintegerpovinné
vehiclesobject[]povinné
vehicleIdstringpovinné
modestringpovinné
monthlyHalerintegerpovinné
monthsobject[]povinné
monthinteger | nullpovinné
daysintegerpovinné
amountHalerinteger | nullpovinné
amountHalerinteger | nullpovinné
totalHalerinteger | nullpovinné
reducedCountintegerpovinné
monthlyHalerinteger
reducedPctinteger
maxVehiclesinteger
GET/v1/transport-flat-rate
curl https://api.damedoklad.cz/v1/transport-flat-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Choose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none

PUT/v1/transport-flat-rate

Choose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none

Nástroj MCP: set-transport-flat-rate

Tělo požadavku

vehicleIdstringpovinné
ID of the vehicle. Find it with list-vehicles.
yearintegerpovinnémin 1990max 2100
mode"full" | "reduced" | "none"povinné
validFromstringYYYY-MM-DD
Date as YYYY-MM-DD.
validTostringYYYY-MM-DD
Date as YYYY-MM-DD.

Odpověď · 200

yearintegerpovinné
vehiclesobject[]povinné
vehicleIdstringpovinné
modestringpovinné
monthlyHalerintegerpovinné
monthsobject[]povinné
monthinteger | nullpovinné
daysintegerpovinné
amountHalerinteger | nullpovinné
amountHalerinteger | nullpovinné
totalHalerinteger | nullpovinné
reducedCountintegerpovinné
monthlyHalerinteger
reducedPctinteger
maxVehiclesinteger
PUT/v1/transport-flat-rate
curl -X PUT https://api.damedoklad.cz/v1/transport-flat-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "year": 2026,
  "mode": "full"
}'

Seznam: zaměstnanec, cesty a vozidla

GET/v1/travel-employees

Employees that a business trip can be linked to: id and name only

Nástroj MCP: list-travel-employees

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"travel_employee"povinné
idstringpovinné
namenull | stringpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/travel-employees
curl https://api.damedoklad.cz/v1/travel-employees \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List business trip orders (cestovní příkazy)

GET/v1/travel-orders

List business trip orders (cestovní příkazy)

Nástroj MCP: list-travel-orders

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
status"draft" | "settled" | "paid"

Odpověď · 200

dataobject[]povinné
object"travel_order"povinné
idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/travel-orders
curl https://api.damedoklad.cz/v1/travel-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a domestic or foreign business trip order; add abroad segments and expenses to it

POST/v1/travel-orders

Create a domestic or foreign business trip order; add abroad segments and expenses to it

Nástroj MCP: create-travel-order

Tělo požadavku

travelerNamestringmax 200 chars
employeeIdstring | null
ID of the employee.
interruptionsobject[]
fromAtstringpovinné
toAtstringpovinné
familyVisitsobject[]
fromAtstringpovinné
toAtstringpovinné
fareHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
limitHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
fareCentsintegermin 0max 9007199254740991
limitCentsintegermin 0max 9007199254740991
familyVisitAgreedboolean
agreedMealsobject
tier5to12integermin 0max 9007199254740991
tier12to18integermin 0max 9007199254740991
over18integermin 0max 9007199254740991
mealCutsobject
tier5to12numbermin 0max 70
tier12to18numbermin 0max 35
over18numbermin 0max 25
foreignRatePctinteger | null
fareEquivalentHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
travelerKind"employee" | "owner"
purposestringpovinnémax 200 chars
destinationstringpovinnémax 200 chars
startAtstringpovinné
endAtstringpovinné
transport"public" | "company_car" | "private_car" | "equivalent" | "other"
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
trailerboolean
documentedFuelPriceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
basicRateHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
pocketMoneyPctintegermin 0max 40
freeMealsobject
exchangeRatesobject
advanceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
abroadobject[]
countryCodestringpovinnémin 2 charsmax 20 chars
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kind"accommodation" | "transport" | "parking" | "other"
descriptionstringmax 500 chars
amountCentsintegerpovinnémin 0max 9007199254740991
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
vatHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
notestringmax 2000 chars

Odpověď · 201

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders
curl -X POST https://api.damedoklad.cz/v1/travel-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "purpose": "string",
  "destination": "string",
  "startAt": "2026-10-30T08:00",
  "endAt": "2026-10-30T08:00"
}'

Get a business trip order with its time abroad and expenses

GET/v1/travel-orders/{id}

Get a business trip order with its time abroad and expenses

Nástroj MCP: get-travel-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
GET/v1/travel-orders/{id}
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Edit a business trip order before it is settled

PATCH/v1/travel-orders/{id}

Edit a business trip order before it is settled

Nástroj MCP: update-travel-order

Parametry v cestě

idstringpovinné

Tělo požadavku

travelerNamestringmax 200 chars
employeeIdstring | null
ID of the employee.
interruptionsobject[]
fromAtstringpovinné
toAtstringpovinné
familyVisitsobject[]
fromAtstringpovinné
toAtstringpovinné
fareHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
limitHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
fareCentsintegermin 0max 9007199254740991
limitCentsintegermin 0max 9007199254740991
familyVisitAgreedboolean
agreedMealsobject
tier5to12integermin 0max 9007199254740991
tier12to18integermin 0max 9007199254740991
over18integermin 0max 9007199254740991
mealCutsobject
tier5to12numbermin 0max 70
tier12to18numbermin 0max 35
over18numbermin 0max 25
foreignRatePctinteger | null
fareEquivalentHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
travelerKind"employee" | "owner"
purposestringmax 200 chars
destinationstringmax 200 chars
startAtstring
endAtstring
transport"public" | "company_car" | "private_car" | "equivalent" | "other"
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
trailerboolean
documentedFuelPriceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
basicRateHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
pocketMoneyPctintegermin 0max 40
freeMealsobject
exchangeRatesobject
advanceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
abroadobject[]
countryCodestringpovinnémin 2 charsmax 20 chars
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kind"accommodation" | "transport" | "parking" | "other"
descriptionstringmax 500 chars
amountCentsintegerpovinnémin 0max 9007199254740991
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
vatHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
notestringmax 2000 chars

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
PATCH/v1/travel-orders/{id}
curl -X PATCH https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "travelerName": "Pekárna U Lípy s.r.o.",
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "interruptions": [
    {
      "fromAt": "2026-10-30T08:00",
      "toAt": "2026-10-30T08:00"
    }
  ]
}'

Delete a business trip order that has not been settled and has no paid advance

DELETE/v1/travel-orders/{id}

Delete a business trip order that has not been settled and has no paid advance

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

Nástroj MCP: delete-travel-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
DELETE/v1/travel-orders/{id}
curl -X DELETE https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Pay out the trip advance: MD 335 / D 211xxx or 221xxx, or a non-tax cash book row. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over. A movement can also pay it directly (POST /bank-movements/{id}/match with kind travel_advance)

POST/v1/travel-orders/{id}/advance

Pay out the trip advance: MD 335 / D 211xxx or 221xxx, or a non-tax cash book row. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over. A movement can also pay it directly (POST /bank-movements/{id}/match with kind travel_advance)

Nástroj MCP: pay-travel-advance

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
method"transfer" | "cash" | "card"
registerIdstring
ID of the register.
bankAccountIdstring
ID of the bank account. Find it with list-bank-accounts.
amountHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders/{id}/advance
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/advance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Download a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines

GET/v1/travel-orders/{id}/order.pdf

Download a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines

Nástroj MCP: export-travel-order-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/travel-orders/{id}/order.pdf
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/order.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Pay the reimbursement (MD 333 / D 221xxx or 211xxx) or take back an overpaid advance (MD 211xxx or 221xxx / D 335), rounded up to whole koruny. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over

POST/v1/travel-orders/{id}/pay

Pay the reimbursement (MD 333 / D 221xxx or 211xxx) or take back an overpaid advance (MD 211xxx or 221xxx / D 335), rounded up to whole koruny. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over

Nástroj MCP: pay-travel-order

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
method"transfer" | "cash" | "card"
registerIdstring
ID of the register.
bankAccountIdstring
ID of the bank account. Find it with list-bank-accounts.

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders/{id}/pay
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pay \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Pay a settled trip through the payroll of a month: the amount joins the wage payment, untaxed, and the order is paid when the run locks

POST/v1/travel-orders/{id}/payroll

Pay a settled trip through the payroll of a month: the amount joins the wage payment, untaxed, and the order is paid when the run locks. Needs an employee on the order with a contract in that month. Payroll posts MD 333 / D 331 when the run locks. A draft or reviewed run is recalculated, and a reviewed one returns to draft.

Nástroj MCP: queue-travel-reimbursement

Parametry v cestě

idstringpovinné

Tělo požadavku

yearintegerpovinnémin 1990max 2100
monthintegerpovinnémin 1max 12

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders/{id}/payroll
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payroll \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "month": 1
}'

Take a trip back out of a payroll run that is not locked yet

POST/v1/travel-orders/{id}/payroll/cancel

Take a trip back out of a payroll run that is not locked yet

Nástroj MCP: cancel-travel-reimbursement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders/{id}/payroll/cancel
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payroll/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Which ČNB rates a trip needs and for which date (§ 183 odst. 2, § 184 of the Labour Code). Get them from /ledger/exchange-rates/lookup and PATCH them into exchangeRates

GET/v1/travel-orders/{id}/required-rates

Which ČNB rates a trip needs and for which date (§ 183 odst. 2, § 184 of the Labour Code). Get them from /ledger/exchange-rates/lookup and PATCH them into exchangeRates

Nástroj MCP: get-travel-order-required-rates

Parametry v cestě

idstringpovinné

Odpověď · 200

orderIdnull | stringpovinné
datestringpovinnédate
currenciesobject[]povinné
currencynull | stringpovinné
ratenull | numberpovinné
GET/v1/travel-orders/{id}/required-rates
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/required-rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Settle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335

POST/v1/travel-orders/{id}/settle

Settle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335

Nástroj MCP: settle-travel-order

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné
numberstringpovinné
travelerNamestringpovinné
travelerKindstringpovinné
purposestringpovinné
destinationstringpovinné
startAtstringpovinné
endAtstringpovinné
transportstringpovinné
vehicleIdnull | stringpovinné
kmMilliintegerpovinné
trailerbooleanpovinné
documentedFuelPriceHalerinteger | nullpovinné
basicRateHalerinteger | nullpovinné
pocketMoneyPctintegerpovinné
freeMealsobjectpovinné
exchangeRatesobjectpovinné
advanceHalerintegerpovinné
advancePaidOnnull | stringpovinnédate
statusstringpovinné
totalHalerintegerpovinné
settleHalerintegerpovinné
settledOnnull | stringpovinnédate
paidOnnull | stringpovinnédate
notestring | nullpovinné
employeeIdnull | stringpovinné
interruptionsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
familyVisitsobject[]povinné
toAtstringpovinné
fromAtstringpovinné
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanpovinné
agreedMealsobjectpovinné
tier5to12integer
mealCutsobjectpovinné
tier12to18integer
foreignRatePctinteger | nullpovinné
fareEquivalentHalerintegerpovinné
payMethodnull | stringpovinné
payrollYearinteger | nullpovinné
payrollMonthinteger | nullpovinné
settlementnull | objectpovinné
daysobject[]povinné
datestringpovinnédate
tiernull | stringpovinné
foreignnull | objectpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
grossCentsintegerpovinné
amountCentsintegerpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
fractionThirdsintegerpovinné
reductionCentsintegerpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
amountHalerinteger | nullpovinné
abroadMinutesintegerpovinné
reductionHalerintegerpovinné
domesticMinutesintegerpovinné
taxableExcessHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
fuelHalerintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
totalHalerintegerpovinné
consumedMilliintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
expensesobject[]povinné
kindstringpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountCentsintegerpovinné
amountHalerinteger | nullpovinné
descriptionnull | stringpovinné
vatHalerinteger | nullpovinné
warningsany[]povinné
totalHalerintegerpovinné
settleHalerintegerpovinné
advanceHalerintegerpovinné
familyVisitsobject[]povinné
tostringpovinné
fromstringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
mileageHalerintegerpovinné
expensesHalerintegerpovinné
roundingHalerintegerpovinné
familyVisitHalerintegerpovinné
foreignMealHalerintegerpovinné
pocketMoneyHalerintegerpovinné
domesticMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
taxableExcessHalerintegerpovinné
fareEquivalentHalerintegerpovinné
abroadobject[]
countryCodenull | stringpovinné
fromAtstringpovinné
toAtstringpovinné
expensesobject[]
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
POST/v1/travel-orders/{id}/settle
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Náhled: likvidace, cesty a vozidla

GET/v1/travel-orders/{id}/settlement-preview

Compute the settlement of a business trip without posting: stravné by day, mileage, expenses, advance, and the amount to pay

Nástroj MCP: preview-travel-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

orderIdnull | stringpovinné
daysobject[]povinné
datestringpovinnédate
domesticMinutesintegerpovinné
abroadMinutesintegerpovinné
tiernull | stringpovinné
freeMealsintegerpovinné
grossHalerintegerpovinné
reductionHalerintegerpovinné
amountHalerinteger | nullpovinné
taxableExcessHalerintegerpovinné
foreignnull | objectpovinné
countryCodenull | stringpovinné
countryNamestringpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
fractionThirdsintegerpovinné
grossCentsintegerpovinné
reductionCentsintegerpovinné
amountCentsintegerpovinné
domesticMealHalerintegerpovinné
foreignMealHalerintegerpovinné
foreignByCurrencyobjectpovinné
pocketMoneyHalerintegerpovinné
mileageHalerintegerpovinné
fareEquivalentHalerintegerpovinné
familyVisitsobject[]povinné
fromstringpovinné
tostringpovinné
fareHalerintegerpovinné
limitHalerintegerpovinné
amountHalerinteger | nullpovinné
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitHalerintegerpovinné
warningsany[]povinné
taxableExcessHalerintegerpovinné
expensesHalerintegerpovinné
expensesobject[]povinné
kindstringpovinné
descriptionnull | stringpovinné
amountCentsintegerpovinné
currencynull | stringpovinné
vatHalerinteger | nullpovinné
amountHalerinteger | nullpovinné
vatHalerinteger | nullpovinné
totalHalerinteger | nullpovinné
advanceHalerintegerpovinné
settleHalerintegerpovinné
roundingHalerintegerpovinné
mileagenull | objectpovinné
kmMilliintegerpovinné
rateHalerintegerpovinné
basicHalerintegerpovinné
fuelPriceHalerintegerpovinné
fuelPriceSourcestringpovinné
consumedMilliintegerpovinné
fuelHalerintegerpovinné
totalHalerinteger | nullpovinné
GET/v1/travel-orders/{id}/settlement-preview
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settlement-preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Statutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems

GET/v1/travel-rates

Statutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems

Nástroj MCP: get-travel-rates

Parametry dotazu

yearintegermin 1990max 2100

Odpověď · 200

yearintegerpovinné
citationstringpovinné
mileageHalerobjectpovinné
motorcycleintegerpovinné
carintegerpovinné
mealsHalerobjectpovinné
tier5to12integerpovinné
tier12to18integerpovinné
over18integerpovinné
mealsMaxHalerobjectpovinné
tier5to12integerpovinné
tier12to18integerpovinné
over18integerpovinné
fuelHalerobject[]povinné
fromstringpovinnédate
ba95integerpovinné
ba98integerpovinné
dieselintegerpovinné
electricityintegerpovinné
foreignobject[]povinné
countryCodenull | stringpovinné
namenull | stringpovinné
currencynull | stringpovinné
baseAmountintegerpovinné
GET/v1/travel-rates
curl https://api.damedoklad.cz/v1/travel-rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List logbook trips, filterable by vehicle, type, and date

GET/v1/trips

List logbook trips, filterable by vehicle, type, and date

Nástroj MCP: list-trips

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.
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
tripType"business" | "private"

Odpověď · 200

dataobject[]povinné
object"vehicle_trip"povinné
idstringpovinné
vehicleIdstringpovinné
routeIdnull | stringpovinné
datestringpovinnédate
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
drivernull | stringpovinné
odometerStartinteger | nullpovinné
odometerEndinteger | nullpovinné
notestring | null
continuityIssuesobject[]
idstringpovinné
datestringpovinnédate
kindstringpovinné
expectedintegerpovinné
actualintegerpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/trips
curl https://api.damedoklad.cz/v1/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add a logbook trip. Pass routeId to fill it from a recurring route; the odometer continues from the last trip

POST/v1/trips

Add a logbook trip. Pass routeId to fill it from a recurring route; the odometer continues from the last trip. The trip is saved even when the odometer does not chain, since unrecorded private driving happens. The response lists any problem in continuityIssues.

Nástroj MCP: create-trip

Tělo požadavku

vehicleIdstringpovinné
ID of the vehicle. Find it with list-vehicles.
routeIdstring
ID of the route.
datestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"
driverstringmax 500 chars
odometerStartintegermin 0max 9007199254740991
odometerEndintegermin 0max 9007199254740991
notestringmax 2000 chars

Odpověď · 201

idstringpovinné
vehicleIdstringpovinné
routeIdnull | stringpovinné
datestringpovinnédate
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
drivernull | stringpovinné
odometerStartinteger | nullpovinné
odometerEndinteger | nullpovinné
notestring | null
continuityIssuesobject[]
idstringpovinné
datestringpovinnédate
kindstringpovinné
expectedintegerpovinné
actualintegerpovinné
POST/v1/trips
curl -X POST https://api.damedoklad.cz/v1/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "date": "2026-10-30"
}'

Correct a logbook trip

PATCH/v1/trips/{id}

Correct a logbook trip

Nástroj MCP: update-trip

Parametry v cestě

idstringpovinné

Tělo požadavku

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
routeIdstring
ID of the route.
datestringYYYY-MM-DD
Date as YYYY-MM-DD.
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"
driverstringmax 500 chars
odometerStartintegermin 0max 9007199254740991
odometerEndintegermin 0max 9007199254740991
notestringmax 2000 chars

Odpověď · 200

idstringpovinné
vehicleIdstringpovinné
routeIdnull | stringpovinné
datestringpovinnédate
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
drivernull | stringpovinné
odometerStartinteger | nullpovinné
odometerEndinteger | nullpovinné
notestring | null
continuityIssuesobject[]
idstringpovinné
datestringpovinnédate
kindstringpovinné
expectedintegerpovinné
actualintegerpovinné
PATCH/v1/trips/{id}
curl -X PATCH https://api.damedoklad.cz/v1/trips/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "routeId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "date": "2026-10-30"
}'

Delete a logbook trip

DELETE/v1/trips/{id}

Delete a logbook trip

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

Nástroj MCP: delete-trip

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
DELETE/v1/trips/{id}
curl -X DELETE https://api.damedoklad.cz/v1/trips/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Import logbook trips from a CSV or fleet export (date, from, to, km required; purpose, type, driver, odometer, plate optional). dryRun only validates

POST/v1/trips/import

Import logbook trips from a CSV or fleet export (date, from, to, km required; purpose, type, driver, odometer, plate optional). dryRun only validates. Columns are found by name in Czech or English. For other headers pass columnMap, such as { "date": "Kdy" }; the answer lists headers and missing when it cannot find them. Without vehicleId the plate column picks the vehicle. A trip already in the logbook (same vehicle, date, route, and km) is skipped.

Nástroj MCP: import-trips

Tělo požadavku

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
csvstringmax 4000000 chars
fileBase64stringmax 8000000 chars
File content encoded as base64.
columnMapobject
dryRunboolean

Odpověď · 200

dryRunbooleanpovinné
importedintegerpovinné
validintegerpovinné
duplicatesintegerpovinné
errorsobject[]povinné
lineintegerpovinné
messagenull | stringpovinné
continuityIssuesany[]povinné
headersarray | nullpovinné
missingarray | nullpovinné
POST/v1/trips/import
curl -X POST https://api.damedoklad.cz/v1/trips/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "csv": "string",
  "fileBase64": "string"
}'

List VehicleRoutes

GET/v1/vehicle-routes

List VehicleRoutes

Nástroj MCP: list-vehicle-routes

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"vehicle_route"povinné
idstringpovinné
namestringpovinné
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/vehicle-routes
curl https://api.damedoklad.cz/v1/vehicle-routes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a VehicleRoute

POST/v1/vehicle-routes

Create a VehicleRoute

Nástroj MCP: create-vehicle-route

Tělo požadavku

namestringpovinnémax 200 chars
fromPlacestringpovinnémax 200 chars
toPlacestringpovinnémax 200 chars
purposestringmax 500 chars
kmMilliintegerpovinnémin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"

Odpověď · 201

idstringpovinné
namestringpovinné
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
POST/v1/vehicle-routes
curl -X POST https://api.damedoklad.cz/v1/vehicle-routes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "fromPlace": "string",
  "toPlace": "string",
  "kmMilli": 1000
}'

Get a VehicleRoute

GET/v1/vehicle-routes/{id}

Get a VehicleRoute

Nástroj MCP: get-vehicle-route

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
namestringpovinné
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
GET/v1/vehicle-routes/{id}
curl https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Update a VehicleRoute

PATCH/v1/vehicle-routes/{id}

Update a VehicleRoute

Nástroj MCP: update-vehicle-route

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"

Odpověď · 200

idstringpovinné
namestringpovinné
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
PATCH/v1/vehicle-routes/{id}
curl -X PATCH https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "fromPlace": "string",
  "toPlace": "string"
}'

Delete a VehicleRoute

DELETE/v1/vehicle-routes/{id}

Delete a VehicleRoute

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

Nástroj MCP: delete-vehicle-route

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
DELETE/v1/vehicle-routes/{id}
curl -X DELETE https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Fill the logbook from a recurring route without GPS: one trip for each listed date or weekday in a period, optionally there and back

POST/v1/vehicle-routes/{id}/trips

Fill the logbook from a recurring route without GPS: one trip for each listed date or weekday in a period, optionally there and back. Pass dates, or from and to with weekdays (1 Monday to 7 Sunday, default Monday to Friday). Odometer readings chain from the vehicle’s last trip. Dates where this route is already in the logbook are skipped. dryRun only returns the trips.

Nástroj MCP: generate-trips-from-route

Parametry v cestě

idstringpovinné

Tělo požadavku

vehicleIdstringpovinné
ID of the vehicle. Find it with list-vehicles.
datesstring[]
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
weekdaysinteger[]
skipstring[]
roundTripboolean
driverstringmax 500 chars
dryRunboolean

Odpověď · 200

dryRunbooleanpovinné
createdintegerpovinné
skippedDatesstring[]povinné
lastOdometerintegerpovinné
tripsobject[]povinné
object"vehicle_trip"povinné
idstringpovinné
vehicleIdstringpovinné
routeIdnull | stringpovinné
datestringpovinnédate
fromPlacestringpovinné
toPlacestringpovinné
purposenull | stringpovinné
kmMilliintegerpovinné
tripTypestringpovinné
drivernull | stringpovinné
odometerStartinteger | nullpovinné
odometerEndinteger | nullpovinné
notestring | null
continuityIssuesobject[]
idstringpovinné
datestringpovinnédate
kindstringpovinné
expectedintegerpovinné
actualintegerpovinné
POST/v1/vehicle-routes/{id}/trips
curl -X POST https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

Seznam: vozidlo

GET/v1/vehicles

List Vehicles

Nástroj MCP: list-vehicles

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"vehicle"povinné
idstringpovinné
registrationPlatestringpovinné
namestringpovinné
kindstringpovinné
categorynull | stringpovinné
fuelstringpovinné
ownershipstringpovinné
odometerStartintegerpovinné
consumptionMilliintegerpovinné
vinnull | stringpovinné
firstRegisteredOnstring | nullpovinné
grossWeightKginteger | nullpovinné
axlesinteger | nullpovinné
engineCcinteger | nullpovinné
roadTaxRelevantbooleanpovinné
assetIdnull | stringpovinné
isActivebooleanpovinné
notestring | nullpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/vehicles
curl https://api.damedoklad.cz/v1/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Vytvoření: vozidlo

POST/v1/vehicles

Create a Vehicle

Nástroj MCP: create-vehicle

Tělo požadavku

registrationPlatestringpovinnémax 20 chars
namestringpovinnémax 200 chars
kind"car" | "motorcycle" | "truck" | "bus" | "tractor"
categorystringmax 10 chars
fuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"povinné
ownership"company" | "private" | "leased"
odometerStartintegermin 0max 9007199254740991
consumptionMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
vinstringmax 40 chars
firstRegisteredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
grossWeightKgintegermin 0max 9007199254740991
axlesintegermin 0max 20
engineCcintegermin 0max 9007199254740991
roadTaxRelevantboolean
assetIdstring
ID of the asset. Find it with list-assets.
isActiveboolean
notestringmax 2000 chars

Odpověď · 201

idstringpovinné
registrationPlatestringpovinné
namestringpovinné
kindstringpovinné
categorynull | stringpovinné
fuelstringpovinné
ownershipstringpovinné
odometerStartintegerpovinné
consumptionMilliintegerpovinné
vinnull | stringpovinné
firstRegisteredOnstring | nullpovinné
grossWeightKginteger | nullpovinné
axlesinteger | nullpovinné
engineCcinteger | nullpovinné
roadTaxRelevantbooleanpovinné
assetIdnull | stringpovinné
isActivebooleanpovinné
notestring | nullpovinné
POST/v1/vehicles
curl -X POST https://api.damedoklad.cz/v1/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registrationPlate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "fuel": "ba95"
}'

Detail: vozidlo

GET/v1/vehicles/{id}

Get a Vehicle

Nástroj MCP: get-vehicle

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
registrationPlatestringpovinné
namestringpovinné
kindstringpovinné
categorynull | stringpovinné
fuelstringpovinné
ownershipstringpovinné
odometerStartintegerpovinné
consumptionMilliintegerpovinné
vinnull | stringpovinné
firstRegisteredOnstring | nullpovinné
grossWeightKginteger | nullpovinné
axlesinteger | nullpovinné
engineCcinteger | nullpovinné
roadTaxRelevantbooleanpovinné
assetIdnull | stringpovinné
isActivebooleanpovinné
notestring | nullpovinné
GET/v1/vehicles/{id}
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Úprava: vozidlo

PATCH/v1/vehicles/{id}

Update a Vehicle

Nástroj MCP: update-vehicle

Parametry v cestě

idstringpovinné

Tělo požadavku

registrationPlatestringmax 20 chars
namestringmax 200 chars
kind"car" | "motorcycle" | "truck" | "bus" | "tractor"
categorystringmax 10 chars
fuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"
ownership"company" | "private" | "leased"
odometerStartintegermin 0max 9007199254740991
consumptionMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
vinstringmax 40 chars
firstRegisteredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
grossWeightKgintegermin 0max 9007199254740991
axlesintegermin 0max 20
engineCcintegermin 0max 9007199254740991
roadTaxRelevantboolean
assetIdstring
ID of the asset. Find it with list-assets.
isActiveboolean
notestringmax 2000 chars

Odpověď · 200

idstringpovinné
registrationPlatestringpovinné
namestringpovinné
kindstringpovinné
categorynull | stringpovinné
fuelstringpovinné
ownershipstringpovinné
odometerStartintegerpovinné
consumptionMilliintegerpovinné
vinnull | stringpovinné
firstRegisteredOnstring | nullpovinné
grossWeightKginteger | nullpovinné
axlesinteger | nullpovinné
engineCcinteger | nullpovinné
roadTaxRelevantbooleanpovinné
assetIdnull | stringpovinné
isActivebooleanpovinné
notestring | nullpovinné
PATCH/v1/vehicles/{id}
curl -X PATCH https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registrationPlate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "kind": "car"
}'

Smazání: vozidlo

DELETE/v1/vehicles/{id}

Delete a Vehicle

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

Nástroj MCP: delete-vehicle

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
DELETE/v1/vehicles/{id}
curl -X DELETE https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Download the logbook of a vehicle as a PDF

GET/v1/vehicles/{id}/logbook.pdf

Download the logbook of a vehicle as a PDF

Nástroj MCP: export-vehicle-logbook-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/vehicles/{id}/logbook.pdf
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/logbook.pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Check the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven

GET/v1/vehicles/{id}/odometer-check

Check the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven

Nástroj MCP: check-vehicle-odometer

Parametry v cestě

idstringpovinné

Odpověď · 200

vehicleIdnull | stringpovinné
okbooleanpovinné
lastOdometerintegerpovinné
issuesobject[]povinné
idstringpovinné
datestringpovinnédate
kindstringpovinné
expectedintegerpovinné
actualintegerpovinné
GET/v1/vehicles/{id}/odometer-check
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/odometer-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Monthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate

GET/v1/vehicles/{id}/summary

Monthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate

Nástroj MCP: get-vehicle-year-summary

Parametry v cestě

idstringpovinné

Parametry dotazu

yearintegerpovinnémin 1990max 2100

Odpověď · 200

vehicleIdnull | stringpovinné
consumptionMilliintegerpovinné
yearintegerpovinné
monthsobject[]povinné
monthnull | stringpovinné
businessKmMilliintegerpovinné
privateKmMilliintegerpovinné
tripsintegerpovinné
fuelQuantityMilliintegerpovinné
fuelAmountHalerintegerpovinné
expectedFuelMilliintegerpovinné
differenceMilliintegerpovinné
totalsobjectpovinné
businessKmMilliintegerpovinné
privateKmMilliintegerpovinné
tripsintegerpovinné
fuelQuantityMilliintegerpovinné
fuelAmountHalerintegerpovinné
expectedFuelMilliintegerpovinné
differenceMilliintegerpovinné
actualConsumptionMilliintegerpovinné
businessSharePctintegerpovinné
GET/v1/vehicles/{id}/summary
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/summary \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"