N11 Entegrasyonu

Kategori: Pazaryeri
Versiyon: 1.0.0

N11 eklentisi, mağazanızı N11 pazaryeri ile entegre eder. Ürün yükleme, stok güncelleme, sipariş çekme ve kategori eşleştirme işlemlerini tek panelden yönetebilirsiniz.

Desteklenen Özellikler

  • Ürün yükleme ve güncelleme (N11 REST API v9)
  • Stok senkronizasyonu
  • Sipariş senkronizasyonu
  • Ürün bazında kategori eşleştirme
  • Fatura linki bildirimi (SOAP)

ℹ️ N11 için fiyat senkronizasyonu bulunmamaktadır. Fiyat değişikliklerini N11 satıcı panelinden yapmanız gerekir.

1. Ön Hazırlık — N11'den API Bilgilerini Alın

  1. N11 Satıcı Paneli'nde Ayarlar → API Yönetimi sayfasına gidin.
  2. API Key (appKey) ve API Secret (appSecret) değerlerini kopyalayın.
📸 N11 Satıcı Paneli, API Yönetimi sayfası, API Key ve Secret alanları

2. Eklentiyi Mağaza Panelinde Yapılandırın

  1. Sol menüden Eklenti Mağazası sayfasına gidin ve N11 kartındaki Eklentiyi Yapılandır butonuna tıklayın.
  2. Ayarlar sekmesine tıklayın.
N11 entegrasyon sayfası, Ayarlar sekmesi aktif
N11 entegrasyon sayfası, Ayarlar sekmesi aktif
  1. Aşağıdaki alanları doldurun:
AlanAçıklama
API Key (appKey)N11 API Yönetimi sayfasından
API Secret (appSecret)N11 API Yönetimi sayfasından
Entegratör adıN11'e gönderilen entegratör bilgisi; varsayılan IGKFast
Teslimat şablonu (N11 panel)N11 panelinde tanımlı kargo/teslimat şablonunuzun adı; varsayılan Varsayılan
  1. Kaydet butonuna tıklayın.

⚠️ Teslimat şablonu adı N11 panelinizdeki şablonla birebir aynı olmalıdır; aksi halde ürün gönderimi reddedilir.

3. Bağlantıyı Test Edin

Kaydettikten sonra Dashboard sekmesine geçip Bağlantıyı Test Et butonuna tıklayın. Başarılı mesajı görünce entegrasyon hazırdır.

📸 Bağlantı testi başarılı bildirimi

4. Kategori Eşleştirme

N11 kendi kategori yapısını kullanır. Ürünlerinizin doğru kategoride yayınlanması için eşleştirme yapmanız şarttır.

  1. Ürünler sekmesine gidin.
  2. Eşleştirmek istediğiniz ürünün satırındaki kategori ikonuna tıklayın.
  3. Açılan N11 Kategori Eşleştir penceresinden N11 kategorisini seçin veya Manuel N11 kategori ID alanına ID'yi girin.
  4. Kaydedin.

ℹ️ N11'de ayrı bir Kategori Eşleştirme sekmesi yoktur; eşleştirme ürün satırındaki pencere üzerinden yapılır. Eşlemesi geçersiz olan ürünlerde listede "Geçersiz eşleme" uyarısı görünür.

📸 N11 Kategori Eşleştir penceresi, kategori seçici

5. Ürün Senkronizasyonu

Ürünler sekmesinde ad, SKU veya barkod ile arama yapabilirsiniz.

  • Tüm ürünleri göndermek için Tümünü Gönder butonunu kullanın.
  • Ürün satırındaki ikonlarla tek ürün için kategori eşleştirme, gönderme ve stok güncelleme yapabilirsiniz.

Listede her ürünün N11 Durum bilgisi (ve varsa hata mesajı) görünür.

📸 Ürünler sekmesi, ürün listesi ve aksiyon ikonları

6. Sipariş Yönetimi

  1. Siparişler sekmesinden N11 siparişlerinizi görüntüleyin.
  2. Siparişleri İçe Aktar ile son 7 günün siparişlerini çekin. Siparişler ayrıca 10 dakikada bir otomatik çekilir.

Sekmenin altındaki N11 Araçları kartından:

  • Fatura linki (SOAP) — N11 sipariş numarası + fatura PDF URL'sini girip Gönder ile N11'e iletin.
  • Sipariş kalemi onay (Created → Picking) — orderLineId değerlerini virgülle ayırarak girip kalemleri onaylayın.
📸 Siparişler sekmesi, sipariş listesi ve N11 Araçları kartı

Sık Karşılaşılan Sorunlar

"N11 API bilgileri yapılandırılmamış" hatası: Ayarlar sekmesindeki API Key (appKey) ve API Secret (appSecret) alanlarını doldurun.

Ürün N11'de görünmüyor: Ürünün kategori eşleştirmesinin yapıldığını ve listede "Geçersiz eşleme" uyarısı olmadığını kontrol edin.

Stok N11'e yansımıyor: N11 için otomatik stok gönderimi yoktur; ürün satırındaki stok güncelleme ikonunu veya Tümünü Gönder butonunu kullanın.