Skip to main content
POST
/
payment-terms
Zahlungsbedingungen erstellen oder aktualisieren
curl --request POST \
  --url https://api.comstruct.com/v1/payment-terms \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "title": "Net 30",
    "number": "30T",
    "net_days": 30,
    "discount_days1": 10,
    "discount_rate1": 2,
    "discount_days2": 20,
    "discount_rate2": 1
  }
]
'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "Net 30",
    "number": "30T",
    "net_days": 30,
    "discount_days1": 10,
    "discount_rate1": 2,
    "discount_days2": 20,
    "discount_rate2": 1,
    "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_favorite": true,
    "active": true,
    "is_default_for_credit_notes": true
  }
]

Authorizations

​
X-API-Key
string
header
required

API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.

Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.

Body

application/json
​
title
string
required

Der Titel der Zahlungsbedingung

Example:

"Net 30"

​
number
string
required

Die Nummer/der Code der Zahlungsbedingung

Example:

"30T"

​
net_days
integer
required

Anzahl der Tage bis zur Fälligkeit der Zahlung

Example:

30

​
discount_days1
integer
required

Anzahl der Tage für den ersten Skontozeitraum

Example:

10

​
discount_rate1
number
required

Skontosatz für den ersten Zeitraum (Prozent)

Example:

2

​
discount_days2
integer
required

Anzahl der Tage für den zweiten Skontozeitraum

Example:

20

​
discount_rate2
number
required

Skontosatz für den zweiten Zeitraum (Prozent)

Example:

1

Response

Zahlungsbedingungen erfolgreich erstellt oder aktualisiert

​
id
string<uuid>

Die eindeutige Kennung der Zahlungsbedingung

​
title
string

Der Titel der Zahlungsbedingung

Example:

"Net 30"

​
number
string

Die Nummer/der Code der Zahlungsbedingung

Example:

"30T"

​
net_days
integer

Anzahl der Tage bis zur Fälligkeit der Zahlung

Example:

30

​
discount_days1
integer | null

Anzahl der Tage für den ersten Skontozeitraum

Example:

10

​
discount_rate1
number | null

Skontosatz für den ersten Zeitraum (Prozent)

Example:

2

​
discount_days2
integer | null

Anzahl der Tage für den zweiten Skontozeitraum

Example:

20

​
discount_rate2
number | null

Skontosatz für den zweiten Zeitraum (Prozent)

Example:

1

​
tenant_id
string<uuid>

Die Mandanten-ID

​
is_favorite
boolean | null

Ob diese Zahlungsbedingung ein Favorit ist

​
active
boolean | null

Ob diese Zahlungsbedingung aktiv ist

​
is_default_for_credit_notes
boolean | null

Ob dies die Standard-Zahlungsbedingung für Gutschriften ist