PATCH /api/account/service-contracts/{id}

patch/api/account/service-contracts/{id}

Beispielanfrage

PATCH https://api.jupiter-erp.com/api/account/service-contracts/example-id

Code

curl -X PATCH 'https://api.jupiter-erp.com/api/account/service-contracts/example-id' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'X-Account-Uuid: YOUR_ACCOUNT_UUID' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": 0,
  "formatted_number": "string",
  "contact_id": 0,
  "cost_center_id": 0,
  "project_id": 0,
  "account_user_id": 0
}'

Parameter

Name	In	Pflicht	Beschreibung
id	path	ja	—

Request Body

Optional

ModellUpdateServiceContractRequest

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	—

automatic_generation

boolean

—

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

Elemente

string (email)

email_cc

string (email)[]

array

Elemente

string (email)

email_copy_to_self

boolean

—

email_message

string

—

email_subject

string

—

email_to

string (email)[]

array

Elemente

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 per account

interval_amount

integer

—

interval_unit

string

day
week
month
year

invoice_anchor

string

first
middle
last

invoice_mode

string

automatic_draft
automatic_send_email

last_created_period_start

string (date)

Start of the last period for which a document was created; may be set manually or by background jobs.

name_line_1

string

—

name_line_2

string

—

name_line_3

string

—

number

integer

Sequential service contract number per account

payment_method_code

string

—

payment_term_days

integer

Zahlungsziel in Tagen für erstellte Rechnungen.

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

—

recurring_document_type

string

invoice
service_order

reference

string

—

service_object_ids

integer[]

array

Elemente

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.

Beispiel Request

{
  "number": 0,
  "formatted_number": "string",
  "contact_id": 0,
  "cost_center_id": 0,
  "project_id": 0,
  "account_user_id": 0
}

Antworten

200OK

ModellServiceContract

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	—

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

object

Feld

Typ

Beschreibung

additional_name

string

—

address_line_1

string

First line of the address (Street and House number)

address_line_2

string

Second line of the address

avatar

object

Feld	Typ	Beschreibung
id	integer	—
url	string	—

bank_bic

string

Bank BIC/SWIFT code

bank_iban

string

Bank IBAN

birthdate

string (date)

Birthdate of the contact in ISO 8601 format.

buyer_reference

string

—

cash_discount_days

integer

Cash discount days for the contact.

cash_discount_rate

number (float)

Cash discount percentage for the contact.

city

string

City of the address.

company_name

string

Company name (used as name_line_3 in document addresses).

contact_number

integer

—

country_code

string

ISO country code of the address.

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

creditor_number

integer

—

custom_data

object

—

customer_discount_rate

number (float)

Customer-specific discount percentage.

debtor_number

integer

—

delivery_terms

string

—

emails

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (email)	—

fields

object[]

List of contact field values

array

Elemente

Feld	Typ	Beschreibung
id*	integer	Field ID
key*	string	Field key
value*	object	Value of the field

first_name

string

—

gender

string

female
male
diverse

group_ids

integer[]

array

Elemente

integer

groups

object[]

List of groups associated with the contact.

array

Elemente

Feld	Typ	Beschreibung
id*	integer	Unique identifier for the group.
name*	string	Name of the group.

id*

integer

—

internal_note

string

HTML

is_organisation*

boolean

—

last_name

string

—

name*

string

—

parent

object

Feld

Typ

Beschreibung

additional_name

string

—

address_line_1

string

First line of the address (Street and House number)

address_line_2

string

Second line of the address

bank_bic

string

Bank BIC/SWIFT code

bank_iban

string

Bank IBAN

birthdate

string (date)

Birthdate of the contact in ISO 8601 format.

buyer_reference

string

—

cash_discount_days

integer

Cash discount days for the contact.

cash_discount_rate

number (float)

Cash discount percentage for the contact.

city

string

City of the address.

company_name

string

Company name (used as name_line_3 in document addresses).

contact_number

integer

—

country_code

string

ISO country code of the address.

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

creditor_number

integer

—

custom_data

object

—

customer_discount_rate

number (float)

Customer-specific discount percentage.

debtor_number

integer

—

delivery_terms

string

—

emails

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (email)	—

first_name

string

—

gender

string

female
male
diverse

id*

integer

—

internal_note

string

HTML

is_organisation*

boolean

—

last_name

string

—

name*

string

—

parent_id

integer

—

payment_term_days

integer

—

payment_terms

string

—

phones

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string	Phone number in E.164 format.

position

string

Position of the contact in the organisation.

quote_due_days

integer

—

reference_key

string

—

sepa_creditor_id

string

—

state

string

State or region of the address.

tax_id

string

Tax ID

title

string

Title of the contact (e.g., Mr., Mrs.).

type*

string

organisation
person

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

vat_id

string

VAT ID

