curl --request POST \
--url https://api.comstruct.com/v1/tax-codes \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"title": "VAT 19%",
"number": "VAT19",
"rate": 19,
"recognition": true,
"active": true
}
]
'[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "VAT 19%",
"number": "VAT19",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"rate": 19,
"recognition": true,
"active": true,
"is_favorite": true
}
]Steuercodes erstellen/aktualisieren
Erforderliche Berechtigungen: tax_codes:write
Erstellt oder aktualisiert einen oder mehrere Steuercodes für den aktuellen Mandanten.
Verwendet das number-Feld zum Abgleich bestehender Steuercodes für Aktualisierungen.
titlewird bei bestehenden Steuercodes immer überschrieben.rate,recognition,activeundis_favoritewerden bei bestehenden Steuercodes nur aktualisiert, wenn jeder Eintrag der Anfrage das jeweilige Feld enthält. Fehlt ein Feld in mindestens einem Eintrag, bleibt dieser Wert bei allen bestehenden Steuercodes der Anfrage unverändert. Senden Sie daher immer dieselben Felder für alle Einträge.
curl --request POST \
--url https://api.comstruct.com/v1/tax-codes \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
[
{
"title": "VAT 19%",
"number": "VAT19",
"rate": 19,
"recognition": true,
"active": true
}
]
'[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "VAT 19%",
"number": "VAT19",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"rate": 19,
"recognition": true,
"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 Steuercodes. Wird bei bestehenden Steuercodes immer überschrieben.
"VAT 19%"
Die Nummer/der Code des Steuercodes. Eindeutig pro Mandant und Abgleichsschlüssel für Aktualisierungen.
"VAT19"
Der Steuersatz (z.B. 19 für 19%). Numerische Zeichenketten (z. B. "19") werden akzeptiert.
19
Ob dieser Steuercode für die Erkennung verwendet werden soll
true
Ob dieser Steuercode aktiv ist
true
Ob dieser Steuercode ein Favorit ist
false
Antwort
Steuercodes erfolgreich erstellt oder aktualisiert
Die eindeutige Kennung des Steuercodes
Der Titel des Steuercodes
"VAT 19%"
Die Nummer/der Code des Steuercodes
"VAT19"
Die Mandanten-ID
Der Steuersatz (z.B. 19 für 19%). Fehlt, wenn kein Wert gespeichert ist.
19
Ob dieser Steuercode für die Erkennung verwendet werden soll. Fehlt, wenn kein Wert gespeichert ist.
Ob dieser Steuercode aktiv ist. Fehlt, wenn kein Wert gespeichert ist.
Ob dieser Steuercode ein Favorit ist. Fehlt, wenn kein Wert gespeichert ist.