Amazon Vendor Procurement 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)

The Vendor have the option to either accept or reject order items before shipping the order. Thus in order to give the Hemi user the flexibility and have full control over the Order Acknowledgement we want to automate the flow and may have different setup based on the user needs and requirements. We will have automatic and manual acceptance. After each order acknowledgement we will store a feed in Hemi which afterwards will need to be read in order to keep track of the acknowledgement status.

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.

This is asynchronous flow so for every acknowledgement we will have to store a feed in Marketplace Feeds table with the relevant objects from where we will be checking the response afterwards.

API Call: POST /vendor/orders/v1/acknowledgements

Docs: https://developer-docs.amazon.com/sp-api/docs/vendor-orders-api-v1-reference#post-vendorordersv1acknowledgements

<v1.1>We want to push only 1 order in a single request.</v1.1> Sample Request: POST [https://sellingpartnerapi-na.amazon.com/vendor/orders/v1/acknowledgements](https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/v1/acknowledgements) Boby:

{
  "acknowledgements": [
    {
      "purchaseOrderNumber": "L8266355",
      "sellingParty": {
        "partyId": "999US"
      },
      "acknowledgementDate": "2019-07-17T19:17:34.304Z",
      "items": [
        {
          "itemSequenceNumber": "1",
          "amazonProductIdentifier": "ABC123434",
          "vendorProductIdentifier": "028877454078",
          "orderedQuantity": {
            "amount": 10,
            "unitOfMeasure": "Cases",
            "unitSize": "5"
          },
          "netCost": {
            "currencyCode": "USD",
            "amount": 10.2
          },
          "itemAcknowledgements": [
            {
              "acknowledgementCode": "Accepted",
              "acknowledgedQuantity": {
                "amount": 10,
                "unitOfMeasure": "Cases",
                "unitSize": "5"
              },
              "scheduledShipDate": "2019-07-17T19:17:34.304Z"
            }
          ]
        }
      ]
    }
  ]
}

Request Mapping: Please note everything with Hemi Field = N/A we exclude from the payload.

``Please note we will have separate nodes for each code | | | | | acknowledgedQuantity | | | | | | | | | | amount | Yes | Order Acknowledgement Row Line > Action | Based on the Order Acknowledgement Row Line > Action we will know hoy many quantity we have either for accept or reject by counting the lines. | | | | | | unitOfMeasure | No | N/A | | | | | | | unitSize | No | N/A | | | | | | scheduledShipDate | | | N/A | |

Sample Response: Status 200

{
    "payload": {
        "transactionId": "fd621aac-8dab-4885-b38e-21143679942e-20250409091213"
    }
}

Response Mapping:

Once we read the response using the Get Transaction Status If we receive success we want to set: Order > Status > Ready For Shipping Then we update the Order Acknowledgment fields as per Order Acknowledgement Functional Details

If we receive error we want to set: Order Acknowledgement > Status = Error Store the relevant error message in Order Error table

Limits: