VibeFox NZ Post for OpenCart — المساعدة

المتطلبات

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

PHP: 8.0 أو أحدث.

وصول API الخاص بـ NZ Post (للأسعار الفورية فقط): تستخدم الأسعار الفورية ShippingOptions API الخاص بـ NZ Post. اطلب الوصول إلى API من Developer Resource Centre على موقع NZ Post. تمنحك NZ Post Client ID وClient Secret، أولًا لبيئة الاختبار (UAT)، ثم للإنتاج بعد قائمة مراجعة الإطلاق الخاصة بها. وللأسعار داخل نيوزيلندا تحتاج أيضًا إلى حساب تجاري لدى NZ Post: رقم الحساب والـ auth code الخاص به (أو site code). وإذا كنت تستخدم الأسعار الثابتة فقط، فلا تحتاج إلى وصول API.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. للأسعار الفورية، املأ قسم NZ Post API (live rates). ويمكنك اختياريًا إدخال أسعار ثابتة، تُستخدم دون الأسعار الفورية وكبديل احتياطي (انظر الإعدادات). فعّل Enable NZ Post واضغط Save.

OpenCart 4

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

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

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

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

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

الإعدادات

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

لا يُحفظ شيء ويظهر خطأ عندما يكون Method title فارغًا أو يتجاوز 64 حرفًا أو يحتوي على < > ; = # { }، أو عندما يحتوي حقل رقمي على نص أو عدد سالب، أو عندما يكون سعر صرف NZD صفرًا، أو عندما يكون Min cart weight (kg) أكبر من Max cart weight (kg)، أو عندما لا يكون Sort order عددًا صحيحًا. وتظهر تحذيرات فوق الإعدادات عندما لا تستطيع الأسعار الفورية العمل بالقيم المحفوظة: إذا كان أحد الحقلين Client ID أو Client Secret فقط مُدخلًا، أو لا يوجد سعر تحويل إلى NZD، أو كانت بيانات الأسعار المحلية غير مكتملة. ويظهر تحذير أيضًا إذا لم تحتوِ المتجر على فئة وزن وحدتها kg أو فئة طول وحدتها cm: تُحوَّل الأوزان والأبعاد حينئذٍ حسب اسم وحدة فئتها (kg وg وlb وoz؛ وcm وmm وm وin)، وتُقرأ الوحدات الأخرى على أنها كغ وسم.

عام

تنطبق الإعدادات على جميع المناطق الجغرافية. يمكنك قصر الطريقة على منطقة جغرافية، أو على دول، في Availability.

Enable NZ Post: يفعّل الطريقة أو يعطّلها عند الدفع. الافتراضي: معطل.

Method title: اسم طريقة الشحن الذي يراه العميل في السلة وعند الدفع. الافتراضي: NZ Post. مطلوب، بحد أقصى 64 حرفًا.

Tax class: فئة الضريبة لتكلفة الشحن، أو No tax (الافتراضي؛ لا تُفرض ضريبة على تكلفة الشحن). وإذا كان المتجر يضيف GST على الشحن، فاضبط API prices أدناه على Excluding GST حتى لا تُفرض الضريبة مرتين.

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

NZ Post API (الأسعار الفورية) (اترك Client ID فارغًا لاستخدام الأسعار الثابتة فقط)

Environment: Production (api.nzpost.co.nz) (الافتراضي) أو Testing / UAT (api.uat.nzpost.co.nz). استخدم البيئة التي صدر لها Client ID الخاص بك.

Client ID: معرّف عميل OAuth2 لتطبيق NZ Post API الخاص بك. ويؤدي مسحه إلى مسح Client Secret المحفوظ أيضًا.

Client Secret: السر الخاص بعميل OAuth2. يُستبدل برمز وصول يُخزَّن مؤقتًا حتى انتهاء صلاحيته. وبعد الحفظ يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها.

Account number: رقم حسابك التجاري (الفوترة) لدى NZ Post. وهو مطلوب للأسعار داخل نيوزيلندا. وهو اختياري للأسعار الدولية؛ وعند إدخاله تعيد NZ Post أسعار التعاقد الخاصة بك. ويؤدي مسحه إلى مسح الـ auth code المحفوظ أيضًا.

Auth code: الـ auth code الخاص بالحساب للأسعار المحلية. ولا يلزم إذا أدخلت site code. وكما هو الحال مع Client Secret، لا يُعرض مرة أخرى بعد الحفظ.

Site code: البديل عن الـ auth code: رمز موقع الاستلام الخاص بك لدى NZ Post (pickup site code).

Ship-from suburb: الحي الذي تُرسل منه الطرود، على سبيل المثال Petone. وهو مطلوب للأسعار المحلية.

Ship-from city: البلدة أو المدينة التي تُرسل منها الطرود، على سبيل المثال Lower Hutt. وهي مطلوبة للأسعار المحلية.

Ship-from postcode: الرمز البريدي النيوزيلندي المكون من 4 أرقام الذي تُرسل منه الطرود، على سبيل المثال 5012. وهو مطلوب للأسعار المحلية.

Services: رموز خدمات NZ Post اختيارية، مفصولة بفواصل، على سبيل المثال CPOLP وICOU. لا تُسعَّر إلا هذه الخدمات. اتركه فارغًا لاستخدام أرخص خدمة تعيدها NZ Post للطرد.

API prices: Including GST (الافتراضي) أو Excluding GST. تتضمن أسعار NZ Post المحلية ضريبة GST بنسبة 15%؛ أما البريد الدولي فيُعامل بنسبة صفر. اختر Excluding GST عندما تكون للطريقة فئة ضريبة (General)، حتى لا تُفرض GST مرتين.

سعر صرف NZD → (عملة المتجر): أسعار NZ Post بالدولار النيوزيلندي. وإذا لم تكن عملة المتجر الافتراضية هي NZD، فأدخل كم وحدة من عملتك تساوي دولارًا نيوزيلنديًا واحدًا، على سبيل المثال 0.55. وبدونه لا تُستخدم الأسعار الفورية. ويحوّل السعر نفسه قيمة الطلب المرسلة مع الطلبات الدولية. ويجب أن يكون السعر أكبر من 0. وإذا كانت عملة متجرك NZD، فاتركه فارغًا.

الطرد للأسعار الفورية

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

Default product weight (kg): يُستخدم لكل منتج لا وزن له. الافتراضي: 0.5.

Default parcel length (cm): يُستخدم عندما لا يكون لأي منتج في السلة أبعاد. الافتراضي: 30.

Default parcel width (cm): يُستخدم عندما لا يكون لأي منتج في السلة أبعاد. الافتراضي: 20.

Default parcel height (cm): يُستخدم عندما لا يكون لأي منتج في السلة أبعاد. الافتراضي: 10.

الأسعار الثابتة (تُستخدم عندما لا تكون الأسعار الفورية مُعدّة أو عندما لا تعيد NZ Post أي سعر)

الأسعار بعملة المتجر الافتراضية، دون ضريبة.

Country prices: صف واحد لكل دولة وجهة. اضغط Add country لإضافة صف، وزر × لحذفه. اختر * Default لصف يغطي جميع الدول الأخرى. يحتوي كل صف على سعر Any weight وأعمدة وزن اختيارية: ≤ 1 kg، و1–2 kg، و2–3 kg، و3–5 kg، و> 5 kg (وزن السلة). ويحل العمود المملوء محل Any weight؛ والعمود الفارغ أو الذي قيمته 0 يستخدم Any weight. والسعر Any weight الذي قيمته 0 يعني شحنًا مجانيًا إلى تلك الدولة. ويُقبل كل من "9.99" و"9,99". وتُحذف الصفوف التي لا تحتوي على أي سعر، والأسعار السالبة، عند الحفظ. ولا يُحتفظ إلا بصف واحد لكل دولة.

Fallback cost: يُستخدم عندما لا يعطي كل من API وجدول الدول أي سعر. اتركه فارغًا لإخفاء الطريقة في هذه الحالة.

Fixed price per: Order (الافتراضي) يحتسب السعر مرة واحدة. Item (price × quantity) يضربه في عدد العناصر في السلة. وينطبق هذا على الأسعار الثابتة والتكلفة الاحتياطية فقط. وتُحسب الأسعار الفورية دائمًا للطرد كاملًا.

الشروط

Min cart weight (kg): يُخفي الطريقة عندما يكون وزن السلة أقل من ذلك. والقيمة 0 تعني بلا حد (الافتراضي).

