VibeFox CTT for OpenCart — المساعدة

المتطلبات

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

PHP: 8.0 أو أحدث.

حساب التجارة الإلكترونية لدى CTT (للأسعار الفورية ونقاط CTT فقط): تستخدم الأسعار الفورية والتوصيل إلى نقطة CTT واجهة برمجة تطبيقات التجارة الإلكترونية لدى CTT. تحتاج إلى حساب تجارة إلكترونية لدى CTT على enviosecommerce.ctt.pt (لعملاء عقد CTT Expresso، أو اطلب عرضًا من CTT). في صفحة إدارة المفاتيح لهذا الحساب، أنشئ زوجًا من المفتاح العام والمفتاح الخاص. يُصدر CTT الـ App ID (X-APPID) لتكاملك: اسأل جهة الاتصال لديك في CTT للتجارة الإلكترونية. كما تحدد CTT وظائف API (تقدير التكلفة، نقاط CTT) التي يمكن لـ App ID الخاص بك استخدامها. وأخيرًا، تحتاج إلى Carrier ID الخاص بـ CTT في حسابك. تُدرج صفحة الإعدادات شركات الشحن في حسابك بعد حفظ المفاتيح. إذا كنت تستخدم جدول الأسعار والتوصيل إلى العنوان فقط، فلا تحتاج إلى مفاتيح API.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. املأ جدول الأسعار (صف واحد على الأقل باسم Portugal أو * Default)، وفعّل Enable/Disable و/أو Enable CTT point option، ثم انقر على Save. ويمكنك اختياريًا إدخال مفاتيح API الخاصة بـ CTT وApp ID وCarrier ID، وتفعيل Live rates (راجع الإعداد).

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص والإعدادات كما في الخطوتين 4 و5 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين.

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

الإعداد

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Shipping > VibeFox CTT > Edit. وتظهر الأقسام في الجهة اليسرى. يحفظ زر Save الواحد في أسفل الصفحة الصفحة بأكملها دون إعادة تحميلها. تنطبق الأسعار والشروط على خياري CTT كليهما. يؤدي كل حفظ إلى مسح ردود CTT المخزنة مؤقتًا: رمز API، وشركات الشحن، والأسعار، وقوائم نقاط CTT. لا يمكن حفظ الإعدادات إلا لمستخدمي الإدارة الذين لديهم صلاحية التعديل لهذه الإضافة.

تخبرك التحذيرات في أعلى الصفحة بوجود جدول أسعار فارغ، أو سعر مفقود لدولة البرتغال، أو مفاتيح API غير مكتملة بينما تكون الأسعار الفورية أو خيار نقطة CTT مفعّلة، أو Carrier ID مفقود، أو عملة متجر غير اليورو دون سعر صرف، أو فشل الاتصال بواجهة CTT البرمجية، أو وجود متجر بلا فئة وزن بوحدة kg أو فئة طول بوحدة cm (فتُحوَّل وحدات المنتجات حينئذ حسب اسم الوحدة؛ راجع System > Localisation > Weight Classes وLength Classes). وإذا كان أحد الأسماء فارغًا أو غير صالح أو يتجاوز 64 حرفًا، أو كان Min weight (kg) أكبر من Max weight (kg)، أو كان Sort Order أو فئة الضريبة أو المنطقة الجغرافية غير صالحة، فستعرض الصفحة خطأ ولن يُحفظ أي شيء. أما القيم الأخرى غير الصالحة فتُعرض كتحذيرات ويُحفظ الباقي: لا يُحفظ الرقم غير الصالح، ويُمسح سعر الصرف الذي يساوي 0 أو أقل، ويعود حجم المنتج غير الصالح إلى القيمة الافتراضية، ويُحذف الوجهة غير المعروفة أو الصف المكرر في جدول الأسعار، ويبقى سعر الجدول غير الصالح فارغًا.

عام

تقدم الإضافة عند الدفع خيارين كحد أقصى: التوصيل عبر CTT إلى عنوان العميل، والتوصيل إلى نقطة CTT أو خزانة الطرود. وتنطبق الأسعار والشروط على الخيارين معًا.

Enable/Disable: يفعّل التوصيل عبر CTT إلى عنوان العميل أو يعطّله.

Name: اسم طريقة الشحن الذي يراه العميل عند الدفع، مثل "CTT Expresso". الافتراضي: CTT. حتى 64 حرفًا.

Tax class: فئة الضريبة الخاصة بتكلفة الشحن. يضيف OpenCart هذه الضريبة (مثل IVA) فوق الأسعار. يعني --- None --- أن الأسعار نهائية. ويستخدمها الخياران كلاهما.

Sort Order: موضع CTT بين طرق الشحن عند الدفع. رقم صحيح.

التوصيل إلى نقطة CTT أو خزانة الطرود

الخيار الثاني لـ CTT. يبحث العميل عن نقاط CTT بالرمز البريدي أو المدينة (يُبحث عن عنوان التوصيل تلقائيًا) ويجب أن يختار نقطة قبل المتابعة. ويتطلب مفاتيح API الخاصة بـ CTT وCarrier ID. ومن دونهما يصبح الخيار بلا اختيار للنقطة.

Enable CTT point option: يتيح التوصيل إلى نقطة CTT أو خزانة الطرود. الافتراضي: معطّل.

CTT point option name: اسم هذا الخيار عند الدفع. الافتراضي: CTT point / parcel locker. حتى 64 حرفًا.

واجهة CTT البرمجية للتجارة الإلكترونية (الأسعار الفورية، نقاط CTT) (اختياري؛ من دون المفاتيح يُستخدم جدول الأسعار)

Public key: المفتاح العام من صفحة إدارة المفاتيح في حساب CTT للتجارة الإلكترونية.

Private key: المفتاح السري المستخدم لتوقيع كل طلب (HMAC-SHA256). لا يُرسل إلى CTT ولا يُكتب في السجل أبدًا.

لا يُعرض المفتاحان مرة أخرى بعد الحفظ. وعندئذٍ يقول وصف الحقل Saved - leave empty to keep it. اكتب قيمة جديدة فقط إذا أردت تغييرها. حدّد Remove the saved public and private key واحفظ لحذف المفتاحين. وعندما لا يكون هناك شيء محفوظ، يعرض القسم No keys saved.

App ID (X-APPID): مفتاح التطبيق الذي تصدره CTT، ويُرسل في ترويسة X-APPID.

Carrier ID: معرّف شركة الشحن لدى CTT في حسابك، ويُستخدم للأسعار الفورية والبحث عن نقاط CTT. بعد حفظ المفاتيح وApp ID، تُدرج شركات الشحن في حسابك أسفل الحقل (Carriers of your CTT account:)، وتُعلَّم الشركات التي تدعم نقاط CTT بعبارة CTT points. أرقام فقط.

Live rates: يطلب السعر (تقدير التكلفة) من CTT بمجرد أن يُدخل العميل اسم الشارع والرمز البريدي والمدينة. ويُستخدم جدول الأسعار طالما كان العنوان غير مكتمل، وكلما لم تُعِد CTT سعرًا. تسمي CTT هذا السعر تقديرًا. الافتراضي: معطّل.

Service ID: اختياري. عندما تُعيد CTT عدة خدمات، تُستخدم الخدمة ذات ServiceId هذا. اتركه فارغًا لاستخدام الأرخص.

Exchange rate: أسعار CTT بالأورو. إذا كانت العملة الافتراضية لمتجرك مختلفة، فأدخل عدد وحدات عملة متجرك التي تعادل وحدة واحدة من عملة CTT. ومن دون هذه القيمة لا تُستخدم الأسعار الفورية بعملة أخرى، ويُطبَّق جدول الأسعار.

