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

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होगा।

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

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Mercado Envios ढूँढकर Configure पर क्लिक करें।

3. अपनी VibeFox लाइसेंस कुंजी Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key में दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

इंस्टॉल होने पर मॉड्यूल Mercado Envios कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट Mercado Envios delivery है। यह कैरियर सभी ज़ोन और सभी ग्राहक समूहों को, बिना टैक्स नियम के, सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से ही आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Mercado Envios > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सेव से कैश किए गए Mercado Envios रेट और अंतिम API त्रुटि भी साफ़ हो जाते हैं।

पेज के ऊपर की चेतावनियाँ कॉन्फ़िगरेशन की समस्याएँ दिखाती हैं: विनिमय दर का न होना, Access Token और कीमत दोनों का न होना, तारीख के साथ अंतिम Mercado Envios API त्रुटि, और स्टोर की वह वज़न या आयाम इकाई जिसे मॉड्यूल नहीं पहचानता (तब उसे kg या cm माना जाता है)। यदि कैरियर हटा दिया गया है, तो General सेक्शन में लिखा आएगा: The Mercado Envios carrier was not found — reset the module to create it again.

General

अपने ग्राहकों के ज़ोन Shipping > Carriers में Mercado Envios कैरियर में जोड़ें, या नीचे Ignore shipping zones का उपयोग करें। ये सेटिंग्स हर ज़ोन पर लागू होती हैं।

Enable Mercado Envios shipping: कैरियर चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

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

Tax: कैरियर का टैक्स नियम, या No tax (डिफ़ॉल्ट)। Mercado Envios अंतिम कीमतें देता है। No tax उन्हें जैसी दी गई हैं वैसी ही दिखाता है; टैक्स नियम चुनने पर आपका शिपिंग टैक्स ऊपर से जुड़ जाता है।

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

Access token: आपका Mercado Pago प्रोडक्शन Access Token (APP_USR-...)। यह केवल api.mercadopago.com को भेजा जाता है और कभी लॉग में नहीं लिखा जाता। सेव करने के बाद यह फ़ील्ड खाली रहती है और Saved — leave empty to keep it. दिखाती है। नया मान केवल तभी दर्ज करें जब उसे बदलना हो। लाइव रेट इस्तेमाल करना बंद करने के लिए Remove the saved access token (only the prices below are used then) पर टिक करें और सेव करें।

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

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

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

ये कीमतें तब इस्तेमाल होती हैं जब Access Token न हो, गंतव्य 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 का उपयोग करता है। Price 0 हो तो उस देश के लिए मुफ़्त शिपिंग होती है। 9.99 और 9,99, दोनों स्वीकार किए जाते हैं। संख्या न होने वाले मान सेव के बाद बताए जाते हैं और साफ़ कर दिए जाते हैं। बिना किसी कीमत वाली पंक्तियाँ सेव करते समय हटा दी जाती हैं।

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 kg, 0 का अर्थ है कोई सीमा नहीं। Max weight से बड़ा Min weight सेव करते समय अस्वीकार कर दिया जाता है।

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

Ignore shipping zones: कैरियर को उसके ज़ोन सेट किए बिना नीचे दिए देशों के लिए उपलब्ध कराता है। सेव करने पर कैरियर सभी ज़ोन में जोड़ा जाता है, और बाद में बनाए गए ज़ोन में भी। इस विकल्प को बंद करने पर वे ज़ोन हट जाते हैं जो इसने जोड़े थे, और कैरियर अपने ज़ोन रखता है।

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

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

Free shipping from: कार्ट का सबटोटल (छूट के बाद, टैक्स से पहले) जिससे यह कैरियर मुफ़्त होता है। उस स्थिति में API अनुरोध नहीं किया जाता। बंद करने के लिए खाली छोड़ें।

उन्नत

Debug log: API अनुरोध और रेट गणना को मॉड्यूल फ़ोल्डर में logs/vfd_mrcv_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा दर्ज होती हैं। Access Token और ग्राहक के पते कभी लॉग नहीं होते।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Remove data on uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से सेटिंग्स, कैरियर, कैश किए गए रेट और लॉग हट जाते हैं। बंद होने पर दोबारा इंस्टॉल करने के लिए सब कुछ रखा जाता है।

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

