VibeFox Mercado Envios for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Mercado Pago खाता (केवल लाइव रेट के लिए): लाइव रेट आपके अर्जेंटीना, ब्राज़ील या मेक्सिको के Mercado Pago खाते के Mercado Envios रेट कैलकुलेटर से आते हैं। खाते के लिए Mercado Envios सक्षम होना चाहिए। पार्सल का रेट उस खाते में सेट किए गए शिपिंग पते से निकाला जाता है। आपको प्रोडक्शन Access Token चाहिए (यह APP_USR- से शुरू होता है): Mercado Pago डेवलपर पैनल में अपना एप्लिकेशन और उसकी प्रोडक्शन क्रेडेंशियल्स खोलें। यहाँ लॉगिन बटन नहीं है: आप टोकन को सेटिंग्स में पेस्ट करते हैं। यदि आप केवल देश के अनुसार कीमतें इस्तेमाल करते हैं, तो Mercado Pago खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. लाइव रेट के लिए Access Token पेस्ट करें, Mercado Envios देश चुनें और यदि आपके स्टोर की मुद्रा ARS, BRL या MXN नहीं है, तो विनिमय दर दर्ज करें। वैकल्पिक रूप से Country prices और Fallback cost भरें (ये लाइव रेट के बिना इस्तेमाल होते हैं)।

6. WooCommerce > Settings > Shipping > Shipping zones में किसी शिपिंग ज़ोन में VibeFox Mercado Envios जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

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

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

पेज के ऊपर की चेतावनियाँ कॉन्फ़िगरेशन की समस्याएँ दिखाती हैं: विनिमय दर न होना, एक्सेस टोकन और कीमत दोनों न होना, और तारीख के साथ अंतिम Mercado Envios API त्रुटि। हर बार सेटिंग्स सहेजने पर कैश की गई दरें हट जाती हैं।

सामान्य

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

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

Tax status: Mercado Envios अंतिम कीमतें देता है। None उन्हें जैसी दी गई हैं वैसी दिखाता है, Taxable उनके ऊपर आपका WooCommerce शिपिंग टैक्स जोड़ता है।

Mercado Envios API (लाइव रेट) (टोकन के बिना केवल नीचे की कीमतें इस्तेमाल होती हैं)

Access token: आपका Mercado Pago प्रोडक्शन Access Token (APP_USR-...)। यह केवल Mercado Pago को भेजा जाता है और कभी लॉग नहीं किया जाता।

Mercado Envios country: आपके Mercado Pago खाते का देश: Argentina (ARS) (डिफ़ॉल्ट), Brazil (BRL) या Mexico (MXN)। लाइव रेट केवल इसी देश के गंतव्यों के लिए माँगे जाते हैं और उसी देश की मुद्रा में दिए जाते हैं।

Exchange rate: केवल तभी आवश्यक है जब आपके स्टोर की मुद्रा Mercado Envios की मुद्रा से अलग हो: 1 ARS, BRL या MXN की कीमत आपके स्टोर की मुद्रा में, उदाहरण के लिए 0.001। इसके बिना लाइव रेट इस्तेमाल नहीं होते। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।

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

ये कीमतें तब इस्तेमाल होती हैं जब एक्सेस टोकन न हो, गंतव्य Mercado Envios देश के बाहर हो, और जब API कोई दर न दे।

Country prices: आपके स्टोर की मुद्रा में कीमतें। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और पंक्ति हटाने के लिए क्रॉस पर। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * All other countries चुनें। Price उस देश की कीमत है। XS (1 kg तक), S (1-2 kg), M (2-3 kg), L (3-5 kg) और XL (5 kg से अधिक) कॉलम उस कार्ट वज़न के लिए इसकी जगह लेते हैं। खाली या 0 वाला कॉलम Price इस्तेमाल करता है। जो मान संख्या नहीं हैं, वे सहेजने के बाद बताए जाते हैं और मिटा दिए जाते हैं। जिन पंक्तियों में कोई कीमत नहीं है, वे सहेजते समय हटा दी जाती हैं।

Fallback cost: तब इस्तेमाल होता है जब न API और न ही Country prices कोई कीमत देते हैं। उस स्थिति में विधि को छिपाने के लिए इसे खाली छोड़ें।

Calculation type: Per order कीमत एक बार लेता है। Per item (each item priced by its own weight x quantity) हर आइटम के वज़न के लिए Country prices (या Fallback cost) में कीमत खोजता है और उसे मात्रा से गुणा करता है। Mercado Envios लाइव रेट हमेशा पूरे पार्सल के लिए होते हैं।

उपलब्धता

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

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

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

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

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

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

मुफ़्त शिपिंग