Default product size (cm): الطول × العرض × الارتفاع المرسلة إلى CTT للمنتجات التي ليس لها أبعاد. الافتراضي: 30x20x15. وتستخدم المنتجات التي لها أبعاد أبعادها الخاصة. وتُحوَّل الأبعاد إلى سم والأوزان إلى غرامات وفقًا لفئات الطول والوزن الخاصة بالمنتجات.

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

أدخل الأسعار الواردة في عقد CTT الخاص بك، أو في قائمة الأسعار العامة لدى CTT على ctt.pt، بعملة المتجر الافتراضية، دون الضريبة. عندما تكون الأسعار الفورية معطّلة، يحدد هذا الجدول السعر. وعندما تكون مفعّلة، يكون هذا الجدول هو السعر الاحتياطي.

Price table: صف واحد لكل وجهة. اختر دولة، أو Portugal - Azores، أو Portugal - Madeira، أو * Default (other destinations). يحتوي كل صف على Price أساسي وأسعار اختيارية للأحجام XS (حتى 1 كغ)، وS (حتى 2 كغ)، وM (حتى 3 كغ)، وL (حتى 5 كغ)، وXL (أكثر من 5 كغ). يستخدم سعر الحجم الفارغ (أو 0) السعر الأساسي. أما الصف الذي يكون فيه الاثنان فارغين فيُخفي طريقة الشحن. ويُستخدم صف Azores للرموز البريدية البرتغالية 9500-9999، وصف Madeira للرموز 9000-9499. وإذا لم تكن هذه الصفوف موجودة، فيُطبَّق صف Portugal. انقر على Add destination لإضافة صف، وعلى الزر × لحذفه. تقبل الأسعار النقطة أو الفاصلة العشرية. يكون الجدول فارغًا بعد التثبيت.

Calculation: كيفية تحديد سعر الجدول.

يكون السعر الفوري لـ CTT دائمًا للشحنة كاملة.

الشروط

Min weight (kg): الحد الأدنى لوزن السلة لكي تظهر خيارات CTT. يعني 0 عدم وجود حد.

Max weight (kg): تُخفى خيارات CTT عندما يتجاوز وزن السلة هذا الحد. الافتراضي: 30 (تصل طرود CTT إلى 30 كغ). يعني 0 عدم وجود حد. لا يمكن أن يكون Min weight (kg) أكبر من Max weight (kg).

Minimum order amount: اعرض خيارات CTT فقط عندما يبلغ المجموع الفرعي للمنتجات التي تحتاج إلى شحن (بعد الكوبون وقبل الضريبة) هذا المبلغ. اتركه فارغًا لعرضها دائمًا.

الشحن المجاني

Free shipping: فعّل التوصيل المجاني عبر CTT ابتداءً من المبلغ المذكور أدناه.

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

التوفر

عادةً ما تُقدَّم خيارات CTT في المنطقة الجغرافية المختارة أدناه. ويعني All Zones في كل مكان. ومع Ignore shipping zones لا تُفحص المنطقة الجغرافية، ويحدد Countries الوجهة.

Geo Zone: المنطقة الجغرافية لعنوان الشحن. تُدار المناطق الجغرافية في System > Localisation > Geo Zones.

Ignore shipping zones: لا تفحص المنطقة الجغرافية؛ اعرض CTT في الدول المذكورة أدناه.

Countries: الدول المستهدفة لذلك الوضع. الافتراضي: Portugal. اتركه فارغًا للسماح بجميع الدول. يُستخدم فقط مع Ignore shipping zones.

متقدم

Debug log: يسجل حساب الأسعار واستدعاءات واجهة CTT البرمجية في storage/logs/vfd_ctt_debug.log.php (في OpenCart 4 في system/storage/logs/vfd_ctt_debug.log.php). لا يمكن قراءة هذا الملف من الويب. تُسجَّل أخطاء واجهة CTT البرمجية دائمًا، حتى عندما يكون هذا الخيار معطّلًا. لا تُسجَّل المفاتيح ولا الرموز ولا عناوين العملاء أبدًا. وعندما يصل الملف إلى 5 ميغابايت يُنقل إلى vfd_ctt_debug.old.log.php ويبدأ سجل جديد.

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

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

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

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

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

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

