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) प्राइस API का उपयोग करती हैं और इसके लिए पोस्टिंग कार्ड वाले Correios अनुबंध की क्रेडेंशियल्स चाहिए। आपको तीन मान चाहिए: आपका Meu Correios उपयोगकर्ता (आमतौर पर अनुबंध का CNPJ या CPF), API एक्सेस कोड और पोस्टिंग कार्ड नंबर। एक्सेस कोड 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 लाइसेंस कुंजी Edit पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
5. Correios API उपयोगकर्ता, एक्सेस कोड, पोस्टिंग कार्ड नंबर, मूल 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. लाइसेंस कुंजी और सेटिंग्स OpenCart 3 के चरण 4 और 5 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
इंस्टॉल के बाद, जब तक आप Enable Correios चालू करके सेव नहीं करते, यह मेथड बंद रहता है। अगर आप अनइंस्टॉल के बाद एक्सटेंशन फिर से इंस्टॉल करते हैं, तो आपकी रखी हुई Correios सेटिंग्स फिर से इस्तेमाल होती हैं।
Configuration
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Correios > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव कैश्ड Correios कीमतों और API टोकन को भी साफ़ करता है। संख्याएँ बिंदु या कॉमा के साथ लिखी जा सकती हैं। केवल इस एक्सटेंशन के लिए modify अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं।
जब लाइव कीमतें या यह मेथड काम नहीं कर सकता, तब पेज चेतावनियाँ दिखाता है: तीन क्रेडेंशियल्स में से कुछ ही भरे हैं, मूल 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 API (ब्राज़ील में लाइव कीमतें)
ब्राज़ील के पतों के लिए कीमत Correios प्राइस API से आती है। यदि API कोई कीमत नहीं देता (API बंद है, CEP सेवा में नहीं है, पार्सल बहुत बड़ा है), तो Country prices की निश्चित कीमत इस्तेमाल होती है, या यदि वह नहीं है तो मेथड छिपा दिया जाता है। त्रुटि का विवरण लॉग में जाता है, कभी ग्राहक को नहीं दिखता।
API user: आपका Meu Correios पोर्टल लॉगिन, आमतौर पर अनुबंध का CNPJ या CPF। इसे साफ़ करने से सेव किया हुआ एक्सेस कोड भी साफ़ हो जाता है।
Access code: Correios Web Services पोर्टल पर बना API एक्सेस कोड (código de acesso)। यह पोर्टल पासवर्ड नहीं है। सेव करने के बाद फ़ील्ड खाली रहता है और 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 वेबसाइट के Correios Fácil पेज पर देखा जा सकता है।
Homologation: Correios का परीक्षण (homologation) वातावरण उपयोग करता है: अनुरोध एक परीक्षण एक्सेस कोड के साथ 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 है, तो इसे खाली छोड़ें।
निश्चित कीमतें (ब्राज़ील के बाहर के देशों, बिना API क्रेडेंशियल्स के, और तब फ़ॉलबैक के रूप में जब API कोई कीमत न दे)
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: शिपिंग की ज़रूरत वाले उत्पादों का उप-योग (कूपन के बाद, टैक्स से पहले) जिस राशि से डिलीवरी मुफ़्त है। उस स्थिति में API अनुरोध नहीं भेजा जाता।
Tax class: शिपिंग शुल्क के ऊपर जोड़ी जाने वाली टैक्स क्लास, या No tax (डिफ़ॉल्ट)।
Geo zone: Correios केवल इस जियो ज़ोन के पतों को दिखाता है। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones के साथ इसका उपयोग नहीं होता।
शिपिंग ज़ोन के बिना उपलब्धता
आम तौर पर मेथड Conditions में चुने गए जियो ज़ोन में दिया जाता है (कोई न चुना हो तो सभी ज़ोन में)।
Ignore shipping zones: मेथड को नीचे दिए देशों के लिए दिखाता है, चाहे कोई भी जियो ज़ोन मेल खाए। तब Conditions का Geo zone जाँचा नहीं जाता।
Countries: इस मोड के लिए गंतव्य देश। स्टोर में सक्षम सभी देशों का उपयोग करने के लिए खाली छोड़ें। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: कीमत की गणनाएँ storage/logs/vfd_crr_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_crr_debug.log.php) में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ हमेशा लिखी जाती हैं, भले ही यह विकल्प बंद हो। API उपयोगकर्ता, एक्सेस कोड, पोस्टिंग कार्ड, टोकन और ग्राहकों के CEP लॉग नहीं होते। जब फ़ाइल 5 MB तक पहुँचती है, तो उसे vfd_crr_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।
Log: डीबग लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। साफ़ करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर एक्सटेंशन हटाने से Correios सेटिंग्स और लॉग मिट जाते हैं। बंद होने पर (डिफ़ॉल्ट) वे दोबारा इंस्टॉल करने के लिए रखे जाते हैं। ऑर्डर के साथ सेव हुई Correios सेवाएँ हमेशा रहती हैं।
इंपोर्ट / एक्सपोर्ट
Export: सेटिंग्स को JSON फ़ाइल के रूप में सेव करने के लिए Download JSON पर क्लिक करें। एक्सेस कोड एक्सपोर्ट नहीं होता।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मान सामान्य सेव की तरह जाँचे जाते हैं। सेव किया हुआ एक्सेस कोड बना रहता है।
चेकआउट पर यह कैसे काम करता है
जब OpenCart शिपिंग मेथड दिखाता है, तो वह एक्सटेंशन से Correios की कीमत माँगता है। यदि कोई Geo zone सेट है (और Ignore shipping zones बंद है) और पता उससे बाहर है, तो Correios नहीं दिखाया जाता। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। फिर एक्सटेंशन शर्तें जाँचता है: अनुमत देश (Ignore shipping zones के साथ), कार्ट का वज़न और न्यूनतम ऑर्डर राशि। ऑर्डर राशि शिपिंग की ज़रूरत वाले उत्पादों की कीमत है, कूपन छूट के बाद और टैक्स से पहले। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और Correios को कोई अनुरोध नहीं भेजा जाता।
क्रेडेंशियल्स सेट होने पर ब्राज़ील के पते के लिए, एक्सटेंशन पहले आपके पोस्टिंग कार्ड के लिए एक API टोकन लेता है। टोकन अनुबंध और क्षेत्रीय कार्यालय की संख्याएँ भी देता है, इसलिए कीमत आपके अनुबंध की कीमत होती है। फिर वह मूल और गंतव्य CEP, ग्राम में पार्सल का वज़न और cm में पार्सल का आकार देखकर चुनी गई सेवा की कीमत माँगता है। कीमत केवल तभी माँगी जाती है जब गंतव्य CEP 8 अंकों का हो। जब सभी उत्पादों के आयाम हों, तो पार्सल का आकार उनसे अनुमानित किया जाता है; अन्यथा Correios का न्यूनतम आकार भेजा जाता है। 30 kg से अधिक के पार्सल API को नहीं भेजे जाते। BRL कीमत आपकी दर से बदली जाती है। कीमत स्टोर की डिफ़ॉल्ट मुद्रा में गणना की जाती है, उस मुद्रा के दशमलव स्थानों पर पूर्णांकित होती है, और चुने गए Tax class के टैक्स के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है।
हर कीमत 1 घंटे के लिए कैश होती है। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि API बंद होने से हर चेकआउट अपडेट धीमा न हो। टोकन समाप्त होने से थोड़ा पहले तक कैश होता है (अधिकतम OpenCart कैश की अवधि तक, डिफ़ॉल्ट रूप से 1 घंटा) और अपने-आप नवीनीकृत होता है; यदि Correios उसे अस्वीकार करता है, तो नया टोकन माँगा जाता है और कीमत अनुरोध एक बार दोहराया जाता है। API टाइमआउट 12 सेकंड है।
यदि API कोई कीमत नहीं देता, तो निश्चित कीमत इस्तेमाल होती है, या निश्चित कीमत न होने पर मेथड छिपा दिया जाता है। ग्राहक को API त्रुटि का विवरण कभी नहीं दिखता; वह डीबग लॉग में जाता है।
एक्सटेंशन केवल दरों की गणना करता है। यह Correios की अंतरराष्ट्रीय कीमतें (Exporta Fácil, Packet), डिलीवरी समय के अनुमान, लेबल, प्री-पोस्टिंग, घोषणाएँ या ट्रैकिंग नहीं लेता। ग्राहक Correios एजेंसी या लॉकर नहीं चुन सकते। अतिरिक्त सेवाएँ (घोषित मूल्य, स्वयं सौंपना, रसीद सूचना) नहीं जोड़ी जातीं। यह हर स्टोर के लिए एक Correios सेवा दिखाता है, और मुद्रा दरें अपने-आप अपडेट नहीं होतीं।
OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग मेथड ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Correios चुनता है। यह मेथड 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.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। 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 चालू करें।
टोकन अनुरोध विफल होता है: API उपयोगकर्ता, एक्सेस कोड, पोस्टिंग कार्ड और वातावरण जाँचें। परीक्षण एक्सेस कोड केवल Homologation चालू होने पर काम करता है, और लाइव कोड केवल बंद होने पर।
बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश्ड कीमतें और API टोकन साफ़ हो जाते हैं।
पेज पर "Warning: You do not have permission to modify VibeFox Correios!" लिखा है: आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_correios (OpenCart 3) या extension/vfd_correios/shipping/vfd_correios (OpenCart 4) के लिए modify अनुमति दें।
डेवलपर्स के लिए: Correios API होस्ट को सेटिंग vfd_crr_api_url से बदला जा सकता है (परीक्षण के लिए); सेटिंग्स पेज पर इसके लिए कोई फ़ील्ड नहीं है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox Correios के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart हमेशा Enable Correios, Sort order, Tax class और Geo zone को रीसेट करता है। कैश्ड कीमतें और टोकन हमेशा हटा दिए जाते हैं। यदि Remove data on uninstall चालू है, तो Correios सेटिंग्स और डीबग लॉग भी हट जाते हैं। यदि बंद है, तो बाकी सेटिंग्स बनी रहती हैं और एक्सटेंशन फिर से इंस्टॉल करने पर दोबारा इस्तेमाल होती हैं। ऑर्डर के साथ सेव हुई Correios सेवाएँ हमेशा रहती हैं, और मौजूदा ऑर्डर अपनी शिपिंग मेथड और लागत बनाए रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Correios के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया हुआ पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Correios उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Correios से संबद्ध नहीं है और Correios द्वारा समर्थित नहीं है।