Error
A valid request URL is required to generate request examples{
"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
}
}{
"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
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Catalog
Get a product (produit) by id
Returns the full catalogue read model for one product (produit / article): its merchandising fields, taxonomy, and sellable SKUs with their références and code-barres (EAN). 404s when no product carries the given id.
GET
/
v1
/
products
/
{id}
Error
A valid request URL is required to generate request examples{
"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
}
}{
"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
}
}{
"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.
Path Parameters
The product id (e.g. prod-espresso).
Minimum string length:
1Response
The product read model.
The product read model.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

