| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Invoicing (account) • Discuss (mail) |
| Lines of code | 2848 |
| Technical Name |
n11_connector |
| License | OPL-1 |
| Website | https://gencbaris.com |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Invoicing (account) • Discuss (mail) |
| Lines of code | 2848 |
| Technical Name |
n11_connector |
| License | OPL-1 |
| Website | https://gencbaris.com |
| Versions | 18.0 19.0 |
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: 35+
- Geliştirici: Baris Genc
- Bağımlılıklar: sale_management, stock, delivery, product, sale
- Destek: odoo@gencbaris.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.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module