Max cart weight (kg): يُخفي الطريقة عندما يكون وزن السلة أكبر من ذلك. الافتراضي: 25 (طرود Courier من NZ Post تصل إلى 25 كغ)؛ والحقل الفارغ يعني 25 أيضًا. والقيمة 0 تعني بلا حد. وعندما يكون Ignore shipping zones مفعّلًا، يعني الحقل الفارغ عدم وجود حد للعناوين الواقعة خارج Geo zone.

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

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

وبالنسبة لهذه الشروط، يحتسب وزن السلة المنتجات التي لا وزن لها على أنها 0.

التوفر

عادةً تُعرض الطريقة في المنطقة الجغرافية المحددة أدناه، أو في كل مكان إذا لم تُحدد أي منطقة.

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

Ignore shipping zones: اعرض NZ Post أيضًا خارج المنطقة الجغرافية، للدول المذكورة أدناه. وعندما يكون مفعّلًا، لا تحصل على الطريقة إلا هذه الدول، بما فيها داخل المنطقة الجغرافية. الافتراضي: معطل.

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

متقدم

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

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

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

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

Export: اضغط Download JSON لحفظ الإعدادات كملف JSON. لا يُصدَّر Client Secret ولا الـ auth code.

Import: الصق ملف JSON صُدِّر سابقًا واضغط Import لاستعادة الإعدادات، على سبيل المثال في متجر آخر. تُتحقق القيم كما في الحفظ العادي. ويُحتفظ بـ Client Secret والـ auth code المحفوظين ما دام Client ID ورقم الحساب مُدخلين.

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

عندما يعرض OpenCart طرق الشحن، يطلب من الإضافة سعر NZ Post. إذا كانت Geo zone محددة وكان العنوان خارجها، فلا تُعرض NZ Post إلا عندما يكون Ignore shipping zones مفعّلًا والدولة مسموحًا بها. ولا تُحتسب إلا المنتجات التي يكون Requires Shipping فيها على Yes: فالمنتجات الأخرى لا تضيف وزنًا ولا تدخل في قيمة الطلب. ثم تتحقق الإضافة من الشروط: الدول المسموح بها (مع Ignore shipping zones)، ووزن السلة، والحد الأدنى لقيمة الطلب. وقيمة الطلب هي سعر المنتجات التي تحتاج إلى شحن، بعد خصم القسيمة وقبل الضريبة. ولا تُحتسب شهادات الهدايا ونقاط المكافآت ورصيد المتجر. وإذا انطبق الشحن المجاني، يكون السعر 0 ولا يُرسل أي طلب إلى NZ Post. وإلا فإنها تبحث عن سعر: أولًا السعر الفوري لـ NZ Post، ثم جدول الدول، ثم التكلفة الاحتياطية. وإذا لم يوجد سعر، تُخفى الطريقة.

عند إعداد الأسعار الفورية، تحصل الإضافة على رمز وصول باستخدام Client ID وClient Secret الخاصين بك، وتطلب من NZ Post سعرًا. وبالنسبة لعنوان في نيوزيلندا، ترسل بيانات حسابك وعنوان الشحن، وحي العميل ومدينته ورمزه البريدي، وكذلك وزن الطرد وحجمه. ولا يوجد في OpenCart حقل للحي: تستخدم الإضافة Address 2 عندما يحتوي على اسم حي (بدون أرقام)، وإلا تستخدم المدينة. ولا يُطلب السعر المحلي إلا بعد أن يُدخل العميل مدينة ورمزًا بريديًا من 4 أرقام. وبالنسبة للدول الأخرى، ترسل الدولة الوجهة ووزن الطرد وحجمه وقيمة الطلب بالدولار النيوزيلندي.

تُستخدم أرخص خدمة مسموح بها ولها سعر، بما في ذلك الرسوم الإضافية والخدمات الإضافية الإلزامية. ويُحوَّل السعر من NZD إلى عملة المتجر الافتراضية، ويُقرَّب إلى منازله العشرية، ويُعرض للعميل بعملته مع ضريبة Tax class المختارة. وتُخزَّن كل استجابة مؤقتًا لمدة ساعة. ويُخزَّن الطلب الفاشل مؤقتًا لمدة 10 دقائق، حتى لا ينتظر الدفع NZ Post عند كل تحديث. ومهلة انتظار API هي 10 ثوانٍ. ويُحتفظ برمز الوصول حتى انتهاء صلاحيته، ويُجدَّد الرمز المرفوض تلقائيًا.

