VibeFox Chilexpress for OpenCart — सहायता

आवश्यकताएँ

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

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

Chilexpress API कुंजियाँ (केवल लाइव दरों के लिए): Chilexpress डेवलपर पोर्टल (developers.wschilexpress.com) पर एक खाता बनाएँ और दो उत्पादों की सदस्यता लें: Rating (Cotizador) और Coverage (Coberturas / Georreferencia)। हर उत्पाद की अपनी सब्सक्रिप्शन कुंजी होती है। टेस्ट कुंजियाँ केवल टेस्ट वातावरण में काम करती हैं; प्रोडक्शन कुंजियाँ अनुबंध वाले Chilexpress व्यावसायिक ग्राहकों को दी जाती हैं। आपको उस comuna का Chilexpress county कोड भी चाहिए जहाँ से आप भेजते हैं, जैसे STGO। यदि आप केवल निश्चित मूल्य का उपयोग करते हैं, तो API कुंजियों की ज़रूरत नहीं है।

चिली के क्षेत्र (केवल लाइव दरों के लिए): लाइव दरों के लिए डिलीवरी पते का क्षेत्र (ज़ोन) चाहिए। OpenCart 3.0.5.0 में चिली के 16 में से 15 क्षेत्र हैं; एक्सटेंशन गायब क्षेत्रों को जोड़ सकता है (नीचे Chilean regions देखें)। स्टोर में Chile देश मौजूद होना चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. Country prices तालिका भरें। लाइव दरों के लिए दोनों सब्सक्रिप्शन कुंजियाँ, भेजने के स्थान का county कोड और, यदि स्टोर की मुद्रा CLP नहीं है, तो CLP विनिमय दर दर्ज करें; यदि पेज गायब क्षेत्र दिखाए तो Add Chilean regions पर क्लिक करें, फिर दर स्रोत चुनें (कॉन्फ़िगरेशन देखें)। Enable/Disable चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Chilexpress > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। सेव करने के बाद आपको Settings saved. Cached Chilexpress rates and comuna lists were cleared. दिखेगा। केवल वे एडमिन उपयोगकर्ता, जिनके पास इस एक्सटेंशन के लिए संशोधन की अनुमति है, सेटिंग्स सेव कर सकते हैं, लॉग साफ़ कर सकते हैं या क्षेत्र जोड़ सकते हैं।

पेज के ऊपर समस्याएँ दिखती हैं: API दरें चुनी हैं लेकिन Rating API कुंजी खाली है; Coverage API कुंजी खाली है; भेजने के स्थान का county कोड खाली या गलत है; स्टोर की मुद्रा CLP नहीं है और CLP विनिमय दर सेट नहीं है; Country prices में चिली या डिफ़ॉल्ट के लिए कोई पंक्ति नहीं है; स्टोर में चिली का कोई ज़ोन नहीं है; स्टोर की वज़न या लंबाई की इकाई एक्सटेंशन को ज्ञात नहीं है (तब वज़न kg और आयाम cm माने जाते हैं; System > Localisation में kg, g, lb या oz और cm, mm, m या in उपयोग करें)। संख्याएँ बिंदु या अल्पविराम से लिखी जा सकती हैं। यदि Name खाली है, उसमें < > ; = # { } में से कोई अक्षर है या वह 64 अक्षरों से लंबा है, कोई संख्या गलत या ऋणात्मक है, CLP exchange rate 0 है, Min weight (kg), Max weight (kg) से बड़ा है, Origin county code county कोड नहीं है, या Sort order पूर्ण संख्या नहीं है, तो कुछ भी सेव नहीं होता और पेज त्रुटियाँ सूचीबद्ध करता है।

सामान्य

हर जियो ज़ोन के लिए एक शिपिंग विधि "Chilexpress", या Availability के अंतर्गत चुने गए जियो ज़ोन के लिए।

Enable/Disable: चेकआउट पर Chilexpress दिखाता या छिपाता है। डिफ़ॉल्ट: बंद।

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

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

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

