Schema CreateReceiptRequest

CreateReceiptRequest (object)

Field

Type

Description

account_user_id

integer

—

contact_id

integer

—

cost_center_id

integer

—

currency_code

string

—

date*

string

Date in Y-m-d format

delivery_date

string

Date in Y-m-d format

due_date

string

Date in Y-m-d format

exchange_rate

string

Optional exchange rate to EUR (foreign units per 1 EUR, ECB convention). When omitted, it is prefilled from the daily ECB rate for the receipt date.

file_hash

string

SHA-256 hash returned by analyzeReceiptFile; attaches the staged upload to the receipt.

issuer_reference

string

—

positions

object[]

Required unless creating a draft with file_hash (document-only capture).

array

Elements

Field	Type	Description
booking_account_catalog_category_id	integer	Snapshot of catalog category id at save time
booking_account_catalog_category_name	string	Snapshot of catalog category name at save time
booking_account_catalog_id	integer	Selected platform booking account catalog entry
booking_account_source	string	Origin of a booking account selection string catalog custom manual
booking_account_type	string	Booking account catalog account type (Kontoart) string expense revenue tax other
chart_of_accounts	string	Chart of accounts snapshot string deu-skr03 deu-skr04
custom_ledger_account_id	integer	Selected tenant custom ledger account
depreciation_afa_ledger_account_name	string	Snapshot of the mapped AfA expense ledger account name
depreciation_afa_ledger_account_number	string	Snapshot of the mapped AfA expense ledger account
depreciation_method	string	Depreciation method when this position is treated as a fixed asset string linear gwg
depreciation_useful_life_years	integer	Useful life in years (required for linear depreciation)
description*	string	—
id	integer	Stable identifier of the persisted receipt position. Returned in responses; send it back on update to preserve position identity. Omit for newly added positions.
ledger_account_name	string	Ledger account name snapshot
ledger_account_number	string	Ledger account number (category / account)
position*	string	—
price_unit*	integer	Net line amount in cents (quantity is always 1)
tax_rate*	number	—

positions_price_input_mode

string

Whether position unit prices were entered as net or gross (display preference; price_unit is always stored net).

string

net
gross

project_id

integer

—

receipt_type*

string

expense
income

reference

string

—

service_date_from

string

Date in Y-m-d format

service_date_to

string

Date in Y-m-d format

service_order_id

integer

—

start_analysis

boolean

When true and a file is attached on a draft receipt, analysis starts automatically after save.

status

string

draft
open

vat_rule_code

string

—

Example (JSON)

{
  "receipt_type": "expense",
  "status": "draft",
  "date": "2025-01-14T00:00:00.000Z",
  "contact_id": 0,
  "cost_center_id": 0,
  "project_id": 0
}