وإذا لم تعد NZ Post أي سعر (API غير مُعدّ، أو خطأ، أو عنوان غير مكتمل، أو خدمة غير متاحة، أو لا يوجد سعر NZD)، فلن يرى العميل أي خطأ. ويُستخدم سعر جدول الدول، ثم التكلفة الاحتياطية. وإذا لم يوجد سعر ثابت، تُخفى الطريقة. ويُكتب السبب في السجل.

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

تحسب الإضافة الأسعار فقط. ولا تُنشئ ملصقات شحن، ولا تُصدر بيانات تجميع، ولا تحجز استلامات، ولا تتبع الطرود، ولا تتحقق من العناوين، ولا تسمح للعميل باختيار نقطة استلام أو صندوق بريد (PO Box) أو خزانة طرود. وتُسعَّر السلة كطرد واحد، ويرى العميل سعرًا واحدًا لـ NZ Post، لا قائمة بالخدمات.

الطلبات

عندما يُقدَّم طلب مع NZ Post، تحفظ الإضافة الأساس الذي استند إليه سعر الشحن. افتح الطلب في Sales > Orders: تعرض صفحة الطلب لوحة NZ Post تحتوي على NZ Post service (خدمة NZ Post المُسعَّرة لسعر فوري، مع رمزها) وPrice source: Live rate (NZ Post ShippingOptions API) أو Fixed price أو Free shipping. وتعرض اللوحة القيم من وقت الطلب، حتى إذا تغيرت الأسعار أو الإعدادات لاحقًا، وكذلك عندما تكون الطريقة معطلة. ولا يرى العميل اسم الخدمة.

على OpenCart 4 تظهر لوحة NZ Post فوق History. يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه في كل مرة يؤكد فيها العميل من جديد، فتُحدَّث الخدمة المحفوظة ومصدر السعر معه. وإذا غيّر العميل طريقة الشحن لذلك الطلب، تُحذف بيانات NZ Post الخاصة بالطلب.

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

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

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

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

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

لا تظهر NZ Post عند الدفع: تحقق من أن الترخيص نشط وأن Enable NZ Post مفعّل. وتحقق من Geo zone (أو Ignore shipping zones وCountries)، وحدود الوزن، وMinimum order amount. وإذا لم تعد NZ Post أي سعر، فلا تُعرض الطريقة إلا مع سعر دولة أو Fallback cost. وتأكد من أن المنتجات لديها Requires Shipping على Yes.

الأسعار الفورية لا تظهر: انظر إلى التحذيرات في أعلى صفحة الإضافة. ثم فعّل Debug log، وأعد تحميل صفحة الدفع، وانظر إلى الحقل Log. وتظهر أخطاء API هناك دائمًا. ويوضح السجل السبب: Client ID أو Client Secret مفقود، أو رمز وصول مرفوض، أو بيانات حساب أو شحن مفقودة، أو لا توجد مدينة أو رمز بريدي للعميل بعد، أو لا يوجد سعر NZD، أو لا توجد خدمة مُسعَّرة. وأثناء إصلاح المشكلة تُستخدم الأسعار الثابتة.

يفشل طلب الرمز: تحقق من Client ID وClient Secret وEnvironment. بيانات اعتماد UAT لا تعمل مع بيئة الإنتاج، والعكس صحيح.

الأسعار المحلية مفقودة، والأسعار الدولية تعمل: تحتاج الأسعار داخل نيوزيلندا إلى Account number أو Auth code أو Site code، وإلى عنوان شحن كامل مع رمز بريدي من 4 أرقام. ويجب أن يُدخل العميل مدينة ورمزًا بريديًا من 4 أرقام.

متجري ليس بالدولار النيوزيلندي: أدخل سعر صرف NZD (الحقل NZD → (عملتك) rate). وتبقى الأسعار الثابتة دائمًا بعملة المتجر الافتراضية.

تُفرض GST مرتين على الشحن: تتضمن أسعار NZ Post المحلية ضريبة GST بنسبة 15%. وإذا كان للطريقة Tax class، فاضبط API prices على Excluding GST.

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

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

للمطورين: يمكن تغيير الحي المُرسَل لعنوان توصيل في نيوزيلندا باستخدام حدث OpenCart vfd_nz_post/delivery_suburb (المشغل catalog/vfd_nz_post/delivery_suburb). ويمكن استبدال عنوان NZ Post API بالإعداد vfd_nzpt_api_url (للاختبارات)؛ ولا يوجد له حقل في صفحة الإعدادات.

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

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

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

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