Error
A valid request URL is required to generate request examples{
"id": "po-1001",
"supplierId": "nike-fr",
"shopId": "store-rivoli",
"status": "received",
"lines": [
{
"skuId": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"orderedQuantity": 24,
"receivedQuantity": 24,
"unitCostCents": 4500
}
]
}{
"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
}
}Procurement
Receive against a purchase order (réception de marchandise)
Books a batch of receipts (réception de marchandise / bon de livraison) against an OPEN order, accumulating each line’s received quantity and re-deriving the order status (received once every line is fully received). Re-runs the receiving guard server-side. 404s for an unknown order or receipt SKU; 422s when the order is already fully received.
POST
/
v1
/
purchase-orders
/
{orderId}
/
receive
Error
A valid request URL is required to generate request examples{
"id": "po-1001",
"supplierId": "nike-fr",
"shopId": "store-rivoli",
"status": "received",
"lines": [
{
"skuId": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"orderedQuantity": 24,
"receivedQuantity": 24,
"unitCostCents": 4500
}
]
}{
"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 purchase order (bon de commande) id.
Minimum string length:
1Body
application/json
The receipts booked in this delivery (bon de livraison); at least one.
Minimum array length:
1Show child attributes
Show child attributes
Response
The order with accumulated receipts and re-derived status.