Shopify + Odoo ERP Entegrasyonu: Tam Kılavuz

Shopify mağazaları ölçeklendikçe, Shopify'ın yerel olarak ele aldığı şeyler ile işletmenin operasyonel mükemmellik için gerçekte ihtiyaç duyduğu şeyler arasındaki fark önemli bir kısıtlama haline gelir. Birden fazla depoda envanter yönetimi, çoklu para birimi muhasebesi, Shopify satışları tarafından tetiklenen üretim siparişleri, tam müşteri geçmişine sahip gelişmiş CRM ve otomatik satıcı yenileme - bunlar bir ERP gerektirir ve Odoo, orta ölçekli e-ticaret işletmeleri için giderek daha fazla tercih edilen sistem haline geliyor.

Shopify + Odoo, tak ve çalıştır entegrasyonu değildir. Hangi sistemin hangi verilere sahip olduğu, neyin hangi yönde senkronize edildiği ve kısmi sevkiyatlar, iade işlemleri ve değişken eşleme gibi uç durumların nasıl ele alınacağı konusunda dikkatli mimari kararlar alınması gerekir. Bu kılavuz, entegrasyon mimarisinden belirli uygulama modellerine kadar her şeyi kapsar.

Önemli Çıkarımlar

• Odoo envanter, müşteriler ve muhasebe için gerçeğin kaynağıdır; Shopify, e-ticaret işlemleri için gerçeğin kaynağıdır
• Çift yönlü envanter senkronizasyonu (siparişler için Shopify → Odoo, stok seviyeleri için Odoo → Shopify) temel entegrasyon gereksinimidir
• Ürün kataloğu yönetimi Odoo'da bulunmalı ve Shopify ile senkronize edilmelidir; bunun tersi değil
• Müşteri kayıtları, benzersiz tanımlayıcı olarak e-postayı kullanan sistemler arasında birleştirilir
• Sipariş yaşam döngüsü: Shopify sipariş oluşturur → Odoo siparişi alır → Odoo teslimatı oluşturur → sipariş karşılama güncellemeleri Shopify
• İade işleme koordinasyon gerektirir: Shopify iadeyi başlatır → Odoo makbuzu işler → her iki sistem de güncellenir
• Shopify'ın Webhook API'si gerçek zamanlı sipariş etkinlikleri sağlar; Odoo bunları bağlayıcı ara yazılımı aracılığıyla alır
• Doğrudan Odoo-Shopify bağlayıcıları mevcuttur (Syncee, OdooConnector) ancak REST API aracılığıyla özel entegrasyonlar daha fazla kontrol sunar

---

Entegrasyon Mimarisini Anlamak

Uygulamadan önce her veri alanı için yetkili sistemi tanımlayın:

Neden Odoo'nun envanteri var:

Shopify'ın envanter takibi işlevseldir ancak çok depolu, çok kanallı operasyonlar için sınırlıdır. Odoo'nun envanter modülü şunları yönetir: parti ve seri numarası takibi, çok konumlu depo yönetimi, otomatik yenileme kuralları, üretim entegrasyonu (bitmiş ürün azalan bileşen envanteri) ve barkoda dayalı sipariş karşılama operasyonları. Shopify, Odoo'nun envanter gerçekliğini yansıtmalıdır, tersini değil.

Shopify neden ticaret katmanıdır:

Shopify'ın ödeme, ödeme işleme, kargo ücreti hesaplaması, vergi tahsilatı ve müşteriyle yüz yüze görüşme deneyimi sınıfının en iyisidir. Odoo'nun B2C e-ticareti (Odoo Web Sitesi) işlevseldir ancak Shopify'ın DTC ticareti düzeyinde değildir. Optimum mimari, Shopify'ı ticaret arayüzü ve Odoo'yu operasyonel omurga olarak tutar.

---

Entegrasyon Yöntemleri: Bağlayıcı Uygulamaları ve Özel API Karşılaştırması

Seçenek 1: Önceden oluşturulmuş bağlayıcı uygulamaları

Çeşitli Shopify ve Odoo Marketplace uygulamaları önceden oluşturulmuş entegrasyon sağlar:

Önceden oluşturulmuş bağlayıcılar aşağıdakiler için iyi çalışır: karmaşık değişken yapıları, çoklu depoları veya üretim bağımlılıkları olmayan basit iş modelleri için standart ürün kataloğu ve sipariş senkronizasyonu.

Seçenek 2: API'ler aracılığıyla özel entegrasyon

Karmaşık iş gereksinimleri için Shopify'ın REST/GraphQL API'sini ve Odoo'nun JSON-RPC/REST API'sini kullanan özel entegrasyon, en fazla kontrolü ve güvenilirliği sağlar.