दरें

Rate source: मूल्य कहाँ से आता है।

लाइव दरें केवल चिली के गंतव्यों के लिए उपलब्ध हैं। अन्य देश हमेशा निश्चित मूल्य उपयोग करते हैं।

Country prices: गंतव्य देशों की सूची, जिसमें Price कॉलम और पार्सल आकार के अनुसार वैकल्पिक मूल्य होते हैं, स्टोर की डिफ़ॉल्ट मुद्रा में, कर को छोड़कर। आकार कार्ट के वज़न से तय होता है: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक, XL 5 kg से अधिक। किसी आकार का मान 0 रहने पर Price उपयोग होता है। पंक्ति जोड़ने के लिए Add country पर क्लिक करें। * Default (other countries) पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। जिस देश की पंक्ति नहीं है (और डिफ़ॉल्ट पंक्ति भी नहीं है), उसके लिए कोई निश्चित मूल्य नहीं है, इसलिए वहाँ यह विधि छिपी रहती है। सेव की गई ऐसी पंक्ति जिसका मूल्य और आकार-मूल्य सब 0 हों, मुफ़्त शिपिंग देती है। खाली तालिका में चिली के लिए 0 वाली एक पंक्ति दिखती है, इसलिए पेज सेव करने से पहले असली मूल्य दर्ज करें। दोहराया गया देश या गलत मूल्य अपने-आप ठीक हो जाता है (दोहराव अनदेखा होता है, मूल्य 0 कर दिया जाता है), और एक चेतावनी सुधारों की सूची दिखाती है।

Calculation type: Per order (डिफ़ॉल्ट) निश्चित मूल्य एक बार लेता है। Per item (fixed price x number of items) उसे कार्ट में आइटमों की संख्या से गुणा करता है। Chilexpress API दर हमेशा पूरे पार्सल के लिए दी जाती है।

Chilexpress API (लाइव दरें)

यह सेक्शन डेवलपर पोर्टल और Rating तथा Coverage सब्सक्रिप्शन पेजों के लिंक से शुरू होता है।

Test environment: Chilexpress के टेस्ट वातावरण (qaservices.wschilexpress.com) का उपयोग करता है। इसे टेस्ट कुंजियों के साथ इस्तेमाल करें और लाइव स्टोर पर बंद रखें। डिफ़ॉल्ट: बंद।

Rating API key: Rating (Cotizador) उत्पाद की सब्सक्रिप्शन कुंजी।

Coverage API key: Coverage (Coberturas / Georreferencia) उत्पाद की सब्सक्रिप्शन कुंजी। इसका उपयोग ग्राहक की comuna का Chilexpress county कोड खोजने के लिए होता है (पते का City फ़ील्ड, उसके क्षेत्र के साथ)।

सेव करने के बाद कुंजी का फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। कुंजी वैसे ही सेव होती है जैसी आपने लिखी; केवल उसके आसपास के खाली स्थान हटते हैं।

Remove the saved Rating API key और Remove the saved Coverage API key: इनमें से किसी एक को चालू करें और उस कुंजी को हटाने के लिए Save पर क्लिक करें।

Origin county code: वह Chilexpress county कोड जिस comuna से आप भेजते हैं, 2 से 5 अक्षर, जैसे STGO (Santiago Centro), PROV (Providencia) या VALP (Valparaíso)। इंस्टॉल के बाद यह खाली होता है। county कोड न होने वाला मान त्रुटि के साथ अस्वीकार होता है।

Service: दर के लिए उपयोग की गई Chilexpress सेवा। यदि वह गंतव्य के लिए उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा उपयोग होती है।

CLP exchange rate: Chilexpress चिली पेसो में कोटेशन देता है। यह तभी ज़रूरी है जब आपके स्टोर की डिफ़ॉल्ट मुद्रा CLP न हो: उस मुद्रा में 1 CLP का मूल्य, जैसे 0.001। इसके बिना API दरें उपयोग नहीं होतीं। यदि स्टोर की मुद्रा CLP है, तो इसे खाली छोड़ें। मान 0 से अधिक होना चाहिए।

Chilean regions: चिली की comuna क्षेत्र के अनुसार खोजी जाती हैं, इसलिए लाइव दरों के लिए पते का क्षेत्र (ज़ोन) चाहिए। इस फ़ील्ड में दिखता है कि चिली के कितने ज़ोन हैं और कौन-से क्षेत्र गायब हैं, साथ में Add Chilean regions बटन। यह केवल गायब क्षेत्र चिली के ज़ोन के रूप में जोड़ता है; मौजूदा ज़ोन नहीं बदले जाते और एक क्षेत्र दो बार नहीं जोड़ा जाता। जब सभी 16 क्षेत्र मौजूद हों, तो फ़ील्ड में All 16 Chilean regions are zones of Chile दिखता है। यदि चिली स्टोर का देश नहीं है, तो फ़ील्ड यह बताता है: इसे System > Localisation > Countries में जोड़ें।

उपलब्धता

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

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

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

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

Ignore shipping zones: नीचे दिए देशों के लिए, जियो ज़ोन की जाँच किए बिना विधि दें।

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

निःशुल्क शिपिंग

Free shipping: निःशुल्क शिपिंग की सीमा चालू करता है।

Free shipping from: कार्ट का उप-योग (शिपिंग वाले उत्पाद, कूपन के बाद, कर को छोड़कर) जिससे शिपिंग निःशुल्क हो जाती है। यह केवल तब उपयोग होता है जब Free shipping चालू हो। उस स्थिति में API अनुरोध नहीं भेजा जाता।

उन्नत

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

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

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

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

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

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

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

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

चिली के पते और API दर स्रोत के लिए, एक्सटेंशन पते का क्षेत्र (ज़ोन) और City फ़ील्ड से comuna लेता है और उस क्षेत्र की comuna सूची में Chilexpress county कोड खोजता है (Coverage API)। उच्चारण चिह्न, स्थान और वर्तनी के रूप अनदेखे किए जाते हैं, इसलिए Ñuñoa और Nunoa मेल खाते हैं, और Santiago, Santiago Centro से मेल खाता है। City फ़ील्ड में लिखा county कोड भी स्वीकार होता है। इसके बाद एक्सटेंशन Rating API को भेजने और लेने वाले स्थान के county कोड, कार्ट का वज़न (कम से कम 0.1 kg), पार्सल के आयाम (सबसे बड़े उत्पाद की लंबाई और चौड़ाई, ऊँचाइयाँ एक पर एक रखी हुई) और CLP में कार्ट का उप-योग घोषित मूल्य के रूप में भेजता है। Chilexpress अपनी सेवाएँ लौटाता है; एक्सटेंशन चुनी हुई या सबसे सस्ती सेवा लेता है और पेसो राशि को स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है। मूल्य उस मुद्रा के दशमलव स्थानों तक गोल किया जाता है, फिर चुने हुए Tax class के कर के साथ ग्राहक की मुद्रा में दिखाया जाता है।

दरें 1 घंटे तक कैश होती हैं। comuna सूचियाँ 7 दिन तक कैश हो सकती हैं, लेकिन OpenCart के कैश में प्रविष्टियाँ रखने की अवधि (डिफ़ॉल्ट 1 घंटा) से अधिक नहीं। विफल अनुरोध 5 मिनट तक याद रखा जाता है, ताकि धीमा या अनुपलब्ध API हर चेकआउट रीफ़्रेश को धीमा न करे। API का टाइमआउट 10 सेकंड है। यदि Chilexpress त्रुटि लौटाए, मूल्य वाली कोई सेवा न मिले, या comuna या क्षेत्र अज्ञात हों, तो ग्राहक को कोई त्रुटि नहीं दिखती। केवल-API मोड में विधि छिप जाती है, या निश्चित मूल्य उपयोग होता है। कारण डीबग लॉग में लिखा जाता है।

एक्सटेंशन केवल दरों की गणना करता है। यह शिपमेंट या परिवहन ऑर्डर (OT) नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता और पार्सल ट्रैक नहीं करता; शिपमेंट अपने Chilexpress खाते में बुक करें। ग्राहक Chilexpress ऑफ़िस नहीं चुन सकते, और comuna चयनकर्ता नहीं है: ग्राहक comuna को मानक City फ़ील्ड में लिखता है। अंतरराष्ट्रीय शिपमेंट निश्चित मूल्य उपयोग करते हैं।

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Chilexpress चुनता है, उदाहरण के लिए Chilexpress - $5.49। यह विधि OpenCart 3 जैसी ही काम करती है।

ऑर्डर

जब Chilexpress से ऑर्डर दिया जाता है, तो एक्सटेंशन सहेजता है कि उसका मूल्य कैसे निकाला गया। Sales > Orders में ऑर्डर पेज पर Chilexpress पैनल दिखता है, जिसमें Chilexpress service (लाइव दर के लिए Chilexpress द्वारा दी गई सेवा, जैसे Express; अन्यथा एक डैश) और Price दिखते हैं: Live rate (Chilexpress Rating API), Fixed price या Free shipping। यह पैनल तब भी दिखता है जब विधि बंद हो। OpenCart 4 पर Chilexpress पैनल History के ऊपर दिखता है, और जब कोई ऑर्डर चेकआउट पर फिर से पुष्टि होता है या किसी दूसरी शिपिंग विधि में बदला जाता है, तब पैनल बदलाव के साथ चलता है।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Chilexpress, Extensions > Extensions > Shipping > VibeFox Chilexpress > Edit पेज का पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी छिपी हुई (मास्क) दिखती है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) दिखती है, और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-shipping-chilexpress वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

Chilexpress चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Geo zone (या Ignore shipping zones और Countries), वज़न की सीमाएँ और Minimum subtotal जाँचें। निश्चित मूल्यों के साथ, जाँचें कि देश या * Default (other countries) की पंक्ति मौजूद है। जाँचें कि उत्पादों में Requires Shipping Yes पर है।

चिली में शिपिंग निःशुल्क है, जबकि ऐसा नहीं होना चाहिए: चिली के लिए Country prices की पंक्ति (या डिफ़ॉल्ट पंक्ति) में Price और आकार के कॉलम में 0 है। मूल्य दर्ज करें और Save पर क्लिक करें।

लाइव दर नहीं दिख रही, उसकी जगह निश्चित मूल्य उपयोग हो रहा है: पहले एक्सटेंशन पेज के ऊपर की चेतावनियाँ देखें। यदि कुछ न हो, तो Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: पते में क्षेत्र नहीं है या चिली के क्षेत्र गायब हैं (Add Chilean regions का उपयोग करें), कोई comuna जिसे Chilexpress नहीं पहचानता (City फ़ील्ड और क्षेत्र जाँचें), गलत उत्पाद या वातावरण की कुंजी, या ऐसा गंतव्य जहाँ Chilexpress की सेवा नहीं है।

लॉग में HTTP 401 या 403: सब्सक्रिप्शन कुंजी गलत है, निष्क्रिय है, या किसी दूसरे उत्पाद या वातावरण की है। टेस्ट कुंजियाँ केवल Test environment चालू होने पर काम करती हैं।

किसी दूसरी मुद्रा वाले स्टोर में API दरें उपयोग नहीं होतीं: CLP exchange rate दर्ज करें।

क्या API दरों में IVA शामिल है? वे बिल्कुल वैसे ही उपयोग होती हैं जैसे Chilexpress उन्हें कोट करता है। यदि आपका स्टोर शिपिंग पर कर जोड़ता है और कोटेशन में पहले से IVA शामिल है, तो Tax class को No tax पर सेट करें।

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

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

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

अनइंस्टॉल

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

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

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