VibeFox DHL Packstation for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x। Classic और Hummingbird थीम समर्थित हैं।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।
DHL API key: स्थानों की सूची मुफ़्त DHL Location Finder API से आती है। DHL डेवलपर पोर्टल (developer.dhl.com) पर पंजीकरण करें, एक ऐप बनाएँ, "Location Finder - Unified" API जोड़ें और ऐप की API कुंजी कॉपी करें। इस API के लिए DHL के साथ व्यावसायिक अनुबंध की ज़रूरत नहीं है। कुंजी के बिना चेकआउट में कैरियर छिपा रहता है। अपने DHL ऐप की अनुरोध सीमा का ध्यान रखें: हर नई पिनकोड या शहर खोज एक API अनुरोध होती है।
VibeFox license key: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox DHL Packstation ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी दर्ज करें, फिर Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. DHL API कुंजी पेस्ट करें, Save पर क्लिक करें, फिर Test API key पर क्लिक करें। स्थान प्रकार चुनें और देश के अनुसार कीमतें दर्ज करें (देखें कॉन्फ़िगरेशन)।
इंस्टॉल के समय मॉड्यूल Delivery to a DHL Packstation or post office डिलीवरी समय टेक्स्ट के साथ DHL Packstation कैरियर बनाता है। कैरियर सक्षम होता है, सभी ग्राहक समूहों और डिफ़ॉल्ट मूल्य सूची के देशों, यानी जर्मनी और ऑस्ट्रिया के ज़ोन को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। कीमतें वहाँ न रखें: कीमत हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox DHL Packstation > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। यदि किसी फ़ील्ड में त्रुटि है (अमान्य या ऋणात्मक संख्या, Min weight (kg) का Max weight (kg) से बड़ा होना, 64 अक्षरों से लंबा नाम), तो कुछ भी सेव नहीं होता और त्रुटि ऊपर दिखती है। हर सेव स्थान कैश को साफ़ करता है।
सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं: जब कैरियर नहीं मिला; जब स्टोर की वज़न इकाई (International > Localization, Local units) मॉड्यूल को ज्ञात नहीं है (तब वज़न kg माना जाता है; kg, g, lb या oz इस्तेमाल करें); जब DHL API कुंजी खाली है; जब कोई स्थान प्रकार सक्षम नहीं है; और जब देश कीमत की प्रविष्टियाँ CC:PRICE प्रारूप में नहीं हैं (ये प्रविष्टियाँ अनदेखी की जाती हैं)।
सामान्य
कैरियर के ग्राहक समूह, ज़ोन और आकार सीमाएँ Shipping > Carriers में सेट होते हैं। नीचे की सेटिंग्स हर ज़ोन पर लागू होती हैं।
Enable/Disable: कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।
Name: ग्राहक को दिखाया जाने वाला कैरियर नाम। डिफ़ॉल्ट: DHL Packstation। आवश्यक, अधिकतम 64 अक्षर।
Tax: कैरियर का टैक्स नियम, या No tax। PrestaShop यह टैक्स नीचे की कीमतों पर जोड़ता है। No tax के साथ कीमतें अंतिम होती हैं।
DHL Location Finder API
DHL API key: developer.dhl.com पर आपके ऐप की "API Key"। इसके बिना कैरियर चेकआउट में छिपा रहता है। सेव करने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलना हो तो नया मान दर्ज करें।
Remove the saved API key: यह बॉक्स चुनें और सेव करें, तो सहेजी गई कुंजी हट जाती है।
Connection test: Test API key बटन सहेजी गई कुंजी से 53113 Bonn के पास के स्थान खोजता है और स्थान कैश साफ़ करता है। पहले सेटिंग्स सेव करें। यह बताता है कि कितने स्थान मिले, DHL ने कुंजी अस्वीकार की (401/403) या API ने सही उत्तर नहीं दिया (विवरण डीबग लॉग में)।
पिकअप स्थान
चेकआउट पर ग्राहक अपने डिलीवरी पिनकोड के पास के स्थान देखता है और कोई दूसरा पिनकोड या शहर खोज सकता है।
Location types: कौन-से DHL स्थान ग्राहक चुन सकता है: Packstation (parcel locker), Post Office (Postfiliale) और DHL Parcel Shop (Paketshop)। डिफ़ॉल्ट रूप से तीनों चुने होते हैं। यदि कोई भी चुना न हो, तो कैरियर छिप जाता है। Packstation के लिए ग्राहक को अपना DHL Postnummer दर्ज करना होता है।
Search radius (meters): खोजे गए पिनकोड या शहर के चारों ओर का दायरा। डिफ़ॉल्ट: 5000। पूर्ण संख्या; 100 से कम या 25000 m (DHL की अधिकतम सीमा) से ज़्यादा मान इस सीमा तक समायोजित किए जाते हैं।
Max results: हर खोज में दिखाए जाने वाले स्थानों की अधिकतम संख्या। डिफ़ॉल्ट: 20। पूर्ण संख्या; DHL 50 तक की अनुमति देता है, इससे बड़े मान 50 तक घटाए जाते हैं।
Shipping address: चुने हुए स्थान को ऑर्डर का डिलीवरी पता बनाता है। डिफ़ॉल्ट रूप से चालू। पता पंक्ति 1 उदाहरण के लिए "Packstation 105" (या Post Office या Parcel Shop के लिए "Postfiliale 502") बन जाती है, पंक्ति 2 नंबर के साथ "Postnummer" होती है, और स्थान का पिनकोड, शहर और देश जुड़ जाते हैं, ताकि ऑर्डर से प्रिंट किए गए लेबल सही जगह पहुँचें। नाम, कंपनी और फ़ोन ग्राहक के पते से आते हैं। नया पता केवल इस ऑर्डर के लिए इस्तेमाल होता है और ग्राहक की एड्रेस बुक में नहीं दिखता।
कीमतें (सेक्शन शीर्षक में आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखती है)
Country prices: गंतव्य देश के अनुसार कीमत, स्टोर की डिफ़ॉल्ट मुद्रा में, कर को छोड़कर, CC:PRICE प्रारूप में, अल्पविराम या नई पंक्ति से अलग की गई। डिफ़ॉल्ट: DE:4.99, AT:5.99। दशमलव अल्पविराम भी चलता है (DE:4,99)।
Other countries: ऐसे गंतव्य देश की कीमत जो Country prices में नहीं है। डिफ़ॉल्ट: 5.99। ऐसे देशों के लिए कैरियर छिपाने हेतु इसे खाली छोड़ें।
Calculation: Per order कीमत एक बार लेता है। Per item (price x quantity) इसे कार्ट के आइटमों की संख्या से गुणा करता है।
Free shipping from: कार्ट का सबटोटल (शिपिंग की ज़रूरत वाले उत्पाद, छूट के बाद, टैक्स से पहले) जिससे यह शिपिंग मुफ़्त होती है। कभी मुफ़्त न करनी हो तो खाली छोड़ें।
उपलब्धता
Min weight (kg): कार्ट का न्यूनतम वज़न। उत्पादों के वज़न आपके स्टोर की वज़न इकाई से बदले जाते हैं। 0 का अर्थ है कोई सीमा नहीं।
Max weight (kg): इस कार्ट वज़न से ऊपर कैरियर छिप जाता है। डिफ़ॉल्ट: 31.5, क्योंकि Packstation 31.5 kg तक के पार्सल लेता है। 0 का अर्थ है कोई सीमा नहीं।
Minimum subtotal: कैरियर तभी दिखाएँ जब कार्ट का सबटोटल (शिपिंग की ज़रूरत वाले उत्पाद, छूट के बाद, टैक्स से पहले) कम से कम इस मान के बराबर हो। हमेशा दिखाने के लिए खाली छोड़ें।
Ignore shipping zones: चालू होने पर कैरियर हर सक्रिय ज़ोन (बाद में बनाए गए ज़ोन भी) से जुड़ता है और नीचे दिए देशों के लिए दिया जाता है, या सूची खाली हो तो सभी देशों के लिए। फिर से बंद करने पर कैरियर को वे ज़ोन वापस मिल जाते हैं जो उसके पास पहले थे।
Countries (ignore zones): इस मोड के लिए गंतव्य देश। कई देश चुनने के लिए Ctrl/Cmd + क्लिक करें। यह केवल Ignore shipping zones के साथ इस्तेमाल होता है।
एडवांस्ड
Debug log: API अनुरोध और चेकआउट चरण मॉड्यूल फ़ोल्डर में logs/vfd_dhlp_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। यह बंद होने पर भी API त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजी, Postnummer और ग्राहक के पते कभी नहीं लिखे जाते।
Log: डीबग लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर मॉड्यूल हटाने पर सेटिंग्स, कैरियर, कैश की गई खोजें और लॉग हट जाते हैं। चुने गए स्थान ऑर्डर में बने रहते हैं। बंद होने पर फिर से इंस्टॉल करने के लिए सब कुछ रखा जाता है।
चेकआउट पर कैसे काम करता है
डिलीवरी चरण पर PrestaShop मॉड्यूल से DHL Packstation की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल जाँचता है कि API कुंजी और कम से कम एक स्थान प्रकार सेट है, अनुमत देश (Ignore shipping zones के साथ), कार्ट का वज़न और न्यूनतम सबटोटल। फिर वह गंतव्य देश की कीमत (या अन्य देशों की कीमत) लेता है और यदि सबटोटल पर्याप्त ऊँचा है तो मुफ़्त शिपिंग लागू करता है। कीमत स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है और ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
यदि कैरियर के ऑर्डर आने के बाद आप Shipping > Carriers में उसे संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल अपने-आप नए संस्करण का पालन करता है।
मॉड्यूल DHL शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता और पार्सल ट्रैक नहीं करता। DHL बिज़नेस कस्टमर पोर्टल या लेबल टूल इस्तेमाल करें: Shipping address चालू होने पर ऑर्डर में पहले से Packstation का पता और Postnummer होता है। मॉड्यूल लाइव DHL दरों की गणना नहीं करता और कोई मैप नहीं दिखाता। Packstation नंबर को हाथ से दर्ज करने की सुविधा नहीं है।
पिकअप स्थान
जब ग्राहक DHL Packstation चुनता है, तो कैरियर के नीचे एक चयनकर्ता दिखता है। डिलीवरी पिनकोड और शहर के पास के DHL स्थान लोड होते हैं। DHL से केवल चुने गए कैरियर के लिए पूछा जाता है। ग्राहक कोई दूसरा पिनकोड या शहर लिखकर Search पर क्लिक कर सकता है। स्थान प्रकार (Packstation, Post Office, Parcel Shop) के अनुसार समूहित होते हैं और दूरी के अनुसार क्रमबद्ध होते हैं। यदि कुछ न मिले, तो ग्राहक को No DHL locations found near "…". Try another postcode or city. दिखता है।
Packstation के लिए ग्राहक को DHL Postnummer दर्ज करना होता है, यानी उसका 6-12 अंकों का DHL ग्राहक नंबर, जो DHL ऐप या DHL खाते में होता है। अन्य स्थानों के लिए यह वैकल्पिक है। चुनाव होते ही कार्ट में सहेजा जाता है। Continue पर सर्वर इसे फिर जाँचता है: स्थान डिलीवरी देश में DHL खोज परिणामों में से एक होना चाहिए। स्थान न होने पर ग्राहक को Please choose a DHL Packstation or post office for delivery. दिखता है और वह आगे नहीं बढ़ सकता। गायब या अमान्य Postnummer की सूचना भी इसी तरह दी जाती है।
खोज परिणाम 12 घंटे के लिए कैश होते हैं। खाली या विफल खोज 10 मिनट के लिए कैश होती है, ताकि हर रीफ़्रेश पर चेकआउट DHL का इंतज़ार न करे। API टाइमआउट 12 सेकंड है। यदि DHL API तक पहुँच नहीं हो पाती, तो ग्राहक को DHL locations cannot be loaded right now. Please try again later or choose another shipping method. दिखता है। ग्राहक द्वारा पहले से चुना गया स्थान फिर भी स्वीकार होता है।
ऑर्डर देने पर स्थान (ID, प्रकार, नंबर, नाम, पता) और Postnummer ऑर्डर के साथ सहेजे जाते हैं। यदि Shipping address चालू है, तो ऑर्डर का डिलीवरी पता स्थान के पते से बदल दिया जाता है। स्थान ऑर्डर पुष्टि पेज पर, ग्राहक खाते में Order history and details में, और ऑर्डर पुष्टि ईमेल तथा Mail alerts मॉड्यूल के नए ऑर्डर ईमेल में दिखाया जाता है; कैरियर के नाम में DHL pickup location और DHL Postnummer के लेबल जोड़े जाते हैं।
बैक ऑफ़िस के ऑर्डर पेज पर DHL pickup location ब्लॉक स्थान, उसका प्रकार और ID, तथा Postnummer दिखाता है। Change पर क्लिक करें, पिनकोड या शहर से खोजें, कोई दूसरा स्थान चुनें, Postnummer बदलें और Save location पर क्लिक करें। आप केवल Postnummer भी बदल सकते हैं। हर बदलाव ऑर्डर में एक निजी संदेश जोड़ता है: DHL pickup location changed to: …। यदि Shipping address चालू है, तो ऑर्डर का डिलीवरी पता भी अपडेट होता है। स्थान बदलने के लिए ऑर्डर संपादित करने की अनुमति चाहिए; Modules पेज की पहुँच ज़रूरी नहीं है। यदि एक ही कार्ट से कई ऑर्डर बने हैं, तो स्थान केवल पहले ऑर्डर का होता है; उसी कार्ट के किसी दूसरे ऑर्डर पर Change दबाने पर The DHL location of this cart belongs to another order of the same cart - nothing was changed. दिखता है।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox DHL Packstation लाइसेंस ब्लॉक Modules > Module Manager > VibeFox DHL Packstation > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। License key में कुंजी दर्ज करके Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी छिपाकर (मास्क करके) दिखती है, स्थिति (जैसे लाइसेंस की अवधि की अंतिम तिथि और आपका डोमेन) दिखती है, और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-shipping-dhl-packstation वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना DHL Packstation कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर भी नहीं गिनी जाती। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे जाँच नहीं सकते। Modules > Module Manager में Alerts टैब पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की अवधि खत्म होने पर भी मॉड्यूल चलता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। मॉड्यूल को अनइंस्टॉल करने पर हमेशा लाइसेंस कुंजी और लाइसेंस स्थिति हट जाती है। Reset डेटा नहीं हटाता, इसलिए कुंजी और स्थिति बनी रहती है।
समस्या निवारण
चेकआउट पर DHL Packstation नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है (या Ignore shipping zones चालू करके Countries (ignore zones) जाँचें)। जाँचें कि DHL API key भरी है, कम से कम एक स्थान प्रकार चुना गया है, गंतव्य देश की कीमत है (या Other countries सेट है), और वज़न तथा सबटोटल के नियम इसे नहीं छिपा रहे। उत्पाद पेज पर उत्पादों को कुछ कैरियरों तक सीमित किया गया हो सकता है।
कोई स्थान नहीं दिखता: Test API key पर क्लिक करें। यदि DHL कुंजी अस्वीकार करता है (401/403), तो कुंजी और अपने ऐप में "Location Finder - Unified" API जाँचें। Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। जाँचें कि आपके DHL ऐप की अनुरोध सीमा पूरी नहीं हुई है।
किसी पते के पास कोई स्थान नहीं: Search radius (meters) या Max results बढ़ाएँ, या ग्राहक को कोई दूसरा पिनकोड या शहर खोजने दें। DHL डेटा में बिना नंबर वाला Packstation सूची में नहीं आता।
ग्राहक को "Enter your postcode or city to see DHL locations near you." दिखता है: डिलीवरी पते में न पिनकोड है, न शहर। ग्राहक खोज फ़ील्ड में इनमें से कोई भी लिख सकता है।
ऑर्डर पेज पर Change "Please choose a DHL location of the search - nothing was changed." दिखाता है: पिनकोड या शहर से खोजें और परिणामों में से कोई स्थान चुनें। यदि ऑर्डर में अभी तक कोई स्थान नहीं है, तो Postnummer सहेजने से पहले स्थान चुनना होगा।
पेज कहता है कि DHL Packstation कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया है। उसे फिर बनाने के लिए Modules > Module Manager में मॉड्यूल को Reset करें। Reset मौजूदा कैरियर की चालू/बंद स्थिति बनाए रखता है।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox DHL Packstation के बगल का मेन्यू खोलें और Uninstall चुनें। लाइसेंस कुंजी, लाइसेंस स्थिति और स्थान कैश हमेशा हटाए जाते हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटाया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग तथा बिना ऑर्डर वाली कार्ट के स्थान भी हटाए जाते हैं। यदि बंद है, तो कैरियर केवल निष्क्रिय होता है और सभी सेटिंग्स रखी जाती हैं। मॉड्यूल फिर से इंस्टॉल करने पर कैरियर की पिछली स्थिति लौट आती है। चुने गए स्थान हमेशा ऑर्डर में रहते हैं।
DHL और Packstation उनके संबंधित स्वामियों के ट्रेडमार्क हैं। यह मॉड्यूल DHL से संबद्ध नहीं है और DHL द्वारा अनुमोदित नहीं है।