Zorunlu ve isteğe bağlı alanlar
Ürünler products dizisi içinde gönderilir. Dokümanda yıldızla işaretli alanlar zorunludur.
| Alan | Zorunlu | Not |
|---|---|---|
| barcode | Evet | Ürün barkodu |
| title | Evet | Ürün adı |
| productMainId | Evet | Ana ürün kodu; varyantlarda ortak |
| brandId | Evet | Marka servislerinden alınır |
| categoryId | Evet | Yaprak kategori ID'si |
| inventoryQuantity | Evet | Satılabilir stok |
| vendorStockCode | Evet | Sizin stok kodunuz |
| description | Evet | Ürün açıklaması |
| price | Evet | idefix satış fiyatı |
| vatRate | Evet | KDV oranı |
| images.url | Evet | https görsel; barkod başına en fazla 8 |
| attributes.attributeId | Evet | Kategori özellikleri |
| comparePrice | Hayır | Tavsiye edilen satış fiyatı |
| desi, weight | Hayır | Paketin boyutsal ağırlığı ve ürün ağırlığı |
| deliveryType | Hayır | regular ya da same_day_shipping |
| cargoCompanyId, shipmentAddressId, returnAddressId | Hayır | Kargo firması, sevkiyat ve iade adresi ID'leri |
Varyantlı ürün nasıl gönderilir?
Bir ürünün renk ya da hafıza gibi varyantları varsa her varyant ayrı barkodla ama aynı productMainId ile gönderilir. Varyantı ayıran değer, kategorinin isVariant=true özelliğinde yer alır. Dokümandaki örnek iki varyantı şöyle kurar:
| barcode | productMainId | vendorStockCode | Varyant özelliği (attributeId 1) |
|---|---|---|---|
| 8879615313219 | FHY777 | STOK_A | attributeValueId 100090 |
| 8879615313500 | FHY777 | STOK_B | attributeValueId 100130 |
Her varyantın kendi stoğu, fiyatı ve görselleri olabilir. Varyantları ayrı productMainId ile gönderirseniz vitrinde tek ürün sayfası yerine ayrı ürünler görünür.
Ürün denetim bilgileri
İstek, ürün güvenliği denetimi için isteğe bağlı alanlar da taşır: originCountryId (menşe ülke), manufacturer (üretici), importer (ithalatçı ya da yetkili temsilci), ceCompatibility (CE uygunluğu), lotInfo (parti, lot ya da son kullanma tarihi). Görsel alanları da vardır: kullanım talimatı, paket ön ve arka yüzü, ürün bilgi formu, enerji sınıfı, enerji ve besin değerleri.
Menşe ülke ID'leri GET /pim/country/origin-country servisinden alınır; örneğin 1 Andorra, 2 Birleşik Arap Emirlikleri. Bu alanlar ürününüzün kategorisinde denetim bilgisi isteniyorsa gönderilir.
Bilmeniz gereken kurallar
- Bir istekte en fazla 200 ürün gönderilir (idefix SSS).
- Görseller SSL sertifikalı https adresinde olmalıdır.
- Dokümandaki KDV örnekleri (0, 1, 8, 18) eskidir. Türkiye'de Temmuz 2023'ten beri genel oranlar yüzde 1, 10 ve 20'dir; ürününüzün güncel oranını gönderin. Hesap için KDV hesaplama aracını kullanabilirsiniz.
- Canlı kullanımda vendorStockCode 40 karakteri geçince istek 400 ile reddedildi.
- Ürün güncelleme API'de yoktur. Ad, açıklama ya da görsel değişikliği API dışında yapılır.
- Gönderilen ürün idefix incelemesinden geçer; katalogla eşleşirse onayınız beklenir.
Sık hatalar ve çözümleri
| Hata kodu ya da belirti | Neden | Çözüm |
|---|---|---|
| PRODUCT_IMAGE_MANDATORY_ONCREATE | Görsel yok | En az bir https görsel ekleyin |
| CATEGORY_MANDATORY_ATTRIBUTE_MISSED | Zorunlu özellik eksik | Özellik listesindeki required alanları gönderin |
| BRAND_NOT_EXIST | brandId yanlış | Marka servislerinden ID alın |
| 400 ve violations | Alan biçimi ya da uzunluğu | propertyPath'teki kalemi düzeltin |
| Ürün görünmüyor | Sonuç sorgulanmadı | batch-result ile durumu kontrol edin |
| PRODUCT_POOL_ALREADY_EXIST | Barkod zaten havuzunuzda | Yalnız stok ve fiyat gönderin |
Sık sorulanlar
idefix'te ürün bilgilerini API ile güncelleyebilir miyim?
Hayır. idefix dokümanı ve SSS'si API ile yalnız stok ve fiyat güncellenebildiğini söyler. Ad, açıklama ve görsel API'den değiştirilemez.
Bir create isteğinde kaç ürün olur?
En fazla 200 ürün. Daha büyük listeleri 200'lük partilere bölün ve her partinin sonucunu ayrı sorgulayın.
Varyantlı ürünler nasıl bağlanır?
Her varyant ayrı barkodla ama aynı productMainId ile gönderilir. Varyantı ayıran değer kategorinin isVariant=true özelliğinde yer alır.
Ürün gönderildi ama listede yok, neden?
Ürün inceleme ya da onay bekliyor olabilir. Yanıttaki batchRequestId ile batch-result servisinden ürünün durumunu ve varsa failureReasons kodunu okuyun.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı