Entegrasyon üzerinden ürün listeleme sürecinde karşılaşılan hata kodlarını, nedenlerini ve çözüm adımlarını kapsamlı bir şekilde aşağıda açıklanmıştır.

Hata Kategorileri

Kategori	Açıklama
🏷️ Marka Hataları	Marka yetkisi, kaydı ve güncelleme sorunları
📦 Katalog Hataları	ASIN çakışması, veri uyuşmazlığı, yineleme
🔢 Barkod Hataları	Geçersiz barkod, GS1 uyuşmazlığı
🔒 Kategori Hataları	Kategori izni, ürün türü kısıtlaması
✏️ Doğrulama Hataları	Zorunlu alan, karakter limiti, veri tipi, enum
💰 Fiyat	Min/max değer, maliyet-fiyat ilişkisi
⚙️ Sistem Hataları	Dahili hatalar, SKU-ASIN çakışması

Senkron vs Asenkron Hatalar

Senkron hatalar, API isteği sırasında anında döner ve genellikle yanlış parametre veya eksik özniteliklerle ilgilidir. Asenkron hatalar ise ilk doğrulamayı geçen ancak işleme aşamasında sorun oluşan gönderimler için sonradan bildirilir. Entegratörler her iki hata türünü de yönetmelidir.

Detaylı Hata Kodları Referans Tablosu

Marka Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
5461	Sistemde var olan bir marka için yeni ASIN yaratma yetkisi olmadığında ortaya çıkar. Satıcının ilgili marka altında ürün listeleme hakkı bulunmamaktadır.	Seller Central > Katalog > Ürün Ekle > Boş Form üzerinden başvuru yapılabilir. Ürünün görselleri, marka adı ve üretici bilgileri ile birlikte başvuru oluşturulmalıdır.	Listings Restrictions API ile marka yetkisini ürün gönderimi öncesinde kontrol edin. `getListingsRestrictions` endpoint'i kullanarak kısıtlama bilgisini önceden sorgulayın.
5665	Marka Amazon sisteminde kayıtlı olmadığında ortaya çıkar. Amazon kataloğunda tanımlı olmayan bir marka ile ASIN oluşturulmaya çalışılmaktadır.	Satıcı, marka başvuru formunu doldurmalı ve gerçek ürün fotoğrafları ile başvuru oluşturmalıdır.	Catalog Items API (`searchCatalogItems`) ile markanın kayıtlı olup olmadığını kontrol edin. Product Type Definitions API ile gerekli marka alanlarını önceden doğrulayın.
5885	Başka bir satıcının oluşturduğu jenerik (markasız) ürünün güncellenmesine izin verilmediğinde ortaya çıkar.	Jenerik ürünler üzerinde güncelleme yapılamaz; orijinal sahibi üzerinden değişiklik yapılabilir. Seller Central > Yardım > Destek Talebi yoluyla Amazon'a başvuru yapın.	getCatalogItem API ile mevcut ASIN bilgilerini kontrol edin. Jenerik ürünlerde güncelleme yetkisi olmadığından yeni ASIN oluşturmayı değerlendirin.
5995	Mevcut bir ASIN üzerindeki marka değerini güncelleme yetkisi olmadığında ortaya çıkar. Marka alanı düzenlenemez (non-editable) niteliktedir.	Marka değeri ASIN oluşturulduktan sonra değiştirilemez. Seller Central > Yardım > Destek Talebi yoluyla Amazon'a başvuru yapın	getListingsItem API ile mevcut marka bilgisini ASIN oluşturmadan önce kontrol edin. Katalog verisi ile gönderilecek veri arasında tutarlılık doğrulaması yapın.
4005007	Gönderilen ürünün harici kimliği (UPC/EAN/GTIN), belirtilen marka ile kullanım için kayıtlı değildir. GS1 veritabanında barkod ile marka eşleşmesi sağlanamamıştır.	Doğru UPC/EAN/GTIN değeri kullanıldığından emin olun. Barkod-marka ilişkisini kanıtlayan belge (lisans sözleşmesi vb.) hazırlayın. Destek talebi açarken: Satıcı ID, hata mesajı ekran görüntüsü, marka adı, ürün başlığı, UPC/EAN, marketplace ve GS1 sertifikası paylaşın.	GS1 veritabanında barkod sahipliğini ve marka ilişkisini önceden doğrulayın. UPC: 12, EAN: 13, GTIN: 14 karakter kuralına uygunluk kontrolü yapın.

