XML ile İdefix'e Ürün Aktarma: Hızlı Listeleme ve Yeni Ürün

Kısa cevap

İdefix'te katalogda bulunan global barkodlu ürünler hızlı listeleme akışıyla, yeni katalog ürünleri ise create akışıyla ele alınır. XML entegrasyonu önce hangi ürünün hangi akışa gireceğini belirlemelidir.

XML ile İdefix'e Ürün Aktarma neden önemli?

Aynı XML'de hem İdefix kataloğunda bulunan hem de hiç açılmamış ürünler olabilir. Tümünü tek endpoint mantığıyla göndermek yerine barkod/katalog sonucuna göre dallanan bir iş akışı gerekir.

XML veya Excel bir veri kaynağıdır; pazaryerinin katalog şeması değildir. Kaynak alanları temizlemek, normalize etmek ve kanalın kategori/özellik modeline çevirmek entegrasyonun asıl işidir.

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ı?

Sağlam akış kaynak veriyi önce yerel ürün modeline alır. Ardından kategori, marka, varyant, fiyat ve stok kuralları uygulanır; son aşamada kanal özelindeki payload üretilir. Böylece bir pazaryerindeki değişiklik ana ürün verisini bozmaz.

Ü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ı

XML'deki global barkod, stok kodu, marka, kategori ve ürün özelliklerini 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.
Marka, kategori ve kategori özellik listelerini İdefix servislerinden güncel ç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.
Katalogda bulunan uygun ürünleri hızlı listeleme 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.
Yeni ürünleri create akışı için zorunlu alanlarla hazırlayı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.
BatchRequestId değerini kaydedip batch-result ile sonucu takip 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.
Onaylı ürünlerde inventory-upload ile stok-fiyat gönderimini çalıştı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.
Eşleşen ürünlerde onay/red sürecini operasyon ekranında görünür tutun. 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ı

İlk toplu aktarımda başarı oranı, eşleşmeyen marka/kategori sayısı, zorunlu özellik eksikleri ve batch sonucu izlenmelidir. Sonraki senkronlarda yalnız değişen ürünleri göndermek API yükünü ve hata yüzeyini azaltır.

İş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ı

Yeni ürünü hızlı listeleme servisine gönderip katalogda oluşmasını beklemek.

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.

Required=true özellikleri boş göndermek.

Batch sonucunu okumadan ürünü başarılı saymak.

Ürün eşleşmesi kararını operatöre göstermeden otomatik kabul etmek.

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

İdefix hızlı ürün yükleme ne zaman kullanılır?

İdefix kataloğunda bulunan ve global barkodla eşleşebilen ürünlerin hızlı satışa açılması için kullanılır.

Yeni ürün nasıl gönderilir?

Marka, kategori ve zorunlu özellikler tamamlanarak create akışı kullanılır.

Stok ve fiyat nasıl güncellenir?

Onaylı ürünler için inventory-upload akışı kullanılır ve sonuç ayrıca sorgulanır.