A valid request URL is required to generate request examples{
"lines": [
{
"skuId": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"orderedQuantity": 24,
"receivedQuantity": 20,
"varianceQuantity": -4,
"unitCostCents": 4500,
"valuedVarianceCents": -18000
}
],
"totalOrderedQuantity": 24,
"totalReceivedQuantity": 20,
"outstandingLineCount": 1,
"overReceivedLineCount": 0,
"totalValuedVarianceCents": -18000,
"shortfallValueCents": -18000,
"overReceiptValueCents": 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
}
}Get a purchase order's received-vs-ordered variance (écart de réception)
Returns the received-vs-ordered variance (écart de réception) of one purchase order: a per-line signed gap valued in integer cents (varianceQuantity = received − ordered; negative is a shortfall still outstanding, positive an over-receipt), plus the outstanding/over-received line counts and the shortfall/over-receipt valued totals. Every ordered line appears (an un-received line reads received = 0). The procurement twin of the transfer receipt-discrepancy report. 404s for an unknown order id.
A valid request URL is required to generate request examples{
"lines": [
{
"skuId": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"orderedQuantity": 24,
"receivedQuantity": 20,
"varianceQuantity": -4,
"unitCostCents": 4500,
"valuedVarianceCents": -18000
}
],
"totalOrderedQuantity": 24,
"totalReceivedQuantity": 20,
"outstandingLineCount": 1,
"overReceivedLineCount": 0,
"totalValuedVarianceCents": -18000,
"shortfallValueCents": -18000,
"overReceiptValueCents": 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
}
}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 purchase order (bon de commande) id.
1Response
The per-line received-vs-ordered variance with the valued shortfall/over-receipt totals.
The per-line received-vs-ordered variance with the valued shortfall/over-receipt totals.
Per-SKU received-vs-ordered variance (every ordered line appears).
Show child attributes
Show child attributes
Total units ordered across lines.
0 <= x <= 9007199254740991Total units received across lines.
0 <= x <= 9007199254740991Lines still short of their ordered quantity (received < ordered).
0 <= x <= 9007199254740991Lines that received strictly more than ordered (received > ordered).
0 <= x <= 9007199254740991Net valued variance across all lines, in cents.
-9007199254740991 <= x <= 9007199254740991Sum of the negative (shortfall) variances, in cents.
-9007199254740991 <= x <= 9007199254740991Sum of the positive (over-receipt) variances, in cents.
-9007199254740991 <= x <= 9007199254740991