curl --request POST \
--url https://api.comstruct.com/v1/accounts \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"title": "Materials Account",
"number": "ACC-4000"
}
]
'[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "Materials Account",
"number": "ACC-4000",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tax_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"active": true,
"is_favorite": true
}
]Konten erstellen oder aktualisieren
Erforderliche Berechtigungen: accounts:write
Erstellt oder aktualisiert ein oder mehrere Konten für den aktuellen Mandanten.
Verwendet das number-Feld zum Abgleich bestehender Konten für Aktualisierungen.
titlewird bei bestehenden Konten immer überschrieben.tax_code_id,activeundis_favoritewerden nur überschrieben, wenn sie im jeweiligen Eintrag enthalten sind. Weggelassene Felder behalten ihren gespeicherten Wert; neue Konten sind standardmäßig aktiv.- Enthält die Anfrage dieselbe
numbermehrfach (z. B. ein Sachkonto pro Buchungskreis aus dem ERP-Export), wird nur der letzte Eintrag übernommen.
curl --request POST \
--url https://api.comstruct.com/v1/accounts \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"title": "Materials Account",
"number": "ACC-4000"
}
]
'[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "Materials Account",
"number": "ACC-4000",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tax_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"active": true,
"is_favorite": true
}
]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.
Scopes
Body
Der Titel des Kontos. Wird bei bestehenden Konten immer überschrieben.
"Materials Account"
Die Nummer/der Code des Kontos. Eindeutig pro Mandant und Abgleichsschlüssel für Aktualisierungen.
"ACC-4000"
Die ID eines Steuercodes des Mandanten (siehe GET /tax-codes). Weglassen behält den gespeicherten Wert, null entfernt die Zuordnung.
"a1b2c3d4-e5f6-4890-abcd-ef1234567890"
Ob das Konto aktiv ist. Standardmäßig true für neue Konten; weglassen behält den gespeicherten Wert eines bestehenden Kontos.
true
Ob das Konto ein Favorit ist. Weglassen behält den gespeicherten Wert eines bestehenden Kontos.
false
Antwort
Konten erfolgreich erstellt oder aktualisiert
Die eindeutige Kennung des Kontos
Der Titel des Kontos
"Materials Account"
Die Nummer/der Code des Kontos
"ACC-4000"
Die Mandanten-ID
Die ID des zugeordneten Steuercodes
Ob das Konto aktiv ist
Ob das Konto ein Favorit ist