Skip to main content
POST
/
tax-codes
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
  }
]

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

Der Titel des Steuercodes

Example:

"VAT 19%"

number
string
required

Die Nummer/der Code des Steuercodes

Example:

"VAT19"

rate
number

Der Steuersatz (z.B. 19 für 19%)

Example:

19

recognition
boolean

Ob dieser Steuercode für die Erkennung verwendet werden soll

Example:

true

active
boolean

Ob dieser Steuercode aktiv ist

Example:

true

is_favorite
boolean

Ob dieser Steuercode ein Favorit ist

Example:

false

Response

Steuercodes erfolgreich erstellt oder aktualisiert

id
string<uuid>

Die eindeutige Kennung des Steuercodes

title
string

Der Titel des Steuercodes

Example:

"VAT 19%"

number
string

Die Nummer/der Code des Steuercodes

Example:

"VAT19"

tenant_id
string<uuid>

Die Mandanten-ID

rate
number

Der Steuersatz (z.B. 19 für 19%)

Example:

19

recognition
boolean

Ob dieser Steuercode für die Erkennung verwendet werden soll

active
boolean

Ob dieser Steuercode aktiv ist

is_favorite
boolean

Ob dieser Steuercode ein Favorit ist