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

n11 entegrasyonu nedir, n11 ürünleri hangi yollarla kabul ediyor?

n11 entegrasyonu, mağazanızın ürün, stok, fiyat ve sipariş verisini n11'in satıcılara açtığı API üzerinden bir yazılımla karşılıklı olarak güncel tutmasıdır. n11 ürün listelemek için üç yöntem tanımlar: elle yükleme, Excel ile toplu yükleme ve API entegrasyonu. İlk ikisi tek seferlik yükleme için yeterlidir; ancak aynı ürün başka bir kanalda da satılıyorsa Excel dosyası yüklendiği gün eskir. Değişikliği satış anında karşı tarafa taşıyan yöntem yalnız API'dir.

n11 API'sinde 2024–2026 arasında neler değişti?

n11, satıcı entegrasyonlarını eski SOAP servislerinden REST yapısına taşıdı; eskiden kurulmuş bir bağlantının bugün kısmen çalışmamasının en yaygın sebebi budur. n11 Developer değişiklik kaydındaki önemli tarihler:

• 4 Nisan 2024: Stok-fiyat ve ürün güncelleme REST'e geçti; tek istekte 1.000 SKU gönderiliyor, her işlem için sorgulanabilir bir görev numarası dönüyor.
• 25 Aralık 2024: Sipariş listeleme, onaylama ve bölme REST'e taşındı; siparişler paket mantığıyla izleniyor.
• 25 Ocak 2025: Eski SOAP stok ve fiyat servisleri kapatıldı; alıcı, sipariş kargoya verilene kadar doğrudan iptal edebiliyor.
• 15 Ağustos 2025: Kategori servisleri API anahtarı ve şifresi olmadan yanıt vermiyor.
• 15 Ekim 2025: T.C. kimlik numarası zorunluluğu kalktı; bu alan siparişte boş gelebiliyor.
• 8 Haziran ve 3 Ağustos 2026: E-ihracat siparişleri ve teslimat noktasına giden siparişler için sipariş servisine yeni alanlar eklendi.

Bir n11 entegrasyon programı seçerken bu değişikliklere uyum sağlanıp sağlanmadığını sorun.

n11'de satıcı olma şartları ve API erişimi için gerekenler

n11'de Türkiye Cumhuriyeti vergi numarası, e-posta adresi ve banka hesabı olan şirketler satış yapabilir; üyelik ücretsizdir. n11, üyelikte evrak istemediğini, bilgilerin Gelir İdaresi Başkanlığı kayıtlarıyla karşılaştırıldığını belirtir. Entegrasyondan önce şu şartlar tamamlanmalıdır:

Üyelik ücretsiz olsa da her tamamlanan satıştan kategori komisyonu ve iki ayrı hizmet bedeli kesilir; hesabını komisyon bölümünde örnekle açıyoruz.

n11 entegrasyonu Yox İş Ortağım'da adım adım nasıl kurulur?

Kurulum, API bilgilerini girmekle başlar ve ürünlerin n11 kategori özelliklerine eşleşmesiyle biter; zamanın çoğunu ikinci kısım alır. Yox İş Ortağım'da sıra şöyledir:

1. n11 Satıcı Ofisi'nde Hesabım > API Hesapları ekranından yeni bir API hesabı oluşturun; anahtarı ekrandan, şifreyi kayıtlı e-postanızdan alın.
2. Bu iki bilgiyi Yox İş Ortağım'daki n11 bağlantı ekranına girin; mevcut n11 ilanlarınız panele gelir.
3. İlanlar ürün kartlarınızla barkod ya da stok koduyla eşleştirilir. Siz onaylamadan hiçbir ilan değişmez; toplu değişiklikten önce neyin değişeceği size gösterilir.
4. n11'de ilanı olmayan ürünlerin kartını n11 kategorisine ve özelliklerine eşleştirin; beden, renk gibi varyantlar tek karttan yönetilir.
5. Eşleştirme bitince stok, fiyat ve sipariş senkronunu açın.

İsterseniz bu adımları ekibimizle birlikte yapıyoruz; ön görüşme için iletişim sayfasından yazabilirsiniz.

Kategori özellikleri: zorunlu alan, sabit değer ve varyant

n11, ürünün kategori ağacının en alt kırılımına gönderilmesini ve kategori özelliklerinin önceden eşleştirilmesini ister. Üç işaret belirleyicidir: zorunlu işaretli özellik boş bırakılamaz; serbest değere kapalı özellikte yalnız n11'in değer listesinden seçim yapılır; varyant işaretli özellikte aynı ana ürün koduyla gönderilen ürünler tek sayfada seçenek olarak görünür. Bir üründe en fazla 5 seçenek kullanılabilir.

Barkod, stok kodu ve görsel kuralları

