VibeFox Delhivery for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या बाद का संस्करण।
WooCommerce: 5.0 या बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या बाद का संस्करण।
Delhivery API टोकन (केवल लाइव दरों के लिए): Delhivery One में लॉग इन करें और Settings > API setup खोलें। Delhivery सहायता लेख "API token generation" में चरण बताए गए हैं। टेस्ट टोकन staging वातावरण के साथ काम करते हैं। आपको अपने पिकअप स्थान का 6 अंकों का पिनकोड भी चाहिए। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो टोकन की ज़रूरत नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_delhivery फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Delhivery, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. API टोकन और अपना origin पिनकोड डालें, Express या Surface तथा Pre-paid या COD चुनें। यदि आपके स्टोर की मुद्रा INR नहीं है, तो conversion rate डालें। वैकल्पिक रूप से निश्चित कीमतें डालें (देखें सेटिंग्स)।
6. WooCommerce > Settings > Shipping > Shipping zones में VibeFox Delhivery को किसी शिपिंग ज़ोन (जैसे India) में जोड़ें, या Ignore zones चालू करके देश चुनें।
सेटिंग्स
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Delhivery। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में यह विधि जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। वैश्विक Method title उपयोग करने के लिए इसे खाली छोड़ें।
हर बार सेटिंग्स सेव करने पर कैश की गई Delhivery दरें मिट जाती हैं। कीमतें और राशियाँ "9.99" और "9,99" दोनों स्वीकार करती हैं।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ इस विधि को चालू या बंद करता है।
Method title: चेकआउट पर दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Delhivery। कोई ज़ोन इसे अपने Title से बदल सकता है।
Tax status: Taxable शिपिंग शुल्क पर WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।
Delhivery API खाता (केवल लाइव दरों के लिए आवश्यक)
Environment: Production (track.delhivery.com) (डिफ़ॉल्ट) या Staging / test account (staging-express.delhivery.com)। Staging का उपयोग केवल Delhivery टेस्ट टोकन के साथ करें।
API token: आपका Delhivery API टोकन। यह केवल authorization हेडर में भेजा जाता है और कभी लॉग में नहीं लिखा जाता।
Origin pincode: आपके पिकअप स्थान या वेयरहाउस का 6 अंकों का पिनकोड, उदाहरण के लिए 110001।
लाइव दरें
लाइव दर भारत के उन गंतव्यों के लिए माँगी जाती है जिनका वैध 6 अंकों का पिनकोड हो, और यह आगे की (डिलीवर होने वाली) शिपमेंट के लिए होती है।
Shipping mode: दर के लिए उपयोग होने वाला Delhivery बिलिंग मोड: Express (डिफ़ॉल्ट) या Surface।
Payment type: Delhivery को भेजा जाने वाला भुगतान प्रकार: Pre-paid (डिफ़ॉल्ट) या COD (कैश ऑन डिलीवरी; Delhivery अपना COD शुल्क जोड़ता है)। प्लगइन ग्राहक द्वारा चुनी गई भुगतान विधि के आधार पर इसे नहीं बदलता।
Rate amount: Delhivery GST सहित और GST रहित, दोनों राशियाँ लौटाता है।
INR to (store currency) conversion rate: Delhivery की दरें भारतीय रुपये में होती हैं। यदि आपके स्टोर की मुद्रा INR नहीं है, तो लिखें कि एक रुपया आपकी मुद्रा की कितनी इकाइयों के बराबर है, उदाहरण के लिए 0.011। इसे खाली छोड़ने पर लाइव दरें उपयोग नहीं होतीं, निश्चित कीमतें लागू होती हैं, और सेटिंग्स के ऊपर एक चेतावनी दिखती है। यदि आपके स्टोर की मुद्रा INR है तो इसकी ज़रूरत नहीं है।
निश्चित कीमतें (लाइव दर उपलब्ध न होने पर उपयोग)
निश्चित कीमतें तब उपयोग होती हैं जब अभी तक कोई टोकन या पिनकोड नहीं है, गंतव्य भारत से बाहर है, पिनकोड पर सेवा उपलब्ध नहीं है, या API कोई त्रुटि लौटाता है। ये आपकी स्टोर मुद्रा में होती हैं।
Prices per country: हर पंक्ति में एक, COUNTRY_CODE:price प्रारूप में, उदाहरण के लिए IN:120। इसे वैकल्पिक कीमत से पहले जाँचा जाता है।
Fallback price: तब उपयोग होती है जब न लाइव दर लागू हो न देश की कीमत। विधि छिपाने के लिए इसे खाली छोड़ें। 0 का अर्थ है मुफ़्त।
Fixed price is charged: Per order कीमत एक बार लेता है। Per item (price × quantity) इसे कार्ट के आइटमों की संख्या से गुणा करता है। Delhivery की लाइव दर हमेशा पूरे पार्सल के वज़न के लिए होती है।
शर्तें
Free shipping from: यदि कार्ट का सबटोटल इस राशि या इससे अधिक है, तो डिलीवरी मुफ़्त है। Delhivery को कोई अनुरोध नहीं भेजा जाता। बंद करने के लिए खाली छोड़ें।
Show from subtotal: विधि केवल तभी दिखाएँ जब कार्ट का सबटोटल इस राशि या इससे अधिक हो। हमेशा दिखाने के लिए खाली छोड़ें।
Min weight (kg): विधि दिखाने के लिए न्यूनतम कार्ट वज़न। 0 का अर्थ है कोई सीमा नहीं।
Max weight (kg): यदि कार्ट इससे भारी है तो विधि छिपाएँ। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं।
उत्पादों के वज़न को आपके स्टोर की वज़न इकाई से kg में बदला जाता है। दर वास्तविक कार्ट वज़न (उत्पाद वज़न का योग) का उपयोग करती है, वॉल्यूमेट्रिक वज़न या बॉक्स का नहीं।
Excluded shipping classes: यदि कार्ट का कोई आइटम इन WooCommerce शिपिंग क्लासों में से किसी से संबंधित है, तो विधि छिपाएँ।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore zones: Delhivery को किसी शिपिंग ज़ोन में जोड़े बिना नीचे दिए देशों के लिए प्रदान करें।
Countries: इस मोड के लिए गंतव्य देश। आप जिन सभी देशों में शिप करते हैं उन्हें उपयोग करने के लिए खाली छोड़ें। यह केवल तब उपयोग होता है जब Ignore zones चालू हो।
उन्नत
Debug log: दर गणनाओं को WooCommerce > Status > Logs में, स्रोत vfd_delhivery के साथ, लॉग करता है। यह विकल्प बंद होने पर भी API त्रुटियाँ हमेशा लॉग होती हैं। टोकन और ग्राहकों के पूरे पिनकोड कभी लॉग नहीं होते।
Remove data on uninstall: चालू होने पर, प्लगइन हटाने से इसकी सभी सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें हट जाती हैं। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले कार्ट का वज़न, सबटोटल और बाहर रखी गई शिपिंग क्लासें जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को मुफ़्त डिलीवरी मिलती है और Delhivery को कोई अनुरोध नहीं जाता।
वैध 6 अंकों के पिनकोड वाले भारतीय पते के लिए, प्लगइन Delhivery को origin और गंतव्य पिनकोड, ग्राम में कार्ट वज़न, शिपिंग मोड और भुगतान प्रकार भेजता है, और लौटाई गई राशि को आपकी स्टोर मुद्रा में बदलकर दिखाता है। हर उत्तर 1 घंटे के लिए कैश होता है। असफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि चेकआउट हर रिफ़्रेश पर Delhivery का इंतज़ार न करे। API टाइमआउट 10 सेकंड है।
यदि कोई लाइव दर नहीं है, तो देश की कीमत या वैकल्पिक कीमत उपयोग होती है। यदि दोनों सेट नहीं हैं, तो विधि छिप जाती है। ग्राहक को कभी API त्रुटि नहीं दिखती।
यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce के High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन दरों की गणना करता है और ट्रैकिंग लिंक दिखाता है। यह शिपमेंट या वेबिल नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप या मैनिफ़ेस्ट का अनुरोध नहीं करता, पिनकोड की सेवा-योग्यता नहीं जाँचता, डिलीवरी की तारीखों का अनुमान नहीं लगाता, ट्रैकिंग स्थिति सिंक नहीं करता, और Delhivery की अंतरराष्ट्रीय दरों का अनुमान नहीं देता। भारत के बाहर केवल निश्चित कीमतें उपयोग होती हैं।
ऑर्डर और ट्रैकिंग
ऑर्डर स्क्रीन पर, शिपिंग पते के नीचे, Delhivery ब्लॉक शिपिंग मोड (Express या Surface) और कीमत का स्रोत दिखाता है: Delhivery की लाइव दर, निश्चित कीमत, या मुफ़्त शिपिंग की सीमा।
Delhivery One में शिपमेंट बनाएँ, फिर उसका AWB Delhivery AWB / tracking number फ़ील्ड में पेस्ट करें और ऑर्डर सेव करें। एडमिन में Track on delhivery.com लिंक दिखेगा। ग्राहक को मेरा खाता में ऑर्डर पेज पर और ऑर्डर ईमेल (HTML और plain text) में लिंक के साथ Delhivery tracking दिखेगा। AWB ऑर्डर स्थिति से पहले सेव होता है, इसलिए यदि आप उसी सेव में ऑर्डर पूरा करते हैं, तो "पूर्ण ऑर्डर" ईमेल में AWB पहले से शामिल होगा।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Delhivery के ऊपर होता है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर Delhivery ग्राहकों को नहीं दिखता। लॉग इन किए स्टोर मैनेजरों को यह (unlicensed — visible to admins only) चिह्न के साथ दिखता रहता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की अवधि समाप्त होने पर भी प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप दोबारा जाँची जाती है।
समस्या निवारण
चेकआउट पर Delhivery नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore zones चालू है और देश की अनुमति है)। वज़न सीमाएँ, Show from subtotal और Excluded shipping classes भी जाँचें। लाइव दर के बिना देश की कीमत या Fallback price चाहिए।
लाइव दरें नहीं दिखतीं: API टोकन, सही Origin pincode, और INR के अलावा मुद्रा वाले स्टोर में conversion rate जाँचें। ग्राहक को वैध 6 अंकों का भारतीय पिनकोड डालना होगा। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत vfd_delhivery खोलें, ताकि API त्रुटियाँ दिखें, जैसे ऐसा पिनकोड जहाँ सेवा उपलब्ध नहीं है।
GST दोहरे रूप में लगता है: Delhivery की कुल राशि में GST पहले से शामिल है। Rate amount को Gross amount (excluding GST) पर सेट करें, या Tax status को None पर सेट करें।
परीक्षण: Environment को Staging पर सेट करें और Delhivery का टेस्ट टोकन उपयोग करें।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सेव करें। इससे कैश की गई Delhivery दरें मिट जाती हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। हटाने के लिए, इसे निष्क्रिय करें और Plugins पेज से डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें केवल तभी हटती हैं जब Remove data on uninstall चालू था। अन्यथा, बाद में दोबारा इंस्टॉल करने के लिए वे बनी रहती हैं। AWB नंबर ऑर्डर में बने रहते हैं, और मौजूदा ऑर्डर अपनी शिपिंग लाइनें रखते हैं।
Delhivery संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Delhivery से संबद्ध नहीं है और Delhivery द्वारा समर्थित नहीं है।