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

आवश्यकताएँ

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

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

NZ Post API एक्सेस (केवल लाइव दरों के लिए): लाइव दरें NZ Post ShippingOptions API का उपयोग करती हैं। NZ Post की वेबसाइट पर Developer Resource Centre में API एक्सेस का अनुरोध करें। NZ Post पहले टेस्टिंग वातावरण (UAT) के लिए Client ID और Client Secret देता है, और फिर अपनी go-live चेकलिस्ट के बाद प्रोडक्शन के लिए। न्यूज़ीलैंड के भीतर की दरों के लिए आपको NZ Post बिज़नेस अकाउंट भी चाहिए: अकाउंट नंबर और उसका auth code (या site code)। यदि आप केवल तय कीमतें उपयोग करते हैं, तो API एक्सेस की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

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

OpenCart 4

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

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

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

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

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

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

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

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

सामान्य

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

Enable NZ Post: चेकआउट पर विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।

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

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट; शिपिंग लागत पर टैक्स नहीं लगता)। यदि स्टोर शिपिंग पर GST जोड़ता है, तो GST दोबारा न लगे इसलिए नीचे API prices को Excluding GST पर सेट करें।

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

NZ Post API (लाइव दरें) (केवल तय कीमतें उपयोग करने के लिए Client ID खाली छोड़ें)

Environment: Production (api.nzpost.co.nz) (डिफ़ॉल्ट) या Testing / UAT (api.uat.nzpost.co.nz)। वही वातावरण चुनें जिसके लिए आपका Client ID जारी हुआ है।

Client ID: आपके NZ Post API आवेदन का OAuth2 क्लाइंट ID। इसे साफ़ करने पर सहेजा गया Client Secret भी साफ़ हो जाता है।

Client Secret: OAuth2 क्लाइंट सीक्रेट। इसे एक एक्सेस टोकन से बदला जाता है, जो समाप्त होने तक कैश रहता है। सहेजने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। इसे बदलने के लिए ही नया मान दर्ज करें।

Account number: आपका NZ Post बिज़नेस (बिलिंग) अकाउंट नंबर। न्यूज़ीलैंड के भीतर की दरों के लिए यह अनिवार्य है। अंतरराष्ट्रीय दरों के लिए यह वैकल्पिक है; इसके साथ NZ Post आपकी अनुबंध दरें लौटाता है। इसे साफ़ करने पर सहेजा गया auth code भी साफ़ हो जाता है।

Auth code: घरेलू दरों के लिए अकाउंट का auth code। यदि आप site code दर्ज करते हैं तो इसकी ज़रूरत नहीं है। Client Secret की तरह, सहेजने के बाद यह फिर से नहीं दिखता।

Site code: auth code का विकल्प: आपका NZ Post पिकअप साइट कोड।

Ship-from suburb: उस पते का उपनगर जहाँ से पार्सल भेजे जाते हैं, जैसे Petone। घरेलू दरों के लिए आवश्यक।

Ship-from city: वह कस्बा या शहर जहाँ से पार्सल भेजे जाते हैं, जैसे Lower Hutt। घरेलू दरों के लिए आवश्यक।

Ship-from postcode: वह 4 अंकों का न्यूज़ीलैंड पिनकोड जहाँ से पार्सल भेजे जाते हैं, जैसे 5012। घरेलू दरों के लिए आवश्यक।

Services: अल्पविराम से अलग किए गए वैकल्पिक NZ Post सेवा कोड, जैसे CPOLP, ICOU। केवल ये सेवाएँ मूल्यांकित होती हैं। खाली छोड़ने पर पार्सल के लिए NZ Post द्वारा लौटाई गई सबसे सस्ती सेवा उपयोग होती है।

API prices: Including GST (डिफ़ॉल्ट) या Excluding GST। NZ Post की घरेलू कीमतों में 15% GST शामिल है; अंतरराष्ट्रीय डाक शून्य-दर पर है। जब विधि में टैक्स क्लास (General) हो, तब GST दोबारा न लगे इसलिए Excluding GST चुनें।

NZD → (स्टोर मुद्रा) दर: NZ Post की कीमतें NZD में हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा NZD नहीं है, तो दर्ज करें कि 1 NZD आपकी मुद्रा में कितना है, जैसे 0.55। इसके बिना लाइव दरें उपयोग नहीं होतीं। वही दर अंतरराष्ट्रीय अनुरोधों में भेजे गए ऑर्डर मूल्य को भी बदलती है। दर 0 से अधिक होनी चाहिए। यदि आपके स्टोर की मुद्रा NZD है, तो इसे खाली छोड़ें।