• Stok kodu her ürüne özgü olmalı, en çok 255 karakter olabilir; n11 stok ve fiyatı bu koda göre işler.
• Barkod alanına yalnız ulusal barkodlar kaydedilir; barkod n11 kataloğundaki bir ürünle eşleşirse ilan satıcı onayı bekleyen statüde açılır.
• Başlık ve alt başlık 15–65 karakter olmalıdır; uzun başlıkları başlık optimizasyon aracıyla kısaltabilirsiniz.
• Görsel adresleri HTTPS olmalı, her görsel en fazla 10 MB olabilir.
• Kendi ürettiğiniz ürünler için GTIN, GS1'in Türkiye temsilcisi TOBB'dan alınır.

n11 stok ve fiyat senkronu hangi kurallara uyar?

n11'de stok ve fiyat, stok kodu üzerinden toplu görevler hâlinde güncellenir; bir istekte en fazla 1.000 SKU gönderilir ve sonuç ayrıca sorgulanır. n11 görevi önce sıraya alır, ardından her SKU için başarılı ya da hatalı sonucu bildirir. Yox İş Ortağım'da satış hangi kanaldan gelirse gelsin stok aynı ürün kartından düşer ve n11'e gönderilir; Trendyol entegrasyonunu aynı karta bağladığınızda son ürünün iki kanalda birden satılmasının önüne geçilir.

Fiyat güncellemesinin reddedildiği durumlar

• Liste fiyatı ve satış fiyatı birlikte gönderilmelidir; liste fiyatı satış fiyatının altında olamaz, ikisi eşit olabilir.
• Kuruş ayracı nokta olmalı ve noktadan sonra iki hane yazılmalıdır; virgül görevi başarısız kılar.
• Kampanyadaki ürünün fiyatı değiştirilemez; n11 bunun için talep açmanızı ister.
• Mağazanın bir fiyat güncelleme limiti vardır; artırılması için talep açılır.
• Düşük komisyonlu ürün tekliflerine katılım Satıcı Ofisi'ndeki kendi ekranından yapılır; API'den gelen fiyat bu katılımı sağlamaz.

Kanal bazında fiyat kuralı nasıl kurgulanır?

n11'deki komisyon ve kargo yükünüz diğer kanallardan farklıysa fiyat kurallarını kanal bazında tanımlarsınız. Örneğin 1.200 TL'lik ürüne n11 için %10 fark tanımlandığında n11'e 1.320 TL gider; ana fiyat 1.300 TL olunca n11 fiyatı 1.430 TL'ye güncellenir. Kampanyadaki üründe yeni fiyat kampanya bitene kadar n11'e yansımaz.

n11 sipariş akışı: statüler, onay, iptal ve fatura

n11 siparişleri REST servisinde paket bazında ve statüyle izlenir. Yox İş Ortağım'da n11 siparişleri diğer kanallarla aynı listeye düşer; hazırlanıyor, kargoda, teslim edildi aşamaları tek ekranda görünür. n11 tarafındaki karşılıklar şunlardır:

n11, onayı sipariş kalemlerinin Picking statüsüne çekilmesiyle alır. Stok bulunmaması siparişi reddetmek için haklı gerekçe sayılmaz; n11 sözleşmesi ret başına ürün bedeline göre 10 TL ile 250 TL arasında ceza öngörür. Stoğu bütün kanallarda doğru tutmak bu yüzden doğrudan maliyet konusudur.

Teslimat noktası, e-ihracat ve fatura bağlantısı

Ağustos 2026'dan beri teslimat noktasına giden siparişlerde adres alanında noktanın adresi gelir; alıcının adı ve iletişim bilgisi fatura adresinden okunur. E-ihracat siparişlerinin faturası ihracat faturası olarak düzenlenip numarası ve tarihiyle n11'e bildirilmelidir. Yurt içi siparişlerde n11, faturanın HTTPS bağlantısını (PDF, PNG ya da JPEG) siparişe eklemeyi kabul eder. Yox İş Ortağım'da e-Arşiv ya da e-Fatura belgesi bağlı muhasebe programınızdan kesilir; e-Fatura bağlantısı Profesyonel paketle başlar.

n11 kargo düzeni: teslimat şablonu, kampanya kodu ve takip numarası

n11'de kargo takip numarası siparişe elle girilmez; paket, şablondaki 15 haneli kampanya koduyla kargo şubesine teslim edildiğinde numara siparişe kendiliğinden işlenir. Kod kullanılmayan gönderim Kargolandı statüsüne geçmez ve geciken kargolamada kalır. Temel kurallar:

• Kargo firmasını ve ücret tipini mağaza teslimat şablonunda seçer: Mağaza Öder (alıcıya ücretsiz) ya da Şartlı Ödeme.
• Tek kargo ücreti sisteminde alıcı mağaza bazında 300 TL'yi tamamlamazsa kargoyu kendisi öder; şartlı ödeme 5 desi ve altındaki gönderilerde geçerlidir.
• Özel Kargo Kampanyası'na dahil mağazalar bu anlaşmanın kampanya koduyla göndermek zorundadır.
• Aynı siparişteki ürünlerin depo adresi aynıysa tek kampanya koduyla birlikte gönderim oluşur.

