VibeFox Canada Post for OpenCart — सहायता

आवश्यकताएँ

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

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

Canada Post Developer Program (केवल लाइव दरों के लिए): लाइव दरें Canada Post Rating API का उपयोग करती हैं। Canada Post की वेबसाइट पर Canada Post Developer Program में शामिल हों और अपनी API कुंजी व ग्राहक नंबर कॉपी करें। API कुंजी का रूप username:password होता है, और Canada Post विकास (सैंडबॉक्स) और उत्पादन वातावरण के लिए अलग-अलग कुंजियाँ देता है। आपको उस कनाडाई पोस्टल कोड की भी ज़रूरत है जहाँ से आप भेजते हैं। यदि आप केवल तय कीमतें इस्तेमाल करते हैं, तो API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. लाइव दरों के लिए API का उपयोगकर्ता नाम और पासवर्ड, अपना ग्राहक नंबर और भेजने वाला पोस्टल कोड दर्ज करें। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा CAD नहीं है, तो CAD दर दर्ज करें। यदि आपको तय कीमतें या बैकअप कीमत चाहिए, तो Country prices भरें (कॉन्फ़िगरेशन देखें)। Enable Canada Post चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

जब कोई मान गलत होता है, तो पेज एक त्रुटि दिखाता है और कुछ भी सेव नहीं होता: कोई संख्या फ़ील्ड या Country prices में कोई कीमत जो 0 या उससे बड़ी संख्या नहीं है (जैसे -1 या 12abc), CAD दर 0 हो, Min cart weight (kg) Max cart weight (kg) से बड़ा हो, Method title 64 अक्षरों से लंबा हो या उसमें अक्षर < > ; = # { } हों, Sort order पूर्ण संख्या न हो, या कोई अज्ञात टैक्स क्लास या जियो ज़ोन हो। यदि स्टोर में इकाई "kg" वाली वज़न श्रेणी या इकाई "cm" वाली लंबाई श्रेणी नहीं है, तो पेज चेतावनी देता है कि वज़न और आयाम उनकी श्रेणी के इकाई-नाम (kg, g, lb, oz; cm, mm, m, in) के अनुसार बदले जाएँगे, और अन्य इकाइयों को kg या cm माना जाएगा।

सेव करने के बाद, यदि सेटिंग्स इच्छित रूप से काम नहीं कर सकतीं, तो पेज चेतावनी दिखाता है: API उपयोगकर्ता नाम और पासवर्ड में से केवल एक भरा है, भेजने वाला पोस्टल कोड कनाडाई पोस्टल कोड नहीं है (प्रारूप A1A 1A1), किसी अन्य मुद्रा वाले स्टोर के लिए CAD दर नहीं है, या न API क्रेडेंशियल हैं न तय कीमतें। चेतावनी यह भी बताती है कि इस बीच क्या होता है: देश-वार तय कीमतें इस्तेमाल होती हैं, या Country prices तालिका खाली होने पर चेकआउट पर यह विधि छिपा दी जाती है।

सामान्य

ये सेटिंग्स हर जियो ज़ोन पर लागू होती हैं। कीमत हमेशा इसी एक्सटेंशन से आती है: Canada Post की लाइव दर या देश-वार तय कीमतें।

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

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

Tax class: वह टैक्स क्लास जो OpenCart शिपिंग लागत में जोड़ता है, या No tax (कर-मुक्त)।

Sort order: चेकआउट पर शिपिंग विधियों के बीच Canada Post का क्रम।

Canada Post API (लाइव दरें)

API उपयोगकर्ता नाम और पासवर्ड भरे होने पर कीमत Canada Post Rating API से आती है। यदि API कोई दर नहीं देता (API बंद है, गलत पोस्टल कोड, सेवा उपलब्ध नहीं), तो Country prices की तय कीमत इस्तेमाल होती है, या यदि कोई नहीं है तो विधि छिपा दी जाती है। यह सेक्शन Canada Post Developer Program का लिंक देता है, जहाँ आपको API कुंजियाँ और अपना ग्राहक नंबर मिलेगा। त्रुटि का विवरण लॉग में जाता है, ग्राहक को कभी नहीं दिखाया जाता।

