Cesty a vozidla
Operace ve skupině Cesty a vozidla.
- 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
Nástroj MCP: list-fuel-purchases
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDvehicleIdstringOdpověď · 200
dataobject[]povinnéobject"vehicle_fuel_purchase"povinnéidstringpovinnévehicleIdstringpovinnépurchasedOnstringpovinnédatequantityMilliintegerpovinnéamountHalerintegerpovinnéodometerinteger | nullvendornull | stringpovinnénotenull | stringtotalintegerhasMorebooleanpovinnéRecord 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
Nástroj MCP: create-fuel-purchase
Tělo požadavku
vehicleIdstringpovinnépurchasedOnstringpovinnéYYYY-MM-DDquantityMilliintegerpovinnémin 1max 9007199254740991amountHalerintegerpovinnémin 0max 9007199254740991odometerintegermin 0max 9007199254740991vendorstringmax 500 charsnotestringmax 2000 charsOdpověď · 201
idstringpovinnévehicleIdstringpovinnépurchasedOnstringpovinnédatequantityMilliintegerpovinnéamountHalerintegerpovinnéodometerinteger | nullvendornull | stringpovinnénotenull | stringDelete a fuel purchase
/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éImport 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.
Nástroj MCP: import-fuel-card
Tělo požadavku
vehicleIdstringcsvstringmax 4000000 charsfileBase64stringmax 8000000 charscolumnMapobjectdryRunbooleanOdpověď · 200
dryRunbooleanpovinnéimportedintegerpovinnévalidintegerpovinnéduplicatesintegerpovinnéskippedobject[]povinnélineintegerpovinnéproductstringpovinnéerrorsobject[]povinnélineintegerpovinnémessagenull | stringpovinnétotalQuantityMilliintegerpovinnétotalAmountHalerintegerpovinnéheadersanypovinnémissinganypovinné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
/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.
Nástroj MCP: export-logbook-for-authority-pdf
Parametry dotazu
yearintegerpovinnémin 1990max 2100vehicleIdstringOdpověď · 200
Vrací soubor application/pdf.
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
Nástroj MCP: export-logbook-for-authority-xlsx
Parametry dotazu
yearintegerpovinnémin 1990max 2100vehicleIdstringOdpověď · 200
Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.
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
Nástroj MCP: get-transport-flat-rate
Parametry dotazu
yearintegerpovinnémin 1990max 2100Odpověď · 200
yearintegerpovinnévehiclesobject[]povinnévehicleIdstringpovinnémodestringpovinnémonthlyHalerintegerpovinnémonthsobject[]povinnémonthinteger | nullpovinnédaysintegerpovinnéamountHalerinteger | nullpovinnéamountHalerinteger | nullpovinnétotalHalerinteger | nullpovinnéreducedCountintegerpovinnémonthlyHalerintegerreducedPctintegermaxVehiclesintegerChoose 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
Nástroj MCP: set-transport-flat-rate
Tělo požadavku
vehicleIdstringpovinnéyearintegerpovinnémin 1990max 2100mode"full" | "reduced" | "none"povinnévalidFromstringYYYY-MM-DDvalidTostringYYYY-MM-DDOdpověď · 200
yearintegerpovinnévehiclesobject[]povinnévehicleIdstringpovinnémodestringpovinnémonthlyHalerintegerpovinnémonthsobject[]povinnémonthinteger | nullpovinnédaysintegerpovinnéamountHalerinteger | nullpovinnéamountHalerinteger | nullpovinnétotalHalerinteger | nullpovinnéreducedCountintegerpovinnémonthlyHalerintegerreducedPctintegermaxVehiclesintegerSeznam: zaměstnanec, cesty a vozidla
/v1/travel-employeesEmployees that a business trip can be linked to: id and name only
Nástroj MCP: list-travel-employees
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"travel_employee"povinnéidstringpovinnénamenull | stringpovinnétotalintegerhasMorebooleanpovinnéList business trip orders (cestovní příkazy)
/v1/travel-ordersList business trip orders (cestovní příkazy)
Nástroj MCP: list-travel-orders
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsstatus"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édatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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étotalintegerhasMorebooleanpovinnéCreate 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
Nástroj MCP: create-travel-order
Tělo požadavku
travelerNamestringmax 200 charsemployeeIdstring | nullinterruptionsobject[]fromAtstringpovinnétoAtstringpovinnéfamilyVisitsobject[]fromAtstringpovinnétoAtstringpovinnéfareHalerintegermin 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"purposestringpovinnémax 200 charsdestinationstringpovinnémax 200 charsstartAtstringpovinnéendAtstringpovinnétransport"public" | "company_car" | "private_car" | "equivalent" | "other"vehicleIdstringkmMilliintegermin 0max 9007199254740991trailerbooleandocumentedFuelPriceHalerintegermin 0max 9007199254740991basicRateHalerintegermin 0max 9007199254740991pocketMoneyPctintegermin 0max 40freeMealsobjectexchangeRatesobjectadvanceHalerintegermin 0max 9007199254740991abroadobject[]countryCodestringpovinnémin 2 charsmax 20 charsfromAtstringpovinnétoAtstringpovinnéexpensesobject[]kind"accommodation" | "transport" | "parking" | "other"descriptionstringmax 500 charsamountCentsintegerpovinnémin 0max 9007199254740991currencystring3 charsvatHalerintegermin 0max 9007199254740991notestringmax 2000 charsOdpověď · 201
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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 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
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édatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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éEdit a business trip order before it is settled
/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 charsemployeeIdstring | nullinterruptionsobject[]fromAtstringpovinnétoAtstringpovinnéfamilyVisitsobject[]fromAtstringpovinnétoAtstringpovinnéfareHalerintegermin 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[]countryCodestringpovinnémin 2 charsmax 20 charsfromAtstringpovinnétoAtstringpovinnéexpensesobject[]kind"accommodation" | "transport" | "parking" | "other"descriptionstringmax 500 charsamountCentsintegerpovinnémin 0max 9007199254740991currencystring3 charsvatHalerintegermin 0max 9007199254740991notestringmax 2000 charsOdpověď · 200
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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éDelete 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
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é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)
/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)
Nástroj MCP: pay-travel-advance
Parametry v cestě
idstringpovinnéTělo požadavku
datestringpovinnéYYYY-MM-DDmethod"transfer" | "cash" | "card"registerIdstringbankAccountIdstringamountHalerintegermin 0max 9007199254740991Odpověď · 200
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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éDownload 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
Nástroj MCP: export-travel-order-pdf
Parametry v cestě
idstringpovinnéOdpověď · 200
Vrací soubor application/pdf.
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
Nástroj MCP: pay-travel-order
Parametry v cestě
idstringpovinnéTělo požadavku
datestringpovinnéYYYY-MM-DDmethod"transfer" | "cash" | "card"registerIdstringbankAccountIdstringOdpověď · 200
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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é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
/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.
Nástroj MCP: queue-travel-reimbursement
Parametry v cestě
idstringpovinnéTělo požadavku
yearintegerpovinnémin 1990max 2100monthintegerpovinnémin 1max 12Odpověď · 200
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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éTake 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
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édatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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é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
/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
Nástroj MCP: get-travel-order-required-rates
Parametry v cestě
idstringpovinnéOdpověď · 200
orderIdnull | stringpovinnédatestringpovinnédatecurrenciesobject[]povinnécurrencynull | stringpovinnératenull | numberpovinnéSettle 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
Nástroj MCP: settle-travel-order
Parametry v cestě
idstringpovinnéTělo požadavku
datestringpovinnéYYYY-MM-DDOdpověď · 200
idstringpovinnénumberstringpovinnétravelerNamestringpovinnétravelerKindstringpovinnépurposestringpovinnédestinationstringpovinnéstartAtstringpovinnéendAtstringpovinnétransportstringpovinnévehicleIdnull | stringpovinnékmMilliintegerpovinnétrailerbooleanpovinnédocumentedFuelPriceHalerinteger | nullpovinnébasicRateHalerinteger | nullpovinnépocketMoneyPctintegerpovinnéfreeMealsobjectpovinnéexchangeRatesobjectpovinnéadvanceHalerintegerpovinnéadvancePaidOnnull | stringpovinnédatestatusstringpovinnétotalHalerintegerpovinnésettleHalerintegerpovinnésettledOnnull | stringpovinnédatepaidOnnull | stringpovinnédatenotestring | nullpovinnéemployeeIdnull | stringpovinnéinterruptionsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfamilyVisitsobject[]povinnétoAtstringpovinnéfromAtstringpovinnéfareHalerintegerlimitHalerintegercurrencynull | stringfareCentsintegerlimitCentsintegerfamilyVisitAgreedbooleanpovinnéagreedMealsobjectpovinnétier5to12integermealCutsobjectpovinnétier12to18integerforeignRatePctinteger | nullpovinnéfareEquivalentHalerintegerpovinnépayMethodnull | stringpovinnépayrollYearinteger | nullpovinnépayrollMonthinteger | nullpovinnésettlementnull | objectpovinnédaysobject[]povinnédatestringpovinnédatetiernull | 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éNáhled: likvidace, cesty a vozidla
/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
Nástroj MCP: preview-travel-settlement
Parametry v cestě
idstringpovinnéOdpověď · 200
orderIdnull | stringpovinnédaysobject[]povinnédatestringpovinnédatedomesticMinutesintegerpovinné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 | stringfareCentsintegerlimitCentsintegerfamilyVisitHalerintegerpovinné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éStatutory 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
Nástroj MCP: get-travel-rates
Parametry dotazu
yearintegermin 1990max 2100Odpověď · 200
yearintegerpovinnécitationstringpovinnémileageHalerobjectpovinnémotorcycleintegerpovinnécarintegerpovinnémealsHalerobjectpovinnétier5to12integerpovinnétier12to18integerpovinnéover18integerpovinnémealsMaxHalerobjectpovinnétier5to12integerpovinnétier12to18integerpovinnéover18integerpovinnéfuelHalerobject[]povinnéfromstringpovinnédateba95integerpovinnéba98integerpovinnédieselintegerpovinnéelectricityintegerpovinnéforeignobject[]povinnécountryCodenull | stringpovinnénamenull | stringpovinnécurrencynull | stringpovinnébaseAmountintegerpovinnéList logbook trips, filterable by vehicle, type, and date
/v1/tripsList logbook trips, filterable by vehicle, type, and date
Nástroj MCP: list-trips
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDvehicleIdstringtripType"business" | "private"Odpověď · 200
dataobject[]povinnéobject"vehicle_trip"povinnéidstringpovinnévehicleIdstringpovinnérouteIdnull | stringpovinnédatestringpovinnédatefromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnédrivernull | stringpovinnéodometerStartinteger | nullpovinnéodometerEndinteger | nullpovinnénotestring | nullcontinuityIssuesobject[]idstringpovinnédatestringpovinnédatekindstringpovinnéexpectedintegerpovinnéactualintegerpovinnétotalintegerhasMorebooleanpovinnéAdd 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.
Nástroj MCP: create-trip
Tělo požadavku
vehicleIdstringpovinnérouteIdstringdatestringpovinnéYYYY-MM-DDfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"driverstringmax 500 charsodometerStartintegermin 0max 9007199254740991odometerEndintegermin 0max 9007199254740991notestringmax 2000 charsOdpověď · 201
idstringpovinnévehicleIdstringpovinnérouteIdnull | stringpovinnédatestringpovinnédatefromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnédrivernull | stringpovinnéodometerStartinteger | nullpovinnéodometerEndinteger | nullpovinnénotestring | nullcontinuityIssuesobject[]idstringpovinnédatestringpovinnédatekindstringpovinnéexpectedintegerpovinnéactualintegerpovinnéCorrect a logbook trip
/v1/trips/{id}Correct a logbook trip
Nástroj MCP: update-trip
Parametry v cestě
idstringpovinnéTělo požadavku
vehicleIdstringrouteIdstringdatestringYYYY-MM-DDfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"driverstringmax 500 charsodometerStartintegermin 0max 9007199254740991odometerEndintegermin 0max 9007199254740991notestringmax 2000 charsOdpověď · 200
idstringpovinnévehicleIdstringpovinnérouteIdnull | stringpovinnédatestringpovinnédatefromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnédrivernull | stringpovinnéodometerStartinteger | nullpovinnéodometerEndinteger | nullpovinnénotestring | nullcontinuityIssuesobject[]idstringpovinnédatestringpovinnédatekindstringpovinnéexpectedintegerpovinnéactualintegerpovinnéDelete a logbook trip
/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éImport 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.
Nástroj MCP: import-trips
Tělo požadavku
vehicleIdstringcsvstringmax 4000000 charsfileBase64stringmax 8000000 charscolumnMapobjectdryRunbooleanOdpověď · 200
dryRunbooleanpovinnéimportedintegerpovinnévalidintegerpovinnéduplicatesintegerpovinnéerrorsobject[]povinnélineintegerpovinnémessagenull | stringpovinnécontinuityIssuesany[]povinnéheadersarray | nullpovinnémissingarray | nullpovinnéList VehicleRoutes
/v1/vehicle-routesList VehicleRoutes
Nástroj MCP: list-vehicle-routes
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"vehicle_route"povinnéidstringpovinnénamestringpovinnéfromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnétotalintegerhasMorebooleanpovinnéCreate a VehicleRoute
/v1/vehicle-routesCreate a VehicleRoute
Nástroj MCP: create-vehicle-route
Tělo požadavku
namestringpovinnémax 200 charsfromPlacestringpovinnémax 200 charstoPlacestringpovinnémax 200 charspurposestringmax 500 charskmMilliintegerpovinnémin 0max 9007199254740991tripType"business" | "private"Odpověď · 201
idstringpovinnénamestringpovinnéfromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnéGet a VehicleRoute
/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éUpdate a VehicleRoute
/v1/vehicle-routes/{id}Update a VehicleRoute
Nástroj MCP: update-vehicle-route
Parametry v cestě
idstringpovinnéTělo požadavku
namestringmax 200 charsfromPlacestringmax 200 charstoPlacestringmax 200 charspurposestringmax 500 charskmMilliintegermin 0max 9007199254740991tripType"business" | "private"Odpověď · 200
idstringpovinnénamestringpovinnéfromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnéDelete a VehicleRoute
/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éFill 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.
Nástroj MCP: generate-trips-from-route
Parametry v cestě
idstringpovinnéTělo požadavku
vehicleIdstringpovinnédatesstring[]fromstringYYYY-MM-DDtostringYYYY-MM-DDweekdaysinteger[]skipstring[]roundTripbooleandriverstringmax 500 charsdryRunbooleanOdpověď · 200
dryRunbooleanpovinnécreatedintegerpovinnéskippedDatesstring[]povinnélastOdometerintegerpovinnétripsobject[]povinnéobject"vehicle_trip"povinnéidstringpovinnévehicleIdstringpovinnérouteIdnull | stringpovinnédatestringpovinnédatefromPlacestringpovinnétoPlacestringpovinnépurposenull | stringpovinnékmMilliintegerpovinnétripTypestringpovinnédrivernull | stringpovinnéodometerStartinteger | nullpovinnéodometerEndinteger | nullpovinnénotestring | nullcontinuityIssuesobject[]idstringpovinnédatestringpovinnédatekindstringpovinnéexpectedintegerpovinnéactualintegerpovinnéSeznam: vozidlo
/v1/vehiclesList Vehicles
Nástroj MCP: list-vehicles
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 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étotalintegerhasMorebooleanpovinnéVytvoření: vozidlo
/v1/vehiclesCreate a Vehicle
Nástroj MCP: create-vehicle
Tělo požadavku
registrationPlatestringpovinnémax 20 charsnamestringpovinnémax 200 charskind"car" | "motorcycle" | "truck" | "bus" | "tractor"categorystringmax 10 charsfuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"povinnéownership"company" | "private" | "leased"odometerStartintegermin 0max 9007199254740991consumptionMilliintegermin 0max 9007199254740991vinstringmax 40 charsfirstRegisteredOnstringYYYY-MM-DDgrossWeightKgintegermin 0max 9007199254740991axlesintegermin 0max 20engineCcintegermin 0max 9007199254740991roadTaxRelevantbooleanassetIdstringisActivebooleannotestringmax 2000 charsOdpověď · 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éDetail: vozidlo
/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éÚprava: vozidlo
/v1/vehicles/{id}Update a Vehicle
Nástroj MCP: update-vehicle
Parametry v cestě
idstringpovinnéTělo požadavku
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 charsOdpověď · 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éSmazání: vozidlo
/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éDownload the logbook of a vehicle as a PDF
/v1/vehicles/{id}/logbook.pdfDownload the logbook of a vehicle as a PDF
Nástroj MCP: export-vehicle-logbook-pdf
Parametry v cestě
idstringpovinnéParametry dotazu
fromstringYYYY-MM-DDtostringYYYY-MM-DDOdpověď · 200
Vrací soubor application/pdf.
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
Nástroj MCP: check-vehicle-odometer
Parametry v cestě
idstringpovinnéOdpověď · 200
vehicleIdnull | stringpovinnéokbooleanpovinnélastOdometerintegerpovinnéissuesobject[]povinnéidstringpovinnédatestringpovinnédatekindstringpovinnéexpectedintegerpovinnéactualintegerpovinnéMonthly 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
Nástroj MCP: get-vehicle-year-summary
Parametry v cestě
idstringpovinnéParametry dotazu
yearintegerpovinnémin 1990max 2100Odpověď · 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é