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 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 olabilirsinizOrderChangeType
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 olORDER_CHANGE
aboneliğinizi bildirin ve silinORDER_STATUS_CHANGE
.
- Arayın
getSubscription
işlem Getirmek içinsubscriptionId
danORDER_STATUS_CHANGE
.- İle
subscriptionId
, kullandeleteSubscriptionById
işlem aboneliği silmek içinORDER_STATUS_CHANGE
bildirim. Unutmayın kideleteSubscriptionById
operasyon bağışsız bir işlemdir.
Adım 1. Abone ol ORDER_CHANGE
bildirim
ORDER_CHANGE
bildirim- Ş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.
-
createSubscription
işlemini çağırın. -
Parametreyi ekle
ORDER_CHANGE
içindenotificationType
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:
BuyerRequestedChange
: Alıcı bir iptal başlattı. Bir MFN siparişini iptal etmek için aşağıdakileri kullanınPOST_ORDER_ACKNOWLEDGEMENT_DATA
besleme.OrderStatusChange
: Sipariş durumu değişti. Değiştirilenleri kontrol edinOrderStatus
. Eğer öyleyseUnshipped
, 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.
Updated 8 months ago