Odoo + Shopify Sync: Products, Orders, and Inventory

اس گائیڈ میں Odoo-Shopify کے مکمل انضمام کا احاطہ کیا گیا ہے: فن تعمیر کے فیصلے، پروڈکٹ کیٹلاگ کی مطابقت پذیری، ریئل ٹائم آرڈر امپورٹ، دو طرفہ انوینٹری مینجمنٹ، Shopify ادائیگیوں کا مفاہمت، اور ملٹی اسٹور مینجمنٹ۔

اہم ٹیک ویز

• Shopify کے REST اور GraphQL APIs دونوں معاون ہیں۔ Shopify Plus کے لیے GraphQL کو ترجیح دی گئی۔
• مصنوعات کی مطابقت پذیری دو طرفہ ہے: Odoo میں تخلیق کریں → Shopify پر شائع کریں، یا Shopify سے درآمد کریں
• انوینٹری کی مطابقت پذیری واقعہ پر مبنی ہے: Odoo میں ہر اسٹاک کی نقل و حرکت کو متحرک کرتا ہے۔
• Shopify سے Odoo تک ویب ہک کے آرڈرز فوری آرڈر کی درآمد فراہم کرتا ہے (<30 سیکنڈ)
• Shopify ادائیگیوں کا مفاہمت خود بخود ادائیگیوں، فیسوں اور ریفنڈز کو ہینڈل کرتا ہے۔
• ملٹی لوکیشن انوینٹری Shopify کی ملٹی لوکیشن فیچر سے ہم آہنگ ہوتی ہے۔
• Shopify Plus B2B (تھوک) کیٹلاگ Odoo کی قیمتوں کی فہرست سے لنک کرتے ہیں
• خودکار اسٹاک ایڈجسٹمنٹ کے ساتھ Shopify سے Odoo RMA میں بہاؤ واپس کرتا ہے۔

---

انٹیگریشن آرکیٹیکچر

API نقطہ نظر:

انضمام زیادہ تر کارروائیوں کے لیے Shopify کا REST Admin API استعمال کرتا ہے اور ایونٹ سے چلنے والی اپ ڈیٹس کے لیے ویب ہکس:

• REST API: پروڈکٹ CRUD، آرڈر ریڈ، انوینٹری مینجمنٹ
• GraphQL API: بلک آپریشنز (بڑے کیٹلاگ ایکسپورٹ)، B2B قیمتوں کا تعین (Shopify Plus)
• ویب ہکس: ریئل ٹائم آرڈر تخلیق، آرڈر اپ ڈیٹ، ریفنڈ تخلیق، انوینٹری لیول اپ ڈیٹ

کنکشن ٹوپولوجی:

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

توثیق:

Shopify نجی ایپ API کیز یا کسٹم ایپ OAuth استعمال کرتا ہے:

• نجی ایپ: آسان، سنگل اسٹور انضمام کے لیے تجویز کردہ
• کسٹم ایپ (OAuth): Shopify ایپ اسٹور کی تقسیم یا ملٹی اسٹور مینجمنٹ کے لیے درکار ہے

ECOSIRE کنیکٹر کے لیے، Shopify کے پارٹنر ڈیش بورڈ میں ایک حسب ضرورت ایپ کنفیگر کریں۔

---

Shopify ایپ کنفیگریشن

مرحلہ 1: Shopify میں ایک حسب ضرورت ایپ بنائیں

1. اپنے Shopify منتظم → ترتیبات → ایپس اور سیلز چینلز پر جائیں۔
2. ایپ تیار کریں پر کلک کریں → ایک ایپ بنائیں
3. ایپ کا نام سیٹ کریں (جیسے، "Odoo Integration")
4. API کے دائرہ کار کو ترتیب دیں:

   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. ویب ہک URL سیٹ کریں: https://your-odoo.com/shopify/webhook
6. ایپ انسٹال کریں → کاپی ایڈمن API رسائی ٹوکن

مرحلہ 2: Odoo میں کنفیگر کریں

سیلز → Shopify یا انوینٹری → Shopify اسٹورز پر جائیں:

مرحلہ 3: ویب ہکس رجسٹر کریں

کنفیگریشن کو محفوظ کرنے کے بعد، رجسٹر ویب ہکس پر کلک کریں۔ کنیکٹر سبسکرائب کرتا ہے:

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

---

پروڈکٹ کیٹلاگ کی مطابقت پذیری۔

سیکشن ڈائریکشن کے اختیارات:

تجویز کردہ: Odoo → Shopify نئی تعیناتیوں کے لیے۔ Odoo کا پروڈکٹ ماسٹر بہتر ڈیٹا (خریداری کی معلومات، لاگت، BOM) فراہم کرتا ہے جس کی Shopify کو ضرورت نہیں ہے۔

پروڈکٹ فیلڈ میپنگ:

مختلف ہم آہنگی:

Shopify 3 پروڈکٹ کے اختیارات (رنگ، ​​سائز، مواد) کو زیادہ سے زیادہ 100 ویریئنٹس فی پروڈکٹ کے ساتھ سپورٹ کرتا ہے۔ کنیکٹر اوڈو کی مصنوعات کی خصوصیات کا نقشہ بناتا ہے:

1. Odoo product.template → Shopify پروڈکٹ
2. Odoo product.product (متغیرات) → Shopify متغیرات
3. Odoo انتساب کی قدریں → Shopify آپشن کی قدریں۔

بلک کیٹلاگ مطابقت پذیری:

بڑے کیٹلاگ کے ساتھ ابتدائی سیٹ اپ کے لیے (1000+ مصنوعات):

1. Shopify → Catalog → Bulk Sync پر جائیں
2. مطابقت پذیری کے لیے مصنوعات کے زمرے منتخب کریں۔
3. بلک سنک جاب چلائیں (پس منظر کا عمل)
4. مطابقت پذیری لاگ میں پیشرفت کی نگرانی کریں۔
5. نقشہ سازی کی غلطیوں کا جائزہ لیں اور حل کریں۔

---

آرڈر مینجمنٹ

ویب ہکس کے ذریعے ریئل ٹائم آرڈر کی درآمد:

جب کوئی گاہک Shopify پر آرڈر دیتا ہے تو orders/create ویب ہک سیکنڈوں میں فائر ہوجاتا ہے۔ کنیکٹر:

1. Shopify سے ویب ہک پے لوڈ وصول کرتا ہے۔
2. ویب ہک دستخط کی تصدیق کرتا ہے (HMAC-SHA256)
3. Odoo میں فوری طور پر سیل آرڈر بناتا ہے۔
4. Shopify پر 200 OK لوٹاتا ہے (دوبارہ کوشش کو روکتا ہے)

Shopify چیک آؤٹ سے لے کر Odoo سیل آرڈر تک آخر سے آخر تک کا وقت: عام طور پر 3-15 سیکنڈز۔

ڈیٹا میپنگ کا آرڈر دیں:

حسب ضرورت آرڈر فیلڈز:

اپنی مرضی کے مطابق چیک آؤٹ اوصاف کے ساتھ Shopify Plus مرچنٹس کے لیے:

• اوڈو کسٹم فیلڈز میں میپ شاپائف آرڈر نوٹ کی خصوصیات
• مثال: سیل آرڈر پر "PO نمبر" وصف → x_purchase_order_number
• مثال: "گفٹ میسج" → note سیل آرڈر پر

آرڈر پروسیسنگ ورک فلو:

درآمد کے بعد، کنیکٹر Odoo کے معیاری ورک فلو کے ذریعے آرڈر کا انتظام کرتا ہے:

1. سیل آرڈر کی تصدیق ہو گئی۔
2. Odoo WMS میں ڈیلیوری آرڈر بنایا گیا۔
3. گودام چنتا ہے، پیک، جہاز
4. اوڈو میں ڈیلیوری کی توثیق کی گئی (ٹریکنگ درج کی گئی)
5. کنیکٹر شاپائف کو ٹریکنگ نمبر کے ساتھ تکمیل بھیجتا ہے۔
6. Shopify آرڈر کو "مکمل" کے طور پر نشان زد کرتا ہے اور صارف کو ای میل کرتا ہے۔

