n11 Connector
Odoo için doğrudan n11 Pazaryeri REST API entegrasyonu — sipariş, ürün, stok, kargo
Odoo'yu n11 REST API'sine (api.n11.com) doğrudan bağlayın. Aracı platform yok, aylık SaaS yok.
Önemli — Entegratör değiliz. Bu modül n11 REST API'sine doğrudan SİZİN kendi mağaza kimlik bilgilerinizle (App Key, App Secret) bağlanır. n11 ile satıcı ilişkisi, sözleşme, onay ve destek doğrudan sizin firmanız ile n11 arasındadır; aradan biz geçmeyiz, hesabınıza veya verinize erişimimiz yoktur.
Temel Özellikler
Sipariş Çekme
Cron ile REST sevkiyat-paketi ucundan sipariş çekme. Tüm sayfalar (totalPages) gezilir; TC kimlik numarası ile müşteri, kalemler, fiyatlar ve ödeme tipi Odoo satış siparişine eşlenir. Sipariş satırları stok kodundan doğru ürüne bağlanır.
Varyant Bazında Ürün Oluşturma
Her varyant kendi sellerStockCode'u, varyant bazında stok ve fiyatı (price_extra dahil) ile ayrı bir SKU olarak gönderilir. REST ürün-oluşturma görevi çoklu görsel ve açıklamayla çalışır. Sipariş alımında stok kodu + varyant öznitelikleriyle TAM varyant eşlenir — asla şablonun ilk varyantı değil.
Kategori ve Zorunlu Öznitelik Eşleme (YENİ)
n11 kategori ağacı ve her yaprak kategorinin zorunlu nitelikleri (izinli değerleriyle, gerektiğinde nitelik başına ayrı çekilir) senkronlanır. Her ürün için zorunlu nitelikleri bir kez eşlersiniz — Sabit değer, Odoo niteliğinden ya da Özel metin olarak. Her üründe 7-8 niteliği elle doldurmazsınız.
Değer-Bazında Çeviri (YENİ)
n11 değer id'leri kategoriye göre değişir. Her Odoo öznitelik değerini o kategorinin kendi n11 değer id'sine bir kez eşlersiniz (örn. Odoo “Sax Mavi” → n11 “Mavi”); her varyantın değeri otomatik çevrilir. Eşlenmemiş ya da n11 karşılığı olmayan bir zorunlu nitelik, push'u eksik listesiyle en başta engeller — ürün n11'in reddedeceği şekilde hiç gönderilmez.
Stok ve Fiyat Senkronu
REST fiyat-stok güncelleme görevi ile sellerStockCode bazında stok ve fiyat güncellemesi. Hem satış fiyatı (salePrice) hem liste fiyatı (listPrice) gönderilir — tekrar senkron çift kayıt oluşturmaz (idempotent). Cron ile periyodik çalıştırın.
Sevkiyat Güncelleme
Odoo sevkiyatı yaptığında sipariş kalemleri lineId bazında tek REST çağrısıyla sevk durumuna alınır. Kargo takibi n11 lojistik sağlayıcısı üzerinden yürütülür.
Görev Sonuçlarının Yoklanması
Ürün oluşturma görevinden dönen taskId, n11 onaylayana kadar yoklanır. SKU bazında başarı/hata durumu ve gerçek hata sebepleri kaydedilir; “zaten mevcut” hataları başarılı listeleme sayılır.
Çoklu Depo Stok ve Döviz Çevrimi
Miktar şirket toplamı yerine seçili depodan okunur. Fiyatlar Odoo kurlarıyla yapılandırılan pazaryeri para birimine (varsayılan TRY) çevrilir ve uygun n11 currencyType (TL/USD/EUR) ile gönderilir.
Görsel Gönderimi & Ağır Bağımlılık Yok
Ürün görselleri (varyant görseli → e-ticaret görselleri → ana görsel önceliğiyle, 8 adede kadar) URL ile n11'e iletilir. Saf ``requests`` (HTTPS üzerinden JSON); harici SDK kurulumu gerekmez.
Tam API Kaydı
Her REST çağrısı (başarılı ve hatalı); metod, URL, durum kodu, süre, istek payload'u, response özeti ve hata detayı ile kayıt altında. HTTP 429/503 sınırlamaları Retry-After ile yönetilir.
Ekran Görüntüleri
n11 API Kayıtları
n11 Ayarları
Neden Bu Modül
Bu modül Odoo'yu resmi n11 REST API'sine (api.n11.com) doğrudan bağlar: sipariş, fiyat/stok, ürün oluşturma ve sevkiyat. Saf Python + requests, harici SDK bağımlılığı yok, üçüncü taraf entegrasyon platformu yok, SaaS aboneliği yok. n11 Satıcı Paneli'nden aldığınız App Key ve App Secret'ı girin; Odoo, n11 operasyonlarınızın komuta merkezi olsun.
Teknik Özellikler
- Uyumlu: Odoo 18.0 / 19.0
- Lisans: OPL-1
- Diller: TR/EN
- Geliştirici: Pokutsoft
- Bağımlılıklar: sale_management, stock, delivery, product, sale
- Destek: support@pokutsoft.com
Entegratör-Dostu Öznitelikler (YENİ)
Bir pazaryeri kategorisinin zorunlu özniteliklerini bir kez kategori şablonu olarak tanımlayın; Odoo öznitelik ve değerleri n11 tarafına ada göre otomatik eşlensin; ve tek sihirbazla onlarca ürüne toplu uygulayın. Artık her üründe öznitelikleri tek tek elle eşlemek yok — kategori şablonu bir kez kurulur, tüm kategorideki ürünler ondan beslenir.
Fatura'yı Pazaryerine Gönder (YENİ)
Odoo'da kestiğiniz faturayı (ya da kendi e-Arşiv PDF bağlantınızı) tek tıkla siparişin geldiği n11 tarafına geri gönderin; tüm istek/yanıt API kaydıyla. Önemli: Bu modül yalnızca hazır üretilmiş bir faturayı taşır (BYOK); e-Fatura/e-Arşiv üretmez ve hiçbir mali kesinleştirme (clearance) yapmaz — yasal faturadan satıcı sorumludur.
Update date: 2026-07-22