A valid request URL is required to generate request examples{
"id": "trf-2026-0001",
"sourceStoreId": "store-paris",
"destinationStoreId": "store-lyon",
"status": "requested",
"lines": [
{
"skuId": "1111111111111111111111111111111111111111111111111111111111111111",
"requestedQuantity": 10,
"shippedQuantity": null,
"receivedQuantity": null
}
]
}{
"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
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Request a transfer
Opens a new inter-store transfer from a source to a DIFFERENT destination store with the requested per-SKU quantities. The transfer starts requested, every line unshipped/unreceived. 409s when the transfer id already exists.
A valid request URL is required to generate request examples{
"id": "trf-2026-0001",
"sourceStoreId": "store-paris",
"destinationStoreId": "store-lyon",
"status": "requested",
"lines": [
{
"skuId": "1111111111111111111111111111111111111111111111111111111111111111",
"requestedQuantity": 10,
"shippedQuantity": null,
"receivedQuantity": null
}
]
}{
"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
}
}{
"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.
Body
Caller-supplied unique transfer id (409 if it already exists).
1Store the goods leave from (magasin source).
1Store the goods are sent to (magasin destination); must differ from the source.
1The per-SKU quantities to move (at least one line).
1Show child attributes
Show child attributes
Response
The requested transfer (status requested).
The requested transfer (status requested).
111requested, shipped, received, cancelled 1Show child attributes
Show child attributes

