VibeFox Melhor Envio for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
Melhor Envio खाता (केवल लाइव दरों के लिए): लाइव दरों के लिए एक एक्सेस टोकन चाहिए। अपने Melhor Envio खाते में टोकन के लिए एक्सेस परमिशन पेज खोलें (Integrações > Permissões de acesso, melhorenvio.com.br/painel/gerenciar/tokens) और «shipping-calculate» अनुमति वाला टोकन बनाएँ। परीक्षण के लिए Melhor Envio के सैंडबॉक्स में टोकन बनाएँ (sandbox.melhorenvio.com.br/painel/gerenciar/tokens)। प्रोडक्शन और सैंडबॉक्स के टोकन अलग होते हैं। टोकन की समय-सीमा होती है। यहाँ «कनेक्ट» बटन नहीं है: आप टोकन को सेटिंग्स में चिपकाते हैं। टोकन के बिना विधि फ़ॉलबैक मूल्य उपयोग करती है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_melhor_envio फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Melhor Envio, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. एक्सेस टोकन, अपना संपर्क ईमेल और मूल CEP चिपकाएँ। यदि आपके स्टोर की मुद्रा BRL नहीं है, तो BRL exchange rate सेट करें। वैकल्पिक रूप से फ़ॉलबैक मूल्य तालिका (उदाहरण के लिए ब्राज़ील के लिए) या फ़ॉलबैक लागत भरें।
6. WooCommerce > Settings > Shipping > Shipping zones में ब्राज़ील के लिए एक ज़ोन जोड़ें और उसमें VibeFox Melhor Envio जोड़ें, या Ignore shipping zones चालू करके देश चुनें।
कॉन्फ़िगरेशन
सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Melhor Envio। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): चेकआउट पर इस विकल्प का नाम। वैश्विक Name उपयोग करने के लिए इसे खाली छोड़ें।
पेज के ऊपर की चेतावनियाँ अधूरे सेटअप को दिखाती हैं: 8 अंकों से कम वाला मूल CEP, संपर्क ईमेल का न होना, BRL विनिमय दर का न होना, तारीख के साथ अंतिम Melhor Envio API त्रुटि, या टोकन और फ़ॉलबैक मूल्य दोनों का न होना। हर बार सेटिंग्स सहेजने पर कैश की गई दरें साफ़ हो जाती हैं।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ Melhor Envio शिपिंग चालू या बंद करता है।
Name: चेकआउट पर ग्राहकों को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Melhor Envio।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।
Melhor Envio API
Access token: नीचे चुने गए वातावरण का टोकन। यह कभी लॉग में नहीं लिखा जाता।
Sandbox: परीक्षण के लिए Melhor Envio सैंडबॉक्स (sandbox.melhorenvio.com.br) उपयोग करता है। इसके साथ सैंडबॉक्स टोकन उपयोग करें। डिफ़ॉल्ट: बंद।
Contact e-mail: एक तकनीकी संपर्क ईमेल, जो हर अनुरोध के साथ Melhor Envio को भेजा जाता है। Melhor Envio हर इंटीग्रेशन से यह माँगता है।
Origin CEP: वह CEP (8 अंक) जहाँ से पार्सल भेजे जाते हैं, जैसे 01310-100। मान्य मूल CEP के बिना कोई दर नहीं माँगी जाती।
Services: दरों के लिए वैकल्पिक, कॉमा से अलग किए गए Melhor Envio सेवा ID, जैसे 1 = Correios PAC, 2 = Correios SEDEX, 17 = Correios Mini Envios, 3 = Jadlog .Package, 4 = Jadlog .Com। अपने खाते की हर सेवा की दर पाने के लिए खाली छोड़ें।
Quotes at checkout: दरें कैसे दिखाई जाएँ।
Delivery time: नाम के बगल में Melhor Envio का डिलीवरी अनुमान दिखाता है, जैसे «(3-5 business days)»। डिफ़ॉल्ट: चालू।
Declared value: दरों में उत्पाद का मूल्य (बीमा) घोषित करता है। बंद होने पर दरें बिना घोषित मूल्य के माँगी जाती हैं: सस्ती, लेकिन पार्सल का बीमा नहीं होता। डिफ़ॉल्ट: चालू।
BRL exchange rate: Melhor Envio ब्राज़ीलियाई रियाल (BRL) में दरें देता है। केवल तब ज़रूरी है जब आपके स्टोर की मुद्रा BRL न हो: 1 BRL का मूल्य आपकी स्टोर मुद्रा में डालें, जैसे 0.17। इसके बिना लाइव दरें उपयोग नहीं होतीं। घोषित मूल्य को उसी दर से BRL में बदला जाता है।
Default product weight (kg): बिना वज़न वाले उत्पादों के लिए उपयोग होता है, दरों और वज़न सीमाओं दोनों में। डिफ़ॉल्ट: 0.3।
Default product size (cm): बिना आयाम वाले उत्पादों के लिए उपयोग होने वाला लंबाई x चौड़ाई x ऊँचाई। डिफ़ॉल्ट: 16x11x5।
Fallback prices (आपकी स्टोर मुद्रा में)
फ़ॉलबैक मूल्य तब उपयोग होते हैं जब टोकन न हो, गंतव्य CEP गायब हो, या API कोई दर न दे (त्रुटि, टाइमआउट, कवरेज न होना)।
Fallback price table: देश और कार्ट के वज़न के अनुसार मूल्य। पंक्ति जोड़ने के लिए + Add country पर और पंक्ति हटाने के लिए क्रॉस पर क्लिक करें। जिन देशों की अपनी पंक्ति नहीं है, उन सबके लिए * Any country चुनें। हर पंक्ति में एक Price और वज़न के कॉलम होते हैं: 1 kg तक XS, 1-2 kg S, 2-3 kg M, 3-5 kg L और 5 kg से ऊपर XL। खाली या 0 वाला कॉलम Price का उपयोग करता है। «9.99» और «9,99» दोनों स्वीकार्य हैं। जो मान संख्या नहीं हैं, उन्हें सहेजने के बाद बताया जाता है और अनदेखा किया जाता है।
Fallback cost: तब उपयोग होता है जब तालिका में भी कोई मूल्य न हो। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।
Fallback calculation: Per order फ़ॉलबैक मूल्य एक बार लेता है। Per item (each item priced by its own weight x quantity) हर आइटम के वज़न (वज़न न होने पर डिफ़ॉल्ट वज़न) के लिए फ़ॉलबैक मूल्य खोजता है और उसे मात्रा से गुणा करता है। यह केवल फ़ॉलबैक मूल्यों पर लागू होता है। Melhor Envio की दरों में पहले से हर आइटम शामिल है।
Availability
Min weight (kg): कार्ट का वज़न इससे कम हो तो विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं।
Max weight (kg): कार्ट का वज़न इससे अधिक हो तो विधि छिपाता है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं।
Minimum subtotal: विधि केवल तभी दिखाता है जब कार्ट का सबटोटल (छूट के बाद, टैक्स से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Free shipping from: वह कार्ट सबटोटल जहाँ से शिपिंग मुफ़्त है। हर सेवा के लिए एक विकल्प होने पर केवल सबसे सस्ती सेवा मुफ़्त होती है। तेज़ सेवाएँ अपनी कीमत बनाए रखती हैं। बंद करने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लासों में से किसी का आइटम हो, तो विधि छिपाता है।
Ignore shipping zones: शिपिंग ज़ोन में जोड़े बिना भी नीचे दिए देशों के लिए यह विधि प्रदान करता है।
Countries: इस मोड के लिए गंतव्य देश। सभी देशों के लिए खाली छोड़ें। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: API अनुरोधों और दर की गणना को WooCommerce > Status > Logs में (स्रोत vfd-melhor-envio) लॉग करता है। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। टोकन और ग्राहक के पते कभी लॉग नहीं होते।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से प्लगइन की सभी सेटिंग्स और ज़ोन की शिपिंग विधियाँ हट जाती हैं। प्लगइन को निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी का पता डालता है, तो WooCommerce प्लगइन से एक दर माँगता है। प्लगइन पहले शर्तें जाँचता है: कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लास।
8 अंकों के CEP वाले ब्राज़ील के डिलीवरी पते के लिए, प्लगइन Melhor Envio को मूल और गंतव्य CEP भेजता है, और हर भेजे जाने योग्य आइटम का वज़न, आकार, मात्रा और घोषित मूल्य भेजता है। यदि आपने सेवाओं की सूची तय की है, तो वह भी भेजी जाती है। दरों को आपकी स्टोर मुद्रा में बदला जाता है और कीमत के अनुसार क्रमबद्ध किया जाता है। ग्राहक को सबसे सस्ती सेवा या हर सेवा के लिए एक विकल्प दिखता है, और डिलीवरी अनुमान भी, यदि वह चालू है। यदि मुफ़्त शिपिंग लागू होती है, तो सबसे सस्ती सेवा की कीमत 0 होती है।
हर दर को पार्सल, CEP और वातावरण के अनुसार 1 घंटे तक कैश किया जाता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल कॉल को 5 मिनट तक याद रखा जाता है, ताकि API की रुकावट चेकआउट के हर रीफ़्रेश को धीमा न करे। API टाइमआउट 12 सेकंड है।
यदि टोकन न हो, पता ब्राज़ील के बाहर हो या अभी मान्य CEP न हो, BRL विनिमय दर गायब हो, या Melhor Envio त्रुटि लौटाए या उस रूट के लिए कोई सेवा न मिले, तो फ़ॉलबैक मूल्य उपयोग होते हैं: देश की पंक्ति (या * पंक्ति), नहीं तो फ़ॉलबैक लागत। यदि मुफ़्त शिपिंग लागू होती है, तो बिना मूल्य के भी विधि मुफ़्त दिखती है। यदि कोई मूल्य नहीं है, तो विधि छिपी रहती है। ग्राहक को कभी API त्रुटि नहीं दिखती।
यह विधि क्लासिक चेकआउट पर और कार्ट तथा चेकआउट ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल मूल्य की गणना करता है। यह लेबल नहीं खरीदता या बनाता, Melhor Envio के कार्ट में शिपमेंट नहीं जोड़ता, पार्सल ट्रैक नहीं करता, पिकअप शेड्यूल नहीं करता, और चालान (NF-e) का डेटा नहीं भेजता। यह Jadlog, Azul या LATAM के एजेंसी पॉइंट (ड्रॉप-ऑफ स्थान) का चयन नहीं देता, और «स्वयं हाथ में» तथा «रसीद» जैसी अतिरिक्त सेवाएँ भी नहीं देता। शिपमेंट अपने Melhor Envio पैनल में प्रबंधित करें। Melhor Envio केवल ब्राज़ील के भीतर भेजता है। अन्य देशों को केवल फ़ॉलबैक मूल्य मिलते हैं।
ऑर्डर
जब ऑर्डर लाइव दर के साथ दिया जाता है, तो सेवा और डिलीवरी का अनुमान ऑर्डर की शिपिंग लाइन पर सहेजे जाते हैं। वे ऑर्डर स्क्रीन और ऑर्डर ईमेल में Melhor Envio service और Delivery estimate के रूप में दिखाए जाते हैं, ताकि आप जानें कि Melhor Envio में कौन सी सेवा खरीदनी है। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Melhor Envio पेज के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसकी डोमेन स्लॉट मुक्त नहीं होती। स्लॉट अपने vibefox.net खाते में मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Melhor Envio नहीं दिखता। लॉग इन किए स्टोर मैनेजर इसे (unlicensed — visible to admins only) चिह्न के साथ अब भी देखते हैं, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके परख सकें। प्लगइन पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस की अवधि समाप्त होती है, तब भी प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Melhor Envio नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। सेटिंग्स पेज के ऊपर की चेतावनियाँ, वज़न सीमाएँ, Minimum subtotal और Excluded shipping classes देखें। बिना टोकन या दर के, विधि को फ़ॉलबैक मूल्य चाहिए: Fallback price table में एक पंक्ति या एक Fallback cost।
केवल फ़ॉलबैक मूल्य दिख रहे हैं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-melhor-envio। आम कारण: टोकन नहीं है, मूल CEP 8 अंकों का नहीं है, BRL से भिन्न स्टोर मुद्रा के लिए BRL exchange rate नहीं है, अभी गंतव्य CEP नहीं है, या कोई सेवा रूट को कवर नहीं करती।
लॉग या चेतावनियों में HTTP 401 या 403: Melhor Envio ने एक्सेस टोकन अस्वीकार कर दिया। वह गलत है, समाप्त या रद्द हो चुका है, या दूसरे वातावरण का है। नया टोकन बनाएँ और जाँचें कि Sandbox उससे मेल खाता है।
ग्राहक कौन सी कीमत देखते हैं: एक विकल्प होने पर, Melhor Envio द्वारा लौटाई गई सबसे सस्ती सेवा। हर सेवा के लिए एक विकल्प होने पर, रूट को कवर करने वाली हर सेवा। Per item केवल फ़ॉलबैक मूल्यों पर लागू होता है।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सहेजें। इससे कैश की गई दरें साफ़ हो जाती हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारी सेटिंग्स बनी रहती हैं। केवल दर का कैश साफ़ होता है। पूरी तरह हटाने के लिए इसे निष्क्रिय करें और Plugins पेज पर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा कैश की गई दरें हमेशा हटा दी जाती हैं। सेटिंग्स और ज़ोन की शिपिंग विधियाँ केवल तब हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।
Melhor Envio उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Melhor Envio से संबद्ध नहीं है और उसके द्वारा अनुमोदित या समर्थित नहीं है।