VibeFox Purolator for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, cURL एक्सटेंशन के साथ। PHP SOAP एक्सटेंशन आवश्यक नहीं है।

Purolator E-Ship Web Services (केवल लाइव दरों के लिए): Purolator की वेबसाइट पर Purolator E-Ship Resource Centre में E-Ship Web Services के लिए रजिस्टर करें। Purolator डेवलपमेंट और प्रोडक्शन वातावरण के लिए अलग-अलग कुंजियाँ और पासवर्ड देता है। आपको अपना Purolator बिलिंग खाता नंबर और वह कनाडाई पोस्टल कोड भी चाहिए जहाँ से आप भेजते हैं। यदि आप केवल तय कीमतें उपयोग करते हैं, तो API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. लाइव दरों के लिए Purolator API (live rates) सेक्शन भरें: API कुंजी, पासवर्ड, बिलिंग खाता नंबर, कनाडा का शिप-फ़्रॉम पोस्टल कोड और, यदि आपके स्टोर की मुद्रा CAD नहीं है, तो CAD दर। परीक्षण के लिए, डेवलपमेंट कुंजी के साथ Development environment चालू करें। यदि आप तय कीमतें या बैकअप चाहते हैं, तो Country prices या Fallback price भरें (कॉन्फ़िगरेशन देखें)। Enable Purolator चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

अगर सेव की गई वैल्यू के साथ लाइव दरें काम नहीं कर सकतीं (कुंजी, पासवर्ड या बिलिंग खाता गायब, कनाडा का शिप-फ़्रॉम पोस्टल कोड नहीं, CAD दर नहीं), या न API क्रेडेंशियल हैं न तय कीमतें, तो General सेक्शन में चेतावनी दिखती है। यह भी बताया जाता है कि तब तक तय कीमतें इस्तेमाल होंगी या विधि छिपी रहेगी। अगर स्टोर की वज़न इकाई एक्सटेंशन के लिए अज्ञात है, तो भी चेतावनी दिखती है। तब उत्पादों के वज़न kg के रूप में पढ़े जाते हैं; System > Localisation > Weight Classes में इकाई kg वाला वज़न वर्ग जोड़ें।

जो संख्या फ़ील्ड 0 या उससे बड़ी संख्या नहीं है, वह सेव नहीं होता। Save के बाद एक संदेश फ़ील्ड और मान बताता है। फ़ील्ड खाली रहता है, या वज़न फ़ील्ड में अपना डिफ़ॉल्ट मान पाता है। Country prices में गलत मान 0 के रूप में सेव होता है, और संदेश देश और कॉलम बताता है। अगर विधि का शीर्षक खाली है या 64 अक्षरों से लंबा है, Min cart weight (kg) Max cart weight (kg) से बड़ा है, सॉर्ट ऑर्डर पूर्ण संख्या नहीं है, या टैक्स क्लास या जियो ज़ोन अमान्य है, तो कुछ भी सेव नहीं होता और एक त्रुटि दिखती है।

सामान्य

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

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

Method title: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Purolator। ज़रूरी, अधिकतम 64 अक्षर।

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। यह तय करता है कि स्टोर कीमत के ऊपर टैक्स जोड़े या नहीं। कनाडा के पतों के लिए Purolator का कुल पहले से GST/HST/PST/QST शामिल करता है। नीचे Canadian sales taxes देखें।

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

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

जब API कुंजी, पासवर्ड और बिलिंग खाता भरे हों, तो कीमत Purolator E-Ship Estimating वेब सर्विस (Quick Estimate, कुल कार्ट वज़न के अनुसार) से आती है। अगर Purolator कोई दर नहीं देता, तो तय कीमत इस्तेमाल होती है, या अगर वह भी नहीं है तो विधि छिप जाती है। इस सेक्शन में Purolator E-Ship Resource Centre का लिंक है, जहाँ आप रजिस्टर करके कुंजियाँ पाते हैं। त्रुटि का विवरण लॉग में जाता है, ग्राहक को कभी नहीं दिखाया जाता।

API key: चुने गए वातावरण के लिए आपकी E-Ship Web Services कुंजी। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