Yox İş Ortağım'da etiket basıldığında takip numarası n11 siparişine işlenir ve alıcı kargosunu n11 üzerinden izler. Başlangıç paketinde kargo entegrasyonu yoktur; n11'de kampanya koduyla teslim edilen pakette numarayı n11 kendisi oluşturur. Hangi gönderimde hangi yolu kullanacağınızı kurulumda birlikte netleştiriyoruz.

Kesinti itirazı, kapıda iade ve gecikme cezaları

Kesilen kg/desi ya da ücrete 24 saat içinde itiraz edebilirsiniz; koli ölçüsünü göndermeden önce desi hesaplama aracıyla kontrol etmek itirazı azaltır. Kapıda iade ya da teslim edilemeyen kargoda bedelin %50'si alınır. Geç kargolama cezaları:

n11 komisyon oranları, hizmet bedelleri ve hakediş takvimi

n11 her tamamlanan satıştan KDV dahil kategori komisyonu, %1 + KDV pazarlama hizmet bedeli ve %0,67 + KDV pazaryeri hizmet bedeli keser; Yatırımlık Altın & Gümüş'te pazarlama bedeli %0,17 + KDV'dir. Ekim 2026'da resmî komisyon tablosundan örnekler (kendi kırılımınızı panelden kontrol edin):

Ödeme sayacı sipariş Tamamlandı statüsüne geçince başlar; hesaplama süresi dolunca ödeme Perşembe yapılır, Perşembe tatilse izleyen ilk iş günü. En az 4 kez ödeme almış, mağaza puanı 8.0 ve üzeri mağazalar en az 10.000 TL erken ödeme talep edebilir. Hakedişten ayrıca KDV hariç tutar üzerinden %1 stopaj kesilir (9284 sayılı Cumhurbaşkanı Kararı, 1 Ocak 2025'ten beri).

Örnek hesap: 2.000 TL'lik fitness ürününde n11 kesintisi

Fitness & Kondisyon kategorisinde (%15) KDV dahil 2.000 TL'ye satılan, KDV'si %20 olan bir ürün varsayalım. Kargo örnek olarak 120 TL + KDV alındı; gerçek tutar desiye ve firmaya göre değişir. Hizmet bedelleri KDV dahil tutardan hesaplandı.

Kargo hariç kesinti bile satış fiyatının yaklaşık %17,8'i eder; komisyon faturasındaki KDV indirilebilir, stopaj vergiden mahsup edilir. Kendi rakamlarınızı komisyon hesaplama ve kâr hesaplama araçlarında deneyin. Yox İş Ortağım'da n11 komisyonu ve kargo bedeli sipariş bazında net kârla görünür; fazla kesinti ve ödenmeyen hakediş ayrı listelenir.

Elle yönetim mi, Yox İş Ortağım mı: n11 için paket seçimi

Yalnız n11'de az sayıda ürün satıyorsanız Satıcı Ofisi yetebilir; ikinci bir kanal eklendiği anda stok ve sipariş takibi ikiye bölünür. İki yöntemin karşılaştırması:

n11 hangi Yox İş Ortağım paketinde yer alıyor?

Yıllık ödemede %20 indirim vardır, paketler 3 gün ücretsiz denenir; limitlerin tamamı paket karşılaştırmasında. n11'i Trendyol ve Hepsiburada ile birlikte yönetecekseniz en az Büyüme paketi gerekir.

n11 entegrasyonunda sık yapılan hatalar ve kurulum öncesi kontrol listesi

n11 bağlantısında yaşanan sorunların çoğu yazılımdan değil, mağaza tarafında eksik kalan bir ayardan kaynaklanır. Bağlantıyı açmadan önce şu listeyi tamamlayın:

• KEP ve e-posta doğrulaması ile evrak süreçleri tamamlandı.
• API hesabı oluşturuldu, şifre e-postası alındı.
• En az bir teslimat şablonu tanımlı; hazırlık süreleri gerçekçi.
• Her varyantın kendi barkodu ve tekrar etmeyen stok kodu var.
• n11 fiyat kuralınız komisyonu, hizmet bedellerini, stopajı ve kargoyu karşılıyor.

En sık görülen beş hata

1. Eşleştirme bitmeden stok senkronunu açmak: eşleşmemiş ilanlar eski stokla satışta kalır.
2. Aynı stok kodunu iki üründe kullanmak: yanlış ürünün stoğu değişir.
3. Kampanya kodu dışında gönderim yapmak: sipariş Kargolandı'ya geçmez, gecikme cezası işler.
4. Fiyatı virgülle göndermek ya da liste fiyatını satış fiyatının altına çekmek: görev başarısız döner.
5. 100.000 ürünlük listeleme sınırını unutmak: aylık Listeleme Paketi yenilenmezse sınırın üstündeki ürünler Limit Dışı olup satışa kapanır.

n11'i Hepsiburada entegrasyonu ya da başka kanallarla birlikte düşünüyorsanız 80 satış kanalının listelendiği sayfaya bakın. Kararınızı verdiyseniz Yox İş Ortağım'a başvurun; 3 günlük denemede n11 mağazanızı bağlayıp eşleştirmeyi kendi kataloğunuzda görebilirsiniz.