تكامل التجارة الموحدة

Unicommerce عبارة عن مجمع للعديد من منصات التجارة الإلكترونية التي تسمح لك ببيع العناصر من خلال العديد من الأسواق المدعومة وطلب المعالجة عبر واجهة موحدة تسمى Uniware. تعرف على المزيد حول Unicommerce في https://unicommerce.com/

التكامل BITEX مع Unicommerce

تقدم BITEX تكاملاً كاملاً ثنائي الاتجاه مع Unicommerce باستخدام واجهات برمجة تطبيقات REST الخاصة بـ Uniware. يتم توفير هذا التكامل باستخدام تطبيق Frappe المدعوم رسميًا من قبل فريق Frappe. على نطاق واسع يغطي هذا التكامل:

1. مزامنة كتالوج العناصر مع Unicommerce (ثنائي الاتجاه)
2. مزامنة المخزون (اتجاه واحد من BITEX إلى Unicommerce)
3. مزامنة أوامر المبيعات الجديدة
4. مزامنة فاتورة المبيعات أو إنشاء فاتورة المبيعات (يجب استخدام أي خيار واحد)

تثبيت التطبيق

• If you are hosting your BITEX site on Frappe Cloud, you can quickly install the app by going to your site Dashboard. The app is available in Frappe Cloud Marketplace
• إذا كان موقعك مستضافًا بواسطة Frappe، فيرجى رفع تذكرة دعم لتثبيت التطبيق على موقعك.
• If you are self hosting BITEX you can install the app using Frappe bench. Refer bench documentation for installing Frappe Apps. bench get-app ecommerce_integrations --branch main

المصادقة والإعداد الأساسي

1. بمجرد تثبيت التطبيق، انتقل إلى صفحة "إعدادات Unicommerce".
2. انقر فوق مربع الاختيار "تمكين Unicommerce".
3. أدخل موقع Unicommerce الخاص بك، واسم المستخدم وكلمة المرور.
4. تتم إضافة معرف العميل بشكل افتراضي، ولكن إذا قمت بتكوين معرف عميل منفصل، فستحتاج إلى تحديثه هنا. إذا لم تكن متأكدًا من معرف العميل الخاص بك، فيرجى الاتصال بفريق دعم Unicommerce.
5. انقر فوق "حفظ" سيؤدي هذا إلى بدء عملية المصادقة مع Unicommerce وإعداد الحقول المخصصة للتكامل.
6. بمجرد الانتهاء من هذا الإعداد، سترى رموز الوصول/التحديث المميزة في قسم "تفاصيل المصادقة". وهذا يعني أن المصادقة كانت ناجحة ويمكنك الآن بدء العمل على مزيد من الإعداد.

في حالة فشل المصادقة:

1. الرجاء إعادة التحقق من التفاصيل المدخلة.
2. قد يتم إدراج الخادم الخاص بك في القائمة المحظورة بواسطة جدار الحماية. تواصل مع فريق دعم Unicommerce لإدراج عنوان IP الخاص بخادمك في القائمة البيضاء.

مزامنة العنصر

يتحقق هذا التكامل من العناصر التي تم إنشاؤها حديثًا ويقوم بتحميلها إلى Unicommerce على أساس كل ساعة. لتمكين هذه الميزة، تحتاج إلى إعداد ما يلي:

1. انتقل إلى "إعدادات Unicommerce" وقم بتمكين "تحميل عناصر جديدة إلى Unicommerce".
2. قم بتعيين مجموعة عناصر افتراضية. يتم استخدام هذا فقط كإجراء احتياطي في حالة فقدان مجموعة العناصر.
3. أثناء إنشاء عنصر جديد، حدد مربع الاختيار "المزامنة مع Unicommerce"، لتحميل هذا العنصر إلى Unicommerce.
4. يمكن أيضًا تمكين مربع الاختيار هذا على العناصر الموجودة.

كود Unicommerce SKU غير قابل للتغيير، وبالتالي لا ينبغي عليك تغيير رمز السلعة بعد الإنشاء.

من أجل مزامنة مجموعة العناصر بشكل صحيح مع فئات المنتجات، يتعين عليك تعيين جميع مجموعات العناصر إلى فئات المنتجات الخاصة بها على Unicommerce.

لتعيين مجموعة العناصر إلى فئة المنتج:

1. ابحث أولاً عن رمز فئة المنتج على Unicommerce.
2. افتح مجموعة العناصر ذات الصلة على BITEX وقم بتحديث رمز فئة منتج Unicommerce هناك.

