Odoo + Shopify Sync: Ürünler, Siparişler ve Envanter

Shopify, ABD'deki tüm e-ticaret gelirlerinin %10'undan fazlasına güç sağlıyor. Operasyonel omurgası olarak Odoo 19 Enterprise'ı ve müşteriye dönük vitrini olarak Shopify'ı kullanan işletmeler için her iki sistemi de senkronize tutmak tartışılamaz; bağlantısız sistemler envanter hataları, sipariş işleme gecikmeleri ve muhasebe sorunları anlamına gelir.

Bu kılavuz Odoo-Shopify entegrasyonunun tamamını kapsar: mimari kararları, ürün kataloğu senkronizasyonu, gerçek zamanlı sipariş içe aktarma, çift yönlü envanter yönetimi, Shopify Payments mutabakatı ve çoklu mağaza yönetimi.

Önemli Çıkarımlar

• Shopify'ın REST ve GraphQL API'lerinin her ikisi de desteklenir; Shopify Plus için GraphQL tercih edildi
• Ürün senkronizasyonu iki yönlüdür: Odoo'da oluşturun → Shopify'da yayınlayın veya Shopify'dan içe aktarın
• Envanter senkronizasyonu olaya dayalıdır: Odoo'daki her stok hareketinde tetiklenir
• Shopify'dan Odoo'ya sipariş webhook'u, siparişlerin neredeyse anında içe aktarılmasını sağlar (<30 saniye)
• Shopify Payments mutabakatı ödemeleri, ücretleri ve geri ödemeleri otomatik olarak yönetir
• Çok konumlu envanter, Shopify'ın çoklu konum özelliğiyle senkronize edilir
• Shopify Plus B2B (toptan satış) katalogları Odoo'nun fiyat listelerine bağlantı verir
• Otomatik stok ayarlaması ile Shopify'dan Odoo RMA'ya iade akışı

---

Entegrasyon Mimarisi

API yaklaşımı:

Entegrasyon, çoğu işlem için Shopify'ın REST Yönetici API'sini ve olaya dayalı güncellemeler için web kancalarını kullanır:

• REST API: ürün CRUD'u, sipariş okuma, envanter yönetimi
• GraphQL API: toplu işlemler (büyük katalog dışa aktarma), B2B fiyatlandırma (Shopify Plus)
• Web kancaları: gerçek zamanlı sipariş oluşturma, sipariş güncellemesi, para iadesi oluşturma, envanter düzeyi güncellemesi

Bağlantı topolojisi:

Odoo 19 (ERP Backend)
    ↕ Product, Inventory, Price
Shopify Admin API / Webhooks
    ↕ Real-time events
Shopify Storefront (Customer-facing)

Kimlik doğrulama:

Shopify, özel uygulama API anahtarlarını veya özel uygulama OAuth'unu kullanır:

• Özel Uygulama: daha basit, tek mağazalı entegrasyonlar için önerilir
• Özel Uygulama (OAuth): Shopify App Store dağıtımı veya çoklu mağaza yönetimi için gereklidir

ECOSIRE bağlayıcı için Shopify'ın İş Ortağı Kontrol Panelinde bir Özel Uygulama yapılandırın.

---

Shopify Uygulama Yapılandırması

1. Adım: Shopify'da Özel Uygulama Oluşturun

1. Shopify yöneticinize → Ayarlar → Uygulamalar ve Satış Kanallarına gidin
2. Uygulama Geliştir → Uygulama Oluştur'a tıklayın
3. Uygulama adını ayarlayın (ör. "Odoo Entegrasyonu")
4. API kapsamlarını yapılandırın:

   read_products, write_products
   read_orders, write_orders
   read_inventory, write_inventory
   read_shipping, write_shipping
   read_customers, write_customers
   read_fulfillments, write_fulfillments
   read_locations
   read_price_rules, write_price_rules
   

5. Web kancası URL'sini ayarlayın: https://your-odoo.com/shopify/webhook
6. Uygulamayı yükleyin → Yönetici API Erişim Simgesini kopyalayın

