N11 Entegrasyonu (REST + SOAP Hibrit)
N11 satıcı panelinden API anahtarı alıp Qando'ya bağlama. REST + SOAP hibrit yaklaşım açıklaması.
Hangi bilgilere ihtiyacınız var?
N11 entegrasyonu için:
- App Key (appKey)
- App Secret (appSecret)
N11 satıcı panelinden API anahtarı
- satici.n11.com panelinize girin.
- Sağ üstte hesap menüsü > API Bilgileri.
- Yeni Anahtar Oluştur veya mevcut anahtarınızı kopyalayın.
- App Key + App Secret değerlerini güvenli yere kaydedin.
Qando'da bağlantı oluşturma
- Entegrasyonlar > Yeni Bağlantı > N11.
- Formu doldurun:
- Bağlantı Adı
- App Key
- App Secret
- Kaydet + Test Et.
Test başarılı ise bağlantı ACTIVE olur.
REST + SOAP hibrit nedir?
N11, 2024'te SOAP'tan REST'e geçti fakat bazı kritik özellikler SOAP'ta kaldı:
| Özellik | Yöntem |
|---|---|
| Ürün listesi, ürün oluşturma | REST |
| Sipariş çekme, kargoya verme | REST |
| Kategori ve attribute keşfi | REST |
| Kargo şablonu listesi | SOAP |
| Müşteri iadeleri (claim) | SOAP |
Qando bu farkı otomatik olarak yönetir — sizin SOAP/REST farkını bilmenize gerek yok. Sadece iade akışında ve kargo şablonu çekerken aynı App Key/Secret SOAP servislerine de gönderilir.
Sync akışları
- Ürün Sync: 21:00'da otomatik
- Sipariş Sync: 5 dakikada bir (REST)
- İade Sync: 10 dakikada bir (SOAP)
Önemli farklılıklar
İade modeli
Trendyol'da bir iade talebi N kalem içerebilir; N11'de her ürün ayrı bir iade kaydıdır. Bu nedenle aynı siparişten 3 farklı ürün iade edildiğinde N11 size 3 ayrı claim gönderir. Qando bunları local modelde N=1 kalemli claim olarak saklar.
Kargo şablonu
N11'de bir ürünü kargoya verirken shipmentTemplate seçmek zorunludur. Bağlantı oluşturduktan sonra:
- Bağlantı detay sayfasında Kargo Şablonları sekmesine git.
- Şablonları Çek butonuna bas → SOAP üzerinden anlaşmalı kargo şablonlarınız listelenir.
- Push akışında bu listeden seçeceksiniz (manuel text input yok).
Pazaryerine ürün gönderme
N11'de push asenkrondur — taskId döner. Push history panelinden durumu sorgulayın. Bkz: Ürünü Pazaryerine Push Etme.
Yaygın sorunlar
- Test başarısız: 401/403 → App Key/Secret yanlış veya hesabınızda API erişimi aktif değil
- İade listesi gelmiyor → SOAP servisi geçici bakımda olabilir; 10dk sonra tekrar dene
- Kargo şablonu boş → N11 panelinden anlaşmalı kargo eklemeniz gerekiyor; yoksa boş döner