VibeFox PostNord for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x.

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

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

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

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

इंस्टॉलेशन

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

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

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

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

इंस्टॉल होने पर मॉड्यूल दो कैरियर बनाता है। PostNord सर्विस पॉइंट पर डिलीवर करता है, डिलीवरी समय का पाठ Delivery to a PostNord service point होता है। यह चालू रहता है। PostNord Home delivery पते पर डिलीवर करता है, पाठ PostNord home delivery होता है। Home delivery चालू करने तक यह बंद रहता है। दोनों कैरियर स्वीडन, डेनमार्क, नॉर्वे और फ़िनलैंड के ज़ोन और सभी ग्राहक समूहों को सौंपे जाते हैं। ज़ोन, ग्राहक समूह, डिलीवरी समय का पाठ, लोगो और आकार की सीमाएँ Shipping > Carriers में बदली जा सकती हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox PostNord > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर कैश की गई सर्विस पॉइंट सूचियाँ भी साफ़ हो जाती हैं।

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

सामान्य

Enable/Disable: सर्विस पॉइंट कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

Name: चेकआउट पर सर्विस पॉइंट कैरियर का नाम, उदाहरण के लिए "PostNord MyPack Collect"। डिफ़ॉल्ट: PostNord। अनिवार्य।

Home delivery: PostNord की घर तक डिलीवरी भी देता है। यह दूसरा कैरियर है, जिसमें सर्विस पॉइंट नहीं होता। डिफ़ॉल्ट रूप से बंद।

Home delivery name: चेकआउट पर घर तक डिलीवरी कैरियर का नाम, उदाहरण के लिए "PostNord MyPack Home"। डिफ़ॉल्ट: PostNord Home delivery। अनिवार्य।

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

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

API key: developer.postnord.com पर आपके एप्लिकेशन की API कुंजी। यह केवल आपके सर्वर से PostNord को भेजी जाती है, कभी ब्राउज़र को नहीं, और लॉग में कभी नहीं लिखी जाती। सहेजने के बाद फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान डालें।

Remove the saved API key: इसे टिक करके Save पर क्लिक करें, तो सहेजी गई कुंजी हट जाएगी।

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

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

कीमतें

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

Calculation type: Per order कीमत एक बार लेता है। Per item (price x 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 कॉलम का उपयोग करता है, और Price 0 होने का अर्थ है मुफ़्त शिपिंग। * All other countries उन सभी देशों को कवर करता है जिनकी अपनी पंक्ति नहीं है। दशमलव अंक अल्पविराम या बिंदु से लिखें (9,99 या 9.99)। नई पंक्ति * All other countries के रूप में शुरू होती है, जिसमें सभी कीमतें 0 होती हैं। सहेजने से पहले देश चुनें और कीमतें डालें, या पंक्ति हटा दें। खाली सेल 0 के रूप में सहेजी जाती है। जो सेल संख्या नहीं है, वह 0 के रूप में सहेजी जाती है और एक संदेश दिखता है।

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

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

उपलब्धता

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

Max weight (kg): कार्ट इससे भारी हो तो कैरियर छिपाएँ। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं। अपनी PostNord सेवा की वज़न सीमा जाँचें: पार्सल लॉकर सर्विस पॉइंट से कम वज़न लेते हैं। Max weight (kg) से बड़ा Min weight (kg) त्रुटि के साथ अस्वीकार होता है और कुछ भी सहेजा नहीं जाता।

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

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

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

राशि और वज़न में अल्पविराम या बिंदु चल सकते हैं। 0 या उससे अधिक संख्या न होने वाला मान सहेजा नहीं जाता, और एक संदेश दिखता है।

उन्नत

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

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

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

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

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

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

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

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

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

पिकअप पॉइंट

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

सूची लोड होने पर एक पॉइंट चुनना आवश्यक है। बिना चुने Continue "कृपया एक PostNord सर्विस पॉइंट चुनें।" संदेश के साथ रुक जाता है। चुना गया पॉइंट सर्वर पर डिलीवरी पते के लिए PostNord की सूची से मिलाया जाता है। किसी अन्य पिनकोड के लिए चुना गया पॉइंट उपयोग नहीं होता।

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

बैक ऑफ़िस ऑर्डर पेज: नाम, पता और Service point ID वाला PostNord service point ब्लॉक। यदि कोई पॉइंट नहीं चुना गया, तो लिखा होता है "चयनित नहीं - PostNord शिपिंग पते के सबसे नज़दीक के सर्विस पॉइंट पर डिलीवर करता है।"

ग्राहक की ऑर्डर पुष्टि और ऑर्डर विवरण: PostNord service point: नाम और पते के साथ।

ऑर्डर ईमेल: ग्राहक को भेजी गई ऑर्डर पुष्टि और स्टोर को भेजी गई नए ऑर्डर की सूचना में कैरियर के नाम के साथ पॉइंट का नाम, पता और ID दिखता है। स्टोर की सूचना में पॉइंट न होने पर "not selected" भी दिखता है।

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

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

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

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

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

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

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

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

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

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

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

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

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

अनइंस्टॉल

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

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