N11 Entegrasyonu Kurulumu

N11 mağazanızı Pazarus'a bağlayarak ürünlerinizi içe aktarabilir, stok ve fiyatı tek yerden güncelleyebilir, siparişleri otomatik çekebilir ve N11'e yeni ürün gönderebilirsiniz. Bu rehber API bilgilerinin girilmesinden ilk ürün aktarımına kadar tüm adımları kapsar.

Ön koşullar

• Aktif bir N11 satıcı hesabınız olmalı.
• N11 satıcı panelinizde gösterilen API Anahtarı ve API Şifresi değerlerini hazır edin.
• N11'e ürün gönderecekseniz N11 satıcı panelinde Hesabım → Teslimat Bilgileri altında en az bir kargo şablonu tanımlı olmalı ve bu şablon en az bir ürüne uygulanmış olmalıdır.
• Pazarus'ta Entegrasyonlar → Pazaryeri Ayarları sayfasında bağlantı limitinizin dolu olmaması gerekir.

Adım adım

1. Entegrasyonlar → Pazaryeri Ayarları sayfasını açın ve N11 kartındaki Entegrasyonu Kur butonuna tıklayın.
2. N11 Bağlantı Ayarları bölümünde API Anahtarı ve API Şifresi alanlarına N11 satıcı panelindeki değerleri yapıştırın.
3. Kargo Şablonu alanına N11'de oluşturduğunuz kargo şablonunun adını yazın. Alanın sağındaki yenile simgesine tıklarsanız Pazarus, mağazanızdaki mevcut şablon adlarını çeker ve alanın altında tıklanabilir seçenekler olarak listeler; bir tanesine tıklamanız yeterlidir. Bu şablon N11'e gönderdiğiniz her üründe kullanılır.
4. Aktif anahtarını açık bırakın. Senkronizasyon Modu ilk kurulumda Senkronize Etme olarak kalsın; eşleştirme tamamlandıktan sonra Fiyat + Stok, Sadece Fiyat veya Sadece Stok seçin.
5. Kaydet butonuna basın, ardından Bağlantıyı Test Et butonuna tıklayın. Üç sonuçtan biri görünür:
   • Bağlantı Başarılı!: sipariş ve ürün yönetimi aktif; N11 kategorileri arka planda senkronize edilmeye başlar.
   • Kısmi Bağlantı: kimlik doğrulandı ancak Ürün Yönetimi API erişimi yok. N11 Satıcı Paneli → Entegrasyon bölümünden "Ürün Yönetimi" iznini aktive edin ve testi tekrarlayın.
   • Bağlantı Başarısız: API Anahtarı ve API Şifresi değerlerini kontrol edin.
6. Sağ üstteki Diğer menüsünden Ürünleri Önizle seçeneğini çalıştırın; "N11 Ürün Özeti" bildirimi toplam ürün, kayıtlı bağlantı ve tahmini yeni ürün sayısını gösterir.
7. Ürünleri İçe Aktar butonuna tıklayın ve seçenekleri belirleyin:
   • Sadece aktif ürünleri aktar: yalnızca Active + On_Sale durumundaki ürünler gelir.
   • Sadece stoktakileri aktar: stoğu sıfırdan büyük ürünler gelir.
   • Varyantları oluştur: kapalıysa aynı ürünün her renk ve bedeni ayrı ürün olarak eklenir.
   • Stok davranışı: Pazarus'ta mevcut ürünleriniz varsa "Sadece yeni ürünlerde stok al (mevcut ürünlere dokunma)" seçeneğini koruyun.
   Başlat ile aktarım arka planda çalışır. Durumu Pazaryerleri → İçe Aktarma Geçmişi sayfasından takip edebilirsiniz.
8. Sipariş Senkronizasyonu bölümünde Siparişleri Otomatik Çek anahtarını açın; siparişler otomatik çekilir (varsayılan 5 dakikada bir; planınıza göre değişebilir).
9. Kaydet ile ayarları saklayın.

İsteğe bağlı ayar bölümleri

• Ürün Adı Otomatik Tamamlama: N11 ürün başlığının en az 15 karakter olmasını ister. Otomatik Tamamlamayı Aç anahtarı açıkken kısa adlı ürünler için Uygulanacak Stratejiler sırayla uygulanır: varyant niteliklerini ekle, marka adını başına ekle, SKU'yu sonuna ekle, sabit metin ekle. Minimum Karakter Sayısı varsayılan 15'tir; Sabit Metin (Suffix) diğer stratejiler yetmezse son çare olarak eklenir.
• Ürün Senkronizasyonu: Ürün değişikliklerini pazaryerine push et açıkken Pazarus'taki açıklama ve görsel değişiklikleri N11'e otomatik gönderilir.
• Kategorileri Senkronize Et (Diğer menüsü): N11 kategori ağacını yeniden çeker. Bağlantı testi başarılı olduğunda otomatik başlar; kategori listesi boş görünüyorsa elle çalıştırın.

Sık karşılaşılan sorunlar

• Belirti: Bağlantı testi "API kimlik doğrulama hatası" veriyor. Çözüm: API Anahtarı ve API Şifresi değerlerini N11 satıcı panelinden yeniden kopyalayın; baştaki ve sondaki boşlukları temizleyin.
• Belirti: "Kısmi Bağlantı" uyarısı alıyorsunuz, ürünler gelmiyor. Çözüm: N11 Satıcı Paneli → Entegrasyon bölümünden "Ürün Yönetimi" iznini açın. Sipariş çekme bu izin olmadan da çalışır, ürün işlemleri çalışmaz.
• Belirti: Kargo Şablonu alanında "N11'de mevcut şablon bulunamadı" uyarısı çıkıyor. Çözüm: N11 satıcı panelinde Mağaza Yönetimi → Kargo Şablonları'ndan en az bir şablon tanımlayıp bir ürüne uygulayın, sonra yenile simgesine tekrar basın. Bu arada şablon adını elle yazabilirsiniz.
• Belirti: N11'e gönderilen ürün "Satıcı Onay Bekliyor" durumunda kalıyor. Çözüm: Gönderilen barkod N11 kataloğunda farklı bir kategoride kayıtlıysa N11 ürünü onaya alır. Ürünün kategorisini N11 kataloğundaki kategoriyle eşleştirin.
• Belirti: Ürün gönderiminde kategori seçilemiyor. Çözüm: Diğer → Kategorileri Senkronize Et seçeneğini çalıştırıp birkaç dakika bekleyin.

İpuçları

• N11'de ürünün kimliği stok kodudur (stockCode). Varyantlı ürünlerde her varyantın benzersiz bir stok kodu olmalıdır.
• Yalnızca eşleştirmeleri kaldırmak için Diğer → N11 Bağlantılarını Sil kullanın; ürünleriniz korunur. Entegrasyonu Tamamen Kaldır ayarları da siler.