n11 entegrasyonu:
ürün, stok ve sipariş tek panelde.

n11 entegrasyonu: API bağlantısından hakediş kontrolüne kadar bilmeniz gerekenler

n11 entegrasyonu, mağazanızdaki ürünleri, stokları, fiyatları ve siparişleri n11'in resmî API'si üzerinden bir yazılıma bağlayarak elle güncelleme ihtiyacını ortadan kaldırır. Bu bölümde API anahtarının alınmasını, katalog kontrolünü, stok ve fiyat kurallarını, sipariş ve kargo akışını ve kesinti kontrolünü n11 Mağaza Destek Merkezi'ndeki açıklamalara dayanarak anlatıyoruz. Değişebilen oran ve ücretlerde her zaman satıcı panelinizdeki güncel bilgiyi esas alın.

n11 entegrasyonu kimler için gerekli?

n11'de ürünleri üç yolla listeleyebilirsiniz: elle yükleme, Excel ile toplu yükleme ve API entegrasyonu. Az sayıda ürünü yalnız n11'de satıyorsanız elle yönetim bir süre yeter. Aynı ürünü birden fazla kanalda sattığınızda ise her satıştan sonra diğer mağazalardaki stoğu düşürmek ayrı bir iş hâline gelir; gözden kaçan tek bir güncelleme, elinizde olmayan bir ürünün satılmasına yol açabilir.

Bir n11 entegrasyon programı bu noktada işe yarar: ürün bilgisi tek yerde tutulur, n11'e API ile gönderilir, siparişler geri okunur ve stok bütün kanallarda buna göre düşer. Aşağıdaki durumlardan ikisi ya da daha fazlası sizin için geçerliyse entegrasyonu düşünmenin zamanı gelmiştir:

• Aynı ürünü n11'in yanında Trendyol'da ya da kendi sitenizde de satıyorsunuz; bu durumda Trendyol entegrasyonu ile aynı stok kartını iki kanala bağlamak mantıklı olur.
• Beden, renk gibi seçenekleri olan varyantlı ürünleriniz var ve her varyantın stoğunu ayrı takip etmeniz gerekiyor.
• Günde birkaç siparişten fazlasını hazırlıyorsunuz ve hazırlık süresini kaçırma riskiniz artıyor.
• Komisyon ve kargo kesintilerini sipariş bazında kontrol edemiyorsunuz.

n11 API anahtarı nasıl alınır?

n11 API entegrasyonu için iki bilgiye ihtiyacınız var: API Key (anahtar) ve API Secret (şifre). n11'in açıklamasına göre bu bilgileri, mağaza hesabınıza yüklediğiniz evrakların süreçleri tamamlandıktan sonra oluşturabilirsiniz. Yani mağaza başvurunuz ve evrak onayınız bitmeden entegrasyon kurulamaz. Adımlar şöyle:

1. n11 mağaza yönetim panelinize (Seller Office / Satıcı Ofisi) giriş yapın.
2. Hesabım > API Hesapları sekmesini açın.
3. Yeni Hesap Oluştur düğmesine tıklayın. API anahtarı aynı ekranın alt bölümündeki hesap listesinde görünür; API şifresi mağazanıza kayıtlı e-posta adresine gönderilir.
4. API Key ve API Secret bilgilerini eticaretcim panelindeki n11 bağlantı ekranına girin.
5. Bağlantı doğrulandıktan sonra mevcut ilanlarınız panele okunur ve barkod ya da stok koduyla eşleştirilir.

Eşleştirme bittikten sonra hiçbir ilanınız siz onaylamadan değişmez: hangi ürünlerin stok ve fiyatının yazılım tarafından yönetileceğine siz karar verirsiniz. İsterseniz bu ilk kurulumu ekibimizle birlikte yapabilirsiniz.

n11 kategori eşleştirme ve katalog kontrolü

n11 entegrasyonunda en çok zaman alan iş ürünü göndermek değil, kategori eşleştirmedir. n11, ürün aktarımına başlamadan önce kendi kategori ve kategori özelliklerinin çekilip sizin sisteminizdeki özelliklerle eşleştirilmesini istiyor. Zorunlu özellikler kategoriye göre değişir; eksik gönderilen zorunlu alan, aktarım sırasında hata olarak geri döner.

Barkod ile katalog eşleşmesi

