Lieferanten aus SAP-System erstellen oder aktualisieren

curl --request POST \
  --url https://api.comstruct.com/v1/suppliers/sap \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "number": "EXTERNAL-09092",
    "title": "Beispiel GmbH-8",
    "legal_uid": "D456789900022202",
    "country_code": "US",
    "comment": "Bevorzugter Kontakt per E-Mail",
    "payment_term": "90T",
    "wth_tax_code": "90",
    "bank_details": [
      {
        "number": "9999912",
        "iban": "DE89370400440532013000"
      },
      {
        "external_id": "8881112",
        "iban": "GB33BUKB20201555555555"
      }
    ],
    "address": {
      "address": "Müllerstraße 1",
      "city": "Berlin",
      "zip": "10115",
      "country_code": "DE"
    }
  }
]
'

{
  "message": "Supplier data received successfully"
}

Lieferanten

SAP-Lieferanten erstellen oder aktualisieren

Erforderliche Berechtigungen: suppliers:write

Empfängt und verarbeitet Lieferanten aus dem SAP-System. Akzeptiert ein Array von SAP-Lieferanten als Rohdaten. number wird als external_id gespeichert und für Upserts pro Kunde verwendet. API-Schlüssel muss mit einem Kunden verknüpft sein. Validierung: Der Body muss ein Array sein, title ist je Lieferant erforderlich, und angegebene Zahlungsbedingungen müssen im comstruct-Mandanten existieren.

POST

suppliers

sap

Lieferanten aus SAP-System erstellen oder aktualisieren

curl --request POST \
  --url https://api.comstruct.com/v1/suppliers/sap \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "number": "EXTERNAL-09092",
    "title": "Beispiel GmbH-8",
    "legal_uid": "D456789900022202",
    "country_code": "US",
    "comment": "Bevorzugter Kontakt per E-Mail",
    "payment_term": "90T",
    "wth_tax_code": "90",
    "bank_details": [
      {
        "number": "9999912",
        "iban": "DE89370400440532013000"
      },
      {
        "external_id": "8881112",
        "iban": "GB33BUKB20201555555555"
      }
    ],
    "address": {
      "address": "Müllerstraße 1",
      "city": "Berlin",
      "zip": "10115",
      "country_code": "DE"
    }
  }
]
'

{
  "message": "Supplier data received successfully"
}

Übersicht

Mit diesem Endpunkt synchronisieren Kundensysteme Lieferanten aus SAP nach comstruct. Der Request-Body ist immer ein Array, sodass ein einzelner Lieferant und Batches über denselben POST-Aufruf verarbeitet werden. Wenn number gesetzt ist, wird sie als external_id des Lieferanten gespeichert. Existiert für denselben Kunden bereits ein Lieferant mit dieser external_id, wird der Datensatz aktualisiert.

Senden Sie number für jeden SAP-Lieferanten mit. Das Feld ist für die Schema-Validierung nicht zwingend, wird aber für idempotente SAP-Syncs und spätere Lookups benötigt.

Berechtigungen

Scope	Tenant-Typ
`suppliers:write`	Kunden-API-Schlüssel

Der API-Schlüssel muss mit einem Kunden verknüpft sein.

Header	Pflicht	Beschreibung
`x-api-key`	Ja	API-Schlüssel mit Scope `suppliers:write`
`Content-Type`	Ja	`application/json`

Request-Body

Der Body muss ein JSON-Array von Lieferanten enthalten.

Lieferantenfelder

Feld	Pflicht	Beschreibung
`title`	Ja	Lieferantenname
`number`	Nein	SAP-Lieferantennummer; wird zu `external_id` gemappt und für Upserts genutzt
`legal_uid`	Nein	USt-IdNr. oder Steuernummer
`country_code`	Nein	ISO 3166-1 Alpha-2 Ländercode
`comment`	Nein	Freitext-Kommentar zum Lieferanten
`payment_term`	Nein	Zahlungsbedingungsschlüssel; muss im comstruct-Mandanten existieren
`wth_tax_code`	Nein	Quellensteuercode; Standardwert ist `00`
`bank_details`	Nein	Bankverbindungen des Lieferanten
`address`	Nein	Lieferantenadresse

