VibeFox Sameday Easybox for OpenCart — المساعدة

المتطلبات

OpenCart: 3.0.x (تم الاختبار على 3.0.5.0) أو 4.0.2 وما بعده (تم الاختبار على 4.1.0.3).

PHP: 8.0 أو أحدث.

اسم مستخدم وكلمة مرور API لدى Sameday: يُعدّ الوصول إلى API جزءاً من حساب أعمال لدى Sameday في رومانيا أو المجر أو بلغاريا. اسأل مدير حسابك لدى Sameday أو فريق التكامل في Sameday. غالباً ما تكون بيانات الاعتماد نفسها المستخدمة في بوابة eAWB (eawb.sameday.ro أو .hu أو .bg). بالنسبة إلى واجهة API التجريبية، تُقدِّم Sameday بيانات اعتماد اختبار منفصلة. بدون اسم مستخدم وكلمة مرور لواجهة API لا تُعرض الطريقة، لأن العميل لن يتمكن من اختيار خزانة.

البلد والمقاطعات: يجب تفعيل بلد حساب Sameday الخاص بك في System > Localisation > Countries. يحتاج تقدير Sameday إلى مقاطعة عنوان التوصيل (حقل Region / State). يحتوي OpenCart على مقاطعات رومانيا وبلغاريا، لكن لا توجد مقاطعات للمجر في OpenCart 3 (وتوجد في OpenCart 4.1). يمكن للإضافة إضافتها لك (انظر أدناه خزائن easybox). بدونها تأتي الأسعار من جدولك أو من التكلفة الاحتياطية.

مفتاح ترخيص VibeFox: يُشترى من vibefox.net. يعمل مفتاح واحد على نطاق واحد.

التثبيت

ملف التنزيل عبارة عن ملف zip واحد يحتوي على الحزم لكلا إصداري OpenCart. فكّ ضغطه على حاسوبك. ويحتوي على README.txt، وحزمة OpenCart 3 vfd_sameday_easybox-oc3-(version).ocmod.zip، وحزمة OpenCart 4 vfd_sameday_easybox.ocmod.zip. ثبّت الحزمة الخاصة بإصدار OpenCart لديك فقط. مفتاح الترخيص هو نفسه لكلا الإصدارين.

OpenCart 3

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف vfd_sameday_easybox-oc3-(version).ocmod.zip. لا تضيف الإضافة أي تعديلات OCMOD، لذا لا تحتاج إلى تحديث Extensions > Modifications. بدلاً من Installer، يمكنك نسخ محتويات مجلد upload الموجود في هذه الحزمة إلى المجلد الجذر لمتجرك.

2. انتقل إلى Extensions > Extensions، واختر نوع الإضافات Shipping، وابحث عن VibeFox Sameday Easybox، ثم انقر على Install (زر + الأخضر).

3. انقر على Edit (زر القلم) لفتح صفحة الإعدادات.

4. في الكتلة الخاصة بالترخيص أعلى صفحة Edit، الصق مفتاح ترخيص VibeFox في License key ثم انقر على Activate (انظر مفتاح الترخيص).

5. أدخل API username وAPI password الخاصين بـ Sameday، واختر Sameday country، وفعّل Enable/Disable، ثم انقر على Save. يجب أن تعرض الصفحة "Connected to Sameday ... easybox lockers". يتم ملء Pickup point وEasybox service من حسابك.

6. حدِّد أسعارك: Exchange rate of the estimate إذا كانت عملة متجرك تختلف عن عملة Sameday، وصفاً في Country prices (مثلاً * Default) أو Fallback cost.

7. إذا أشارت الصفحة إلى أن OpenCart لا يحتوي على مقاطعات لبلد Sameday الخاص بك، فانقر على Add counties في قسم easybox lockers.

OpenCart 4

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف vfd_sameday_easybox.ocmod.zip. لا تُغيّر اسم الملف: فـ OpenCart 4 يأخذ رمز الإضافة من اسم الملف، والحزمة التي يُعاد تسميتها لا تعمل.

2. تظهر الحزمة في قائمة الإضافات المثبتة في الصفحة نفسها. انقر على Install (زر + الأخضر) بجانبها.

3. انتقل إلى Extensions > Extensions، واختر نوع الإضافات Shipping، وابحث عن VibeFox Sameday Easybox، ثم انقر على Install (زر + الأخضر)، ثم على Edit (زر القلم).

4. أدخل مفتاح الترخيص والإعدادات كما في الخطوات من 4 إلى 7 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين. يختلف رابط cron فقط (انظر خزائن easybox).

بعد التثبيت تبقى الطريقة معطّلة حتى تفعّل Enable/Disable وتحفظ. إذا أعدت تثبيت الإضافة بعد إلغاء تثبيتها، فستُستخدم الإعدادات التي احتفظت بها من جديد، لكن الطريقة تبدأ معطّلة.

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit. تُدرج الأقسام على اليسار. يحفظ زر Save الواحد في الأسفل الصفحة كاملة دون إعادة تحميلها. لا يمكن حفظ الإعدادات إلا للمستخدمين المديرين الذين لديهم صلاحية التعديل لهذه الإضافة.

تعرض الصفحة فوق الإعدادات حالة الاتصال: مضيف Sameday، وعدد خزائن easybox ووقت آخر تحديث للقائمة، أو أن Sameday رفض اسم المستخدم أو كلمة المرور. كما تسرد مشكلات التهيئة، مثل غياب بيانات الاعتماد، أو غياب السعر، أو غياب سعر الصرف للتقدير، أو غياب المقاطعات، أو غياب فئة وزن بالكيلوغرام، أو اختيار بلدان خارج بلد Sameday الخاص بك.

