VibeFox DHL Africa for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और बाद का संस्करण (4.1.0.3 पर परीक्षित)।
PHP: cURL एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण। 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 से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_dhl_africa-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_dhl_africa.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_dhl_africa-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए आपको Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, आप पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और एक्सटेंशन का प्रकार Shipping चुनें। VibeFox DHL Africa ढूँढें और Install (हरे + बटन) पर क्लिक करें।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।
4. Edit पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी License key फ़ील्ड में डालें और Activate पर क्लिक करें (देखें License key)।
5. DHL API चुनें, API key, API secret और अपना DHL खाता नंबर दर्ज करें। टेस्ट क्रेडेंशियल इस्तेमाल करते समय Test mode चालू रखें। Ship from पता दर्ज करें। यदि आपके DHL खाते का बिल आपके स्टोर की डिफ़ॉल्ट मुद्रा में नहीं बनता, तो DHL quote currency और Exchange rate सेट करें। वैकल्पिक रूप से देश के अनुसार कीमतें और फ़ॉलबैक लागत सेट करें (देखें Configuration)। Enable DHL Express Africa चालू करें और Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_dhl_africa.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरे + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और एक्सटेंशन का प्रकार Shipping चुनें। VibeFox DHL Africa ढूँढें, Install (हरे + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 4 और 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
इंस्टॉल के बाद, जब तक आप Enable DHL Express Africa चालू करके सेव नहीं करते, तब तक यह विधि बंद रहती है। अनइंस्टॉल के बाद एक्सटेंशन को फिर से इंस्टॉल करने पर, आपकी रखी हुई DHL सेटिंग्स फिर से इस्तेमाल होती हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Shipping > VibeFox DHL Africa > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। एक Save बटन पूरे पेज को रीलोड किए बिना सेव करता है। हर सेव कैश्ड DHL कोट्स को भी साफ़ करता है। कीमतें और वज़न दशमलव कॉमा या बिंदु, दोनों स्वीकार करते हैं। केवल इस एक्सटेंशन के लिए संशोधन अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं।
पेज के ऊपर की चेतावनियाँ बताती हैं कि लाइव दरें कब बंद हैं: API key, API secret या खाता नंबर खाली होने पर (या XML Services के साथ Site ID या पासवर्ड खाली होने पर), भेजने वाला देश या शहर खाली होने पर, XML Services चुने होने पर (DHL इन्हें बंद कर रहा है), विनिमय दर के बिना कोट मुद्रा सेट होने पर, और जब स्टोर की वज़न या लंबाई की इकाई एक्सटेंशन को ज्ञात न हो (तब उत्पादों का वज़न kg और आयाम cm माने जाते हैं; System > Localisation > Weight Classes में इकाई kg वाला वज़न क्लास, या System > Localisation > Length Classes में इकाई cm वाला लंबाई क्लास जोड़ें)।
यदि सेव करते समय कोई मान मान्य नहीं है (विधि का शीर्षक खाली हो या 64 अक्षरों से लंबा हो, कोई संख्या अमान्य या ऋणात्मक हो, विनिमय दर 0 हो, न्यूनतम वज़न अधिकतम वज़न से बड़ा हो, कोट मुद्रा, भेजने वाला देश, टैक्स क्लास या जियो ज़ोन अज्ञात हो, क्रम संख्या पूर्णांक न हो), तो सेटिंग्स के ऊपर की चेतावनी फ़ील्ड का नाम बताती है, जैसे Select a valid origin country. It was not saved. उस फ़ील्ड का पिछला मान बना रहता है, और बाकी सेटिंग्स सेव हो जाती हैं।
सामान्य
Enable DHL Express Africa: चेकआउट पर DHL Express दिखाता या छिपाता है। डिफ़ॉल्ट: off।
Method title: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: DHL Express। अनिवार्य, अधिकतम 64 अक्षर।
Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। टैक्स क्लास के साथ (और स्टोर में टैक्स चालू होने पर) DHL की दर, DHL द्वारा कोट किया गया टैक्स हटाकर ली जाती है, और OpenCart अपना टैक्स जोड़ता है। No tax के साथ DHL की दर जैसी कोट की गई है, वैसे ही टैक्स सहित ली जाती है।
Sort order: चेकआउट पर शिपिंग विधियों के बीच DHL Express की स्थिति। एक पूर्णांक।
DHL Express खाता (केवल लाइव दरों के लिए ज़रूरी)
DHL API: किस DHL इंटरफ़ेस का उपयोग होता है।
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: केवल MyDHL API के लिए, और केवल तब जब कोई 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 टेस्ट वातावरण का उपयोग करता है। डिफ़ॉल्ट रूप से चालू। टेस्ट क्रेडेंशियल केवल टेस्ट वातावरण में और प्रोडक्शन क्रेडेंशियल केवल प्रोडक्शन में काम करते हैं। लाइव होने पर इसे बंद करें।
भेजने वाला पता
वह पता जहाँ से DHL पार्सल उठाता है। दर इसी पर निर्भर करती है। OpenCart स्टोर का पता मुक्त-रूप टेक्स्ट के रूप में रखता है, इसलिए मूल स्थान हमेशा यहीं दर्ज किया जाता है। इस सेक्शन का नोट आपके स्टोर का देश दिखाता है।
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 (kg) से अधिक नहीं हो सकता।
Maximum weight (kg): इस कार्ट वज़न से अधिक होने पर विधि छिपाएँ। डिफ़ॉल्ट: 70 (फ़ील्ड खाली होने पर भी यही उपयोग होता है)। 0 का अर्थ है कोई सीमा नहीं।
Minimum subtotal: विधि केवल तभी दिखाएँ जब शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, टैक्स से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
उपलब्धता
Geo zone: DHL Express केवल इस जियो ज़ोन के पतों के लिए दें। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones के साथ इसकी जाँच नहीं होती।
Ignore shipping zones: चुने गए जियो ज़ोन चाहे जो भी हो, नीचे दिए देशों के लिए विधि दें (यदि सूची खाली है तो सभी देशों के लिए)।
Countries: इस मोड के गंतव्य देश। केवल Ignore shipping zones के साथ इस्तेमाल होता है।
उन्नत
Debug log: दर गणनाएँ storage/logs/vfd_dhla_debug.log.php में लिखता है (OpenCart 4 पर system/storage/logs/vfd_dhla_debug.log.php में)। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। यह बंद होने पर भी DHL त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल, खाता नंबर और ग्राहक के पते कभी नहीं लिखे जाते। फ़ाइल 5 MB तक पहुँचने पर इसे vfd_dhla_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।
Log: डिबग लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर एक्सटेंशन को अनइंस्टॉल करने से सेटिंग्स, कैश्ड DHL कोट्स और लॉग हट जाते हैं। बंद (डिफ़ॉल्ट) होने पर, दोबारा इंस्टॉल के लिए सब कुछ रहता है। दिए गए ऑर्डरों के DHL उत्पाद हमेशा रहते हैं।
आयात / निर्यात
Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। API key, API secret और XML पासवर्ड निर्यात नहीं होते।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मानों की जाँच सामान्य सेव की तरह होती है। सेव किए गए क्रेडेंशियल बने रहते हैं।
चेकआउट पर यह कैसे काम करता है
जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से DHL Express की कीमत माँगता है। यदि कोई Geo zone सेट है (और Ignore shipping zones बंद है) और पता उससे बाहर है, तो DHL Express नहीं दिखाया जाता। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: दूसरे उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। फिर एक्सटेंशन शर्तें जाँचता है: Ignore shipping zones के देश, कार्ट का वज़न और न्यूनतम सबटोटल। सबटोटल शिपिंग की ज़रूरत वाले उत्पादों की कीमत है, कूपन छूट के बाद और टैक्स से पहले। गिफ़्ट सर्टिफ़िकेट, रिवार्ड पॉइंट और स्टोर क्रेडिट को ध्यान में नहीं रखा जाता। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और DHL को कोई अनुरोध नहीं भेजा जाता।
अन्यथा एक्सटेंशन DHL को मूल और गंतव्य (देश, शहर, पोस्टकोड), उत्पादों के वज़न क्लास से kg में बदला गया कार्ट वज़न (कम से कम 0.5 kg), और उत्पादों के आयामों से cm में बनाया गया एक बॉक्स भेजता है: सबसे लंबी लंबाई, सबसे चौड़ी चौड़ाई और एक-दूसरे पर रखी ऊँचाइयाँ। बिना आयाम वाले उत्पाद कुछ नहीं जोड़ते। यदि किसी उत्पाद में आयाम नहीं हैं, तो 10 x 10 x 10 cm का बॉक्स इस्तेमाल होता है। दूसरे देश के शिपमेंट कस्टम्स में घोषित किए जाते हैं, जिसका घोषित मूल्य कार्ट का सबटोटल होता है। घरेलू शिपमेंट घोषित नहीं होते। पिकअप की तारीख स्टोर के समय क्षेत्र के अनुसार आज होती है, या सप्ताहांत में सोमवार। लाइव दर तभी माँगी जाती है जब ग्राहक शहर दर्ज कर दे (XML Services के साथ शहर या पोस्टकोड)। उससे पहले फ़ॉलबैक कीमतें लागू होती हैं।
सबसे सस्ता DHL Express उत्पाद आपकी शिपिंग विधि के शीर्षक के साथ एक कीमत के रूप में दिखाया जाता है। ग्राहक DHL उत्पाद नहीं देखता। कीमत आपकी डिफ़ॉल्ट मुद्रा में गणना की जाती है, उस मुद्रा के दशमलव स्थानों तक गोल की जाती है, और चुने गए Tax class के टैक्स के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है।
हर कोट हर पार्सल और मार्ग के लिए 1 घंटे तक कैश होता है। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रिफ़्रेश पर DHL का इंतज़ार न करे। API टाइमआउट 12 सेकंड है। यदि DHL त्रुटि लौटाता है, कोई सेवा नहीं देता, या अनुपयोगी मुद्रा में उत्तर देता है, तो ग्राहक को कोई त्रुटि नहीं दिखती: फ़ॉलबैक कीमत इस्तेमाल होती है या विधि छिप जाती है। कारण डिबग लॉग में लिखा जाता है।
एक्सटेंशन केवल दरों की गणना करता है। यह DHL शिपमेंट नहीं बनाता, लेबल या वाणिज्यिक इनवॉइस प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता, DHL सर्विस पॉइंट नहीं देता, ग्राहक को DHL उत्पादों के बीच चुनने नहीं देता, कई बॉक्स पैक नहीं करता, बीमा नहीं जोड़ता, और शुल्क तथा करों की गणना नहीं करता। कोट केवल शिपिंग के लिए है। शुल्क और आयात कर प्राप्तकर्ता चुकाता है।
OpenCart 4 पर ग्राहक चेकआउट पेज की शिपिंग विधि वाली ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में DHL Express चुनता है। यह विधि OpenCart 3 की तरह ही काम करती है।
ऑर्डर
ऑर्डर दिए जाने पर, एक्सटेंशन उसके कार्ट के लिए गणना की गई दर रखता है। ऑर्डर को Sales > Orders में खोलें: ऑर्डर इतिहास के ऊपर का 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): आपके स्टोर की डिफ़ॉल्ट मुद्रा में कीमत।
DHL उत्पाद ग्राहक को ईमेल में या ग्राहक के ऑर्डर पेज पर नहीं दिखता। ऑर्डर में शिपिंग विधि का शीर्षक और शिपिंग लागत दिखती है, जैसे किसी भी दूसरी OpenCart शिपिंग विधि में।
OpenCart 4 पर चेकआउट एक ही ऑर्डर रखता है और ग्राहक हर बार पुष्टि करने पर उसे अपडेट करता है। तब पैनल चेकआउट की नवीनतम दर दिखाता है। यदि ग्राहक किसी दूसरी शिपिंग विधि पर चला जाता है, तो उस ऑर्डर के लिए पैनल अब नहीं दिखता।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox DHL Africa, Extensions > Extensions > Shipping > VibeFox DHL Africa > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन: Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी डालने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-shipping-dhl-africa पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। कुंजी केवल उन एडमिन उपयोगकर्ताओं द्वारा बदली जा सकती है जिनके पास इस एक्सटेंशन की Modify अनुमति है। ब्लॉक के टेक्स्ट एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या License expired on और एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में कोई डोमेन स्लॉट मुक्त करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया स्टोर का पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। स्लॉट अपने vibefox.net खाते में मुक्त करें।
सक्रिय कुंजी के बिना, DHL Express शिपिंग विधि चेकआउट पर ग्राहकों को नहीं दिखाई जाती और कोई दर नहीं गिनी जाती। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन पैनल में लॉग इन है, वह स्टोर में यह विधि अब भी देखता है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन के Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस समाप्त होता है, तब भी एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्थिति अपने-आप फिर से जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों में रोज़, फिर हर सप्ताह। इसके लिए cron job की ज़रूरत नहीं है। एक्सटेंशन को अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस की स्थिति हमेशा हटा दी जाती है।
समस्या निवारण
चेकआउट पर DHL Express नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable DHL Express Africa चालू है। Geo zone जाँचें (या Ignore shipping zones चालू करके Countries जाँचें), वज़न की सीमाएँ और Minimum subtotal जाँचें। लाइव दर के बिना विधि तभी दिखती है जब देश की कीमत या फ़ॉलबैक लागत सेट हो। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।
लाइव दरें नहीं दिखतीं: एक्सटेंशन पेज के ऊपर की चेतावनियाँ देखें (क्रेडेंशियल या मूल स्थान का गायब होना)। 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 class सेट करें ताकि DHL की दर DHL के टैक्स के बिना ली जाए, या DHL की राशि जैसी कोट हुई है वैसी लेने के लिए No tax चुनें।
बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश्ड DHL कोट्स साफ़ हो जाते हैं।
पेज पर लिखा है "Warning: You do not have permission to modify VibeFox DHL Africa!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। समूह को System > Users > User Groups में extension/shipping/vfd_dhl_africa (OpenCart 3) या extension/vfd_dhl_africa/shipping/vfd_dhl_africa (OpenCart 4) की संशोधन अनुमति दें।
डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट catalog/vfd_dhl_africa/api_url, is_dutiable, package_box, rest_request और xml_request (उसी उपसर्ग के साथ) चलाता है, जो API पता, कस्टम्स घोषणा, बॉक्स और DHL अनुरोधों को बदल सकते हैं।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox DHL Africa के बगल में Uninstall (लाल − बटन) पर क्लिक करें। OpenCart हमेशा Enable DHL Express Africa, Sort order, Tax class और Geo zone को रीसेट करता है। कैश्ड DHL कोट्स और एक्सटेंशन के इवेंट हमेशा हटा दिए जाते हैं। यदि Remove data on uninstall चालू है, तो DHL सेटिंग्स और डिबग लॉग भी हट जाते हैं। यदि यह बंद है, तो बाकी सेटिंग्स रहती हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर इस्तेमाल होती हैं। दिए गए ऑर्डरों के DHL उत्पाद कभी नहीं हटते। मौजूदा ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox DHL Africa के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल बिन बटन) पर क्लिक करें।
DHL उसके संबंधित मालिक का ट्रेडमार्क है। यह एक्सटेंशन DHL से संबद्ध नहीं है और DHL द्वारा समर्थित नहीं है।