n11 Entegrasyonu Nasıl Yapılır? Adım Adım 2026

Bu yazıda

Kısa cevap: n11 entegrasyonu nasıl yapılır?
Başlamadan önce hazırlayın
Adım 1: API hesabını açın
Adım 2: Teslimat şablonunu hazırlayın
Adım 3: Bilgileri programa girin ve bağlantıyı test edin
Adım 4: Kategorileri eşleştirin, ürünleri gönderin
Sipariş ve fatura bağlantısı
Sık görülen hata mesajları ve anlamları
Güvenlik: API bilgilerini kim görmeli?
Webtegra'ya n11 mağazası bağlamak
Sık sorulanlar
Kaynaklar

n11'de satıyorsunuz ya da yeni mağaza kampanyasıyla n11'e yeni geldiniz ve siparişleri, stoğu, faturayı diğer mağazalarınızla aynı programdan yönetmek istiyorsunuz. Programın ilk istediği şey n11 API bilgileriniz olur. n11'de bu bilgiler için önce panelden bir API hesabı açarsınız; n11'e göre bilgiler mağazanızın kayıtlı e-posta adresine gönderilir.

Entegrasyonun genel mantığını pazaryeri entegrasyonu nedir yazısında anlattık. Bu yazıda n11 entegrasyonunu dört adımda topladık: API hesabını açmak, teslimat şablonunu hazırlamak, bilgileri programa girmek ve ürünleri eşleştirmek. Ardından onay bekleyen ürünler, sipariş ve fatura bağlantısı, sık görülen hata mesajları ve güvenlik geliyor. Bütün n11 adımları n11 Mağaza Destek Merkezi'nden ve n11'in geliştirici dokümanından, 5 Kasım 2026'da okundu.

Kısa cevap: n11 entegrasyonu nasıl yapılır?

Mağaza üyeliğinizin ve yüklediğiniz evrakların süreçlerinin tamamlandığından emin olun. n11'e göre API bilgileri bundan sonra oluşturulabilir.
n11 mağaza panelinde Hesabım > API Hesapları sekmesini açıp "Yeni Hesap Oluştur" düğmesine tıklayın.
API Key ve API Secret bilgileri mağazanıza kayıtlı e-posta adresine gelir. İkisini entegrasyon programınızın n11 mağaza ayarına girin.
Hesabım > Teslimat Bilgilerim alanında teslimat şablonunuzu oluşturun. Programdan gönderilen her üründe bu şablonun adı istenir.
n11 kategorilerini ve kategori özelliklerini kendi ürünlerinizle eşleştirin, sonra ürünleri gönderin. Onayınızı bekleyen ürünleri Ürün Yönetimi > Aksiyon Bekleyenler sekmesinde kontrol edin.

Başlamadan önce hazırlayın

Onaylı bir n11 mağazası. Üyelik, KEP doğrulaması ve ana kategori seçimi n11'de mağaza açma yazısında. Yeni mağaza kampanyasına katılacaksanız 90 günün katılım onayıyla başladığını hatırlayın; entegrasyonu onaydan önce bitirmek, kampanya günlerini kurulumla harcamamanızı sağlar.
Mağazanın kayıtlı e-posta adresine erişim. n11 API bilgilerini bu adrese gönderir.
Teslimat şablonu. Depo adresi, iade ve değişim adresi, kargo ücreti ve satış sonrası servis bilgisi bu şablonda durur.
Tekil stok kodları. n11'de stok ve fiyat güncellemesi ürünün stok koduyla (stockCode) yapılır. Her varyantın kendi stok kodu olmalı; aynı stok kodu iki üründe kullanılırsa n11 hata verir. Terimin ayrıntısı SKU maddesinde.
Başlık ve görseller. Ürün adı 15 ile 255 karakter arasında olmalı. Görsel bağlantıları herkese açık olmalı ve her görsel 10 MB'ı geçmemeli.

Adım 1: API hesabını açın