بعض الأخطاء تمنع الحفظ، فلا يُحفظ شيء: Enter a valid name (1-64 characters, without < > ; = # { }).، Sort order must be a whole number.، أو فئة ضريبة أو منطقة جغرافية غير صالحة. المشكلات الأخرى تُبقي قيمة واحدة فقط: تقبل جميع الأسعار والحدود الفاصلة أو النقطة كفاصل عشري (4,99 أو 4.99)، ولا يُحفظ العدد غير الصالح أو السالب. يحدد التحذير الحقل، وتبقى القيمة السابقة.

عام

Enable/Disable: يعرض الطريقة عند الدفع أو يخفيها. وهي حالة الإضافة في Extensions > Extensions > Shipping. الافتراضي: معطّل.

Name: اسم طريقة الشحن الذي يراه العميل. الافتراضي: Sameday easybox. حتى 64 حرفاً.

Tax class: --- None --- (الافتراضي) يعني أن السعر نهائي. مع فئة ضريبة، يضيف OpenCart ضريبة هذه الفئة فوق السعر.

Sort order: ترتيب الطريقة بين طرق الشحن عند الدفع. رقم صحيح.

حساب Sameday (API)

عند الحفظ، تسجّل الإضافة الدخول إلى Sameday وتُحمِّل خدماتك ونقاط الاستلام وقائمة خزائن easybox. تُحدَّث القائمة يومياً.

API username: اسم مستخدم API الخاص بك في Sameday.

API password: كلمة مرور API الخاصة بك في Sameday. لا تُعرض مرة أخرى: اترك الحقل فارغاً للاحتفاظ بالكلمة المحفوظة. مسح اسم المستخدم يحذف كلمة المرور أيضاً. إذا رفضها Sameday، فلا تُعاد المحاولة لمدة 10 دقائق.

Sameday country: بلد حساب Sameday الخاص بك: Romania (api.sameday.ro) (الافتراضي) أو Hungary (api.sameday.hu) أو Bulgaria (api.sameday.bg). تُعرض خزائن هذا البلد، وتظهر الطريقة لوجهة هذا البلد فقط.

Test mode: يستخدم واجهة API التجريبية من Sameday (sameday-api.demo.zitec.com) مع بيانات اعتماد تجريبية.

الأسعار (يعرض عنوان القسم عملة المتجر الافتراضية)

ترتيب الاستخدام هو: تقدير Sameday (عندما تكون Pickup point وEasybox service مُعدَّتين)، ثم جدول الأسعار حسب البلد، وأخيراً التكلفة الاحتياطية. تُدخل أسعار الجدول بعملة المتجر الافتراضية. يرى العملاء الذين يدفعون بعملة أخرى السعر محوَّلاً.

Pickup point: نقطة استلام Sameday الخاصة بك، حيث تجمع Sameday الطرود. بعد تسجيل دخول ناجح، تكون قائمة بنقاط الاستلام في حسابك، وتُختار النقطة الافتراضية تلقائياً. قبل ذلك، يكون حقلاً لإدخال المعرّف. مطلوب لتقدير Sameday. اختر - not set (price table only) - لاستخدام جدول الأسعار فقط.

Easybox service: خدمة Sameday لتوصيل easybox، وعادةً "Locker NextDay" (الرمز LN)، وتُختار تلقائياً. مطلوبة لتقدير Sameday.

Exchange rate of the estimate: تُقدِّم Sameday التقديرات بعملة بلدك في Sameday: RON أو HUF أو BGN (وEUR للمتاجر البلغارية التي تبيع باليورو). إذا كان متجرك يبيع بعملة أخرى، فأدخل قيمة وحدة واحدة من عملة Sameday بعملة متجرك، مثلاً 0.20. يجب أن يكون السعر أكبر من 0. بدونه لا يُستخدم التقدير وتُطبَّق جدول الأسعار. يُحوَّل الليف واليورو تلقائياً بالسعر الثابت.

Table price: Per order يفرض السعر مرة واحدة. Per item (price x quantity) يضربه في عدد العناصر. ينطبق هذا على سعر الجدول والتكلفة الاحتياطية. تقدير Sameday دائماً للطرد كاملاً.

Country prices: سعر لكل بلد وجهة ووزن للطرد. انقر على Add country لإضافة صف، وعلى زر الحذف لحذف صف. يحتوي كل صف على عمود Price وأعمدة للوزن: XS حتى 1 كغ، وS من 1 إلى 2 كغ، وM من 2 إلى 3 كغ، وL من 3 إلى 5 كغ، وXL أكثر من 5 كغ. عمود الوزن الذي يبقى على 0 أو فارغاً يستخدم عمود Price. يُستخدم صف * Default للبلدان التي ليس لها صف خاص بها. يبدأ الصف الجديد كصف * Default وتكون جميع الأسعار 0، أي شحن مجاني. اختر البلد وأدخل الأسعار قبل الحفظ، أو احذف الصف. إذا ظهر البلد نفسه في صفين، فعند الحفظ يُحتفظ بالأول فقط، ويوضح تحذير ذلك. إذا لم تكن الخلية رقماً يساوي 0 أو أكبر، فلا يُحفظ الجدول.

Fallback cost: يُستخدم عندما لا يوجد تقدير من Sameday ولا يوجد في جدول البلد صف لوجهة الطلب. اتركه فارغاً لعدم عرض الطريقة في هذه الحالة.

Free shipping from: المجموع الفرعي للسلة (المنتجات التي تحتاج إلى شحن، بعد الخصومات، دون ضريبة) الذي يصبح التوصيل عبر easybox عنده مجانياً. عندما يصل المجموع الفرعي إليه، تُعرض الطريقة بلا تكلفة ولا يُستعلم عن أي سعر. اتركه فارغاً لعدم عرض شحن مجاني أبداً.

التوافر

Minimum weight (kg): يُخفي الطريقة عندما يكون وزن السلة أقل من هذا. يُحوَّل الوزن من فئة وزن المنتجات. الفارغ أو 0 يعني دون حد.

Maximum weight (kg): لا تُعرض خدمة توصيل easybox للطرود الأثقل من هذا. الافتراضي: 30. تحقق من حد عقد Sameday الخاص بك وأحجام صناديق easybox. الفارغ أو 0 يعني دون حد. لا يُحفظ وزن أدنى أكبر من الوزن الأقصى: يوضح تحذير ذلك، وتبقى القيم السابقة.

Minimum cart subtotal: اعرض الطريقة فقط عندما يصل المجموع الفرعي للسلة (المنتجات التي تحتاج إلى شحن، بعد الخصومات، دون ضريبة) إلى هذا المبلغ. الفارغ يعني دون حد أدنى.

Geo zone: اعرض الطريقة فقط للعناوين في هذه المنطقة الجغرافية. All Zones (الافتراضي) يعني دون حد. تُدار المناطق الجغرافية في System > Localisation > Geo Zones. لا يتم التحقق منها عندما تكون Ignore shipping zones مفعّلة.

Ignore shipping zones: عندما تكون مفعّلة، لا يتم التحقق من المنطقة الجغرافية، وتُعرض الطريقة للبلدان المحددة أدناه (بلد Sameday إذا كانت القائمة فارغة). عندما تكون معطّلة، تنطبق المنطقة الجغرافية أعلاه فقط.

Countries (ignore zones mode): بلدان الوجهة لهذا الوضع. تُتخطى البلدان غير بلد Sameday، وتحذّر الصفحة منها. يُستخدم هذا الحقل فقط عندما تكون Ignore shipping zones مفعّلة.

خزائن easybox

Locker list: يعرض عدد خزائن easybox المحمّلة في عدد المدن، ومتى. Refresh the locker list now يعيد تحميلها. تُحدَّث القائمة عند حفظ الإعدادات، وبعد طلب الدفع إذا مضى عليها أكثر من يوم (مرة واحدة في الساعة على الأكثر). للتحديث اليومي الثابت، استدعِ الرابط المعروض هنا مرة واحدة يومياً من مهمة cron على خادمك. يبدو الرابط في OpenCart 3 هكذا: https://your-store/index.php?route=extension/shipping/vfd_sameday_easybox/cron&token=(token)، وفي OpenCart 4 هكذا: https://your-store/index.php?route=extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox.cron&token=(token). انسخ الرابط تماماً كما تعرضه الإعدادات. يحتوي الرابط على رمز سري. بدون الرمز الصحيح يردّ بخطأ ولا يتصل بـ Sameday. كما لا يفعل شيئاً أثناء تعطيل الطريقة.

Counties: يعرض عدد المقاطعات التي يملكها OpenCart لبلد Sameday الخاص بك. إذا لم يكن لديه أي مقاطعة، فانقر على Add counties. تضيف الإضافة مقاطعات ذلك البلد إلى System > Localisation > Zones، ويعرضها حقل Region / State في نموذج العنوان. المقاطعات الموجودة بالفعل لا تُضاف مرة أخرى. ويحتوي OpenCart 4.1 على مقاطعات البلدان الثلاثة بالفعل، لذلك لا حاجة إلى الزر هناك.

متقدم

Debug log: يكتب حسابات الأسعار، واستدعاءات API، واختيارات الخزائن إلى storage/logs/vfd_sdeb_debug.log.php، وهو ملف لا يمكن قراءته من الويب. تُسجَّل أخطاء API دائماً. لا تُسجَّل كلمات المرور أو الرموز أو البيانات الشخصية للعملاء. عندما يصل الملف إلى 5 ميغابايت، يبدأ سجل جديد. أوقف السجل عندما تنتهي.

Log: يعرض حجم سجل التصحيح وأحدث إدخالاته. انقر على Clear log لتفريغه.

Remove data on uninstall: عندما تكون مفعّلة، يؤدي إلغاء تثبيت الإضافة إلى حذف الإعدادات وبيانات Sameday المخزنة مؤقتاً والسجل. وعندما تكون معطّلة (الافتراضي)، تُحفظ الإعدادات. تُحذف قائمة الخزائن والذاكرة المؤقتة دائماً. الخزانة المحفوظة في الطلبات تُحفظ دائماً.

الاستيراد / التصدير

Export: انقر على Download JSON لحفظ الإعدادات كملف JSON. لا تُصدَّر كلمة مرور API.

Import: الصق ملف JSON المُصدَّر سابقاً وانقر على Import. تمر القيم بالفحوص نفسها التي يمر بها النموذج. تبقى كلمة المرور المحفوظة.

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

عندما يعرض OpenCart طرق الشحن، يطلب من الإضافة سعر توصيل easybox من Sameday. تتحقق الإضافة من المنطقة الجغرافية (أو بلدان Ignore shipping zones)، ومن بلد التوصيل في حساب Sameday الخاص بك، ومن بيانات اعتماد API وقائمة خزائن صالحة للاستخدام، ومن وزن السلة والمجموع الفرعي الأدنى للسلة. تُحتسب فقط المنتجات التي يكون فيها Requires Shipping على Yes. المجموع الفرعي هو سعر هذه المنتجات دون ضريبة، بعد خصم القسيمة. إذا انطبق الشحن المجاني، يرى العميل الطريقة دون تكلفة.

وإلا، تطلب الإضافة من Sameday تقديراً بمجرد أن يُدخل العميل مدينة ومقاطعة. وترسل نقطة الاستلام والخدمة، ووزن الطرد، وعنوان العميل من شارع ومدينة ومقاطعة ورمز بريدي. لا يُرسل الاسم أو البريد الإلكتروني أو رقم الهاتف. تُرسل بوخارست بوصفها "Sector 1"، كما يفعل المكوّن الإضافي الرسمي لـ Sameday. يُحوَّل التقدير إلى عملة متجرك. إذا لم يكن هناك تقدير (غير مُعدّ، أو لا توجد مدينة أو مقاطعة بعد، أو خطأ، أو لا يوجد سعر صرف)، يأتي السعر من جدول البلد، ثم من التكلفة الاحتياطية. إذا لم يوجد سعر، تُخفى الطريقة. يُعرض السعر بعملة العميل مع ضريبة Tax class المحددة.

لا تُوقف مشكلات Sameday إتمام الشراء أبداً. يُخزَّن التقدير مؤقتاً لمدة ساعة واحدة. يُخزَّن الخطأ مؤقتاً لمدة 10 دقائق. بعد انتهاء المهلة أو خطأ في الخادم، لا يُطلب أي تقدير لمدة 5 دقائق. تنتهي مهلة الطلبات بعد 15 ثانية. أثناء الدفع، تُقرأ قائمة الخزائن من خادمك، وليس من Sameday.

لا تُنشئ الإضافة بوالص AWB (الشحنات)، ولا تطبع الملصقات، ولا تتتبع الطرود، ولا تتعامل مع الدفع عند الاستلام. لا يوجد توصيل منزلي بالمندوب ولا أداة خريطة من Sameday. أنشئ بوليصة AWB في بوابة Sameday eAWB أو في أداتك المعتادة باستخدام معرّف الخزانة المعروض في الطلب.

على OpenCart 4 ينقر العميل على Choose في كتلة طريقة الشحن في صفحة الدفع، ويختار Sameday easybox في النافذة Shipping method options. الأسعار هي نفسها في OpenCart 3.

نقاط الاستلام

عندما يختار العميل الطريقة، يظهر تحتها كتلة easybox locker بقائمتين: - Select city - و- Select easybox locker -. تُختار مدينة عنوان التوصيل مسبقاً إذا كانت بها خزائن. يعرض كل خزانة اسمها وعنوانها. يُحفظ الاختيار فوراً لإتمام الشراء، لذا يبقى محفوظاً إذا فُتحت خطوة التوصيل مرة أخرى.

الخزانة مطلوبة. بدونها لا يستطيع العميل المتابعة، ويرى "Please choose a Sameday easybox locker.". عندما ينقر العميل على Continue، يتحقق الخادم من أن الخزانة المختارة موجودة في القائمة. يُرفض معرّف الخزانة المزوَّر أو المحذوف مع رسالة "The selected easybox locker is not available any more. Please choose another easybox locker.". إذا تعذر تحميل القائمة، يرى العميل "The easybox lockers could not be loaded. Please try again in a moment or choose another shipping method.". يأتي الاسم والعنوان المحفوظان مع الطلب من القائمة، لا من المتصفح.

صفحات الطلب ورسائل البريد الإلكتروني والفاتورة: تُضاف الخزانة إلى طريقة الشحن الخاصة بالطلب، مثلاً "Sameday easybox: الاسم - العنوان" (أولاً اسم الطريقة ثم الخزانة). يراها العميل في تأكيد الطلب وسجل الطلبات ورسائل البريد الإلكتروني للطلب، وتراها أنت في الفاتورة.

صفحة الطلب في لوحة الإدارة: في Sales > Orders، تحتوي صفحة الطلب على لوحة Sameday easybox locker تعرض الاسم والعنوان وLocker ID لبوليصة Sameday AWB. إذا لم يكن لطلب easybox خزانة، تقول اللوحة "No easybox locker was selected for this order.". تُعرض اللوحة أيضاً أثناء تعطيل الطريقة.

على OpenCart 4 تظهر كتلة easybox locker في النافذة Shipping method options، تحت خيار Sameday easybox، وتُحمَّل قائمة المدن من جديد في كل مرة تُفتح فيها النافذة، لأن العنوان قد يتغير في الدفع في صفحة واحدة. ولا يتابع زر Continue في النافذة من دون خزانة صالحة، بالرسائل نفسها. ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه في كل مرة يؤكد فيها العميل من جديد، وتُحدَّث خزانة الطلب معه. وتظهر لوحة صفحة الطلب في الإدارة فوق قسم History.

مفتاح الترخيص

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox Sameday Easybox هي أول كتلة في صفحة Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مقنّعاً، والحالة (مثلاً التاريخ الذي يبقى الترخيص نشطاً حتى موعده ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها سطر Product: opencart-shipping-sameday-easybox ورابط Manage licenses and domains in your account الذي يفتح حسابك على vibefox.net. لا يستطيع تغيير المفتاح سوى مستخدمي الإدارة الذين لديهم صلاحية Modify للإضافة. تتبع نصوص الكتلة لغة لوحة الإدارة (الإنجليزية والروسية مدرجتان).

إذا لم يُقبل المفتاح، تُبيّن الكتلة السبب، مثلاً Key not found، أو This key belongs to another product، أو Domain limit reached، أو License expired on مع تاريخ. بعد تغيير عنوان المتجر، أو بعد تحرير خانة نطاق في حسابك، انقر على Check now. إذا تعذر الوصول إلى خادم التراخيص، تستمر الإضافة في العمل بآخر حالة معروفة.

يعمل المفتاح الواحد على نطاق واحد: عنوان المتجر من إعدادات OpenCart. إزالة المفتاح من المتجر لا تحرر خانة النطاق الخاصة به. حرّر الخانة في حسابك على vibefox.net.

بدون ترخيص نشط، لا تُعرض طريقة شحن Sameday easybox للعملاء عند الدفع ولا يُطلب أي سعر ولا يُحسب. ويرى مستخدم الإدارة الذي سجّل الدخول إلى لوحة الإدارة في المتصفح نفسه الطريقة في المتجر، مع العلامة (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. وعلى OpenCart 4 لا تتوفر هذه المعاينة: فالمتجر لا يرى تسجيل دخول الإدارة، لذلك تُخفى الطريقة عن الجميع دون ترخيص نشط. وبعد فتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard الخاصة بالإدارة. أغلقه بـ × لإخفائه لمدة 7 أيام. ولا تتأثر الطلبات الحالية.

عندما تنتهي صلاحية الترخيص، تستمر الإضافة في العمل، لكن التحديثات والدعم يحتاجان إلى تجديد. تُعاد مراجعة الحالة تلقائياً عند فتح Dashboard الخاصة بالإدارة أو صفحة Edit: مرة واحدة يومياً خلال أول 14 يوماً بعد إدخال المفتاح، ثم مرة واحدة أسبوعياً. لا حاجة إلى مهمة cron. وإلغاء تثبيت الإضافة يحذف دائماً مفتاح الترخيص وحالة الترخيص.

استكشاف الأخطاء وإصلاحها

لا تظهر Sameday easybox عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن اسم مستخدم API وكلمة المرور مُدخلان وأن صفحة الإعدادات تعرض "Connected to Sameday"، وأن بلد الوجهة هو بلد حساب Sameday الخاص بك. تحقق من توفر سعر (تقدير Sameday أو صف البلد أو صف * Default أو Fallback cost)، وحدود الوزن والمجموع الفرعي، وGeo zone، وبلدان Ignore shipping zones. تحقق من أن المنتجات لديها Requires Shipping على Yes. فعّل Debug log لرؤية السبب في الحقل Log.

رفض Sameday اسم مستخدم API أو كلمة المرور: تحقق منهما واحفظ مرة أخرى. تعمل بيانات الاعتماد التجريبية فقط عندما تكون Test mode مفعّلة، وبيانات الإنتاج فقط عندما تكون معطّلة. حتى ذلك الحين، تُعرض قائمة الخزائن المحفوظة إن وُجدت، ولا يُستخدم تقدير Sameday.

يأتي السعر من جدولي، لا من Sameday: يحتاج التقدير إلى Pickup point، وEasybox service، ومقاطعات لبلد Sameday الخاص بك، وإلى Exchange rate of the estimate عندما تختلف عملة متجرك عن عملة Sameday. لا يُطلب إلا بعد أن يُدخل العميل مدينة ومقاطعة. عندما لا يكون Sameday متاحاً أو يعيد خطأ، يُستخدم الجدول أو التكلفة الاحتياطية؛ والسبب موجود في السجل.

قائمة الخزائن قديمة أو مفقودة: انقر على Refresh the locker list now أو احفظ الإعدادات. إذا فشل التحديث، تُستخدم القائمة السابقة، وتوضح الحالة ذلك.

الشحن مجاني بالخطأ: تحقق من Free shipping from وصفوف Country prices التي فيها Price يساوي 0، وخصوصاً صف * Default الذي أُضيف بـ Add country وتُرك دون تعبئة.

حدود الوزن أو أعمدة الوزن غير متطابقة: إذا حذّرت الصفحة من عدم وجود فئة وزن بالوحدة "kg"، فأضف فئة وزن بالكيلوغرام في System > Localisation > Weight Classes.

تقول الصفحة "Warning: You do not have permission to modify VibeFox Sameday Easybox!": قد تتمكن مجموعة المستخدمين المديرين لديك من عرض الإعدادات فقط. امنح المجموعة صلاحية التعديل لـ extension/shipping/vfd_sameday_easybox (OpenCart 3) أو extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox (OpenCart 4) في System > Users > User Groups.

إلغاء التثبيت

انتقل إلى Extensions > Extensions، واختر النوع Shipping، وانقر على Uninstall (زر − الأحمر) بجوار VibeFox Sameday Easybox. تُحذف دائماً مفتاح الترخيص وحالة الترخيص لهذه الإضافة. يعيد OpenCart دائماً تعيين Enable/Disable وSort order وTax class وGeo zone. تُحذف دائماً قائمة الخزائن المحفوظة ونتيجة فحص الحساب وجميع الذاكرات المؤقتة. إذا كانت Remove data on uninstall مفعّلة، فتُحذف الإعدادات الأخرى ورمز cron والسجل أيضاً. إذا كانت معطّلة، فتُحفظ وتُستخدم من جديد عند إعادة تثبيت الإضافة. تحتفظ الطلبات الحالية بالخزانة المحفوظة.

على OpenCart 4، ولحذف ملفات الإضافة أيضًا، انتقل إلى Extensions > Installer بعد إلغاء التثبيت، وانقر على Uninstall (زر − البرتقالي) بجوار VibeFox Sameday Easybox في قائمة الإضافات المثبتة، ثم Delete (زر سلة المهملات الأحمر) لحذف الحزمة المرفوعة.

Sameday وeasybox علامتان تجاريتان لمالكيهما. هذه الإضافة غير تابعة لـ Sameday ولا تحظى بتأييدها.