VibeFox Melhor Envio for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

PHP: 8.0 या उसके बाद का संस्करण।

Melhor Envio खाता (केवल लाइव कोटेशन के लिए): लाइव कोटेशन के लिए एक एक्सेस टोकन चाहिए। अपने Melhor Envio खाते में टोकन पेज (melhorenvio.com.br/painel/gerenciar/tokens) खोलें और "shipping-calculate" अनुमति वाला टोकन बनाएँ। परीक्षण के लिए, Melhor Envio के सैंडबॉक्स (sandbox.melhorenvio.com.br) में टोकन बनाएँ। प्रोडक्शन और सैंडबॉक्स टोकन अलग-अलग होते हैं। यहाँ "कनेक्ट" बटन नहीं है: आप टोकन को एक्सटेंशन की सेटिंग्स में चिपकाते हैं। टोकन के बिना विधि फ़ॉलबैक कीमतों का उपयोग करती है।

VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर खोलें (अनज़िप करें)। उसमें README.txt, OpenCart 3 का पैकेज vfd_melhor_envio-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_melhor_envio.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_melhor_envio-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए आपको Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी किया जा सकता है।

2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Melhor Envio ढूँढें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।

4. Edit पेज के सबसे ऊपर के लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

5. एक्सेस टोकन, संपर्क ईमेल और भेजने वाले स्थान का CEP चिपकाएँ। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL नहीं है, तो BRL exchange rate सेट करें। वैकल्पिक रूप से फ़ॉलबैक कीमत तालिका (जैसे ब्राज़ील के लिए) या फ़ॉलबैक लागत भरें। Enable Melhor Envio shipping चालू करें और Save पर क्लिक करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_melhor_envio.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Melhor Envio ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 4 और 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

इंस्टॉल के बाद जब तक आप Enable Melhor Envio shipping चालू करके सेव नहीं करते, तब तक यह विधि बंद रहती है। अनइंस्टॉल के बाद यदि आप एक्सटेंशन दोबारा इंस्टॉल करते हैं, तो आपकी रखी गई सेटिंग्स फिर से इस्तेमाल होती हैं।

कॉन्फ़िगरेशन

सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Melhor Envio > Edit। खंड बाईं ओर सूचीबद्ध हैं। एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव पर कैश की गई Melhor Envio कोटेशन और आखिरी API त्रुटि भी साफ़ हो जाती है। केवल इस एक्सटेंशन के लिए संशोधन अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं।

पेज के ऊपर (और हर सेव के बाद) की चेतावनियाँ अधूरे सेटअप को दिखाती हैं: खाली या 8 अंकों से अलग भेजने वाले स्थान का CEP, गायब संपर्क ईमेल, गायब BRL विनिमय दर, टोकन और फ़ॉलबैक कीमत दोनों का न होना (तब विधि कभी नहीं दिखाई जाती), टोकन सेव होने पर तारीख के साथ आखिरी Melhor Envio API त्रुटि, या ऐसा स्टोर जिसमें वज़न श्रेणी "kg" या लंबाई श्रेणी "cm" नहीं है (तब इकाइयाँ उनके नाम से बदली जाती हैं, और अज्ञात इकाइयों को kg या cm माना जाता है)। यदि Name खाली, बहुत लंबा या < > ; = # { } में से कोई वर्ण रखता है, किसी संख्या फ़ील्ड में 0 या उससे बड़ी संख्या के अलावा कुछ है, Min weight, Max weight से बड़ा है, या Default product size लंबाई x चौड़ाई x ऊँचाई के रूप में नहीं है, तो पेज त्रुटि दिखाता है और कुछ भी सेव नहीं होता।

सामान्य

सेटिंग्स हर जियो ज़ोन पर लागू होती हैं। Availability में आप विधि को किसी जियो ज़ोन तक सीमित कर सकते हैं। कीमत हमेशा एक्सटेंशन से आती है।

Enable Melhor Envio shipping: चेकआउट पर Melhor Envio दिखाता या छिपाता है। डिफ़ॉल्ट: off।

Name: कार्ट और चेकआउट में ग्राहकों को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Melhor Envio। आवश्यक, अधिकतम 64 अक्षर।

Sort order: चेकआउट पर शिपिंग विधियों के बीच Melhor Envio का स्थान। एक पूर्ण संख्या।

Melhor Envio API

Access token: नीचे चुने गए वातावरण का टोकन। यह Bearer टोकन के रूप में Melhor Envio को भेजा जाता है। सेव करने के बाद फ़ील्ड खाली रहता है और A token is saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया टोकन लिखें। सेव किया गया टोकन हटाने के लिए Remove the saved token चिह्नित करें और सेव करें। टोकन कभी लॉग में नहीं लिखा जाता।

Sandbox: परीक्षण के लिए Melhor Envio का सैंडबॉक्स (sandbox.melhorenvio.com.br) उपयोग करें। उसके साथ सैंडबॉक्स टोकन इस्तेमाल करें। डिफ़ॉल्ट: off।

Contact e-mail: एक तकनीकी संपर्क ईमेल, जो हर अनुरोध के User-Agent हेडर में Melhor Envio को भेजा जाता है, जैसे tech@example.com। Melhor Envio हर इंटीग्रेशन से इसकी माँग करता है। अमान्य पता सेव नहीं होता, और एक सूचना इसकी जानकारी देती है।

Origin CEP: वह CEP (8 अंक) जहाँ से पार्सल भेजे जाते हैं, जैसे 01310-100। OpenCart में स्टोर का पिन कोड नहीं होता, इसलिए लाइव कोटेशन के लिए यह फ़ील्ड ज़रूरी है। 8 अंकों से अलग CEP सूचना के साथ सेव होता है, पर कोई कोटेशन नहीं माँगा जाता।

Services: कोटेशन के लिए Melhor Envio सेवा ID की अल्पविराम से अलग की गई वैकल्पिक सूची, जैसे 1 = Correios PAC, 2 = Correios SEDEX, 17 = Correios Mini Envios, 3 = Jadlog .Package, 4 = Jadlog .Com। खाते की हर सेवा के लिए कोटेशन पाने हेतु खाली छोड़ें।

Quotes at checkout: कोटेशन कैसे दिखाए जाते हैं।

Delivery time: नाम के पास Melhor Envio का डिलीवरी अनुमान दिखाता है, जैसे "(3-5 business days)"। डिफ़ॉल्ट: on।

Declared value: कोटेशन में उत्पाद का मूल्य (बीमा) घोषित करता है। बंद होने पर कोटेशन बिना घोषित मूल्य के बनते हैं: सस्ते, पर पार्सल बीमित नहीं होते। डिफ़ॉल्ट: on।

BRL exchange rate: Melhor Envio ब्राज़ीलियाई रियल में कोटेशन देता है। यह केवल तब चाहिए जब आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL न हो: अपनी डिफ़ॉल्ट मुद्रा में 1 BRL की कीमत दर्ज करें, जैसे 0.17। इसके बिना लाइव कोटेशन इस्तेमाल नहीं होते। मान 0 से बड़ा होना चाहिए। घोषित मूल्य उसी दर से BRL में बदला जाता है। यदि आपकी डिफ़ॉल्ट मुद्रा BRL है, तो फ़ील्ड बताता है कि Melhor Envio की कीमतें जैसी हैं वैसी ही इस्तेमाल होती हैं।

Default product weight (kg): बिना वज़न वाले उत्पादों के लिए इस्तेमाल होता है, कोटेशन और वज़न सीमाओं दोनों में। 0 से बड़ा होना चाहिए। डिफ़ॉल्ट: 0.3।

Default product size (cm): लंबाई x चौड़ाई x ऊँचाई, बिना आयाम वाले उत्पादों के लिए। डिफ़ॉल्ट: 16x11x5।

फ़ॉलबैक कीमतें (आपके स्टोर की डिफ़ॉल्ट मुद्रा में)

फ़ॉलबैक कीमतें तब उपयोग होती हैं जब कोई टोकन न हो, गंतव्य CEP गायब हो, या API कोई कोटेशन न दे (त्रुटि, टाइमआउट, कवरेज न होना)।

Fallback price table: देश और कार्ट के वज़न के अनुसार कीमत, कर को छोड़कर। एक पंक्ति जोड़ने के लिए Add country पर क्लिक करें (नई पंक्ति ब्राज़ील से शुरू होती है), और किसी पंक्ति को हटाने के लिए हटाएँ बटन। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * Any country चुनें। हर पंक्ति में एक Price और वज़न कॉलम होते हैं: XS 1 kg तक, S 1-2 kg, M 2-3 kg, L 3-5 kg और XL 5 kg से ऊपर। खाली या 0 वाला कॉलम Price का उपयोग करता है, और Price 0 हो तो मुफ़्त शिपिंग होती है। "9.99" और "9,99" दोनों स्वीकार्य हैं। जो मान संख्या नहीं हैं, वे सेव के बाद सूचित होते हैं और अनदेखे किए जाते हैं। जिन पंक्तियों में कोई कीमत न हो, वे हटा दी जाती हैं।

Fallback cost: तब उपयोग होती है जब तालिका में भी कीमत न हो। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।

Fallback calculation: Per order (डिफ़ॉल्ट) फ़ॉलबैक कीमत एक बार लेता है। Per item (each item priced by its own weight x quantity) हर आइटम के वज़न (वज़न न होने पर डिफ़ॉल्ट वज़न) के लिए फ़ॉलबैक कीमत खोजता है और उसे उसकी मात्रा से गुणा करता है। यह केवल फ़ॉलबैक कीमतों पर लागू होता है। Melhor Envio के कोटेशन में पहले से हर आइटम शामिल होता है।

उपलब्धता

Min weight (kg): कार्ट का वज़न इससे कम हो तो विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।

Max weight (kg): कार्ट का वज़न इससे ज़्यादा हो तो विधि छिपाता है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं। खाली फ़ील्ड का अर्थ है 30 kg, या जब Ignore shipping zones चालू हो तो कोई सीमा नहीं।

Minimum subtotal: विधि केवल तब दिखाता है जब कार्ट का उप-योग (शिपिंग की ज़रूरत वाले उत्पाद, कूपन के बाद, कर से पहले) कम से कम यह राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।

Free shipping from: वह कार्ट उप-योग जिससे शिपिंग मुफ़्त होती है। हर सेवा के लिए एक विकल्प के साथ, केवल सबसे सस्ती सेवा मुफ़्त होती है। तेज़ सेवाएँ अपनी कीमत रखती हैं। बंद करने के लिए खाली छोड़ें।

Tax class: शिपिंग लागत के ऊपर जोड़ी गई टैक्स क्लास, या No tax (डिफ़ॉल्ट)। Melhor Envio की कीमतें कैरियर की अंतिम कीमतें हैं। यदि OpenCart उन पर कर न जोड़े, तो No tax चुनें।

Geo zone: Melhor Envio केवल इस जियो ज़ोन के पतों के लिए देता है। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। जब Ignore shipping zones चालू हो, तब जियो ज़ोन की जाँच नहीं होती।

शिपिंग ज़ोन के बिना उपलब्धता

आम तौर पर विधि Availability में चुने गए जियो ज़ोन में दी जाती है (कोई न चुना हो तो सभी ज़ोन में)।

Ignore shipping zones: चुने गए जियो ज़ोन चाहे जो हो, नीचे सूचीबद्ध देशों के लिए विधि देता है। इस मोड में जियो ज़ोन की जाँच नहीं होती।

Countries: इस मोड के लिए गंतव्य देश। सभी देशों के लिए खाली छोड़ें। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।

उन्नत

Debug log: API अनुरोध और दर गणना को storage/logs/vfd_menv_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_menv_debug.log.php) में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। यह विकल्प बंद होने पर भी API त्रुटियाँ हमेशा दर्ज होती हैं। टोकन कभी लॉग नहीं होता, और ग्राहक का CEP केवल पहले 5 अंकों तक लिखा जाता है। जब फ़ाइल 5 MB तक पहुँचती है, तो उसे vfd_menv_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।

Log: डीबग लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Remove data on uninstall: चालू होने पर एक्सटेंशन हटाने से सभी एक्सटेंशन सेटिंग्स और लॉग हट जाते हैं। बंद होने पर (डिफ़ॉल्ट) वे दोबारा इंस्टॉल करने के लिए रहते हैं। कोटेशन कैश हमेशा हटता है। ऑर्डर के साथ सहेजी गई सेवाएँ ऑर्डर इतिहास का हिस्सा हैं और रहती हैं।

आयात / निर्यात

Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। एक्सेस टोकन निर्यात नहीं होता।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मान एक सामान्य सेव की तरह जाँचे जाते हैं। सहेजा गया एक्सेस टोकन रखा जाता है।

चेकआउट पर यह कैसे काम करता है

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से Melhor Envio की कीमत माँगता है। यदि कोई Geo zone सेट है और पता उससे बाहर है, तो Melhor Envio नहीं दिया जाता। Ignore shipping zones के साथ जियो ज़ोन की जाँच नहीं होती: Melhor Envio केवल तब दिया जाता है जब देश Countries में हो (या Countries खाली हो)। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। फिर एक्सटेंशन कार्ट का वज़न और न्यूनतम उप-योग जाँचता है।

