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

المتطلبات

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

PHP: 8.0 أو أحدث.

حساب Andreani (للتعرفات الفورية فقط): تستخدم التعرفات الفورية واجهة عروض الأسعار التابعة لـ Andreani. تمنح Andreani عملاء الأعمال بيانات اعتماد لواجهة البرمجة ورمز عميل وأرقام عقود، وعادةً ابتداءً من نحو 300 شحنة شهريًا. راجع developers.andreani.com أو اكتب إلى ventapyme@andreani.com. تحتاج إلى اسم مستخدم وكلمة مرور واجهة البرمجة، ورمز العميل (código de cliente)، ورقم العقد. تصدر Andreani عقدًا منفصلًا لكل خدمة (التوصيل إلى المنزل، واستلام الطرد من الفرع). وبدون وصول إلى واجهة البرمجة، استخدم الأسعار الثابتة. يعمل منتقي الفرع دون بيانات اعتماد.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. اضبط الاسم ومصدر التعرفات وأسعار البلدان (مثل AR=5000) وبيانات اعتماد الواجهة البرمجية ورمز العميل ورقم العقد للتعرفات الفورية (انظر الإعداد). اضغط على Save.

OpenCart 4

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

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

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

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

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

الإعداد

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Shipping > VibeFox Andreani > Edit. تظهر الأقسام في الجهة اليسرى. يحفظ زر Save واحد الصفحة كاملة دون إعادة تحميلها. وبعد الحفظ ترى Settings saved. Cached token, branches and rates were cleared. ولا يمكن حفظ الإعدادات إلا من قبل مستخدمي الإدارة الذين لديهم صلاحية التعديل لهذه الإضافة.

تظهر في أعلى الصفحة تحذيرات بشأن الإعدادات الناقصة: تعرفات واجهة برمجية مختارة دون اسم مستخدم وكلمة مرور للواجهة أو دون رقم عقد، أو غياب ARS exchange rate عندما لا تكون عملة متجرك ARS، أو عدم وجود سعر للأرجنتين في Country prices. ويظهر أيضًا تحذير إذا لم تتعرف الإضافة على وحدة الوزن أو الطول في المتجر (تُقرأ الأوزان حينها بالكيلوغرام، والأبعاد بالسنتيمتر).

عند الحفظ، يُرفض اسم فارغ، أو اسم يزيد على 64 حرفًا أو يحتوي أيًّا من الرموز < > ; = # { }، أو Min weight (kg) أكبر من Max weight (kg)، أو Sort order ليس عددًا صحيحًا؛ ولا يُحفظ أي شيء. ولا تُحفظ القيمة غير الرقمية أو السالبة أو ARS exchange rate الذي يساوي 0 أو أقل، ويذكر التحذير الحقل المعني.

عام

يقدم Andreani خيارين عند الدفع: الخيار الرئيسي، وهو الذي يُضبط هنا وفي Andreani API وDelivery and rates، والخيار Second option. ويظهر الخياران تحت عنوان Andreani في خطوة طريقة الشحن.

Enable/Disable: يفعّل خيار Andreani الرئيسي أو يعطّله. الافتراضي: معطّل. للخيار الثاني مفتاح خاص به.

Name: اسم الخيار الرئيسي الذي يراه العميل عند الدفع. الافتراضي: Andreani. مطلوب.

Tax status: None (the API rate is taken with IVA) (الافتراضي)، أو إحدى فئات الضريبة لديك. مع فئة ضريبة، يضيف OpenCart الضريبة إلى تكلفة الشحن، لذلك يُؤخذ تعرفة الواجهة بدون IVA. مع None، تُؤخذ تعرفة الواجهة متضمنة IVA. ويُستخدم هذا الإعداد في الخيارين معًا.

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

واجهة برمجة Andreani (لازمة للتعرفات الفورية)

Environment: Sandbox / QA (apisqa.andreani.com) (الافتراضي) أو Production (apis.andreani.com). استخدم البيئة التي تنتمي إليها بيانات اعتمادك.

API username: اسم مستخدم واجهة برمجة Andreani الخاص بك.

API password: كلمة مرور واجهة برمجة Andreani الخاصة بك. بعد الحفظ يبقى الحقل فارغًا ويعرض Saved - leave empty to keep it. Clearing the API username removes it too. أدخل قيمة جديدة فقط إذا أردت تغييرها.

Client code: رمز العميل (código de cliente) الذي تقدمه Andreani، مثل CL0000000.

