Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Eğitim: ORDER_CHANGE Bildirimine abone olun

ORDER_CHANGE bildirimine abone olmak için iş akışı

Bu eğitim, nasıl kullanılacağını kapsar ORDER_CHANGE sipariş kullanılabilirliği durumunda bir değişiklik olduğunda gönderilen bildirim. Bu bildirime abone olmak, sipariş işleme iş yükünüzü azaltmanıza ve Amazon Satış Ortağı API'si ile entegrasyonunuzun performansını artırmanıza yardımcı olur.

Faydaları ORDER_CHANGE bildirim

ORDER_CHANGE bildirim aşağıdaki avantajları sunar:

  • Sonraki iş akışlarınızı otomatikleştirmek için yeterli bilgi: Artık kullanabilirsiniz ORDER_CHANGE siparişler hakkında bilgi almak için yük. Bildirim, bir alıcının iptal talebinde bulunması durumunda sizi bilgilendirmek için de tasarlanmıştır..
  • Gerektiğinde bilgilendirilecek etkinlikler: Artık sunucu kapasitesinden tasarruf ederek Siparişler API'sini sorgulamaya devam etmeniz gerekmeyecek.
  • Sipariş düzeyinde konsolide yük: Siparişte birden fazla sipariş öğeniz varsa, sipariş düzeyinde konsolide yük alırsınız. Sipariş düzeyinde tetikleme, daha verimli bir entegrasyon iş akışı oluşturmanıza olanak tanır.
  • Etkinlik filtreleri filtrelenmiş aboneliklere izin verir: Olay filtreleri artık aşağıdakilerle destekleniyor ORDER_CHANGE bildirim. Etkinlik filtreleri ile ilgili bir abonelikle abone olabilirsiniz OrderChangeType işletmenizle ilgili sipariş bildirimlerini filtrelemek için. Şu anda alıcı tarafından talep edilen iptal ve sipariş durumu değişikliğini destekliyoruz.
  • Gelecekteki kullanım durumları için genişletilebilir olay filtreleri: Bu yeni bildirim, Amazon'un gelecekte belirli Easy Ship etkinlikleri veya kaldırım kenarı teslim alma etkinlikleri gibi siparişlerle ilgili ek etkinlikler eklemesine olanak tanır.
  • Gerçek zamanlı olay değişiklikleri sağlamak için değiştirme zamanı eklendi: ORDER_CHANGE bildirim, yük içinde bir alan olarak sipariş değişikliği zamanına sahiptir. Bunu entegrasyonunuza uygulamak, satıcılarınız için gerçek zamanlı güncellemeler sağlamanıza olanak tanır.

Eğitim

Aşağıdaki eğitim, abone olmanıza ve kullanmanıza yardımcı olacaktır. ORDER_CHANGE bildirim.

Ön koşullar

Abone olmadan önce ORDER_CHANGE bildirim, geliştirici profiliniz ve uygulamanızda şunlara sahip olmalıdır Envanter ve Sipariş Takibi rolü veya Amazon Gönderim rolü atanmış.

🚧

Önemli:

Bu bildirimin önceki sürümü, ORDER_STATUS_CHANGE, kullanımdan kaldırıldı. Abone ol ORDER_CHANGE aboneliğinizi bildirin ve silin ORDER_STATUS_CHANGE.

  1. Arayın getSubscription işlem Getirmek için subscriptionId dan ORDER_STATUS_CHANGE.
  2. İle subscriptionId, kullan deleteSubscriptionById işlem aboneliği silmek için ORDER_STATUS_CHANGE bildirim. Unutmayın ki deleteSubscriptionById operasyon bağışsız bir işlemdir.

Adım 1. Abone ol ORDER_CHANGE bildirim

  1. Şuna bir abonelik oluşturun ORDER_CHANGE işleme yönergelerini kullanarak.

processingDirective bildirimlerin işlenmesini kontrol etmek için aboneliğe ek bilgi iletmek için kullanılır. Örneğin, kullanabilirsiniz eventFilter Belirli bir Sipariş Değişikliği Türü için bildirimleri filtrelemek için.

Kullanmak için eventFilter için ORDER_CHANGE bildirimler, eklediğinizden emin olun eventFilterType ve orderChangeTypes abonelik oluştur adımında.

  1. createSubscription işlemini çağırın.

  2. Parametreyi ekle ORDER_CHANGE içinde notificationType yol değişkeni.

Aşağıdaki yük, yalnızca sipariş durumu değişiklikleriyle ilgili bildirimleri alacak şekilde bir filtrenin nasıl ayarlanacağını gösterir. Kendinizi eklediğinizden emin olun destinationId:

POST https://sellingpartnerapi-na.amazon.com/notifications/v1/subscriptions/ORDER_CHANGE { "payloadVersion": "1.0", "destinationId": "e22gf420-1606-47c4-a393-91df6648d3da", "processingDirective": { "eventFilter": { "orderChangeTypes": [ "OrderStatusChange" ], "eventFilterType": "ORDER_CHANGE" } } }

Talep başarılı olursa, şu yanıtı alacaksınız:

{ "payload": { "subscriptionId": "92d519e4-f208-493b-9092-d70cf546c383", "destinationId": "e22gf420-1606-47c4-a393-91df6648d3da", "payloadVersion": "1.0", "processingDirective": { "eventFilter": { "orderChangeTypes": [ "OrderStatusChange" ], "eventFilterType": "ORDER_CHANGE" } } } }

Eğer almak istiyorsan BuyerRequestedChange bilgi, eklemelisiniz BuyerRequestedChange içinde orderChangeTypes İlgili bildirimleri filtrelemek için. Tüm sipariş değişikliği türlerinden sipariş bildirimleri almak için şunları ekleyin eventFilterType bu bildirime abone olurken ayarlanır.

Örnek yük:

{ "destinationId": "e22gf420-1606-47c4-a393-91df6648d3da", "payloadVersion": "1.0", "processingDirective": { "eventFilter": { "eventFilterType": "ORDER_CHANGE" } } }

Adım 2. Bildirim mesajları alma

Bildirim doğru ayarlandıktan sonra, tüm sipariş durumu değişiklikleri için Amazon Basit Kuyruk Hizmeti (Amazon SQS) kuyruğunuzda mesajlar alırsınız.

Aşağıdakiler bir örneğidir ORDER_CHANGE bildirim:

{ "NotificationVersion" : "1.0", "NotificationType" : "ORDER_CHANGE", "PayloadVersion" : "1.0", "EventTime" : "2023-10-03T01:35:06.382Z", "Payload" : { "OrderChangeNotification" : { "NotificationLevel" : "OrderLevel", "SellerId" : "ABCDEFGFMDKELDW", "AmazonOrderId" : "123-4567891-4567891", "OrderChangeType" : "OrderStatusChange", "OrderChangeTrigger" : { "TimeOfOrderChange" : "2023-10-03T01:35:01.000Z", "ChangeReason" : "Order Status Change" }, "Summary" : { "MarketplaceId" : "A2Q3Y263D00KWC", "OrderStatus" : "Unshipped", "PurchaseDate" : "2023-10-03T01:03:44.106Z", "DestinationPostalCode" : null, "FulfillmentType" : "MFN", "OrderType" : "StandardOrder", "OrderPrograms" : [ ], "ShippingPrograms" : [ ], "OrderItems" : [ { "OrderItemId" : "12345207241", "SellerSKU" : "SKU123", "SupplySourceId" : null, "Quantity" : 15 } ] } } }, "NotificationMetadata" : { "ApplicationId" : "amzn1.sp.solution.c4d.......", "SubscriptionId" : "52ac10........", "PublishTime" : "2023-10-03T01:35:07.931Z", "NotificationId" : "e9b0f384........" } }

Bir bildirim aldığınızda, değerini kontrol edin OrderChangeTypes bildirim yükünde:

  1. BuyerRequestedChange: Alıcı bir iptal başlattı. Bir MFN siparişini iptal etmek için aşağıdakileri kullanın POST_ORDER_ACKNOWLEDGEMENT_DATA besleme.
  2. OrderStatusChange: Sipariş durumu değişti. Değiştirilenleri kontrol edin OrderStatus. Eğer öyleyse Unshipped, artık alıcılar tarafından satın alınan ürünleri yerine getirmek için siparişinizi hazırlamaya başlayabilirsiniz. Bu zamana duyarlı bir görevdir; gerçek zamanlı olarak bilgilendirilmek, siparişleri zamanında yerine getirmenize yardımcı olur. Ürünü müşteriye gönderdikten sonra, gönderiyi Amazon'a onaylamanız ve alıcıya ürünün teslimata hazır olduğunu bildirmeniz de beklenir. Bakınız SP-API kullanarak MFN Siparişleri nasıl onaylanır? Satış Ortağı API'lerini kullanarak MFN siparişlerini onaylama hakkında daha fazla bilgi için.

Yük yükü ORDER_CHANGE bildirim şimdi sağlar OrderItems ilgili siparişten. Kullandığınızda OrderItems bilgi, artık aramanıza gerek yok getOrderItems Bir sırayla hangi öğelerin olduğunu bilmek için işlem.

Sonuç

Bu eğitim, nasıl abone olunacağını ve kullanılacağını kapsıyordu. ORDER_CHANGE bildirim, sipariş işleme iş yükünüzü azaltmanıza ve Amazon Satış Ortağı API'si ile entegrasyonunuzun performansını artırmanıza yardımcı olur.


Bu sayfa size yardımcı oldu mu?