Free shipping from: वह कार्ट सबटोटल जिससे यह विधि मुफ़्त है। इस स्थिति में Mercado Envios को कोई अनुरोध नहीं भेजा जाता। अक्षम करने के लिए खाली छोड़ें।

उन्नत

Debug log: API अनुरोधों और रेट गणना को WooCommerce > Status > Logs (स्रोत vfd-mercado-envios) में लॉग करता है। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। एक्सेस टोकन और ग्राहकों के पते कभी लॉग नहीं होते।

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

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

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

मान्य पिन कोड वाले Mercado Envios देश के गंतव्य के लिए, प्लगइन कार्ट को एक पार्सल के रूप में वर्णित करता है: आइटमों की सबसे बड़ी चौड़ाई और लंबाई, सभी आइटमों की ऊँचाइयों का योग, और ग्राम में कुल वज़न। हर भुजा और वज़न उस देश की Mercado Envios न्यूनतम सीमा तक बढ़ाए जाते हैं, इसलिए बिना आयाम या वज़न वाले उत्पादों को भी रेट मिल जाता है। कार्ट की राशि Mercado Envios की मुद्रा में आइटम कीमत के रूप में भेजी जाती है। Mercado Envios द्वारा लौटाया गया सबसे सस्ता विकल्प आपके स्टोर की मुद्रा में बदला जाता है और आपकी विधि के नाम के नीचे दिखाया जाता है।

हर कोट 1 घंटे के लिए कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल कोट 5 मिनट तक दोबारा नहीं भेजा जाता। यदि Mercado Pago तक पहुँच नहीं हो पाती या वह टोकन अस्वीकार करता है, तो सभी लाइव कोट 5 मिनट के लिए रोक दिए जाते हैं, ताकि चेकआउट हर रीफ़्रेश पर API का इंतज़ार न करे। API टाइमआउट 10 सेकंड है।

लाइव रेट के बिना कीमतें इनकी जगह इस्तेमाल होती हैं: जब टोकन न हो, गंतव्य Mercado Envios देश के बाहर हो, पिन कोड गायब या अमान्य हो, विनिमय दर न हो, पार्सल देश की Mercado Envios सीमा (अर्जेंटीना में 25 kg, ब्राज़ील में 15 kg, मेक्सिको में 30 kg) से भारी हो, या Mercado Envios उस पते के लिए त्रुटि लौटाए या कोई विकल्प न दे। देश की पंक्ति (या * पंक्ति) इस्तेमाल होती है, नहीं तो फ़ॉलबैक लागत। यदि कोई कीमत नहीं है, तो विधि छिप जाती है। ग्राहक को कभी API त्रुटि नहीं दिखती।

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

प्लगइन केवल रेट की गणना करता है। यह शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता और पार्सल ट्रैक नहीं करता। शिपमेंट अपने Mercado Libre या Mercado Pago खाते में बनाएँ। यह हर विधि के लिए एक रेट दिखाता है, यानी सबसे सस्ता Mercado Envios विकल्प, सभी विकल्पों के बीच चुनाव नहीं; और इसमें पिकअप पॉइंट (एजेंसी) चुनने की सुविधा नहीं है।

ऑर्डर

जब ऑर्डर लाइव रेट पर दिया जाता है, तो सेवा का नाम और दिनों में अनुमानित डिलीवरी समय ऑर्डर की शिपिंग लाइन पर Mercado Envios service और Estimated delivery के रूप में सहेजे जाते हैं। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।

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

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

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

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

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

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

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

लाइव रेट नहीं दिखते: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-mercado-envios। आम कारण: टोकन न होना, गंतव्य Mercado Envios देश के बाहर होना, पिन कोड गायब या अमान्य होना, Exchange rate न होना, पार्सल वज़न सीमा से ऊपर होना, या पते के लिए Mercado Envios विकल्प न होना।

चेतावनियों में HTTP 401 या 403: एक्सेस टोकन अमान्य है या समाप्त हो चुका है। Mercado Pago डेवलपर पैनल से प्रोडक्शन Access Token फिर से कॉपी करें।

Mercado Envios ने दूसरी मुद्रा में जवाब दिया: खाते का देश Mercado Envios country से मेल नहीं खाता। अपने Mercado Pago खाते का देश चुनें।

कीमतें किस मुद्रा में हैं: Country prices और Fallback cost आपके स्टोर की मुद्रा में हैं। लाइव रेट आपके Mercado Pago खाते की मुद्रा में आते हैं और स्टोर दूसरी मुद्रा इस्तेमाल करता हो तो Exchange rate से बदले जाते हैं।

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

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

अनइंस्टॉल

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

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