Amazon Vendor DF 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 are as per

Order management general requirements

Accept Orders

“The submitAcknowledgement operation allows vendors to accept or reject a purchase order for fulfillment. Amazon expects a complete acknowledgement, including all purchase order line items of the purchase order. If the vendor does not provide all line items of the purchase order in the acknowledgement, Amazon does not accept the partial acknowledgement.

Amazon expects the vendor to submit the acknowledgement as fast as possible, at the latest within 24 hours. The acknowledgement should be an accurate view of the actual shipment quantities and items.”

Below is an example of the codes that may be used in the Amazon acknowledgement. Amazon and the vendor will mutually agree upon a list of codes that will be appropriate for their relationship.

Code & Description

• "00" Shipping 100 percent of ordered product
• "02" Canceled due to missing/invalid SKU
• "03" Canceled out of stock
• "04" Canceled due to duplicate Amazon Ship ID
• "05" Canceled due to missing/invalid Bill To Location Code
• "06" Canceled due to missing/invalid Ship From Location Code
• "07" Canceled due to missing/invalid Customer Ship to Name
• "08" Canceled due to missing/invalid Customer Ship to Address Line 1
• "09" Canceled due to missing/invalid Customer Ship to City
• "10" Canceled due to missing/invalid Customer Ship to State
• "11" Canceled due to missing/invalid Customer Ship to Postal Code
• "12" Canceled due to missing/invalid Customer Ship to Country Code
• "13" Canceled due to missing/invalid Shipping Carrier/Shipping Method
• "20" Canceled due to missing/invalid Unit Price
• "21" Canceled due to missing/invalid Ship to Address Line 2
• "22" Canceled due to missing/invalid Ship to Address Line 3
• "50" Canceled due to Tax Nexus Issue
• "51" Canceled due to Restricted SKU/Qty
• "53" Canceled due to USPS > $400
• "54" Canceled due to Missing AmazonShipID
• "55" Canceled due to Missing AmazonOrderID
• "56" Canceled due to Missing LineItemId
• "71" Canceled due to discontinued item

Since Hemi always accepts the order and we will have to accept 100% of the order the only code we will be using is “00”. This is asynchronous flow so for every acknowledgement we will have to store a feed in Marketplace Feeds table from where we will be checking the response afterwards.

API Call: POST [https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/v1/acknowledgements](https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/v1/acknowledgements)

Docs: https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-orders-api-use-case-guide

Sample Request: POST [https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/v1/acknowledgements](https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/orders/v1/acknowledgements) Boby:

{
  "orderAcknowledgements": [
    {
      "purchaseOrderNumber": "2JK3S9VC",
      "vendorOrderNumber": "ABC",
      "acknowledgementDate": "2020-02-20T19:17:34.304Z",
      "acknowledgementStatus": {
        "code": "00",
        "description": "Shipping 100 percent of ordered product"
      },
      "sellingParty": {
        "partyId": "999US"
      },
      "shipFromParty": {
        "partyId": "ABCD"
      },
      "itemAcknowledgements": [
        {
          "itemSequenceNumber": "00001",
          "buyerProductIdentifier": "B07DFVDRAB",
          "vendorProductIdentifier": "8806098286500",
          "acknowledgedQuantity": {
            "amount": 1,
            "unitOfMeasure": "Each"
          }
        }
      ]
    }
  ]
}

Mapping:

Sample Response:

{

  "transactionId": "20190827182357-8725bde9-c61c-49f9-86ac-46efd82d4da5"

}

Mapping:

Limits: