Compute the reimbursement of an unsaved report (tenant:access)
POST /api/hr/v1/travel-reports/calculate
Module: HR · operationId: calculateTravelReport · Tag: Travel expenses · Auth: access token (Authorization: Bearer <accessToken>)
Dry run for the form; nothing is saved.
Request body
application/json (required)
destination(string, required): Destination of the trip (max length 200)endAt(string, required): Local return time (YYYY-MM-DDTHH:MM)purpose(string, required): Purpose of the trip (max length 200)startAt(string, required): Local departure time (YYYY-MM-DDTHH:MM)country(string): ISO 3166-1 alpha-2 code of the destination (default DE); selects the ratesdays(array of TravelDay): What was provided per day (meals, lodging lump sum)breakfast(boolean): Breakfast provided (cuts the allowance by breakfastPercent of the full-day rate)date(string (date)): Day of the trip (YYYY-MM-DD)dinner(boolean): Dinner was provided (reduces the meal allowance)lodgingLumpSum(boolean): The night after this day without a hotel receipt (lodging lump sum)lunch(boolean): Lunch was provided (reduces the meal allowance)
items(array of TravelItem): Expenses; they replace the report's itemsdate(string (date), required): Date of the expense (YYYY-MM-DD)kind(string, required): Kind of expense; mileage items carry km and are priced with the tenant rate (one ofmileage,transport,lodging,other)amountCents(integer): Gross amount in cents; computed for mileage (km × rate)description(string): What was paid for (max length 200)id(string, read-only): Id of the expensekm(number): Kilometres of a mileage itemmerchant(string): Issuer of the receipt (max length 200)receiptId(string): A receipt of the same reportvatCents(integer): VAT contained in the amount, always computed from amountCents and vatRate (a sent value is ignored; record a receipt with several rates as one item per rate)vatRate(number): VAT rate in percent
note(string): Note of the employee (max length 2000)overnight(boolean): The trip includes overnight stays (required for more than two calendar days)version(integer): Required for PATCH
Example:
{
"country": "DE",
"days": [
{
"breakfast": true,
"date": "2026-11-05"
}
],
"destination": "Alpenhotel Seeblick, Schönau am Königssee",
"endAt": "2026-11-05T18:30",
"items": [
{
"date": "2026-11-04",
"description": "Regensburg – Schönau am Königssee und zurück",
"kind": "mileage",
"km": 380
},
{
"amountCents": 9800,
"date": "2026-11-05",
"description": "Übernachtung mit Frühstück",
"kind": "lodging",
"merchant": "Alpenhotel Seeblick",
"receiptId": "6f8b0d2f-4b6d-4f8b-8d2f-4b6d8f0b2d44",
"vatRate": 7
}
],
"overnight": true,
"purpose": "WLAN-Ausleuchtung und Access-Point-Montage",
"startAt": "2026-11-04T06:45"
}
Responses
- 200 Totals (
application/json) - 400 Error (
application/json)
Fields of the 200 answer:
days(array of object): Allowance per dayallowanceCents(integer): Meal allowance of the day in centscountry(string): Country whose rates apply (ISO 3166-1 alpha-2)date(string (date)): The day (YYYY-MM-DD)deductionCents(integer): Deduction for provided meals in centshours(number): Hours away on the daykind(string): full (24 h), partial (arrival or departure day, or more than 8 h) or none (one offull,partial,none)lodgingCents(integer): Lodging lump sum of the night after the day in centsrateCents(integer): Allowance rate of the day in cents
expensesCents(integer): Receipted expenses in centslodgingLumpSumCents(integer): Lodging lump sums in centsmealAllowanceCents(integer): Meal allowance in cents (after deductions for provided meals)mileageCents(integer): Mileage allowance in centstotalCents(integer): Total reimbursement in centswarnings(array of string): Hints that never block (missing receipts, lump sum next to a hotel receipt)
Example 200 answer:
{
"days": [
{
"allowanceCents": 1400,
"country": "DE",
"date": "2026-11-04",
"deductionCents": 0,
"hours": 17.25,
"kind": "partial",
"lodgingCents": 0,
"rateCents": 1400
},
{
"allowanceCents": 840,
"country": "DE",
"date": "2026-11-05",
"deductionCents": 560,
"hours": 18.5,
"kind": "partial",
"lodgingCents": 0,
"rateCents": 1400
}
],
"expensesCents": 9800,
"lodgingLumpSumCents": 0,
"mealAllowanceCents": 2240,
"mileageCents": 11400,
"totalCents": 23440,
"warnings": []
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/travel-reports/calculate' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"country":"DE","days":[{"breakfast":true,"date":"2026-11-05"}],"destination":"Alpenhotel Seeblick, Schönau am Königssee","endAt":"2026-11-05T18:30","items":[{"date":"2026-11-04","description":"Regensburg – Schönau am Königssee und zurück","kind":"mileage","km":380},{"amountCents":9800,"date":"2026-11-05","description":"Übernachtung mit Frühstück","kind":"lodging","merchant":"Alpenhotel Seeblick","receiptId":"6f8b0d2f-4b6d-4f8b-8d2f-4b6d8f0b2d44","vatRate":7}],"overnight":true,"purpose":"WLAN-Ausleuchtung und Access-Point-Montage","startAt":"2026-11-04T06:45"}'