Katalog Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
8541	Satıcının sağladığı değer Amazon kataloğundaki değerle eşleşmediğinde ortaya çıkar.	Amazon'un mevcut katalog değerini kabul ederek ürünü ekleyin. Mevcut değerleri değiştirmek için Amazon Destek'e case açın.	getListingsItem ve getCatalogItem API'leri ile mevcut katalog verilerini sorgulayın. Gönderilecek veriyi katalog ile karşılaştırma iş akışı oluşturun.
4005011	Gönderilen veri, Amazon kataloğundaki başka bir ürünle (ASIN) çakışmaktadır.	Çakışan ASIN'deki mevcut veriyi inceleyerek düzeltme yapın. Mevcut değerleri değiştirmek için Amazon Destek'e case açın.	getListingsItem ve getCatalogItem API'leri ile mevcut katalog verilerini önceden sorgulayın.
4005013	Gönderilen ürün, hesapta zaten mevcut olan bir ASIN ile eşleşmektedir. Ürünler katalogda çoğaltılamaz.	Orijinal SKU'yu kullanarak ürünü düzenleyin; yeni SKU ile aynı ürün oluşturulamaz.	searchCatalogItems API ile mevcut eşleşmeleri kontrol edin.
4005015	Gönderilen ASIN, katalogdaki mevcut ürünle eşleşmiyor.	Hata mesajındaki önerilen ASIN değerini kullanın. Merchant Suggested ASIN alanına doğru değeri girin.	getCatalogItem API ile ASIN doğrulaması yapın.
4005033	Düzenlenemez (non-editable) bir öznitelik değiştirilmeye çalışılıyor.	Hata mesajındaki orijinal değere geri dönün ve yeniden gönderin. Değer güncellenmesi gerekiyorsa Amazon Destek'e case açın.	getListingsItem ve getCatalogItem API'leri ile mevcut verileri sorgulayın.
4005006	Aynı harici ürün kimliği (UPC/EAN) için katalogda zaten bir ürün mevcut ve bu alan düzenlenemez.	Orijinal harici ürün kimliğini kullanarak düzenlemeye devam edin. Farklı ürün ise farklı harici ID ile gönderin.	getListingsItem ve getCatalogItem API'leri ile mevcut SKU-ASIN eşleşmelerini kontrol edin.
4005038	Mevcut bir SKU'ya farklı bir external_id atanmaya çalışılıyor. Harici ID değiştirilemez.	Orijinal harici ürün kimliğini kullanın. Güncelleme gerekiyorsa Amazon Destek'e başvurun.	Mevcut katalog verilerini API ile sorgulayarak doğru harici ID kullanın.
4005039	Bu ürün için birden fazla gönderim bulunmaktadır. Katalogda çoklu katkı kaydı oluşmuştur.	Developer Support üzerinden destek talebi açın.	Gönderim durumlarını düzenli takip edin, çift gönderim kontrolü yapın.

Barkod Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
8560	Sağlanan barkodlar geçersiz olduğunda ortaya çıkar. Barkod formatı veya değeri kabul edilmemektedir.	Belirtilen kategori ve marka için barkod muafiyeti sağlanarak ürünler barkodsuz oluşturulabilir. Seller Central > Katalog > Ürün Ekle yoluyla barkod muafiyeti başvurusu yapın.	Barkod format doğrulaması yapın: UPC=12, EAN-13=13, EAN-8=8, GTIN=14 karakter.
8572 / 8566	GS1 veritabanındaki barkod sahibi bilgisi, girilen marka değeriyle eşleşmediğinde ortaya çıkar.	Onay almak için Amazon Destek'e case açın.	GS1 veritabanında barkod sahiplik bilgisini önceden doğrulayın. Barkod-marka eşleşme kontrolünü otomatize edin.
4005008	Harici ürün kimliği (UPC/EAN/GTIN), GS1'de kayıtlı değil veya kısıtlanmış durumdadır.	UPC/EAN/GTIN değerinin doğruluğunu kontrol edin. Sahiplik belgesi varsa GS1 sertifikasını Amazon'a sunun.	UPC/EAN/GTIN değerlerini GS1 veritabanında doğrulayın.
90188	Harici ürün kimliği, ISBN/UCCID gereksinimleri karşılamıyor.	Karakter sayısını kontrol edin: UPC=12, EAN=13, GTIN=14.	Sistemde barkod formatı ve checksum otomatik doğrulama kontrolü ekleyin.