API username: API कुंजी का कोलन (:) से पहले वाला हिस्सा। विकास कुंजी Sandbox के साथ और लाइव स्टोर पर उत्पादन कुंजी इस्तेमाल करें।

API password: API कुंजी का कोलन (:) के बाद वाला हिस्सा। सेव करने के बाद फ़ील्ड खाली रहता है और दिखाता है A password is saved. Leave empty to keep it; clear the API username and save to remove both. केवल बदलने के लिए नया मान लिखें। पासवर्ड जैसा लिखा गया था वैसा ही सेव होता है और लॉग में कभी नहीं लिखा जाता।

Customer number: ग्राहक नंबर के साथ Canada Post आपके खाते की वाणिज्यिक (छूट वाली) दरें लौटाता है। खुदरा (काउंटर) दरों के लिए खाली छोड़ें। स्पेस हटा दिए जाते हैं।

Contract number: अनुबंध वाले ग्राहकों के लिए वैकल्पिक। यह केवल ग्राहक नंबर के साथ इस्तेमाल होता है।

Sandbox: विकास API कुंजी से परीक्षण के लिए Canada Post के विकास वातावरण का उपयोग करता है। कीमतें परीक्षण डेटा हैं। लाइव स्टोर पर इसे बंद करें। डिफ़ॉल्ट: बंद।

Ship-from postal code: वह कनाडाई पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, जैसे K1A 0B1। लाइव दरों के लिए यह ज़रूरी है।

Service in Canada: कनाडाई पतों के लिए सेवा: उपलब्ध सबसे सस्ती, Regular Parcel (DOM.RP, डिफ़ॉल्ट), Expedited Parcel (DOM.EP), Xpresspost (DOM.XP) या Priority (DOM.PC)।

Service to the USA: उपलब्ध सबसे सस्ती (डिफ़ॉल्ट), Expedited Parcel USA (USA.EP), Tracked Packet USA (USA.TP), Small Packet USA Air (USA.SP.AIR), Xpresspost USA (USA.XP) या Priority Worldwide parcel USA (USA.PW.PARCEL)।

International service: उपलब्ध सबसे सस्ती (डिफ़ॉल्ट), International Parcel Surface (INT.IP.SURF), International Parcel Air (INT.IP.AIR), Tracked Packet International (INT.TP), Small Packet International Surface (INT.SP.SURF), Small Packet International Air (INT.SP.AIR), Xpresspost International (INT.XP) या Priority Worldwide parcel International (INT.PW.PARCEL)।

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

Use Canada Post prices without GST/HST/PST: कनाडाई पतों के लिए Canada Post की कीमत में ये कर शामिल होते हैं। इसे चालू करें जब OpenCart शिपिंग पर खुद कर जोड़ता हो (ऊपर Tax class), ताकि कर दोबारा न लगे।

CAD to … rate: फ़ील्ड का नाम आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखाता है, जैसे CAD to USD rate। Canada Post की कीमतें CAD में हैं। यदि आपकी डिफ़ॉल्ट मुद्रा CAD नहीं है, तो लिखें कि 1 CAD कितनी आपकी मुद्रा के बराबर है, जैसे 0.68। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। यदि आपकी डिफ़ॉल्ट मुद्रा CAD है, तो खाली छोड़ें। दर 0 से बड़ी होनी चाहिए।

Default product weight (kg): हर उस उत्पाद के लिए Canada Post को भेजा जाने वाला वज़न जिसका वज़न नहीं है। डिफ़ॉल्ट: 0.5। उत्पादों के वज़न और आयाम उनकी वज़न और लंबाई श्रेणियों से बदले जाते हैं, और कार्ट को एक पार्सल (30 kg तक) माना जाता है।

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

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

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

शर्तें

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

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

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

Free shipping: नीचे दी गई राशि से मुफ़्त शिपिंग चालू करें।

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

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

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

आमतौर पर यह विधि Conditions में चुने गए जियो ज़ोन में दी जाती है।

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

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

उन्नत

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

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

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

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

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

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

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

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

