VibeFox Blue Express for OpenCart — सहायता

आवश्यकताएँ

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

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

Blue Express खाता (केवल लाइव दरों के लिए): लाइव दरों के लिए Blue Express ई-कॉमर्स खाता और उसकी API कुंजी (x-api-key) चाहिए। इसके लिए Blue Express से अनुरोध करें: developers.bluex.cl या gpo.integraciones@bx.cl। जिस सेवा का आप उपयोग करते हैं (EX, PY या MD), वह आपके Blue Express अनुबंध में सक्षम होनी चाहिए। यदि आप केवल निश्चित मूल्य इस्तेमाल करते हैं, तो आपको API कुंजी की ज़रूरत नहीं है।

चिली के क्षेत्र: लाइव दर के लिए डिलीवरी पते में चिली का क्षेत्र होना चाहिए। यदि आपके स्टोर में चिली के क्षेत्र नहीं हैं, तो एक्सटेंशन आपके लिए उन्हें जोड़ सकता है (देखें कॉन्फ़िगरेशन)।

पिकअप पॉइंट: Blue Express मानचित्र ग्राहक के ब्राउज़र में widget-pudo.blue.cl से लोड होता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. API कुंजी, सेवा, मूल डाक क्षेत्र कोड (जैसे SCL), यदि आपके स्टोर की मुद्रा CLP नहीं है तो CLP एक्सचेंज रेट, और निश्चित मूल्य (जैसे CL=4500) दर्ज करें। होम डिलीवरी के लिए Enable/Disable चालू करें और Blue Express पॉइंट पर पिकअप देना हो तो Pickup point option चालू करें। Save पर क्लिक करें। देखें कॉन्फ़िगरेशन।

OpenCart 4

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

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

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

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

इंस्टॉल होने पर एक्सटेंशन ऑर्डर के पिकअप पॉइंट के लिए एक टेबल बनाता है। जब तक आप होम डिलीवरी या पिकअप विकल्प चालू करके सेव नहीं करते, तब तक यह विधि बंद रहती है। अनइंस्टॉल के बाद एक्सटेंशन दोबारा इंस्टॉल करने पर, आपकी रखी हुई Blue Express सेटिंग्स फिर से उपयोग होती हैं।

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

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

अमान्य मान त्रुटि के साथ अस्वीकार होते हैं और कुछ भी सेव नहीं होता: खाली नाम या ऐसा नाम जिसमें < > ; = # { } अक्षर हों, 64 अक्षरों से लंबा नाम, ऋणात्मक या अमान्य संख्या, Min weight (kg) का Max weight (kg) से बड़ा होना, ऐसा Sort order जो पूर्ण संख्या नहीं है, या अज्ञात टैक्स क्लास या जियो ज़ोन।

ऐसी सेटिंग्स के बारे में चेतावनियाँ, जो विकल्पों या लाइव दर को छिपा देंगी, पेज के ऊपर दिखती हैं: API कुंजी न होना, Exchange rate के बिना CLP से अलग स्टोर मुद्रा, निश्चित मूल्य तालिका का खाली होना, चिली के लिए कोई ज़ोन न होना, और ऐसा स्टोर जिसमें kg वज़न क्लास या cm लंबाई क्लास नहीं है जिसकी डिफ़ॉल्ट इकाई एक्सटेंशन पहचान नहीं पाता (तब वज़न kg और आयाम cm माने जाते हैं)।

सामान्य

Enable/Disable: चेकआउट पर Blue Express होम डिलीवरी को चालू या बंद करता है।

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

Tax class: शिपिंग लागत की टैक्स क्लास, या None (no tax on shipping) (डिफ़ॉल्ट)। Blue Express मूल्यों में IVA शामिल है। यदि OpenCart उसके ऊपर टैक्स नहीं जोड़े, तो None चुनें। यह दोनों विकल्पों पर लागू होता है।

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

Blue Express पॉइंट पर पिकअप (PUDO)

Pickup point option: होम डिलीवरी के साथ दूसरे विकल्प के रूप में, ग्राहक द्वारा चुने गए Blue Express पॉइंट पर डिलीवरी देता है। डिफ़ॉल्ट रूप से बंद।

Pickup point name: Blue Express पॉइंट पर पिकअप के लिए चेकआउट पर दिखने वाली शिपिंग विधि का नाम। डिफ़ॉल्ट: Blue Express pickup point। अनिवार्य, अधिकतम 64 अक्षर।

Blue Express API (लाइव दरों के लिए आवश्यक)

API key: आपकी Blue Express API कुंजी (हेडर x-api-key)। इसके बिना केवल निश्चित मूल्य उपयोग होते हैं। सेव करने के बाद फ़ील्ड खाली रहता है और A key is saved - leave empty to keep it. दिखाता है। नया मान केवल तभी दर्ज करें जब उसे बदलना हो।

Remove the saved API key: चालू करके सेव करें, ताकि सहेजी गई कुंजी हट जाए।

Service: दर के लिए उपयोग होने वाली Blue Express सेवा: Express (EX) (डिफ़ॉल्ट), Prioritario (PY) या SameDay (MD)। यह आपके Blue Express अनुबंध में सक्षम होनी चाहिए।

Origin district code: उस स्थान का Blue Express जिला कोड जहाँ से आप शिप करते हैं, जैसे सैंटियागो के लिए SCL (डिफ़ॉल्ट)। यदि अनिश्चित हों तो Blue Express से पूछें।

CLP per 1 (your currency): लेबल आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखाता है, जैसे CLP per 1 EUR। Blue Express मूल्य चिली पेसो (CLP) में होते हैं। अपने स्टोर की डिफ़ॉल्ट मुद्रा की एक इकाई का मान CLP में दर्ज करें, जैसे 1050। इसके बिना लाइव दरें उपयोग नहीं होतीं। स्टोर की मुद्रा CLP होने पर इसे अनदेखा किया जाता है।

मूल्य

Rate source: मूल्य की गणना कैसे होती है। लाइव दर के लिए क्षेत्र और कम्यून (शहर) के साथ चिली का पता चाहिए। त्रुटियाँ लॉग में लिखी जाती हैं और ग्राहक को कभी नहीं दिखाई जातीं।

Fixed prices: हर देश के लिए एक पंक्ति, देश कोड=मूल्य के प्रारूप में, स्टोर की डिफ़ॉल्ट मुद्रा में, कर के बिना, जैसे CLP स्टोर में CL=4500 या EUR स्टोर में CL=4.50। दशमलव विभाजक के रूप में अल्पविराम या बिंदु स्वीकार होता है। अमान्य पंक्तियाँ अनदेखी की जाती हैं और सेव करते समय चेतावनी में सूचीबद्ध होती हैं। जिस देश की पंक्ति नहीं है, उसका निश्चित मूल्य नहीं होता, इसलिए निश्चित मूल्य की ज़रूरत होने पर उस देश के लिए विकल्प छिप जाते हैं। निश्चित मूल्य किसी भी देश के लिए उपयोग किए जा सकते हैं।

Fixed price per: Order (डिफ़ॉल्ट) मूल्य एक बार लेता है। Item (price x quantity) उसे कार्ट में आइटमों की संख्या से गुणा करता है। यह केवल निश्चित मूल्य पर लागू होता है। API दर हमेशा पूरी शिपमेंट के लिए होती है।

शर्तें

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

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

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

मुफ़्त शिपिंग

Free shipping: कार्ट के उप-योग से मुफ़्त शिपिंग चालू करता है।

Free from subtotal: कार्ट का उप-योग (स्टोर की मुद्रा, शिप होने वाले उत्पाद, कूपन के बाद, कर के बिना) जिससे शिपिंग मुफ़्त है। तब Blue Express को कोई अनुरोध नहीं जाता। केवल तब उपयोग होता है जब Free shipping चालू हो।

उपलब्धता

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

Ignore shipping zones: हर जियो ज़ोन में दोनों विकल्प दें। तब देशों को नीचे की सूची सीमित करती है।

Countries: इस मोड के गंतव्य देश। सभी देशों की अनुमति के लिए खाली छोड़ें। यह केवल Ignore shipping zones के साथ उपयोग होता है।

चिली के क्षेत्र (केवल तब दिखता है जब आपके स्टोर में चिली के क्षेत्र नहीं हैं)

Blue Express को लाइव दर के लिए चिली के पते का क्षेत्र (RM, VS आदि) चाहिए। क्षेत्र पते के ज़ोन से, उसके कोड या नाम के आधार पर लिया जाता है। यह सेक्शन दिखाता है कि आपके स्टोर में चिली के कितने ज़ोन हैं और कौन-से क्षेत्र नहीं हैं (एक मानक OpenCart 3.0.5 स्टोर में 16 में से 15 हैं, Ñuble नहीं है)। गायब क्षेत्रों को Blue Express द्वारा उपयोग किए जाने वाले कोड के साथ चिली के ज़ोन के रूप में जोड़ने के लिए Add Chilean regions पर क्लिक करें। कोड या नाम से पहले से मौजूद क्षेत्र दोबारा नहीं जोड़े जाते। बटन दबाने तक कुछ नहीं बदलता। आप इन्हें System > Localisation > Zones में खुद भी जोड़ सकते हैं।

उन्नत

Debug log: अनुरोध और निर्णय storage/logs/vfd_blex_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ हमेशा लॉग होती हैं। API कुंजी और ग्राहक के पते कभी लॉग नहीं होते। काम पूरा होने पर लॉग बंद कर दें। लॉग 5 MB तक पहुँचने पर घुमा दिया जाता है।

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

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

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

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

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

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह हर सक्षम विकल्प का मूल्य एक्सटेंशन से माँगता है। यदि Geo zone सेट है (और Ignore shipping zones बंद है) और पता उसके बाहर है, तो Blue Express नहीं दिया जाता। Ignore shipping zones चालू होने पर Countries सूची तय करती है। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। एक्सटेंशन फिर कार्ट का वज़न और Minimum order subtotal जाँचता है। उप-योग वह मूल्य है जो शिप होने वाले उत्पादों का है, कूपन छूट के बाद और कर से पहले। गिफ़्ट कार्ड, रिवॉर्ड पॉइंट और स्टोर क्रेडिट को ध्यान में नहीं रखा जाता। यदि मुफ़्त शिपिंग लागू होती है, तो मूल्य 0 होता है और Blue Express को कोई अनुरोध नहीं जाता।

लाइव दर के लिए पता चिली में होना चाहिए, क्षेत्र और शहर (कम्यून) के साथ। एक्सटेंशन पहले Blue Express से कम्यून पहचानने को कहता है, फिर सेवा, मूल जिले, गंतव्य और पार्सल के लिए मूल्य माँगता है। हर उत्पाद अपने वज़न और आयामों को उसकी वज़न और लंबाई क्लास से kg और cm में बदलकर भेजा जाता है। बिना वज़न या आकार वाले उत्पाद 0.01 kg, 10 x 10 x 10 cm के रूप में भेजे जाते हैं। घोषित मूल्य CLP में भेजा जाता है। CLP मूल्य को स्टोर की डिफ़ॉल्ट मुद्रा में बदला जाता है, उसके दशमलव स्थानों तक राउंड किया जाता है, और चुने गए Tax class के कर के साथ ग्राहक को उसकी मुद्रा में दिखाया जाता है।

दरें 1 घंटे तक और कम्यून डेटा 12 घंटे तक कैश होता है, लेकिन OpenCart की कैश अवधि (डिफ़ॉल्ट 1 घंटा) से अधिक नहीं। विफल API कॉल 5 मिनट तक याद रखी जाती है, और टाइमआउट 10 सेकंड है, ताकि धीमा या अनुपलब्ध API हर चेकआउट रीफ़्रेश को धीमा न करे। API त्रुटियाँ ग्राहक को कभी नहीं दिखतीं: विकल्प छिप जाता है, या बैकअप मोड में निश्चित मूल्य उपयोग होता है। कारण लॉग में लिखा जाता है।

एक्सटेंशन Blue Express में शिपमेंट या लेबल नहीं बनाता, ट्रैकिंग नंबर नहीं देता और ट्रैकिंग अपडेट नहीं दिखाता। शिपमेंट अपने Blue Express खाते में बनाएँ। कम्यून-वार क्षेत्रीय दर तालिकाएँ नहीं हैं: Blue Express API दर या प्रति देश एक निश्चित मूल्य का उपयोग करें। लाइव दरें केवल चिली के लिए काम करती हैं।

OpenCart 4 में ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Blue Express या Blue Express pickup point चुनता है। ये विकल्प OpenCart 3 की तरह ही काम करते हैं; पिकअप पॉइंट बॉक्स का वर्णन पिकअप पॉइंट में है।

पिकअप पॉइंट

जब Pickup point option चालू हो, तो OpenCart चेकआउट के Delivery Method चरण में Blue Express pickup point के नीचे Choose pickup point बटन वाला एक बॉक्स दिखता है। यह बटन Blue Express का आधिकारिक मानचित्र खोलता है, जहाँ ग्राहक एक पॉइंट चुनता है। चुना गया पॉइंट उसके नाम और पते के साथ दिखता है, और बटन Change pickup point में बदल जाता है। पॉइंट चेकआउट सत्र के लिए सेव होता है, और दर Blue Express पिकअप (PUDO) मूल्य के साथ फिर से गणना होती है। यदि मूल्य बदलता है, तो विकल्प नया मूल्य दिखाता है। यदि उस पॉइंट के लिए यह विकल्प अब नहीं दिया जाता, तो डिलीवरी चरण फिर से लोड होता है। जब तक कोई पॉइंट नहीं चुना जाता, विकल्प होम डिलीवरी का मूल्य दिखाता है।

ग्राहक पॉइंट चुने बिना आगे नहीं बढ़ सकता: डिलीवरी चरण पर Continue को Please choose a Blue Express pickup point. के साथ अस्वीकार किया जाता है। यह ब्राउज़र में और फिर स्टोर द्वारा जाँचा जाता है। गलत प्रारूप वाला पॉइंट कोड The selected Blue Express pickup point is not valid. Please choose it again on the map. के साथ अस्वीकार होता है, और पिछला चुनाव बना रहता है। यदि सेव विफल होता है, तो ग्राहक को The pickup point could not be saved. Please try again. दिखता है।

OpenCart 4 में ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है। Shipping method options विंडो में, जब तक यह विकल्प चुना है, Blue Express pickup point के नीचे Choose pickup point वाला वही बॉक्स दिखता है। चुने गए पॉइंट के साथ मूल्य बदलने पर विंडो का विकल्प नया मूल्य दिखाता है, और यदि पिकअप विकल्प चेकआउट के लिए पहले से सेव था तो शिपिंग विधि का फ़ील्ड और ऑर्डर पुष्टि ब्लॉक भी अपडेट होते हैं। यदि उस पॉइंट के लिए यह विकल्प अब नहीं दिया जाता, तो विंडो बंद हो जाती है और शिपिंग विधियों की सूची फिर से लोड होती है। बिना पॉइंट के विंडो में Continue पर क्लिक करने पर बॉक्स में Please choose a Blue Express pickup point. दिखाकर रोक लगती है, और स्टोर इसे फिर से जाँचता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और हर पुष्टि पर उसे अपडेट करता है; ऑर्डर का पिकअप पॉइंट उसी के साथ अपडेट होता है, और ऑर्डर को किसी दूसरी शिपिंग विधि में बदलने पर वह हट जाता है।

ऑर्डर देने पर पॉइंट, Blue Express एजेंसी कोड, नाम, पते और क्षेत्र के साथ ऑर्डर में सेव होता है। यह पिकअप विकल्प के नाम के बाद ऑर्डर की शिपिंग विधि में भी जुड़ जाता है, जैसे Blue Express pickup point: Blue Point Providencia, Av. Providencia 1234, ताकि ग्राहक इसे ऑर्डर ईमेल और अपने खाते के ऑर्डर पेज पर देख सके।

एडमिन ऑर्डर पेज (Sales > Orders, View) पर Blue Express pickup point पैनल में पॉइंट उसके कोड और क्षेत्र के साथ दिखता है। यदि ऑर्डर में पॉइंट नहीं है, तो पैनल Not chosen दिखाता है। Edit पर क्लिक करें, Choose on the Blue Express map से दूसरा पॉइंट चुनें या Agency code, Name और Address हाथ से दर्ज करें, फिर Save pickup point पर क्लिक करें। ऑर्डर की शिपिंग विधि का टेक्स्ट भी अपडेट होता है, और बदलाव ग्राहक को सूचित किए बिना ऑर्डर इतिहास में जुड़ जाता है (Blue Express pickup point changed: पुराना कोड -> नया कोड)। पॉइंट बदलने के लिए केवल ऑर्डर बदलने की अनुमति चाहिए, एक्सटेंशन सेटिंग्स तक पहुँच नहीं। मौजूदा ऑर्डर अपना पिकअप पॉइंट डेटा रखते हैं।

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

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

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

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

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

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

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

चेकआउट पर Blue Express नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable (या Pickup point option) चालू है। एक्सटेंशन पेज के ऊपर की चेतावनियाँ पढ़ें। Geo zone (या Ignore shipping zones और Countries), वज़न सीमाएँ, Minimum order subtotal जाँचें, और यदि आप निश्चित मूल्य या बैकअप का उपयोग करते हैं तो जाँचें कि Fixed prices में उस देश की पंक्ति है। जाँचें कि उत्पादों में Requires Shipping Yes पर है।

लाइव दरें नहीं दिखतीं: Blue Express API only के साथ दर न होने पर विकल्प छिप जाते हैं। Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: API कुंजी नहीं है, बिना Exchange rate के CLP से अलग स्टोर मुद्रा, पते में क्षेत्र या कम्यून नहीं है, Blue Express कम्यून को नहीं पहचानता, या API त्रुटि (जैसे API कुंजी अस्वीकार होने पर HTTP 401 या 403)। Blue Express API, fixed price if the API gives no rate के साथ, समस्या ठीक करते समय भी ग्राहकों को निश्चित मूल्य मिलता रहता है।

चिली के पते में क्षेत्र नहीं है: पेज पर गायब क्षेत्रों की चेतावनी दिखती है। एक्सटेंशन पेज पर Add Chilean regions पर क्लिक करें। जिन ग्राहकों के पते बिना क्षेत्र के सेव हुए हैं, उन्हें पता संपादित करके क्षेत्र चुनना होगा।

Blue Express मूल्य पर टैक्स जुड़ रहा है: Blue Express मूल्यों में IVA शामिल है। Tax class को None (no tax on shipping) पर सेट करें।

मानचित्र नहीं खुलता: मानचित्र ग्राहक के ब्राउज़र में widget-pudo.blue.cl से लोड होता है, इसलिए यह पता पहुँच योग्य होना चाहिए और आपकी साइट पर अवरुद्ध नहीं होना चाहिए।

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

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

डेवलपर्स के लिए: Blue Express API और मानचित्र के पते सेटिंग्स vfd_blex_api_url और vfd_blex_widget_url (परीक्षण के लिए) से बदले जा सकते हैं; सेटिंग्स पेज पर इनके फ़ील्ड नहीं हैं।

अनइंस्टॉल

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

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

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