Contract number: عقد الخدمة المستخدم في التعرفات، مثل التوصيل إلى المنزل. يمكن للخيار الثاني استخدام عقد آخر، مثل استلام الطرد من الفرع.

Origin branch code: فرع منشأ اختياري (sucursalOrigen) لعروض الأسعار. اتركه فارغًا لاستخدام الفرع المعرّف في عقدك.

التوصيل والتعرفات

Delivery modality: طريقة التوصيل للخيار الرئيسي. يوضح الجزء الأول المكان الذي تستلم منه Andreani الطرد (عنوانك أو فرع تسلّمه فيه). ويوضح الجزء الثاني المكان الذي يستلم فيه العميل الطرد.

Rate source: كيفية احتساب السعر.

Country prices: سعر ثابت لكل بلد وجهة بعملة المتجر الافتراضية، دون الضريبة، سطر واحد لكل بلد بصيغة CC=PRICE، مثل AR=5000. ويُستخدم في النمط الثابت وكبديل عند فشل الواجهة. البلدان التي لا سطر لها لا يكون لها سعر ثابت. تُتجاهل الأسطر بصيغة أخرى، ويسردها تحذير عند الحفظ.

ARS exchange rate: تُصدر Andreani عروض أسعارها بالبيزو الأرجنتيني. لا يلزم إلا إذا كانت عملة المتجر الافتراضية ليست ARS: وهو سعر 1 ARS بعملة متجرك، مثل 0.001. وبدونه لا تُستخدم تعرفات الواجهة.

Default product weight (kg): يُستخدم للمنتجات التي لا وزن لها عند طلب تعرفات الواجهة وعند التحقق من حدود الوزن. والفراغ يعني 0,5 كغ.

Calculation type: Per order (الافتراضي) يحصّل السعر مرة واحدة. أما Per item (price x number of items) فيضرب السعر الثابت من Country prices في عدد القطع في السلة. والتعرفة الفورية من Andreani تنطبق أصلًا على السلة كلها، فلا تُضرب.

التوفر

Min weight (kg): الحد الأدنى لوزن السلة حتى يظهر الخيار. القيمة 0 تعني بلا حد (الافتراضي).

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

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

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

Ignore shipping zones: يُقدَّم Andreani للبلدان المذكورة أدناه بغض النظر عن المنطقة الجغرافية. الافتراضي: معطّل.

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

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

Free shipping: يفعّل حد الشحن المجاني. الافتراضي: معطّل.

Free shipping from: المجموع الفرعي للسلة (بعملة المتجر الافتراضية) الذي يصبح عنده الشحن مجانيًا. ويشترط تفعيل Free shipping.

الخيار الثاني

خيار Andreani ثانٍ باسم وطريقة توصيل وعقد خاصة به، مثل "a domicilio" في الخيار الرئيسي و"retiro en sucursal" هنا، لعرض الاثنين معًا. وتُشارك جميع الإعدادات الأخرى.

Enable second option: يعرض الخيار الثاني عند الدفع. الافتراضي: معطّل.

Second option name: اسم هذا الخيار عند الدفع. الافتراضي: Andreani - branch pickup. مطلوب.

Delivery modality: Use global setting أو إحدى الطرق الأربع. الافتراضي: Door to branch (Puerta a Sucursal).

Contract number: تصدر Andreani عقدًا منفصلًا لكل خدمة (التوصيل إلى المنزل، واستلام الطرد من الفرع). اتركه فارغًا لاستخدام العقد العام.

منتقي الفرع (يظهر لـ Door to branch وBranch to branch)

Province select width: عرض قائمة المحافظات بصيغة CSS، مثل 100% أو 300px. الافتراضي: 100%.

Branch select width: عرض قائمة الفروع بصيغة CSS، مثل 100% أو 400px. الافتراضي: 100%.

متقدم

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

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

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

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

Export: اضغط على Download JSON لحفظ الإعدادات في ملف JSON. لا يُصدَّر مفتاح كلمة مرور الواجهة البرمجية.

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

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

