A valid request URL is required to generate request examples{
"items": [
{
"code": "FR-STD",
"label": "TVA taux normal",
"rateBps": 2000,
"country": "FR",
"active": true
}
],
"total": 5,
"page": 1,
"pageSize": 20,
"pageCount": 1
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}List the network's VAT / tax codes
Returns one page of the central VAT / tax-code registry — the governed set of VAT rates a product references (by code) instead of carrying a raw per-product rate. Reach for it to populate a tax-code picker or to resolve the rate a product’s taxCode points at. Each rateBps is the rate in BASIS POINTS of a percentage (20% → 2000, 5.5% → 550), so divide by 100 to render a percentage. Filter with active ("true"/"false") and/or country (ISO alpha-2); sort by code, label or rateBps; page with page/pageSize (max 100) until page reaches pageCount.
A valid request URL is required to generate request examples{
"items": [
{
"code": "FR-STD",
"label": "TVA taux normal",
"rateBps": 2000,
"country": "FR",
"active": true
}
],
"total": 5,
"page": 1,
"pageSize": 20,
"pageCount": 1
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
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.
Query Parameters
1-based page index to return. Defaults to 1.
1 <= x <= 9007199254740991Rows per page, 1..100. Defaults to 20.
1 <= x <= 100true, false 2code, label, rateBps asc, desc Response
A page of tax codes with the pagination totals.
A page of tax codes with the pagination totals.
The rows on this page, in the query's sort order.
Show child attributes
Show child attributes
Total rows matching the filter across ALL pages, not just this one.
0 <= x <= 9007199254740991The 1-based page number served.
0 < x <= 9007199254740991Rows requested per page.
0 < x <= 9007199254740991Total number of pages; stop walking when page reaches it.
0 <= x <= 9007199254740991