curl --request PUT \
--url https://api.comstruct.com/v1/suppliers/{id}/legal-entities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"legalEntityNumbers": [
"LE-001",
"LE-002"
]
}
'{
"supplierId": "33333333-3333-4333-8333-333333333333",
"legalEntityNumbers": [
"LE-001",
"LE-002"
]
}Lieferanten
Lieferant Buchungskreisen zuordnen
Erforderliche Berechtigungen: suppliers:write
Ersetzt die vollständige Buchungskreis-Zuordnung eines Lieferanten. Der API-Schlüssel muss mit einem Kunden verknüpft sein, der Lieferant und alle Buchungskreise müssen zu diesem Kunden gehören.
Senden Sie legalEntityNumbers: [], um alle Zuordnungen zu entfernen.
PUT
/
suppliers
/
{id}
/
legal-entities
curl --request PUT \
--url https://api.comstruct.com/v1/suppliers/{id}/legal-entities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"legalEntityNumbers": [
"LE-001",
"LE-002"
]
}
'{
"supplierId": "33333333-3333-4333-8333-333333333333",
"legalEntityNumbers": [
"LE-001",
"LE-002"
]
}Übersicht
Mit diesem Endpunkt ordnen Kundensysteme einen Lieferanten einem oder mehreren Buchungskreisen zu. Der Request ersetzt immer die vollständige Zuordnungsliste des Lieferanten.Senden Sie ein leeres Array, um alle Buchungskreis-Zuordnungen zu entfernen.
Der Lieferant ist danach wieder mandantenweit sichtbar.
Berechtigungen
| Scope | Tenant-Typ |
|---|---|
suppliers:write | Kunden-API-Schlüssel |
Header
| Header | Pflicht | Beschreibung |
|---|---|---|
x-api-key | Ja | API-Schlüssel mit Scope suppliers:write |
Content-Type | Ja | application/json |
Path-Parameter
| Parameter | Beschreibung |
|---|---|
id | UUID des Lieferanten, dessen Buchungskreise ersetzt werden |
Request-Body
| Feld | Pflicht | Beschreibung |
|---|---|---|
legalEntityNumbers | Ja | Vollständige Liste der Buchungskreisnummern für diesen Lieferanten |
Beispiel
curl -X PUT "https://api.comstruct.com/v1/suppliers/33333333-3333-4333-8333-333333333333/legal-entities" \
-H "x-api-key: IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"legalEntityNumbers": [
"LE-001",
"LE-002"
]
}'
Alle Zuordnungen entfernen
curl -X PUT "https://api.comstruct.com/v1/suppliers/33333333-3333-4333-8333-333333333333/legal-entities" \
-H "x-api-key: IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{ "legalEntityNumbers": [] }'
Verhalten
- Die übergebene Liste ersetzt alle vorhandenen Buchungskreis-Zuordnungen des Lieferanten.
- Doppelte Nummern sind nicht erlaubt.
- Der Lieferant muss zum Kunden des API-Schlüssels gehören.
- Alle Buchungskreise müssen zum selben Kunden gehören.
Response Codes
| Code | Beschreibung |
|---|---|
200 | Zuordnung erfolgreich ersetzt |
400 | Ungültige Anfrage, doppelte Nummern oder Buchungskreis gehört nicht zum Kunden |
401 | Nicht autorisiert — API-Schlüssel ist mit keinem Kunden verknüpft |
403 | Verboten — fehlender Scope suppliers:write |
404 | Lieferant wurde im aktuellen Mandanten nicht gefunden |
500 | Interner Serverfehler |
Autorisierungen
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.
Pfadparameter
UUID des Lieferanten
Body
application/json
Vollständige Liste der Buchungskreisnummern für diesen Lieferanten. Ein leeres Array entfernt alle Zuordnungen.
Beispiel:
["LE-001", "LE-002"]