Yüklediğiniz ürünün barkodu n11 kataloğunda aranır; ürün katalogda varsa bilgiler otomatik eşleştirilir. Katalogdaki bazı ürün bilgilerini kendiniz değiştiremezsiniz; düzeltme için ürün sayfasındaki Hata Bildir / Güncelleme Talep Et seçeneğiyle talep açmanız gerekir. Bu yüzden her varyantta doğru GTIN/barkod şarttır. Kendi ürettiğiniz ürünler için GTIN'i, GS1'i Türkiye'de temsil eden TOBB'a başvurarak alabilirsiniz.

n11 Aksiyon Bekleyenler sekmesindeki hata etiketleri

Kontrole takılan ürünler Ürün Yönetimi > Aksiyon Bekleyenler sekmesinde bir hata etiketiyle listelenir ve ancak sizin onayınızla satışa açılır:

n11 ürün başlığı uzunluğu ve varyant sınırı

n11'de başlık ve alt başlık en az 15, en çok 65 karakter olmalıdır; bu aralığın dışında kalan yeni ürünler yüklenmez. Varyantlı ürünlerde en fazla 5 seçenek (ör. beden, renk) kullanılabilir; seçeneklere tanımlanan değerlerin sayısında ise sınır yoktur.

n11 stok entegrasyonu ve fiyat güncellemesi nasıl çalışır?

n11 stok entegrasyonu tek bir stok kartı üzerinden çalıştığında en güvenli hâlini alır: n11'de, başka bir pazaryerinde ya da sitenizde gelen her sipariş aynı stoktan düşer ve yeni miktar bütün kanallara gönderilir. Bunun nasıl kurgulandığını stok ve fiyat senkronu sayfasında ayrıntılı görebilirsiniz. 5'li, 10'lu paketler ya da setler satıyorsanız bunları ayrı stokla değil, tek stok biriminden düşecek şekilde tanımlamak sayım farklarını baştan önler.

n11 için kanal başına fiyat farkı: örnek hesap

n11'deki komisyon ve kargo maliyetiniz diğer kanallardan farklı olabilir. Fiyatı her kanalda elle değiştirmek yerine ana fiyata kanal başına yüzde ya da tutar farkı tanımlamak işinizi kolaylaştırır. Örneğin ana fiyatı 500 TL olan bir ürüne n11 için %8 fark tanımlarsanız n11 fiyatı 540 TL olur; ana fiyatı 550 TL'ye çektiğinizde n11 fiyatı kendiliğinden 594 TL'ye güncellenir.

Fiyatın n11'e yansımadığı durumlar

• Ürününüz n11'de bir kampanyadaysa fiyat değişikliği yapılamaz; n11 bu durumda talep açmanızı istiyor.
• Ürün Komisyon Teklifleri'ne yalnız Seller Office'teki Ürün Komisyon Teklifleri sayfasından katılabilirsiniz; başka ekranlardan ya da entegrasyondan yapılan fiyat güncellemesi teklife katılım sayılmaz.
• n11'de bir fiyat güncelleme limiti vardır; limitin artırılması için panelden talep açabilirsiniz.
• Yeni yüklenen üründe olağan dışı fiyat tespit edilirse ürün, Hatalı Fiyat Şüphesi etiketiyle onayınızı bekler.

Reddedilen bir güncellemenin sebebini eticaretcim'deki senkron sağlığı ekranında görürsünüz. Çok kanallı stokta dikkat etmeniz gereken diğer noktaları aşırı satışı önleme rehberimizde topladık.

n11 sipariş entegrasyonu: kargo ve fatura akışı

n11'de hazırlık süresi, ürünün kargoya verilmesi için tanınan süredir. Bu süre içinde kargolanmayan siparişler geciken kargolamaya düşer ve mağaza puanınızı olumsuz etkiler. Sipariş yönetimi ekranında n11 siparişleri diğer kanallarla aynı listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarıyla görünür; geciken siparişler için ayrıca uyarı alırsınız.

Teslimat şablonu ve kampanya numarası

n11'in anlaşmalı kargo fiyatlarından yararlanmak için panelde teslimat şablonu tanımlamanız gerekir. Şablonda depo adresini, kargo firmasını, iade/değişim kargosunu ve kargo ücreti tipini seçersiniz. Kargo ücretini sizin ödediğiniz gönderiler için Mağaza Öder; belirlediğiniz sipariş tutarı ya da ürün adedinin altındaki gönderimlerde ücreti alıcının ödediği durumlar için Şartlı Ödeme seçilir. Gönderim şu sırayla yapılır:

1. Gelen siparişi onaylayın.
2. Siparişin yanındaki Kargo Şablonu bağlantısından çıktı alıp pakete yerleştirin.
3. Paketi kargo şablonuyla ya da şablondaki kampanya numarasıyla ilgili kargo firmasına teslim edin.
4. Kargo firması kampanya numarasıyla faturayı kestiğinde takip numarası güncellenir ve sipariş otomatik olarak Kargolandı statüsüne geçer.

n11'e göre kampanya numarası kullanılmadan yapılan gönderimler geciken kargolama statüsüne geçer. Kendi kargo sözleşmenizle çalışmak isterseniz kargo entegrasyonu ile etiketi panelden basıp takip numarasını n11'e iletebilirsiniz. Fatura tarafında ise siparişe otomatik e-Arşiv ya da e-Fatura düzenleyen ve kanal destekliyorsa PDF'i pazaryerine yükleyen e-Fatura ve e-Arşiv entegrasyonu devreye girer.

n11 komisyon, kargo kesintisi ve hakediş kontrolü

n11 komisyon oranları kategoriye göre değişir ve zaman içinde güncellenir; güncel oranı Mağaza Destek Merkezi'ndeki Komisyon Oranları sayfasından ve kendi panelinizden kontrol edin. Hakediş ödeme takvimi de mağaza sözleşmenize göre panelde görünür. Bu bilgi değişebildiği için burada sabit bir gün vermiyoruz.

Mağaza Öder olarak gönderilen siparişlerin kargo ücretleri sipariş bazında hesabınızdan düşülür ve ay sonunda toplu olarak faturalanır. Kesilen kg/desi ve ücretleri Sipariş Yönetimi > Kargo Ücret Kesintisi ekranında görebilir, n11'in açıklamasına göre 24 saat içinde itiraz edebilirsiniz. Alıcı siparişi kapıda iade ederse ya da kargo teslim edilemezse kargo bedelinin %50'si tutarında ücret alınır. İtiraz süresi kısa olduğu için kesintileri her gün gözden geçirmek gerekir. Kontrol ederken şu sorulara bakın:

• Kesilen komisyon, kategorinin güncel oranıyla uyuşuyor mu?
• Kargo desisi ürün kartındaki ölçülerle tutarlı mı?
• Teslim edilen siparişin ödemesi beklenen dönemde hesaba geçmiş mi?
• Kampanya döneminde hangi siparişler zarar yazdı?

Bu soruları Excel'de tek tek cevaplamak yerine hakediş ve komisyon kontrolü ile sipariş bazında net kârı, fazla komisyonu, fazla kargo kesintisini ve ödenmeyen hakedişi tek raporda görebilirsiniz.

n11 entegrasyonu kurulum kontrol listesi ve sık yapılan hatalar

n11 entegrasyonunu kurmadan önce aşağıdaki listeyi tamamlamak, ilk gönderimde alacağınız hataları azaltır:

• Evrak onayı tamamlandı, API Key ve API Secret oluşturuldu.
• Her ürün ve her varyant için doğru barkod ve tekil stok kodu girildi; aynı stok kodu iki farklı üründe kullanılmıyor.
• Başlıklar 15-65 karakter aralığında, kategorinin zorunlu özellikleri dolu.
• Teslimat şablonu tanımlandı, ürünlerdeki hazırlık süreleri gerçek kargolama hızınıza uygun.
• Kampanyadaki ürünler belirlendi; bu ürünlerde fiyat güncellemesinin kampanya bitene kadar n11'e yansımayacağı biliniyor.
• n11 için tanımlanan kanal fiyat farkı, komisyon ve kargo maliyetini karşılıyor.

Kurulumda en sık yapılan hatalar şunlardır: ürün eşleştirmesi bitmeden stok senkronunu açmak, varyant barkodlarını ana ürünle aynı girmek ve Aksiyon Bekleyenler sekmesini haftalarca kontrol etmemek. Çok geniş kataloglarda bir kural daha var: 100.000'den fazla ürünü olan mağazalarda, en az bir kez sipariş almış ve en son güncellenen 100.000 ürün satışta kalır; bunun üzerindeki ürünler Listeleme Paketi alınmazsa Limit Dışı statüsüne geçer ve satışa kapanır.

Yalnız n11 ile başlamak isterseniz Başlangıç paketinde tek kanal olarak n11'i seçebilirsiniz; paket ayrıntıları fiyatlar sayfasında. 3 günlük ücretsiz deneme süresinde ürünlerinizi bağlayıp eşleştirmenin kendi kataloğunuzda nasıl göründüğünü inceleyebilirsiniz.