إنتقل إلى المحتوى الرئيسي

تكامل التجارة الإلكترونية

يربط التكامل متجرًا إلكترونيًا بـ Nadigit IMS. يبقى Nadigit IMS المرجع للأصناف والأسعار والضرائب والمخزون، ويرسل إليه المتجر طلباته.

ما تتم مزامنته​

الاتجاهما ينتقل
من Nadigit IMS إلى المتجركتالوج المستودع المرتبط (الاسم، الوصف، الفئة، السعر، الضريبة، الصور، الرموز الشريطية) والكميات المتاحة. يُبلَّغ المتجر بكل تغيّر في المخزون، سواء جاء من نقطة البيع أو عملية شراء أو شطب أو تحويل أو إرجاع. ويُسحب الصنف المعطّل أو النافد من البيع الإلكتروني.
من Nadigit IMS إلى المتجرحالة طلبات الويب: قيد المعالجة، مُسلَّم، ملغى، مُرجَع، وحالة الدفع.
من المتجر إلى Nadigit IMSالطلبات المُنجزة عبر الإنترنت، وتُسجَّل كمبيعات، وإلغاءاتها.

المتطلبات​

  • باقة Enterprise.
  • في المستودع الذي سيبيع منه المتجر: أصناف نشطة لها سعر بيع ومخزون.
  • متجر في Nadigit IMS تُربط به المبيعات الإلكترونية، فتبقى منفصلة عن مبيعات نقطة البيع في التقارير.
  • يجب أن يتمكن المتجر الإلكتروني وNadigit IMS من الاتصال ببعضهما عبر HTTPS.
  • دور مسؤول.
متجر إلكتروني واحد، مستودع واحد

يرتبط كل متجر إلكتروني بـمستودع واحد ومتجر واحد. لبيع مخزون مستودعين عبر الإنترنت، أنشئ تكاملين.

المنصّات​

المنصّةالموصّل
Bagistoموصّل تقدّمه Nadigit
Shopify، WooCommerce، مخصّصةموصّل يُطوَّر على واجهة التكامل البرمجية

ربط متجر إلكتروني​

1. تسجيل المتجر​

  1. افتح إعدادات النظام ← الإعدادات العامة، تبويب التكاملات، ثم تكاملات التجارة الإلكترونية.
  2. انقر على تكامل جديد واملأ:
    • المنصّة والاسم؛
    • رابط المتجر، أي عنوانه العام؛
    • المستودع والمتجر المرتبطين، وهما إلزاميان قبل التزويد؛
    • مسار الـ webhook، أي العنوان في المتجر الذي يستقبل إشعارات Nadigit IMS. القيمة المقترحة تناسب موصّل Bagisto؛
    • سرّ الـ webhook (HMAC): اتركه فارغًا، فالتزويد يولّده.
  3. انقر على حفظ.

2. تزويد الموصّل​

في القائمة، انقر على تزويد الموصّل في سطر المتجر. يُنشئ Nadigit IMS هوية الموصّل: حسابًا تقنيًا لا يصل إلا إلى واجهة التكامل البرمجية، ولا يخصّ إلا المستودع والمتجر المرتبطين.

تعرض نافذة إعدادات الموصّل حينها:

  • عنوان Nadigit IMS وعنوان الحصول على الرموز؛
  • معرّف العميل وسرّ العميل؛
  • سرّ الـ webhook.
انسخ الإعدادات فورًا

تنبّه النافذة إلى أن السرّين لا يُعرضان إلا في هذه اللحظة: انقر على نسخ JSON واحتفظ به في مكان آمن حتى الخطوة التالية. يمكن إعادة التزويد دون خطر: فهو لا يغيّر حساب الموصّل ولا أسراره.

3. تثبيت الموصّل في المتجر​

بالنسبة لـ Bagisto:

  1. ثبّت في المتجر الموصّل الذي تقدّمه Nadigit.
  2. في إدارة Bagisto، افتح Configure ← ERP Connector واستورد ملف JSON المنسوخ في الخطوة 2.
  3. احفظ، ثم انقر على Test Connection.
لمسؤول متجر Bagisto

يجب تفعيل إضافة PHP ‏intl. بعد تثبيت الموصّل، امسح ذاكرة التطبيق المؤقتة (php artisan optimize:clear)، وإلا فلن تُرسَل الطلبات.

4. التحقق​

بالعودة إلى تكاملات التجارة الإلكترونية، يعرض سطر المتجر مُزوّد. يتحقق زر اختبار الاتصال من وصول Nadigit IMS إلى المتجر، ويُظهر عمود آخر مزامنة آخر تبادل في كل اتجاه: وارد وصادر.

الطلبات الإلكترونية​

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

ممارسات جيدة​

  • عدّل الكتالوج في Nadigit IMS لا في المتجر: فـ Nadigit IMS هو المرجع، وتُرسَل تغييراته إلى المتجر.
  • بعد بدء التشغيل، تحقق من بعض الأصناف في المتجر: السعر والضريبة والمخزون والصور.
  • وحّد الضرائب في الطرفين قبل فتح البيع الإلكتروني.
  • حذف تكامل يوقف المزامنة مع ذلك المتجر فورًا.

انظر أيضًا​