VibeFox Purolator for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होगा। PHP SOAP एक्सटेंशन की आवश्यकता नहीं है।
Purolator E-Ship Web Services (केवल लाइव दरों के लिए): Purolator वेबसाइट पर Purolator E-Ship Resource Centre में E-Ship Web Services के लिए पंजीकरण करें। Purolator डेवलपमेंट और प्रोडक्शन वातावरण के लिए अलग-अलग कुंजियाँ और पासवर्ड देता है। आपको अपना Purolator बिलिंग खाता नंबर और वह कनाडाई पोस्टल कोड भी चाहिए जहाँ से आप शिप करते हैं। यदि आप केवल निश्चित कीमतें इस्तेमाल करते हैं, तो API कुंजियों की आवश्यकता नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Purolator ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के सबसे ऊपर लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।
4. लाइव दरों के लिए Purolator API (live rates) सेक्शन भरें। परीक्षण के लिए, डेवलपमेंट कुंजी के साथ Development environment चालू करें। यदि आप निश्चित कीमतें या फ़ॉलबैक कीमत चाहते हैं, तो Country prices या Fallback price भरें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।
इंस्टॉल के समय मॉड्यूल Purolator courier डिलीवरी समय टेक्स्ट के साथ Purolator कैरियर बनाता है। कैरियर सभी ज़ोन और सभी ग्राहक समूहों को असाइन किया जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Purolator > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव से कैश की गई Purolator दरें भी साफ़ हो जाती हैं।
यदि सेव किए गए मानों के साथ लाइव दरें काम नहीं कर सकतीं (कुंजी, पासवर्ड या बिलिंग खाता गायब है, कनाडाई शिप-फ्रॉम पोस्टल कोड नहीं है, CAD दर नहीं है), या न API क्रेडेंशियल हैं न निश्चित कीमतें, तो सेटिंग्स के ऊपर चेतावनी दिखती है। यदि स्टोर की वज़न इकाई मॉड्यूल की ज्ञात इकाइयों (kg, g, lb, oz आदि) में नहीं है, तब भी चेतावनी दिखती है। तब उत्पादों के वज़न को kg माना जाता है। वज़न इकाई International > Localization (Local units) में सेट करें।
0 या उससे अधिक संख्या न होने वाला संख्या फ़ील्ड सेव नहीं होता। चेतावनी फ़ील्ड और मान बताती है। फ़ील्ड खाली रहता है, या वज़न फ़ील्ड के लिए अपना डिफ़ॉल्ट मान पाता है। Country prices में गलत मान 0 के रूप में सेव होता है, और चेतावनी देश और कॉलम बताती है। यदि Min cart weight, Max cart weight से बड़ा है, तो कुछ भी सेव नहीं होता और एक त्रुटि दिखती है।
सामान्य
Enable Purolator: कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।
Method title: कार्ट और चेकआउट में दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Purolator। अनिवार्य, अधिकतम 64 अक्षर।
Tax: कैरियर का टैक्स नियम, या No tax। यह तय करता है कि स्टोर शिपिंग लागत पर टैक्स जोड़े या नहीं। कनाडाई पतों के लिए Purolator का कुल योग पहले से GST/HST/PST/QST शामिल करता है। नीचे Canadian sales taxes देखें।
Purolator API (लाइव दरें)
जब API कुंजी, पासवर्ड और बिलिंग खाता भरा होता है, तब कीमत Purolator E-Ship Estimating web service से आती है। यदि Purolator कोई दर नहीं देता, तो निश्चित कीमत इस्तेमाल होती है, या कोई नहीं होने पर कैरियर छिपा दिया जाता है। इस सेक्शन में Purolator E-Ship Resource Centre का लिंक है, जहाँ आप पंजीकरण करके कुंजियाँ पाते हैं।
API key: चुने गए वातावरण के लिए आपकी E-Ship Web Services कुंजी। सेव के बाद फ़ील्ड खाली हो जाता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
API password: कुंजी का पासवर्ड। कुंजी की तरह, सेव के बाद यह फिर से नहीं दिखता।
Billing account number: आपका Purolator खाता नंबर। अनुमान इसी खाते की दरों का उपयोग करते हैं। डेवलपमेंट वातावरण Purolator दस्तावेज़ीकरण का परीक्षण खाता स्वीकार करता है। इस फ़ील्ड को खाली करने से सेव की गई API कुंजी और पासवर्ड भी हट जाते हैं।
Development environment: डेवलपमेंट कुंजी के साथ Purolator डेवलपमेंट वातावरण (devwebservices.purolator.com) का उपयोग करता है। कीमतें परीक्षण डेटा हैं। लाइव स्टोर पर इसे बंद रखें।
Ship-from postal code: कनाडाई पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, जैसे L4W 5M8।
Service in Canada: Cheapest available (डिफ़ॉल्ट), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM या Purolator Express Evening।
Service to the USA: Cheapest available (डिफ़ॉल्ट), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM या Purolator Express U.S. 12:00।
International service: Cheapest available (डिफ़ॉल्ट), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM या Purolator Express International 12:00।
यदि चुनी गई सेवा पते के लिए उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा इस्तेमाल होती है।
Canadian sales taxes: GST/HST/PST/QST के बिना Purolator कीमतें इस्तेमाल करें। कनाडाई पतों के लिए Purolator का कुल योग इन टैक्स को शामिल करता है। जब कैरियर के पास Tax में टैक्स नियम हो, तब इसे चालू करें, ताकि टैक्स दो बार न लगे।
CAD → (shop currency) rate: Purolator की कीमतें CAD में होती हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा CAD नहीं है, तो बताएँ कि 1 CAD आपकी मुद्रा की कितनी इकाइयों के बराबर है, जैसे 0.68। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। यदि डिफ़ॉल्ट मुद्रा CAD है, तो इसे खाली छोड़ें।
Default product weight: kg में, उन सभी उत्पादों के लिए जिनका वज़न नहीं है। डिफ़ॉल्ट: 0.5। वज़न स्टोर की वज़न इकाई से बदला जाता है और पाउंड की पूरी इकाइयों में, ऊपर की ओर पूर्णांकित करके, कुल वज़न के रूप में Purolator को भेजा जाता है।
निश्चित कीमतें (API क्रेडेंशियल के बिना उपयोग होती हैं, और API दर न दे तो फ़ॉलबैक के रूप में)
Country prices: देश और कार्ट वज़न के अनुसार कीमत, स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स को छोड़कर। पंक्ति जोड़ने के लिए Add country पर और पंक्ति हटाने के लिए ट्रैश आइकन पर क्लिक करें। उन सभी देशों के लिए एक पंक्ति चुनें जिनकी अपनी पंक्ति नहीं है: * Default (all other countries)। हर पंक्ति में एक Base कीमत और आकार कॉलम होते हैं: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg और XL 5 kg से अधिक। खाली या शून्य आकार कीमत Base इस्तेमाल करती है। Base 0 हो, या Base खाली हो, तो अपनी आकार कीमत न वाले वज़न के लिए मुफ़्त शिपिंग होती है। 9.99 और 9,99 दोनों स्वीकार हैं। बिना किसी कीमत वाली पंक्तियाँ सेव नहीं होतीं, और हर देश के लिए केवल एक पंक्ति रखी जाती है।
Fallback price: उस देश की कीमत जिसकी Country prices में पंक्ति नहीं है और * पंक्ति भी नहीं है। ऐसे देशों में कैरियर छिपाने के लिए इसे खाली छोड़ें।
Fixed price per: Order कीमत एक बार लेता है। Item (price × quantity) इसे कार्ट में आइटम की संख्या से गुणा करता है। यह केवल निश्चित कीमतों पर लागू होता है। लाइव दरें हमेशा पूरी शिपमेंट के लिए गणना की जाती हैं।
शर्तें
Min cart weight: kg में; यदि कार्ट इससे हल्का है तो कैरियर छिपाता है। 0 का अर्थ है कोई सीमा नहीं।
Max cart weight: kg में; यदि कार्ट इससे भारी है तो कैरियर छिपाता है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं।
Minimum order amount: कैरियर केवल तब दिखाता है जब कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) इस राशि तक पहुँचता है। हमेशा दिखाने के लिए खाली छोड़ें।
Free shipping from: कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) जिससे डिलीवरी मुफ़्त है। तब Purolator को कोई अनुरोध नहीं भेजा जाता। कभी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।
इन शर्तों के लिए कार्ट वज़न में बिना वज़न वाले उत्पाद 0 गिने जाते हैं।
शिपिंग ज़ोन के बिना उपलब्धता
आम तौर पर कैरियर उन ज़ोन में दिया जाता है जिनमें वह Shipping > Carriers में असाइन है।
Ignore shipping zones: नीचे दिए गए देशों के लिए Purolator दें, चाहे कोई भी ज़ोन मेल खाए। सेव करने पर कैरियर सभी ज़ोन में जोड़ा जाता है, और बाद में बनाए गए ज़ोन में भी जुड़ जाता है। इस विकल्प को बंद करने पर वे ज़ोन फिर से हट जाते हैं।
Countries: इस मोड के लिए गंतव्य देश। स्टोर के सभी सक्रिय देश इस्तेमाल करने के लिए खाली छोड़ें। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: दर गणनाएँ मॉड्यूल फ़ोल्डर में logs/vfd_prlr_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खुल सकती। API त्रुटियाँ डिबग लॉग बंद होने पर भी हमेशा दर्ज होती हैं। API कुंजियाँ, बिलिंग खाता और ग्राहकों के पोस्टल कोड दर्ज नहीं होते। काम पूरा होने पर लॉग बंद करें।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से सेटिंग्स, कैरियर, कैश की गई दरें और लॉग हट जाते हैं। बंद होने पर फिर से इंस्टॉल करने के लिए सब कुछ रखा जाता है।
चेकआउट पर यह कैसे काम करता है
शिपिंग चरण पर PrestaShop मॉड्यूल से Purolator की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। ग्राहक के पता दर्ज करने से पहले, कीमत उस देश के लिए अनुमानित की जाती है जिसे स्टोर अनुमान के लिए इस्तेमाल करता है। मॉड्यूल पहले शर्तें जाँचता है: अनुमति वाले देश (Ignore shipping zones के साथ), कार्ट वज़न और न्यूनतम ऑर्डर राशि। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और Purolator को कोई अनुरोध नहीं भेजा जाता। फिर वह कीमत खोजता है: पहले Purolator की लाइव दर, फिर देश की तालिका, फिर फ़ॉलबैक कीमत। यदि कोई कीमत नहीं है, तो कैरियर छिपा दिया जाता है।
API क्रेडेंशियल होने पर मॉड्यूल Purolator को Quick Estimate अनुरोध भेजता है: आपका बिलिंग खाता, शिप-फ्रॉम पोस्टल कोड, ग्राहक का शहर, प्रांत या राज्य, देश और पोस्टल कोड, और पाउंड की पूरी इकाइयों में कुल कार्ट वज़न। कनाडा के लिए मान्य पोस्टल कोड चाहिए, USA के लिए मान्य ZIP कोड; अन्य देश उसी पोस्टल कोड के साथ भेजे जाते हैं जैसा दर्ज किया गया है। आयाम (डायमेंशनल वज़न) नहीं भेजे जाते। Purolator ग्राहक की भाषा के अनुसार फ़्रेंच या अंग्रेज़ी में उत्तर देता है। Purolator सभी सेवाओं की कीमतें लौटाता है; मॉड्यूल आपकी चुनी हुई सेवा या सबसे सस्ती सेवा लेता है, सेट होने पर कनाडाई बिक्री टैक्स हटाता है, और कीमत को CAD से बदलता है। कीमत स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
हर उत्तर 1 घंटे के लिए कैश होता है। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि Purolator की रुकावट से हर चेकआउट रीफ़्रेश धीमा न हो। API टाइमआउट 10 सेकंड है।
यदि Purolator कोई दर नहीं देता (API बंद है, गलत क्रेडेंशियल या पोस्टल कोड, सेवा उपलब्ध नहीं, CAD दर नहीं है), तो ग्राहक को कोई त्रुटि नहीं दिखती। निश्चित कीमत इस्तेमाल होती है, या निश्चित कीमत न होने पर कैरियर छिपा दिया जाता है। कारण लॉग में लिखा जाता है।
यदि आप Shipping > Carriers में कैरियर को उसके ऑर्डर होने के बाद संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।
मॉड्यूल केवल दरों की गणना करता है। यह Purolator शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, रिटर्न नहीं संभालता और पार्सल ट्रैक नहीं करता। यह Full Estimate (आयाम, कई पीस, सिग्नेचर या खतरनाक सामान जैसे विकल्प) इस्तेमाल नहीं करता, डिलीवरी तिथियाँ नहीं दिखाता, कई सेवाओं को अलग-अलग कैरियर के रूप में नहीं दिखाता, और विनिमय दरें अपने-आप नहीं लाता।
ऑर्डर
जब लाइव Purolator दर के साथ ऑर्डर दिया जाता है, तो सेवा ऑर्डर के साथ सेव होती है। बाद में कार्ट की पुनर्गणना इसे नहीं बदलती। बैक ऑफिस में ऑर्डर पेज (Orders > Orders, ऑर्डर खोलें) पर एक Purolator ब्लॉक Purolator service (नाम और कोड) और Live rate (excl. tax) दिखाता है। निश्चित कीमतों या मुफ़्त शिपिंग वाले ऑर्डर में यह ब्लॉक नहीं होता।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Purolator, मॉड्यूल के Modules > Module Manager > VibeFox Purolator > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में डालें और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी डालने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए) दिखते हैं। उनके नीचे Product: presta-shipping-purolator वाली पंक्ति और आपके 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 खाते में खाली करें।
सक्रिय कुंजी के बिना Purolator कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता, और कोई दर न माँगी जाती है न गणना की जाती है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager पर Alerts टैब में एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस समाप्त होता है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप फिर से जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron job नहीं चाहिए। मॉड्यूल अनइंस्टॉल या Reset करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
चेकआउट पर Purolator नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Purolator चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है (या Ignore shipping zones चालू है और देश अनुमत है)। वज़न सीमाएँ और Minimum order amount जाँचें। यदि Purolator कोई दर नहीं देता, तो कैरियर केवल देश की कीमत, * पंक्ति या Fallback price होने पर दिखता है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।
लाइव दरें नहीं दिखतीं: मॉड्यूल पेज पर Log फ़ील्ड देखें। API त्रुटियाँ हमेशा वहाँ होती हैं। विवरण के लिए Debug log चालू करें और चेकआउट रीलोड करें। API कुंजियों के साथ पते में मान्य पोस्टल कोड (कनाडा) या ZIP कोड (USA) होना चाहिए। सेटिंग्स के ऊपर की चेतावनियाँ भी जाँचें।
लॉग में HTTP 401: API कुंजी या पासवर्ड चुने गए वातावरण से मेल नहीं खाता। डेवलपमेंट कुंजियाँ केवल Development environment चालू होने पर, और प्रोडक्शन कुंजियाँ केवल उसके बंद होने पर काम करती हैं।
दर Purolator वेबसाइट से अलग है: Quick Estimate आपके बिलिंग खाते की दरें और बिना डायमेंशनल वज़न के, पाउंड की पूरी इकाइयों तक ऊपर पूर्णांकित कुल वज़न का उपयोग करता है। कनाडाई पतों के लिए कुल योग में बिक्री टैक्स शामिल होते हैं; यदि कैरियर के पास टैक्स नियम है तो Canadian sales taxes इस्तेमाल करें। कीमतें आपकी CAD → (shop currency) rate से बदली जाती हैं।
सेव के बाद एक मान गायब हो गया: Save के बाद दिखी चेतावनी पढ़ें। वह मान 0 या उससे अधिक संख्या नहीं था, इसलिए सेव नहीं हुआ। उसे सादी संख्या के रूप में फिर से दर्ज करें।
बदलाव के बाद दरें पुरानी लगती हैं: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश की गई Purolator दरें साफ़ हो जाती हैं।
पेज कहता है कि Purolator कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटा दिया गया है। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox Purolator के बगल का मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। कैश की गई दरें हमेशा हटाई जाती हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटाया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, ऑर्डरों में सहेजी गई Purolator सेवाएँ और लॉग हटाए जाते हैं। यदि यह बंद है, तो कैरियर केवल निष्क्रिय किया जाता है और सभी सेटिंग्स रखी जाती हैं; दिए गए ऑर्डर अपनी Purolator सेवा रखते हैं। मॉड्यूल फिर से इंस्टॉल करने या Reset करने पर कैरियर को पहले वाली स्थिति वापस मिल जाती है।
Purolator उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Purolator से संबद्ध नहीं है और Purolator द्वारा अनुमोदित नहीं है।