N11 Mağaza API Entegrasyon Rehberi

N11 mağazanızı NİTRU'ya bağlamak için API Key ve API Secret bilgilerine ihtiyacınız var. N11, SOAP tabanlı bir API sistemi kullanır ve bilgilere satıcı panelinizden kolayca ulaşabilirsiniz.

1. N11 Satıcı Paneline Giriş

seller.n11.com adresine satıcı hesabınızla giriş yapın.

2. API Bilgilerine Erişim

Satıcı panelinde API bilgilerinize ulaşmak için:

1. Sol menüden "Mağaza" sekmesine tıklayın.
2. Açılan alt menüden "API Bilgileri" veya "Entegrasyon Bilgileri" seçeneğine tıklayın.

Alternatif olarak: Hesabım → Mağaza Bilgilerim → Entegrasyon → API Bilgileri yolunu da takip edebilirsiniz.

3. API Key ve Secret Alma

API Bilgileri sayfasında:

• API Key (appKey): Mağazanıza atanmış benzersiz anahtar. Bu otomatik olarak oluşturulur.
• API Secret (appSecret): API Key ile birlikte kullanılan gizli anahtar.

Eğer daha önce API bilgisi oluşturmadıysanız:

1. "API Anahtarı Oluştur" veya "Anahtar Üret" butonuna tıklayın.
2. Sistem size bir API Key ve API Secret üretecektir.
3. Bu bilgileri güvenli bir yere kopyalayın.

Not: N11 API anahtarları sayfayı her açtığınızda görünür. Ancak güvenlik için bir yere kaydetmeniz önerilir.

4. API Erişim İzinleri

N11 API'si aşağıdaki servis gruplarına erişim sağlar:

• Ürün Servisi: Ürün listeleme, güncelleme, silme
• Sipariş Servisi: Sipariş listeleme, durum güncelleme
• Sevkiyat Servisi: Kargo ve teslimat işlemleri
• Stok Servisi: Stok güncelleme
• Kategori Servisi: Kategori listeleme

N11'de API anahtarınız oluşturulduğunda tüm servislere otomatik olarak erişim sağlanır. Ayrıca servis bazlı yetkilendirme yapmanız gerekmez.

5. N11 API Endpoint Bilgisi

N11 SOAP API endpoint'leri otomatik olarak NİTRU tarafından yönetilir. Manuel olarak endpoint girmeniz gerekmez. NİTRU, aşağıdaki servisleri kullanır:

• Ürün Servisi: ProductService
• Sipariş Servisi: OrderService
• Sevkiyat Şirketi Servisi: ShipmentCompanyService

N11 için Mağaza ID, App Key ve App Secret bilgileri gereklidir.

6. NİTRU'da Mağaza Ekleme

API bilgilerinizi aldıktan sonra NİTRU panelinde:

1. Mağaza Yönetimi sayfasına gidin.
2. "Yeni Mağaza" butonuna tıklayın.
3. Platform olarak N11'i seçin.
4. API Key (appKey) ve API Secret (appSecret) bilgilerinizi girin.
5. "Doğrula" butonu ile bağlantıyı test edin.
6. Bağlantı başarılıysa "Ekle" butonuna tıklayarak mağazanızı kaydedin.

İpucu: N11 API bağlantısı genellikle en hızlı kurulan pazaryeri entegrasyonlarından biridir. API Key ve Secret'ı girdikten sonra saniyeler içinde bağlantı kurulur.

Sık Karşılaşılan Sorunlar

• "Kimlik doğrulama hatası": API Key veya Secret'ı kopyalarken başında/sonunda boşluk kalmış olabilir. Temizleyin.
• "API anahtarı bulunamıyor": Hesabınızda API bilgisi oluşturulmamış olabilir. Satıcı panelinden "Anahtar Üret" butonuna tıklayın.
• Ürünler gelmiyor: N11'de ürünlerinizin "onaylı" statüde olduğundan emin olun. Onay bekleyen ürünler API'de görünmeyebilir.

API Limitleri

N11 API kullanımında bazı limitler bulunur:

• Dakikada maksimum istek sayısı sınırlıdır.
• NİTRU bu limitleri otomatik olarak yönetir ve aşım durumunda bekleme yapar.
• Yoğun ürün sayılarında ilk senkronizasyon biraz daha uzun sürebilir.

NİTRU Mağaza Yönetimi sayfasında tüm bağlı mağazalarınızı, API bağlantı durumlarını ve ürün sayılarını görebilirsiniz.