v1

latestOpenAPI 3.0.02026-07-2455104.8 MB

Tax

🔒 Create tax

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

Creates a single tax entry.

post/api/v1/tax

Request body

namestring

Tax name

taxTypestring

Tax type

taxRatenumber float

Tax rate

countryCodestring

Country code in ISO 3166-1 alpha-2 format

zipCodestring

ZIP code

isDefaultboolean

Is default tax

isStandardboolean

Is standard tax

defaultRevenueAccountNumberstring

Default revenue account number

defaultDebitTaxAccountNumberstring nullable

Default debit tax account number

defaultCreditTaxAccountNumberstring nullable

Default credit tax account number

defaultCostAccountNumberstring nullable

Default credit tax account number

validFromstring date-time

Valid from date

validUntilstring date-time nullable

Valid until date

Response

Created

idstring

Tax ID

namestring

Tax name

taxTypestring

Tax type

taxRatenumber float

Tax rate

countryCodestring

Country code in ISO 3166-1 alpha-2 format

zipCodestring

ZIP code

isDefaultboolean

Is default tax

isStandardboolean

Is standard tax

defaultRevenueAccountNumberstring

Default revenue account number

defaultDebitTaxAccountNumberstring nullable

Default debit tax account number

defaultCreditTaxAccountNumberstring nullable

Default credit tax account number

defaultCostAccountNumberstring nullable

Default cost account number

validFromstring date-time

Valid from date

validUntilstring date-time nullable

Valid until date

createdAtstring date-time

Created at timestamp

updatedAtstring date-time

Updated at timestamp

Example response

{
  "id": "1",
  "name": "VAT 19%",
  "taxType": "standard",
  "taxRate": 19,
  "countryCode": "DE",
  "zipCode": "",
  "isDefault": true,
  "isStandard": true,
  "defaultRevenueAccountNumber": "8400",
  "defaultDebitTaxAccountNumber": null,
  "defaultCreditTaxAccountNumber": null,
  "defaultCostAccountNumber": null,
  "validFrom": "2022-01-01T00:00:00Z",
  "validUntil": null,
  "createdAt": "2022-01-01T00:00:00Z",
  "updatedAt": "2022-01-01T00:00:00Z"
}