İdefix'in resmî API portalı ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri, fatura gönderimi ve iade süreçleri için servisler sunuyor. Sağlıklı kurulumda bu servisler tek tek çağrılan teknik uçlar olarak değil, sonucu doğrulanan bir operasyon zinciri olarak ele alınmalıdır.
İdefix entegrasyonu hangi operasyonları kapsar?
İdefix API portalı; kategori, marka ve kategori özelliklerini okumaya, yeni ürün oluşturmaya, mevcut kataloğu sayfalı biçimde çekmeye, stok-fiyat göndermeye ve sipariş sevkiyatlarını almaya yönelik servisleri ayrı gruplarda sunar. Bu ayrım, bağlantı testinin başarılı olmasının ürünün yayında veya sipariş akışının eksiksiz olduğu anlamına gelmediğini gösterir.
Ticevo'da İdefix mağazası diğer pazaryerleriyle aynı operasyon modeline bağlanır. Ürün, stok, fiyat ve sipariş durumları mağaza bazında ayrılır; toplu işlemler İş Kuyruğu üzerinden izlenir ve bir kabul cevabı terminal başarı olarak yorumlanmaz.
- Kategori, marka ve zorunlu özellik hazırlığı
- Ürün oluşturma ve hızlı listeleme
- Stok-fiyat gönderimi ve batch sonucu takibi
- Sipariş, kargo takip ve fatura bağlantısı akışı
Ürün yayına hazırlanırken neden kategori ağacı önemlidir?
İdefix kategori servisi alt kategorileri iç içe bir ağaç olarak döndürür. Ürün oluşturulabilen son kategori seçilmeden yalnız üst kategoriyle ilerlemek, zorunlu özelliklerin yanlış veya eksik hazırlanmasına neden olabilir. Bu yüzden Ticevo kategori ağacını tek kaynaktan açar, yalnız seçilebilir yaprak kategorileri tam yoluyla gösterir.
Kategori seçildikten sonra marka ve özellik sözlükleri aynı hazırlık akışında kullanılır. Barkod, ürün ana kodu, görsel, açıklama ve varyant bilgileri hedef kanalın kurallarına göre doğrulanır; eksik alanlar toplu gönderim başlamadan görünür hale getirilir.
- Yalnız yaprak kategoriyi seçin
- Kategori yolunu ve zorunlu özellikleri birlikte kontrol edin
- Barkod ve stok kodunu mağaza kimliğinden ayırın
- Önce küçük ürün grubuyla yayın sonucunu doğrulayın
Stok ve fiyat güncellemesi kabul cevabıyla bitmez
İdefix'in stok-fiyat servisi barkod bazında satış fiyatı, karşılaştırma fiyatı, satılabilir stok ve teslimat alanlarını kabul eder. Resmî dokümana göre gönderim sonrasında dönen batchRequestId ile sonuç servisi sorgulanmalıdır. Bu nedenle HTTP cevabını tek başına başarı saymak, kısmi hata veya bekleyen kaydı gözden kaçırabilir.
Ticevo fiyat ve stok değişikliklerini ortak iş kuyruğuna alır; mağaza, ürün ve işlem sonucunu ayrı izler. 429 yanıtında Retry-After bilgisi korunur ve aynı mağazaya gereksiz tekrar baskısı uygulanmaz. Böylece toplu güncelleme performansı ile pazaryeri kotası aynı karar içinde yönetilir.
- Gönderim sonucundaki batch kimliğini saklayın
- Bekleyen, başarılı, kısmi ve reddedilen kalemleri ayırın
- 429 yanıtında pazaryerinin bekleme süresine uyun
- Yerel hedef stok-fiyat ile canlı katalog sonucunu karşılaştırın
İdefix mağazası için uygulanabilir başlangıç planı
Kuruluma Vendor ID, API Key ve API Secret bilgileriyle bağlantı testi yaparak başlayın. Ardından kategori ve marka sözlüklerini doğrulayın, az sayıda ürünle listeleme testi çalıştırın ve batch sonucunu terminal duruma kadar izleyin. İlk başarılı ürün grubundan sonra fiyat-stok ve sipariş senkronunu açın.
Kapsamı doğru okumak da önemlidir. Ticevo'nun mevcut İdefix sürümünde ürün içerik güncelleme, BuyBox ve webhook akışları desteklenmez; sipariş iptali ile iade kararları İdefix panelindeki süreçlerden ayrıdır. Kargo takip numarası ve HTTPS takip bağlantısı ile fatura bağlantısı ise ortak sipariş/fatura akışından gönderilebilir.
- Bağlantıyı kaydetmeden önce kimlik doğrulamasını test edin
- Küçük ürün grubunda kategori ve özellik sonucunu doğrulayın
- Batch sonucu kapanmadan ürünü yayında saymayın
- Desteklenmeyen işlemleri İdefix panelindeki süreçle yönetin
