VibeFox PostNord for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या बाद का।

WooCommerce: 7.0 या बाद का, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या बाद का।

PostNord API कुंजी (सर्विस पॉइंट पिकर के लिए): developer.postnord.com पर एक मुफ़्त खाता बनाएँ, एक एप्लिकेशन जोड़ें और उसकी API कुंजी कॉपी करें। कुंजी के बिना भी यह विधि काम करती है, पर ग्राहक सर्विस पॉइंट नहीं चुन सकते।

PostNord अनुबंध: पार्सल भेजने के लिए आपके सामान्य PostNord ग्राहक अनुबंध की आवश्यकता है, उदाहरण के लिए MyPack Collect या MyPack Home।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_postnord फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox PostNord, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।

5. PostNord की API key पेस्ट करें, अपना Agreement country चुनें और Country prices भरें (देखें कॉन्फ़िगरेशन)।

6. WooCommerce > Settings > Shipping > Shipping zones में स्वीडन, डेनमार्क, नॉर्वे या फ़िनलैंड के शिपिंग ज़ोन में VibeFox PostNord जोड़ें। विधि की सेटिंग्स में उसका Title और Delivery type सेट करें। या Ignore shipping zones चालू करें।

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

शीर्षक और डिलीवरी प्रकार को छोड़कर सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox PostNord। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में विधि जोड़ते हैं, तो ज़ोन विंडो में दो फ़ील्ड होते हैं:

Title (zone): चेकआउट पर इस विकल्प का नाम, उदाहरण के लिए "PostNord MyPack Collect"। वैश्विक Name का उपयोग करने के लिए खाली छोड़ें।

Delivery type (zone): Same as global setting (डिफ़ॉल्ट), Service point / parcel locker, या Home delivery। दोनों विकल्प देने के लिए किसी ज़ोन में दो PostNord विधियाँ जोड़ें।

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

सामान्य

Enable/Disable: अनचेक होने पर यह विधि हर जगह छिप जाती है, शिपिंग ज़ोन में भी।

Name: चेकआउट पर दिखाया जाने वाला शिपिंग विधि का नाम। ज़ोन विधि इसे अपने Title से बदल सकती है। डिफ़ॉल्ट: PostNord।

Delivery type: सभी PostNord विधियों के लिए डिफ़ॉल्ट; हर ज़ोन विधि अपना प्रकार चुन सकती है।

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

PostNord API (सर्विस पॉइंट पिकर)

API key: developer.postnord.com पर आपके एप्लिकेशन की API कुंजी। यह केवल आपके सर्वर से PostNord को भेजी जाती है, कभी ब्राउज़र को नहीं, और कभी लॉग नहीं की जाती।

Test mode: PostNord टेस्ट एनवायरनमेंट (atapi2.postnord.com) का उपयोग करता है। केवल टेस्ट एनवायरनमेंट के लिए जारी की गई कुंजियों के लिए।

Agreement country: आपके PostNord ग्राहक अनुबंध का देश: स्वीडन, डेनमार्क, नॉर्वे या फ़िनलैंड। यह तय करता है कि कौन से सर्विस पॉइंट दिखाए जाएँगे। Same as the delivery country (डिफ़ॉल्ट) ग्राहक के देश का उपयोग करता है।

कीमतें

कीमतें स्टोर की मुद्रा में होती हैं। PostNord के पास कोई सार्वजनिक प्राइस API नहीं है, इसलिए आप अपनी कीमतें तय करते हैं, आमतौर पर अपने PostNord अनुबंध की कीमतें। क्रम यह है: पहले देश की तालिका, फिर फ़ॉलबैक लागत; मुफ़्त शिपिंग केवल वहीं लागू होती है जहाँ इनमें से कोई एक कीमत देता है।

Calculation type: Per order कीमत एक बार लेता है। Per item (price × number of items) उसे कार्ट के आइटमों की संख्या से गुणा करता है।

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

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

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

उपलब्धता

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

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

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

Disabled shipping classes: कार्ट में इन WooCommerce शिपिंग क्लास में से किसी का उत्पाद होने पर विधि छिपाता है।

Ignore shipping zones: चालू होने पर, भले ही विधि किसी शिपिंग ज़ोन में न जोड़ी गई हो, नीचे दिए देशों के लिए वैश्विक सेटिंग्स के साथ PostNord दिया जाता है। बंद होने पर, केवल उन्हीं शिपिंग ज़ोन में जहाँ आपने इसे जोड़ा है।

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

