VibeFox Estafeta for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का।

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

PHP: 8.0 या उसके बाद का।

DrEnvio खाता (केवल लाइव दरों के लिए): Estafeta की लाइव दरें DrEnvio से आती हैं, जो मेक्सिको में Estafeta का साझेदार है। drenvio.com पर एक खाता बनाएँ, Estafeta सक्रिय करें, वहाँ अपना पिकअप पता सेट करें और DrEnvio पैनल से API कुंजी कॉपी करें। यह वही कुंजी है जो आधिकारिक DrEnvio प्लगइन उपयोग करता है। यदि आप केवल अपनी कीमतों का उपयोग करते हैं, तो आपको DrEnvio खाते की ज़रूरत नहीं है।

उत्पाद: लाइव दरों के लिए उत्पादों का वज़न होना चाहिए।

VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

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

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

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

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

5. DrEnvio API कुंजी और, यदि चाहें, मूल पिनकोड दर्ज करें। यदि आपकी स्टोर मुद्रा MXN नहीं है, तो MXN exchange rate दर्ज करें। यदि DrEnvio के पास दर न होने पर भी यह विधि दिखाई देनी चाहिए, तो MX के लिए देश की कीमत या फ़ॉलबैक लागत सेट करें।

6. WooCommerce > Settings > Shipping > Shipping zones में VibeFox Estafeta को अपने Mexico ज़ोन में जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

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

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

पेज के शीर्ष पर प्लगइन चेतावनियाँ दिखाता है: DrEnvio API कुंजी नहीं है, स्टोर मुद्रा MXN से भिन्न है और विनिमय दर नहीं है, या MX के लिए देश की कीमत और फ़ॉलबैक लागत दोनों नहीं हैं (ऐसे में लाइव दर न होने पर विधि छिप जाती है)। सेटिंग्स सहेजने पर, कैश की गई DrEnvio दरें साफ़ हो जाती हैं। संख्या फ़ील्ड दशमलव बिंदु या कॉमा स्वीकार करते हैं। जो मान वैध संख्या नहीं है, वह सहेजते समय साफ़ कर दिया जाता है और उसकी सूचना दी जाती है।

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ Estafeta शिपिंग चालू या बंद करता है। डिफ़ॉल्ट: चालू।

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

Tax status: Taxable WooCommerce को शिपिंग लागत पर टैक्स जोड़ने देता है, None नहीं जोड़ता। DrEnvio की कीमतों में IVA शामिल है या नहीं, यह आपके DrEnvio खाते पर निर्भर है। यदि उनमें IVA पहले से शामिल है, तो None चुनें। डिफ़ॉल्ट: Taxable।

लाइव दरें (DrEnvio API)

पते के लिए सबसे सस्ती Estafeta सेवा प्रस्तुत की जाती है। कुंजी के बिना, अगले भाग की कीमतें उपयोग होती हैं।

DrEnvio API key: आपके DrEnvio पैनल से API कुंजी।

Origin country: पिकअप पते का दो-अक्षर का देश कोड। डिफ़ॉल्ट: MX। इसे केवल मूल पिनकोड के साथ भेजा जाता है।

Origin postcode: पिकअप पते का 5 अंकों का पिनकोड। आपके DrEnvio खाते में सहेजे गए मूल पते का उपयोग करने के लिए इसे खाली छोड़ें। जो पिनकोड 5 अंकों का नहीं है, वह सहेजते समय साफ़ कर दिया जाता है।

MXN exchange rate: DrEnvio मेक्सिकन पेसो में कोटेशन देता है। यह केवल तब चाहिए जब आपकी स्टोर मुद्रा MXN न हो: आपकी स्टोर मुद्रा में 1 MXN का मान, उदाहरण के लिए 0.05। इसके बिना लाइव दरें उपयोग नहीं होतीं।

लाइव दर के बिना कीमतें

जब API कुंजी न हो या DrEnvio कोई Estafeta दर न लौटाए तब उपयोग होती हैं (API उपलब्ध नहीं है, अज्ञात पिनकोड, अभी तक कोई पिनकोड दर्ज नहीं किया गया)। कीमतें आपकी स्टोर मुद्रा में हैं।

