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

MWSPushNotification

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

Note: If you are using this schema for runtime validation, future additions to the NotificationPayload element will invalidate the existing version of the schema, without prior notice.

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.

Availability

This notification is available in all marketplaces.

Elements

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.

Notification

The root element of all notifications.

Notification Elements

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

NotificationMetaData

The metadata for the notification.

NotificationMetaData Elements

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:
  • AnyOfferChanged
  • FulfillmentOrderStatus
  • TestNotification

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

NotificationPayload

The notification that is being delivered.

NotificationPayload Elements

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.

Type: AnyOfferChangedNotification

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.

Type: FBAOutboundShipmentStatusNotification

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.

Type: FulfillmentOrderStatusNotification

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