n11'e XML ile Ürün Göndermeden Önce Bilmeniz Gerekenler

Tedarikçinizin XML'inde binlerce ürün var, n11 mağazanız ise boş duruyor. Birkaç ürünü gönderiyorsunuz, ekranda "başarılı" yazıyor. Sonra ilanı açıyorsunuz ve renk başka, tür başka, bazı ürünler hiç satışta değil.

Bu yazıda n11 XML entegrasyonunu adım adım anlatıyoruz. Anlattıklarımızın dayanağı iki şey. Biri n11'in resmi API dokümanı, diğeri paneli sınadığımız kendi canlı mağazamız. O mağazada yaklaşık 100.000 ürünü beş pazaryerinde birden yönetiyoruz ve n11 de bunlardan biri.

n11 XML entegrasyonu aslında ne demek?

n11 ürünü kendi API'si üzerinden, kendi kategori ve özellik kimlikleriyle bekler. Tedarikçinin XML'i ise tedarikçinin diliyle yazılmıştır. Onun "Telefon Aksesuarı" dediği şey n11'de birkaç kırılım aşağıda, başka bir adla durur. Onun "Gold" dediği renk n11'in listesinde başka bir değerdir.

Yani "n11 XML entegrasyonu" dediğimiz iş, XML'deki her ürünü n11'in anlayacağı biçime çevirmektir. Çeviri eksik kalırsa ilan ya hiç açılmaz ya da yanlış açılır. İkincisi daha pahalıdır, çünkü fark edilmesi zaman alır.

Yanlış kurulan entegrasyon size neye mal olur?

• Görünmeyen ürün. Onayda ya da kuyrukta bekleyen ürün satış getirmez, ama sizin tarafınızda "gönderildi" görünür.
• Yanlış açılan ilan. Yanlış renkte ya da yanlış türde açılan ürün iade ve şikâyet getirir. Üstelik temel özelliği sonradan sizin düzeltmeniz mümkün değil.
• Elle kontrol saatleri. Yüzlerce ürünü tek tek açıp bakmak, entegrasyonla kazandığınız zamanı geri alır.
• İptal edilen sipariş. Tedarikçide bitmiş ama n11'de açık kalan ürüne sipariş gelir ve iptal etmek zorunda kalırsınız.

Bu yazının tek cümlelik özeti. n11'de görevin "başarılı" dönmesi, gönderdiğiniz özelliğin kabul edildiği anlamına gelmez. Ürün açıldıktan sonra marka, renk, beden gibi temel özellikleri API ile değiştiremediğiniz için eşleme ilk gönderimde doğru olmalı.

Adım adım n11 entegrasyonu

1. API anahtarınızı oluşturun

n11 her mağazaya özel bir API anahtarı ve API şifresi verir. Bunları satıcı panelinde Hesabım > API Hesapları menüsünden oluşturursunuz. Her istekte bu ikisi birlikte gider ve yalnız sizin mağazanızın verisine erişim sağlar. Şifreyi gerektiğinde yenileyebilir ya da API hesabını silebilirsiniz.

Kontrol edin. Entegrasyon için oluşturduğunuz API hesabını başka bir programla paylaşmayın. Şifreyi yenilediğinizde eski bağlantının kopacağını bilerek yenileyin.

2. Kargo şablonunu açmadan ürün göndermeyin

n11'e giden her ürün, bir kargo şablonunun adıyla birlikte gönderilir ve bu alan zorunludur. Şablonu satıcı panelinde Hesabım > Teslimat Bilgileri bölümünden oluşturursunuz. Kendi mağazamızda şablonu tanımlanmamış bir mağazadan tek bir ürün bile gönderemediğimiz oldu. Sorun kodda değil, bu eksik ayardaydı.

Kontrol edin. Şablonun adını entegrasyon ayarına panelde yazdığınız biçimde, harfi harfine girin.

3. Kategoriyi en alt kırılımda eşleyin

n11 ürünü kategori ağacının en alt basamağına bağlamanızı ister. XML'deki "Aksesuar" gibi geniş bir başlık yetmez. Her tedarikçi kategorisini bir kez n11'deki karşılığına bağlarsınız, sonraki ürünler aynı yoldan gider.

