تكامل Shopify + Odoo ERP: الدليل الكامل

مع توسع متاجر Shopify، تصبح الفجوة بين ما يتعامل معه Shopify محليًا وما يحتاجه العمل فعليًا لتحقيق التميز التشغيلي عائقًا كبيرًا. إدارة المخزون عبر مستودعات متعددة، والمحاسبة متعددة العملات، وأوامر التصنيع التي يتم تشغيلها بواسطة مبيعات Shopify، وإدارة علاقات العملاء المتطورة مع سجل العملاء الكامل، والتجديد الآلي للبائعين — تتطلب هذه الأمور نظام تخطيط موارد المؤسسات (ERP)، وأصبح Odoo بشكل متزايد هو النظام المفضل لشركات التجارة الإلكترونية في السوق المتوسطة.

Shopify + Odoo ليس تكامل التوصيل والتشغيل. يتطلب الأمر قرارات معمارية دقيقة حول النظام الذي يمتلك البيانات، وما الذي تتم مزامنته في أي اتجاه، وكيفية التعامل مع حالات الحافة مثل الشحنات الجزئية، ومعالجة الإرجاع، وتعيين المتغيرات. يغطي هذا الدليل كل شيء بدءًا من بنية التكامل وحتى أنماط التنفيذ المحددة.

الوجبات الرئيسية

• أودو هو المصدر الحقيقي للمخزون والعملاء والمحاسبة؛ Shopify هو مصدر الحقيقة لمعاملات التجارة الإلكترونية
• مزامنة المخزون ثنائية الاتجاه (Shopify → Odoo للطلبات، Odoo → Shopify لمستويات المخزون) هي متطلبات التكامل الأساسية
• يجب أن تكون إدارة كتالوج المنتجات موجودة في Odoo وأن تتم مزامنتها مع Shopify - وليس العكس
• يتم دمج سجلات العملاء بين الأنظمة باستخدام البريد الإلكتروني كمعرف فريد
• دورة حياة الطلب: يقوم Shopify بإنشاء الطلب ← يتلقى Odoo الطلب ← يقوم Odoo بإنشاء التسليم ← تحديثات التنفيذ Shopify
• تتطلب معالجة الإرجاع التنسيق: يبدأ Shopify الإرجاع ← يعالج Odoo الاستلام ← يتم تحديث كلا النظامين
• توفر واجهة برمجة تطبيقات Webhook الخاصة بـ Shopify أحداث الطلب في الوقت الفعلي؛ يتلقى Odoo هذه العناصر عبر البرامج الوسيطة للموصل
• توجد موصلات Odoo-Shopify المباشرة (Syncee وOdooConnector) ولكن عمليات التكامل المخصصة عبر REST API توفر المزيد من التحكم

---

فهم بنية التكامل

قبل التنفيذ، حدد النظام المعتمد لكل مجال بيانات:

لماذا يمتلك Odoo مخزونًا:

يعد تتبع مخزون Shopify وظيفيًا ولكنه محدود للعمليات متعددة المستودعات ومتعددة القنوات. تتعامل وحدة المخزون في Odoo مع: تتبع الكمية والرقم التسلسلي، وإدارة المستودعات متعددة المواقع، وقواعد التجديد الآلي، وتكامل التصنيع (مخزون مكونات إنقاص البضائع تامة الصنع)، وعمليات التنفيذ المستندة إلى الرمز الشريطي. يجب أن يعكس Shopify واقع مخزون Odoo، وليس العكس.

** لماذا Shopify هي طبقة التجارة **:

تعد عمليات الدفع ومعالجة الدفع وحساب معدل الشحن وتحصيل الضرائب وتجربة التعامل مع العملاء هي الأفضل في فئتها. تعتبر التجارة الإلكترونية بين الشركات والمستهلكين (موقع Odoo الإلكتروني) الخاصة بـ Odoo وظيفية ولكنها ليست على مستوى Shopify فيما يتعلق بتجارة DTC. تحافظ البنية المثالية على Shopify كواجهة التجارة وOdoo باعتباره العمود الفقري التشغيلي.

---

طرق التكامل: تطبيقات الموصل مقابل واجهة برمجة التطبيقات المخصصة