API password: कुंजी का पासवर्ड। कुंजी की तरह, सेव करने के बाद यह फिर से नहीं दिखता।

Billing account number: आपका Purolator खाता नंबर। अनुमान इस खाते की दरों का उपयोग करते हैं। डेवलपमेंट वातावरण Purolator दस्तावेज़ों में दिए गए परीक्षण खाते को स्वीकार करता है। इस फ़ील्ड को खाली करने से सेव की गई API कुंजी और पासवर्ड भी हट जाते हैं।

Development environment: डेवलपमेंट कुंजी के साथ Purolator का डेवलपमेंट वातावरण (devwebservices) इस्तेमाल करता है। कीमतें परीक्षण डेटा हैं। लाइव स्टोर पर इसे बंद रखें।

Ship-from postal code: वह कनाडाई पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, जैसे L4W 5M8। OpenCart में स्टोर का पोस्टल कोड नहीं होता, इसलिए यह स्टोर के पते से नहीं लिया जाता: इसे यहाँ दर्ज करें।

Service in Canada: Cheapest available (डिफ़ॉल्ट), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM या Purolator Express Evening।

Service to the USA: Cheapest available (डिफ़ॉल्ट), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM या Purolator Express U.S. 12:00।

International service: Cheapest available (डिफ़ॉल्ट), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM या Purolator Express International 12:00।

अगर चुनी गई सेवा उस पते के लिए उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा इस्तेमाल होती है।

Canadian sales taxes: GST/HST/PST/QST के बिना Purolator कीमतें इस्तेमाल करता है। कनाडा के पतों के लिए Purolator का कुल इन करों को शामिल करता है। इसे तब चालू करें जब स्टोर शिपिंग पर खुद टैक्स जोड़ता हो (General में टैक्स क्लास), ताकि टैक्स दो बार न लगे। डिफ़ॉल्ट: बंद।

CAD → (store currency) rate: Purolator की कीमतें CAD में हैं। अगर आपके स्टोर की डिफ़ॉल्ट मुद्रा CAD नहीं है, तो बताएँ कि एक CAD कितनी आपकी मुद्रा के बराबर है, जैसे 0.68। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। अगर आपकी डिफ़ॉल्ट मुद्रा CAD है, तो इसे खाली छोड़ें।

Default product weight (kg): हर उस उत्पाद के लिए इस्तेमाल होता है जिसका वज़न नहीं है। डिफ़ॉल्ट: 0.5। वज़न उत्पाद के वज़न वर्ग से बदले जाते हैं और Purolator को पाउंड में पूर्ण संख्या के रूप में, ऊपर की ओर पूर्णांकित कुल वज़न के रूप में भेजे जाते हैं।

तय कीमतें (API क्रेडेंशियल के बिना उपयोग होती हैं, और जब API कोई दर नहीं देता तब बैकअप के रूप में)

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

Fallback price: उस देश की कीमत जिसकी Country prices में कोई पंक्ति नहीं है और * पंक्ति भी नहीं है। ऐसे देशों में विधि छिपाने के लिए इसे खाली छोड़ें।

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

शर्तें

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

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

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

Free shipping from: शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, टैक्स से पहले) जिससे डिलीवरी मुफ़्त है। तब Purolator को कोई अनुरोध नहीं भेजा जाता। कभी भी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।

उपलब्धता

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

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

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

उन्नत

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

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

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

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

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

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

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

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

API क्रेडेंशियल होने पर एक्सटेंशन Purolator को Quick Estimate अनुरोध भेजता है: आपका बिलिंग खाता, शिप-फ़्रॉम पोस्टल कोड, ग्राहक का शहर, प्रांत या राज्य, देश और पोस्टल कोड, और पाउंड में पूर्ण संख्या के रूप में कुल कार्ट वज़न। कनाडा के लिए मान्य पोस्टल कोड चाहिए, USA के लिए मान्य ZIP कोड; अन्य देश उसी पोस्टल कोड के साथ भेजे जाते हैं जैसा दर्ज किया गया है। आयाम (डायमेंशनल वज़न) नहीं भेजे जाते। ग्राहक जब स्टोर फ़्रेंच में देखता है तो Purolator फ़्रेंच में, अन्यथा अंग्रेज़ी में जवाब देता है। Purolator सभी सेवाओं की कीमतें लौटाता है; एक्सटेंशन आपकी चुनी हुई या सबसे सस्ती सेवा लेता है, सेट होने पर कनाडा के बिक्री कर हटाता है, और CAD से कीमत बदलता है। कीमत आपकी डिफ़ॉल्ट मुद्रा में गिनी जाती है, उसके दशमलव के अनुसार पूर्णांकित होती है, और ग्राहक को उसकी मुद्रा में, चुने गए Tax class के टैक्स के साथ दिखाई जाती है।

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

