VibeFox PostNL for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x, Classic या Hummingbird थीम (या इन पर आधारित कोई थीम)।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।

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

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox PostNL ढूँढकर Configure पर क्लिक करें।

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

4. कीमतें भरें। पिकअप पॉइंट के लिए PostNL की API key और Ship from (postcode) भी दर्ज करें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल दो कैरियर बनाता है: PostNL pickup point, जिसका डिलीवरी समय टेक्स्ट Delivery to a PostNL pickup point है, और PostNL, जिसका टेक्स्ट PostNL delivery to the home address है। दोनों नीदरलैंड और बेल्जियम के ज़ोन से और सभी ग्राहक समूहों से जुड़े होते हैं। ज़ोन जोड़ने और ग्राहक समूह, डिलीवरी समय, लोगो तथा आकार की सीमाएँ बदलने के लिए Shipping > Carriers का उपयोग करें। वहाँ कीमत न लगाएँ: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल के पेज पर हैं: Modules > Module Manager > VibeFox PostNL > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। WooCommerce में एक विधि को हर डिलीवरी प्रकार के लिए एक बार, यानी दो बार ज़ोन में जोड़ा जाता है। PrestaShop में हर डिलीवरी प्रकार अपने नाम, स्टेटस और ज़ोन वाला अलग कैरियर होता है।

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

सामान्य

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

Pickup point carrier name: चेकआउट पर ग्राहकों को दिखने वाला नाम। डिफ़ॉल्ट: PostNL pickup point। आवश्यक।

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

Home delivery carrier name: चेकआउट पर ग्राहकों को दिखने वाला नाम। डिफ़ॉल्ट: PostNL। आवश्यक।

Tax status: दोनों कैरियर का टैक्स नियम। Taxable नियम उस नियम का शिपिंग टैक्स कीमतों पर जोड़ता है। None का अर्थ है कि कीमतें अंतिम हैं।

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 को सौंपते हैं: Netherlands या Belgium। डिफ़ॉल्ट: Netherlands। PostNL पिकअप की तारीख के लिए भेजने वाले का पता उपयोग करता है।

Ship from (postcode): भेजने वाले का पिनकोड, उदाहरण के लिए नीदरलैंड में 1234AB या बेल्जियम में 1000। अगर स्टोर उसी देश में है, तो Shop Parameters > Contact > Stores का स्टोर पिनकोड उपयोग करने के लिए इसे खाली छोड़ें। गलत पिनकोड चेतावनी के साथ खाली सहेजा जाता है। API कुंजी, सैंडबॉक्स सेटिंग या भेजने का पता बदलने पर कैश की गई पिकअप पॉइंट सूचियाँ और अंतिम API त्रुटि साफ़ हो जाती हैं।

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

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

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" तथा "1.234,50" या "1,234.50" जैसी हज़ार-विभाजक वाली राशियाँ स्वीकार होती हैं। सहेजते समय खाली पंक्तियाँ और अमान्य देश कोड हटा दिए जाते हैं। कोई देश दो बार आए तो पहली पंक्ति रखी जाती है। अमान्य कीमतें चेतावनी के साथ अनदेखी की जाती हैं।

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

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

शर्तें

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

Minimum subtotal: कैरियर तभी दिखाएँ जब कार्ट सबटोटल कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।

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

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

सभी राशियाँ और वज़न हज़ार-विभाजक के साथ भी दशमलव अल्पविराम स्वीकार करते हैं। अमान्य या ऋणात्मक संख्या चेतावनी के साथ अनदेखी होती है और फ़ील्ड खाली सहेजा जाता है।

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

आमतौर पर कैरियर उन शिपिंग ज़ोन में दिए जाते हैं जिनसे वे Shipping > Carriers में जुड़े होते हैं।

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

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

उन्नत

Debug log: मॉड्यूल फ़ोल्डर में logs/vfd_ptnl_debug.log.php में डीबग संदेश लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। API त्रुटियाँ हमेशा लॉग होती हैं। कोई API कुंजी या ग्राहक डेटा नहीं लिखा जाता। काम खत्म होने पर लॉग बंद कर दें।

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

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

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

शिपिंग चरण में PrestaShop हर PostNL कैरियर की कीमत मॉड्यूल से माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल शर्तें जाँचता है: कार्ट वज़न और न्यूनतम सबटोटल। फिर वह देश और वज़न वर्ग के लिए तालिका से कीमत लेता है, या अन्य देशों की कीमत। कीमत न हो तो कैरियर छिप जाता है। कार्ट सबटोटल Free shipping from तक पहुँचे तो कीमत 0 होती है।

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

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

अगर ऑर्डर आने के बाद आप Shipping > Carriers में किसी कैरियर को संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सहेजता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।

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

पिकअप पॉइंट

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

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

एडमिन ऑर्डर पेज: नाम और पते के साथ PostNL pickup point ब्लॉक, जिसमें Location code और Partner ID होते हैं।

ऑर्डर कन्फर्मेशन और ऑर्डर विवरण पेज: नाम और पते के साथ PostNL pickup point।

ऑर्डर ईमेल: ऑर्डर कन्फर्मेशन ईमेल में कैरियर के नाम के साथ पॉइंट का नाम और पता जोड़ा जाता है। स्टोर का नया ऑर्डर ईमेल (Mail alerts मॉड्यूल) लोकेशन कोड भी दिखाता है।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox PostNL, Modules > Module Manager > VibeFox PostNL > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और बटन Check now (स्थिति दोबारा जाँचें), Change key (दूसरी कुंजी दर्ज करें) और Remove key (इस स्टोर से कुंजी हटाएँ)। उनके नीचे Product: presta-shipping-postnl वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल इस मॉड्यूल की Configure अनुमति वाले कर्मचारी कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर का डोमेन, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को PostNL कैरियर नहीं दिखाए जाते और शिपिंग कीमत की गणना नहीं होती। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपे रहते हैं: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

चेकआउट पर PostNL नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और कैरियर का स्विच चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore zones चालू है और देश की अनुमति है)। जाँचें कि देश के लिए कीमत, वज़न की सीमाएँ और Minimum subtotal सेट हैं। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।

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

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

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

उत्पादों के वज़न गलत लगते हैं: अगर मॉड्यूल पेज चेतावनी देता है कि स्टोर की वज़न इकाई ज्ञात नहीं है, तो International > Localization में Local units के अंतर्गत कोई मानक इकाई (kg, g, lb या oz) सेट करें। तब तक उत्पादों के वज़न kg माने जाते हैं।

पेज कहता है कि PostNL कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया जा चुका है। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल को रीसेट करें। रीसेट आपकी सेटिंग्स और कैरियर के स्टेटस को बनाए रखता है।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox PostNL के बगल वाला मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। कैश की गई पिकअप पॉइंट सूचियाँ और अंतिम API त्रुटि हमेशा हटा दी जाती हैं। अगर Remove data on uninstall चालू है, तो कैरियर हटाए जाते हैं (ऑर्डर अपना इतिहास रखते हैं) और सेटिंग्स तथा लॉग हटा दिए जाते हैं। अगर यह बंद है, तो कैरियर केवल बंद होते हैं और सारी सेटिंग्स रखी जाती हैं। मॉड्यूल फिर से इंस्टॉल करने पर कैरियर को उनका पिछला स्टेटस वापस मिल जाता है। मौजूदा ऑर्डर अपनी शिपिंग लाइनें और सहेजा गया पिकअप पॉइंट रखते हैं।

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