الخيار 1: تطبيقات الموصل المعدة مسبقًا

توفر العديد من تطبيقات Shopify وOdoo للسوق تكاملًا تم إنشاؤه مسبقًا:

تعمل الموصلات المعدة مسبقًا بشكل جيد مع: كتالوج المنتجات القياسي ومزامنة الطلبات لنماذج الأعمال البسيطة بدون هياكل متغيرة معقدة أو مستودعات متعددة أو تبعيات التصنيع.

الخيار 2: التكامل المخصص عبر واجهات برمجة التطبيقات

بالنسبة لمتطلبات الأعمال المعقدة، يوفر التكامل المخصص باستخدام واجهة برمجة تطبيقات REST/GraphQL الخاصة بـ Shopify وواجهة برمجة تطبيقات JSON-RPC/REST الخاصة بـ Odoo أكبر قدر من التحكم والموثوقية.

بنية التكامل المخصصة:

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

مجموعة التكنولوجيا للتكامل المخصص:

• البرامج الوسيطة: Node.js (لمحاذاة نظام Shopify البيئي) أو Python (لمحاذاة نظام Odoo البيئي)
• قائمة الانتظار: Redis أو RabbitMQ لمعالجة الأحداث بشكل موثوق
• قاعدة البيانات: PostgreSQL لحالة التكامل، ومفاتيح الفاعلية، وسجلات الأخطاء
• الاستضافة: AWS Lambda أو ما شابه ذلك لمعالجات webhook (تتدرج تلقائيًا مع ارتفاع حركة المرور في Shopify)

---

مزامنة الطلب: Shopify → Odoo

تعد مزامنة الطلب هي مسار التكامل الأكثر أهمية. يجب على كل طلب من Shopify إنشاء أمر بيع Odoo مطابق يؤدي إلى التنفيذ وتحديث السجلات المالية.

** إعداد Shopify webhook لأحداث الطلب **:

// 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 إلى أمر بيع على Odoo:

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
    }

التعامل مع العجز الجنسي:

قد يقوم Shopify بتسليم نفس حدث webhook عدة مرات (إعادة محاولة الشبكة). يجب أن يتعامل تكاملك مع الأحداث المكررة بأمان:

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

---

مزامنة المخزون: Odoo → Shopify

يجب أن تعكس مستويات المخزون واقع Odoo في Shopify في الوقت الفعلي (أو في الوقت الفعلي تقريبًا) لمنع الإفراط في البيع.

مزامنة المخزون المستندة إلى المشغل:

النهج الأكثر موثوقية هو المزامنة المستندة إلى الأحداث: عندما يتغير المخزون في Odoo (البيع، استلام الشراء، إكمال التصنيع، تعديل المخزون)، يدفع Odoo الكمية المحدثة إلى Shopify.

# 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
    )

** تسوية المخزون المجدولة **:

حتى مع المزامنة المستندة إلى الأحداث، قم بجدولة تسوية المخزون الكاملة يوميًا:

1. قم بتصدير جميع كميات منتجات Odoo من موقع Shopify-sync المخصص
2. قارن مع مستويات مخزون Shopify الحالية
3. قم بتحديث أي اختلافات (قد تحدث بسبب أحداث المزامنة الفاشلة، والتعديلات اليدوية)
4. سجل نتائج التسوية لأغراض التدقيق

تمنع هذه التسوية انجراف المخزون من حالات فشل المزامنة الصغيرة المتراكمة.

---

مزامنة كتالوج المنتجات: Odoo → Shopify

بالنسبة للشركات التي تدير كتالوجات المنتجات في Odoo (مع تسعير متعدد العملات، ومواصفات تفصيلية، ومصفوفات متغيرة معقدة)، فإن مزامنة الكتالوج مع Shopify تقضي على الإدخال المزدوج اليدوي.

بنية تعيين المنتج:

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 إلى Shopify:

• اسم المنتج (وصف مبيعات Odoo)
• وصف المنتج (وصف HTML طويل)
• الصور (صور قالب المنتج)
• السعر (باستخدام قائمة أسعار Shopify التي تم تكوينها)
• SKU (المرجع الداخلي لـ Odoo)
• الرمز الشريطي (EAN/UPC من Odoo)
• الوزن (لحساب الشحن)
• الحالة النشطة/المؤرشفة (إلغاء النشر في Shopify عند أرشفة منتج Odoo)
• الجرد (من موقع المزامنة المعين)