جزوی تکمیلات:

Shopify متعدد تکمیلات کے ساتھ آرڈرز کی حمایت کرتا ہے (اب جو دستیاب ہے اسے بھیجیں، بعد میں آرام کریں)۔ کنیکٹر ہینڈل کرتا ہے:

• Odoo میں جزوی ڈیلیوری → جزوی تکمیل Shopify کو بھیجی گئی۔
• Shopify گاہک کو جزوی تکمیل کی حیثیت دکھاتا ہے۔
• جب اسٹاک دستیاب ہو تو باقی آئٹمز علیحدہ ڈیلیوری بناتے ہیں۔

---

انوینٹری کی مطابقت پذیری۔

دو طرفہ انوینٹری کی مطابقت پذیری:

انوینٹری درستگی کو برقرار رکھنے کے لیے دونوں سمتوں میں بہتی ہے:

Odoo → Shopify (بنیادی سمت):

• Odoo میں اسٹاک کی ہر حرکت Shopify پر انوینٹری لیول اپ ڈیٹ کو متحرک کرتی ہے۔
• دستیاب مقدار = ہاتھ پر - محفوظ - حفاظتی اسٹاک
• Shopify کی انوینٹری لیول API کے ذریعے اپ ڈیٹس

Shopify → Odoo (فال بیک):

• اگر Shopify انوینٹری کو دستی طور پر ایڈجسٹ کیا جاتا ہے (ایڈمن یا ایپ)، تو ویب ہک فائر ہو جاتا ہے۔
• کنیکٹر آڈٹ نوٹ کے ساتھ اوڈو انوینٹری ایڈجسٹمنٹ بناتا ہے۔

Shopify ملٹی لوکیشن:

Shopify کی ملٹی لوکیشن فیچر انوینٹری کو فی فزیکل لوکیشن ٹریک کرتی ہے۔ Shopify مقامات پر Odoo کے گوداموں کا نقشہ بنائیں:

کنیکٹر گودام-مقام کی نقشہ سازی کی بنیاد پر فی مقام کی مقدار کو Shopify پر دھکیلتا ہے۔

انوینٹری کی درستگی کے تحفظات:

• سیفٹی اسٹاک بفر Shopify کو تمام دستیاب انوینٹری دکھانے سے روکتا ہے۔
• آؤٹ آف اسٹاک ہینڈلنگ: جب مقدار 0 تک پہنچ جائے، Shopify انوینٹری = 0 (منفی نہیں)
• اسٹاک ختم ہونے پر فروخت جاری رکھیں: فی پروڈکٹ ترتیب دینے کے قابل (کچھ بیچنے والے بیک آرڈر کی اجازت دیتے ہیں)

---

Shopify ادائیگیوں کا مفاہمت

Shopify ادائیگیوں کی فیس کا ڈھانچہ:

ادائیگی کی مفاہمت:

Shopify ادائیگیاں ہر 2-3 کاروباری دنوں میں آپ کے بینک اکاؤنٹ میں بھیجی جاتی ہیں۔ کنیکٹر ادائیگی کا ڈیٹا درآمد کرتا ہے:

1. Shopify ادائیگیوں کی ادائیگی کی رپورٹ ڈاؤن لوڈ کریں (یا API کے ذریعے)
2. Shopify → Finance → Import Payout کے ذریعے درآمد کریں
3. کنیکٹر جرنل اندراجات تخلیق کرتا ہے:

• آمدنی (فی آرڈر کی خالص فروخت کی مقدار)
• Shopify فیس کا خرچ (ادائیگی کی کارروائی)
• ریفنڈ ایڈجسٹمنٹس
• خالص ادائیگی قابل وصول

4. جب بینک ٹرانسفر آتا ہے: Shopify ادائیگیوں کے جرنل کے خلاف صلح کریں۔

** Shopify ریفنڈز کو ہینڈل کرنا:**