लाइव दरों के लिए पार्सल

कार्ट NZ Post को एक पार्सल के रूप में भेजा जाता है। उत्पादों के वज़न और आयाम उनकी वज़न और लंबाई क्लास से kg और cm में बदले जाते हैं (अंतरराष्ट्रीय अनुरोधों में mm)। पार्सल उत्पादों की सबसे बड़ी लंबाई और चौड़ाई लेता है, और उसकी ऊँचाई तब तक बढ़ती है जब तक सभी आइटमों की मात्रा उसमें समा न जाए। नीचे के मान उन उत्पादों के लिए उपयोग होते हैं जिनमें वज़न या आयाम नहीं हैं।

Default product weight (kg): हर उस उत्पाद के लिए उपयोग होता है जिसका वज़न नहीं है। डिफ़ॉल्ट: 0.5।

Default parcel length (cm): तब उपयोग होता है जब कार्ट में किसी उत्पाद का आयाम न हो। डिफ़ॉल्ट: 30।

Default parcel width (cm): तब उपयोग होता है जब कार्ट में किसी उत्पाद का आयाम न हो। डिफ़ॉल्ट: 20।

Default parcel height (cm): तब उपयोग होता है जब कार्ट में किसी उत्पाद का आयाम न हो। डिफ़ॉल्ट: 10।

तय कीमतें (तब उपयोग होती हैं जब लाइव दरें सेट न हों या NZ Post कोई दर न दे)

कीमतें स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स छोड़कर, होती हैं।

Country prices: गंतव्य देश के हिसाब से एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर और हटाने के लिए × बटन पर क्लिक करें। बाकी सभी देशों को कवर करने वाली पंक्ति के लिए * Default चुनें। हर पंक्ति में एक Any weight कीमत और वैकल्पिक वज़न कॉलम हैं: ≤ 1 kg, 1–2 kg, 2–3 kg, 3–5 kg और > 5 kg (कार्ट का वज़न)। भरा हुआ वज़न कॉलम Any weight की जगह लेता है; खाली या 0 वाला कॉलम Any weight उपयोग करता है। Any weight कीमत 0 का अर्थ है उस देश के लिए मुफ़्त शिपिंग। "9.99" और "9,99" दोनों स्वीकार होते हैं। बिना किसी कीमत वाली पंक्तियाँ और ऋणात्मक कीमतें सहेजते समय हटा दी जाती हैं। हर देश की केवल एक पंक्ति रखी जाती है।

Fallback cost: तब उपयोग होता है जब न API और न देशों की तालिका कोई कीमत दे। इस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।

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

शर्तें

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

Max cart weight (kg): कार्ट इससे भारी हो तो विधि छिपाएँ। डिफ़ॉल्ट: 25 (NZ Post कूरियर पार्सल 25 kg तक जाते हैं); खाली फ़ील्ड भी 25 माना जाता है। 0 का अर्थ कोई सीमा नहीं है। Ignore shipping zones चालू होने पर, खाली फ़ील्ड का अर्थ Geo zone के बाहर के पतों के लिए कोई सीमा नहीं है।

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

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

इन शर्तों के लिए कार्ट के वज़न में, बिना वज़न वाले उत्पाद 0 गिने जाते हैं।

उपलब्धता

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

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

Ignore shipping zones: नीचे के देशों के लिए जियो ज़ोन के बाहर भी NZ Post दें। चालू होने पर केवल ये देश विधि पाते हैं, जियो ज़ोन के भीतर भी। डिफ़ॉल्ट: बंद।

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

उन्नत

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

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

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

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

Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। Client Secret और auth code निर्यात नहीं होते।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मान सामान्य सहेजने की तरह जाँचे जाते हैं। सहेजे गए Client Secret और auth code तब तक रखे जाते हैं जब तक Client ID और अकाउंट नंबर भरे हों।

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

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

लाइव दरें सेट होने पर, एक्सटेंशन आपके Client ID और Client Secret से एक एक्सेस टोकन लेता है और NZ Post से कीमत माँगता है। न्यूज़ीलैंड के पते के लिए यह आपके अकाउंट विवरण, भेजने का पता, ग्राहक का उपनगर, शहर और पिनकोड, और पार्सल का वज़न व आकार भेजता है। OpenCart में उपनगर का कोई फ़ील्ड नहीं है: एक्सटेंशन Address 2 का उपयोग करता है जब उसमें उपनगर का नाम (बिना अंकों के) हो, अन्यथा शहर का। घरेलू दर तभी माँगी जाती है जब ग्राहक शहर और 4 अंकों का पिनकोड दर्ज कर दे। अन्य देशों के लिए यह गंतव्य देश, पार्सल का वज़न और आकार, और NZD में ऑर्डर मूल्य भेजता है।