n11'in anlatımına göre mağaza hesabınıza yüklediğiniz evraklara ait süreçler tamamlandıktan sonra API Key ve API Secret bilgilerinizi mağaza panelinden oluşturabilirsiniz. Bunun için Hesabım > API Hesapları sekmesine gidip "Yeni Hesap Oluştur" düğmesine tıklarsınız. Oluşan API hesap bilgileri mağazanıza kayıtlı e-posta adresine gönderilir. Ardından entegrasyon programına girip n11 mağazanızı bu bilgilerle bağlarsınız.

n11'in geliştirici dokümanına göre programlar n11'e yaptıkları her istekte bu iki bilgiyi gönderir. Yani API Key ve API Secret birlikte mağazanızın ürünlerine, stoğuna, fiyatına ve siparişlerine erişim demektir. Bilgileri ekran görüntüsüyle ya da mesajla paylaşmayın; programa kendiniz girin. Terimin ayrıntısı API anahtarı maddesinde.

API Hesapları sekmesinde hesap açamıyorsanız önce evrak sürecinizin tamamlanıp tamamlanmadığını kontrol edin. Durum belirsizse panelden talep açıp n11'e sorun.

Adım 2: Teslimat şablonunu hazırlayın

n11'de teslimat şablonu, ürün eklerken Teslimat Bilgisi sekmesinde seçtiğiniz hazır adres ve kargo düzenidir. Şablonda teslimat metodu, depo adresi, iade ve değişim adresi, kargo ücreti, teslimat ve iade bilgileri ile satış sonrası servis bilgileri girilir.

Entegrasyonda bu şablon zorunludur. n11'in ürün yükleme servisi her ürün için şablonun adını ve ürünün kargoya verilmesi için gereken süreyi (hazırlık süresi) ister. Şablonu Hesabım > Teslimat Bilgilerim alanında oluşturur, adını programınıza panelde yazdığınız hâliyle girersiniz. Ad tutmazsa ürün aktarımı "shipmentTemplate alanı geçersizdir" hatası alır.

Adım 3: Bilgileri programa girin ve bağlantıyı test edin

Programın n11 mağaza ekranına API Key ve API Secret bilgilerini girin. Sonra bağlantıyı üç denemeyle doğrulayın:

Sipariş: Son birkaç günün siparişleri programa düştü mü?
Stok: Programda bir ürünün stoğunu değiştirin; bir süre sonra n11 panelinde aynı rakamı görün.
Fiyat: Düşük satışlı bir üründe fiyatı değiştirip panelde kontrol edin, sonra geri alın.

Değişiklik panelde hemen görünmeyebilir. n11 ürün yükleme ve stok-fiyat güncelleme isteklerini bir iş (task) olarak sıraya alır; programlar işin sonucunu ayrıca sorgular. Sonuç ürün bazında başarılı ya da başarısız döner ve başarısız olanın gerekçesi yazılır. Programınız bu gerekçeyi ekranda göstermiyorsa destek ekibinden isteyin.

n11'in geliştirici dokümanındaki kurallar, bir programın n11 tarafında neye uyması gerektiğini gösterir:

Konu	n11'in kuralı
Ürün yükleme ve stok-fiyat güncelleme	Tek istekte 1.000 ürüne (SKU) kadar; istek sıraya alınır, sonucu ayrıca sorgulanır
Fiyat	Liste fiyatı ve satış fiyatı birlikte gönderilir; liste fiyatı satış fiyatına eşit ya da ondan yüksek olmalı
Kampanyadaki ürün	Kampanya sürerken fiyat değiştirilemez; değişiklik için panelden talep açılır
Sipariş listeleme	Dakikada 1.000 isteğe kadar; tek sorguda 15 günlük kayıt; Kasım 2024 öncesi siparişler bu servisten verilmez
Görsel	Görsel başına 10 MB'a kadar
Fatura bağlantısı	Sipariş başına bir etkin bağlantı; HTTPS ile başlar, PDF, PNG ya da JPEG gösterir

Adım 4: Kategorileri eşleştirin, ürünleri gönderin

