Bu bölümde, gizlenmiş (suppression) ve aktif olmayan liste kayıtlarının nasıl tespit edileceğini, hangi API'lerin kullanılacağını ve dönen verilerin nasıl yorumlanacağını açıklanmıştır.
Bir ürün listesi gizlenme veya inaktif durumuna geçtiğinde, ürünün Amazon arama sonuçlarında veya ürün sayfasında görüntülenmesi engellenir ya da kısıtlanır. Bu durum satışları doğrudan olumsuz etkilediği için satıcıların bu sorunları hızla tespit edip çözmesi kritik önem taşır.
Önerilen Entegrasyon Mimarisi
- Adım— (Anlık): Notifications API → LISTINGS_ITEM_STATUS_CHANGE & LISTINGS_ITEM_ISSUES_CHANGE
- Adım— (Düzenli): getListingItem API → Günlük/haftalık toplu kontrol
- Adım — Hesap Sağlığı: GET_V2_SELLER_PERFORMANCE_REPORT → Günlük rapor analizi
1. Liste Kaydının Statüsünü Anlık Çekme
Amazon SP-API'nin Notifications API'si, liste kaydı durumundaki değişiklikleri gerçek zamanlı olarak almanızı sağlar. Sürekli ürün durumunu kontrol etmek yerine event-driven bir yaklaşım sunar; böylece bir liste kaydı suppressed durumuna geçtiğinde anında haberdar olabilirsiniz.
| Bildirim Türleri | Açıklaması |
|---|---|
| LISTINGS_ITEM_STATUS_CHANGE | Bir liste kaydının durumu değiştiğinde tetiklenir. Suppressed, active, inactive geçişleri dahil. |
| LISTINGS_ITEM_ISSUES_CHANGE | Bir liste kaydındaki issue'lar değiştiğinde tetiklenir. Yeni sorunlar eklendiğinde veya çözüldüğünde bildirim gelir. |
| ITEM_INVENTORY_EVENT_CHANGE | Stok durumu değişikliklerini bildirir. Stok tükenmesi nedeniyle inactive olan listeleri tespit etmek için kullanılabilir. |
Notification API aboneliği oluşturmak için buradaki adımları takip edebilirsiniz.
2. Liste Kaydı Durumunu Kontrol Etme
Notification üzerinden liste kaydı durumunun değiştiği bildirimini aldıktan sonra [getListingItem ](https://amazon-doc-tr.readme.io/reference/getlistingsitem-2)API üzerinden liste kaydı detaylarını, durumunu ve sorunlarını sorgulayabilirsiniz.
includedDataparametresi içinde "issues" değeri eklendiğinde liste kaydındaki sorunlar response içinde dönecektir.
Issues parametresi detayları yapısı:
{
"issues": [
{
"code": "string", // Issue kodu (sayısal veya alfanümerik)
"severity": "string", // ERROR | WARNING | INFO
"message": "string", // Okunabilir hata mesajı
"attributeNames": ["string"], // Sorunlu attribute'lar
"categories": ["string"], // Issue kategorisi
"enforcements": {
"actions": [
{ "action": "string" } // Uygulanan enforcement action
],
"exemption": {
"status": "string", // Muafiyet durumu
"expiryDate": "string" // Muafiyet bitiş tarihi
}
}
}
]
}
Önem Seviyesi:
ERROR: Kritik sorun. Listing suppressed olabilir veya yakında olacaktır.
WARNING: Önemli ama henüz suppression uygulanmamış sorun. Düzeltilmesi önerilir.
INFO: Bilgilendirme amaçlı. Şu an için bir etkisi yok.
Liste Kaydı Statüleri
| Statü | Açıklaması |
|---|---|
| BUYABLE | Ürün satın alınabilir durumda. |
| DISCOVERABLE | Ürün alışveriş yapanlar tarafından görülebilir ve keşfedilebilir durumda. |
| NOT DISCOVERABLE | Ürün arama sonuçlarında görünmüyor. |
Suppression Türleri
| Durum | Açıklaması |
|---|---|
| SEARCH_SUPPRESSED | Liste kaydı arama sonuçlarında görünmez. |
| LISTING_SUPPRESSED | Liste kaydı satın alınamaz durumda. |
| ATTRIBUTE_SUPPRESSED | Belirli bir attribute (özellik) değeri reddedildi. |
| CATALOG_ITEM_REMOVED | Ürüne ait teklifler kaldırıldı. |
Sorun Kategorileri
| Kategori | Açıklaması |
|---|---|
| INVALID_ATTRIBUTE | Liste kaydındaki bir attribute'un değeri geçersiz. |
| MISSING_ATTRIBUTE | Gerekli bir attribute eksik. |
| INVALID_IMAGE | Ürün görseli geçersiz veya kurallara uygun değil. |
| MISSING_IMAGE | Ürün ana görseli eksik. |
| INVALID_PRICE | Fiyat bilgisi geçersiz veya kurallara uygun değil. |
| MISSING_PRICE | Fiyat bilgisi eksik. |
| DUPLICATE | Liste kaydı potansiyel olarak başka bir ASIN ile eşleşiyor. |
| QUALIFICATION_REQUIRED | Ürünü satmak için onay/yetkilendirme gerekli. |
| POLICY_VIOLATION | Ürün içeriği Amazon politikalarını ihlal ediyor. |
3. Hesap Sağlığı Kontrolü
GET_V2_SELLER_PERFORMANCE_REPORT raporu, Seller Central'daki Account Health dashboard'undan gelen bireysel performans metriklerini içerir.
Gerekli Rol: Selling Partner Insights
Rapor çekme detaylarını incelemek için buraya tıklayın.
Rapor İçeriği ve Yapısı
1. Hesap Durumları
Değerler:
NORMAL - Hesap sağlıklı durumda
AT_RISK - Hesap risk altında, performans iyileştirmesi gerekli
DEACTIVATED - Hesap devre dışı bırakılmış
2. Performans Metrikleri
Değerler:
Geç Gönderim Oranı
Sipariş Kusur Oranı
Fatura Kusur Oranı
Zamanında Teslimat Oranı
Birim Bazında Zamanında Teslimat
Geçerli Takip Oranı
Gönderim Öncesi İptal Oranı
Hesap Sağlık Değerlendirmesi
Politika İhlalleri
{
"listingPolicyViolations": {
"reportingDateRange": {
"reportingDateFrom": "2020-05-24T00:00Z",
"reportingDateTo": "2020-11-19T23:59Z"
},
"defectsCount": 86,
"status": "BAD",
"targetValue": 0,
"targetCondition": "EQUALS"
},
"productAuthenticityCustomerComplaints": {
"reportingDateRange": {
"reportingDateFrom": "2020-05-22T00:00Z",
"reportingDateTo": "2020-11-17T23:59Z"
},
"defectsCount": 212,
"status