Odoo Amazon Connector: Kurulum ve Çok Kanallı Satış

Amazon, ABD e-ticaret gelirinin yaklaşık %40'ını oluşturuyor ve bu da onu ürün satıcıları için zorunlu bir kanal haline getiriyor. Amazon siparişlerini, envanterini ve sipariş karşılama işlemlerini temel ERP'nizden ayrı olarak yönetmek, veri silolarına, mutabakat sorunlarına ve gerçek paraya mal olan sipariş karşılama hatalarına neden olur.

ECOSIRE Odoo Amazon Connector, Odoo 19 Enterprise ile Amazon Seller Central arasında köprü oluşturarak ürünleri, siparişleri, envanter seviyelerini ve sipariş karşılama durumunu her iki yönde senkronize eder. Bu kılavuz, Amazon satışlarını Odoo aracılığıyla yürütmek için tüm kurulum sürecini, veri eşleme yapılandırmasını, senkronizasyon sıklığı seçeneklerini, hata yönetimini ve operasyonel en iyi uygulamaları kapsar.

Önemli Çıkarımlar

• Konektör tüm Amazon pazar yerlerini (ABD, İngiltere, AB, Japonya, BAE vb.) destekler.
• Sipariş senkronizasyonu varsayılan olarak her 15 dakikada bir çalışır; 5 dakikaya kadar yapılandırılabilir
• Envanter seviyeleri her hisse senedi hareketinde otomatik olarak Amazon'a aktarılır
• FBA ve FBM (Satıcı Tarafından Karşılanır) siparişleri ayrı iş akışlarında gerçekleştirilir
• Ürün eşlemede eşleştirme anahtarları olarak ASIN, SKU ve EAN/UPC kullanılır
• Başarısız senkronizasyonlar hata ayrıntılarıyla birlikte günlüğe kaydedilir ve ayrı ayrı yeniden denenebilir
• Fiyatlandırma kuralları, Odoo fiyat listelerine dayalı olarak Amazon fiyatlarını geçersiz kılabilir
• Bağlayıcı, kullanımdan kaldırılan MWS'nin yerine Amazon SP-API'yi (Satış Ortağı API'si) kullanır

---

Önkoşullar ve Amazon SP-API Kurulumu

Bağlayıcı, Amazon'un Satış Ortağı API'sini (SP-API) kullanır. Bağlayıcıyı yüklemeden önce Amazon'dan SP-API kimlik bilgilerine ihtiyacınız vardır.

1. Adım: Amazon Seller Central'da geliştirici olarak kaydolun

1. Seller Central → Uygulamalar ve Hizmetler → Uygulama Geliştirme'de oturum açın
2. "Yeni uygulama istemcisi ekle"ye tıklayın ve geliştirici kaydını tamamlayın
3. Amazon başvurunuzu inceleyecektir (onay için 1-3 iş günü)

2. Adım: Bir SP-API uygulaması oluşturun

Onaylandıktan sonra:

1. Uygulamalar ve Hizmetler → Uygulama Geliştirin → Uygulamalarınız'a gidin
2. "Yeni uygulama istemcisi ekle"ye tıklayın
3. IAM ARN'yi seçin (önce bir AWS IAM kullanıcısı oluşturun) veya OAuth'u kullanın
4. Yönlendirme URI'sini Odoo örneğinize ayarlayın: https://your-odoo.com/amazon/oauth/callback
5. Gerekli API kapsamlarını seçin:

• Siparişler API'si
• Raporlar API'si
• Listeleme API'si
• Katalog Öğeleri API'si
• Amazon Lojistik Envanter API'si
• Feed'ler API'sı

3. Adım: Satıcı hesabınızı yetkilendirin

Uygulamayı oluşturduktan sonra uygulamayı her pazaryerinde yetkilendirin:

1. Uygulamanızın LWA (Amazon ile Giriş) kimlik bilgilerini kopyalayın
2. Bağlayıcının yetkilendirme URL'sine gidin
3. Her Amazon Marketplace hesabı için OAuth akışını tamamlayın

Odoo'da ihtiyaç duyacağınız kimlik bilgileri:

• LWA İstemci Kimliği
• LWA Müşteri Sırrı
• Tokenı Yenile (OAuth akışı sırasında oluşturulur)
• AWS Bölgesi (pazaryerine göre)

---

Bağlayıcıyı Kurma ve Yapılandırma

ECOSIRE Amazon Connector modülünü yükleyin:

Konektör ECOSIRE pazarından temin edilebilir. Satın aldıktan sonra:

1. Modül zip dosyasını ECOSIRE hesabınızdan indirin
2. Odoo sunucunuza yükleyin: cp amazon_connector.zip /opt/odoo/addons/
3. Çıkarın ve yükleyin: Uygulamalar'a gidin → Uygulama Listesini Güncelleyin → "Amazon Bağlayıcısı"nı arayın → Yükle

İlk yapılandırma:

Envanter → Yapılandırma → Amazon Marketplaces'e (veya Odoo düzeninize bağlı olarak Satış → Amazon → Yapılandırma) gidin.

Yeni bir Market bağlantısı eklemek için Oluştur'u tıklayın:

Bağlantıyı test edin:

Kaydettikten sonra Bağlantıyı Test Et'e tıklayın. Başarılı bir test, satıcı adınızı döndürür ve API erişimini onaylar. Başarısız olursa şunları kontrol edin:

• LWA kimlik bilgileri doğru
• Yenileme jetonunun süresi dolmadı
• AWS bölgesi pazaryerinize uygundur
• SP-API uygulaması "Yayınlandı" durumundadır ("Taslak" değil)

---

Ürün Eşleme ve Katalog Senkronizasyonu

Bağlayıcı, üç yöntemi kullanarak Odoo ürünlerini Amazon ASIN'leriyle eşleştirir:

Yöntem 1: SKU eşleştirme (önerilen)

Dahili ürün referanslarınız (SKU kodları) Amazon'da kullandığınız satıcı SKU'su ile eşleşiyorsa, Market ayarlarında SKU Otomatik Eşleştirme'yi etkinleştirin. Bağlayıcı, Odoo ürünlerini otomatik olarak Amazon listelerine bağlayacaktır.

Yöntem 2: EAN/UPC eşleştirme

Bağlayıcı, ürününüzün barkoduyla (EAN13 veya UPC) eşleşen listeleri bulmak için Amazon'un katalog API'sini sorgular. Bu, Amazon'un kataloğunda listelenen markalı ürünler için geçerlidir.

Yöntem 3: Manuel ASIN eşleme

Özel ürünler veya paketler için:

1. Ürün formuna gidin → Amazon sekmesi
2. Her pazaryeri için ASIN'i girin
3. Varyantları belirli ASIN'lerle eşleştirin

Amazon kataloğunu içe aktarma:

Tek tek eşlemek yerine Amazon kataloğunuzu içe aktarın:

1. Amazon → Katalog → Listeleri İçe Aktar seçeneğine gidin
2. Pazar yerini seçin
3. Bağlayıcı tüm aktif listelemelerinizi indirir ve Odoo ürünlerini oluşturur/günceller
4. Alan eşleme doğruluğu açısından içe aktarılan ürünleri inceleyin

Ürün alanı eşleme yapılandırması:

---

Sipariş Senkronizasyonu

Siparişler Amazon'dan Odoo'ya otomatik olarak aktarılır. Sipariş yaşam döngüsünü anlamak, karışıklığı ve yerine getirme hatalarını önler.

Sipariş senkronizasyonu iş akışı:

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

Sipariş senkronizasyonu ayarları:

İptal edilen siparişlerin yönetimi:

Amazon bir siparişi iptal ettiğinde (müşteri iptali veya ödeme hatası):

1. Bağlayıcı bir sonraki senkronizasyonda iptali algılar
2. Teslimat siparişi doğrulanmadıysa: otomatik olarak iptal edilir
3. Teslimat zaten doğrulanmışsa: bağlayıcı bir iade RMA'sı oluşturur
4. Faturanın alacak dekontu ile iptal edilmesi veya ters çevrilmesi

---

Envanter Senkronizasyonu

Gerçek zamanlı envanter doğruluğu, aşırı satışı önleyerek Amazon satıcı hesabının cezalandırılmasına neden olur.

Amazon'a envanter aktarımı:

Her Odoo stok hareketi gerçekleştiğinde (teslimat, teslim alma, iade, ayarlama), bağlayıcı güncellenen miktarı Amazon Inventory API'ye aktarır:

• FBM ürünleri: Odoo'nun eldeki miktarı eksi güvenlik stok tamponu
• FBA ürünleri: Amazon, Amazon Lojistik envanterini yönetir; Odoo, Amazon Envanter API'si aracılığıyla Amazon Lojistik seviyelerini alıyor

Emniyet stoğu yapılandırması:

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

Güvenlik stoğunu ürün başına veya genel olarak yapılandırın:

• Ürüne gidin → Amazon sekmesi → Güvenlik Stoku: 5
• Veya küresel olarak pazar yeri ayarlarında → Varsayılan Güvenlik Stoku: 2

Envanter senkronizasyon sıklığı:

Sipariş senkronizasyonunun (olay odaklı + planlanmış) aksine, envanter senkronizasyonu toplu tabanlıdır:

• Varsayılan: her 30 dakikada bir
• Herhangi bir stok hareketinden sonra: 5 dakika içinde (webhook stili)
• Yoğun dönemlerden önce: manuel senkronizasyonu çalıştırın

Çoklu depo envanteri:

Birden fazla depodan gönderim yapılıyorsa:

1. Her depo için ayrı Amazon Marketplace yapılandırmaları oluşturun
2. Bağlayıcı, tüm bağlı depolardaki envanteri toplar
3. Veya: Amazon'un çok konumlu envanter özelliğini depoya özel miktar tahsisiyle kullanın

---

Amazon Lojistik (Amazon Tarafından Karşılanır) Entegrasyonu

Amazon Lojistik siparişleri Amazon'un deposu tarafından yerine getirilir ancak mali mutabakat için Odoo'nun hâlâ bunları bilmesi gerekiyor.

Odoo'da Amazon Lojistik sipariş iş akışı:

1. Amazon siparişi alır ve yerine getirir (Odoo'nun sipariş karşılama rolü yoktur)
2. Bağlayıcı, Odoo'da "FBA" olarak işaretlenmiş bir satış.siparişi oluşturur
3. Teslimat siparişi otomatik olarak doğrulanır (Odoo'da fiziksel toplama yoktur)
4. Sanal bir "Amazon FBA" konumu azaltılır
5. Fatura oluşturulur ve gönderilir
6. Amazon havalesi faturayla mutabakata varılır

FBA stok yönetimi:

Envanteri Odoo aracılığıyla Amazon FBA'ya gönderin:

1. Odoo'da (veya Seller Central'da) bir Amazon Lojistik gönderisi oluşturun ve bağlayın)
2. Bağlayıcı, deponuzdan "Amazon FBA" konumuna bir stok transferi oluşturur
3. Ürünler Amazon'a gönderildiğinde aktarımı doğrulayın
4. Amazon Lojistik miktarları raporlama amacıyla Odoo'da takip edilir

FBA ücreti mutabakatı:

Amazon, ödemeyi yapmadan önce ücretleri (yerine getirme, depolama, yönlendirme) keser. Bağlayıcıyı şu şekilde yapılandırın:

• Amazon ödeme raporlarını içe aktarın
• Amazon Lojistik ücretleri için otomatik günlük girişleri oluşturun
• Net ödeme tutarının ödenmemiş faturalarla mutabakatı

---

Fiyatlandırma Yönetimi

Otomatik yeniden fiyatlandırma:

Bağlayıcı, Odoo fiyat listesi kurallarına göre Amazon'a otomatik fiyat güncellemelerini destekler:

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

Yapılandırma:

• Market ayarlarına gidin → Fiyatlandırma
• Fiyat Kaynağını ayarlayın: Fiyat Listesi, Maliyet + Marj veya Sabit
• Çarpan'ı ayarlayın (ör. aynı fiyat için 1,0, %15 kâr marjı için 1,15)
• Fiyatları Otomatik Eşitleme özelliğini etkinleştirin: Odoo'da değiştirildiğinde fiyatlar Amazon'a aktarılır

Para birimi kullanımı:

USD dışı pazaryerleri (EUR, GBP, JPY) için bağlayıcı:

1. Yapılandırılmışsa pazaryerine özel fiyat listesinden fiyatları okur
2. Veya Odoo'nun günlük döviz kurlarını kullanarak temel para biriminizden çevirir

---

Hata İşleme ve İzleme

Senkronizasyon hatası günlüğü:

Tüm senkronizasyon işlemlerini görmek için Amazon → Günlükleri Eşitle seçeneğine gidin:

• Yeşil: başarılı senkronizasyon
• Sarı: kısmi senkronizasyon (bazı kayıtlar başarısız oldu)
• Kırmızı: tam senkronizasyon hatası

Her hata girişi şunu gösterir:

• Zaman damgası ve senkronizasyon türü (siparişler, envanter, listeler)
• Amazon API'sinden gelen hata kodu
• Etkilenen kayıt kimliği
• Hata mesajı
• Yeniden dene düğmesi

Yaygın hatalar ve çözümleri:

Otomatik uyarılar:

Senkronizasyon hataları için e-posta uyarılarını yapılandırın:

• Market ayarlarına gidin → Bildirimler
• Senkronizasyon hatalarını bildirmek için e-posta adresleri ekleyin
• Uyarı eşiğini ayarlayın: art arda 3 başarısızlıktan sonra bildirimde bulunun

---

Sıkça Sorulan Sorular

Bağlayıcı Amazon FBA Çok Kanallı Lojistik'i (MCF) destekliyor mu?

Evet. MCF, diğer satış kanallarından (web siteniz, diğer pazaryerleri) gelen siparişleri yerine getirmek için Amazon'un Amazon Lojistik envanterini kullanmanıza olanak tanır. Bağlayıcı, ürünün Amazon Lojistik'te stoklanması koşuluyla Amazon dışı bir kanaldan satış siparişi alındığında MCF gerçekleştirme talepleri oluşturabilir. MCF siparişleri Odoo'da FBA konum hareketleriyle takip edilir.

Bağlayıcı, Amazon'un karmaşık vergi kurallarını (KDV OSS, Pazar Yeri Kolaylaştırıcısı) nasıl ele alıyor?

Amazon'un vergi topladığı ve aktardığı pazaryerleri için (Pazar Yeri Kolaylaştırıcısı kuralları, çoğu ABD eyaletinde ve AB dışındaki satıcılar için AB'de geçerlidir), vergi yükümlülüğünü Amazon üstlendiğinden bağlayıcı 0 ABD doları vergiyle siparişler oluşturur. Kolaylaştırıcı dışı durumlar için bağlayıcı, alıcının teslimat adresine göre Odoo'da yapılandırılan mali pozisyonları uygular.

