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

المتطلبات

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

PHP: 8.0 أو أحدث.

عقد Correios (للأسعار اللحظية فقط): تستخدم الأسعار اللحظية واجهة برمجة أسعار Correios Web Services (CWS) وتحتاج إلى بيانات اعتماد عقد Correios يتضمن بطاقة إرسال (cartão de postagem). تحتاج إلى ثلاث قيم: مستخدم Meu Correios الخاص بك (عادةً رقم CNPJ أو CPF الخاص بالعقد)، ورمز الوصول للواجهة البرمجية، ورقم بطاقة الإرسال. أنشئ رمز الوصول من بوابة Correios Web Services (cws.correios.com.br؛ وللاختبار cwshom.correios.com.br). تحتاج أيضًا إلى رمز CEP الذي تشحن منه. من دون بيانات الاعتماد تعمل الإضافة بالأسعار الثابتة فقط.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. أدخل مستخدم واجهة Correios البرمجية، ورمز الوصول، ورقم بطاقة الإرسال، ورمز CEP للمصدر، والخدمة. إذا لم تكن العملة الافتراضية لمتجرك BRL، فأدخل سعر الصرف إلى BRL. أدخل الأسعار الثابتة للدول الأخرى وكبديل احتياطي (راجع Configuration)، ثم فعّل Enable Correios واضغط Save.

OpenCart 4

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

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

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

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

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

Configuration

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

تعرض الصفحة تحذيرات عندما لا تستطيع الأسعار اللحظية أو الطريقة العمل: إذا لم تُملأ سوى بعض بيانات الاعتماد الثلاث، أو كان رمز CEP للمصدر مفقودًا، أو كان سعر الصرف إلى BRL مفقودًا لمتجر بعملة أخرى، أو إذا لم توجد بيانات اعتماد ولا أسعار ثابتة. يوضح كل تحذير ما إذا كانت الأسعار الثابتة تُستخدم في الأثناء أم أن الطريقة مخفية. ويظهر تحذير أيضًا إذا لم تكن لدى المتجر فئة وزن بوحدة kg أو فئة طول بوحدة cm؛ عندها تُحوَّل وحدات المنتجات بحسب اسم الوحدة في فئتها (تُعامَل الوحدات غير المعروفة على أنها kg أو cm). تحقق من System > Localisation > Weight Classes وLength Classes.

