Skip to main content
POST
Lieferanten erstellen oder aktualisieren

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

Lieferantenname

Example:

"Acme GmbH"

external_id
string
required

Externe Kennung; zusammen mit dem Kunden der Schlüssel für das Upsert

Example:

"SUP-001"

USt-IdNr. oder Steuernummer

Example:

"DE123456789"

country_code
string

ISO 3166-1 alpha-2 Ländercode

Example:

"DE"

withholding_tax_code
string

Quellensteuercode

Example:

"00"

payment_term_id
string<uuid>

ID der Zahlungsbedingung im comstruct-Mandanten

default_account_id
string<uuid>

ID des Standardkontos im comstruct-Mandanten

comment
string

Freitext-Kommentar

Example:

"Bevorzugter Kontakt per E-Mail"

address
string

Straße und Hausnummer

Example:

"Musterstraße 1"

city
string

Ort

Example:

"Berlin"

zip
string

Postleitzahl

Example:

"10115"

is_active
boolean

Ob der Lieferant aktiv ist. Weglassen belässt den gespeicherten Status.

Example:

true

supplier_bank_details
object[]

Bankverbindungen, zusammengeführt anhand der IBAN

Response

Lieferanten erfolgreich erstellt oder aktualisiert

count
integer
Example:

1