API क्रेडेंशियल्स के साथ एक्सटेंशन Canada Post को भेजने वाला पोस्टल कोड, गंतव्य, पार्सल का वज़न और, जब हर उत्पाद का आयाम हो, अनुमानित पार्सल आकार भेजता है। कनाडा के लिए गंतव्य पोस्टल कोड है, अमेरिका के लिए ZIP कोड, और अन्य सभी देशों के लिए केवल देश। लाइव दर तभी माँगी जाती है जब कनाडाई या अमेरिकी पते में वैध पोस्टल या ZIP कोड हो। Canada Post पार्सल के लिए सभी सेवाएँ लौटाता है। एक्सटेंशन गंतव्य समूह की चुनी हुई सेवा या सबसे सस्ती सेवा लेता है, यदि Use Canada Post prices without GST/HST/PST चालू है तो कनाडाई बिक्री कर हटाता है, और CAD कीमत को आपकी दर से बदलता है। कीमत आपकी डिफ़ॉल्ट मुद्रा में निकाली जाती है, उसके दशमलव स्थानों तक गोल की जाती है, और ग्राहक को उसकी मुद्रा में, चुने गए Tax class के कर के साथ दिखाई जाती है।

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

यदि API कोई दर नहीं देता, तो तय कीमत इस्तेमाल होती है, या तय कीमत न होने पर विधि छिपा दी जाती है। ग्राहक को API त्रुटि का विवरण कभी नहीं दिखता; वह लॉग में जाता है।

एक्सटेंशन केवल दरें निकालता है। यह शिपमेंट नहीं बनाता, लेबल नहीं छापता, मैनिफ़ेस्ट या रिटर्न नहीं बनाता, और पार्सल ट्रैक नहीं करता। ग्राहक पोस्ट ऑफ़िस या पिकअप पॉइंट नहीं चुन सकते। यह डिलीवरी तारीखों, बीमा या हस्ताक्षर विकल्पों के बिना Canada Post की एक ही दर दिखाता है। कार्ट हमेशा एक पार्सल के रूप में गिना जाता है, और मुद्रा दरें अपने-आप अपडेट नहीं होतीं।

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

ऑर्डर

जब Canada Post से ऑर्डर दिया जाता है, तो एक्सटेंशन सहेजता है कि उसकी कीमत कैसे निकाली गई थी। एडमिन ऑर्डर पेज (Sales > Orders, कोई ऑर्डर खोलें) पर एक Canada Post ब्लॉक दिखता है जिसमें:

Canada Post service: लाइव दर की सेवा का नाम और कोड, जैसे Regular Parcel (DOM.RP)।

Price source: Live rate (Canada Post Rating API), Fixed price या Free shipping।

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

सेवा ऑर्डर ईमेल या ग्राहक के ऑर्डर पेज में नहीं जोड़ी जाती; वे शिपिंग विधि का नाम और शिपिंग लागत दिखाते हैं, जैसे कोई भी दूसरी OpenCart शिपिंग विधि।

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: API उपयोगकर्ता नाम या पासवर्ड गायब, भेजने या गंतव्य का पोस्टल कोड अमान्य, CAD दर गायब, 30 kg से बड़ा पार्सल, या Canada Post का त्रुटि संदेश। इस बीच यदि तय कीमत है, तो ग्राहकों को वही मिलती है।

दर Canada Post की वेबसाइट से अलग है: ग्राहक नंबर के साथ आपको अपने खाते की वाणिज्यिक (छूट वाली) दरें मिलती हैं; उसके बिना खुदरा (काउंटर) दरें। कनाडाई पतों के लिए Canada Post की कीमत में GST/HST/PST शामिल होता है। कीमतें आपकी CAD दर से बदली जाती हैं।

शिपिंग पर कर दोबारा लग रहा है: Use Canada Post prices without GST/HST/PST चालू करें, या Tax class को No tax पर सेट करें।

लाइव स्टोर पर कीमतों का परीक्षण: Sandbox बंद करें और उत्पादन API कुंजी इस्तेमाल करें।

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

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

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

अनइंस्टॉल

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

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

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