Showroom Prive Order Acknowledgement

Summary of Changes: (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)

Date	Version	Name	Applied changes
	1.0		First Published

The purpose of this page is to describe in details the flow of accepting & rejecting order on MIRAKL.

By default we do accept all orders in Hemi however we have different cases which we need to cover.

We accept all order items with Product In Order > Status ="WAITING_ACCEPTANCE" and Order > Marketplace Status = “WAITING_ACCEPTANCE“ we also need to tack the Orders > Acknowledge status.

If we want to pick an order for acceptance we need to have: Order > Status = “Pending“ Order > Marketplace Status = “WAITING_ACCEPTANCE“ Orders > Is Acknowledge = “Pending” Product In Order > Status ="WAITING_ACCEPTANCE"

If we receive an error during the acceptance we update: Orders > Marketplace Status = “WAITING_ACCEPTANCE Product In Order > Status ="WAITING_ACCEPTANCE" Orders > Is Acknowledge = “Error” Order > Status = “Pending“ and we store the relevant error message in Order Error table

If we successfully accept an order we set: Orders > Is Acknowledge = “Completed”

If we successfully accept an order get modified orders cron should update: Orders > Marketplace Status = “Shipping” Product In Order > Status = "Shipping" Order > Status = “Ready for Shipping“

API Call: PUT /api/orders/{order_id}/accept

API Docs: {{TBA}}

Example Call: (with accept on two order item lines)

{
  "order_lines": [
    {
      "accepted": true,
      "id": "Order_00012-B-1"
    },
    {
      "accepted": true,
      "id": "Order_00012-B-2"
    }
  ]
}

Mapping

Parameter		Integration Notes / Value	Required	Notes
`order_lines`		List of representations of order line for acceptance	Yes
	`accepted`	Boolean indicating if the order line is accepted or refused
‘TRUE' or 'FALSE’	Yes	If Order Item > Rejected Order Item = 0 we send TRUE
If Order Item > Rejected Order Item = 1 we send FALSE
	`id`	string	Yes	The value stored in Product In Order > Order Item Line

Please note we DO accept only order items which are with Order Item > Rejected Order Item = 0 or the status of the order item is NOT “CANCELED“ or “REFUNDED”. This way we have both cases cover we download an order on status “Awaiting Acceptance“ with cancelled order item and if we try to accept it we will receive an error so we need to make sure that only order items with the correct status are accepted. Then if we have order which we do not want to accept all order item our internal teams can set Order Item > Rejected Order Item = 1 and we need to reject the item.

Marketplaces / Showroom Prive Technical Scope / Showroom Prive Order management / Showroom Prive Order Acknowledgement

Showroom Prive Order Acknowledgement