Bankverbindungen (`bank_details[]`)

Feld	Pflicht	Beschreibung
`iban`	Nein	Gültige IBAN; Einträge ohne IBAN werden ignoriert
`number`	Nein	Externe Nummer der Bankverbindung; wird bevorzugt als ID gespeichert
`external_id`	Nein	Alternative externe ID, falls `number` nicht gesetzt ist

Adresse (`address`)

Feld	Pflicht	Beschreibung
`address`	Nein	Straße und Hausnummer
`city`	Nein	Ort
`zip`	Nein	Postleitzahl
`country_code`	Nein	ISO 3166-1 Alpha-2 Ländercode

Beispiel

curl -X POST "https://api.comstruct.com/v1/suppliers/sap" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "number": "SAP-SUP-001",
      "title": "Beispiel Lieferant GmbH",
      "legal_uid": "DE123456789",
      "country_code": "DE",
      "comment": "Bevorzugter Kontakt per E-Mail",
      "payment_term": "30T",
      "wth_tax_code": "00",
      "bank_details": [
        {
          "number": "BANK-001",
          "iban": "DE89370400440532013000"
        }
      ],
      "address": {
        "address": "Musterstraße 1",
        "city": "Berlin",
        "zip": "10115",
        "country_code": "DE"
      }
    }
  ]'

Verhalten

number wird als external_id gespeichert; vorhandene Lieferanten mit derselben external_id und demselben Kunden werden aktualisiert.
Nur die Felder external_id, legal_uid, country_code, withholding_tax_code, payment_term_id, title, comment, address, city und zip werden bei Konflikten aktualisiert.
payment_term wird gegen die Zahlungsbedingungen des Kunden aufgelöst. Unbekannte Werte führen zu 400.
Fehlt wth_tax_code, speichert comstruct den Standardwert 00.
Bankverbindungen werden anhand von IBAN, Lieferant und Tenant zusammengeführt; bei Konflikten wird die externe ID der Bankverbindung aktualisiert.

Response Codes

Code	Beschreibung
`200`	Lieferantendaten erfolgreich verarbeitet
`400`	Ungültiger Body, Validierungsfehler oder unbekannte Zahlungsbedingung
`401`	Nicht autorisiert — API-Schlüssel ist mit keinem Kunden verknüpft
`403`	Verboten — fehlender Scope `suppliers:write`
`500`	Interner Serverfehler

Autorisierungen

X-API-Key

string

header

erforderlich

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

erforderlich

Lieferantenname/Titel

Beispiel:

"Beispiel GmbH-8"

number

string

Lieferantennummer aus SAP; wird als external_id gespeichert und für Upserts verwendet

Beispiel:

"EXTERNAL-09092"

legal_uid

string

Optionale Umsatzsteuer-ID

Beispiel:

"D456789900022202"

country_code

string

ISO 3166-1 alpha-2 Ländercode

Beispiel:

"US"

comment

string

Freitext-Kommentar zum Lieferanten

Beispiel:

"Bevorzugter Kontakt per E-Mail"

payment_term

string

Optionaler SAP-Zahlungsbedingungsschlüssel; muss, falls angegeben, im comstruct-Mandanten existieren

Beispiel:

"90T"

wth_tax_code

string

Optionaler Quellensteuercode

Beispiel:

"90"

bank_details

object[]

Optionale Bankverbindungen

Show child attributes

address

object

Show child attributes

Antwort

Lieferantendaten erfolgreich empfangen

message

string

Beispiel:

"Supplier data received successfully"

Dimensions-Zuweisung löschen Lieferant Buchungskreisen zuordnen

​Übersicht

​Berechtigungen

​Header

​Request-Body

​Lieferantenfelder

​Bankverbindungen (bank_details[])

​Adresse (address)

​Beispiel

​Verhalten

​Response Codes

Autorisierungen

Body

Antwort

Übersicht

Berechtigungen

Header

Request-Body

Lieferantenfelder

Bankverbindungen (`bank_details[]`)

Adresse (`address`)

Beispiel

Verhalten

Response Codes