शिपिंग चरण पर PrestaShop मॉड्यूल से Mercado Envios की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल पहले शर्तें जाँचता है: अनुमत देश (Ignore shipping zones के साथ), कार्ट का वज़न और न्यूनतम सबटोटल। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 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 त्रुटि नहीं दिखती।

यदि आप कैरियर को Shipping > Carriers में उसके ऑर्डर आ जाने के बाद संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सहेजता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।

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

ऑर्डर

जब कोई ऑर्डर लाइव Mercado Envios रेट पर दिया जाता है, तो मॉड्यूल सेवा का नाम, दिनों में अनुमानित डिलीवरी समय और लाइव रेट सुरक्षित रखता है। बैक ऑफिस में ऑर्डर पेज पर Mercado Envios ब्लॉक दिखता है, जिसमें Mercado Envios service, Estimated delivery और Live rate (excl. tax) होते हैं। ग्राहक अपने खाते के ऑर्डर विवरण पेज पर Mercado Envios service और Estimated delivery देखता है। मौजूदा ऑर्डर बाद के रेट बदलावों से प्रभावित नहीं होते।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Mercado Envios, Modules > Module Manager > VibeFox Mercado Envios > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में पेस्ट करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन Check now (स्थिति दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। इनके नीचे पंक्ति Product: presta-shipping-mercado-envios और लिंक Manage licenses and domains in your account हैं, जो आपका vibefox.net खाता खोलता है। केवल उन कर्मचारियों को कुंजी बदलने का अधिकार है जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। शॉप का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच न हो, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

सक्रिय कुंजी के बिना Mercado Envios कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता, और कोई रेट नहीं निकाला जाता। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

जब लाइसेंस की अवधि समाप्त होती है, तो मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। बैक ऑफिस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हफ़्ते में एक बार। किसी cron job की ज़रूरत नहीं है। मॉड्यूल अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

चेकआउट पर Mercado Envios नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Mercado Envios shipping चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू करें और Countries देखें)। मॉड्यूल पेज के ऊपर की चेतावनियाँ, वज़न सीमाएँ और Minimum subtotal देखें। कैरियर को कीमत चाहिए: Mercado Envios देश के पतों के लिए काम करता Access Token, या Country prices या Fallback cost। इसके अलावा, उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित किया गया हो सकता है।

लाइव रेट नहीं दिखते: Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। आम कारण: टोकन न होना, Mercado Envios देश से बाहर का गंतव्य, पिन कोड गायब या अमान्य, Exchange rate गायब, वज़न सीमा से अधिक पार्सल, या पते के लिए कोई Mercado Envios विकल्प न होना।

चेतावनियों में HTTP 401 या 403: Access Token अमान्य है या उसकी अवधि समाप्त हो गई है। Mercado Pago डेवलपर पैनल से प्रोडक्शन Access Token दोबारा कॉपी करें।

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

कीमतें किस मुद्रा में हैं: Country prices, Fallback cost और सीमाएँ आपके स्टोर की डिफ़ॉल्ट मुद्रा में हैं। लाइव रेट आपके Mercado Pago खाते की मुद्रा में आते हैं और जब स्टोर कोई अलग डिफ़ॉल्ट मुद्रा इस्तेमाल करता है, तो Exchange rate से बदले जाते हैं।

बदलाव के बाद रेट पुराने लगते हैं: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश किए गए रेट साफ़ हो जाते हैं।

पेज कहता है कि Mercado Envios कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया था। उसे दोबारा बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Mercado Envios के बगल वाला मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। कैश किए गए रेट हमेशा हटा दिए जाते हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटा दिया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग तथा ऑर्डरों का सहेजा गया सेवा डेटा हटा दिया जाता है। यदि यह बंद है, तो कैरियर केवल निष्क्रिय किया जाता है और सभी सेटिंग्स तथा ऑर्डर सेवा डेटा रखे जाते हैं। मॉड्यूल दोबारा इंस्टॉल करने पर कैरियर को अनइंस्टॉल से पहले वाली स्थिति वापस मिल जाती है।

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