A valid request URL is required to generate request examples{
"items": [
{
"product": {
"id": "prod-espresso",
"name": "Espresso Blend 1kg",
"brandId": "solya",
"category": "cafe",
"active": true,
"serialTracked": false,
"ageRestricted": false,
"warrantyMonths": 0,
"rentable": false,
"serviceable": false,
"taxonomy": {
"Famille": "Épicerie"
},
"skus": [
{
"skuId": "sku-espresso-1kg",
"skuGroupId": "espresso",
"uom": "piece",
"active": true,
"axes": {
"Format": "1kg"
},
"barcodes": [
"3401579800005"
],
"references": []
}
],
"price": {
"currency": "EUR",
"minNetCents": 10825,
"maxNetCents": 10825
}
},
"units": [
{
"skuId": "2f0a30932a471a86d885382399c476bc17fde6e613c42a73e2cf6a760fe4f774",
"productId": "prod-espresso",
"label": "Espresso Blend 1kg",
"ageRestricted": false,
"currency": "EUR",
"netUnitPrice": 15,
"unitPriceTtc": 18,
"vatRate": 20,
"taxClass": "standard"
}
]
}
],
"total": 21,
"page": 1,
"pageSize": 20,
"pageCount": 2
}{
"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 sellable catalogue (produits + prix de vente TTC)
Returns one page of the catalogue where EVERY row already carries that product’s priced (TTC + VAT per SKU) sellable units — the read a till boots its sale grid from. Same filters (q, category, taxonomy, status), same sort and same page/pageSize (max 100) as the plain product listing; ?store=<id> re-prices every unit through that store’s overrides, exactly as the per-product units operation does.
Prefer this over calling the units operation per product: assembling a catalogue that way costs one request PER PRODUCT, which is what forced a till to stop loading at 2 000 articles. Here the cost is one request per 100 products. A product with no master pricing record is still listed, with an empty units array — it exists, it is simply not priced per SKU yet, so a caller can fall back to the product-level price range rather than concluding the article does not exist.
A valid request URL is required to generate request examples{
"items": [
{
"product": {
"id": "prod-espresso",
"name": "Espresso Blend 1kg",
"brandId": "solya",
"category": "cafe",
"active": true,
"serialTracked": false,
"ageRestricted": false,
"warrantyMonths": 0,
"rentable": false,
"serviceable": false,
"taxonomy": {
"Famille": "Épicerie"
},
"skus": [
{
"skuId": "sku-espresso-1kg",
"skuGroupId": "espresso",
"uom": "piece",
"active": true,
"axes": {
"Format": "1kg"
},
"barcodes": [
"3401579800005"
],
"references": []
}
],
"price": {
"currency": "EUR",
"minNetCents": 10825,
"maxNetCents": 10825
}
},
"units": [
{
"skuId": "2f0a30932a471a86d885382399c476bc17fde6e613c42a73e2cf6a760fe4f774",
"productId": "prod-espresso",
"label": "Espresso Blend 1kg",
"ageRestricted": false,
"currency": "EUR",
"netUnitPrice": 15,
"unitPriceTtc": 18,
"vatRate": 20,
"taxClass": "standard"
}
]
}
],
"total": 21,
"page": 1,
"pageSize": 20,
"pageCount": 2
}{
"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 <= 100Status filter: active (sellable only), inactive (archived only), all (both). Default all.
active, inactive, all Free-text term (recherche): matched case-insensitively over product name, SKU references and barcodes (EAN/code-barres).
1Exact brand (marque) id match, e.g. br-sly — the id served by the brands directory. Filtered server-side, so a brand's catalogue is a total-accurate page rather than a client-side refine of one window.
1Exact category (catégorie) match, e.g. sneakers — the merchandising category slug.
1Taxonomy facet as a JSON object of axis -> value (every pair must match), e.g. {"Famille":"Sneakers"}. Malformed JSON 400s.
1Location capability gate (true / false): keep only the products the merchant has flagged as rentable (true), or only those it has not (false). Filtered server-side over the whole catalogue before the page window, so total counts the rentable articles rather than the whole book. Unconstrained when omitted. A product that predates the flag carries false and is therefore NOT offered for rental — renting an article out is opt-in per product.
true, false After-sales (SAV) capability gate (true / false): the same facet as rentable, for the repair flow. Combines with rentable as AND.
true, false Field to order by: name, brand, or category. Unsorted when omitted.
name, brand, category Sort direction; defaults to asc when sortField is set.
asc, desc Store id to re-price every unit through its overrides; omit for the base price.
Response
A page of products with their priced sellable units and the pagination totals.
A page of products with their priced sellable units and 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