VibeFox PostNL for OpenCart — सहायता

आवश्यकताएँ

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

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

PostNL API कुंजी (केवल पिकअप पॉइंट्स के लिए): पिकअप पॉइंट्स PostNL Checkout API से लोड होते हैं। PostNL के बिज़नेस ग्राहक अपनी API कुंजी Mijn PostNL में My account > API beheren के अंतर्गत पाते हैं। PostNL सैंडबॉक्स के लिए एक अलग सैंडबॉक्स कुंजी चाहिए। घर तक डिलीवरी विकल्प को कुंजी की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. PostNL pickup point और/या PostNL home address चालू करें और कीमतें भरें। पिकअप पॉइंट्स के लिए PostNL की API key और Ship from (postcode) भी दर्ज करें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

यदि कोई मान गलत है, तो कुछ भी सहेजा नहीं जाता और पेज कारण दिखाता है: विकल्प का नाम खाली हो, 64 अक्षरों से लंबा हो या उसमें < > ; = # { } हों; क्रम संख्या पूर्ण संख्या न हो; न्यूनतम वज़न अधिकतम वज़न से ऊपर हो; या टैक्स क्लास या जियो ज़ोन अमान्य हो। छोटी समस्याएँ एक टिप्पणी के साथ सहेजी जाती हैं: अमान्य या ऋणात्मक संख्या से उसका फ़ील्ड खाली हो जाता है, अमान्य शिप-फ़्रॉम पोस्टकोड खाली सहेजा जाता है, और तालिका की अमान्य कीमत अनदेखी की जाती है।

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

सामान्य

हर डिलीवरी प्रकार चेकआउट पर अपना अलग विकल्प है। इस पेज की सेटिंग्स दोनों पर लागू होती हैं।

PostNL pickup point: पिकअप पॉइंट विकल्प चालू या बंद करता है। ग्राहक को चेकआउट पर PostNL पॉइंट चुनना होगा। यह केवल नीदरलैंड और बेल्जियम के पतों के लिए और केवल API कुंजी के साथ दिया जाता है। डिफ़ॉल्ट: बंद।

Pickup point option name: ग्राहक को चेकआउट पर दिखने वाला नाम। डिफ़ॉल्ट: PostNL pickup point। आवश्यक, अधिकतम 64 अक्षर, < > ; = # { } के बिना।

PostNL home address: घर तक डिलीवरी विकल्प चालू या बंद करता है। कोई पॉइंट नहीं चुना जाता। यह हर उस देश के लिए काम करता है जिसकी कीमत है। डिफ़ॉल्ट: बंद।

Home delivery option name: ग्राहक को चेकआउट पर दिखने वाला नाम। डिफ़ॉल्ट: PostNL। पिकअप पॉइंट नाम जैसे ही नियम लागू होते हैं।

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

Tax class: दोनों विकल्पों की टैक्स क्लास। टैक्स क्लास होने पर OpenCart कीमतों पर अपना टैक्स जोड़ता है। No tax का अर्थ है कि कीमतें अंतिम हैं।

PostNL API (पिकअप पॉइंट्स) (घर तक डिलीवरी के लिए ज़रूरी नहीं)

API key: Mijn PostNL (My account > API beheren) से आपकी PostNL API कुंजी। यह "apikey" हेडर में PostNL को भेजी जाती है और न ग्राहकों को दिखाई जाती है, न लॉग में लिखी जाती है। सहेजने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Remove the saved API key: इसे टिक करें और सहेजी गई कुंजी हटाने के लिए Save पर क्लिक करें। इसके बाद पिकअप पॉइंट विकल्प नहीं दिया जाता।

Sandbox: PostNL सैंडबॉक्स (api-sandbox.postnl.nl) का उपयोग करता है, सैंडबॉक्स API कुंजी के साथ। तब ग्राहकों को परीक्षण पिकअप पॉइंट्स दिखते हैं। लाइव स्टोर पर इसे बंद रखें।

Ship from (country): वह देश जहाँ आप अपने पार्सल PostNL को सौंपते हैं: नीदरलैंड या बेल्जियम। PostNL पिकअप की तारीख़ के लिए भेजने वाले का पता उपयोग करता है। इंस्टॉल पर यह आपके स्टोर के देश पर सेट होता है, यदि वह नीदरलैंड या बेल्जियम है; अन्यथा नीदरलैंड पर।

Ship from (postcode): भेजने वाले का पोस्टकोड, उदाहरण के लिए नीदरलैंड में 1234AB या बेल्जियम में 1000। पिकअप पॉइंट्स के लिए आवश्यक है: OpenCart में स्टोर का पोस्टकोड नहीं होता, इसलिए यह स्टोर के पते से नहीं लिया जाता। अमान्य पोस्टकोड चेतावनी के साथ खाली सहेजा जाता है।

API कुंजी, सैंडबॉक्स सेटिंग या शिप-फ़्रॉम पता बदलने पर, कैश की गई पिकअप पॉइंट सूचियाँ और आख़िरी API त्रुटि साफ़ हो जाती हैं।

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

कीमतें दोनों विकल्पों पर लागू होती हैं। PostNL के पास सार्वजनिक दर API नहीं है, इसलिए एक्सटेंशन लाइव दरें नहीं माँगता। किसी ऐसे ग्राहक के लिए जो दूसरी मुद्रा में भुगतान करता है, OpenCart आपके स्टोर की विनिमय दर से कीमत बदलता है।

Price per country: हर गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर और पंक्ति हटाने के लिए × बटन पर क्लिक करें। जिन देशों की अपनी पंक्ति नहीं है, उन सभी के लिए पंक्ति चाहिए तो * All other countries चुनें। हर पंक्ति में एक Price होता है और कार्ट के वज़न के अनुसार वैकल्पिक वज़न श्रेणियाँ: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक और XL 5 kg से अधिक। वज़न श्रेणी की कीमत Price की जगह लेती है; Price का उपयोग करने के लिए इसे खाली छोड़ें। Price 0 हो तो मुफ़्त शिपिंग होती है। "6.95" और "6,95" दोनों स्वीकार होते हैं। जिन पंक्तियों में कीमत नहीं है, वे सहेजते समय हटा दी जाती हैं। यदि कोई देश दो बार आता है, तो पहली पंक्ति रखी जाती है। अमान्य कीमतें चेतावनी के साथ अनदेखी की जाती हैं।

Calculation: Per order कीमत एक बार लेता है। Per item (price x quantity) उसे उन आइटमों की संख्या से गुणा करता है जिन्हें शिपिंग चाहिए।

Price for other countries: तब उपयोग होता है जब तालिका में न देश हो, न * पंक्ति। वहाँ विकल्प छिपाने के लिए इसे खाली छोड़ें।

शर्तें

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

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

Minimum weight (kg): कार्ट इससे हल्का हो तो विकल्प छिपाएँ। उत्पादों का वज़न उनकी वज़न श्रेणी से परिवर्तित होता है। कोई सीमा न रखने के लिए खाली छोड़ें।

Maximum weight (kg): भारी कार्ट के लिए विकल्प छिपाएँ। PostNL के पार्सल Benelux में 30 kg तक जाते हैं। 0 का अर्थ है कोई सीमा नहीं। खाली छोड़ने पर 30 kg लागू होता है, या Ignore shipping zones चालू होने पर कोई सीमा नहीं।

सभी राशियाँ और वज़न दशमलव के लिए कॉमा स्वीकार करते हैं।

उपलब्धता

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

Ignore shipping zones: चालू होने पर जियो ज़ोन की जाँच नहीं होती और PostNL नीचे चुने गए देशों के लिए दिया जाता है (सूची खाली हो तो हर देश)। बंद होने पर केवल जियो ज़ोन मायने रखता है।

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

उन्नत

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

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

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

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

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

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

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से हर PostNL विकल्प की कीमत माँगता है। यदि Ignore shipping zones चालू है, तो PostNL केवल एक अनुमत देश के लिए दिया जाता है, जियो ज़ोन चाहे जो भी हो। अन्यथा, यदि Geo zone सेट है, तो पता उसके अंदर होना चाहिए। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। एक्सटेंशन कार्ट के वज़न और न्यूनतम उप-योग की जाँच करता है। फिर वह देश और वज़न श्रेणी के लिए तालिका से कीमत लेता है, या अन्य देशों की कीमत। यदि कीमत नहीं है, तो विकल्प छिप जाता है। यदि कार्ट का उप-योग Free shipping from तक पहुँचता है, तो कीमत 0 है। कीमत ग्राहक को उसकी मुद्रा में, चुनी गई Tax class के टैक्स के साथ दिखाई जाती है।

पिकअप पॉइंट विकल्प केवल नीदरलैंड और बेल्जियम के पतों के लिए और केवल API कुंजी के साथ दिया जाता है। जब डिलीवरी पते में पूरा पोस्टकोड होता है, तो एक्सटेंशन PostNL Checkout API से निकटतम तीन पिकअप पॉइंट्स माँगता है। वह ग्राहक का पोस्टकोड, गली और मकान नंबर, शहर और देश, तथा आपका शिप-फ़्रॉम पता भेजता है। घर तक डिलीवरी विकल्प के लिए कुछ नहीं भेजा जाता। यदि PostNL तक पहुँच न हो या उस पते के लिए कोई पॉइंट न हो, तो पिकअप पॉइंट विकल्प छिप जाता है और घर तक डिलीवरी उपलब्ध रहती है। API का टाइमआउट 12 सेकंड है।

पॉइंट सूचियाँ हर पते के लिए 6 घंटे तक कैश होती हैं, और "कोई पॉइंट नहीं" के उत्तर 1 घंटे तक। विफल अनुरोध 10 मिनट तक कैश होते हैं, ताकि कोई आउटेज हर चेकआउट रीफ़्रेश को धीमा न करे। कैश एक्सटेंशन की अपनी डेटाबेस तालिका में रखा जाता है। आख़िरी त्रुटि एक्सटेंशन पेज पर तब तक दिखती है जब तक अगला सफल अनुरोध न हो।

एक्सटेंशन PostNL की लाइव दरें नहीं माँगता और शिपिंग लेबल, बारकोड, ट्रैक एंड ट्रेस, रिटर्न या प्री-अलर्ट नहीं बनाता। इसमें डिलीवरी-दिन, शाम या सुबह की डिलीवरी के विकल्प नहीं हैं। सहेजे गए पिकअप पॉइंट का उपयोग करते हुए Mijn PostNL या किसी दूसरे PostNL टूल में शिपमेंट बनाएँ।

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

पिकअप पॉइंट्स

जब डिलीवरी पता नीदरलैंड या बेल्जियम में होता है, तो पिकअप पॉइंट विकल्प के नीचे निकटतम तीन पॉइंट्स वाली PostNL pickup point सूची दिखती है: कंपनी का नाम, पता और दूरी, सबसे नज़दीक वाला पहले। पेज कभी PostNL का इंतज़ार नहीं करता: यदि सूची अभी कैश में नहीं है, तो विकल्प चुनते ही वह लोड हो जाती है। पूरा पोस्टकोड दर्ज होने से पहले ग्राहक को "Enter your postcode (for example 1234 AB) to see PostNL pickup points." दिखता है (बेल्जियम के लिए 4 अंक)। चुना गया पॉइंट तुरंत चेकआउट के लिए सहेजा जाता है।

पॉइंट आवश्यक है। जब ग्राहक डिलीवरी विधि चरण में Continue पर क्लिक करता है, तो सर्वर पॉइंट की जाँच डिलीवरी पते के लिए PostNL की सूची से करता है। बिना पॉइंट के ग्राहक को "Please choose a PostNL pickup point." दिखता है। यदि पॉइंट सूची में नहीं है, तो "The chosen PostNL pickup point is not available for this address. Please choose it again." दिखता है। यदि PostNL तक पहुँच न हो, तो "PostNL pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method." दिखता है। किसी दूसरे पते के लिए चुना गया पॉइंट ऑर्डर के लिए कभी उपयोग नहीं होता। ऑर्डर के साथ सहेजे गए नाम और पते PostNL से आते हैं, ब्राउज़र से नहीं।

ऑर्डर पेज, ईमेल और इनवॉइस: पॉइंट ऑर्डर की शिपिंग विधि में जोड़ा जाता है, जैसे "PostNL pickup point: नाम, पता" (पिकअप पॉइंट विकल्प का नाम, फिर पॉइंट) (128 अक्षरों तक, OpenCart 4 पर 255 अक्षरों तक)। यह वहाँ दिखता है जहाँ OpenCart शिपिंग विधि दिखाता है: ग्राहक का ऑर्डर इतिहास, ऑर्डर ईमेल, इनवॉइस और Sales > Orders।

एडमिन ऑर्डर पेज: Sales > Orders में ऑर्डर पेज इतिहास के ऊपर एक PostNL pickup point पैनल दिखाता है, जिसमें पॉइंट, Location code और Partner ID होते हैं। यह केवल सहेजे गए पॉइंट वाले ऑर्डरों के लिए दिखता है, एक्सटेंशन बंद होने के बाद भी।

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

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

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

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

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

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

चेकआउट पर PostNL नहीं दिखता: जाँच करें कि लाइसेंस सक्रिय है और PostNL pickup point या PostNL home address चालू है। Geo zone की जाँच करें (या यह कि Ignore shipping zones चालू है और देश अनुमत है), देश के लिए कीमत सेट है, वज़न सीमाएँ और Minimum subtotal। जाँच करें कि उत्पादों में Requires Shipping Yes पर सेट है।

पिकअप पॉइंट विकल्प नहीं दिखता: यह केवल डच और बेल्जियन पतों के लिए, केवल API कुंजी, शिप-फ़्रॉम पोस्टकोड और कीमत के साथ, और केवल तब दिखता है जब PostNL ग्राहक के पोस्टकोड के लिए पॉइंट्स लौटाए। एक्सटेंशन पेज के ऊपर की चेतावनियाँ और Log फ़ील्ड देखें। त्रुटियाँ हमेशा लॉग होती हैं; विवरण के लिए Debug log चालू करें।

"PostNL pickup points cannot be loaded right now": PostNL तक पहुँच नहीं हो सकी, उसने API कुंजी अस्वीकार की, या शिप-फ़्रॉम पोस्टकोड गायब है। एक्सटेंशन पेज पर आख़िरी त्रुटि दिखती है। सैंडबॉक्स कुंजी केवल Sandbox चालू होने पर, और लाइव कुंजी केवल उसके बंद होने पर काम करती है।

ग्राहकों को परीक्षण पिकअप पॉइंट्स दिखते हैं: Sandbox बंद करें।

उत्पादों का वज़न गलत लगता है: यदि एक्सटेंशन पेज चेतावनी देता है कि स्टोर में वज़न श्रेणी "kg" नहीं है, तो System > Localisation > Weight Classes देखें। उत्पादों का वज़न उनकी श्रेणी के इकाई-नाम से परिवर्तित होता है, और अज्ञात इकाइयाँ किलोग्राम मानी जाती हैं।

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

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

अनइंस्टॉल

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

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

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