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.
Defines the basic structure of the notification. Each Notification element contains a notification (in the NotificationPayload child element) and information about the notification (in the NotificationMetaData child element).
The contents of the NotificationPayload child element will vary depending on which notification you have subscribed to. Each notification is described by its own XSD.
This notification is available in all marketplaces.
This is the root element of the MWSPushNotification.xsd schema:
| Name | Description |
|---|---|
| Notification | The root element of all notifications. |
These are the complex elements of the MWSPushNotification element:
| Name | Description |
|---|---|
| NotificationMetaData | The metadata for the notification. |
| NotificationPayload | The notification that is being delivered. |
The root element of all notifications.
The following table shows the child elements of the Notification element:
| Name | Description |
|---|---|
| NotificationMetaData |
The metadata for the
notification.
Required. Type: NotificationMetaData |
| NotificationPayload |
The notification that is being
delivered.
Required. Type: NotificationPayload |
The metadata for the notification.
The following table shows the child elements of the NotificationMetaData element:
| Name | Description |
|---|---|
| NotificationType | Identifies the type of notification that is contained in the
NotificationPayload
element. NotificationType values:
Required. Type: xs:string |
| PayloadVersion | The version of the notification that is contained in the
NotificationPayload element. Required. Type: VersionType |
| UniqueId | The unique identifier for this notification. Required. Type: xs:string |
| PublishTime | The date and time that the notification was published. In ISO 8601 date time format. Required. Type: xs:dateTime |
| SellerId | The identifier of the seller that is receiving the
notification. Required. Type: xs:string |
| MarketplaceId | The identifier of the marketplace to which the notification
pertains. Optional. Not present for events that are cross-marketplace or not marketplace-specific. Type: MarketplaceType |
The notification that is being delivered.
The following table shows the child elements of the NotificationPayload element:
| Name | Description |
|---|---|
| AnyOfferChangedNotification |
The AnyOfferChanged notification is sent whenever there is a listing change for any of the top 20 offers, by condition (new or used), or if the external price (the price from other retailers) changes for an item that you sell. The top 20 offers are determined by the landed price, which is the price plus shipping minus Amazon Points. If multiple sellers are charging the same landed price, the results will be returned in random order. You will only receive AnyOfferChanged notifications for items for which you have active offers. You cannot subscribe to notifications for items for which you do not have active offers. Only one of the elements in this table is returned. |
| FBAOutboundShipmentStatusNotification |
The FBAOutboundShipmentStatus notification is sent whenever Amazon creates or cancels a Fulfillment by Amazon shipment for a seller. Only one of the elements in this table is returned. |
| 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. Only one of the elements in this table is returned. |
| TestNotification |
Describes the contents of the
NotificationPayload element for
a test notification sent by using the
SendTestNotificationToDestination
operation.
Only one of the elements in this table is returned. Type: TestNotification |