n11'e göre ürünleri yüklemeden önce n11 kategori ve kategori özelliklerini çekip kendi ürün bilgilerinizle eşleştirmeniz gerekir; ürün aktarımına bundan sonra başlamanız önerilir. Zorunlu özellikler kategoriye göre değişir ve eksik gönderilirse aktarım hata alır. Hata mesajına göre düzeltip ürünü yeniden gönderirsiniz.

Eşleştirmede üç noktaya dikkat edin:

Son kırılım kategori. n11, ürünün kategori ağacının son kırılımındaki kategoriye gönderilmesini istiyor. "Ayakkabı" yetmez; ürün o dalın son alt kategorisine eşlenir.
Listeden seçilen özellikler. Bazı özelliklerde yalnız n11'in kendi değer listesinden seçim yapılabilir, bazılarında serbest değer yazılabilir. Sizin "lacivert" yazdığınız renk n11'de listeden seçilen bir özellikse, o değeri n11'deki karşılığıyla eşlemeniz gerekir.
Varyantlar. Aynı ürünün renk ve beden seçenekleri aynı model koduyla (productMainId) gönderildiğinde n11'de tek sayfada seçenek olarak görünür. Ayrıntısı varyant maddesinde.

n11'de zaten satışta olan ürünleriniz varsa stok kodlarına bakın. Güncellemeler stok koduyla yapıldığı için programdaki ürün kartının stok kodu n11'deki ilanla aynı olmalı. Aynı stok koduyla yeniden ürün yüklemeye çalışırsanız n11 bu kodun sizin tarafınızdan zaten kullanıldığını söyleyen bir hata verir.

Onay bekleyen ürünler

Barkodu n11 kataloğundaki bir ürünle eşleşen yeni ürün, n11'e göre satıcı onayı bekleyerek açılır. Yüklediğiniz ürünler aşağıdaki etiketlerle Ürün Yönetimi > Aksiyon Bekleyenler sekmesine düşebilir ve sizin onayınızla satışa açılır:

Etiket	Anlamı	Ne yapmalı
Hatalı Eşleşen Kategori	Barkod katalogda bulundu ama yüklediğiniz kategori farklıydı; ürün doğru kategoriye taşındı	Kategoriyi kontrol edip onaylayın
Hatalı Fiyat Şüphesi	Fiyatta olağan dışı bir durum görüldü	Fiyat doğruysa onaylayın, değilse düzeltin
Katalogda Eşleşen Ürün	Aynı ürün n11 kataloğunda zaten var	İnceleyip onaylayın; ürün mükerrer diye reddedilmez
Katalogda Eşleşen Benzer Ürün	Ürün adı katalogdaki bir ürüne çok benziyor	Doğru ürün olduğunu kontrol edip onaylayın
Marka Eşleşmesi	Marka katalogdaki bir ürünle örtüşüyor	Kontrol edip onaylayın
Eşleşme Bekleyen Ürün	İlanınız katalogdaki bir ürünle eşleşmemiş; genellikle silinip talebinizle geri yüklenen ürünler	Katalogdaki ürünle eşleştirin

Onaylayacağınız ürünlere Toplu İşlemler filtresinden toplu onay verebilirsiniz. Katalogdan reddedilen ürünler Ürün Yönetimi > Ürün Listesi sayfasındaki Katalogdan Reddedilen sekmesinde, ret nedeniyle birlikte görünür.

Sipariş ve fatura bağlantısı

Sipariş onayı. n11'e göre gelen siparişe onay verdiğinizde sipariş kargoya hazır hâle gelir; ardından faturayı düzenleyip gönderimi başlatırsınız. Siparişi kimin ve hangi ekrandan onaylayacağını baştan belirleyin; aynı siparişi hem panelden hem programdan işlemek karışıklık yaratır.
Paket numarası. n11'de paket numarası, kargo kampanya kodu anlamına gelir ve siparişleri panelde bu numarayla da arayabilirsiniz. ERP ya da muhasebe programınız paket numarasıyla çalışıyorsa eşleştirmeyi bu numarayla kurun.
Fatura bağlantısı. n11 her siparişe bir etkin fatura bağlantısı kaydeder; yeniden gönderilen bağlantı öncekinin yerine geçer. Bağlantı HTTPS ile başlamalı ve PDF, PNG ya da JPEG dosyasını göstermeli. Yurt dışına satılan e-ihracat siparişlerinde n11 fatura numarasını ve tarihini de ister.
Eski siparişler. n11'in sipariş servisi Kasım 2024 öncesindeki siparişleri vermez. Programın ilk bağlantıda bu tarihten önceki siparişleri çekmesini beklemeyin.