Bu eşlemenin genel mantığını toptancı XML bayilik entegrasyonu rehberimizde ayrıca anlattık.

4. Zorunlu özellikleri n11'in listesinden seçin

Her kategorinin kendi özellik listesi vardır ve bazıları zorunludur. Bu özelliklerin bir kısmı yalnız n11'in kendi değer listesini kabul eder. Bir kısmı serbest metne de izin verir.

Serbest metne izin verilen yerde bile listeden seçmeyi öneriyoruz. Listeden seçtiğiniz değer n11'in beklediği biçimdedir, sürpriz daha az çıkar. Zorunlu özelliği boş bırakırsanız ürün n11 tarafında reddedilir.

5. Varyantları aynı ana ürün koduyla gönderin

Aynı modelin farklı renk ve bedenlerini n11'de tek sayfada göstermek istiyorsanız, hepsini aynı ana ürün koduyla gönderirsiniz. n11 hangi özelliklerin varyant sayılacağını kategori bazında söyler. Ana ürün kodu her varyantta farklı giderse, aynı ayakkabının her bedeni ayrı bir ilan olarak açılır.

6. Stok kodunu ve barkodu doğru verin

Her ürünün benzersiz bir stok kodu olur. n11'e göre fiyat ve stok güncellemeleri bu koda göre yapılır, o yüzden stok kodu sonradan değişmemeli. XML'de tedarikçinin ürün kodu sabitse onu kullanmak en güvenli yoldur.

Barkod alanında n11 yalnız ulusal barkodları kaydeder. Gönderdiğiniz barkod n11 kataloğundaki bir ürünle eşleşirse, ürününüz özelliklere bakılmadan "satıcı onayı bekliyor" durumunda açılır. Katalogdaki ürünün kategorisi sizin seçtiğinizden farklıysa da aynı yere düşer.

Kontrol edin. Gönderimden sonra satıcı panelinde Aksiyon Bekleyenler > Satıcı Onayı Bekliyor ekranına bakın. Orada bekleyen ürün siz onay vermeden satışa açılmaz.

7. Fiyatı ve KDV'yi n11'in biçiminde gönderin

n11 iki fiyat ister. Biri liste fiyatı, yani üstü çizili görünen fiyat. Diğeri satış fiyatı. Fiyat güncellerken ikisini birlikte göndermeniz gerekir. Liste fiyatı satış fiyatından düşük olamaz. Kuruşlar virgülle değil noktayla ve iki haneyle yazılır, aksi hâlde istek reddedilir. KDV oranı olarak n11 0, 1, 10 ve 20 değerlerini kabul eder.

XML'deki fiyat genelde alış fiyatıdır. Komisyon, kargo ve kârınız eklenmeden n11'e gitmemeli. Bu hesabı pazaryeri komisyonu ve otomatik fiyat hesaplama yazımızda adım adım gösterdik.

8. Gönderdikten sonra sonucu okuyun

n11'de ürün yükleme ve fiyat-stok güncelleme anında sonuçlanmaz. İsteğiniz kuyruğa alınır ve size bir görev numarası döner. Asıl sonucu bu numarayla, her stok kodu için ayrı ayrı sonradan sorgularsınız. "İsteği aldım" ile "ürünü açtım" aynı şey değildir.

Kendi mağazamızda öğrendiğimiz en pahalı ders

Görev "başarılı" döndü diye ürünün gönderdiğimiz gibi açıldığını varsaydık. Sonra ilanları n11'den geri okuyup gönderdiklerimizle tek tek karşılaştırdık. Çoğu birebir tutuyordu. Bir kısmında ise n11, gönderdiğimiz özellik değerinin yerine başka bir değer koymuştu. Kılıf türü "Diğer" olmuştu, bir üründe gönderdiğimiz renk yerine başka bir renk duruyordu. Hata mesajı yoktu.

Asıl sorun bundan sonra başlıyor. n11'in resmi dokümanına göre ürün bilgisi güncelleme servisinde siz yalnız ürün güvenliği ve besin değeri gibi sınırlı özellikleri değiştirebilirsiniz. Marka, renk, beden gibi temel özellikleri n11 günceller. Yani yanlış açılan bir ilanın rengini entegrasyondan sonradan düzeltemezsiniz.