Kategori Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
6024	Ürünün Amazon'da satışı ürün türü izni nedeniyle kısıtlandığında meydana gelir. Satıcı hesabında bu ürün türündeki ürünleri satma yetkisi yoktur.	Ek onay gerektiren marka veya kategori için Seller Central üzerinden onay alınmalıdır. Seller Central > Katalog > Satmak İçin Başvur butonunu kullanarak başvurun.	Listings Restrictions API (`getListingsRestrictions`) ile ürün türü kısıtlamalarını önceden sorgulayın. Ürün gönderimi öncesinde yetki kontrolü iş akışı oluşturun.
4000003	Belirtilen Amazon Product Type geçersiz veya desteklenmiyor. Yanlış ürün türü seçilmiş ya da aktif değil.	Product Type Definitions API'nin searchDefinitionsProductTypes işlemi ile ürün türünün geçerli olduğunu doğrulayın.	searchDefinitionsProductTypes API ile geçerli ürün türlerini düzenli güncelleyin.

Doğrulama Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
90220	Zorunlu bir öznitelik sağlanmamıştır.	Hata mesajında belirtilen zorunlu özniteliği ekleyerek yeniden gönderin. Product Type Definitions API ile zorunlu alanları belirleyin.	Product Type Definitions API ile zorunlu alanları tespit edin. Notifications API (PRODUCT_TYPE_DEFINITIONS_CHANGE) ile güncelleme bildirimleri alın.
4000002	Belirtilen öznitelik için zorunlu bir değer eksiktir. Amazon şema güncellemelerinden sonra sıkça karşılaşılır.	Eksik değeri ekleyerek yeniden gönderin. Notifications API ile PRODUCT_TYPE_DEFINITIONS_CHANGE bildirimi alarak güncel kalın.	Product Type Definitions API ile güncel şemaları düzenli çekin. Notifications API aboneliği oluşturun.
4000001	Sağlanan değer geçersizdir. Belirli öznitelikler izin verilen değer listeleriyle sınırlandırılmıştır (Kategori, Alt Kategori, Browse Node vb.).	Product Type Definitions API ile izin verilen değerleri ve koşullu bağımlılıkları doğrulayın. Alt kategorilerin üst kategoriye, browse node'ların alt kategoriye uyumlu olduğundan emin olun.	Product Type Definitions API ile izin verilen değer listelerini sisteminize yansıtın. Koşullu bağımlılık kurallarını doğrulama sürecinize ekleyin.
90225	Öznitelik değeri maksimum uzunluğu aşıyor.	Hata mesajındaki maksimum sınıra uygun şekilde değeri kısaltın.	Sistemde alan bazlı karakter limiti kontrolü ekleyin. Göndermeden önce otomatik uzunluk doğrulaması yapın.
90226	Gönderilen değer, izin verilen minimum uzunluktan kısa.	Değeri düzeltip minimum uzunluğu karşılayacak şekilde yeniden gönderin.	Minimum uzunluk kısıtlamaları olan alanlar için uyarı sistemi kurun.
90244	Gönderilen değer, kabul edilen sabit değerler (enum) listesinde bulunmuyor. Tam eşleşme gereklidir.	Product Type Definitions API'nin en güncel sürümünü çağırarak kabul edilen değerleri doğrulayın. JSON payload'daki Product Type'ın doğruluğunu kontrol edin.	Product Type Definitions API ile izin verilen enum değerlerini sisteminize yansıtın.
90199	Öznitelik değerinde HTML etiketleri bulunuyor. Amazon listeleme alanlarında HTML desteklenmez.	Ürün başlığı, açıklama ve bullet point alanlarındaki tüm HTML etiketlerini temizleyin. Feed'i HTML olmadan tekrar gönderin.	Gönderim öncesi tüm metin alanlarından HTML etiketlerini otomatik temizleme fonksiyonu ekleyin.
90180	Öznitelik için sağlanan değer yanlış veri tipinde. Örnek: STRING yerine BOOL veya DECIMAL bekleniyor.	Hata mesajındaki beklenen veri tipini kontrol edin ve doğru tipte değer gönderin.	Sistemde alan bazlı veri tipi doğrulaması ekleyin. Product Type Definitions API şemasında beklenen tipleri kontrol edin.
90196	Öznitelik değerinde URL bulunuyor. Bu alanda URL kullanımına izin verilmemektedir.	URL içeren değeri düzeltip URL'siz olarak tekrar gönderin.	Gönderim öncesi URL tespiti ve temizleme kontrolü ekleyin.
99022	Öznitelik için minimum değer sayısı karşılanmamış.	Eksik değerleri ekleyin.	Minimum değer gereksinimlerini karşılamayan alanlar için uyarı sistemi kurun.
99016	Bir öznitelik için izin verilenden fazla giriş yapılmış.	Fazla girdileri kaldırıp yeniden gönderin.	Sistemde öznitelik bazlı maksimum değer sayısı kontrolü ekleyin.
90248	Belirtilen alan izin verilenden fazla değere sahip.	Fazla girdileri kaldırıp yeniden gönderin.	Sistemde öznitelik bazlı maksimum değer sayısı kontrolü ekleyin.
90194	Değer, beklenen desen (pattern) kısıtlamasını karşılamıyor.	Hata mesajındaki desene uygun formatta değer gönderin.	Bilinen desen kısıtlamaları olan alanlar için format doğrulaması ekleyin.
18280	fabric_type değerinde yüzde işareti eksik.	fabric_type özniteliğini yüzde dahil formatta düzeltin.	Kumaş tipi alanları için '%X kumaş_adı' format doğrulaması ekleyin.