تعيين حقل مزامنة العنصر كما يلي:

مزامنة المخزون

بمجرد إعداد مزامنة العنصر، يمكن تمكين مزامنة المخزون. يتحقق التكامل من التغييرات في مخزون BITEX ويدفعها إلى Unicommerce على الفاصل الزمني الذي تم تكوينه. تعتبر مستويات مخزون BITEX مصدرًا للحقيقة من خلال التكامل ويتم استبدال مستويات مخزون Unicommerce بواسطة قيم مخزون BITEX.

1. انتقل إلى "إعدادات Unicommerce" وانتقل للأسفل إلى قسم "مزامنة المخزون".
2. حدد "تمكين مزامنة المخزون"
3. تكوين تردد المزامنة. التردد الموصى به هو من 15 إلى 60 دقيقة.
4. في جدول تعيين المستودعات، أضف جميع رموز المنشأة الموجودة لديك في Unicommerce وقم بتعيينها باستخدام مستودع BITEX.
5. حدد مربع الاختيار "ممكّن" لجميع المرافق التي تريد تمكينها.
6. احفظ الإعدادات.

ملاحظة: يتم دفع كافة المخزون إلى الرف "الافتراضي". أرفف Unicommerce غير مدعومة من خلال هذا التكامل، تأكد من أن لديك رفًا واحدًا فقط على Unicommerce يسمى "DEFAULT" لضمان صحة مزامنة المخزون.

ملاحظة: Unicommerce، مثل عمليات التكامل الأخرى للتجارة الإلكترونية، لا يدعم المخزون الجزئي.

معالجة أوامر المبيعات - سير العمل

فيما يلي سير العمل لمعالجة الطلبات على BITEX. يمكنك أيضًا بدلاً من ذلك معالجة الطلبات على Unicommerce ومزامنة الطلب النهائي فقط.

مزامنة أمر المبيعات - إعداد القناة (القنوات).

يدعم Unicommerce Integration الاستلام والمعالجة من قنوات متعددة. للسماح بذلك، يجب أيضًا إجراء إعداد مزامنة أمر المبيعات على مراحل متعددة.

الإعدادات الافتراضية لمزامنة أوامر المبيعات

1. انتقل إلى "إعدادات Unicommerce".
2. قم بالتمرير إلى قسم إعداد "مزامنة أوامر المبيعات".
3. تردد مزامنة أمر الإعداد. يوصى بالتردد من 30 إلى 60 دقيقة.
4. قم بإعداد مجموعة العملاء الافتراضية وسلسلة التسمية للمستندات.

تكوينات مزامنة أمر المبيعات الخاصة بالقناة

للسماح بالتكوين المرن لكل قناة، يتعين عليك إنشاء مستند "قناة Unicommerce" لكل قناة تريد تمكينها لمزامنة أوامر المبيعات.

1. انتقل إلى "قناة Unicommerce" من شريط البحث أو من صفحة إعدادات Unicommerce.
2. انقر على "إضافة قناة Unicommerce"
3. املأ التفاصيل المطلوبة مثل معرف القناة والمستودع الافتراضي والشركة والحسابات وسلسلة التسمية.
4. إذا كان يتم التعامل مع الشحن لهذه القناة بواسطة السوق، فانقر على "الشحن يتم التعامل معه بواسطة السوق" أو قم بإلغاء تحديده.
5. بعد تكوين القناة بالكامل، انقر فوق مربع الاختيار "ممكّن".

سيبدأ الآن أمر المبيعات الجديد الذي تم إنشاؤه في Unicommerce في المزامنة مع BITEX. أثناء هذه العملية، إذا تمت مواجهة عنصر جديد، فسيتم إنشاؤه في BITEX باستخدام معلومات من Unicommerce. يتم تعيين المعلومات ذات الصلة حول طلب Unicommerce إلى حقول BITEX، ويمكن العثور على معلومات إضافية في قسم "تفاصيل Unicommerce" في أمر المبيعات.

مزامنة فاتورة المبيعات

يمكن التعامل مع مزامنة فاتورة المبيعات بإحدى طريقتين. يرجى تحديد الخيار المناسب حسب احتياجاتك.

1. معالجة الفاتورة على Unicommerce (مستحسن)

