Read a receipt (photo or PDF) with AI into a draft expense
POST /api/hr/v1/travel-reports/{id}/receipts/{receiptId}/extract
Module: HR · operationId: extractTravelReceipt · Tag: Travel expenses · Auth: access token (Authorization: Bearer <accessToken>)
Extraction of date, merchant, amount and VAT of a clean receipt: a photo is read with OCR, a PDF
through the text the DMS extracted from it. The answer is a draft only – nothing is saved; the
person checks it and saves the report. 409 receipt_reading while the DMS is still reading the
PDF (retry shortly), 422 receipt_no_text when the PDF has no readable text (encrypted, failed
or empty – enter the expense by hand), 503 unavailable when AI is not configured or fails.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes | |
receiptId |
path | string (uuid) | yes |
Responses
- 200 Draft (
application/json) - 400 Error (
application/json) - 404 Error (
application/json) - 409 Error (
application/json) - 422 Error (
application/json) - 503 Error (
application/json)
Fields of the 200 answer:
amountCents(integer): Gross amount in centsdate(string (date)): Date of the receipt (YYYY-MM-DD)description(string): What was paid forkind(string): Kind of expense (one oftransport,lodging,other)merchant(string): Issuer of the receiptvatCents(integer): VAT contained in the amount, in centsvatRate(number): VAT rate in percent
Example 200 answer:
{
"amountCents": 9800,
"date": "2026-11-05",
"description": "Übernachtung mit Frühstück",
"kind": "lodging",
"merchant": "Alpenhotel Seeblick",
"vatCents": 641,
"vatRate": 7
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/travel-reports/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/receipts/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/extract' \
-H "Authorization: Bearer $ACCESS_TOKEN"