عندما يعرض OpenCart طرق الشحن، يطلب من الإضافة سعر كل خيار Andreani مفعّل. إذا كانت Geo zone مضبوطة وIgnore shipping zones معطّلًا، فلا يُقدَّم Andreani للعناوين الواقعة خارج المنطقة الجغرافية. ولا يُحتسب إلا المنتجات التي ضُبط فيها Requires Shipping على Yes؛ أما المنتجات الأخرى فلا تضيف وزنًا ولا تدخل في المجموع الفرعي. ثم تتحقق الإضافة من البلدان (عندما يكون Ignore shipping zones مفعّلًا)، ومن وزن السلة (تُحوَّل أوزان المنتجات إلى كغ، وتستخدم المنتجات التي لا وزن لها Default product weight (kg))، ومن Minimum subtotal. والمجموع الفرعي هو سعر المنتجات التي تحتاج إلى شحن، بعد خصم القسيمة وقبل الضريبة.

في النمط الثابت يُؤخذ السعر من Country prices. وفي أنماط التعرفات الفورية تسجّل الإضافة الدخول إلى واجهة برمجة Andreani وتطلب عرض سعر بالرمز البريدي للوجهة والعقد ورمز العميل والوزن بالكغ والحجم المحسوب من أبعاد المنتجات والقيمة المصرّح بها (المجموع الفرعي للسلة بالـ ARS). ولا تُطلب تعرفة فورية إلا لرمز بريدي أرجنتيني صالح (4 أرقام، أو رمز CPA مثل C1425ABC). ويُحوَّل مبلغ الـ ARS باستخدام ARS exchange rate عندما لا تكون عملة المتجر ARS. ويُحسب السعر بعملة المتجر الافتراضية، ويُقرَّب إلى منازله العشرية، ويُعرض للعميل بعملته مع الضريبة الخاصة بـ Tax status المختارة.

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

إذا كان Free shipping مفعّلًا وبلغ المجموع الفرعي للسلة Free shipping from، يكون السعر 0. ولا ينطبق الشحن المجاني إلا حيث يكون للخيار سعر: فإذا لم تعد واجهة Andreani أي تعرفة ولم يوجد سعر ثابت للاحتياط، فلا يُعرض الخيار.

لا تنشئ الإضافة شحنات Andreani، ولا تطبع الملصقات، ولا تتتبع الطرود. استخدم بوابة Andreani الإلكترونية لذلك.

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

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

عندما يُعرض خيار مع Door to branch أو Branch to branch، تظهر مباشرة تحته، في خطوة طريقة الشحن، قائمة محافظات وقائمة فروع. وتُحدَّد المحافظة مسبقًا بحسب منطقة عنوان التوصيل. وتأتي قائمة الفروع من واجهة Andreani العامة للفروع، وتُخزَّن مؤقتًا لمدة تصل إلى 12 ساعة (ضمن مدة ذاكرة OpenCart المؤقتة). ولا تُدرج الفروع التي لا تسلّم الطرود. ولا تنتظر خطوة التوصيل نفسها Andreani أبدًا: فإذا لم تكن القائمة مخزنة مؤقتًا بعد، تُحمَّل في الخلفية ويرى العميل لفترة وجيزة Loading Andreani branches.... وإذا لم تتوفر أي فروع، يرى العميل No Andreani branches available right now. Please try again later or choose another shipping method.

يُحفظ الاختيار فور أن يختاره العميل. ولا يُقبل إلا فرع من قائمة Andreani الحالية. وبدون فرع لا تتجاوز Continue في خطوة التوصيل، ويرى العميل Please select an Andreani pickup branch. ويعيد الخادم التحقق من الفرع عندما يتابع العميل. وإذا لم يعد الفرع موجودًا في القائمة، يرى العميل The selected Andreani branch is not available. Please choose another one.

في OpenCart 4 تظهر قائمة المحافظات وقائمة الفروع في النافذة Shipping method options، مباشرة تحت خيار فرع Andreani، بالنصوص والفحوصات نفسها. ويُمنع الزر Continue في النافذة إن لم يُختر فرع، مع الرسالة Please select an Andreani pickup branch. تحت الخيار. وإذا رفض المتجر الفرع عند متابعة العميل، تظهر الرسالة في أعلى صفحة الدفع وتبقى النافذة مفتوحة. ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه في كل تأكيد؛ ويُحدَّث فرع الطلب معه، ويُزال عندما يغيّر العميل الطلب إلى طريقة شحن أخرى.

لا ينتمي فرع اختير تحت خيار Andreani إلى طلب تم بخيار آخر أو بطريقة شحن أخرى.

صُمِّم المنتقي للدفع المعتاد في صفحة واحدة في قالب OpenCart 3 الافتراضي، وللدفع في قالب OpenCart 4 الافتراضي. وقد يحتاج قالب ببنية مختلفة لخطوة التوصيل إلى تعديلات في نص المنتقي.

