VibeFox DHL Africa for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 5.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या उसके बाद का संस्करण।

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. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_dhl_africa फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > DHL Express Africa, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. DHL API चुनें, API key, API secret और अपनी DHL खाता संख्या दर्ज करें। टेस्ट क्रेडेंशियल इस्तेमाल करते समय Test mode चालू रखें। Ship from पता दर्ज करें। यदि आपके DHL खाते का बिल आपकी स्टोर मुद्रा में नहीं बनता, तो DHL quote currency और Exchange rate सेट करें। वैकल्पिक रूप से देशवार कीमतें और फ़ॉलबैक लागत सेट करें (देखें कॉन्फ़िगरेशन)।

6. WooCommerce > Settings > Shipping > Shipping zones में DHL Express Africa को अपने शिपिंग ज़ोन में जोड़ें, या Ignore shipping zones चालू करके देश चुनें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > DHL Express Africa। वे हर शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन के लिए चेकआउट पर इस विकल्प का नाम। इसे खाली छोड़ें तो वैश्विक Name इस्तेमाल होगा।

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

सामान्य

Enable/Disable: विधि को सभी ज़ोन में एक साथ चालू या बंद करता है।

Name: चेकआउट पर दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: DHL Express।

Tax status: Taxable (WooCommerce कर चालू होने पर) DHL की दर को उस कर के बिना लेता है जो DHL कोट करता है, और WooCommerce अपना कर जोड़ता है। None DHL की दर को जैसी कोट हुई है, कर सहित, वैसी ही लेता है।

DHL Express खाता (केवल लाइव दरों के लिए ज़रूरी)

DHL API: कौन-सा DHL इंटरफ़ेस उपयोग होगा। केवल चुनी गई API के फ़ील्ड दिखते हैं।

API key: आपका MyDHL API यूज़रनेम (API key)।

API secret: आपका MyDHL API पासवर्ड (API secret)।

XML Site ID: आपका DHL XML Services Site ID (केवल पुराने API के लिए)।

XML password: आपका DHL XML Services पासवर्ड (केवल पुराने API के लिए)।

DHL account number: आपकी DHL Express खाता संख्या (9 अंक)। MyDHL API के लिए यह ज़रूरी है। XML Services के साथ यह प्रकाशित दरों के बजाय आपके खाते की दरें लौटाता है।

Test mode: DHL के टेस्ट वातावरण का उपयोग करता है। डिफ़ॉल्ट रूप से चालू। टेस्ट क्रेडेंशियल केवल टेस्ट वातावरण में और प्रोडक्शन क्रेडेंशियल केवल प्रोडक्शन में काम करते हैं। लाइव होने पर इसे बंद करें।

भेजने का स्थान

वह पता जहाँ से DHL पार्सल उठाता है। दर इसी पर निर्भर करती है।

Origin country: वह देश जहाँ से आप शिप करते हैं।

Origin city: वह शहर जहाँ से आप शिप करते हैं, जैसे जोहान्सबर्ग। MyDHL API के लिए यह ज़रूरी है।

Origin postcode: उन देशों के लिए खाली छोड़ें जिनमें पोस्टकोड नहीं होते (जैसे केन्या, नाइजीरिया, घाना)।

दरें

सभी कीमतें आपकी स्टोर मुद्रा में हैं। लाइव दर पार्सल के लिए सबसे सस्ता DHL Express उत्पाद है। यदि DHL कॉन्फ़िगर नहीं है, विफल होता है, या मार्ग के लिए कोई सेवा नहीं है, तो देश की कीमत इस्तेमाल होती है, फिर फ़ॉलबैक लागत। दोनों न हों तो विधि छिपी रहती है।

DHL quote currency: DHL आपके DHL खाते के देश की मुद्रा में कोट करता है (जैसे ZAR, NGN या KES)। यदि DHL आपकी स्टोर मुद्रा में राशि नहीं लौटाता, तो लाइव दर नीचे दी गई विनिमय दर से इस मुद्रा से बदली जाती है। अन्यथा वह उपयोग नहीं होती।

Exchange rate: DHL कोटेशन मुद्रा की 1 इकाई आपकी स्टोर मुद्रा में कितनी है, जैसे 1 ZAR = 0.05। बिना रूपांतरण के लिए खाली छोड़ें। यह दर मैन्युअल सेटिंग है।

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): इस कार्ट वज़न से अधिक होने पर विधि छिपा दें। डिफ़ॉल्ट: 70। 0 का अर्थ है कोई सीमा नहीं।

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

Excluded shipping classes: यदि कार्ट में इनमें से किसी WooCommerce शिपिंग क्लास का उत्पाद हो, तो विधि छिपा दें।

शिपिंग ज़ोन के बिना उपलब्धता

Ignore shipping zones: नीचे दिए गए देशों के लिए विधि दें, भले ही मेल खाने वाले शिपिंग ज़ोन में यह विधि न हो।

Countries: उस मोड के लिए गंतव्य देश। आप जिन सभी देशों में शिप करते हैं उन्हें इस्तेमाल करने के लिए खाली छोड़ें। केवल Ignore shipping zones के साथ उपयोग होता है।

उन्नत

Debug log: दर गणनाएँ WooCommerce > Status > Logs में लॉग करता है, स्रोत vfd-dhl-africa। DHL की त्रुटियाँ हमेशा लॉग होती हैं, यह बंद होने पर भी। क्रेडेंशियल और ग्राहकों के पते कभी लॉग नहीं होते।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। प्लगइन निष्क्रिय करने से कभी डेटा नहीं हटता।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले कार्ट का वज़न, न्यूनतम उप-योग और बाहर रखी गई शिपिंग क्लास जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को मुफ़्त डिलीवरी मिलती है और DHL को कोई अनुरोध नहीं जाता।

अन्यथा प्लगइन DHL को मूल और गंतव्य (देश, शहर, पोस्टकोड), किलोग्राम में बदला कार्ट वज़न (कम से कम 0.5 kg) और उत्पाद के सेंटीमीटर आयामों से बना एक बॉक्स भेजता है: सबसे लंबी लंबाई, सबसे चौड़ी चौड़ाई और एक के ऊपर एक रखी ऊँचाइयाँ। जिन उत्पादों में आयाम नहीं हैं, वे कुछ नहीं जोड़ते। यदि किसी भी उत्पाद में आयाम नहीं हैं, तो 10 x 10 x 10 cm का बॉक्स इस्तेमाल होता है। अंतरराष्ट्रीय शिपमेंट को सामान के रूप में घोषित किया जाता है, जिसका घोषित मूल्य कार्ट उप-योग होता है, ताकि DHL पार्सल उत्पादों के लिए कोट करे। घरेलू शिपमेंट घोषित नहीं होते। लाइव दर तभी माँगी जाती है जब ग्राहक शहर दर्ज कर चुका हो (XML Services के साथ शहर या पोस्टकोड)।

सबसे सस्ता DHL Express उत्पाद आपके शीर्षक के साथ एक दर के रूप में दिखाया जाता है। ग्राहक को DHL उत्पाद या डिलीवरी का समय नहीं दिखता। उत्पाद का नाम (जैसे "EXPRESS WORLDWIDE (P)") ऑर्डर की शिपिंग लाइन में DHL product के रूप में सहेजा जाता है, ताकि आप जानें कि क्या बुक करना है।

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

यह विधि क्लासिक चेकआउट और Cart तथा Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

प्लगइन केवल दरों की गणना करता है। यह DHL शिपमेंट नहीं बनाता, लेबल या कमर्शियल इनवॉइस प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता, DHL सर्विस पॉइंट नहीं देता, ग्राहक को DHL उत्पादों के बीच चुनने नहीं देता, कई बॉक्स पैक नहीं करता, बीमा नहीं जोड़ता और शुल्क तथा करों का कोटेशन नहीं देता। कोटेशन केवल शिपिंग के लिए है। शुल्क और आयात कर प्राप्तकर्ता द्वारा चुकाए जाते हैं।

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

प्लगइन vibefox.net से VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > DHL Express Africa के ऊपर होता है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now इस्तेमाल करें, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना DHL Express चेकआउट पर ग्राहकों को नहीं दिखता। लॉग इन किए स्टोर मैनेजर इसे देख पाते हैं, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

जब लाइसेंस समाप्त होता है, तब भी प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

DHL Express चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश अनुमत है)। वज़न सीमा, Minimum subtotal और Excluded shipping classes जाँचें। लाइव दर के बिना विधि तभी दिखती है जब देश की कीमत या फ़ॉलबैक लागत सेट हो।

लाइव दरें नहीं दिख रहीं: सेटिंग्स पेज के ऊपर की चेतावनियाँ जाँचें (क्रेडेंशियल या मूल पता नहीं है)। Debug log चालू करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-dhl-africa। गलत क्रेडेंशियल, मार्ग के लिए सेवा न होना या मुद्रा की समस्या जैसी DHL त्रुटियाँ हमेशा लॉग होती हैं। जाँचें कि Test mode आपके क्रेडेंशियल से मेल खाता है।

DHL ZAR, NGN या KES में दर लौटाता है, पर मेरा स्टोर किसी और मुद्रा में है: DHL quote currency को उसी मुद्रा पर सेट करें और Exchange rate दर्ज करें। इसके बिना लाइव दर उपयोग नहीं होती और फ़ॉलबैक कीमतें लागू होती हैं।

मेरे पास पुराने DHL XML Services क्रेडेंशियल हैं: DHL API में XML Services (legacy) चुनें। MyDHL क्रेडेंशियल मिलने पर MyDHL API पर जाएँ।

शिपिंग पर कर दो बार लग रहा है: Tax status को Taxable पर सेट करें, ताकि DHL की दर DHL के VAT के बिना ली जाए, या None पर, ताकि DHL की राशि जैसी कोट हुई है वैसी ही ली जाए।

बदलाव के बाद दरें पुरानी लग रही हैं: सेटिंग्स पेज सहेजें। इससे कैश किए गए DHL कोटेशन साफ़ हो जाते हैं।

लाइसेंस ब्लॉक में त्रुटि दिख रही है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन निष्क्रिय करने पर सारी सेटिंग्स बनी रहती हैं। केवल कैश किए गए DHL कोटेशन साफ़ होते हैं। प्लगइन हटाने के लिए उसे Plugins पेज पर निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटती हैं, और कैश किए गए कोटेशन भी। सेटिंग्स और ज़ोन विधियाँ केवल तभी हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर कभी नहीं बदले जाते, और मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।

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