Sık görülen hata mesajları ve anlamları

Hata mesajı (kısaltılmış)	n11'in açıklaması	Ne yapmalı
"shipmentTemplate alanı geçersizdir"	Teslimat şablonu adı geçersiz	Panelde geçerli bir şablon seçin, adını programa aynen yazın
"... özellik alanı boş olamaz"	Kategorinin zorunlu özelliği gönderilmemiş	Kategori özelliklerini kontrol edip eşleştirin
"category alanı geçersizdir"	Ürünün eşlendiği kategori n11'de kapanmış	Kategori eşleştirmesini yenileyin
"Ürün adı minimum 15 karakter olmalıdır"	Başlık 15 karakterden kısa	Başlığı uzatın; 255 karakteri geçmesin
"... aynı barcode kullanılmıştır"	Aynı barkod birden çok üründe	Her ürüne kendi barkodunu verin
"Farklı ürünlerinizde aynı Stok Kodu kullanılmıştır"	Aynı stok kodu birden çok üründe	Stok kodlarını tekil yapın
"vatRate ... 0,1,10,20 değerlerinden biri olmak zorundadır"	KDV oranı geçersiz	Ürünün KDV oranını bu değerlerden biriyle gönderin
"fahiş fiyat düşüklüğü" ya da "fahiş fiyat artışı"	Fiyat izin verilen aralığın dışında	Fiyatı kontrol edin
"listPrice salePrice dan küçük olamaz"	Liste fiyatı satış fiyatından düşük	Liste fiyatını satış fiyatına eşit ya da ondan yüksek yazın
"All Images are invalid"	Görseller geçersiz ya da erişilemiyor	Görsel bağlantılarının herkese açık ve çalışır olduğunu kontrol edin
"... SellerStockCode ile mağazanızda ürün bulunamamaktadır"	Güncellenen stok kodunda ürün yok	Önce ürünü yükleyin ya da stok kodunu düzeltin
"Ürünü yalnızca onaylı ve beklemede statülerini seçerek güncelleyebilirsiniz"	Ürün katalog onayındayken güncellenemez	Onay bitince yeniden deneyin

Mesajların tam listesi n11'in geliştirici sitesindeki API Hata Mesajları ve Açıklamaları sayfasında. Excel ile toplu yüklemede aldığınız hatalar da aynı açıklamalara bağlanır.

Güvenlik: API bilgilerini kim görmeli?

Bilgiler e-postayla gelir. Mağazanın kayıtlı e-posta adresi ortak bir kutuysa API Key ve API Secret'ı kimlerin görebildiğini bilin.
Panel şifresini paylaşmayın, alt hesap açın. n11'e göre Hesabım > Alt hesaplar sekmesinden mağaza yönetimini yapan kişilere ayrı kullanıcı tanımlayabilirsiniz. Tanımlanan kişi kendi kullanıcı adıyla, telefonuna gelen tek kullanımlık kodla girer; 20 hesaba kadar açılabilir.
Bıraktığınız programın erişimini kapatın. n11'in Mağaza Destek Merkezi'ndeki sorularda API hesabının nasıl kapatılacağı ya da yenileneceği anlatılmıyor (5 Kasım 2026). Programı bıraktığınızda ya da bilgiler yanlış kişiye gittiğinde panelden talep açıp n11'e sorun. Program değiştirirken izlenecek sıra entegrasyon programı değiştirme yazısında.
Stok ve fiyatı tek programdan gönderin. İki program aynı ürüne farklı rakam gönderirse son gelen geçerli olur. Ayrıntısı stok senkronizasyonu maddesinde.