Bir Odoo örneğinden birden fazla Amazon hesabını (farklı satıcı hesapları) yönetebilir miyim?

Evet. Her biri kendi SP-API kimlik bilgilerine sahip birden fazla pazar yapılandırması oluşturun. Çok şirketli bir Odoo kurulumunda farklı satıcı hesapları, aynı hesap altında farklı pazaryerleri veya farklı şirketler için ayrı konfigürasyonlara sahip olabilirsiniz. Siparişler, envanter ve fiyatlandırma pazar yeri yapılandırmasına göre yönetilir.

Amazon bir siparişi Odoo'ya aktarıldıktan sonra değiştirirse ne olur?

Bağlayıcı, her senkronizasyon döngüsünde sıra değişikliklerini kontrol eder. Amazon bir siparişi güncellerse (ör. gönderim öncesi miktar değişikliği, adres düzeltmesi), henüz onaylanmamışsa bağlayıcı ilgili Odoo satış siparişini günceller. Onaylanan siparişlerde yapılan değişiklikler, manuel inceleme için bir sistem uyarısı oluşturur.

Bağlayıcı Amazon A+ İçeriğini mi yoksa Gelişmiş Marka İçeriğini mi yönetiyor?

Hayır. A+ İçerik yönetimi, yalnızca Seller Central aracılığıyla yönetilen pazarlama içeriğidir. Bağlayıcı operasyonel verilere odaklanır: siparişler, envanter, fiyatlandırma ve yerine getirme. Ürün içeriği (açıklamalar, resimler) Amazon temel listelerine aktarılabilir ancak A+ İçerik şablonlarına aktarılamaz.

---

Sonraki Adımlar

Amazon'da Odoo aracılığıyla satış yapmak, iki sistemi ayrı ayrı yönetmekten önemli ölçüde daha verimlidir; ancak bağlayıcının en baştan doğru şekilde kurulması gerekir. Yanlış yapılandırılmış ürün eşlemeleri, yanlış envanter senkronizasyonu ayarları veya yanlış vergi yapılandırmaları, zamanla artan sorunlara neden olur.

ECOSIRE'ın Amazon Bağlayıcı modülü, Odoo 19 Enterprise için özel olarak tasarlanmıştır ve ekibimiz, Amazon'u Odoo aracılığıyla yöneten pazar yeri satıcılarına kurulum yardımı, eğitim ve sürekli destek sağlar.

Odoo 19 için ECOSIRE Amazon Bağlayıcısını edinin →

Satın alma, Amazon-Odoo entegrasyonunuzun ilk günden itibaren doğru şekilde çalışmasını sağlamak için modül lisansını, belgeleri ve 30 günlük uygulama desteğini içerir.