サブスクリプションAPIでAnyOfferChangedの購読情報により、出品情報に変動が発生した際にその情報をプッシュする機能をご提供いたしておりました。この度この機能に加えて、新たにFulfillmentOrderStatusの購読情報が追加されました。
サブスクリプションAPIとは？
今までAmazon MWSが提供していたAPIは、その都度リクエストを行い、Amazon MWSからのレスポンスを取得するPULL型のサービスとなっていました。
これに対してサブスクリプションAPIではあらかじめサブスクライブ（購読）設定をすることにより、その購読設定に該当するイベントが発生したときに、その情報をAmazon MWSが通知する、PUSH型のサービスとなります。
FulfillmentOrderStatusの購読情報は何を知らせてくれるのですか？
FulfillmentOrderStatusの購読情報はマルチチャネルサービス(MCF)の注文について、注文、出荷、返品などの状況が変化した際にその変更情報をプッシュするものとなります。
有効値の説明
| 名称 | 説明 |
|---|---|
| EventType | 注文、出荷、返金に関する情報を含みます。 Order: この通知は注文に関する情報が含まれます。 Shipment: この通知は出荷に関する情報が含まれます。詳細情報はFulfillmentShipment要素内に返却されます。 Return: この通知は返品に関する情報が含まれます。詳細情報はFulfillmentReturnItem要素内に返却されます。 |
| FulfillmentOrderStatus | Received:注文を受信し、有効であることが確認されました。有効確認では、送付先の住所が有効であるか、Amazonで保有している情報で、出品者が販売可能な商品の在庫を保有しているか確認します。出品者はReceivedステータスのときは注文をキャンセルすることができます。 Invalid:注文を受信しましたが、有効であることが確認されませんでした。理由としては送付先住所が無効であったり、出荷可能な在庫がないときです。このステータスになると、注文は無効で、出荷は行われません。 Planning:注文は出荷準備のためAmazonフルフィルメントネットワークに送信されましたが、まだ在庫からのピックが完了していない状態です。出品者はPlanningステータス中は注文をキャンセルすることができます。 Processing:注文の中の少なくとも1つの出荷に対して、在庫からのピックのプロセスが始まったことを示します。出品者はProcessingステータスでキャンセルを行うことができません。 Cancelled:注文は出品者によりキャンセルされました。 Complete:注文のすべての商品が出荷されました。 CompletePartialled:注文の一部の商品が出荷されました。残りはキャンセルされたか出荷不可の状態となります。 Unfulfillable:在庫が無かったり、販売可能な(ダメージの無い)商品がないため、すべての商品が出荷できませんでした。 |
例：注文作成時
<Notification>
<NotificationMetaData>
<NotificationType>FulfillmentOrderStatus</NotificationType>
<PayloadVersion>1.0</PayloadVersion>
<UniqueId>74c4e4f4-316a-4013-8aa3-1234abcdefgh</UniqueId>
<PublishTime>2014-08-19T09:11:42.095Z</PublishTime>
<SellerId>ABCDEFGHIJKLMN</SellerId>
<MarketplaceId>A1VC38T7YXB528</MarketplaceId>
</NotificationMetaData>
<NotificationPayload>
<FulfillmentOrderStatusNotification>
<EventType>Order</EventType>
<StatusUpdatedDateTime>2014-08-19T09:11:41.590Z</StatusUpdatedDateTime>
<SellerFulfillmentOrderId>MCF-20140819-0001</SellerFulfillmentOrderId>
<FulfillmentOrderStatus>Received</FulfillmentOrderStatus>
</FulfillmentOrderStatusNotification>
</NotificationPayload>
</Notification>例：出荷準備中
<Notification>
<NotificationMetaData>
<NotificationType>FulfillmentOrderStatus</NotificationType>
<PayloadVersion>1.0</PayloadVersion>
<UniqueId>6adb4e40-b097-4d9e-be42-1234abcdefgh</UniqueId>
<PublishTime>2014-08-19T10:46:58.263Z</PublishTime>
<SellerId>ABCDEFGHIJKLMN</SellerId>
<MarketplaceId>A1VC38T7YXB528</MarketplaceId>
</NotificationMetaData>
<NotificationPayload>
<FulfillmentOrderStatusNotification>
<EventType>Order</EventType>
<StatusUpdatedDateTime>2014-08-19T10:46:57.211Z</StatusUpdatedDateTime>
<SellerFulfillmentOrderId>MCF-20140819-0001</SellerFulfillmentOrderId>
<FulfillmentOrderStatus>Processing</FulfillmentOrderStatus>
</FulfillmentOrderStatusNotification>
</NotificationPayload>
</Notification>例：出荷完了
<Notification>
<NotificationMetaData>
<NotificationType>FulfillmentOrderStatus</NotificationType>
<PayloadVersion>1.0</PayloadVersion>
<UniqueId>770b51e9-e1ff-4ffa-b683-1234abcdefgh</UniqueId>
<PublishTime>2014-08-19T22:38:26.757Z</PublishTime>
<SellerId>ABCDEFGHIJKLMN</SellerId>
<MarketplaceId>A1VC38T7YXB528</MarketplaceId>
</NotificationMetaData>
<NotificationPayload>
<FulfillmentOrderStatusNotification>
<EventType>Shipment</EventType>
<StatusUpdatedDateTime>2014-08-19T22:38:26.085Z</StatusUpdatedDateTime>
<SellerFulfillmentOrderId>MCF-20140819-0001</SellerFulfillmentOrderId>
<FulfillmentOrderStatus>Complete</FulfillmentOrderStatus>
<FulfillmentShipment>
<FulfillmentShipmentStatus>Shipped</FulfillmentShipmentStatus>
<AmazonShipmentId>D4gZh999Z</AmazonShipmentId>
<EstimatedArrivalDateTime>2014-08-20T14:59:59.000Z</EstimatedArrivalDateTime>
<FulfillmentShipmentPackageList>
<FullfillmentShipmentPackage>
<PackageNumber>1</PackageNumber>
<CarrierCode>YAMATO</CarrierCode>
<TrackingNumber>410338899999</TrackingNumber>
</FulfillmentShipmentPackage>
</FulfillmentShipmentPackageList>
</FulfillmentShipment>
</FulfillmentOrderStatusNotification>
</NotificationPayload>
</Notification>これにより、Amazon MWSに常時リクエストを行うことなく、状況変化の情報を効率的にキャッチすることが可能となります。 ぜひご活用ください。