Webtegra'ya n11 mağazası bağlamak

Webtegra'da sıra şöyledir: kayıt olur, firma ayarlarınızı yapar, Entegrasyon API ayarları ekranına n11'deki API Key ve API Secret bilgilerinizi girersiniz. Ardından marka ve kategori eşleştirmesini yapar, ürün kartlarınızı n11 ilanlarına bağlarsınız. Ürünleriniz başka bir pazaryerinde zaten satıştaysa onları Excel, XML, bağlantı ya da pazaryeri kataloğundan n11'e topluca aktarırsınız. Her adımın videosu eğitim sayfasında. İsterseniz destek ekibi uzaktan bağlanarak kurulumu sizinle birlikte yapar; yerinde kurulum yapılmaz.

Bağlantıdan sonra n11 siparişleri diğer pazaryerlerinizin siparişleriyle aynı listeye düşer, stok bütün mağazalarda aynı ürün kartından düşer (stok yönetimi), fatura siparişten kesilip bağlantısı n11'e gönderilir. Neler eşitlendiği n11 entegrasyonu sayfasında. n11'in komisyonu ve iki hizmet bedelinden sonra bir satışın ne bıraktığını n11 komisyon ve kâr hesaplama aracında görebilirsiniz.

Kullandıkça Öde paketinde aylık sabit ücret yok, sipariş başı 3 TL (KDV dahil) ödersiniz. Mikro, KOBİ ve Kurumsal paketlerde 3 ay koşulsuz iade imkânı var.

Sık sorulanlar

n11 API Key ve API Secret nereden alınır?

n11 mağaza panelinde Hesabım > API Hesapları sekmesinde "Yeni Hesap Oluştur" düğmesiyle oluşturulur. Bilgiler mağazanıza kayıtlı e-posta adresine gönderilir. n11'e göre bu işlem, yüklediğiniz evrakların süreçleri tamamlandıktan sonra yapılabilir.

n11 entegrasyonunda teslimat şablonu neden zorunlu?

n11'in ürün yükleme servisi her ürün için bir teslimat şablonu adı ve hazırlık süresi ister. Şablonu Hesabım > Teslimat Bilgilerim alanında oluşturur, adını programınıza panelde yazdığınız hâliyle girersiniz.

Ürünlerim n11'e yüklendi ama neden satışa açılmadı?

Barkodu, adı ya da markası n11 kataloğundaki bir ürünle eşleşen ürünler onayınızı bekler. Ürün Yönetimi > Aksiyon Bekleyenler sekmesindeki etiketleri kontrol edip onay verin. Katalogdan reddedilen ürünleri Ürün Listesi'ndeki Katalogdan Reddedilen sekmesinde, ret nedeniyle görürsünüz.

Kampanyadaki ürünün fiyatı neden güncellenmiyor?

n11'e göre ürün kampanyadayken fiyatı değiştirilemez. Fiyatı güncellemek istiyorsanız panelden talep açarsınız.

Eski n11 siparişlerim programa neden gelmedi?

n11'in sipariş listeleme servisi Kasım 2024 öncesindeki siparişleri vermez. Program bu tarihten önceki siparişleri n11'den çekemez.

Entegrasyondan sonra n11 panelinden stok değiştirebilir miyim?

Teknik olarak değiştirebilirsiniz, ama bir sonraki eşitleme paneldeki değişikliğin üzerine yazar. Stoğu ve fiyatı yalnız entegrasyon programından değiştirin.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Adımlar 5 Kasım 2026 itibarıyla n11 Mağaza Destek Merkezi'nden ve n11 geliştirici dokümanından derlendi; panel menü adları değişebilir. Fatura ve e-ihracat ayarlarınız için mali müşavirinize danışın.

n11 Entegrasyonu Nasıl Yapılır? API Hesabı, Teslimat Şablonu ve Ürün Eşleştirme