ما لا يجب مزامنته من Odoo إلى Shopify:

• البيانات التعريفية الخاصة بـ SEO الخاصة بـ Shopify (علامات العنوان والأوصاف التعريفية - الإدارة في Shopify)
• علامات المنتج Shopify (الإدارة في Shopify)
• مجموعات/فئات Shopify (الإدارة في Shopify)
• محتوى خاص بـ Shopify (أقسام منشئ الصفحات والأوصاف الغنية المنسقة لـ Shopify)

---

إدارة بيانات العملاء

يحتاج العملاء الموجودون في كل من Shopify (من حساب واجهة المتجر الخاص بهم) وOdoo (كجهات اتصال/شركاء) إلى الدمج الدقيق لإنشاء ملف تعريف موحد واحد.

استراتيجية إلغاء البيانات المكررة باستخدام البريد الإلكتروني:

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

معرفات عملاء Shopify المخزنة في Odoo:

قم بإضافة حقل مخصص shopify_customer_id إلى نموذج res.partner الخاص بـ Odoo. يتيح ذلك البحث ثنائي الاتجاه: ابحث عن شريك Odoo من معرف Shopify، وابحث عن عميل Shopify من شريك Odoo.

---

حلقة التنفيذ: Odoo → Shopify

عندما يقوم Odoo بمعالجة التسليم (الاختيار + التحقق من صحة)، يتم تنفيذ الطلب. يجب إخطار Shopify إلى:

• وضع علامة على الطلب على أنه مكتمل
• إرسال رسالة تأكيد الشحن إلى العميل بالبريد الإلكتروني
• سجل رقم التتبع

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
        ]
    })

---

التكامل المحاسبي: Shopify Sales → Odoo Financials

يجب أن تظهر كل عملية بيع في Shopify في النهاية في وحدة المحاسبة الخاصة بـ Odoo كإدخال بيع منشور.

منهج التكامل للمحاسبة:

الخيار 1 — المحاسبة على مستوى الطلب: يقوم كل طلب في Shopify بإنشاء فاتورة Odoo (أو يقوم أمر بيع Odoo بإنشاء فاتورة عند استيفائه). تؤدي المدفوعات المسجلة في Shopify إلى تسجيل الدفع في Odoo.

الخيار 2 — المحاسبة على مستوى التسوية: يتم تسجيل تسويات مدفوعات Shopify (الودائع المصرفية اليومية أو الأسبوعية) في Odoo كإدخالات دفتر يومية تتم التسوية مع المعاملات المصرفية. يعد هذا أسهل في الصيانة ولكنه يوفر محاسبة أقل تفصيلاً.

بالنسبة لمعظم تجار السوق المتوسطة، تعد المحاسبة على مستوى التسوية (الخيار 2) كافية وأقل تعقيدًا بشكل ملحوظ في التنفيذ والصيانة.

بيانات دفع Shopify → إدخال دفتر يومية Odoo:

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()

---

الأسئلة المتداولة

ما المدة التي يستغرقها تنفيذ التكامل بين Shopify-Odoo؟

يستغرق التكامل الأساسي (مزامنة الطلب، ومزامنة المخزون، ومزامنة العملاء) باستخدام موصل مُنشأ مسبقًا من 2 إلى 4 أسابيع، بما في ذلك التكوين والاختبار وترحيل البيانات. يستغرق التكامل المخصص الذي يغطي دورة الحياة الكاملة (الطلبات، والمخزون، ومزامنة التنفيذ، والمرتجعات، والمحاسبة) من 8 إلى 16 أسبوعًا اعتمادًا على مدى تعقيد الأعمال. تضيف السيناريوهات المعقدة - المستودعات المتعددة، والتصنيع، والعملات المتعددة، وشركات Odoo المتعددة - 4-8 أسابيع إضافية. ميزانية الصيانة المستمرة: تتطلب عمليات التكامل تحديثات عند تغيير واجهة برمجة تطبيقات إصدار Shopify أو Odoo.

