İstek alanları
| Alan | Zorunlu | Anlamı |
|---|---|---|
| barcode | Evet | Ürünün global barkodu |
| title | Evet | Ürün adı |
| vendorStockCode | Evet | Sizin stok kodunuz |
| price | Evet | idefix satış fiyatı |
| comparePrice | Hayır | Tavsiye edilen satış fiyatı |
| inventoryQuantity | Evet | Satılabilir stok adedi |
Alanlar items dizisi içinde gönderilir. Örnek bir kalem: barcode: 194252707258, title: Ürün adı, vendorStockCode: STOK_KODU, price: 20, comparePrice: 20, inventoryQuantity: 20. Global barkodun ne olduğunu GS1 Türkiye'nin SSS sayfası anlatır.
Akış: gönder, sorgula, onayla
- POST /pim/catalog/{vendorId}/fast-listing ile kalemleri gönderin. Yanıtta parti durumu CREATED ve bir batchRequestId döner.
- Partinin sonucunu /pim/catalog/{vendorId}/fast-listing-result/{batchID} ile sorgulayın.
- Kalem durumu COMPLETED ise barkod katalogda bulunmuş ve satıcı olarak eklenmişsiniz demektir.
- poolState waiting_vendor_approve ise eşleşmeyi onaylamanız beklenir: approve-item servisi ya da satıcı paneli.
- Durum DECLINE ise failureReasons'a bakın. PRODUCT_BARCODE_NOT_EXIST barkodun katalogda olmadığını söyler.
Sonuç yanıtındaki matchedProduct alanı, barkodunuzun eşleştiği katalog ürününü gösterir: ad, marka, kategori, görseller ve özellikler. Onaylamadan önce bu bilgilerin sizin ürününüzle aynı olduğunu kontrol edin. Eşleşmenin onayı ve 24 saat kuralı ürün durumu ve eşleşme onayı sayfasında.
Durum değerleri
| Değer | Nerede | Anlamı |
|---|---|---|
| CREATED, created | Parti ve kalem | Talep alındı, henüz işlenmedi |
| COMPLETED | Kalem ya da parti | Barkod bulundu, satıcı olarak eklendiniz |
| DECLINE | Kalem | Ürün yüklenemedi; failureReasons'a bakın |
| waiting_vendor_approve | poolState | Katalog eşleşmesi onayınızı bekliyor |
Büyük-küçük harf tutarsızdır: dokümanda parti durumu COMPLETED, kalem durumu completed olarak görünür. Karşılaştırmayı harf duyarsız yapın.
Dokümandan farklı canlı davranışlar
- Doküman sonuç servisini POST olarak gösterir. Canlı API Ekim 2026'da bu adrese gelen POST isteğine 405 ve Allow: GET yanıtı verdi; sonuç GET ile alınır.
- Kalem durumu ilk sorgularda created kalabilir. Bu nihai sonuç değildir; birkaç saniye arayla yeniden sorgulayın.
- failureReasons canlıda nesne olarak da geldi; örneğin message alanında "Ürün mevcut değil" metni. Bu metin PRODUCT_BARCODE_NOT_EXIST ile aynı anlama gelir.
Sık hatalar ve çözümleri
| Hata | Çözüm |
|---|---|
| Barkod yerine ürün adı ya da iç kod göndermek | Ürünün üzerindeki global barkodu (GTIN) gönderin |
| PRODUCT_BARCODE_NOT_EXIST'i kalıcı hata saymak | Ürünü create servisiyle yeni ürün olarak açın |
| Sonucu beklemeden stok güncellemek | Önce kalemin COMPLETED olmasını bekleyin |
| PRODUCT_POOL_ALREADY_EXIST | Ürün zaten havuzunuzda; yalnız stok ve fiyat gönderin |
| VENDOR_CATEGORY_ACCESS_DENIED | Ürünün kategorisi için yetki isteyin |
Barkodsuz ürünleriniz varsa hızlı ekleme işe yaramaz; önce barkod tanımlama rehberine bakın.
Sık sorulanlar
idefix hızlı ürün ekleme ne zaman kullanılır?
Ürünün global barkodu idefix kataloğunda zaten varsa. Bu durumda yeni ürün kartı açmadan, kategori ve marka girmeden satıcı olarak eklenirsiniz.
fast-listing için kategori ve marka gerekir mi?
Hayır. Barkod, ad, stok kodu, fiyat ve stok yeterlidir. Kategori ve marka yalnız ürün oluşturma (create) servisinde istenir.
Hızlı ürün ekleme sonucu nasıl sorgulanır?
Yanıttaki batchRequestId ile /pim/catalog/{vendorId}/fast-listing-result/{batchID} adresine istek atılır. Doküman POST yazsa da canlı API GET istiyor.
PRODUCT_BARCODE_NOT_EXIST alırsam ne yapmalıyım?
Barkod katalogda yok demektir. Ürünü kategori, marka ve zorunlu özelliklerle create servisinden yeni ürün olarak gönderin.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı