Schema CreateServiceContractRequest

CreateServiceContractRequest (object)

Field

Type

Description

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[]

Optional. Omit or send null for none.

array

Elements

Field	Type	Description
description	string	—
rate	number	—
title*	string	—
type*	string	string surcharge discount
value	integer	—

automatic_generation*

boolean

When true, scheduled/manual processing may create documents for this contract.

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

—

delivery_terms

string

—

email_bcc

string (email)[]

array

Elements

string (email)

email_cc

string (email)[]

array

Elements

string (email)

email_copy_to_self

boolean

—

email_message

string

—

email_subject

string

—

email_to

string (email)[]

array

Elements

string (email)

end_date

string (date)

End of last billing period (End-Datum)

first_period_start*

string (date)

Start of first billing period (Datum erste Periode)

formatted_number

string

Display number; omit to generate from account service number format

interval_amount*

integer

—

interval_unit*

string

day
week
month
year

invoice_anchor

string

When in billing period to create invoice (first, middle, or last day).

string

first
middle
last

invoice_mode*

string

Required; for service_order contracts use automatic_draft as a placeholder (automation follows recurring_document_type).

string

automatic_draft
automatic_send_email

last_created_period_start

string (date)

Start date of the last billing period for which a document was created; used for scheduling. Optional on create.

name_line_1

string

—

name_line_2

string

—

name_line_3

string

—

number

integer

Sequential number; omit to assign next free number

payment_method_code

string

—

payment_term_days

integer

Zahlungsziel in Tagen für erstellte Rechnungen.

payment_terms

string

—

positions

object[]

Optional. Omit or send null for none.

array

Elements

Field	Type	Description
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

Field	Type	Description
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

—

recurring_document_type*

string

Whether this contract generates invoices or service orders (mutually exclusive).

string

invoice
service_order

reference

string

—

service_object_ids

integer[]

array

Elements

integer

service_order_assignee_account_user_id

integer

Default field assignee (Bearbeiter) for service orders created from this contract.

state

string

State or region of the address.

status*

string

active
inactive

subject

string

—

text_bottom

string

—

text_top

string

—

vat_rule_code

string

—

zip

string

ZIP or postal code.

Example (JSON)

{
  "number": 0,
  "formatted_number": "string",
  "contact_id": 0,
  "cost_center_id": 0,
  "project_id": 0,
  "account_user_id": 0,
  "first_period_start": "2026-01-15",
  "interval_amount": 0,
  "interval_unit": "day",
  "currency_code": "string",
  "recurring_document_type": "invoice",
  "automatic_generation": true,
  "invoice_mode": "automatic_draft",
  "status": "active"
}