BestBuy 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)

All validations, triggers and standardizations which are are as per

Order General Acknowledgement

Order management general requirements

Orders Acknowledgement

With the introduction of the new Order Acknowledgement model we want to incorporate it within the Amazon Vendor integration. Thus in Account Amazon we want to introduce a new field which will indicate if we want to automatically accept the whole order or manually accept it.

The main trigger for the order acknowledgement will be Order Acknowledgement > Status = Pending and Order > Status = “Awaiting Acknowledge” however based on the flow we will have:

#1 Automatic Acceptance We acknowledge all order items as Accepted and with the actual order download we will add the Order Acknowledgement details.

#2 Manual Acceptance When we have manual acceptance the trigger will be the actual user when from the Acknowledgment modal create the Order Acknowledgement .

Please keep in mind if we have bundle skus we want to acknowledge only the bundle SKU not the components.

Once we successfully sent the Acknowledgment and receive the success response we want to update all Acknowledge statuses on the Order, Product In Order and Order Item Lines Order Acknowledgement > Status = Completed if there is an error during the acknowledgment we want to store it in Order Error table This will leave the order with status Order > Status = “Awaiting Acknowledge” with the relevant acknowledge statuses across Order, Product In Order and Order Item Lines Oder Acknowledgement > Status = Completed.

Then we will have to wait for Get Orders to pick the order again and populate all the shipping information and mark the order as Order > Status = “Ready For Shipping”.

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

API Docs: https://help.mirakl.net/help/api-doc/seller/mmp.html#OR21

order_id = Orders > Marketplace Order Id

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

Order Acknowledgement Row Line > Action = Reject then we sent “FALSE” | | | id | string | Yes | Product In Order > Order Item Line | |

Since MIRAKL does not support acceptance on line level we can either accept or reject the whole product. Thus we want to add additional validation if not all line of the product in order are selected to return an error - “Acknowledgment at the line level is not supported”.