إذا كنت تريد معالجة الطلبات والفواتير على Unicommerce ومزامنة الطلبات التي تمت معالجتها بالكامل فقط في BITEX، فقم بتمكين "مزامنة الطلبات المكتملة فقط" في إعدادات Unicommerce.

2. معالجة الفاتورة على BITEX

إذا كنت تريد معالجة الطلبات من BITEX فقط، فأنت بحاجة إلى إنشاء فاتورة من أمر مبيعات BITEX.

من أجل إنشاء فاتورة، انتقل إلى أمر مبيعات Unicommerce الذي تمت مزامنته، وانقر فوق "Unicommerce > إنشاء فاتورة". سيؤدي هذا إلى إنشاء فاتورة مبيعات وخصم المخزون أيضًا.

بيان الشحنة

إذا كنت تقوم بمعالجة الطلبات على BITEX باستخدام الطريقة رقم 2 الموضحة أعلاه، فأنت بحاجة إلى إنشاء بيان شحن وإرساله لإعلام Unicommerce أنك قمت بشحن الطلبات.

المتطلبات الأساسية هي إعداد أنواع المستندات التالية، ويمكنك العثور على التعليمات البرمجية في صفحة إنشاء بيان Unicommerce:

1. إنشاء موفر شحن Unicommerce
2. إنشاء طريقة شحن Unicommerce

عملية إنشاء البيان:

1. بمجرد أن تصبح جاهزًا لإرسال الطرود إلى مزود الشحن، يجب عليك إنشاء مستند "بيان شحنة Unicommerce". انتقل إلى شريط البحث > "بيان شحن Unicommerce" > + إضافة
2. حدد معرف القناة وطريقة الشحن ورمز موفر الشحن.
3. يمكنك الآن إما استخدام زر "الحصول على الحزمة" لجلب الطلبات المفتوحة بناءً على المرشحات المحددة أو استخدام حقل "Scan AWB Code" لمسح AWB للحزم. سيقوم كلاهما تلقائيًا بملء التفاصيل المتبقية بعد الحفظ.
4. بمجرد التأكد من أن جميع التفاصيل تبدو صحيحة، احفظ المستند وأرسله.
5. عند تقديم البيان، يتم إنشاء نفس البيان وإغلاقه على Unicommerce ويتم وضع علامة على الشحنات بأنها "مرسلة". يتم أيضًا جلب بيان Unicommerce PDF وإرفاقه بوثيقة بيان BITEX.

تحديثات الحالة

يتم تحديث حالة Unicommerce بشكل دوري في BITEX، ويمكنك رؤية الحالة الحالية في قسم "تفاصيل Unicommerce".

إلغاء الطلب

عندما يتم إلغاء الطلب على Unicommerce، يقوم التكامل بمزامنة هذا الإجراء ويلغي الطلب على BITEX أيضًا. تتم أيضًا مزامنة الطلبات الملغاة جزئيًا وتتم إزالة العناصر الملغاة من أمر مبيعات BITEX. تتم مزامنة كل من الإلغاءات الكاملة والجزئية على مدار الساعة وقبل إنشاء الفواتير مباشرة.

إرجاع الطلب

عند إنشاء الإرجاع على Unicommerce، يقوم التكامل بمزامنة هذا الإجراء وإنشاء مسودة مذكرة ائتمان في BITEX.

تتم معالجة كلتا حالتي الإرجاع عن طريق التكامل:

• RTO (العودة إلى الأصل) عند إرجاع الشحنة إلى الأصل، تتغير حالة الشحن ويتم إنشاء إشعار دائن (مع تحديث المخزون) في BITEX. ستكون مذكرة الائتمان عائدًا كاملاً.
• CIR (الإرجاع بمبادرة من العميل) عندما يقوم العميل بإرجاع الشحنة، ينعكس ذلك في قسم طلب المبيعات في Unicommerce. يتم إنشاء إشعار دائن كامل أو جزئي اعتمادًا على طبيعة الإرجاع الذي بدأه العميل.

يمكنك عرض جميع المرتجعات بالانتقال إلى "فاتورة المبيعات" والتصفية حسب "هل المرتجع" مضبوط على "نعم". يتم أيضًا تسجيل رمز تتبع الإرجاع في مذكرة الائتمان.

أثناء إنشاء المرتجعات، يتم اختيار مستودع المرتجعات استنادًا إلى مستودع المرتجعات الذي تم تكوينه في إعدادات Unicommerce. إذا لم يتم تعيينه، سيتم استخدام المستودع الأصلي.