Country prices: हर पंक्ति में एक गंतव्य देश, CC:PRICE प्रारूप में, उदाहरण के लिए MX:150। दशमलव बिंदु या कॉमा का उपयोग करें, हज़ार विभाजक का नहीं। किसी अन्य प्रारूप वाले भाग अनदेखे किए जाते हैं और सहेजते समय उनकी सूचना दी जाती है।

Fallback cost: जब न लाइव दर हो और न देश की कीमत, तब की कीमत। विधि छिपाने के लिए इसे खाली छोड़ें; 0 का अर्थ है मुफ़्त शिपिंग।

Calculation type: Per order कीमत एक बार लेता है। Per item (price x number of items) इसे भेजे जा सकने वाले आइटमों की संख्या से गुणा करता है। यह Country prices और Fallback cost पर लागू होता है। DrEnvio की लाइव दर हमेशा पूरे पार्सल की कीमत होती है।

शर्तें

Free shipping from: जब कार्ट का सबटोटल इस राशि तक पहुँचता है, तब शिपिंग मुफ़्त होती है। उस स्थिति में DrEnvio को कोई अनुरोध नहीं भेजा जाता। कभी भी मुफ़्त शिपिंग न देने के लिए इसे खाली छोड़ें।

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

Min weight (kg): विधि दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं।

Max weight (kg): कार्ट का अधिकतम वज़न। इससे अधिक होने पर विधि छिप जाती है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं।

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

उत्पादों के वज़न को आपकी स्टोर इकाई से kg में बदला जाता है।

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

Ignore shipping zones: विधि को किसी शिपिंग ज़ोन में जोड़े बिना भी नीचे दिए देशों के लिए विधि प्रदान करें।

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

एडवांस्ड

Debug log: API अनुरोधों और दर गणना को WooCommerce > Status > Logs में, स्रोत vfd-estafeta के साथ लॉग करता है। API त्रुटियाँ हमेशा लॉग होती हैं। API कुंजी और ग्राहक के पते कभी लॉग नहीं होते।

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

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

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

अन्यथा प्लगइन DrEnvio को गंतव्य देश और पिनकोड, कार्ट का वज़न, आइटमों की संख्या और सबटोटल भेजता है, और यदि आपने मूल पिनकोड सेट किया है तो वह भी। मेक्सिकन पिनकोड 5 अंकों के होने चाहिए; जब तक ग्राहक एक दर्ज नहीं करता, कोई अनुरोध नहीं किया जाता। DrEnvio आपके खाते के सभी कैरियर्स के कोटेशन लौटाता है। प्लगइन केवल Estafeta के कोटेशन का उपयोग करता है, शून्य कीमतों को अनदेखा करता है, सबसे सस्ता चुनता है और उसे आपकी स्टोर मुद्रा में बदलता है। Estafeta सेवा और डिलीवरी समय, ऑर्डर की शिपिंग लाइन के साथ सहेजे जाते हैं और एडमिन ऑर्डर स्क्रीन पर दिखाए जाते हैं।

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

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

प्लगइन केवल दरों की गणना करता है। यह शिपमेंट नहीं बनाता, लेबल (guías) प्रिंट नहीं करता या पार्सल ट्रैक नहीं करता; शिपमेंट अपने DrEnvio या Estafeta खाते में बनाएँ। ग्राहक कोई विशिष्ट Estafeta सेवा या Estafeta कार्यालय नहीं चुन सकता, और विनिमय दरें अपने-आप अपडेट नहीं होतीं।

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

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट को रीलोड करें और WooCommerce > Status > Logs को स्रोत vfd-estafeta के साथ खोलें। कारण दिखाई देगा: API कुंजी नहीं है, MXN से भिन्न स्टोर के लिए विनिमय दर नहीं है, पिनकोड गायब या अमान्य है, API कुंजी अस्वीकार हुई (HTTP 401 या 403), या उस मार्ग के लिए Estafeta की दर नहीं है।

क्या कीमत में IVA शामिल है? यह आपके DrEnvio खाते पर निर्भर है। यदि DrEnvio की कीमतों में IVA पहले से शामिल है, तो Tax status को None पर सेट करें।

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

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

अनइंस्टॉल

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

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