HTTP durum kodları
| Durum | Ne zaman | Ne yapmalı |
|---|---|---|
| 401 ve VENDOR_TOKEN_NOT_EXIST | Token yanlış ya da sırası ters (dokümanda) | API Key, Secret, sıra ve ortamı kontrol edin |
| 429 Too Many Request | İstek eşiği aşıldı (dokümanda) | Retry-After kadar bekleyip yeniden deneyin |
| 400 ve violations | Gövdedeki bir alan doğrulamadan geçmedi (canlı kullanımda görüldü) | propertyPath'teki kalemi ve alanı düzeltin |
| 405 Method Not Allowed | Yanlış HTTP yöntemi (canlı kullanımda görüldü) | Yanıttaki Allow başlığının yöntemini kullanın |
400 ve 405 satırları idefix dokümanında yazmaz; canlıda çalışan bir entegrasyonun kayıtlarından alınmıştır. Örneğin hızlı listeleme sonuç servisi dokümanda POST yazar, canlı API ise bu adrese POST isteğini 405 ve Allow: GET ile yanıtladı.
400 doğrulama yanıtı nasıl okunur?
Toplu gönderimde tek bir hatalı kalem bütün isteğin 400 almasına yol açabilir. Yanıttaki violations dizisinde her ihlalin propertyPath ve title alanları bulunur.
- propertyPath: items[20].vendorStockCode gibi bir değerdir. 21. kalemin (sayım sıfırdan başlar) stok kodu kabul edilmedi demektir.
- title: ihlalin açıklamasıdır; örneğin uzunluk sınırı aşıldı.
Bu durumda hatalı kalemi ayırıp kalanları yeniden göndermek, bütün partiyi bekletmekten iyidir. Canlı kullanımda stok kodunun (vendorStockCode) 40 karakteri geçmesi bu hatayı üretti.
Ürün oluşturma failureReasons kodları
| Kod | Anlamı |
|---|---|
| CATEGORY_MANDATORY_ATTRIBUTE_MISSED | Kategorinin zorunlu özelliği eksik |
| ATTRIBUTE_MULTIPLE_NOT_ALLOWED | Aynı özellik birden fazla kez gönderilmiş |
| CUSTOM_ATTRIBUTE_NOT_SUPPORTED_YET | Sistemde tanımlı olmayan bir özellik gönderilmiş |
| ATTRIBUTEVALUE_NOT_DEFINED | Tanımlı olmayan özellik değeri gönderilmiş |
| BRAND_NOT_EXIST | Marka idefix'te yok |
| BRAND_FAILED_TO_MATCH | Ürün katalogda var ama marka uyuşmuyor; doğru marka ID'si yanıtta |
| CATEGORY_FAILED_TO_MATCH | Ürün katalogda var ama kategori uyuşmuyor; doğru kategori ID'si yanıtta |
| PRODUCT_IMAGE_MANDATORY_ONCREATE | Ürün görseli zorunlu |
| VENDOR_CATEGORY_ACCESS_DENIED | Kategoriye ürün ekleme yetkiniz yok |
| VENDOR_BRAND_ACCESS_DENIED | Markaya erişim yetkiniz yok |
| BRAND_EXCLUSIVE_NOT_AUTHORIZED | Marka için münhasır yetkiniz yok |
| VENDOR_ACCESS_DENIED | Satıcı onaylı değil |
| VENDOR_IN_VACATION_MODE | Tatil modu açık |
| VENDOR_RETURN_ADDRESS_NOT_CORRECT | Gönderilen iade adresi tanımlı adresle uyuşmuyor |
| VENDOR_SHIPMENT_ADDRESS_NOT_CORRECT | Gönderilen sevkiyat adresi tanımlı adresle uyuşmuyor |
| PRODUCT_POOL_ALREADY_EXIST | Ürün zaten ürün havuzunuzda |
| DATA_PARSE_ERROR | İstek gövdesi okunamadı |
| NO_BATCH_ID_EXIST | batchId hatalı ya da sistemde yok |
Hızlı listeleme ve stok-fiyat kodları
| Servis | Kod | Anlamı |
|---|---|---|
| fast-listing-result | PRODUCT_BARCODE_NOT_EXIST | Barkod katalogda yok; ürün oluşturma servisine gidin |
| fast-listing-result | PRODUCT_POOL_ALREADY_EXIST | Ürün havuzunuzda zaten var |
| fast-listing-result | VENDOR_CATEGORY_ACCESS_DENIED, VENDOR_ACCESS_DENIED, BRAND_EXCLUSIVE_NOT_AUTHORIZED | Kategori, satıcı ya da marka yetkisi yok |
| inventory-result | PRODUCT_NOT_FOUND | Barkod ürün havuzunda yok |
| inventory-result | CATALOG_PRICE_LOCKED | Fiyat kilitli; destek ekibine başvurun |
| inventory-result | BATCH_NOT_EXIST, BATCH_ALREADY_PROCESSED | Parti bulunamadı ya da zaten işleniyor |
| inventory-result | DATA_PARSE_ERROR | Gönderilen veri okunamadı |
Dokümandaki örneklerde failureReasons düz metin kod olarak görünür. Canlı yanıtlarda bu alan nesne olarak da geldi: message ve description alanları taşıdı, örneğin "Ürün mevcut değil". Kodunuz metin, dizi ve nesne biçimlerinin üçünü de okuyabilmelidir. Stok-fiyat örnek yanıtında tabloda olmayan NO_PRICE kodu da geçer.
Sık sorulanlar
VENDOR_TOKEN_NOT_EXIST hatası nasıl çözülür?
API Key ile API Secret'ın doğru sırada (önce Key) birleştirilip Base64 ile kodlandığını, değerlerde boşluk olmadığını ve canlı adreste canlı bilgilerin kullanıldığını kontrol edin.
PRODUCT_BARCODE_NOT_EXIST ne anlama gelir?
Hızlı listelemede gönderdiğiniz barkod idefix kataloğunda yok. Ürünü kategori, marka ve özelliklerle ürün oluşturma (create) servisinden göndermeniz gerekir.
CATEGORY_MANDATORY_ATTRIBUTE_MISSED nasıl düzelir?
Kategori özellik listesinde required=true olan her özelliği attributes alanında gönderin. Liste /pim/category-attribute/{categoryID} adresinden alınır.
CATALOG_PRICE_LOCKED alırsam ne yapmalıyım?
Ürün fiyatı idefix tarafında kilitlenmiştir. idefix dokümanı bu durumda destek ekibiyle görüşülmesini söyler; fiyatı API'den değiştiremezsiniz.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı