Error

A valid request URL is required to generate request examples

{
  "code": "FR-RED",
  "label": "TVA taux réduit (révisé)",
  "rateBps": 550,
  "country": "FR",
  "active": false
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Network

Update a VAT / tax code

Replaces a tax code’s registry fields WHOLESALE — this is not a patch. ALWAYS read the tax code first, apply your change to the object you got back, and send the whole thing. An omitted field does not keep its stored value: code, label and rateBps are required (omitting one is a 400), country clears when omitted and active is OPTIONAL WITH A DEFAULT OF true — so omitting active when updating a deactivated code silently REACTIVATES it. The body’s code is required by validation but IGNORED: the path code is merged in afterwards and wins. 404s for an unknown code — updating never implicitly creates one. PERMISSION TRAP (see solya-pos#950): the route guard accepts pos.settings.manage, but the use-case additionally asserts the kernel config:manage permission.

PUT

tax-codes

{code}

Error

A valid request URL is required to generate request examples

{
  "code": "FR-RED",
  "label": "TVA taux réduit (révisé)",
  "rateBps": 550,
  "country": "FR",
  "active": false
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Path Parameters

code

string

required

Minimum string length: 1

Body

application/json

code

string

required

Minimum string length: 1

label

string

required

Minimum string length: 1

rateBps

integer

required

Required range: 0 <= x <= 10000

country

string

Required string length: 2

active

boolean

default:true

Response

The tax code as it now stands in the registry.

code

string

required

Minimum string length: 1

label

string

required

Minimum string length: 1

rateBps

integer

required

Required range: 0 <= x <= 10000

active

boolean

required

country

string

Required string length: 2

Get a tax code by its code Deactivate (archive) a VAT / tax code

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Update a VAT / tax code

Authorizations

Path Parameters

Body

Response