VibeFox DHL Africa for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: cURL एक्सटेंशन के साथ 8.0 या उसके बाद। पुराने PHP संस्करणों पर या cURL के बिना मॉड्यूल इंस्टॉल नहीं होता। DHL XML Services को PHP SimpleXML एक्सटेंशन भी चाहिए।
DHL Express खाता (केवल लाइव दरों के लिए): लाइव दरें MyDHL API का उपयोग करती हैं। आपको अपनी DHL Express खाता संख्या और MyDHL API क्रेडेंशियल चाहिए: एक API key और एक API secret। इन्हें DHL Developer Portal (MyDHL API, "Get access") पर या अपने DHL Express खाता प्रबंधक से माँगा जा सकता है। जिन खातों के पास अभी भी DHL XML Services क्रेडेंशियल (Site ID और पासवर्ड) हैं, वे उनके बजाय उन्हें इस्तेमाल कर सकते हैं। यदि आप केवल फ़ॉलबैक कीमतें इस्तेमाल करते हैं, तो DHL क्रेडेंशियल की ज़रूरत नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox DHL Africa ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के सबसे ऊपर लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी दर्ज करें, फिर Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. DHL API चुनें, API key, API secret और अपना DHL खाता नंबर दर्ज करें। टेस्ट क्रेडेंशियल इस्तेमाल करते समय Test mode चालू रखें। Ship from पता दर्ज करें। यदि आपका DHL खाता स्टोर की डिफ़ॉल्ट मुद्रा में बिल नहीं होता, तो DHL quote currency और Exchange rate सेट करें। वैकल्पिक रूप से देश की कीमतें और फ़ॉलबैक लागत सेट करें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।
इंस्टॉल होने पर मॉड्यूल DHL Express courier डिलीवरी समय पाठ के साथ DHL Express कैरियर बनाता है। कैरियर सभी ज़ोन और सभी ग्राहक समूहों को दिया जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox DHL Africa > Configure। वे कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव से कैश्ड DHL कोटेशन भी साफ़ हो जाते हैं। कीमतें और वज़न दशमलव कॉमा या बिंदु, दोनों स्वीकार करते हैं।
पेज के ऊपर की चेतावनियाँ बताती हैं कि लाइव दरें कब बंद हैं, क्योंकि API key, API secret या खाता नंबर गायब है (या XML Services के साथ Site ID या पासवर्ड गायब है), जब मूल देश या शहर गायब है, जब XML Services चुनी गई हैं (DHL इन्हें बंद कर रहा है), जब बिना विनिमय दर के कोटेशन मुद्रा सेट है, और जब International > Localization (Local units) में स्टोर की वज़न या आकार की इकाई मॉड्यूल को ज्ञात नहीं है (तब उसे kg या cm माना जाता है)। सेव करते समय यदि कोई मान वैध नहीं है (खाली नाम या 64 अक्षरों से लंबा नाम, अमान्य या ऋणात्मक संख्या, 0 विनिमय दर, न्यूनतम वज़न का अधिकतम वज़न से बड़ा होना, कोटेशन मुद्रा, मूल देश या टैक्स नियम), तो एक त्रुटि उस फ़ील्ड का नाम बताती है, उस फ़ील्ड का पिछला मान रखा जाता है, और बाकी सेटिंग्स सेव हो जाती हैं।
सामान्य
Enable DHL Express Africa: कैरियर चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।
Name: चेकआउट पर ग्राहक को दिखने वाला कैरियर नाम। डिफ़ॉल्ट: DHL Express। आवश्यक, 64 अक्षरों तक।
Tax: कैरियर का टैक्स नियम, या No tax। टैक्स नियम होने पर (और स्टोर में टैक्स चालू होने पर) DHL की दर से वह टैक्स घटाकर ली जाती है जो DHL कोट करता है, और PrestaShop अपना टैक्स जोड़ता है। No tax के साथ DHL दर वैसे ही ली जाती है जैसे कोट की गई है, टैक्स सहित।
DHL Express खाता (केवल लाइव दरों के लिए आवश्यक)
DHL API: कौन सा DHL इंटरफ़ेस इस्तेमाल होता है। केवल चुनी गई API के फ़ील्ड दिखते हैं।
API key: आपका MyDHL API यूज़रनेम (API key)।
API secret: आपका MyDHL API पासवर्ड (API secret)। सेव करने के बाद API key और API secret फ़ील्ड खाली रहते हैं और Saved — leave empty to keep it. दिखाते हैं। केवल बदलने के लिए नया मान दर्ज करें।
Remove the saved API key and API secret: केवल तब दिखता है जब कोई key या secret सेव हो। इसे चालू करके Save पर क्लिक करें, तो दोनों मिट जाते हैं।
XML Site ID: आपका DHL XML Services Site ID (केवल पुरानी API के लिए)। इसे खाली करने पर सेव किया गया XML पासवर्ड भी हट जाता है।
XML password: आपका DHL XML Services पासवर्ड (केवल पुरानी API के लिए)। API secret की तरह यह सेव करने के बाद दोबारा नहीं दिखाया जाता।
DHL account number: आपका DHL Express खाता नंबर (9 अंक)। MyDHL API को यह चाहिए। XML Services के साथ यह प्रकाशित दरों के बजाय आपके खाते की दरें लौटाता है।
Test mode: DHL के टेस्ट वातावरण का उपयोग करता है। डिफ़ॉल्ट रूप से चालू। टेस्ट क्रेडेंशियल केवल टेस्ट वातावरण में और प्रोडक्शन क्रेडेंशियल केवल प्रोडक्शन में काम करते हैं। लाइव जाते समय इसे बंद करें।
Ship from
वह पता जहाँ से DHL पार्सल उठाता है। दर इसी पर निर्भर करती है।
Origin country: वह देश जहाँ से आप शिपिंग करते हैं।
Origin city: वह शहर जहाँ से आप शिपिंग करते हैं, उदाहरण के लिए Johannesburg। MyDHL API को यह चाहिए।
Origin postcode: पोस्टल कोड न होने वाले देशों (उदाहरण के लिए केन्या, नाइजीरिया, घाना) के लिए खाली छोड़ें।
दरें
सभी कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स को छोड़कर हैं। लाइव दर पार्सल के लिए सबसे सस्ता DHL Express उत्पाद है। यदि DHL कॉन्फ़िगर नहीं है, विफल होता है, या रूट के लिए कोई सेवा नहीं है, तो देश की कीमत इस्तेमाल होती है, फिर फ़ॉलबैक लागत। दोनों न हों तो कैरियर छिपा रहता है।
DHL quote currency: DHL आपके DHL खाते के देश की मुद्रा में कोटेशन देता है (उदाहरण के लिए ZAR, NGN या KES)। यदि DHL आपके स्टोर की डिफ़ॉल्ट मुद्रा में राशि नहीं लौटाता, तो लाइव दर को इस मुद्रा से नीचे दी गई विनिमय दर से बदला जाता है। अन्यथा उसका उपयोग नहीं होता। डिफ़ॉल्ट: — None —।
Exchange rate: DHL कोटेशन मुद्रा की 1 इकाई आपके स्टोर की डिफ़ॉल्ट मुद्रा में कितनी है, उदाहरण के लिए 1 ZAR = 0.05। यह 0 से बड़ा होना चाहिए। बदलाव न चाहिए तो खाली छोड़ें। विनिमय दर एक मैन्युअल सेटिंग है।
Fallback cost: जब न लाइव दर हो न देश की कीमत, तब लागू होने वाली निश्चित लागत। उस स्थिति में कैरियर छिपाने के लिए खाली छोड़ें।
Country prices: गंतव्य देश के हिसाब से फ़ॉलबैक कीमत, हर पंक्ति में एक: CC:Price, उदाहरण के लिए ZA:25.00। लाइव दर न होने पर इस्तेमाल होती है। किसी और फ़ॉर्मैट की पंक्तियाँ अनदेखी की जाती हैं, और सेव करते समय की चेतावनी उन्हें सूचीबद्ध करती है।
Fallback price basis: Per order कीमत एक बार लेता है। Per item (multiplied by the cart quantity) उसे कार्ट की मात्रा से गुणा करता है। यह केवल देश की कीमत और फ़ॉलबैक लागत पर लागू होता है। DHL की लाइव दर हमेशा पूरे पार्सल के लिए होती है।
Free shipping from: कार्ट का उप-योग (शिपिंग वाले उत्पाद, छूट के बाद, टैक्स से पहले) जिस राशि से यह कैरियर मुफ़्त है। DHL से पूछा नहीं जाता। कभी मुफ़्त न होने के लिए खाली छोड़ें।
शर्तें
Minimum weight: इस कार्ट वज़न से कम होने पर कैरियर छिपाता है, kg में। 0 का अर्थ कोई सीमा नहीं। यह Maximum weight से अधिक नहीं हो सकता।
Maximum weight: इस कार्ट वज़न से ऊपर होने पर कैरियर छिपाता है, kg में। डिफ़ॉल्ट: 70 (फ़ील्ड खाली होने पर भी यही इस्तेमाल होता है)। 0 का अर्थ कोई सीमा नहीं।
Minimum subtotal: कैरियर केवल तभी दिखाता है जब कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: आपके द्वारा कैरियर को ज़ोन असाइन किए बिना उसे पेश करता है। कैरियर को हर ज़ोन मिलता है, जिनमें बाद में बनाए गए ज़ोन भी शामिल हैं, और फ़ैसला नीचे के देश करते हैं। इसे बंद करने पर कैरियर को उसके अपने ज़ोन वापस मिल जाते हैं।
Countries: इस मोड के लिए गंतव्य देश। जिन सभी देशों में आप शिपिंग करते हैं, उन्हें अनुमति देने के लिए खाली छोड़ें। यह केवल Ignore shipping zones के साथ इस्तेमाल होता है।
उन्नत
Debug log: दर गणनाएँ मॉड्यूल फ़ोल्डर में logs/vfd_dhla_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। यह बंद होने पर भी DHL की त्रुटियाँ हमेशा दर्ज होती हैं। क्रेडेंशियल और ग्राहक के पते कभी दर्ज नहीं होते।
Log: डीबग लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर मॉड्यूल हटाने से सेटिंग्स, कैरियर, ऑर्डरों के सेव किए DHL उत्पाद और लॉग मिट जाते हैं। बंद होने पर पुनः इंस्टॉल के लिए सब कुछ रखा जाता है।
चेकआउट पर यह कैसे काम करता है
शिपिंग चरण पर PrestaShop मॉड्यूल से DHL Express कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। मॉड्यूल पहले शर्तें जाँचता है: Ignore shipping zones के देश, कार्ट वज़न और न्यूनतम उप-योग। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और DHL को कोई अनुरोध नहीं भेजा जाता।
अन्यथा मॉड्यूल DHL को मूल और गंतव्य (देश, शहर, पोस्टल कोड), kg में बदला गया कार्ट वज़न (कम से कम 0.5 kg), और उत्पाद आयामों से cm में बना एक बॉक्स भेजता है: सबसे लंबी लंबाई, सबसे चौड़ी चौड़ाई और एक-दूसरे पर रखी ऊँचाइयाँ। बिना आयाम वाले उत्पाद कुछ नहीं जोड़ते। यदि किसी उत्पाद के आयाम नहीं हैं, तो 10 x 10 x 10 cm का बॉक्स इस्तेमाल होता है। दूसरे देश की शिपमेंट को कस्टम के लिए घोषित किया जाता है, जिसका घोषित मूल्य कार्ट उप-योग होता है। घरेलू शिपमेंट घोषित नहीं होतीं। पिकअप की तारीख आज है, या सप्ताहांत पर सोमवार। लाइव दर तभी माँगी जाती है जब ग्राहक शहर दर्ज कर चुका हो (XML Services के साथ शहर या पोस्टल कोड)। उससे पहले फ़ॉलबैक कीमतें लागू होती हैं।
सबसे सस्ता DHL Express उत्पाद आपके कैरियर नाम के साथ एक कीमत के रूप में दिखाया जाता है। ग्राहक को DHL उत्पाद नहीं दिखता। कीमत डिफ़ॉल्ट मुद्रा में गणना की जाती है, गोल की जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
हर कोटेशन प्रति पार्सल और मार्ग 1 घंटे तक कैश होता है। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि हर रिफ़्रेश पर चेकआउट DHL का इंतज़ार न करे। API टाइमआउट 12 सेकंड है। यदि DHL त्रुटि लौटाता है, कोई सेवा नहीं देता, या किसी अनुपयोगी मुद्रा में जवाब देता है, तो ग्राहक को कोई त्रुटि नहीं दिखती: फ़ॉलबैक कीमत इस्तेमाल होती है या कैरियर छिप जाता है। कारण डीबग लॉग में लिखा जाता है।
यदि आप Shipping > Carriers में कैरियर को उसके ऑर्डर होने के बाद बदलते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण को अपने आप फ़ॉलो करता है।
मॉड्यूल केवल दरें गिनता है। यह DHL शिपमेंट नहीं बनाता, वाणिज्यिक इनवॉइस या लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता, DHL सर्विस पॉइंट नहीं देता, ग्राहक को DHL उत्पादों के बीच चुनने नहीं देता, कई बॉक्स पैक नहीं करता, बीमा नहीं जोड़ता, और शुल्क व टैक्स का अनुमान नहीं लगाता। कोटेशन केवल शिपिंग के लिए है। शुल्क और आयात कर प्राप्तकर्ता चुकाता है।
ऑर्डर
ऑर्डर देने पर मॉड्यूल अपनी कार्ट के लिए गणना की गई दर सुरक्षित रखता है। बैक ऑफ़िस के ऑर्डर पेज पर तब एक DHL Express Africa ब्लॉक दिखता है, ताकि आप जानें कि DHL के साथ क्या बुक करना है:
DHL product: लाइव दर का DHL Express उत्पाद, उदाहरण के लिए "EXPRESS WORLDWIDE (P)"। केवल लाइव दरों के लिए दिखता है।
Price source: Live DHL rate, Fallback price (no live rate) या Free shipping threshold।
Calculated price (excl. tax): आपके स्टोर की डिफ़ॉल्ट मुद्रा में कीमत।
बाद में कार्ट की दोबारा गणना, उदाहरण के लिए बैक ऑफ़िस में ऑर्डर बदलने पर, ये मान नहीं बदलती। जो कार्ट कभी ऑर्डर नहीं बने, उनकी दरें 30 दिन बाद हटा दी जाती हैं।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox DHL Africa लाइसेंस ब्लॉक Modules > Module Manager > VibeFox DHL Africa > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। License key में कुंजी दर्ज करके Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी छिपाकर (मास्क करके) दिखती है, स्थिति (जैसे लाइसेंस की अवधि की अंतिम तिथि और आपका डोमेन) दिखती है, और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-shipping-dhl-africa वाली पंक्ति और 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 Express कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर भी नहीं गिनी जाती। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे जाँच नहीं सकते। Modules > Module Manager में Alerts टैब पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की अवधि खत्म होने पर भी मॉड्यूल चलता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर हमेशा लाइसेंस कुंजी और लाइसेंस स्थिति हट जाती है।
समस्या निवारण
चेकआउट पर DHL Express दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable DHL Express Africa चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू करके Countries जाँचें)। वज़न सीमाएँ और Minimum subtotal जाँचें। लाइव दर के बिना कैरियर तभी दिखता है जब देश की कीमत या फ़ॉलबैक लागत सेट हो। उत्पाद पेज पर उत्पाद कुछ कैरियरों तक सीमित भी हो सकते हैं।
लाइव दरें नहीं दिख रहीं: मॉड्यूल पेज के ऊपर की चेतावनियाँ देखें (क्रेडेंशियल या मूल गायब)। Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। DHL त्रुटियाँ, जैसे MyDHL API की HTTP त्रुटि, रूट के लिए कोई उत्पाद न होना या मुद्रा की समस्या, हमेशा दर्ज होती हैं। जाँचें कि Test mode आपके क्रेडेंशियल से मेल खाता है और ग्राहक के पते में शहर है।
DHL ZAR, NGN या KES में दर लौटाता है, लेकिन मेरा स्टोर दूसरी मुद्रा इस्तेमाल करता है: लॉग में DHL quote not usable लिखा होता है। DHL quote currency को उस मुद्रा पर सेट करें और Exchange rate दर्ज करें। इसके बिना लाइव दर इस्तेमाल नहीं होती और फ़ॉलबैक कीमतें लागू होती हैं।
मेरे पास पुराने DHL XML Services क्रेडेंशियल हैं: DHL API में XML Services (legacy) चुनें। MyDHL क्रेडेंशियल मिलने पर MyDHL API पर जाएँ।
शिपिंग पर टैक्स दो बार लगता है: Tax में टैक्स नियम सेट करें ताकि DHL दर DHL के VAT को घटाकर ली जाए, या No tax चुनें ताकि DHL राशि जैसी कोट की गई है वैसे ही ली जाए।
बदलाव के बाद दरें पुरानी लगती हैं: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश्ड DHL कोटेशन साफ़ हो जाते हैं।
पेज कहता है कि DHL Express कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया जा चुका है। उसे दोबारा बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।
डेवलपर्स के लिए मॉड्यूल API पता, कस्टम घोषणा, बॉक्स और DHL अनुरोधों को बदलने हेतु hooks actionVfdDhlaApiUrl, actionVfdDhlaIsDutiable, actionVfdDhlaPackageBox, actionVfdDhlaRestRequest और actionVfdDhlaXmlRequest देता है।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox DHL Africa के बगल वाला मेन्यू खोलें और Uninstall चुनें। लाइसेंस कुंजी, लाइसेंस स्थिति और कैश्ड DHL कोटेशन हमेशा हटा दिए जाते हैं। यदि Remove data on uninstall चालू है, तो कैरियर हट जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, ऑर्डरों के सेव किए DHL उत्पाद और लॉग भी हट जाते हैं। यदि यह बंद है, तो केवल कैरियर निष्क्रिय होता है, और सेटिंग्स तथा दिए गए ऑर्डरों के DHL उत्पाद रखे जाते हैं। मॉड्यूल को फिर से इंस्टॉल करने पर कैरियर की पिछली स्थिति वापस आ जाती है।
DHL उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल DHL से संबद्ध नहीं है और न ही DHL द्वारा अनुमोदित है।