राशियाँ और वज़न अल्पविराम या बिंदु स्वीकार करते हैं। गलत संख्या सेव नहीं होती और संदेश दिखता है।

उन्नत

Debug log: कीमत गणना और API कॉल को WooCommerce > Status > Logs में लिखता है (स्रोत "vfd-postnord")। API त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजी कभी लॉग नहीं होती। काम पूरा होने पर लॉग बंद कर दें।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से PostNord सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर में सेव किए गए सर्विस पॉइंट हमेशा रहते हैं।

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

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

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

अन्य गंतव्यों के लिए विधि आपकी कीमतों के साथ, बिना पिकर के, फिर भी दी जा सकती है।

यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

यह प्लगइन PostNord की लाइव कीमतें नहीं मँगाता और शिपिंग लेबल नहीं बनाता, शिपमेंट बुक नहीं करता (EDI), ट्रैकिंग नंबर नहीं देता या ट्रैकिंग ईमेल नहीं भेजता। मैप व्यू नहीं है। शिपमेंट के लिए PostNord Portal, Skicka Direkt Business या कोई लेबल प्लगइन इस्तेमाल करें; इन टूल को सेव किया गया सर्विस पॉइंट ID चाहिए।

पिकअप पॉइंट

जब ग्राहक सर्विस पॉइंट विधि चुनता है, तो उसके नीचे निकटतम पॉइंट की PostNord service point सूची आती है, जो शहर के अनुसार समूहित होती है और दूरी के साथ दिखती है। पिनकोड डालने से पहले ग्राहक को "Enter your postcode to choose a PostNord service point." दिखता है। चेकआउट अपडेट के बाद भी चुनाव बना रहता है।

सूची लोड होने पर एक पॉइंट चुनना आवश्यक है। चुने बिना चेकआउट "Please select a PostNord service point." के साथ रुक जाता है। चुना गया पॉइंट सर्वर पर सूची से मिलाया जाता है, क्लासिक और ब्लॉक, दोनों चेकआउट में।

पिकर कभी बिक्री नहीं रोकता। यदि सूची लोड नहीं हो पाती (अभी API कुंजी नहीं, PostNord API बंद, पिनकोड के पास कोई पॉइंट नहीं), तो ग्राहक को एक सूचना दिखती है और वह फिर भी ऑर्डर दे सकता है। तब PostNord पते के सबसे नज़दीकी सर्विस पॉइंट पर डिलीवर करता है।

एडमिन ऑर्डर स्क्रीन: डिलीवरी पते के नीचे, नाम, पते और Service point ID के साथ PostNord service point। यदि कोई पॉइंट नहीं चुना गया, तो लिखा होता है "not selected — PostNord delivers to the service point nearest to the shipping address"।

धन्यवाद पेज और My account में ऑर्डर व्यू: PostNord service point: नाम और पते के साथ।

ऑर्डर ईमेल: HTML और सादे टेक्स्ट ईमेल में पॉइंट का नाम, पता और ID।

डेटाबेस में पॉइंट ऑर्डर मेटा _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name और _vfd_ptnd_servicepoint_address में सेव होता है।

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox PostNord के ऊपर है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना PostNord चेकआउट पर ग्राहकों को नहीं दिखता। लॉग इन किए स्टोर मैनेजरों को यह अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस की अवधि खत्म होने पर प्लगइन काम करता रहता है, पर अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

चेकआउट पर PostNord नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। जाँचें कि देश की कीमत तय है (देश की पंक्ति, * पंक्ति या Fallback cost), वज़न की सीमाएँ, Minimum subtotal और Disabled shipping classes।

पिकर कहता है कि सर्विस पॉइंट लोड नहीं हो सकते: API key और Test mode सेटिंग जाँचें। प्रोडक्शन कुंजी टेस्ट एनवायरनमेंट में काम नहीं करती, और इसका उल्टा भी। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत "vfd-postnord" देखें। ऑर्डर फिर भी हो सकता है; तब PostNord निकटतम सर्विस पॉइंट पर डिलीवर करता है।

अनपेक्षित सर्विस पॉइंट: Agreement country जाँचें। यह तय करता है कि कौन से सर्विस पॉइंट दिए जाएँगे।

गलती से शिपिंग मुफ़्त है: Country prices में Price 0 वाली पंक्तियाँ जाँचें, खासकर वह * पंक्ति जो + Add country से जोड़ी गई और भरी नहीं गई, और Free shipping from जाँचें।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदला है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

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

PostNord उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन PostNord से संबद्ध नहीं है और PostNord द्वारा समर्थित नहीं है।