8 अंकों वाले CEP के साथ ब्राज़ील के डिलीवरी पते के लिए, एक्सटेंशन Melhor Envio को भेजने वाले और गंतव्य CEP, और हर भेजे जा सकने वाले आइटम का वज़न, आकार, मात्रा और घोषित मूल्य भेजता है, साथ ही यदि आपने सेवाओं की सूची दी है तो वह भी। उत्पाद का Model आइटम ID के रूप में भेजा जाता है। त्रुटि वाली या बिना कीमत वाली सेवाएँ छोड़ दी जाती हैं। कोटेशन आपकी डिफ़ॉल्ट मुद्रा में बदले जाते हैं, उसके दशमलव स्थानों तक राउंड होते हैं, कीमत के अनुसार छाँटे जाते हैं, और चुने गए Tax class के कर के साथ ग्राहक की मुद्रा में दिखाए जाते हैं। यदि मुफ़्त शिपिंग लागू होती है, तो सबसे सस्ती सेवा की कीमत 0 होती है।

One option - the cheapest service के साथ ग्राहक को एक विकल्प दिखता है, जैसे Melhor Envio (6-7 business days)। One option per service के साथ ग्राहक को हर सेवा के लिए एक विकल्प दिखता है, जैसे Melhor Envio: Correios SEDEX (1-2 business days)। डिलीवरी अनुमान केवल तब जोड़ा जाता है जब Delivery time चालू हो।

हर कोटेशन 1 घंटे तक कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल कॉल 5 मिनट तक याद रखी जाती है, ताकि API बाधा हर चेकआउट रीफ़्रेश को धीमा न करे। API टाइमआउट 12 सेकंड है।

यदि कोई टोकन नहीं है, पता ब्राज़ील के बाहर है या अभी वैध CEP नहीं है, BRL विनिमय दर गायब है, या Melhor Envio त्रुटि या उस मार्ग के लिए कोई सेवा नहीं लौटाता, तो फ़ॉलबैक कीमतें इस्तेमाल होती हैं: देश की पंक्ति (या देश की पंक्ति न हो तो * पंक्ति), नहीं तो फ़ॉलबैक लागत। ऐसा विकल्प केवल Name में लिखे नाम से पुकारा जाता है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत न होने पर भी विधि मुफ़्त दिखाई जाती है। यदि कोई कीमत ही नहीं है, तो विधि छिप जाती है। ग्राहक को कभी API त्रुटि नहीं दिखती। कारण लॉग में लिखा जाता है।

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Melhor Envio का विकल्प चुनता है। विकल्प और कीमतें OpenCart 3 जैसी ही हैं।

यह एक्सटेंशन केवल कीमतें गिनता है। यह लेबल न खरीदता है, न बनाता है, Melhor Envio कार्ट में शिपमेंट नहीं जोड़ता, पार्सल ट्रैक नहीं करता, पिकअप शेड्यूल नहीं करता, और इनवॉइस (NF-e) डेटा नहीं भेजता। यह कैरियर एजेंसी (ड्रॉप-ऑफ पॉइंट) चुनने की सुविधा नहीं देता। शिपमेंट अपने Melhor Envio पैनल में प्रबंधित करें। Melhor Envio केवल ब्राज़ील के भीतर भेजता है। अन्य देशों को केवल फ़ॉलबैक कीमतें मिलती हैं।

ऑर्डर

OpenCart चुने गए विकल्प का नाम ऑर्डर की शिपिंग विधि के रूप में सेव करता है, इसलिए सेवा और डिलीवरी अनुमान ऑर्डर ईमेल, ग्राहक के खाते और Sales > Orders में दिखते हैं।

जब लाइव कोटेशन के साथ ऑर्डर दिया जाता है, तो एक्सटेंशन Melhor Envio की सेवा को भी ठीक वैसे ही सेव करता है जैसे ग्राहक ने डिलीवरी चरण में देखी थी, बिना नए अनुरोध के। Sales > Orders में एडमिन ऑर्डर पेज पर Melhor Envio ब्लॉक दिखता है, जिसमें Melhor Envio service, Service ID और Delivery estimate होते हैं, ताकि आप जानें कि Melhor Envio में कौन-सी सेवा खरीदनी है। ग्राहक अपने खाते के ऑर्डर पेज पर Melhor Envio service और Delivery estimate देखता है। फ़ॉलबैक कीमत पर दिए गए ऑर्डरों में कोई सेवा नहीं होती। मौजूदा ऑर्डर प्रभावित नहीं होते।

OpenCart 4 पर Melhor Envio ब्लॉक History के ऊपर दिखता है। OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और ग्राहक जब भी फिर से पुष्टि करता है तो उसे अपडेट करता है: सेव की गई सेवा उसके साथ अपडेट होती है, और जब ग्राहक दूसरी शिपिंग विधि चुनता है या ऑर्डर को फ़ॉलबैक कीमत मिलती है, तो वह हटा दी जाती है।

लाइसेंस कुंजी

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Melhor Envio, Extensions > Extensions > Shipping > VibeFox Melhor Envio > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे पंक्ति Product: opencart-shipping-melhor-envio और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। कुंजी केवल इस एक्सटेंशन के लिए Modify अनुमति वाले एडमिन उपयोगकर्ता बदल सकते हैं। ब्लॉक के टेक्स्ट एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर से संपर्क नहीं हो पाता, तो एक्सटेंशन आखिरी ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया गया स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

सक्रिय कुंजी के बिना, Melhor Envio ग्राहकों को चेकआउट पर नहीं दिखाया जाता और कोई दर नहीं गिनी जाती। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन में लॉग इन है, उसे स्टोर में यह विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और परीक्षण कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन को नहीं देखता, इसलिए सक्रिय कुंजी के बिना विधि सभी के लिए छिपी रहती है। एडमिन Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

जब लाइसेंस समाप्त हो जाता है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्टेटस अपने आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ाना एक बार, उसके बाद हर सप्ताह एक बार। कोई cron job ज़रूरी नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

समस्या निवारण

चेकआउट पर Melhor Envio दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Melhor Envio shipping चालू है। Geo zone जाँचें, या Ignore shipping zones चालू करके Countries जाँचें। एक्सटेंशन पेज के ऊपर की चेतावनियाँ, वज़न की सीमाएँ और Minimum subtotal देखें। टोकन या कोटेशन के बिना विधि को फ़ॉलबैक कीमत चाहिए: Fallback price table में एक पंक्ति, या एक Fallback cost। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।

केवल फ़ॉलबैक कीमतें दिखती हैं: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: टोकन नहीं है, भेजने वाले स्थान का CEP 8 अंकों का नहीं है, BRL से अलग डिफ़ॉल्ट मुद्रा के लिए BRL exchange rate नहीं है, अभी गंतव्य CEP नहीं है, या कोई सेवा इस मार्ग को कवर नहीं करती।

लॉग या चेतावनियों में HTTP 401 या 403: Melhor Envio ने एक्सेस टोकन अस्वीकार कर दिया है। वह गलत है, समाप्त हो गया है या रद्द हो गया है, या दूसरे वातावरण का है। नया टोकन बनाएँ और जाँचें कि Sandbox उसके अनुरूप है।

Melhor Envio की कीमत में कर जुड़ रहा है: Tax class को No tax पर सेट करें।

बदलाव के बाद कोटेशन पुराने लगते हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश किए गए कोटेशन साफ़ हो जाते हैं।

पेज पर लिखा है "Warning: You do not have permission to modify VibeFox Melhor Envio!": आपका एडमिन उपयोगकर्ता समूह केवल सेटिंग्स देख सकता है। समूह को System > Users > User Groups में extension/shipping/vfd_melhor_envio (OpenCart 3) या extension/vfd_melhor_envio/shipping/vfd_melhor_envio (OpenCart 4) के लिए संशोधन अनुमति दें।

डेवलपर के लिए: Melhor Envio कोटेशन API का पता सेटिंग vfd_menv_api_url (परीक्षण के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसके लिए कोई फ़ील्ड नहीं है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox Melhor Envio के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart हमेशा Enable Melhor Envio shipping, Sort order, Tax class और Geo zone को रीसेट करता है। कोटेशन कैश हमेशा हटता है। यदि Remove data on uninstall चालू है, तो बाकी सेटिंग्स और डीबग लॉग भी हट जाते हैं। यदि यह बंद है, तो वे रखे जाते हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर से इस्तेमाल होते हैं। ऑर्डर के साथ सहेजी गई सेवाएँ हमेशा रहती हैं, और मौजूदा ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।

OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल की गई एक्सटेंशन सूची में VibeFox Melhor Envio के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Melhor Envio उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Melhor Envio से संबद्ध नहीं है और न ही Melhor Envio द्वारा समर्थित है।