Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

FulfillmentOrderStatusNotification

The FulfillmentOrderStatus notification is sent whenever there is a change in the status of a Multi-Channel Fulfillment fulfillment order. See FulfillmentOrderStatus for the events that can trigger a status change.

Availability

This notification is available in all marketplaces.

Elements

This is the root element of the FulfillmentOrderStatusNotification.xsd schema:

Name Description
FulfillmentOrderStatusNotification The root element of the payload for the notification that is sent when there is a status change for a fulfillment order, fulfillment shipment, or fulfillment return.

These are the complex elements of the FulfillmentOrderStatus element:

Name Description
FulfillmentReturnItem Information about an item that was returned to an Amazon fulfillment center.
FulfillmentShipment Delivery and item information for a shipment in a fulfillment order.
FulfillmentShipmentPackage Package information for a shipment in a fulfillment order.

FulfillmentOrderStatusNotification

The root element of the payload for the notification that is sent when there is a status change for a fulfillment order, fulfillment shipment, or fulfillment return.

FulfillmentOrderStatusNotification Elements

The following table shows the child elements of the FulfillmentOrderStatusNotification element:

Name Description
EventType Indicates whether the notification contains order, shipment, or return information.

EventType values:

  • Order - This notification contains information about a fulfillment order.
  • Shipment - This notification contains information about a fulfillment shipment. For more information, see the FulfillmentShipment element.
  • Return - This notification contains information about a fulfillment return. For more information, see the FulfillmentReturnItem element.

Required

Type: xs:string

StatusUpdatedDateTime The date and time when the status was last updated. In ISO 8601 format.

Required

Type: xs:dateTime

SellerFulfillmentOrderId The fulfillment order identifier that you created and submitted using the CreateFulfillmentOrder operation.

Required

Type: xs:string

FulfillmentOrderStatus The current status of the fulfillment order.

FulfillmentOrderStatus values:

  • Received - The fulfillment order was received by Amazon MWS and validated. Validation includes determining that the destination address is valid and that Amazon's records indicate that the seller has enough sellable (undamaged) inventory to fulfill the order. The seller can cancel a fulfillment order that has a status of Received.
  • Invalid - The fulfillment order was received by Amazon MWS but could not be validated. The reasons for this include an invalid destination address or Amazon's records indicating that the seller does not have enough sellable inventory to fulfill the order. When this happens, the fulfillment order is invalid and no items in the order will ship.
  • Planning - The fulfillment order has been sent to Amazon's fulfillment network to begin shipment planning, but no unit in any shipment has been picked from inventory yet. The seller can cancel a fulfillment order that has a status of Planning.
  • Processing - The process of picking units from inventory has begun on at least one shipment in the fulfillment order. The seller cannot cancel a fulfillment order that has a status of Processing.
  • Cancelled - The fulfillment order has been cancelled by the seller.
  • Complete - All item quantities in the fulfillment order have been fulfilled.
  • CompletePartialled - Some item quantities in the fulfillment order were fulfilled; the rest were either cancelled or unfulfillable.
  • Unfulfillable - No item quantities in the fulfillment order could be fulfilled because the Amazon fulfillment center workers found no inventory for those items or found no inventory that was in sellable (undamaged) condition.

Required

Type: xs:string

FulfillmentShipment Delivery and item information for a shipment in a fulfillment order.

Optional. Returned only when EventType is Shipment.

Type: FulfillmentShipment

FulfillmentReturnItem Information about an item that was returned to an Amazon fulfillment center.

Optional. Returned only when EventType is Return.

Type: FulfillmentReturnItem

FulfillmentReturnItem

Information about an item that was returned to an Amazon fulfillment center.

FulfillmentReturnItem Elements

The following table shows the child elements of the FulfillmentReturnItem element:

Name Description
ReceivedDateTime The date and time when the returned item was received by the Amazon fulfillment center. In ISO 8601 date time format.

Required

Type: xs:dateTime

ReturnedQuantity The quantity that was returned.

Required

Type: xs:int

SellerSKU The seller SKU of the item.

Required

Type: xs:string

FulfillmentShipment

Delivery and item information for a shipment in a fulfillment order.

FulfillmentShipment Elements

The FulfillmentShipment element contains a subset of the information contained in the FulfillmentShipment datatype of the Fulfillment Outbound Shipment API section.

The following table shows the child elements of the FulfillmentShipment element:

Name Description
FulfillmentShipmentStatus The current status of the shipment.

FulfillmentShipmentStatus values:

  • Pending - The process of picking units from inventory has begun.
  • Shipped - All packages in the shipment have left the fulfillment center.
  • CancelledByFulfiller - The Amazon fulfillment center could not fulfill the shipment as planned. This might be because the inventory was not at the expected location in the fulfillment center. After cancelling the fulfillment order, Amazon immediately creates a new fulfillment shipment and again attempts to fulfill the order.
  • CancelledBySeller - The shipment was cancelled using the CancelFulfillmentOrder operation.

Required

Type: xs:string

AmazonShipmentId A shipment identifier assigned by Amazon.

Required

Type: xs:string

EstimatedArrivalDateTime The estimated arrival time of the shipment, in ISO 8601 date time format. Note that this value can change over time. If a shipment includes more than one package, EstimatedArrivalDateTime applies to all of the packages in the shipment. If the shipment has been cancelled, EstimatedArrivalDateTime is not returned.

Required

Type: xs:dateTime

FulfillmentShipmentPackageList Contains all the packages in the fulfillment shipment.

Optional

Type: List of FulfillmentShipmentPackage

FulfillmentShipmentPackage

Package information for a shipment in a fulfillment order.

FulfillmentShipmentPackage Elements

The FulfillmentShipmentPackage element contains a subset of the information contained in the FulfillmentShipmentPackage datatype of the Fulfillment Outbound Shipment API section.

The following table shows the child elements of the FulfillmentShipmentPackage element:

Name Description
PackageNumber Identifies a package within a shipment.

Required

Type: xs:int

CarrierCode Identifies the carrier that will deliver the package.

Required

Type: xs:string

TrackingNumber The tracking number used to obtain tracking and delivery information.

Required

Type: xs:string