N11 API Entegrasyonu: Satıcılar İçin Stok ve Sipariş Otomasyonu
Özet
N11 API, SOAP (eski) ve REST (yeni) olmak üzere iki protokol sunar; yeni projeler için REST API tercih edilmelidir. Ürün listeleme, stok güncelleme ve sipariş yönetimi temel kullanım senaryolarıdır. N11 API erişimi için aktif N11 satıcı hesabı ve API key talebi gereklidir (1–2 iş günü onay). 1.000+ SKU'lu mağazalarda API entegrasyonu haftalık 10–15 saatlik manuel işlem yükünü ortadan kaldırır.
N11 API'nin Kapsamı
N11 Marketplace API, satıcıların kendi yazılımları veya ERP sistemleri üzerinden N11 operasyonlarını yönetmesini sağlar. API erişimi N11 Satıcı Merkezi üzerinden talep edilir.
- Ürün Servisi — ürün oluşturma, güncelleme, silme, kategori bilgisi
- Sipariş Servisi — sipariş listesi, detay, durum güncelleme
- Kargo Servisi — kargo kodu oluşturma, takip numarası güncelleme
- Stok Servisi — anlık stok güncelleme, toplu stok yönetimi
- Sorgu Servisi — satış raporları ve performans verileri
SOAP mu, REST mi?
N11, uzun yıllar SOAP tabanlı API kullandı. Yeni API altyapısı REST'e geçiş yapılmıştır; ancak bazı eski metodlar hâlâ SOAP olarak sunulmaktadır.
- SOAP API: XML tabanlı, eski entegrasyonlar için hâlâ çalışır
- REST API: JSON tabanlı, daha hızlı geliştirme, yeni projeler için önerilir
- Authentication: her istekte appKey + appSecret header ile iletilir
- N11 API endpoint: api.n11.com (production) — sandbox ortamı sınırlı
- Rate limit: dakikada 60 istek (hesap tipine göre değişebilir)
API Key Alma ve Başlangıç
N11 API erişimi için Satıcı Merkezi üzerinden talep açılması ve onay beklenmesi gerekir.
- 1. satici.n11.com → 'Entegrasyon Merkezi' → 'API Başvurusu'
- 2. Başvuruda mağaza bilgileri ve kullanım amacı belirtilir
- 3. 1–2 iş günü içinde appKey ve appSecret e-posta ile iletilir
- 4. Her API isteğinde header'a appKey + appSecret eklenir
- 5. Test: Postman ile /ProductService/getProductList endpoint'i çağrılabilir
Yaygın Entegrasyon Senaryoları
N11 API entegrasyonunda en çok kullanılan senaryolar ve teknik notlar:
- Toplu stok güncelleme: /StockService/updateStockByStockSellerCode — SKU bazlı, toplu işlem destekli
- Sipariş çekme: /OrderService/orderList — tarih aralığı filtresi ile
- Fiyat güncelleme: /ProductService/updateProductBasic — ürün ID ile hedefli güncelleme
- Kargo bildirimi: /ShipmentService/updateShipment — kargo şirketi kodu + takip numarası
- Kategori eşleştirme: /CategoryService/getTopLevelCategories → alt kategori ağacı
N11 + Trendyol + Hepsiburada: Çok Kanallı Yönetim
Çok sayıda platformda satış yapan satıcılar için tek merkezi panel, her platform API'sine ayrı ayrı entegre olan bir çözümden çok daha verimlidir.
- Tek stok havuzu: N11, Trendyol ve Hepsiburada stoğu merkezi veritabanından senkronize
- Birleşik sipariş akışı: tüm platformlardan gelen siparişler tek ekranda
- Otomatik fiyat güncelleme: kur değişikliğine göre tüm platformlara eş zamanlı yansıtma
- Tek kargo akışı: barkod oluşturma ve kargo bildirimi tek noktadan
- Çok kanallı proje süresi: 4–6 hafta (3 platform, 500–2.000 SKU)
Sık Sorulan Sorular
N11 API ücretsiz mi?
Evet, N11 API erişimi aktif satıcılar için ücretsizdir. N11'deki satışlardan alınan komisyon oranları (%8–12, kategoriye göre) API kullanımını etkilemez.
N11 API sandbox ortamı var mı?
N11'in tam işlevsel bir sandbox ortamı yoktur. Test işlemleri için test mağazası açılması veya production ortamında minimal miktarda ürün ve sipariş üzerinden test yapılması önerilir.
N11 entegrasyonu WooCommerce ile uyumlu mu?
Evet. WooCommerce'den N11'e ürün ve stok senkronizasyonu mümkündür. N11'den WooCommerce'e sipariş aktarımı da desteklenir. Entegrasyon süresi tek yönlü için 5–7 iş günü, çift yönlü için 8–12 iş günüdür.
N11 entegrasyonu ne kadar sürer?
Yalnızca N11 entegrasyonu 5–8 iş günü içinde tamamlanır. Trendyol + Hepsiburada + N11 gibi çok kanallı projeler 3–5 haftada canlıya geçer.
Solman Digital
Bu rehber, gerçekleştirilen projelerden derlenen doğrudan deneyime dayanmaktadır. Konuya ilişkin sorularınız için doğrudan uzman erişimi sunuyoruz.
N11 API entegrasyonu veya çok kanallı marketplace otomasyonu için
Ücretsiz Araçlar
Rakamları Kendiniz Hesaplayın
Entegrasyon veya geliştirme kararı vermeden önce TicaretHub'un ücretsiz hesaplama araçlarıyla mevcut durumunuzu analiz edebilirsiniz.