عندما يعرض OpenCart طرق الشحن، يطلب من الإضافة سعر CTT. ومع Ignore shipping zones، تُعرض CTT فقط لدولة موجودة في Countries (فارغ = جميع الدول)؛ وإلا، إذا كانت Geo Zone محددة، فتُعرض فقط للعناوين الواقعة داخلها. لا تُحتسب إلا المنتجات التي يكون فيها Requires Shipping على Yes: أما المنتجات الأخرى فلا تضيف وزنًا ولا تدخل في مبلغ الطلب. وتتحقق الإضافة من وزن السلة والحد الأدنى لمبلغ الطلب. وعندما تكون Live rates مفعّلة والعنوان مكتملًا، ترسل الإضافة إلى CTT عنوان التوصيل، وبالنسبة إلى كل سطر في السلة: الكمية والوزن بالغرامات والأبعاد بالسم، وتستخدم السعر الذي تعيده. وإلا، أو عندما لا تُعيد CTT سعرًا (خطأ في API، أو انتهاء المهلة، أو عدم وجود تغطية، أو وظيفة غير مفعّلة لـ App ID الخاص بك)، يأتي السعر من الجدول. وإذا انطبق الشحن المجاني فالسعر 0. ويحصل الخياران على السعر نفسه. يُحسب السعر بعملة المتجر الافتراضية، ويُقرَّب إلى منازلها العشرية، ويُعرض للعميل بعملته مع ضريبة Tax class المختارة.

يُخزَّن سعر CTT مؤقتًا لمدة ساعة، حتى لا تُرسل السلة نفسها طلبًا جديدًا. ويُتذكَّر الطلب الفاشل لمدة 5 دقائق، حتى لا تنتظر صفحة الدفع CTT عند كل تحديث. ويُخزَّن رمز API وقائمة شركات الشحن وقوائم نقاط CTT مؤقتًا أيضًا، لمدة لا تتجاوز عمر ذاكرة التخزين المؤقت في OpenCart (ساعة واحدة افتراضيًا). لا تصل أخطاء API إلى العميل أبدًا: يُستخدم سعر الجدول، أو تُخفى طريقة الشحن إذا لم يكن للوجهة سعر.

عند ملء مفاتيح API، ترسل الإضافة عنوان التوصيل وأوزان المنتجات وأبعادها وعنوان URL لمتجرك إلى CTT للحصول على سعر أو على أقرب نقاط CTT.

لا تنشئ الإضافة شحنات، ولا تطبع ملصقات، ولا تطلب استلامًا، ولا توفر أرقام تتبع، ولا تعرض خريطة لنقاط CTT. يوجد جدول أسعار واحد ومجموعة واحدة من إعدادات API للخيارين معًا.

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

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

عندما يختار العميل خيار نقطة CTT في خطوة طريقة الشحن، يظهر تحته حقل بحث وقائمة. يُملأ الرمز البريدي لعنوان التوصيل ويُبحث عنه تلقائيًا. ويمكن للعميل البحث عن نقاط CTT أخرى بالرمز البريدي أو المدينة (زر Search) واختيار واحدة من القائمة. يُحفظ الاختيار فورًا. ولا يُقبل إلا نقطة من قائمة CTT لذلك البحث.

يجب اختيار نقطة قبل أن يتمكن العميل من المتابعة. وعندما ينقر العميل على Continue، تتحقق الإضافة من النقطة على الخادم. ومن دون نقطة يرى العميل Please select a CTT point.، ومع نقطة ليست في قائمة CTT يرى The selected CTT point is not in the CTT list for this search. Please choose the CTT point again. وإذا تعذر الوصول إلى CTT، يرى العميل CTT points cannot be loaded right now. Please try again in a few minutes or choose another shipping method.