جب Shopify میں رقم کی واپسی پر کارروائی کی جاتی ہے:

1. refunds/create ویب ہک فائر
2. کنیکٹر Odoo میں اصل انوائس کے خلاف کریڈٹ نوٹ بناتا ہے۔
3. اگر اسٹاک واپس کر دیا گیا (دوبارہ ذخیرہ کیا گیا): واپسی کی منتقلی تخلیق کرتا ہے۔
4. پوسٹس کریڈٹ نوٹ → کسٹمر اکاؤنٹ کے خلاف بیلنس کلیئر کر دیا گیا۔

---

Shopify Plus B2B انٹیگریشن

Shopify Plus میں B2B خصوصیات شامل ہیں (تھوک کیٹلاگ، ادائیگی کی شرائط، خالص ادائیگی)۔ کنیکٹر ان کو Odoo کی B2B قیمتوں کے ساتھ مربوط کرتا ہے:

کمپنی اور کیٹلاگ میپنگ:

مطابقت پذیری B2B قیمت:

1. کنیکٹر میں Shopify B2B کیٹلاگ بنائیں
2. اوڈو پرائس لسٹ سے لنک کریں۔
3. Shopify B2B کمپنیوں کو تفویض کریں۔
4. Odoo پرائس لسٹ میں قیمتوں کی تبدیلیاں → خود بخود Shopify B2B کیٹلاگ میں دھکیل دی گئیں۔

---

ملٹی اسٹور مینجمنٹ

ایک سے زیادہ Shopify اسٹورز چلانے والے برانڈز کے لیے (علاقے، برانڈز، ہول سیل بمقابلہ خوردہ):

متعدد اسٹور کنفیگریشنز:

ہر Shopify اسٹور کے لیے الگ کنیکٹر کنفیگریشنز بنائیں:

• فی اسٹور مختلف API اسناد
• اسٹور کے لیے مخصوص مصنوعات کی مرئیت (کچھ مصنوعات تمام اسٹورز میں، کچھ مخصوص میں)
• اسٹور کے لیے مخصوص قیمتوں کا تعین (علاقائی قیمتوں کا تعین، تھوک بمقابلہ خوردہ)
• اسٹور کے لیے مخصوص انوینٹری مختص کرنا

** اسٹورز میں انوینٹری مختص:**

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

جب ایک ہی انوینٹری سے ایک سے زیادہ اسٹورز آتے ہیں تو اوور سیلنگ کو روکنے کے لیے مختص کے قوانین کو ترتیب دیں۔

---

اکثر پوچھے گئے سوالات

کنیکٹر اپنی مرضی کے ڈیٹا کے لیے Shopify کے پروڈکٹ میٹا فیلڈز کو کیسے ہینڈل کرتا ہے؟

Shopify metafields پروڈکٹس، آرڈرز اور کسٹمرز پر حسب ضرورت ڈیٹا اسٹور کرتا ہے۔ کنیکٹر مخصوص اوڈو فیلڈز کو Shopify میٹا فیلڈز کے لیے نقشہ بناتا ہے۔ مثال کے طور پر، اوڈو کے x_care_instructions فیلڈ کو product.care_instructions میٹا فیلڈ میں نقشہ بنائیں۔ میٹا فیلڈ میپنگ کو کنیکٹر کی ایڈوانس سیٹنگز فی ریسورس ٹائپ میں کنفیگر کریں۔

کیا کنیکٹر Shopify کے سبسکرپشن پروڈکٹس (Shopify سبسکرپشنز یا ری چارج) کو سنبھال سکتا ہے؟

معیاری Shopify سبسکرپشن آرڈرز Odoo میں باقاعدہ آرڈرز کے طور پر درآمد کرتے ہیں۔ ری چارج سبسکرپشنز کے لیے، بار بار آنے والے آرڈرز انفرادی orders/create ویب ہکس کے بطور فائر ہوتے ہیں اور عام طور پر درآمد کرتے ہیں۔ کنیکٹر Shopify میں سبسکرپشن لائف سائیکل کا انتظام نہیں کرتا ہے - یہ ہر آرڈر پر کارروائی کرتا ہے چاہے وہ سبسکرپشن سے تیار کیا گیا ہو یا ایک بار۔