الطلبات

يحتفظ الطلب بطريقة التوصيل، وبالنسبة لطرق الفروع، بالفرع المختار.

Shipping method of the order: يُضاف الفرع إلى نص طريقة الشحن، مثل Andreani - branch pickup: واسم الفرع. وإذا لم يذكر اسم الخيار فرعًا، يُضاف النص Pickup branch: (أو Andreani pickup branch: عندما لا يحتوي الاسم على Andreani) قبل اسم الفرع، مثل Andreani - Pickup branch: واسم الفرع. ويظهر هذا النص في رسائل البريد الإلكتروني للطلب المرسلة إلى العميل والمتجر، وفي سجل طلبات العميل، وفي الفاتورة، وفي صفحة الطلب في لوحة الإدارة. ويحدّ OpenCart النص بـ 128 حرفًا؛ وتحتفظ الإضافة ببيانات الفرع كاملة. ولا تعرض صفحة نجاح الطلب في OpenCart طريقة الشحن.

Admin order page: في Sales > Orders، افتح طلبًا. تعرض لوحة Andreani Andreani modality وبالنسبة لطرق الفروع Andreani branch (الاسم والمعرّف والمحافظة). لتغييره، اضغط على Edit، واختر محافظة وفرعًا آخر، ثم اضغط على Save. سترى Branch updated.، ويُستبدل الفرع أيضًا في نص طريقة الشحن الخاصة بالطلب. ولا يمكن حفظ إلا الفروع الموجودة في قائمة Andreani. وإذا لم تكن القائمة متاحة، سترى The Andreani branch list is not available right now - the branch cannot be changed. ويتطلب تغيير الفرع صلاحية التعديل لـ sale/order والوصول إلى extension/shipping/vfd_andreani (OpenCart 3) أو extension/vfd_andreani/shipping/vfd_andreani (OpenCart 4). وتظهر اللوحة أيضًا للطلبات التي تمت بالفعل عبر Andreani حتى عندما تكون الإضافة معطلة.

بينما تكون الإضافة معطلة، لا تظهر لوحة Andreani. وتبقى بيانات الفرع محفوظة، ولا يتغير نص طريقة الشحن الخاصة بالطلب. وتحتفظ الطلبات الحالية ببيانات فروعها.

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

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

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

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

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

لا يظهر Andreani عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل (وللخيار الثاني أيضًا Enable second option)، وأنك ضغطت Save بعد التثبيت. تحقق من Geo zone، أو من Ignore shipping zones وCountries. تحقق من أن Country prices تحتوي على سطر للبلد (للأسعار الثابتة أو الاحتياط)، ومن حدود الوزن وMinimum subtotal. اقرأ التحذيرات في أعلى صفحة Edit. تحقق من أن المنتجات ضُبط فيها Requires Shipping على Yes.

لا تظهر التعرفات الفورية: فعّل Debug log، وأعد تحميل صفحة الدفع، ثم انظر إلى الحقل Log في صفحة الإضافة. سيُظهر السبب: بيانات اعتماد أو رقم عقد مفقود، أو فشل تسجيل الدخول (اسم مستخدم أو كلمة مرور أو بيئة خاطئة)، أو عدم وجود رمز بريدي أرجنتيني صالح بعد، أو عدم وجود سعر صرف، أو خطأ HTTP من Andreani. ومع Andreani API, fixed price if the API fails سيحصل العملاء على السعر الثابت بينما تصلح المشكلة.

متجري ليس بالبيزو الأرجنتيني: اضبط ARS exchange rate على قيمة 1 ARS بعملة متجرك الافتراضية.

ضريبة الشحن تبدو خاطئة: مع فئة ضريبة في Tax status تُستخدم تعرفة Andreani بدون IVA ويضيف OpenCart ضريبته الخاصة. ومع None تُستخدم التعرفة متضمنة IVA ولا تُضاف ضريبة. تحقق من تفعيل الضرائب في إعدادات المتجر، ومن أن فئة الضريبة تحتوي على نسب لـ الأرجنتين.

لا توجد فروع في القائمة: لم تستجب واجهة برمجة فروع Andreani. يُعاد الطلب الفاشل بعد 5 دقائق. تحقق من السجل.

المحافظة الخاطئة مختارة مسبقًا: تُقرأ المحافظة من منطقة عنوان التوصيل. ويستطيع العميل دائمًا اختيار محافظة أخرى.

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

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

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

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

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

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

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