अगर Purolator कोई दर नहीं देता (API बंद, गलत क्रेडेंशियल या पोस्टल कोड, सेवा उपलब्ध नहीं, CAD दर नहीं), तो ग्राहक को कोई त्रुटि नहीं दिखती। तय कीमत इस्तेमाल होती है, या तय कीमत न होने पर विधि छिपती है। कारण लॉग में लिखा जाता है।

एक्सटेंशन केवल दरें गिनता है। यह Purolator शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, रिटर्न नहीं संभालता और पार्सल ट्रैक नहीं करता। यह Full Estimate (आयाम, कई पीस, हस्ताक्षर या खतरनाक सामान जैसे विकल्प) का उपयोग नहीं करता, डिलीवरी की तारीखें नहीं दिखाता, कई सेवाओं को अलग विकल्पों के रूप में नहीं दिखाता और विनिमय दरें अपने-आप नहीं लाता। ग्राहक को Purolator सेवा का नाम नहीं दिखता, केवल आपकी विधि का शीर्षक दिखता है।

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

ऑर्डर

जब कोई ऑर्डर Purolator की लाइव दर पर दिया जाता है, तो सेवा ऑर्डर के साथ सेव होती है। Sales > Orders में ऑर्डर पेज इतिहास के ऊपर Purolator पैनल दिखाता है, जिसमें Purolator service (नाम और कोड) और Live rate (excl. tax) होते हैं। विधि बाद में बंद कर दी जाए तब भी पैनल दिखता रहता है। तय कीमतों या मुफ़्त शिपिंग पर बने ऑर्डरों में ऐसा पैनल नहीं होता। ऑर्डर खुद शिपिंग विधि का शीर्षक और शिपिंग लागत वैसे ही दिखाता है जैसे कोई और OpenCart शिपिंग विधि।

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

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

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

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

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

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

चेकआउट पर Purolator दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Purolator चालू है। Geo zone जाँचें (या यह कि Ignore shipping zones चालू है और देश अनुमत है), वज़न सीमाएँ और Minimum order amount। अगर Purolator कोई दर नहीं देता, तो विधि केवल देश की कीमत, * पंक्ति या Fallback price होने पर दिखती है। जाँचें कि उत्पादों पर Requires Shipping Yes पर सेट है।

लाइव दरें नहीं दिखतीं: एक्सटेंशन पेज पर Log फ़ील्ड देखें। API त्रुटियाँ हमेशा वहाँ होती हैं। विवरण के लिए Debug log चालू करें और चेकआउट रीलोड करें। API कुंजियों के साथ पते में मान्य पोस्टल कोड (कनाडा) या मान्य ZIP कोड (USA) होना चाहिए। General सेक्शन की चेतावनियाँ भी देखें।

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

दर Purolator की वेबसाइट से अलग है: Quick Estimate आपके बिलिंग खाते की दरें और पाउंड में ऊपर पूर्णांकित कुल वज़न इस्तेमाल करता है, डायमेंशनल वज़न के बिना। कनाडा के पतों के लिए कुल में बिक्री कर शामिल होते हैं; अगर आपने Tax class सेट की है तो Canadian sales taxes इस्तेमाल करें। कीमतें आपके CAD → (store currency) rate से बदली जाती हैं।

सेव के बाद एक मान गायब हो गया: Save के बाद दिखा संदेश पढ़ें। मान 0 या उससे बड़ी संख्या नहीं था, इसलिए सेव नहीं हुआ। उसे साधारण संख्या के रूप में फिर से दर्ज करें।

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

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

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

अनइंस्टॉल

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

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

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