2. Adım: Odoo'da yapılandırın

Satış → Shopify veya Envanter → Shopify Mağazaları'na gidin:

3. Adım: Web kancalarını kaydedin

Yapılandırmayı kaydettikten sonra Web Kancalarını Kaydet'i tıklayın. Bağlayıcı aşağıdakilere abone olur:

• orders/create
• orders/updated
• orders/paid
• orders/fulfilled
• orders/partially_fulfilled
• orders/cancelled
• refunds/create
• inventory_levels/update
• products/update

---

Ürün Kataloğu Senkronizasyonu

Senkronizasyon yönü seçenekleri:

Önerilen: Yeni dağıtımlar için Odoo → Shopify. Odoo'nun ürün ana aracı, Shopify'ın ihtiyaç duymadığı daha zengin veriler (satın alma bilgileri, maliyetlendirme, ürün reçetesi) sağlar.

Ürün alanı eşlemesi:

Varyant senkronizasyonu:

Shopify, ürün başına maksimum 100 çeşitle en fazla 3 ürün seçeneğini (Renk, Boyut, Malzeme) destekler. Bağlayıcı, Odoo'nun ürün özelliklerini eşleştirir:

1. Odoo product.template → Shopify Ürünü
2. Odoo product.product (varyantlar) → Shopify Varyantları
3. Odoo özellik değerleri → Shopify seçenek değerleri

Toplu katalog senkronizasyonu:

