## 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:

```json
{
  "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:

```json
{
  "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

```bash
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"}'
```
