Schema CreateInvoiceRequest

CreateInvoiceRequest (object)

Feld

Typ

Beschreibung

account_user_id

integer

—

address_line_1

string

First line of the address (Street and House number)

address_line_2

string

Second line of the address

adjustments

object[]

array

Elemente

Feld	Typ	Beschreibung
description	string	—
rate	number	—
title*	string	—
type*	string	string surcharge discount
value	integer	—

buyer_email

string

—

buyer_reference

string

—

cash_discount_days

integer

—

cash_discount_rate

number

—

city

string

City of the address.

contact_id*

integer

—

cost_center_id

integer

—

country_code

string

ISO country code of the address.

currency_code

string

—

date*

string

—

delivery_date

string

Date in Y-m-d format

delivery_terms

string

—

due_date*

string

Date in Y-m-d format

e_invoice

boolean

When true, the PDF is generated with embedded ZUGFeRD 2.2 (EN16931) XML

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 document date.

formatted_number

string

—

name_line_1

string

—

name_line_2

string

—

name_line_3

string

—

payment_method_code

string

—

payment_terms

string

—

positions

object[]

array

Elemente

Feld	Typ	Beschreibung
chart_of_accounts	string	Chart of accounts snapshot (receipt positions) string deu-skr03 deu-skr04
description	string	—
discount_rate	number	—
discount_value	integer	—
is_optional	boolean	—
ledger_account_name	string	Ledger account name snapshot (receipt positions)
ledger_account_number	string	Ledger account number (receipt positions)
position*	string	—
price_unit	integer	—
product_sku	string	—
quantity	number	—
tax_rate	number	—
title*	string	—
unit_code	string	UN/CEFACT unit of measure code (Recommendation 20/21). Null allowed for optional positions. Code meanings: - C62: unit (piece) - HUR: hour - DAY: day - KGM: kilogram - GRM: gram - LTR: litre - CMT: centimetre - MTR: metre - MTK: square metre - MTQ: cubic metre - KMT: kilometre - TNE: tonne (metric) - PAC: package - PR: pair - BOX: box - RO: roll - SET: set - PCE: page - MIN: minute - SEC: second - MLT: millilitre - MMT: millimetre - P1: percent - ZZ: lump sum (generic / no unit) string C62 HUR DAY KGM GRM LTR CMT MTR MTK MTQ KMT TNE PAC PR BOX RO SET PCE MIN SEC MLT MMT P1 ZZ

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

print_background_id

integer

—

print_layout_id

integer

—

print_options

object

Feld	Typ	Beschreibung
show_contact_number	boolean	Show contact number
show_folding_marks	boolean	Show folding marks
show_footer	boolean	Show footer
show_header	boolean	Show header
show_item_prices	boolean	Show item prices
show_item_quantities	boolean	Show item quantities
show_item_sku	boolean	Show item SKU
show_item_tax_rate	boolean	Show item tax rate
show_item_totals	boolean	Show item totals
show_logo	boolean	Show logo
show_logo_text	boolean	Show logo text
show_page_numbers	boolean	Show page numbers
show_signature_field	boolean	Show signature field
show_terms	boolean	Show terms
show_totals	boolean	Show totals

project_id

integer

—

reference

string

—

service_contract_id

integer

—

service_date_from

string

Date in Y-m-d format

service_date_to

string

Date in Y-m-d format

service_object_ids

integer[]

array

Elemente

integer

service_order_id

integer

—

source_document

object

Polymorphic reference to a business document in the account

Feld	Typ	Beschreibung
id*	integer	—
type*	string	string quote order_confirmation delivery_note invoice credit_note custom_document

state

string

State or region of the address.

subject

string

—

text_bottom

string

—

text_top

string

—

vat_rule_code

string

—

zip

string

ZIP or postal code.

Beispiel (JSON)

{
  "formatted_number": "string",
  "date": "string",
  "contact_id": 0,
  "cost_center_id": 0,
  "project_id": 0,
  "service_contract_id": 0,
  "due_date": "2025-01-14T00:00:00.000Z"
}