هل يجب علي إدارة المنتجات في Shopify أو Odoo؟

للحصول على كتالوجات المنتجات البسيطة: قم بالإدارة في Shopify وقم بتحديث Odoo يدويًا لأغراض التصنيع/المشتريات. بالنسبة للكتالوجات المعقدة (العديد من المتغيرات، والتسعير متعدد العملات، والمواصفات الفنية، وقائمة مكونات الصنف للتصنيع): قم بالإدارة في Odoo والمزامنة مع Shopify. العامل الحاسم هو المكان الذي يعمل فيه فريق المنتج الخاص بك فعليًا. إذا كان فريق التسويق الخاص بك يعيش في Shopify، فإن إجبارهم على العمل في Odoo يؤدي إلى حدوث احتكاك. إذا كان فريق العمليات الخاص بك يدير المنتجات في Odoo للتصنيع والمشتريات، فإن مزامنة Shopify هي النهج الصحيح.

ماذا يحدث لطلبات Shopify الحالية عندما يبدأ التكامل؟

لا تحتاج الأوامر التاريخية إلى الانتقال إلى Odoo. يقوم التكامل بمعالجة الطلبات الجديدة بدءًا من تاريخ البدء فصاعدًا. بالنسبة للبيانات التاريخية (سجلات العملاء، وكتالوج المنتجات، وخطوط الأساس للمخزون)، قم بإجراء ترحيل البيانات لمرة واحدة قبل بدء التكامل: قم باستيراد بيانات العملاء التاريخية إلى Odoo، واستيراد كتالوج المنتجات، وتعيين خطوط الأساس للمخزون في Odoo لمطابقة كميات Shopify الحالية.

كيف أتعامل مع طلبات Shopify مع منتجات غير موجودة في Odoo؟

تكسر حالة الحافة هذه عمليات التكامل الساذجة. إنشاء بديل: عندما يحتوي طلب Shopify على معرف متغير لا يرتبط بمنتج Odoo، قم بإنشاء الطلب في Odoo باستخدام عنصر نائب لمنتج "منتج غير معروف" وقم بتنبيه فريق التكامل الخاص بك. حدد قائمة انتظار الأخطاء مع الإشعار: يقوم موظفو العمليات بمراجعة المنتجات غير المعينة، وإنشاء منتج Odoo، وإعادة معالجة الطلب الفاشل. ويُفضل هذا بدلاً من الفشل الصامت أو حظر كافة الأوامر أثناء انتظار إصلاح التعيين.

هل يمكن لهذا التكامل دعم متاجر Shopify المتعددة (على سبيل المثال، متاجر السوق المختلفة)؟

نعم، ولكن مع تعقيد إضافي. كل متجر Shopify عبارة عن اتصال API منفصل. يمكن لمثيل Odoo واحد تلقي الطلبات من متاجر Shopify متعددة، مع تتبع مصدر المتجر عبر حقل مخصص. يتطلب تخصيص المخزون بين المتاجر منطقًا إضافيًا: إما مجمع مخزون مشترك (يقوم Odoo بالتخصيص عبر المتاجر بناءً على طلب الطلب) أو مخزون منفصل حسب الموقع (كل متجر له موقع Odoo محدد). يضاعف التكامل متعدد المتاجر نطاق الاختبار وعبء الصيانة المستمرة.

---

الخطوات التالية

يؤدي تكامل Shopify-Odoo الذي تم تنفيذه جيدًا إلى تحويل الكفاءة التشغيلية: القضاء على إدخال البيانات يدويًا، ومنع البيع الزائد، وتمكين التقارير المتطورة، وربط مبيعات التجارة الإلكترونية بالتصنيع والمشتريات والعمليات المالية.

تقوم ECOSIRE بإنشاء Shopify وعمليات دمج Odoo ERP لتجار السوق المتوسطة - والتي تغطي التصميم المعماري، والتطوير المخصص، وترحيل البيانات، والاختبار، والدعم المستمر. قام فريق التكامل لدينا بتنفيذ اتصالات Shopify-Odoo لأكثر من 30 تاجرًا عبر فئات المنتجات المتنوعة.

اتصل بفريق التكامل لدينا لتصميم بنية التكامل بين Shopify-Odoo.