Büyük kataloglarla (1000'den fazla ürün) ilk kurulum için:

1. Shopify → Katalog → Toplu Senkronizasyon'a gidin
2. Senkronize edilecek ürün kategorilerini seçin
3. Toplu senkronizasyon işini çalıştırın (arka plan işlemi)
4. Senkronizasyon günlüğündeki ilerlemeyi izleyin
5. Eşleme hatalarını inceleyin ve çözün

---

Sipariş Yönetimi

Web kancaları aracılığıyla gerçek zamanlı sipariş içe aktarma:

Bir müşteri Shopify'da sipariş verdiğinde orders/create web kancası saniyeler içinde etkinleşir. Bağlayıcı:

1. Shopify'dan webhook yükünü alır
2. Webhook imzasını doğrular (HMAC-SHA256)
3. Odoo'da hemen bir satış siparişi oluşturur
4. Shopify'a 200 OK döndürür (yeniden denemeyi engeller)

Shopify ödemesinden Odoo satış siparişine kadar olan uçtan uca süre: genellikle 3-15 saniye.

Sipariş verileri eşleme:

Özel sipariş alanları:

Özel ödeme özelliklerine sahip Shopify Plus satıcıları için:

• Shopify sipariş notu niteliklerini Odoo özel alanlarıyla eşleyin
• Örnek: "PO Numarası" özelliği → satış siparişinde x_purchase_order_number
• Örnek: Satış siparişinde "Hediye Mesajı" → note

Sipariş işleme iş akışı:

İçe aktarmanın ardından bağlayıcı, siparişi Odoo'nun standart iş akışı aracılığıyla yönetir:

1. Satış siparişi onaylandı
2. Odoo WMS'de oluşturulan teslimat siparişi
3. Depodan alınanlar, paketlenenler, gönderilenler
4. Teslimat Odoo'da doğrulandı (takip girildi)
5. Bağlayıcı, siparişin yerine getirildiğini takip numarasıyla Shopify'a gönderir
6. Shopify, siparişi "Gönderildi" olarak işaretler ve müşteriye e-posta gönderir

Kısmi yerine getirmeler:

Shopify, birden fazla gönderime sahip siparişleri destekler (mevcut olanları gönderin, sonra dinlenin). Konektör şunları yönetir:

• Odoo'da kısmi teslimat → Shopify'a kısmi teslimat gönderildi
• Shopify müşteriye kısmi tamamlanma durumunu gösterir
• Kalan ürünler stok mevcut olduğunda ayrı bir teslimat oluşturur

---

Envanter Senkronizasyonu

Çift yönlü envanter senkronizasyonu:

Doğruluğu korumak için envanter her iki yönde de akar:

Odoo → Shopify (birincil yön):

• Odoo'daki her stok hareketi, Shopify'da bir envanter seviyesi güncellemesini tetikler
• Mevcut miktar = Eldeki - Rezerve edilmiş - Emniyet Stoku
• Shopify'ın Envanter Düzeyi API'si aracılığıyla güncellemeler

Shopify → Odoo (yedek):

• Shopify envanteri manuel olarak ayarlanırsa (yönetici veya uygulama) webhook etkinleşir
• Bağlayıcı, denetim notuyla birlikte bir Odoo envanter ayarlaması oluşturur

Shopify'ın çoklu konumu:

Shopify'ın çoklu konum özelliği, fiziksel konuma göre envanteri izler. Odoo depolarını Shopify konumlarıyla eşleyin:

Bağlayıcı, depo konumu eşlemesine göre konum başına miktarları Shopify'a aktarır.

Envanter doğruluğu önlemleri:

• Güvenlik stoku arabelleği, Shopify'ın mevcut tüm envanteri göstermesini engeller
• Stokta olmayan işleme: miktar 0'a ulaştığında Shopify envanteri = 0 (negatif değil)
• Stokta kalmadığında satışa devam edin: ürüne göre yapılandırılabilir (bazı satıcılar ön siparişlere izin verir)

---

Shopify Payments Mutabakatı

Shopify Payments ücret yapısı:

Ödeme mutabakatı:

Shopify Payments, her 2-3 iş gününde banka hesabınıza havale yapar. Bağlayıcı ödeme verilerini içe aktarır:

1. Shopify Payments ödeme raporunu indirin (veya API aracılığıyla)
2. Shopify → Finans → İthalat Ödemesi yoluyla içe aktarın
3. Bağlayıcı günlük girişleri oluşturur:

• Gelir (sipariş başına net satış tutarları)
• Shopify Fees gideri (ödeme işleme)
• İade düzenlemeleri
• Net ödeme alacakları

4. Banka havalesi geldiğinde: Shopify Payments günlüğüyle mutabakat sağlayın

Shopify geri ödemelerini yönetme:

Shopify'da bir geri ödeme işlendiğinde:

1. refunds/create web kancası tetikleniyor
2. Bağlayıcı, Odoo'da orijinal faturaya karşılık bir alacak dekontu oluşturur
3. Stok iade edilmişse (yeniden stoklanmışsa): iade transferi oluşturur
4. Kredi notu gönderilir → müşteri hesabına aktarılan bakiye

---

Shopify Plus B2B Entegrasyonu

Shopify Plus, B2B özelliklerini (toptan satış katalogları, ödeme koşulları, net ödeme) içerir. Bağlayıcı bunları Odoo'nun B2B fiyatlandırmasıyla bütünleştirir:

Şirket ve katalog eşlemesi:

B2B fiyatlandırmasını senkronize edin:

1. Bağlayıcıda Shopify B2B kataloğu oluşturun
2. Odoo fiyat listesine bağlantı
3. Shopify B2B şirketlerine atama
4. Odoo fiyat listesindeki fiyat değişiklikleri → otomatik olarak Shopify B2B kataloğuna aktarılır

---

Çoklu Mağaza Yönetimi

Birden fazla Shopify mağazası işleten markalar için (bölgeler, markalar, toptan ve perakende):

Birden fazla mağaza yapılandırması:

Her Shopify mağazası için ayrı bağlayıcı yapılandırmaları oluşturun:

• Mağaza başına farklı API kimlik bilgileri
• Mağazaya özel ürün görünürlüğü (bazı ürünler tüm mağazalarda, bazıları ise özel olarak)
• Mağazaya özel fiyatlandırma (bölgesel fiyatlandırma, toptan ve perakende)
• Mağazaya özel envanter tahsisi

Mağazalar arasında envanter dağıtımı:

Available for Store A = On-Hand - Reserve for Store B - Reserve for Store C - Safety Stock

Birden fazla mağazanın aynı envanterden ürün alması durumunda aşırı satışı önlemek için tahsis kurallarını yapılandırın.

---

Sıkça Sorulan Sorular

Bağlayıcı, özel veriler için Shopify'ın ürün meta alanlarını nasıl yönetir?

Shopify meta alanları ürünler, siparişler ve müşterilere ilişkin özel verileri depolar. Bağlayıcı belirli Odoo alanlarını Shopify meta alanlarıyla eşler. Örneğin, Odoo'nun x_care_instructions alanını bir product.care_instructions meta alanıyla eşleyin. Kaynak türüne göre bağlayıcının gelişmiş ayarlarında meta alan eşlemelerini yapılandırın.

Bağlayıcı, Shopify'ın abonelik ürünlerini (Shopify Abonelikleri veya ReCharge) yönetebilir mi?

Standart Shopify abonelik siparişleri Odoo'ya normal siparişler olarak aktarılır. ReCharge abonelikleri için yinelenen siparişler ayrı orders/create web kancaları olarak tetiklenir ve normal şekilde içe aktarılır. Bağlayıcı, Shopify'daki abonelik yaşam döngüsünü yönetmez; abonelikle oluşturulmuş veya tek seferlik olmasına bakılmaksızın her siparişi işler.

Shopify webhook etkinleştirildiğinde Odoo sunucusu kapalıysa ne olur?

Shopify, başarısız web kancalarını 48 saat içinde 19 defaya kadar yeniden dener. Bağlayıcı, Odoo kurtarıldığında ve sipariş içe aktarıldığında web kancasını işler. Görev açısından kritik güvenilirlik için Odoo'yu yedekli altyapıyla (yük dengeleyici + birden fazla çalışan) ve kesinti süresine ilişkin izleme uyarılarıyla yapılandırın. 48 saatlik yeniden deneme penceresi, planlı bakım için bir ara bellek sağlar.

Bağlayıcı Shopify Markets'ı (çok para birimli uluslararası satış) destekliyor mu?

Evet. Shopify Markets, tek bir mağazadan birden fazla para biriminde satış yapılmasına olanak tanır. Bağlayıcı, siparişleri alıcının ödeme para birimi cinsinden içe aktarır ve Odoo'da bu para biriminde satış siparişleri oluşturur. Para birimi dönüştürme işleminde siparişin içe aktarımı sırasındaki döviz kuru kullanılır. Doğru yerel fiyatlandırma için Odoo'da Shopify Market başına ayrı fiyat listeleri yapılandırın.

Odoo'da Shopify hediye kartlarını nasıl yönetirim?

Shopify hediye kartları, siparişlerde ödeme yöntemi olarak görünür. Bağlayıcı, her siparişin hediye kartı kısmı için ayrı bir ödeme satırı oluşturur. Odoo'da bir "Shopify Hediye Kartları" yükümlülük hesabı yapılandırın. Hediye kartı satıldığında (hediye kartı ürünü aracılığıyla), gelir ertelenir. Bir sipariş üzerine itfa edildiğinde yükümlülük temizlenir ve gelir muhasebeleştirilir.

---

Sonraki Adımlar

İyi yürütülen bir Odoo-Shopify entegrasyonu görünmez hale gelir; yalnızca çalışır ve manuel müdahale olmadan her iki sistemi de senkronize tutar. ECOSIRE ekibi, günde 50 sipariş işleyen D2C markalarından günde 10.000 sipariş işleyen kurumsal perakendecilere kadar her şey için Shopify-Odoo entegrasyonları oluşturdu.

Shopify-Odoo Entegrasyonunuz Hakkında ECOSIRE ile İletişime Geçin →

ECOSIRE'ın Shopify Hizmetlerini keşfedin →

Mağaza ayrıntılarınızı ve mevcut sorun noktalarınızı paylaşın; ekibimiz, ERP'niz ile vitrininiz arasındaki boşlukları ortadan kaldıran bir Shopify-Odoo entegrasyonunu kapsayacaktır.