Sonuç şu. n11'de eşlemeyi göndermeden önce doğru yapmak, göndermekten daha önemlidir. Gönderdikten sonra da "başarılı" yazısına değil, ilanın n11'deki hâline bakın.

Sık yapılan hatalar

• Kargo şablonu olmadan göndermek. Şablon adı olmayan ürün n11'e gitmez.
• Eski KDV oranlarını kullanmak. 8 ve 18 artık geçerli değil. Yazılımınız eski oranları gönderiyorsa ürünler reddedilir.
• Fiyatta virgül kullanmak. n11 kuruşu nokta ile ve iki haneyle ister.
• Aynı stok kodunu yeni ürün gibi tekrar göndermek. n11 bu stok kodunun zaten kullanıldığını söyler. Bu çoğu zaman ürünün mağazanızda zaten açık olduğunu gösterir, hata sayıp tekrar tekrar göndermeyin.
• Görselleri güvensiz adresle göndermek. Görsel adresleri "https" ile başlamalı ve her görsel 10 MB'ı geçmemeli.
• Bütün kataloğu ilk günden göndermek. Resmi dokümanda ayrı bir test ortamı adresi yer almıyor. Önce küçük bir ürün grubuyla deneyin, sonuçları n11'den geri okuyun, sonra büyütün.
• XML'de biten stoğu n11'de açık bırakmak. Satılamayan ürüne sipariş gelir, iptal mağazanıza yazılır. Nedenlerini stok düşmüyor yazımızda anlattık.

Hızlı teşhis

• Hiçbir ürün gitmiyorsa önce kargo şablonuna ve API anahtarına bakın.
• Ürün "satıcı onayı bekliyor" durumundaysa barkod n11 kataloğundaki bir ürünle eşleşmiştir. Kategoriyi kontrol edip panelden onay verin.
• Görev başarılı ama özellik farklıysa n11 değeri ikame etmiştir. Eşlemeyi düzeltmek sonraki ürünleri kurtarır, açılmış ilan için n11'e başvurmanız gerekebilir.
• Stok ya da fiyat n11'e geçmiyorsa stok kodunun değişip değişmediğine bakın. Çok pazaryerinde stok akışını stok senkronizasyonu rehberimizde anlattık.

Bunu Entegmar'da nasıl yapıyoruz

Entegmar'da tedarikçinizin XML kaynağını bir kez bağlarsınız, ürünler havuzda toplanır. Kategori ve özellik eşlemesini n11'in kendi listesiyle bir kez yaparsınız. Fiyatı maliyet, kargo, komisyon ve kâr kuralınıza göre panel hesaplar. Stok değiştikçe n11'e de gider, siparişler diğer dört pazaryeriyle aynı listede görünür. n11 entegrasyonu sayfamızda ekranları görebilirsiniz.

Sık sorulan sorular

n11 entegrasyonu için API anahtarını nereden alırım?

n11 satıcı panelinde Hesabım > API Hesapları menüsünden. Anahtar ve şifre her istekte birlikte gönderilir ve yalnız kendi mağazanıza erişim verir.

Ürünü gönderdim, neden hemen görünmüyor?

n11 ürün yüklemeyi kuyruğa alarak işler. İstek kabul edildiğinde bir görev numarası döner, sonucu bu numarayla sonradan sorgularsınız. Ürün ayrıca "satıcı onayı bekliyor" durumuna da düşmüş olabilir.

Açılmış bir ürünün rengini ya da markasını sonradan değiştirebilir miyim?

Entegrasyon üzerinden değiştiremezsiniz. n11'in dokümanına göre temel özellikleri n11 günceller. Bu yüzden eşlemeyi ilk gönderimden önce doğru yapmak gerekir.

Tedarikçim XML'ine yeni ürün eklerse ne olur?

Kategorisi daha önce eşlenmişse ürün aynı eşlemeyle hazırlanır. Kategorisi yeniyse önce onu n11'deki karşılığına bağlamanız gerekir.

Kendi XML'inizle birlikte bakalım

n11'de hangi ürünlerinizin ilk seferde doğru açılacağını, hangilerinin eşleme isteyeceğini kendi XML'iniz üzerinden görmek en kısa yoldur. Kısa bir demoda tedarikçi dosyanızı birlikte açalım.

Demo talebi bırakın →