Kısa cevap

Varyantlı ürün entegrasyonunda temel kural, ürün ailesi ile satılabilir varyantı ayırmaktır. Ana ürün kodu gruplamayı; SKU/barkod ise tekil satılabilir varyantı temsil etmelidir.

Varyantlı Ürünleri Pazaryerlerine Gönderme neden önemli?

Siyah-M ve Siyah-L varyantları aynı ana ürün altında olmalı, ancak stok ve barkodları farklı tutulmalıdır. Ana ürün ve varyant anahtarları karışırsa kanal tarafında kopya veya parçalanmış ürün oluşabilir.

Operasyon otomasyonunda asıl hedef ekrandaki tıklama sayısını azaltmak değil, aynı verinin bütün kanallarda tutarlı kalmasını sağlamaktır. Bunun için kaynak sistem, güncelleme yönü ve hata davranışı açıkça tanımlanmalı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ı?

Merkezi ürün ve sipariş modeli ile kanal özelindeki kimlikleri ayırın. Yerel SKU değişmez kalırken pazaryeri ürün ID, listing ID veya task ID gibi uzak kimlikler ayrı tutulmalıdır. Böylece bir kanaldaki hata diğer kanala sıçramaz.

Ü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. Ana ürün kodu ile varyant SKU'sunu ayrı alanlarda 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.
  2. Her satılabilir varyanta benzersiz SKU ve gerekiyorsa benzersiz barkod verin. 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. Renk, beden ve diğer varyant özelliklerini kategori şemasındaki geçerli değerlere eşleyin. 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. Görselleri ürün ve varyant seviyesinde doğru ilişkilendirin. 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. Stok ve fiyatı varyant seviyesinde güncelleyin. 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. Yeni varyant ekleme ve mevcut varyant kapatma senaryolarını ayrı test 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.
  7. Toplu gönderim sonrası ürün ailesinin kanal tarafında tek grup olarak oluştuğunu 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.

Kontrol ve ölçüm noktaları

Gecikme süresi, hata oranı, yeniden deneme sayısı, stok uyuşmazlığı ve manuel müdahale adedi günlük operasyon sağlığını gösteren temel metriklerdir.

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

Aynı barkodu birden fazla varyantta kullanmak.

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.

Ana ürün kodunu SKU yerine göndermek.

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.

Varyant değerlerinde 'Siyah', 'siyah ', 'Black' gibi dağınık sözlük kullanmak.

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.

Bir varyantı silerken tüm ürün ailesini güncellemek.

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

Ana ürün kodu ile SKU aynı mı?

Genellikle hayır. Ana ürün kodu varyant ailesini, SKU ise satılabilir varyantı tanımlar.

Varyantların fiyatı farklı olabilir mi?

Pazaryeri ve entegrasyon modeli destekliyorsa varyant bazlı fiyat yönetilebilir.

Yeni beden eklenince tüm ürün yeniden gönderilir mi?

Kanal API modeline göre değişir; entegrasyon yalnız gerekli varyantı veya ürün grubunu güncellemelidir.