اگر Shopify ویب ہک فائر ہونے پر Odoo سرور ڈاؤن ہو تو کیا ہوگا؟

Shopify 48 گھنٹوں میں 19 بار ناکام ویب ہکس کی دوبارہ کوشش کرتا ہے۔ کنیکٹر ویب ہک پر کارروائی کرتا ہے جب Odoo ٹھیک ہوجاتا ہے، اور آرڈر درآمد ہوتا ہے۔ مشن کی اہم اعتبار کے لیے، اوڈو کو فالتو انفراسٹرکچر (لوڈ بیلنسر + ایک سے زیادہ ورکرز) اور ڈاؤن ٹائم کے لیے مانیٹرنگ الرٹس کے ساتھ ترتیب دیں۔ 48 گھنٹے کی دوبارہ کوشش کرنے والی ونڈو منصوبہ بند دیکھ بھال کے لیے ایک بفر فراہم کرتی ہے۔

کیا کنیکٹر Shopify مارکیٹس (ملٹی کرنسی انٹرنیشنل سیلنگ) کو سپورٹ کرتا ہے؟

جی ہاں Shopify مارکیٹس ایک اسٹور سے متعدد کرنسیوں میں فروخت کی اجازت دیتا ہے۔ کنیکٹر خریدار کی چیک آؤٹ کرنسی میں آرڈرز درآمد کرتا ہے اور Odoo میں اس کرنسی میں سیل آرڈر بناتا ہے۔ کرنسی کی تبدیلی آرڈر کی درآمد کے وقت ایکسچینج ریٹ کا استعمال کرتی ہے۔ درست مقامی قیمتوں کے تعین کے لیے اوڈو میں فی Shopify مارکیٹ کے لیے الگ الگ قیمت کی فہرستیں ترتیب دیں۔

میں Odoo میں Shopify گفٹ کارڈز کو کیسے ہینڈل کروں؟

Shopify گفٹ کارڈز آرڈرز پر ادائیگی کے طریقے کے طور پر ظاہر ہوتے ہیں۔ کنیکٹر ہر آرڈر کے گفٹ کارڈ والے حصے کے لیے علیحدہ ادائیگی لائن بناتا ہے۔ Odoo میں ایک "Shopify گفٹ کارڈز" ذمہ داری اکاؤنٹ تشکیل دیں۔ جب گفٹ کارڈ فروخت کیا جاتا ہے (گفٹ کارڈ پروڈکٹ کے ذریعے)، تو محصول موخر کر دیا جاتا ہے۔ جب کسی آرڈر پر چھڑایا جاتا ہے، تو ذمہ داری صاف ہو جاتی ہے اور محصول کو تسلیم کیا جاتا ہے۔

---

اگلے اقدامات

Odoo-Shopify کا ایک اچھی طرح سے انجام دیا گیا انضمام پوشیدہ ہو جاتا ہے — یہ صرف کام کرتا ہے، دونوں سسٹمز کو دستی مداخلت کے بغیر مطابقت پذیر رکھتے ہوئے ECOSIRE ٹیم نے D2C برانڈز سے لے کر روزانہ 10,000 آرڈرز کو سنبھالنے والے انٹرپرائز ریٹیلرز تک ہر چیز کے لیے Shopify-Odoo انٹیگریشنز بنائے ہیں۔

اپنے Shopify-Odoo انٹیگریشن کے بارے میں ECOSIRE سے رابطہ کریں →

ECOSIRE کی Shopify سروسز کو دریافت کریں →

اپنے اسٹور کی تفصیلات اور موجودہ درد کے پوائنٹس کا اشتراک کریں اور ہماری ٹیم ایک Shopify-Odoo انٹیگریشن کا دائرہ کار بنائے گی جو آپ کے ERP اور آپ کے اسٹور فرنٹ کے درمیان فرق کو ختم کرتا ہے۔