Create a custom tax code

Creates a tenant-specific tax code. Referenced tax accounts must exist in the chart of accounts and be active.

POST /v1/tax-codes

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token.

Request Body

code string required Tenant-wide unique code, max 20 characters, alphanumeric plus -

label string required Display name of the tax code, max 120 characters

description string | null optional Optional description of when to use this tax code (max 500 characters)

rate number required Tax rate in percent

vat_account string required Input/output VAT account in the tenant-specific chart of accounts

self_assess_account string | null optional Optional offsetting account for self-assessment / reverse charge

Responses

201

Success

400

INVALID_INPUT Required fields are missing or values do not match the expected format.

400

ACCOUNT_NOT_FOUND The specified expense or revenue account does not exist in the chart of accounts.

400

ACCOUNT_INACTIVE

409

DUPLICATE_TAX_CODE

POST /v1/tax-codes

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/tax-codes' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "code": "RC19",
  "label": "Reverse Charge 19%",
  "description": "Reverse Charge §13b UStG 19% für EU-Dienstleistungen",
  "rate": 19,
  "vat_account": "1406",
  "self_assess_account": "3804"
}'

201 Response

JSON

{
  "code": "<string>",
  "label": "<string>",
  "description": "<string>",
  "rate": 1,
  "vat_account": "<string>",
  "self_assess_account": "<string>",
  "is_system": true,
  "is_active": true
}