Schema CreateRecurringReceiptRequest

CreateRecurringReceiptRequest (object)

Field

Type

Description

account_user_id

integer

—

auto_approve

boolean

—

automatic_generation

boolean

—

contact_id

integer

—

cost_center_id

integer

—

currency_code

string

—

due_days

integer

—

end_date

string

Date in Y-m-d format

exchange_rate

string

—

file_hash

string

Hash of a previously staged/uploaded document (see analyzeReceiptFile) to attach to the template.

first_period_start*

string

Date in Y-m-d format

interval_amount*

integer

—

interval_unit*

string

day
week
month
year

issuer_reference

string

—

last_created_period_start

string

Date in Y-m-d format

name*

string

—

positions*

object[]

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_order_id

integer

—

status*

string

active
inactive

vat_rule_code

string

—

Example (JSON)

{
  "name": "string",
  "receipt_type": "expense",
  "status": "active",
  "automatic_generation": true,
  "auto_approve": true,
  "contact_id": 0,
  "positions": [
    {
      "id": 0,
      "position": "string",
      "description": "string",
      "ledger_account_number": "string",
      "ledger_account_name": "string",
      "booking_account_source": "catalog",
      "price_unit": 0,
      "tax_rate": 0
    }
  ],
  "first_period_start": "2025-01-14T00:00:00.000Z",
  "interval_amount": 0,
  "interval_unit": "day"
}