A valid request URL is required to generate request examples{
"transferId": "trf-2026-0001",
"sourceStoreId": "store-paris",
"destinationStoreId": "store-lyon",
"lines": [
{
"skuId": "1111111111111111111111111111111111111111111111111111111111111111",
"shippedQuantity": 10,
"receivedQuantity": 9,
"varianceQuantity": -1,
"reason": "short"
}
],
"hasDiscrepancy": true,
"shortQuantity": 1,
"overQuantity": 0
}{
"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
}
}Receive a transfer
Receives a shipped transfer, stamping each line’s received quantity, and returns the computed receipt DISCREPANCY (not the transfer itself). 404s for an unknown transfer/SKU; 422s when the transfer is not shipped.
A valid request URL is required to generate request examples{
"transferId": "trf-2026-0001",
"sourceStoreId": "store-paris",
"destinationStoreId": "store-lyon",
"lines": [
{
"skuId": "1111111111111111111111111111111111111111111111111111111111111111",
"shippedQuantity": 10,
"receivedQuantity": 9,
"varianceQuantity": -1,
"reason": "short"
}
],
"hasDiscrepancy": true,
"shortQuantity": 1,
"overQuantity": 0
}{
"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.
Path Parameters
The transfer (transfert inter-magasin) id.
1Body
The per-SKU quantity actually moved (at least one line).
1Show child attributes
Show child attributes
Response
The receipt discrepancy of the now-received transfer.
The receipt discrepancy of the now-received transfer.
The reconciled transfer's id.
Store the goods left from.
Store the goods arrived at.
Only the lines whose received quantity differs from what was shipped.
Show child attributes
Show child attributes
True when at least one line is short or over.
Total units short across all lines.
0 <= x <= 9007199254740991Total units over across all lines.
0 <= x <= 9007199254740991