Notifications API, bir satış ortağının iş süreçleriyle ilgili bildirimlere abone olma imkanı sunan Webhook yapısıdır. Notification yapısı, satıcıların iş süreçleriyle ilgili önemli güncellemeleri gerçek zamanlı almasını sağlar ve otomatik bildirim sistemi ile manuel kontrol ihtiyacını ortadan kaldırır. Bu API aracılığıyla:
- Bildirimleri alacağınız bir hedef oluşturabilir,
- Bildirimlere abone olabilir,
- Bildirim aboneliklerini silebilir ve daha fazla işlem yapabilirsiniz.
- Abone olduğunuz bir bildirim; bir olay / event tarafından tetiklendiğinde uygulamanız sorgulamak yerine, bilgileri doğrudan Amazon'dan alabilir.
Terminoloji
- Amazon EventBridge (Amazon Etkinlik Köprüsü): Kendi uygulamalarınızdan, entegre Software-as-a-Service (SaaS) uygulamalarınızdan ve AWS hizmetlerinizden gelen uygulama verilerini bağlayan sunucusuz bir event bus sistemidir. Daha fazla bilgi için bknz. Amazon EventBridge
- Amazon Simple Queue Service (Amazon SQS - Amazon Basit Kuyruk Hizmeti): Tam olarak yönetilebilen bir ileti, bildirim kuyruğu hizmeti. Daha fazla bilgi için bknz. Amazon SQS
- Partner event source (İş Ortağı İleti Kaynağı): AWS iş ortağı tarafından AWS müşteri hesabına ileti, bildirim göndermek için kullanılır. Bu iletileri almak için müşterinin bir event bus sistemini iş ortağı ileti kaynağıyla ilişkilendirmesi gerekir. Daha fazla bilgi için bknz.
- Event Bus: İletileri bir kaynaktan alır ve ilişkili kurallara göre hedef kaynaklara yönlendirir. Daha fazla bilgi için bknz. Amazon Event Bus
Bildirim İş Akışları
Bildirim almak için iki ayrı iş akışı vardır. Kullandığınız iş akışı, almak istediğiniz bildirim türüne bağlıdır.
- Amazon EventBridge İş Akışı
- Aşağıdaki bildirim tiplerine abone olmak için yukarıdaki EventBridge iş akışı kullanılmalıdır.
- BRANDED_ITEM_CONTENT_CHANGE: Satış ortağının marka ilişkisi bulunan herhangi bir ASIN'in başlığında, açıklamasında, temel özellikler veya görsellerinde değişiklik olduğunda gönderilir.
- ITEM_PRODUCT_TYPE_CHANGE: Satış ortağının marka ilişkisi bulunan herhangi bir ASIN'in ürün tipi adında değişiklik olduğunda gönderilir.
- LISTINGS_ITEM_ISSUES_CHANGE: Satış ortağının sahip olduğu herhangi bir SKU için sorun değişikliği olduğunda gönderilir.
- LISTINGS_ITEM_MFN_QUANTITY_CHANGE: Bir listeleme öğesinin mevcut miktarında değişiklik olduğunda gönderilir.
- PRODUCT_TYPE_DEFINITIONS_CHANGE: Yeni bir Ürün Tipi veya Ürün Tipi Versiyonu olduğunda gönderilir.
Event Bridge Kurulumu için bknz.
- Amazon Simple Queue Service İş Akışı
Aşağıdaki bildirim türlerini almak için Amazon SQS iş akışını kullanın:
- ACCOUNT_STATUS_CHANGED: Geliştiricilerin aboneliği olan satış ortağı/pazaryeri için hesap durumu değiştiğinde gönderilir. Satış ortağının hesap durumu NORMAL, RİSKLİ ve DEAKTİF durumları arasında değiştiğinde bir bildirim yayınlanır.
- ANY_OFFER_CHANGED: Satıcının listelediği bir ürün için ilk 20 teklifin herhangi biri, ürünün durumda veya dış fiyatta değişiklik olduğunda gönderilir.
- B2B_ANY_OFFER_CHANGED: Satıcının listelediği bir ürün için ilk 20 B2B teklifinde, herhangi bir fiyat değişikliği olduğunda gönderilir.
- DETAIL_PAGE_TRAFFIC_EVENT: Her saatin başında gönderilir. Bu bildirim, ASIN seviyesinde trafik verilerini paylaşır ve önceki saatin verilerinin yanı sıra 24 saat öncesine kadar olan gecikmeli verileri içerir. Her bildirim birden fazla ASIN içerebilir ve bir satış ortağı her saat birden fazla bildirim alabilir.
- FBA_INVENTORY_AVAILABILITY_CHANGES: Amazon Tarafından Fulfillment (FBA) envanter miktarlarında değişiklik olduğunda gönderilir. Bu bildirim, belirli bir bölgedeki tüm uygun pazaryerlerindeki FBA envanterinin anlık görüntüsünü içerir.
- FBA_OUTBOUND_SHIPMENT_STATUS: Bir satıcı için Amazon Tarafından Fulfillment sevkiyatı oluşturduğumuzda veya iptal ettiğimizde gönderilir.
- FEE_PROMOTION: Bir promosyon aktif hale geldiğinde gönderilir.
- FEED_PROCESSING_FINISHED: Selling Partner API for Feeds kullanılarak gönderilen herhangi bir feed'in işlem durumu TAMAMLANDI, İPTAL EDİLDİ veya KRİTİK HATA durumuna ulaştığında gönderilir.
- FULFILLMENT_ORDER_STATUS: Çok Kanallı Fulfillment (MFN) siparişinin durumunda değişiklik olduğunda gönderilir.
- ITEM_INVENTORY_EVENT_CHANGE: Her saatin başında gönderilir. Bu bildirim, ASIN seviyesinde envanter verilerini paylaşır ve önceki saatin verilerinin yanı sıra 24 saat öncesine kadar olan gecikmeli verileri içerir. Her bildirim birden fazla ASIN içerebilir ve bir satış ortağı her saat birden fazla bildirim alabilir.
- ITEM_SALES_EVENT_CHANGE: Her saatin başında gönderilir. Bu bildirim, ASIN seviyesinde satış verilerini paylaşır ve önceki saatin verilerinin yanı sıra 24 saat öncesine kadar olan gecikmeli verileri içerir. Her bildirim birden fazla ASIN içerebilir ve bir satış ortağı her saat birden fazla bildirim alabilir.
- ORDER_CHANGE: Siparişte önemli bir değişiklik olduğunda gönderilir. Önemli değişiklikler arasında sipariş durumu değişiklikleri ve alıcı tarafından talep edilen iptaller yer alır. marketplaceIds'in ORDER_CHANGE için desteklenen bir filtre olmadığını unutmayın. marketplaceIds'i dahil etmek istiyorsanız, ANY_OFFER_CHANGED kullanmalısınız.
- PRICING_HEALTH: Bir satıcı teklifinin rekabetçi olmayan bir fiyat nedeniyle Öne Çıkan Teklif olmaya uygun olmadığında gönderilir.
- REPORT_PROCESSING_FINISHED: Selling Partner API for Reports kullanılarak talep ettiğiniz herhangi bir raporun işlem durumu TAMAMLANDI, İPTAL EDİLDİ veya KRİTİK HATA durumuna ulaştığında gönderilir.
- TRANSACTION_UPDATE: Satıcının hesabına yeni bir işlem kaydedildiğinde gönderilir.