A valid request URL is required to generate request examples{
"items": [
{
"id": "kit-decouverte",
"name": "Coffret Découverte",
"components": [
{
"skuId": "9e84c6158ec8f6e88e9496bb1c1a115e6c35470f3d5f4f7049b076d926b46b3a",
"quantity": 2
},
{
"skuId": "29438a10df101752d9face3d3846c225846588e57c73472f51b5f8735e5f4541",
"quantity": 1
}
],
"active": true,
"version": 1
}
],
"total": 1,
"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 catalog kits (coffrets, nomenclatures)
Returns ONE PAGE of the kit / coffret catalogue, each row carrying its authoring metadata (name, active, version) and bill of materials. Includes deactivated kits (active: false). Page with page/pageSize (max 100) and keep going until page reaches pageCount: a kit left on an unread page is a coffret the till cannot offer, so never read only the first page when you need the whole catalogue. total counts the kits across ALL pages. Use this to discover a kit id before a resolve/update.
A valid request URL is required to generate request examples{
"items": [
{
"id": "kit-decouverte",
"name": "Coffret Découverte",
"components": [
{
"skuId": "9e84c6158ec8f6e88e9496bb1c1a115e6c35470f3d5f4f7049b076d926b46b3a",
"quantity": 2
},
{
"skuId": "29438a10df101752d9face3d3846c225846588e57c73472f51b5f8735e5f4541",
"quantity": 1
}
],
"active": true,
"version": 1
}
],
"total": 1,
"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 <= 100Response
A page of kits with their authoring metadata and bills of materials.
A page of kits with their authoring metadata and bills of materials.
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