Sayısal & Fiyat Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
90114	Sayısal öznitelik izin verilen minimum değerin altında.	Minimum değerin üzerinde bir değer girin.	Fiyat ve miktar alanlarında sıfır değeri engelleme kuralı koyun.
90197	Sayısal öznitelik izin verilen maksimum değeri aşıyor.	Değeri azaltarak tekrar gönderin.	Bilinen maksimum limitleri olan alanlar için üst sınır kontrolü ekleyin.
90193	Bir öznitelik diğerinden küçük olmalıdır ancak koşul karşılanmıyor. Örnek: cost_price < list_price.	Karşılaştırma kuralına uygun değerler sağlayın.	İlişkili alanlar arası karşılaştırma (cross-field validation) kuralları ekleyin.
90147	Bir öznitelik diğerinden küçük veya eşit olmalıdır. Genellikle item_weight ve item_package_weight arasında görülür.	item_weight değerinin item_package_weight'ten küçük veya eşit olduğundan emin olun.	Ağırlık/boyut alanlarında çapraz doğrulama kontrolü ekleyin.
90221	Ağırlık veya maliyet için 0 değeri gönderildiğinde ortaya çıkar. Bu alanlar sıfırdan büyük olmalıdır.	Sıfırdan büyük bir değer sağlayın.	Maliyet ve ağırlık alanlarında 0 değeri girişini engelleyen kural ekleyin.
4005002	Maliyet fiyatı izin verilen maksimum azalma oranından fazla düşürülmüş.	Daha küçük düşüşlerle gönderin.	getListingsItem API ile mevcut maliyetleri sorgulayarak büyük fiyat farklarını tespit edin.
4005001	Gönderilen para birimi mevcut ASIN'in para birimi ile eşleşmiyor.	Mevcut ASIN'in para birimini getCatalogItem ile kontrol edin.	Marketplace'e uygun para birimi otomatik eşleştirme kuralı ekleyin.
4005022	Ürün paket boyutları, üst paket hiyerarşisinin boyutlarından küçük olmalıdır.	Genişlik, yükseklik, uzunluk ve ağırlık değerlerini kontrol edin.	Paket hiyerarşisindeki boyut değerlerini otomatik karşılaştırma kontrolü ekleyin.

Sistem Hataları

Hata Kodu	Açıklama	Çözüm Adımları	API İpuçları
4000000	Amazon tarafında dahili bir hata oluştu. Detaylı bilgi sağlanamamıştır.	İşlemi tekrar deneyin (en az 2 kez). Sorun devam ederse Developer Support'a ticket açın.	Retry mekanizması kurun. Hata loglarını kaydedin ve periyodik olarak analiz edin.
4005012	SKU zaten farklı bir ASIN'e atanmış. SKU yalnızca bir ASIN'e atanabilir.	SKU'yu değiştirip yeniden gönderin.	getListingsItem ve getCatalogItem API'leri ile mevcut SKU-ASIN eşleşmelerini sorgulayın.