Update VAT rate

Updates an existing VAT rate with a new percentage and/or effective date.

What can be updated:

VAT percentage (0-100)
Effective date (dateFrom)

Validation rules:

VAT percentage must be between 0 and 100
dateFrom must be a valid date
The system validates that the updated dateFrom does not overlap with other VAT rates
If the VAT rate does not exist, a NotFoundException is returned
If validation fails, you will receive an error message explaining the issue

Important notes:

Changes to the effective date affect which invoices/quotes use this rate
Documents already issued keep their original tax rate
The system automatically recalculates which rate applies based on the updated dateFrom

Note: This endpoint requires the WsSettings.manageSettings permission.

PUT/administration/vat-rates/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Request body

requiredapplication/json

dateFromstring<date>required

The effective start date for this VAT rate. This date determines when the rate becomes active. Updating this date changes which invoices and quotes will use this rate. The date must be provided in ISO 8601 format (YYYY-MM-DD). The system validates that the updated date does not overlap with other VAT rate periods.

isDefaultboolean

Whether this VAT rate is the default rate for the workspace. Default rates cannot be deleted and serve as a fallback. If not specified, defaults to false. Only one rate should typically be marked as default, though the system does not enforce this.

default: false

vatnumberrequired

The VAT (Value Added Tax) rate percentage that will be applied to invoices and quotes. This is a number between 0 and 100, where 21 represents 21% tax. Updating this value changes the tax percentage for all future documents that use this rate.

min 0 · max 100

Responses

200

successbooleanrequired

Operation success flag

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X PUT "https://leadtime.app/api/public/administration/vat-rates/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dateFrom": "2024-01-01",
  "isDefault": false,
  "vat": 21
}'

const response = await fetch("https://leadtime.app/api/public/administration/vat-rates/string", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "dateFrom": "2024-01-01",
  "isDefault": false,
  "vat": 21
})
});

import requests

response = requests.put(
    "https://leadtime.app/api/public/administration/vat-rates/string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "dateFrom": "2024-01-01",
  "isDefault": False,
  "vat": 21
},
)

Response

{
  "success": true
}