التكامل مع BigCommerce

تشرح هذه الصفحة طريقة ربط متجر BigCommerce بنظام نما ERP: إعدادات الاتصال، وكيف تُقرأ طلبات BigCommerce إلى نما، وكيف تُرسَل الأصناف والأسعار وكميات المخزون إلى المتجر.

كيف يعمل التكامل

يُعرَّف متجر BigCommerce في نما بسجل واحد على شاشة Magento Site. هذا هو اسم الشاشة لكل المنصات وليس لماجنتو وحدها، فمتجر BigCommerce هو سجل Magento Site قيمة Site Type فيه هي BigCommerce Site. وتحتاج الشاشة إلى ترخيص magento.

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

الاتصال بـ BigCommerce

يتصل نما بحساب API على مستوى المتجر (store-level API account). أنشئ هذا الحساب من لوحة تحكم BigCommerce مع صلاحية الوصول إلى الطلبات والمنتجات، فيعرض لك BigCommerce رمز الوصول (access token) ومسار API على شكل https://api.bigcommerce.com/stores/abc123xyz/v3/. الجزء الذي بعد /stores/، وهو هنا abc123xyz، هو معرّف المتجر (store hash).

1. افتح تكامل التجارة الإلكترونية ← الملفات ← Magento Site وأنشئ سجلًا جديدًا.
2. اختر في Site Type القيمة BigCommerce Site.
3. اكتب في رابط القيمة https://api.bigcommerce.com/stores/. هذه القيمة واحدة لكل المتاجر، ونما يضيف بعدها معرّف المتجر.
4. اكتب معرّف المتجر في إسم المستخدم (Consumer Key).
5. اكتب رمز الوصول في كلمة المرور (Consumer Secret).
6. اضبط إعدادات الطلبات كما يشرحها دليل تكامل التجارة الإلكترونية.
7. احفظ.

قراءة الطلبات من BigCommerce

يطلب زر قراءة المبيعات من BigCommerce الطلبات التي أُنشئت منذ تاريخ البداية: التاريخ الذي تعطيه لزر قراءة المبيعات من تاريخ، وإلا فالنقطة التي وصلت إليها القراءة السابقة. استخدم قراءة المبيعات من تاريخ في أول قراءة حتى يعرف نما من أين يبدأ.

تُطابَق طلبات BigCommerce باسم الحالة كما يكتبه BigCommerce تمامًا، مثل Pending أو Awaiting Fulfillment. اكتب هذه الأسماء في نقل فقط الأوامر التي حالتها احدي التالي. وإن تركت الحقل فارغًا قرأ نما طلبات الحالة Pending وحدها. أما الطلبات التي حالتها ضمن قراءة الأوامر كمرتجع إذا كانت إحدى الحالات الأتية فتدخل مردودات مبيعات.

تُظهر قراءة المبيعات رسالة نجاح على الشاشة حتى لو تعذّر حفظ بعض الطلبات. الطلبات التي فشلت تظهر مع سبب الفشل في قائمة الأخطاء بتبويب الإحصائيات في الموقع.

يقرأ نما الطلبات من BigCommerce لكنه لا يعدّلها هناك: لا تُرسَل حالة الطلب ولا أي ملاحظة إلى BigCommerce عند حفظ مستند المبيعات. حدّث الطلب من داخل BigCommerce نفسه.

إرسال الأصناف والأسعار والكميات

يجب أن يسمح الخادم بالإرسال

لا يُرسَل شيء من نما إلى أي متجر (لا أصناف ولا أسعار ولا كميات) ما لم يحتوِ ملف nama.properties على الخادم على السطر send-ecommerce-data=true.

يبحث نما عن المنتج في BigCommerce برمز SKU: الرمز الموجود للصنف في ملف ربط الأصناف بموقع ماجنتو، أو كود الصنف إن لم يكن له سطر في ملف الربط. اجعل رموز SKU في BigCommerce مطابقة تمامًا لما في نما.

• الأصناف. عند حفظ صنف، وكان الموقع مضبوطًا على إرسال الأصناف (إرسال الأصناف إلي ماجنتو والإعدادات المرتبطة به المشروحة في الدليل العام)، ينشئ نما المنتج في BigCommerce إن لم يكن رمزه موجودًا، أو يحدّثه إن كان موجودًا. اسم المنتج هو الاسم الإنجليزي للصنف، ووصفه هو الوصف 1 ثم الوصف 2 كلٌّ في سطر.
• الأسعار. يرسل مستند تحديث أسعار ماجنتو السعر الأساسي وسعر العرض. تُرسَل الأسعار وحدها دون تاريخي بداية العرض ونهايته، فيسري سعر العرض في BigCommerce منذ وصوله حتى يتغير.
• الكميات. يستقبل BigCommerce كمية إجمالية واحدة لكل منتج، يرسلها نما آليًا كلما تحرك المخزون. اترك جدول ربط معرفات المخازن الإلكترونية بنما فارغًا في موقع BigCommerce، فالكميات لا تُقسَّم على المخازن. ولإعادة إرسال كميات كل الأصناف اضغط تحديث كميات جميع الأصناف.