कीमत वाली सबसे सस्ती अनुमत सेवा उपयोग होती है, जिसमें अधिभार और अनिवार्य एड-ऑन शामिल हैं। कीमत NZD से स्टोर की डिफ़ॉल्ट मुद्रा में बदली जाती है, उसके दशमलव स्थानों तक राउंड की जाती है और चुने गए Tax class के टैक्स के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है। हर उत्तर 1 घंटे तक कैश होता है। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रिफ़्रेश पर NZ Post का इंतज़ार न करे। API का समय-सीमा 10 सेकंड है। एक्सेस टोकन समाप्त होने तक रखा जाता है, और अस्वीकृत टोकन अपने-आप नवीनीकृत होता है।

यदि NZ Post कोई दर नहीं लौटाता (API सेट नहीं, त्रुटि, अधूरा पता, सेवा उपलब्ध नहीं, NZD दर नहीं), तो ग्राहक को कोई त्रुटि नहीं दिखती। देशों की तालिका की कीमत उपयोग होती है, फिर फ़ॉलबैक लागत। यदि कोई तय कीमत नहीं है, तो विधि छिप जाती है। कारण लॉग में लिखा जाता है।

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

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

ऑर्डर

जब NZ Post वाला ऑर्डर दिया जाता है, तो एक्सटेंशन सहेजता है कि शिपिंग कीमत किस पर आधारित थी। Sales > Orders में ऑर्डर खोलें: ऑर्डर पेज पर एक NZ Post पैनल दिखता है, जिसमें NZ Post service (लाइव दर की मूल्यांकित NZ Post सेवा, उसके कोड के साथ) और Price source दिखते हैं: Live rate (NZ Post ShippingOptions API), Fixed price या Free shipping। पैनल ऑर्डर के समय के मान दिखाता है, भले ही बाद में दरें या सेटिंग्स बदल जाएँ, और तब भी जब विधि बंद हो। ग्राहक को सेवा का नाम नहीं दिखता।

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

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

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

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

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

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

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

लाइव दरें दिखाई नहीं देतीं: एक्सटेंशन पेज के ऊपर की चेतावनियाँ देखें। फिर Debug log चालू करें, चेकआउट दोबारा लोड करें और Log फ़ील्ड देखें। API त्रुटियाँ वहाँ हमेशा होती हैं। लॉग कारण दिखाता है: Client ID या Client Secret गायब, टोकन अस्वीकृत, अकाउंट या भेजने के डेटा गायब, ग्राहक का शहर या पिनकोड अभी नहीं है, NZD दर नहीं है, या कोई मूल्यांकित सेवा नहीं है। समस्या ठीक करते समय तय कीमतें उपयोग होती हैं।

टोकन अनुरोध विफल: Client ID, Client Secret और Environment जाँचें। UAT क्रेडेंशियल प्रोडक्शन में काम नहीं करते, और इसका उलटा भी।

घरेलू दरें गायब हैं, अंतरराष्ट्रीय दरें काम करती हैं: न्यूज़ीलैंड के भीतर की दरों के लिए Account number, Auth code या Site code, और 4 अंकों के पिनकोड वाला पूरा भेजने का पता चाहिए। ग्राहक को शहर और 4 अंकों का पिनकोड दर्ज करना होगा।

मेरा स्टोर NZD में नहीं है: NZD दर दर्ज करें (NZD → (आपकी मुद्रा) rate फ़ील्ड)। तय कीमतें हमेशा स्टोर की डिफ़ॉल्ट मुद्रा में होती हैं।

शिपिंग पर GST दोबारा लग रहा है: NZ Post की घरेलू कीमतों में 15% GST शामिल है। यदि विधि में Tax class है, तो API prices को Excluding GST पर सेट करें।

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

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

डेवलपर्स के लिए: न्यूज़ीलैंड के डिलीवरी पते के लिए भेजा गया उपनगर OpenCart इवेंट vfd_nz_post/delivery_suburb (ट्रिगर catalog/vfd_nz_post/delivery_suburb) से बदला जा सकता है। NZ Post API का पता सेटिंग vfd_nzpt_api_url (परीक्षण के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसका कोई फ़ील्ड नहीं है।

अनइंस्टॉल

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

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

NZ Post अपने-अपने मालिक का ट्रेडमार्क है। यह एक्सटेंशन NZ Post से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।