Travel and vehicles
Operations in the Travel and vehicles group.
- GET/v1/fuel-purchases
- POST/v1/fuel-purchases
- DEL/v1/fuel-purchases/{id}
- POST/v1/fuel-purchases/import
- GET/v1/logbook-export.pdf
- GET/v1/logbook-export.xlsx
- GET/v1/transport-flat-rate
- PUT/v1/transport-flat-rate
- GET/v1/travel-employees
- GET/v1/travel-orders
- POST/v1/travel-orders
- GET/v1/travel-orders/{id}
- PATCH/v1/travel-orders/{id}
- DEL/v1/travel-orders/{id}
- POST/v1/travel-orders/{id}/advance
- GET/v1/travel-orders/{id}/order.pdf
- POST/v1/travel-orders/{id}/pay
- POST/v1/travel-orders/{id}/payroll
- POST/v1/travel-orders/{id}/payroll/cancel
- GET/v1/travel-orders/{id}/required-rates
- POST/v1/travel-orders/{id}/settle
- GET/v1/travel-orders/{id}/settlement-preview
- GET/v1/travel-rates
- GET/v1/trips
- POST/v1/trips
- PATCH/v1/trips/{id}
- DEL/v1/trips/{id}
- POST/v1/trips/import
- GET/v1/vehicle-routes
- POST/v1/vehicle-routes
- GET/v1/vehicle-routes/{id}
- PATCH/v1/vehicle-routes/{id}
- DEL/v1/vehicle-routes/{id}
- POST/v1/vehicle-routes/{id}/trips
- GET/v1/vehicles
- POST/v1/vehicles
- GET/v1/vehicles/{id}
- PATCH/v1/vehicles/{id}
- DEL/v1/vehicles/{id}
- GET/v1/vehicles/{id}/logbook.pdf
- GET/v1/vehicles/{id}/odometer-check
- GET/v1/vehicles/{id}/summary
List fuel purchases
/v1/fuel-purchasesList fuel purchases
MCP tool: list-fuel-purchases
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDvehicleIdstringResponse · 200
dataobject[]requiredobject"vehicle_fuel_purchase"requiredidstringrequiredvehicleIdstringrequiredpurchasedOnstringrequireddatequantityMilliintegerrequiredamountHalerintegerrequiredodometerinteger | nullvendornull | stringrequirednotenull | stringtotalintegerhasMorebooleanrequiredRecord a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does
/v1/fuel-purchasesRecord a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does
MCP tool: create-fuel-purchase
Request body
vehicleIdstringrequiredpurchasedOnstringrequiredYYYY-MM-DDquantityMilliintegerrequiredmin 1max 9007199254740991amountHalerintegerrequiredmin 0max 9007199254740991odometerintegermin 0max 9007199254740991vendorstringmax 500 charsnotestringmax 2000 charsResponse · 201
idstringrequiredvehicleIdstringrequiredpurchasedOnstringrequireddatequantityMilliintegerrequiredamountHalerintegerrequiredodometerinteger | nullvendornull | stringrequirednotenull | stringDelete a fuel purchase
/v1/fuel-purchases/{id}Delete a fuel purchase
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: delete-fuel-purchase
Path parameters
idstringrequiredResponse · 200
idstringrequireddeletedbooleanrequiredImport a fuel card statement as CSV: date, litres, and amount with VAT required; plate, product, station, card, and odometer optional. dryRun only validates
/v1/fuel-purchases/importImport 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.
MCP tool: import-fuel-card
Request body
vehicleIdstringcsvstringmax 4000000 charsfileBase64stringmax 8000000 charscolumnMapobjectdryRunbooleanResponse · 200
dryRunbooleanrequiredimportedintegerrequiredvalidintegerrequiredduplicatesintegerrequiredskippedobject[]requiredlineintegerrequiredproductstringrequirederrorsobject[]requiredlineintegerrequiredmessagenull | stringrequiredtotalQuantityMilliintegerrequiredtotalAmountHalerintegerrequiredheadersanyrequiredmissinganyrequiredLogbook of a year for the tax authority as a PDF: all trips, monthly km, business share, fuel against the technical certificate, and odometer problems
/v1/logbook-export.pdfLogbook 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.
MCP tool: export-logbook-for-authority-pdf
Query parameters
yearintegerrequiredmin 1990max 2100vehicleIdstringResponse · 200
Returns a application/pdf file.
Logbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle
/v1/logbook-export.xlsxLogbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle
MCP tool: export-logbook-for-authority-xlsx
Query parameters
yearintegerrequiredmin 1990max 2100vehicleIdstringResponse · 200
Returns a application/vnd.openxmlformats-officedocument.spreadsheetml.sheet file.
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
/v1/transport-flat-ratePaušá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
MCP tool: get-transport-flat-rate
Query parameters
yearintegerrequiredmin 1990max 2100Response · 200
yearintegerrequiredvehiclesobject[]requiredvehicleIdstringrequiredmodestringrequiredmonthlyHalerintegerrequiredmonthsobject[]requiredmonthinteger | nullrequireddaysintegerrequiredamountHalerinteger | nullrequiredamountHalerinteger | nullrequiredtotalHalerinteger | nullrequiredreducedCountintegerrequiredmonthlyHalerintegerreducedPctintegermaxVehiclesintegerChoose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none
/v1/transport-flat-rateChoose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none
MCP tool: set-transport-flat-rate
Request body
vehicleIdstringrequiredyearintegerrequiredmin 1990max 2100mode"full" | "reduced" | "none"requiredvalidFromstringYYYY-MM-DDvalidTostringYYYY-MM-DDResponse · 200
yearintegerrequiredvehiclesobject[]requiredvehicleIdstringrequiredmodestringrequiredmonthlyHalerintegerrequiredmonthsobject[]requiredmonthinteger | nullrequireddaysintegerrequiredamountHalerinteger | nullrequiredamountHalerinteger | nullrequiredtotalHalerinteger | nullrequiredreducedCountintegerrequiredmonthlyHalerintegerreducedPctintegermaxVehiclesintegerEmployees that a business trip can be linked to: id and name only
/v1/travel-employeesEmployees that a business trip can be linked to: id and name only
MCP tool: list-travel-employees
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsResponse · 200
dataobject[]requiredobject"travel_employee"requiredidstringrequirednamenull | stringrequiredtotalintegerhasMorebooleanrequiredList business trip orders (cestovní příkazy)
/v1/travel-ordersList business trip orders (cestovní příkazy)
MCP tool: list-travel-orders
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsstatus"draft" | "settled" | "paid"Response · 200
dataobject[]requiredobject"travel_order"requiredidstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredtotalintegerhasMorebooleanrequiredCreate a domestic or foreign business trip order; add abroad segments and expenses to it
/v1/travel-ordersCreate a domestic or foreign business trip order; add abroad segments and expenses to it
MCP tool: create-travel-order
Request body
travelerNamestringmax 200 charsemployeeIdstring | nullinterruptionsobject[]fromAtstringrequiredtoAtstringrequiredfamilyVisitsobject[]fromAtstringrequiredtoAtstringrequiredfareHalerintegermin 0max 9007199254740991limitHalerintegermin 0max 9007199254740991currencystring3 charsfareCentsintegermin 0max 9007199254740991limitCentsintegermin 0max 9007199254740991familyVisitAgreedbooleanagreedMealsobjecttier5to12integermin 0max 9007199254740991tier12to18integermin 0max 9007199254740991over18integermin 0max 9007199254740991mealCutsobjecttier5to12numbermin 0max 70tier12to18numbermin 0max 35over18numbermin 0max 25foreignRatePctinteger | nullfareEquivalentHalerintegermin 0max 9007199254740991travelerKind"employee" | "owner"purposestringrequiredmax 200 charsdestinationstringrequiredmax 200 charsstartAtstringrequiredendAtstringrequiredtransport"public" | "company_car" | "private_car" | "equivalent" | "other"vehicleIdstringkmMilliintegermin 0max 9007199254740991trailerbooleandocumentedFuelPriceHalerintegermin 0max 9007199254740991basicRateHalerintegermin 0max 9007199254740991pocketMoneyPctintegermin 0max 40freeMealsobjectexchangeRatesobjectadvanceHalerintegermin 0max 9007199254740991abroadobject[]countryCodestringrequiredmin 2 charsmax 20 charsfromAtstringrequiredtoAtstringrequiredexpensesobject[]kind"accommodation" | "transport" | "parking" | "other"descriptionstringmax 500 charsamountCentsintegerrequiredmin 0max 9007199254740991currencystring3 charsvatHalerintegermin 0max 9007199254740991notestringmax 2000 charsResponse · 201
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredGet a business trip order with its time abroad and expenses
/v1/travel-orders/{id}Get a business trip order with its time abroad and expenses
MCP tool: get-travel-order
Path parameters
idstringrequiredResponse · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredEdit a business trip order before it is settled
/v1/travel-orders/{id}Edit a business trip order before it is settled
MCP tool: update-travel-order
Path parameters
idstringrequiredRequest body
travelerNamestringmax 200 charsemployeeIdstring | nullinterruptionsobject[]fromAtstringrequiredtoAtstringrequiredfamilyVisitsobject[]fromAtstringrequiredtoAtstringrequiredfareHalerintegermin 0max 9007199254740991limitHalerintegermin 0max 9007199254740991currencystring3 charsfareCentsintegermin 0max 9007199254740991limitCentsintegermin 0max 9007199254740991familyVisitAgreedbooleanagreedMealsobjecttier5to12integermin 0max 9007199254740991tier12to18integermin 0max 9007199254740991over18integermin 0max 9007199254740991mealCutsobjecttier5to12numbermin 0max 70tier12to18numbermin 0max 35over18numbermin 0max 25foreignRatePctinteger | nullfareEquivalentHalerintegermin 0max 9007199254740991travelerKind"employee" | "owner"purposestringmax 200 charsdestinationstringmax 200 charsstartAtstringendAtstringtransport"public" | "company_car" | "private_car" | "equivalent" | "other"vehicleIdstringkmMilliintegermin 0max 9007199254740991trailerbooleandocumentedFuelPriceHalerintegermin 0max 9007199254740991basicRateHalerintegermin 0max 9007199254740991pocketMoneyPctintegermin 0max 40freeMealsobjectexchangeRatesobjectadvanceHalerintegermin 0max 9007199254740991abroadobject[]countryCodestringrequiredmin 2 charsmax 20 charsfromAtstringrequiredtoAtstringrequiredexpensesobject[]kind"accommodation" | "transport" | "parking" | "other"descriptionstringmax 500 charsamountCentsintegerrequiredmin 0max 9007199254740991currencystring3 charsvatHalerintegermin 0max 9007199254740991notestringmax 2000 charsResponse · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredDelete a business trip order that has not been settled and has no paid advance
/v1/travel-orders/{id}Delete a business trip order that has not been settled and has no paid advance
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: delete-travel-order
Path parameters
idstringrequiredResponse · 200
idstringrequireddeletedbooleanrequiredPay 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)
/v1/travel-orders/{id}/advancePay 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)
MCP tool: pay-travel-advance
Path parameters
idstringrequiredRequest body
datestringrequiredYYYY-MM-DDmethod"transfer" | "cash" | "card"registerIdstringbankAccountIdstringamountHalerintegermin 0max 9007199254740991Response · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredDownload a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines
/v1/travel-orders/{id}/order.pdfDownload a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines
MCP tool: export-travel-order-pdf
Path parameters
idstringrequiredResponse · 200
Returns a application/pdf file.
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
/v1/travel-orders/{id}/payPay 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
MCP tool: pay-travel-order
Path parameters
idstringrequiredRequest body
datestringrequiredYYYY-MM-DDmethod"transfer" | "cash" | "card"registerIdstringbankAccountIdstringResponse · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredPay 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
/v1/travel-orders/{id}/payrollPay 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.
MCP tool: queue-travel-reimbursement
Path parameters
idstringrequiredRequest body
yearintegerrequiredmin 1990max 2100monthintegerrequiredmin 1max 12Response · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredTake a trip back out of a payroll run that is not locked yet
/v1/travel-orders/{id}/payroll/cancelTake a trip back out of a payroll run that is not locked yet
MCP tool: cancel-travel-reimbursement
Path parameters
idstringrequiredResponse · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredWhich Č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
/v1/travel-orders/{id}/required-ratesWhich Č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
MCP tool: get-travel-order-required-rates
Path parameters
idstringrequiredResponse · 200
orderIdnull | stringrequireddatestringrequireddatecurrenciesobject[]requiredcurrencynull | stringrequiredratenull | numberrequiredSettle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335
/v1/travel-orders/{id}/settleSettle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335
MCP tool: settle-travel-order
Path parameters
idstringrequiredRequest body
datestringrequiredYYYY-MM-DDResponse · 200
idstringrequirednumberstringrequiredtravelerNamestringrequiredtravelerKindstringrequiredpurposestringrequireddestinationstringrequiredstartAtstringrequiredendAtstringrequiredtransportstringrequiredvehicleIdnull | stringrequiredkmMilliintegerrequiredtrailerbooleanrequireddocumentedFuelPriceHalerinteger | nullrequiredbasicRateHalerinteger | nullrequiredpocketMoneyPctintegerrequiredfreeMealsobjectrequiredexchangeRatesobjectrequiredadvanceHalerintegerrequiredadvancePaidOnnull | stringrequireddatestatusstringrequiredtotalHalerintegerrequiredsettleHalerintegerrequiredsettledOnnull | stringrequireddatepaidOnnull | stringrequireddatenotestring | nullrequiredemployeeIdnull | stringrequiredinterruptionsobject[]requiredtoAtstringrequiredfromAtstringrequiredfamilyVisitsobject[]requiredtoAtstringrequiredfromAtstringrequiredfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanrequiredagreedMealsobjectrequiredtier5to12integermealCutsobjectrequiredtier12to18integerforeignRatePctinteger | nullrequiredfareEquivalentHalerintegerrequiredpayMethodnull | stringrequiredpayrollYearinteger | nullrequiredpayrollMonthinteger | nullrequiredsettlementnull | objectrequireddaysobject[]requireddatestringrequireddatetiernull | stringrequiredforeignnull | objectrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredgrossCentsintegerrequiredamountCentsintegerrequiredcountryCodenull | stringrequiredcountryNamestringrequiredfractionThirdsintegerrequiredreductionCentsintegerrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredamountHalerinteger | nullrequiredabroadMinutesintegerrequiredreductionHalerintegerrequireddomesticMinutesintegerrequiredtaxableExcessHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredfuelHalerintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredtotalHalerintegerrequiredconsumedMilliintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredexpensesobject[]requiredkindstringrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountCentsintegerrequiredamountHalerinteger | nullrequireddescriptionnull | stringrequiredvatHalerinteger | nullrequiredwarningsany[]requiredtotalHalerintegerrequiredsettleHalerintegerrequiredadvanceHalerintegerrequiredfamilyVisitsobject[]requiredtostringrequiredfromstringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredmileageHalerintegerrequiredexpensesHalerintegerrequiredroundingHalerintegerrequiredfamilyVisitHalerintegerrequiredforeignMealHalerintegerrequiredpocketMoneyHalerintegerrequireddomesticMealHalerintegerrequiredforeignByCurrencyobjectrequiredtaxableExcessHalerintegerrequiredfareEquivalentHalerintegerrequiredabroadobject[]countryCodenull | stringrequiredfromAtstringrequiredtoAtstringrequiredexpensesobject[]kindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredCompute the settlement of a business trip without posting: stravné by day, mileage, expenses, advance, and the amount to pay
/v1/travel-orders/{id}/settlement-previewCompute the settlement of a business trip without posting: stravné by day, mileage, expenses, advance, and the amount to pay
MCP tool: preview-travel-settlement
Path parameters
idstringrequiredResponse · 200
orderIdnull | stringrequireddaysobject[]requireddatestringrequireddatedomesticMinutesintegerrequiredabroadMinutesintegerrequiredtiernull | stringrequiredfreeMealsintegerrequiredgrossHalerintegerrequiredreductionHalerintegerrequiredamountHalerinteger | nullrequiredtaxableExcessHalerintegerrequiredforeignnull | objectrequiredcountryCodenull | stringrequiredcountryNamestringrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredfractionThirdsintegerrequiredgrossCentsintegerrequiredreductionCentsintegerrequiredamountCentsintegerrequireddomesticMealHalerintegerrequiredforeignMealHalerintegerrequiredforeignByCurrencyobjectrequiredpocketMoneyHalerintegerrequiredmileageHalerintegerrequiredfareEquivalentHalerintegerrequiredfamilyVisitsobject[]requiredfromstringrequiredtostringrequiredfareHalerintegerrequiredlimitHalerintegerrequiredamountHalerinteger | nullrequiredcurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitHalerintegerrequiredwarningsany[]requiredtaxableExcessHalerintegerrequiredexpensesHalerintegerrequiredexpensesobject[]requiredkindstringrequireddescriptionnull | stringrequiredamountCentsintegerrequiredcurrencynull | stringrequiredvatHalerinteger | nullrequiredamountHalerinteger | nullrequiredvatHalerinteger | nullrequiredtotalHalerinteger | nullrequiredadvanceHalerintegerrequiredsettleHalerintegerrequiredroundingHalerintegerrequiredmileagenull | objectrequiredkmMilliintegerrequiredrateHalerintegerrequiredbasicHalerintegerrequiredfuelPriceHalerintegerrequiredfuelPriceSourcestringrequiredconsumedMilliintegerrequiredfuelHalerintegerrequiredtotalHalerinteger | nullrequiredStatutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems
/v1/travel-ratesStatutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems
MCP tool: get-travel-rates
Query parameters
yearintegermin 1990max 2100Response · 200
yearintegerrequiredcitationstringrequiredmileageHalerobjectrequiredmotorcycleintegerrequiredcarintegerrequiredmealsHalerobjectrequiredtier5to12integerrequiredtier12to18integerrequiredover18integerrequiredmealsMaxHalerobjectrequiredtier5to12integerrequiredtier12to18integerrequiredover18integerrequiredfuelHalerobject[]requiredfromstringrequireddateba95integerrequiredba98integerrequireddieselintegerrequiredelectricityintegerrequiredforeignobject[]requiredcountryCodenull | stringrequirednamenull | stringrequiredcurrencynull | stringrequiredbaseAmountintegerrequiredList logbook trips, filterable by vehicle, type, and date
/v1/tripsList logbook trips, filterable by vehicle, type, and date
MCP tool: list-trips
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDvehicleIdstringtripType"business" | "private"Response · 200
dataobject[]requiredobject"vehicle_trip"requiredidstringrequiredvehicleIdstringrequiredrouteIdnull | stringrequireddatestringrequireddatefromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequireddrivernull | stringrequiredodometerStartinteger | nullrequiredodometerEndinteger | nullrequirednotestring | nullcontinuityIssuesobject[]idstringrequireddatestringrequireddatekindstringrequiredexpectedintegerrequiredactualintegerrequiredtotalintegerhasMorebooleanrequiredAdd a logbook trip. Pass routeId to fill it from a recurring route; the odometer continues from the last trip
/v1/tripsAdd 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.
MCP tool: create-trip
Request body
vehicleIdstringrequiredrouteIdstringdatestringrequiredYYYY-MM-DDfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"driverstringmax 500 charsodometerStartintegermin 0max 9007199254740991odometerEndintegermin 0max 9007199254740991notestringmax 2000 charsResponse · 201
idstringrequiredvehicleIdstringrequiredrouteIdnull | stringrequireddatestringrequireddatefromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequireddrivernull | stringrequiredodometerStartinteger | nullrequiredodometerEndinteger | nullrequirednotestring | nullcontinuityIssuesobject[]idstringrequireddatestringrequireddatekindstringrequiredexpectedintegerrequiredactualintegerrequiredCorrect a logbook trip
/v1/trips/{id}Correct a logbook trip
MCP tool: update-trip
Path parameters
idstringrequiredRequest body
vehicleIdstringrouteIdstringdatestringYYYY-MM-DDfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"driverstringmax 500 charsodometerStartintegermin 0max 9007199254740991odometerEndintegermin 0max 9007199254740991notestringmax 2000 charsResponse · 200
idstringrequiredvehicleIdstringrequiredrouteIdnull | stringrequireddatestringrequireddatefromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequireddrivernull | stringrequiredodometerStartinteger | nullrequiredodometerEndinteger | nullrequirednotestring | nullcontinuityIssuesobject[]idstringrequireddatestringrequireddatekindstringrequiredexpectedintegerrequiredactualintegerrequiredDelete a logbook trip
/v1/trips/{id}Delete a logbook trip
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: delete-trip
Path parameters
idstringrequiredResponse · 200
idstringrequireddeletedbooleanrequiredImport logbook trips from a CSV or fleet export (date, from, to, km required; purpose, type, driver, odometer, plate optional). dryRun only validates
/v1/trips/importImport 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.
MCP tool: import-trips
Request body
vehicleIdstringcsvstringmax 4000000 charsfileBase64stringmax 8000000 charscolumnMapobjectdryRunbooleanResponse · 200
dryRunbooleanrequiredimportedintegerrequiredvalidintegerrequiredduplicatesintegerrequirederrorsobject[]requiredlineintegerrequiredmessagenull | stringrequiredcontinuityIssuesany[]requiredheadersarray | nullrequiredmissingarray | nullrequiredList VehicleRoutes
/v1/vehicle-routesList VehicleRoutes
MCP tool: list-vehicle-routes
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsResponse · 200
dataobject[]requiredobject"vehicle_route"requiredidstringrequirednamestringrequiredfromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequiredtotalintegerhasMorebooleanrequiredCreate a VehicleRoute
/v1/vehicle-routesCreate a VehicleRoute
MCP tool: create-vehicle-route
Request body
namestringrequiredmax 200 charsfromPlacestringrequiredmax 200 charstoPlacestringrequiredmax 200 charspurposestringmax 500 charskmMilliintegerrequiredmin 0max 9007199254740991tripType"business" | "private"Response · 201
idstringrequirednamestringrequiredfromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequiredGet a VehicleRoute
/v1/vehicle-routes/{id}Get a VehicleRoute
MCP tool: get-vehicle-route
Path parameters
idstringrequiredResponse · 200
idstringrequirednamestringrequiredfromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequiredUpdate a VehicleRoute
/v1/vehicle-routes/{id}Update a VehicleRoute
MCP tool: update-vehicle-route
Path parameters
idstringrequiredRequest body
namestringmax 200 charsfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"Response · 200
idstringrequirednamestringrequiredfromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequiredDelete a VehicleRoute
/v1/vehicle-routes/{id}Delete a VehicleRoute
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: delete-vehicle-route
Path parameters
idstringrequiredResponse · 200
idstringrequireddeletedbooleanrequiredFill the logbook from a recurring route without GPS: one trip for each listed date or weekday in a period, optionally there and back
/v1/vehicle-routes/{id}/tripsFill 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.
MCP tool: generate-trips-from-route
Path parameters
idstringrequiredRequest body
vehicleIdstringrequireddatesstring[]fromstringYYYY-MM-DDtostringYYYY-MM-DDweekdaysinteger[]skipstring[]roundTripbooleandriverstringmax 500 charsdryRunbooleanResponse · 200
dryRunbooleanrequiredcreatedintegerrequiredskippedDatesstring[]requiredlastOdometerintegerrequiredtripsobject[]requiredobject"vehicle_trip"requiredidstringrequiredvehicleIdstringrequiredrouteIdnull | stringrequireddatestringrequireddatefromPlacestringrequiredtoPlacestringrequiredpurposenull | stringrequiredkmMilliintegerrequiredtripTypestringrequireddrivernull | stringrequiredodometerStartinteger | nullrequiredodometerEndinteger | nullrequirednotestring | nullcontinuityIssuesobject[]idstringrequireddatestringrequireddatekindstringrequiredexpectedintegerrequiredactualintegerrequiredList Vehicles
/v1/vehiclesList Vehicles
MCP tool: list-vehicles
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsResponse · 200
dataobject[]requiredobject"vehicle"requiredidstringrequiredregistrationPlatestringrequirednamestringrequiredkindstringrequiredcategorynull | stringrequiredfuelstringrequiredownershipstringrequiredodometerStartintegerrequiredconsumptionMilliintegerrequiredvinnull | stringrequiredfirstRegisteredOnstring | nullrequiredgrossWeightKginteger | nullrequiredaxlesinteger | nullrequiredengineCcinteger | nullrequiredroadTaxRelevantbooleanrequiredassetIdnull | stringrequiredisActivebooleanrequirednotestring | nullrequiredtotalintegerhasMorebooleanrequiredCreate a Vehicle
/v1/vehiclesCreate a Vehicle
MCP tool: create-vehicle
Request body
registrationPlatestringrequiredmax 20 charsnamestringrequiredmax 200 charskind"car" | "motorcycle" | "truck" | "bus" | "tractor"categorystringmax 10 charsfuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"requiredownership"company" | "private" | "leased"odometerStartintegermin 0max 9007199254740991consumptionMilliintegermin 0max 9007199254740991vinstringmax 40 charsfirstRegisteredOnstringYYYY-MM-DDgrossWeightKgintegermin 0max 9007199254740991axlesintegermin 0max 20engineCcintegermin 0max 9007199254740991roadTaxRelevantbooleanassetIdstringisActivebooleannotestringmax 2000 charsResponse · 201
idstringrequiredregistrationPlatestringrequirednamestringrequiredkindstringrequiredcategorynull | stringrequiredfuelstringrequiredownershipstringrequiredodometerStartintegerrequiredconsumptionMilliintegerrequiredvinnull | stringrequiredfirstRegisteredOnstring | nullrequiredgrossWeightKginteger | nullrequiredaxlesinteger | nullrequiredengineCcinteger | nullrequiredroadTaxRelevantbooleanrequiredassetIdnull | stringrequiredisActivebooleanrequirednotestring | nullrequiredGet a Vehicle
/v1/vehicles/{id}Get a Vehicle
MCP tool: get-vehicle
Path parameters
idstringrequiredResponse · 200
idstringrequiredregistrationPlatestringrequirednamestringrequiredkindstringrequiredcategorynull | stringrequiredfuelstringrequiredownershipstringrequiredodometerStartintegerrequiredconsumptionMilliintegerrequiredvinnull | stringrequiredfirstRegisteredOnstring | nullrequiredgrossWeightKginteger | nullrequiredaxlesinteger | nullrequiredengineCcinteger | nullrequiredroadTaxRelevantbooleanrequiredassetIdnull | stringrequiredisActivebooleanrequirednotestring | nullrequiredUpdate a Vehicle
/v1/vehicles/{id}Update a Vehicle
MCP tool: update-vehicle
Path parameters
idstringrequiredRequest body
registrationPlatestringmax 20 charsnamestringmax 200 charskind"car" | "motorcycle" | "truck" | "bus" | "tractor"categorystringmax 10 charsfuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"ownership"company" | "private" | "leased"odometerStartintegermin 0max 9007199254740991consumptionMilliintegermin 0max 9007199254740991vinstringmax 40 charsfirstRegisteredOnstringYYYY-MM-DDgrossWeightKgintegermin 0max 9007199254740991axlesintegermin 0max 20engineCcintegermin 0max 9007199254740991roadTaxRelevantbooleanassetIdstringisActivebooleannotestringmax 2000 charsResponse · 200
idstringrequiredregistrationPlatestringrequirednamestringrequiredkindstringrequiredcategorynull | stringrequiredfuelstringrequiredownershipstringrequiredodometerStartintegerrequiredconsumptionMilliintegerrequiredvinnull | stringrequiredfirstRegisteredOnstring | nullrequiredgrossWeightKginteger | nullrequiredaxlesinteger | nullrequiredengineCcinteger | nullrequiredroadTaxRelevantbooleanrequiredassetIdnull | stringrequiredisActivebooleanrequirednotestring | nullrequiredDelete a Vehicle
/v1/vehicles/{id}Delete a Vehicle
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: delete-vehicle
Path parameters
idstringrequiredResponse · 200
idstringrequireddeletedbooleanrequiredDownload the logbook of a vehicle as a PDF
/v1/vehicles/{id}/logbook.pdfDownload the logbook of a vehicle as a PDF
MCP tool: export-vehicle-logbook-pdf
Path parameters
idstringrequiredQuery parameters
fromstringYYYY-MM-DDtostringYYYY-MM-DDResponse · 200
Returns a application/pdf file.
Check the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven
/v1/vehicles/{id}/odometer-checkCheck the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven
MCP tool: check-vehicle-odometer
Path parameters
idstringrequiredResponse · 200
vehicleIdnull | stringrequiredokbooleanrequiredlastOdometerintegerrequiredissuesobject[]requiredidstringrequireddatestringrequireddatekindstringrequiredexpectedintegerrequiredactualintegerrequiredMonthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate
/v1/vehicles/{id}/summaryMonthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate
MCP tool: get-vehicle-year-summary
Path parameters
idstringrequiredQuery parameters
yearintegerrequiredmin 1990max 2100Response · 200
vehicleIdnull | stringrequiredconsumptionMilliintegerrequiredyearintegerrequiredmonthsobject[]requiredmonthnull | stringrequiredbusinessKmMilliintegerrequiredprivateKmMilliintegerrequiredtripsintegerrequiredfuelQuantityMilliintegerrequiredfuelAmountHalerintegerrequiredexpectedFuelMilliintegerrequireddifferenceMilliintegerrequiredtotalsobjectrequiredbusinessKmMilliintegerrequiredprivateKmMilliintegerrequiredtripsintegerrequiredfuelQuantityMilliintegerrequiredfuelAmountHalerintegerrequiredexpectedFuelMilliintegerrequireddifferenceMilliintegerrequiredactualConsumptionMilliintegerrequiredbusinessSharePctintegerrequired