Özel entegrasyon mimarisi:

Shopify (Commerce Layer)
│
│ Webhooks (orders/create, orders/updated, refunds/create, inventory_levels/update)
│
▼
Integration Service (Node.js / Python middleware)
│
│ Event processing, transformation, error handling, retry logic
│
▼
Odoo (ERP Layer)
│
│ Odoo JSON-RPC API (sales orders, inventory, customers, accounting)
│
└── Inventory updates → Shopify Admin API

Özel entegrasyon için teknoloji yığını:

• Ara yazılım: Node.js (Shopify ekosistemi uyumu için) veya Python (Odoo ekosistemi uyumu için)
• Kuyruk: Güvenilir olay işleme için Redis veya RabbitMQ
• Veritabanı: Entegrasyon durumu için PostgreSQL, idempotency anahtarları, hata günlükleri
• Barındırma: Webhook işleyicileri için AWS Lambda veya benzeri (Shopify trafiğindeki artışlarla otomatik olarak ölçeklenir)

---

Sipariş Senkronizasyonu: Shopify → Odoo

Sipariş senkronizasyonu en kritik entegrasyon yoludur. Her Shopify siparişinin, yerine getirilmesini tetikleyen ve mali kayıtları güncelleyen karşılık gelen bir Odoo satış siparişi oluşturması gerekir.

Sipariş etkinlikleri için Shopify webhook kurulumu:

// Register webhooks via Shopify API
const webhooks = [
  {
    topic: 'orders/create',
    address: 'https://your-integration.com/webhooks/shopify/orders',
    format: 'json'
  },
  {
    topic: 'orders/updated',
    address: 'https://your-integration.com/webhooks/shopify/orders/updated',
    format: 'json'
  },
  {
    topic: 'orders/fulfilled',
    address: 'https://your-integration.com/webhooks/shopify/orders/fulfilled',
    format: 'json'
  },
  {
    topic: 'refunds/create',
    address: 'https://your-integration.com/webhooks/shopify/refunds',
    format: 'json'
  }
];

Shopify siparişini Odoo satış siparişine dönüştürme:

def shopify_order_to_odoo_sale_order(shopify_order: dict) -> dict:
    """Transform Shopify order payload to Odoo sale.order format"""

    # Find or create Odoo partner (customer)
    partner_id = find_or_create_odoo_partner(
        email=shopify_order['email'],
        name=shopify_order['customer']['first_name'] + ' ' + shopify_order['customer']['last_name'],
        phone=shopify_order['customer'].get('phone'),
        shipping_address=shopify_order['shipping_address']
    )

    # Map line items
    order_lines = []
    for item in shopify_order['line_items']:
        odoo_product_id = get_odoo_product_from_shopify_variant(
            item['variant_id']
        )
        order_lines.append({
            'product_id': odoo_product_id,
            'product_uom_qty': item['quantity'],
            'price_unit': float(item['price']),
            'name': item['name'],
            'shopify_line_id': item['id'],  # Custom field for traceability
        })

    # Add shipping as a service product line
    if float(shopify_order.get('shipping_lines', [{}])[0].get('price', 0)) > 0:
        order_lines.append({
            'product_id': SHIPPING_PRODUCT_ID,  # Configured in settings
            'product_uom_qty': 1,
            'price_unit': float(shopify_order['shipping_lines'][0]['price']),
            'name': shopify_order['shipping_lines'][0]['title'],
        })

    return {
        'partner_id': partner_id,
        'order_line': [(0, 0, line) for line in order_lines],
        'shopify_order_id': shopify_order['id'],  # Custom field
        'shopify_order_name': shopify_order['name'],  # e.g., #1001
        'note': shopify_order.get('note', ''),
        'state': 'sale',  # Confirm order automatically
    }

Idempotency yönetimi:

Shopify, aynı webhook etkinliğini birden çok kez sunabilir (ağ yeniden denemeleri). Entegrasyonunuz yinelenen olayları düzgün bir şekilde ele almalıdır:

def process_shopify_order_webhook(payload: dict):
    shopify_order_id = str(payload['id'])

    # Check if already processed
    if OrderSyncLog.objects.filter(
        shopify_order_id=shopify_order_id,
        status='completed'
    ).exists():
        logger.info(f"Order {shopify_order_id} already processed, skipping")
        return

    # Process and log
    try:
        odoo_order_id = create_odoo_sale_order(payload)
        OrderSyncLog.objects.create(
            shopify_order_id=shopify_order_id,
            odoo_order_id=odoo_order_id,
            status='completed'
        )
    except Exception as e:
        OrderSyncLog.objects.create(
            shopify_order_id=shopify_order_id,
            status='failed',
            error=str(e)
        )
        raise