websites

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (https://test.com)	—

zip

string

ZIP or postal code.

parent_id

integer

—

payment_term_days

integer

—

payment_terms

string

—

phones

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string	Phone number in E.164 format.

position

string

Position of the contact in the organisation.

quote_due_days

integer

—

reference_key

string

—

sepa_creditor_id

string

—

state

string

State or region of the address.

status*

string

Contact lifecycle status. List endpoints default to active contacts when omitted.

string

active
archived

tax_id

string

Tax ID

title

string

Title of the contact (e.g., Mr., Mrs.).

type*

string

organisation
person

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

vat_id

string

VAT ID

websites

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (https://test.com)	—

zip

string

ZIP or postal code.

contact_id*

integer

—

cost_center

object

Feld	Typ	Beschreibung
booking_account_number	integer	—
code	string	—
created_at	string (date-time)	Creation timestamp in ISO 8601 format.
id*	integer	—
name*	string	—
updated_at	string (date-time)	Last update timestamp in ISO 8601 format.

cost_center_id

integer

—

country_code

string

ISO country code of the address.

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

currency_code*

string

—

delivery_terms

string

—

email_bcc

string (email)[]

array

Elemente

string (email)

email_cc

string (email)[]

array

Elemente

string (email)

email_copy_to_self

boolean

—

email_message

string

—

email_subject

string

—

email_to

string (email)[]

array

Elemente

string (email)

end_date

string (date)

End of last billing period (End-Datum). To pause, set to the last day to bill.

first_period_start*

string (date)

Start of first billing period (Datum erste Periode). When resuming after a pause, set to the desired restart date.

formatted_number*

string

Display number (account format), unique per account

id*

integer

—

interval_amount*

integer

Length of each billing period in interval_unit steps from the period start (e.g. 3 with unit month = quarterly from first_period_start).

interval_unit*

string

day
week
month
year

invoice_anchor*

string

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

string

first
middle
last

invoice_mode*

string

How automatically created invoices are handled when recurring_document_type is invoice. Does not enable automation by itself; use automatic_generation.

string

automatic_draft
automatic_send_email

last_billing

allOf(1)

Latest invoice or service order for this contract (read-only; matches recurring_document_type)

Latest invoice or service order created for this contract's billing periods (matches recurring_document_type).

Feld	Typ	Beschreibung
document_type*	string	string invoice service_order
formatted_number*	string	—
id*	integer	—
service_contract_period_from	string (date)	—
service_contract_period_to	string (date)	—

last_created_period_start

string (date)

Start date of the last billing period for which a document was created (manual or automatic).

name_line_1

string

—

name_line_2

string

—

name_line_3

string

—

next_billing_period_from

string (date)

Computed; start of next billing period (read-only)

next_billing_period_to

string (date)

Computed; end of next billing period (read-only)

next_invoice_due_date

string (date)

Computed; anchor date when next invoice should be created (read-only)

next_order_due_date

string (date)

Computed when recurring_document_type is service_order; first day of the next billing period (read-only)

number*

integer

Sequential service contract number per account (internal)

payment_method_code

string

—

payment_term_days

integer

Zahlungsziel in Tagen für aus diesem Vertrag erstellte Rechnungen. Fehlt der Wert, wird die Konten-Standard-Einstellung verwendet.

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

object

Feld

Typ

Beschreibung

account_user

object

Feld

Typ

Beschreibung

abilities

string[]

Ability strings for this account user. Included when listing or getting users (admin editing). Omitted in embedded contexts (e.g. documents, projects, service orders) to avoid leaking permission data.

array

Elemente

string

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

display_email

string

—

display_name

string

—

display_phone

string

—

id*

integer

—

invited_email

string

Email address the user was invited with. Set for pending account users; null after acceptance or when not applicable.

role*

string

user
admin

status*

string

active
blocked
pending

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

user

object

Feld	Typ	Beschreibung
email*	string	—
id*	integer	—
image_url	string	—
name*	string	—

account_user_id

integer

—

contact

object

Feld

Typ

Beschreibung

additional_name

string

—

address_line_1

string

First line of the address (Street and House number)

address_line_2

string

Second line of the address

avatar

object

Feld	Typ	Beschreibung
id	integer	—
url	string	—

bank_bic

string

Bank BIC/SWIFT code

bank_iban

string

Bank IBAN

birthdate

string (date)

Birthdate of the contact in ISO 8601 format.

buyer_reference

string

—

cash_discount_days

integer

Cash discount days for the contact.

cash_discount_rate

number (float)

Cash discount percentage for the contact.

city

string

City of the address.

company_name

string

Company name (used as name_line_3 in document addresses).

contact_number

integer

—

country_code

string

ISO country code of the address.

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

creditor_number

integer

—

custom_data

object

—

customer_discount_rate

number (float)

Customer-specific discount percentage.

debtor_number

integer

—

delivery_terms

string

—

emails

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (email)	—

fields

object[]

List of contact field values

array

Elemente

Feld	Typ	Beschreibung
id*	integer	Field ID
key*	string	Field key
value*	object	Value of the field

first_name

string

—

gender

string

female
male
diverse

group_ids

integer[]

array

Elemente

integer

groups

object[]

List of groups associated with the contact.

array

Elemente

Feld	Typ	Beschreibung
id*	integer	Unique identifier for the group.
name*	string	Name of the group.

id*

integer

—

internal_note

string

HTML

is_organisation*

boolean

—

last_name

string

—

name*

string

—

parent

object

Feld

Typ

Beschreibung

additional_name

string

—

address_line_1

string

First line of the address (Street and House number)

address_line_2

string

Second line of the address

bank_bic

string

Bank BIC/SWIFT code

bank_iban

string

Bank IBAN

birthdate

string (date)

Birthdate of the contact in ISO 8601 format.

buyer_reference

string

—

cash_discount_days

integer

Cash discount days for the contact.

cash_discount_rate

number (float)

Cash discount percentage for the contact.

city

string

City of the address.

company_name

string

Company name (used as name_line_3 in document addresses).

contact_number

integer

—

country_code

string

ISO country code of the address.

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

creditor_number

integer

—

custom_data

object

—

customer_discount_rate

number (float)

Customer-specific discount percentage.

debtor_number

integer

—

delivery_terms

string

—

emails

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (email)	—

first_name

string

—

gender

string

female
male
diverse

id*

integer

—

internal_note

string

HTML

is_organisation*

boolean

—

last_name

string

—

name*

string

—

parent_id

integer

—

payment_term_days

integer

—

payment_terms

string

—

phones

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string	Phone number in E.164 format.

position

string

Position of the contact in the organisation.

quote_due_days

integer

—

reference_key

string

—

sepa_creditor_id

string

—

state

string

State or region of the address.

tax_id

string

Tax ID

title

string

Title of the contact (e.g., Mr., Mrs.).

type*

string

organisation
person

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

vat_id

string

VAT ID

websites

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (https://test.com)	—

zip

string

ZIP or postal code.

parent_id

integer

—

payment_term_days

integer

—

payment_terms

string

—

phones

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string	Phone number in E.164 format.

position

string

Position of the contact in the organisation.

quote_due_days

integer

—

reference_key

string

—

sepa_creditor_id

string

—

state

string

State or region of the address.

status*

string

Contact lifecycle status. List endpoints default to active contacts when omitted.

string

active
archived

tax_id

string

Tax ID

title

string

Title of the contact (e.g., Mr., Mrs.).

type*

string

organisation
person

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

vat_id

string

VAT ID

websites

object[]

array

Elemente

Feld	Typ	Beschreibung
name	string	—
value	string (https://test.com)	—

zip

string

ZIP or postal code.

contact_id

integer

—

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

description

string

—

end_date

string

—

formatted_number*

string

Display number (account format), unique per account

hex_color

string

—

id*

integer

—

name*

string

—

number*

integer

Sequential project number per account (internal)

start_date

string

—

status

string

—

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

project_id

integer

—

recurring_document_type*

string

Generates either invoices or service orders from this contract, not both.

string

invoice
service_order

reference

string

—

service_object_ids

integer[]

Service object IDs copied to automatically created service orders.

array

Elemente

integer

service_order_assignee

object

Feld

Typ

Beschreibung

abilities

string[]

array

Elemente

string

created_at

string (date-time)

Creation timestamp in ISO 8601 format.

display_email

string

—

display_name

string

—

display_phone

string

—

id*

integer

—

invited_email

string

Email address the user was invited with. Set for pending account users; null after acceptance or when not applicable.

role*

string

user
admin

status*

string

active
blocked
pending

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

user

object

Feld	Typ	Beschreibung
email*	string	—
id*	integer	—
image_url	string	—
name*	string	—

service_order_assignee_account_user_id

integer

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

state

string

State or region of the address.

status*

string

active
inactive

subject

string

—

text_bottom

string

—

text_top

string

—

updated_at

string (date-time)

Last update timestamp in ISO 8601 format.

vat_rule_code

string

—

zip

string

ZIP or postal code.

Beispiel Response

{
  "id": 0,
  "number": 0,
  "formatted_number": "string",
  "contact_id": 0,
  "contact": {
    "id": 0,
    "parent_id": 0,
    "parent": {
      "id": 0,
      "parent_id": 0,
      "type": "organisation",
      "is_organisation": true,
      "name": "string",
      "company_name": "string"
    },
    "type": "organisation",
    "is_organisation": true,
    "name": "string",
    "status": "active"
  },
  "cost_center_id": 0,
  "first_period_start": "2026-01-15",
  "interval_amount": 0,
  "interval_unit": "day",
  "currency_code": "string",
  "status": "active",
  "recurring_document_type": "invoice",
  "automatic_generation": true,
  "invoice_mode": "automatic_draft",
  "invoice_anchor": "first"
}

Service Contracts

Fragen zur Integration?