لا يكون اختيار النقطة فعّالًا إلا عندما يكون المفتاح العام والمفتاح الخاص وApp ID وCarrier ID مملوءة. وهو مصمم لقالب OpenCart الافتراضي وصفحة الدفع الخاصة به؛ وقد تحتاج القوالب الأخرى إلى تعديلات.

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

تُضاف النقطة المختارة إلى طريقة الشحن الخاصة بالطلب، مثل CTT point / parcel locker: .... وهكذا يراها العميل في سجل طلبات حسابه وفي رسائل البريد الإلكتروني للطلب، وتُطبع في الفاتورة وتظهر في Sales > Orders. لا تعرض صفحة نجاح الطلب في OpenCart طريقة الشحن.

في صفحة الطلب في لوحة الإدارة، تُظهر لوحة CTT point فوق السجل اسم النقطة ومعرّفها. ولتغييرها، أدخل رمزًا بريديًا أو مدينة تحت Change CTT point، وانقر على Search، واختر نقطة، ثم انقر على Save. تعرض الصفحة CTT point updated.، ويُحدَّث نص طريقة شحن الطلب، وتُضاف إلى سجل الطلب مدخلة CTT point changed to: ... دون إشعار العميل. ويتطلب تغيير النقطة صلاحية تعديل الطلبات (sale/order) وإعدادات API. وتظهر اللوحة أيضًا لطلبات CTT حتى عندما تكون الإضافة معطّلة.

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

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox CTT هي أول كتلة في Extensions > Extensions > Shipping > VibeFox CTT > Edit، فوق الإعدادات. أدخل المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مخفيًا، والحالة (مثل التاريخ الذي يبقى فيه الترخيص نشطًا، ونطاقك)، والأزرار Check now للتحقق من الحالة مجددًا، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها السطر Product: opencart-shipping-ctt والرابط 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.

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

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

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

لا تظهر CTT في صفحة الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable (أو Enable CTT point option) مفعّل. تحقق من Geo Zone، أو من Ignore shipping zones وCountries. تحقق من أن الوجهة لها صف في جدول الأسعار (أو صف * Default)، وأن وزن السلة بين Min weight وMax weight، وأن Minimum order amount قد تحقق، وأن المنتجات لديها Requires Shipping على Yes.

لا يستطيع العميل اختيار نقطة CTT: لا يظهر المحدِّد إلا تحت خيار نقطة CTT، ولا يظهر إلا عندما تكون المفاتيح العامة والخاصة وApp ID وCarrier ID مملوءة. تحقق من التحذيرات في أعلى صفحة الإعدادات، وفعّل Debug log، وانظر إلى الحقل Log في صفحة الإضافة.

لا تظهر الأسعار الفورية: يُستخدم جدول الأسعار حتى يُدخل العميل اسم الشارع والرمز البريدي والمدينة. تحقق من التحذيرات والسجل. يعني الرد "405" أن الوظيفة غير مفعّلة لـ App ID الخاص بك: اسأل CTT. وفي متجر لا يستخدم اليورو، املأ Exchange rate.

فشل الاتصال بواجهة CTT البرمجية: يعرض التحذير في أعلى صفحة الإعدادات الخطأ. تحقق من المفاتيح وApp ID. تعيد الإضافة المحاولة تلقائيًا بعد بضع دقائق.

أسعار شاملة الضريبة أو غير شاملة: عند اختيار Tax class، يضيف OpenCart تلك الضريبة فوق السعر. ومع --- None --- يكون السعر نهائيًا.

تبدو الأسعار قديمة بعد تغيير: انقر على Save في صفحة الإضافة. وهذا يمسح ردود CTT المخزنة مؤقتًا.

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

للمطورين: يمكن استبدال عنوان واجهة CTT البرمجية بالإعداد vfd_ctt_api_url (للاختبارات)؛ ولا يوجد له حقل في صفحة الإعدادات.

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

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

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

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