يُرفض الحفظ مع رسالة إذا كان عنوان الطريقة فارغًا أو غير صالح (64 حرفًا كحد أقصى، من دون الرموز < > ; = # { })، أو إذا كان حقل رقمي أو سعر في Country prices ليس رقمًا يساوي 0 أو أكبر، أو إذا كان سعر الصرف إلى BRL يساوي 0، أو إذا كان Min cart weight أكبر من Max cart weight، أو إذا لم يتكون رمز CEP للمصدر من 8 أرقام، أو إذا تجاوز رمز الخدمة الأخرى 5 أرقام، أو إذا لم يكن Sort order عددًا صحيحًا. لا يُحفظ أي شيء حتى تصحح القيمة.

عام

تُطبَّق الإعدادات على كل المناطق الجغرافية. يمكنك قصر الطريقة على منطقة جغرافية في Conditions، أو على قائمة دول باستخدام Ignore shipping zones.

Enable Correios: يُظهر Correios عند الدفع أو يخفيه. الافتراضي: معطّل.

Method title: اسم طريقة الشحن الذي يراه العميل في السلة وعند الدفع. الافتراضي: Correios. مطلوب.

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

واجهة Correios البرمجية (الأسعار اللحظية في البرازيل)

بالنسبة إلى العناوين في البرازيل، يأتي السعر من واجهة برمجة أسعار Correios. إذا لم تعطِ الواجهة أي سعر (الواجهة متوقفة، أو رمز CEP غير مخدوم، أو الطرد كبير جدًا)، يُستخدم السعر الثابت من Country prices، أو تُخفى الطريقة إذا لم يكن هناك سعر ثابت. تُسجَّل تفاصيل الأخطاء في السجل، ولا تُعرض للعميل أبدًا.

API user: تسجيل دخولك إلى بوابة Meu Correios، وعادةً رقم CNPJ أو CPF الخاص بالعقد. مسح هذا الحقل يمسح أيضًا رمز الوصول المحفوظ.

Access code: رمز الوصول للواجهة البرمجية (código de acesso) الذي يُنشأ في بوابة Correios Web Services. وهو ليس كلمة مرور البوابة. بعد الحفظ يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it (empty the API user as well to remove it). أدخل قيمة جديدة فقط إذا أردت تغييرها. ولحذف الرمز المحفوظ، أفرغ API user ثم احفظ.

Posting card: رقم بطاقة الإرسال (cartão de postagem) في عقدك: 10 أرقام، وعادةً تبدأ برقمين صفريين، مثل 0012345678. تُكمَّل الأرقام الأقصر بأصفار في البداية. يمكنك التحقق من الرقم في صفحة Correios Fácil على موقع Correios.

Homologation: يستخدم بيئة الاختبار (homologation) الخاصة بـ Correios: تُرسل الطلبات إلى apihom.correios.com.br برمز وصول للاختبار. أوقفه في المتجر الفعلي.

Origin CEP: رمز CEP (8 أرقام) الذي تُرسل منه الطرود، مثل 01001-000.

Service: خدمة Correios التي تُحسب عند الدفع. رموز التجزئة: PAC (04510، الافتراضي)، وSEDEX (04014)، وSEDEX 12 (04782)، وSEDEX 10 (04790)، وSEDEX Hoje (04804). رموز العقد: PAC (03298)، وSEDEX (03220)، وSEDEX 12 (03140)، وSEDEX 10 (03158)، وSEDEX Hoje (03204)، وCorreios Mini Envios (04227). تحتاج رموز العقد إلى بطاقة إرسال لعقد يتضمن الخدمة.

Other service code: اختياري، رمز خدمة من 5 أرقام في عقدك غير موجود في القائمة، مثل 03085. يُكمَّل الرمز الأقصر بأصفار في البداية. عند تعبئته يُستخدم بدلًا من Service.

Package format: نوع الشحنة التي تُرسل إلى Correios.

Default product weight (kg): الوزن الذي يُرسل إلى Correios لكل منتج لا وزن له. الافتراضي: 0.3. تُحوَّل أوزان المنتجات وأبعادها من فئات الوزن والطول الخاصة بها، ويُحسب سعر السلة كطرد واحد.

BRL → store currency rate: يعرض اسم الحقل العملة الافتراضية لمتجرك، مثل BRL → EUR rate. أسعار Correios بعملة BRL. إذا لم تكن عملتك الافتراضية BRL، فأدخل عدد وحدات عملتك التي تساوي وحدة BRL واحدة، مثل 0.17. من دون هذه القيمة لا تُستخدم الأسعار اللحظية. يجب أن يكون سعر الصرف أكبر من 0. وإذا كانت عملتك الافتراضية BRL فاترك الحقل فارغًا.

الأسعار الثابتة (تُستخدم للدول خارج البرازيل، ومن دون بيانات اعتماد للواجهة البرمجية، وكبديل احتياطي عندما لا تعطي الواجهة أي سعر)

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

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

Conditions

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

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

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

Free shipping: يفعّل التوصيل المجاني ابتداءً من المبلغ الموضح أدناه.

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

Tax class: فئة الضريبة التي تُضاف إلى تكلفة الشحن، أو No tax (الافتراضي).

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

التوفر بدون مناطق الشحن

عادةً تُعرض الطريقة في المنطقة الجغرافية المحددة في Conditions (في كل المناطق إذا لم تُحدَّد أي منطقة).

Ignore shipping zones: اعرض الطريقة للدول الواردة أدناه، أيًا كانت المنطقة الجغرافية المطابقة. ولا يُتحقق عندها من Geo zone في Conditions.

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

متقدم

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

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

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

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

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

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

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

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

بالنسبة إلى عنوان في البرازيل مع بيانات اعتماد مُعدّة، تحصل الإضافة أولًا على رمز واجهة برمجية لبطاقة الإرسال الخاصة بك. ويعطي الرمز أيضًا أرقام العقد ومكتب المنطقة، لذلك يكون السعر هو سعر عقدك. ثم تطلب سعر الخدمة المختارة حسب رمز CEP للمصدر والمستلم، ووزن الطرد بالغرام، وحجم الطرد بالسنتيمتر. ولا يُطلب سعر إلا عندما يتكون رمز CEP للمستلم من 8 أرقام. وعندما تكون أبعاد جميع المنتجات معروفة، يُقدَّر حجم الطرد منها؛ وإلا فيُرسل الحد الأدنى لحجم Correios. ولا تُرسل الطرود التي تزيد على 30 kg إلى الواجهة البرمجية. ويُحوَّل السعر بالـ BRL بسعر صرفك. ويُحسب السعر بالعملة الافتراضية للمتجر، ويُقرَّب إلى منازلها العشرية، ويُعرض للعميل بعملته مع الضريبة الخاصة بـTax class المحددة.

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

إذا لم تعطِ الواجهة البرمجية أي سعر، يُستخدم السعر الثابت، أو تُخفى الطريقة عندما لا يوجد سعر ثابت. ولا يرى العميل أبدًا تفاصيل أخطاء الواجهة البرمجية؛ فهي تذهب إلى سجل التصحيح.

تحسب الإضافة الأسعار فقط. فهي لا تحصل على أسعار Correios الدولية (Exporta Fácil وPacket)، ولا تقديرات مواعيد التسليم، ولا الملصقات، ولا التسجيلات المسبقة، ولا البيانات الجمركية، ولا التتبع. ولا يستطيع العملاء اختيار فرع Correios أو خزانة. ولا تُضاف خدمات إضافية (القيمة المصرح بها، والتسليم باليد، وإشعار الاستلام). وتعرض خدمة واحدة من Correios لكل متجر، ولا تُحدَّث أسعار الصرف تلقائيًا.

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

الطلبات

عندما يُقدَّم طلب مع Correios، تحفظ الإضافة كيف حُسب سعر شحنه. ثم تعرض صفحة الطلب في Sales > Orders كتلة Correios تتضمن Correios service (مثل PAC — contract (03298)) وPrice: Live price (Correios API) أو Fixed price أو Free shipping. تُعرض الكتلة في الإدارة فقط، وليس في رسائل البريد الإلكتروني للعملاء، وتبقى ظاهرة عندما تكون الإضافة معطّلة.

في OpenCart 4 يحتفظ الدفع بطلب واحد ويحدّثه عندما يؤكد العميل مرة أخرى. وتُحدَّث بيانات Correios الخاصة بالطلب معه، وإذا انتقل العميل إلى طريقة شحن أخرى فلن تُعرض كتلة Correios لذلك الطلب بعد الآن.

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

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

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

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

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

لا تظهر Correios عند الدفع: تحقق من أن الترخيص نشط وأن Enable Correios مفعّل. تحقق من Geo zone (أو Ignore shipping zones وCountries)، وحدود الوزن، وMinimum order amount. من دون سعر لحظي يجب أن يوجد سعر ثابت للدولة أو للرمز *. تحقق من أن المنتجات لديها Requires Shipping على Yes.

تعرض الطريقة سعرًا ثابتًا بدلًا من سعر Correios: انظر إلى الحقل Log في صفحة الإضافة. تُسجَّل أخطاء Correios هناك: رمز وصول خاطئ، أو خدمة غير موجودة في عقدك، أو رمز CEP غير مخدوم، أو طرد يزيد على 30 kg أو يتجاوز حدود الحجم. تحقق أيضًا من أن رمز CEP للمصدر مُعدّ، وأن رمز CEP للعميل يتكون من 8 أرقام، وإذا لم تكن العملة الافتراضية BRL فتحقق من سعر الصرف إلى BRL. فعّل Debug log لرؤية كل حساب.

يفشل طلب الرمز المميز: تحقق من مستخدم الواجهة البرمجية، ورمز الوصول، وبطاقة الإرسال، والبيئة. يعمل رمز الوصول للاختبار فقط عندما تكون Homologation مفعّلة، ويعمل رمز الإنتاج فقط عندما تكون معطّلة.

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

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

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

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

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

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

Correios علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ Correios ولا يصادق عليها Correios.