ConnectCloud Developers

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 rates
  • days (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 items
    • date (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 of mileage, 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 expense
    • km (number): Kilometres of a mileage item
    • merchant (string): Issuer of the receipt (max length 200)
    • receiptId (string): A receipt of the same report
    • vatCents (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 day
    • allowanceCents (integer): Meal allowance of the day in cents
    • country (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 cents
    • hours (number): Hours away on the day
    • kind (string): full (24 h), partial (arrival or departure day, or more than 8 h) or none (one of full, partial, none)
    • lodgingCents (integer): Lodging lump sum of the night after the day in cents
    • rateCents (integer): Allowance rate of the day in cents
  • expensesCents (integer): Receipted expenses in cents
  • lodgingLumpSumCents (integer): Lodging lump sums in cents
  • mealAllowanceCents (integer): Meal allowance in cents (after deductions for provided meals)
  • mileageCents (integer): Mileage allowance in cents
  • totalCents (integer): Total reimbursement in cents
  • warnings (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"}'

View as Markdown · Interactive reference · OpenAPI