---

Envanter Senkronizasyonu: Odoo → Shopify

Aşırı satışı önlemek için envanter düzeyleri, Odoo'nun Shopify'daki gerçekliğini gerçek zamanlı (veya neredeyse gerçek zamanlı) olarak yansıtmalıdır.

Tetikleyici tabanlı envanter senkronizasyonu:

En güvenilir yaklaşım olay odaklı senkronizasyondur: Odoo'da envanter değiştiğinde (satış, satın alma fişi, üretimin tamamlanması, stok ayarlaması), Odoo güncellenen miktarı Shopify'a iletir.

# In Odoo (using automated actions or override)
def _post_write_sync_to_shopify(self):
    """Called after inventory level changes in Odoo"""
    for move_line in self:
        product = move_line.product_id
        location = move_line.location_id

        if location.is_shopify_sync_location:
            shopify_variant_id = product.shopify_variant_id
            if shopify_variant_id:
                new_quantity = product.with_context(
                    location=location.id
                ).qty_available

                sync_inventory_to_shopify(
                    shopify_variant_id=shopify_variant_id,
                    quantity=int(new_quantity)
                )

def sync_inventory_to_shopify(shopify_variant_id: str, quantity: int):
    """Push inventory update to Shopify via Admin API"""
    inventory_item_id = get_inventory_item_id(shopify_variant_id)
    location_id = get_shopify_location_id()  # Primary Shopify location

    shopify.InventoryLevel.set(
        inventory_item_id=inventory_item_id,
        location_id=location_id,
        available=quantity
    )

Planlanmış envanter mutabakatı:

Olaya dayalı senkronizasyonda bile günlük tam envanter mutabakatı planlayın:

1. Tüm Odoo ürün miktarlarını belirlenen Shopify-sync konumundan dışa aktarın
2. Mevcut Shopify envanter seviyeleriyle karşılaştırın
3. Tutarsızlıkları güncelleyin (başarısız senkronizasyon olayları, manuel ayarlamalar nedeniyle oluşabilir)
4. Denetim amacıyla mutabakat sonuçlarını günlüğe kaydedin

Bu mutabakat, birikmiş küçük senkronizasyon hatalarından kaynaklanan envanter kaymasını önler.

---

Ürün Kataloğu Senkronizasyonu: Odoo → Shopify

Odoo'da ürün kataloglarını (çok para biriminde fiyatlandırma, ayrıntılı özellikler ve karmaşık değişken matrisleriyle) yöneten işletmeler için kataloğun Shopify ile senkronize edilmesi, manuel çift girişi ortadan kaldırır.

Ürün eşleme mimarisi:

Odoo Product (product.template)
├── Shopify Product (via shopify_product_id field on Odoo template)
│
└── Odoo Product Variants (product.product)
    └── Shopify Variants (via shopify_variant_id field on Odoo product.product)

Odoo'dan Shopify'a ne senkronize edilir:

• Ürün adı (Odoo'nun satış açıklaması)
• Ürün açıklaması (uzun HTML açıklaması)
• Resimler (ürün.şablon resimleri)
• Fiyat (yapılandırılmış Shopify fiyat listesini kullanarak)
• SKU (Odoo'nun dahili referansı)
• Barkod (Odoo'dan EAN/UPC)
• Ağırlık (nakliye hesaplaması için)
• Aktif/arşivlenmiş durumu (Odoo ürünü arşivlendiğinde Shopify'da yayından kaldır)
• Envanter (belirlenen senkronizasyon konumundan)

Odoo'dan Shopify'a senkronize edilmemesi gerekenler:

• Shopify'a özel SEO meta verileri (başlık etiketleri, meta açıklamalar — Shopify'da yönetin)
• Shopify ürün etiketleri (Shopify'da yönetin)
• Shopify koleksiyonları/kategorileri (Shopify'da yönetin)
• Shopify'a özel içerik (sayfa oluşturucu bölümleri, Shopify için biçimlendirilmiş zengin açıklamalar)

---

Müşteri Veri Yönetimi

Hem Shopify'da (mağaza hesaplarından) hem de Odoo'da (kişiler/iş ortakları olarak) bulunan müşterilerin, tek bir birleşik profil oluşturmak için dikkatli bir şekilde birleşmeleri gerekir.

E-posta kullanarak tekilleştirme stratejisi:

def find_or_create_odoo_partner(email: str, name: str, **kwargs) -> int:
    """Find existing Odoo partner by email or create new one"""
    existing = Partner.search([
        ('email', '=', email)
    ], limit=1)

    if existing:
        # Update with latest data from Shopify
        existing.write({
            'phone': kwargs.get('phone', existing.phone),
        })
        return existing.id
    else:
        # Create new partner
        partner = Partner.create({
            'name': name,
            'email': email,
            'phone': kwargs.get('phone'),
            'type': 'contact',
            'customer_rank': 1,
            'shopify_customer_id': kwargs.get('shopify_customer_id'),
        })
        return partner.id

Odoo'da saklanan Shopify müşteri kimlikleri:

Odoo'nun res.partner modeline özel bir alan shopify_customer_id ekleyin. Bu, çift yönlü aramayı etkinleştirir: Shopify ID'den Odoo iş ortağını bulun, Odoo iş ortağından Shopify müşterisini bulun.

---

Gerçekleştirme Döngüsü: Odoo → Shopify

Odoo bir teslimatı işlediğinde (toplama + doğrulama) sipariş yerine getirilir. Shopify'ın şu adrese bildirilmesi gerekir:

• Siparişi yerine getirildi olarak işaretleyin
• Müşteriye gönderim onayı e-postasını gönderin
• Takip numarasını kaydedin

def sync_fulfillment_to_shopify(odoo_picking: StockPicking):
    """Called after Odoo delivery is validated"""
    shopify_order_name = odoo_picking.sale_id.shopify_order_name
    tracking_number = odoo_picking.carrier_tracking_ref

    # Find Shopify order
    shopify_orders = shopify.Order.find(name=shopify_order_name)
    if not shopify_orders:
        return

    shopify_order = shopify_orders[0]

    # Create fulfillment in Shopify
    fulfillment = shopify.Fulfillment.create({
        'order_id': shopify_order.id,
        'tracking_number': tracking_number,
        'tracking_company': odoo_picking.carrier_id.name,
        'notify_customer': True,  # Sends Shopify's shipping email
        'line_items': [
            {'id': line.shopify_line_id}
            for line in odoo_picking.sale_id.order_line
            if line.shopify_line_id
        ]
    })

---

Muhasebe Entegrasyonu: Shopify Satışları → Odoo Financials

Her Shopify satışının sonuçta Odoo'nun muhasebe modülünde yayınlanmış bir satış girişi olarak görünmesi gerekir.

Muhasebe için entegrasyon yaklaşımı:

Seçenek 1 — Sipariş düzeyinde muhasebe: Her Shopify siparişi bir Odoo faturası oluşturur (veya Odoo satış siparişi yerine getirildiğinde bir fatura oluşturur). Shopify'da kaydedilen ödemeler, Odoo'da ödeme kaydını tetikler.

Seçenek 2 — Ödeme düzeyinde muhasebe: Shopify Payments ödemeleri (günlük veya haftalık banka mevduatları), Odoo'da banka işlemleriyle mutabakat sağlayan yevmiye kayıtları olarak kaydedilir. Bunun bakımı daha kolaydır ancak daha az ayrıntılı muhasebe sağlar.

Çoğu orta ölçekli satıcı için, uzlaşma düzeyinde muhasebe (Seçenek 2) yeterlidir ve uygulanması ve sürdürülmesi önemli ölçüde daha az karmaşıktır.

Shopify ödeme verileri → Odoo günlük girişi:

def process_shopify_payout(payout_data: dict):
    """Create Odoo journal entry for Shopify Payments payout"""
    journal = ShopifyJournal.get_or_create()  # Shopify clearing account

    entry = AccountMove.create({
        'journal_id': journal.id,
        'date': payout_data['date'],
        'ref': f"Shopify Payout {payout_data['id']}",
        'line_ids': [
            (0, 0, {
                'account_id': SHOPIFY_CLEARING_ACCOUNT_ID,
                'credit': payout_data['amount'],
                'name': f"Shopify sales - {payout_data['period']}",
            }),
            (0, 0, {
                'account_id': SHOPIFY_FEES_ACCOUNT_ID,
                'debit': payout_data['fees'],
                'name': 'Shopify Payments fees',
            }),
            (0, 0, {
                'account_id': BANK_ACCOUNT_ID,
                'debit': payout_data['amount'] - payout_data['fees'],
                'name': f"Bank deposit - Shopify payout {payout_data['id']}",
            }),
        ]
    })
    entry.action_post()

---

Sıkça Sorulan Sorular

Shopify-Odoo entegrasyonunun uygulanması ne kadar sürer?

Önceden oluşturulmuş bir bağlayıcı kullanan temel entegrasyon (sipariş senkronizasyonu, envanter senkronizasyonu, müşteri senkronizasyonu), yapılandırma, test etme ve veri taşıma dahil olmak üzere 2-4 hafta sürer. Tüm yaşam döngüsünü (siparişler, envanter, sipariş karşılama senkronizasyonu, iadeler, muhasebe) kapsayan özel bir entegrasyon, işin karmaşıklığına bağlı olarak 8-16 hafta sürer. Karmaşık senaryolar (çoklu depo, üretim, çok para birimi, çok şirketli Odoo) 4-8 hafta daha ekler. Devam eden bakım için bütçe: Shopify veya Odoo yayın API'si değiştiğinde entegrasyonların güncellenmesi gerekir.

Ürünleri Shopify'da mı yoksa Odoo'da mı yönetmeliyim?

Basit ürün katalogları için: Shopify'da yönetin ve Odoo'yu üretim/tedarik amacıyla manuel olarak güncelleyin. Karmaşık kataloglar için (birçok varyant, birden fazla para biriminde fiyatlandırma, teknik özellikler, üretim ürün reçeteleri): Odoo'da yönetin ve Shopify ile senkronize edin. Kritik faktör, ürün ekibinizin gerçekte nerede çalıştığıdır. Ürün satışı ekibiniz Shopify'da yaşıyorsa onları Odoo'da çalışmaya zorlamak sürtüşme yaratır. Operasyon ekibiniz Odoo'daki ürünleri üretim ve satın alma için yönetiyorsa Shopify senkronizasyonu doğru yaklaşımdır.

Entegrasyon yayına girdiğinde mevcut Shopify siparişlerine ne olacak?

Tarihsel tarikatların Odoo'ya taşınmasına gerek yoktur. Entegrasyon, yeni siparişleri hayata geçme tarihinden itibaren işler. Geçmiş veriler (müşteri kayıtları, ürün kataloğu, envanter taban çizgileri) için, entegrasyon yayına girmeden önce tek seferlik bir veri geçişi gerçekleştirin: geçmiş müşteri verilerini Odoo'ya aktarın, ürün kataloğunu içe aktarın ve Odoo'da envanter temel çizgilerini mevcut Shopify miktarlarıyla eşleşecek şekilde ayarlayın.

Odoo'da bulunmayan ürünlerle Shopify siparişlerini nasıl halledebilirim?

Bu uç durum, saf entegrasyonları bozuyor. Bir yedek oluşturun: Shopify siparişi, bir Odoo ürünüyle eşleşmeyen bir varyant kimliği içerdiğinde, Odoo'da siparişi "Bilinmeyen Ürün" yer tutucusu ile oluşturun ve entegrasyon ekibinizi uyarın. Bildirimli bir hata kuyruğu tanımlayın: operasyon personeli eşlenmemiş ürünleri inceler, Odoo ürününü oluşturur ve başarısız siparişi yeniden işler. Bu, bir eşleme düzeltmesi beklenirken sessiz hataya veya tüm siparişlerin engellenmesine tercih edilir.

Bu entegrasyon birden fazla Shopify mağazasını (ör. farklı market mağazaları) destekleyebilir mi?

Evet, ancak daha fazla karmaşıklıkla. Her Shopify mağazası ayrı bir API bağlantısıdır. Bir Odoo örneği, mağaza kaynağının özel bir alan aracılığıyla izlenmesiyle birden fazla Shopify mağazasından sipariş alabilir. Mağazalar arasında envanter tahsisi ek mantık gerektirir: paylaşılan envanter havuzu (Odoo, sipariş talebine göre mağazalar arasında tahsis eder) veya konuma göre ayrılmış envanter (her mağazanın belirlenmiş bir Odoo konumu vardır). Çoklu mağaza entegrasyonu, test kapsamını ve devam eden bakım yükünü iki katına çıkarır.

---

Sonraki Adımlar

İyi uygulanan Shopify-Odoo entegrasyonu operasyonel verimliliği dönüştürür: manuel veri girişini ortadan kaldırır, fazla satışı önler, gelişmiş raporlamayı etkinleştirir ve e-ticaret satışlarını üretim, satın alma ve finansal süreçlere bağlar.

ECOSIRE, orta ölçekli satıcılar için mimari tasarım, özel geliştirme, veri geçişi, test etme ve sürekli desteği kapsayan Shopify ve Odoo ERP entegrasyonları oluşturur. Entegrasyon ekibimiz, çeşitli ürün kategorilerinde 30'dan fazla satıcı için Shopify-Odoo bağlantılarını uyguladı.

Shopify-Odoo entegrasyon mimarinizi tasarlamak için Entegrasyon ekibimizle iletişime geçin.