Kısa cevap

İdefix resmi dokümanında hızlı ürün yükleme, katalogda bulunan global barkodlu ürünlerin listelenmesi için; create ise katalogda bulunmayan yeni ürünlerin oluşturulması için kullanılır. Entegrasyonun önce ürünün katalog durumunu ayırması gerekir.

İdefix Hızlı Ürün Yükleme mi Yeni Ürün Oluşturma mı? neden önemli?

Katalogda olmayan ürünü fast-listing'e göndermek sürekli failed sonucu üretir. Tersi durumda mevcut ürünü yeniden create etmeye çalışmak gereksiz eşleşme ve operatör süreci oluşturabilir.

Her pazaryerinin katalog, listeleme, stok-fiyat ve sipariş modeli farklıdır. Bu nedenle bir kanalda çalışan entegrasyon mantığını diğerine birebir kopyalamak yerine resmi API akışı temel alınmalıdır.

2026 itibarıyla pazaryerleri katalog ve sipariş servislerini düzenli olarak güncelliyor. Bu nedenle entegrasyon kararını yalnız bir kez yapılan kurulum gibi değil, izlenen ve güncellenen bir operasyon sistemi gibi ele almak daha sağlıklıdır.

Doğru çalışma mantığı nasıl kurulmalı?

Platform entegrasyonunu kimlik doğrulama, ürün/katalog, envanter/fiyat, sipariş ve sonuç takibi olarak ayrı modüller halinde düşünmek bakım ve test kolaylığı sağlar. Resmi sürüm değişiklikleri de modül bazında uygulanabilir.

Ürün veya sipariş kaydında yerel kimlik ile pazaryerinin uzak kimliğini birlikte saklamak, tekrar deneme ve durum sorgularında kritik önem taşır. İşlem geçmişi kaybolmadığında aynı kaydın neden beklediği veya reddedildiği daha hızlı bulunur.

Adım adım uygulama planı

  1. Ürünün global barkodunu ve yerel SKU'sunu doğrulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  2. İdefix katalogunda mevcut ürün eşleşmesini kontrol edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  3. Mevcut uygun ürünleri fast-listing akışına ayırın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  4. Yeni ürünler için marka, kategori ve required özellikleri çekin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  5. Create isteğinde zorunlu alanları eksiksiz gönderin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  6. Her iki akışta batchRequestId değerini saklayıp sonucu sorgulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
  7. Onaylanan ürünlere stok-fiyat gönderimini inventory akışıyla yapın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.

Kontrol ve ölçüm noktaları

Canlıya geçişten önce başarılı ürün oranı, asenkron sonuç süresi, stok-fiyat yansıma gecikmesi, sipariş çekme gecikmesi ve rate-limit hataları ölçülmelidir.

  • İşlem hangi mağaza ve kanal için çalıştı?
  • Yerel SKU/barkod ile uzak ürün kimliği eşleşiyor mu?
  • Son durum ilk API yanıtından mı, nihai sonuç servisinden mi geliyor?
  • Başarısız işlem için kullanıcıya anlaşılır hata nedeni gösteriliyor mu?
  • Tekrar deneme mükerrer ürün veya sipariş oluşturmadan çalışıyor mu?
  • Canlı kanalda örnek ürün/sipariş ile sonuç doğrulandı mı?

Sık yapılan hatalar ve düzeltme yaklaşımı

Katalogda olmayan ürünü fast-listing ile oluşturmaya çalışmak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

Create öncesi required kategori özelliklerini çekmemek.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

Batch sonucunu beklemeden stok-fiyat işini başlatmak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

Eşleşen ürünü kullanıcı kontrolü olmadan yanlış onaylamak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

2026 için güncellik notları

Pazaryeri API dokümanları, endpoint sürümleri, zorunlu alanlar ve işlem limitleri zaman içinde değişebilir. Bu yazıdaki operasyon mantığını uygularken ilgili kanalın güncel geliştirici veya satıcı destek dokümanını esas alın. Özellikle ürün oluşturma, toplu güncelleme ve sipariş durum servislerinde sürüm notlarını takip etmek gerekir.

Canlı sistemlerde değişiklik yapmadan önce küçük ürün grubu, düşük riskli stok-fiyat değeri ve test edilebilir sipariş senaryosu kullanmak; geniş kataloğa geçmeden önce hata davranışını görmeyi sağlar.

3E Entegrasyon tarafında hangi akışlar değerlendirilebilir?

3E Yazılım’ın pazaryeri entegrasyonu sayfasında XML, Excel, manuel ürün ekleme, desteklenen bağlantılardan ürün alma, tekil/toplu ürün gönderimi, kategori-özellik eşleştirme, stok-fiyat senkronizasyonu ve sipariş takibi gibi operasyon başlıkları yer alıyor. İhtiyacınız bu akışlardan biriyse önce gerçek ürün verinizle demo senaryosu oluşturmak en sağlıklı karşılaştırma yöntemidir.

Pazaryeri entegrasyonu özelliklerini inceleyin veya demo talebi oluşturun.

Sık sorulan sorular

Fast-listing ne işe yarar?

Katalogda bulunan ve global barkodla eşleşen ürünlerin daha hızlı satışa açılmasını sağlar.

Create ne zaman kullanılır?

İdefix katalogunda bulunmayan yeni ürün oluşturulacağı zaman kullanılır.

İki işlemde de sonuç sorgulanmalı mı?

Evet. Resmi akış batchRequestId ile sonuç takibi yapılmasını öngörür.

Resmî ve güvenilir kaynaklar