VibeFox 99Minutos for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।
99minutos API कुंजी (केवल कवरेज जाँच के लिए): यह अपने 99minutos अकाउंट मैनेजर से लें या 99minutos डेवलपर पोर्टल (developers.99minutos.com) पर प्राप्त करें। Sandbox और production कुंजियाँ अलग होती हैं। यदि आप केवल प्राइस मैट्रिक्स इस्तेमाल करते हैं, तो आपको API कुंजी की आवश्यकता नहीं है।
देश: 99minutos मेक्सिको, कोलंबिया, चिली और पेरू में डिलीवरी करता है। जिन देशों में आप शिप करते हैं, वे International > Locations में सक्रिय होने चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox 99Minutos खोजकर Configure पर क्लिक करें।
3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में License key के अंतर्गत अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. Price matrix भरें (कम से कम एक पंक्ति, उदाहरण के लिए "* Default") और चाहें तो API कुंजी तथा कवरेज जाँच मोड भी भरें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।
इंस्टॉल पर मॉड्यूल डिलीवरी समय के पाठ Courier delivery के साथ 99Minutos कैरियर बनाता है। कैरियर सभी ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। मेक्सिको, कोलंबिया, चिली और पेरू के ज़ोन कैरियर के लिए सक्रिय रहने चाहिए। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox 99Minutos > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव कैश किए गए कवरेज परिणाम भी साफ़ करता है। सेव के बाद, पेज चेतावनी देता है यदि प्राइस मैट्रिक्स खाली है, यदि उसमें ऐसे देशों की पंक्तियाँ हैं जिन्हें 99minutos सेवा नहीं देता, यदि बिना API कुंजी के कवरेज जाँच मोड चुना गया है, या यदि मॉड्यूल स्टोर की वज़न इकाई नहीं पहचानता (तब वज़न किलोग्राम माने जाते हैं)। यदि Method title 64 अक्षरों से लंबा है, यदि कोई वज़न या राशि फ़ील्ड 0 या उससे बड़ी संख्या नहीं है, या यदि Min weight (kg), Max weight (kg) से बड़ा है, तो कुछ भी सेव नहीं होता और एक त्रुटि दिखाई जाती है। यदि पेज The 99Minutos carrier was not found — reset the module to create it again. दिखाता है, तो समस्या निवारण देखें।
सामान्य
Enable 99Minutos: कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।
Method title: वह कैरियर नाम जो ग्राहक को कार्ट और चेकआउट पर दिखता है। डिफ़ॉल्ट: 99Minutos। अनिवार्य, 64 अक्षरों तक।
Tax: कैरियर का टैक्स नियम, या No tax। टैक्स नियम होने पर PrestaShop मैट्रिक्स की शिपिंग कीमत में टैक्स जोड़ता है।
99minutos API (कवरेज जाँच) (वैकल्पिक)
API का उपयोग केवल यह जाँचने के लिए होता है कि 99minutos ग्राहक के पोस्टकोड पर डिलीवरी करता है या नहीं। कीमत हमेशा मैट्रिक्स से आती है।
Coverage check: पोस्टकोड जाँचा जाए या नहीं, और कैसे।
कवरेज जाँच के साथ कैरियर तभी दिखता है जब ग्राहक पोस्टकोड दर्ज करे। परिणाम कैश किए जाते हैं: कवर 6 घंटे, कवर नहीं 30 मिनट, API त्रुटि 5 मिनट। 99minutos को केवल पोस्टकोड भेजा जाता है, बड़े अक्षरों में और केवल अक्षरों व अंकों के साथ।
API key: आपकी 99minutos API कुंजी, जो Bearer टोकन के रूप में 99minutos कवरेज endpoint पर भेजी जाती है। कवरेज जाँच चालू होने पर आवश्यक है। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। कुंजी जैसी टाइप की गई वैसी ही सेव होती है; केवल आगे-पीछे के स्पेस हटाए जाते हैं।
Remove the saved API key: केवल तभी दिखता है जब कुंजी सेव हो। इसे चालू करें और कुंजी हटाने के लिए Save पर क्लिक करें।
Environment: Sandbox (test) (डिफ़ॉल्ट) या Production। Sandbox और production अलग API कुंजियाँ इस्तेमाल करते हैं, इसलिए अपनी कुंजी से मेल खाता वातावरण चुनें।
दरें
कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, बिना टैक्स के, और जैसी दर्ज की गई हों वैसी ही इस्तेमाल होती हैं। अंतिम कीमत ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
Price matrix: गंतव्य देशों और कीमतों की एक तालिका। पंक्ति जोड़ने के लिए Add country पर और पंक्ति हटाने के लिए ट्रैश आइकन पर क्लिक करें। हर पंक्ति में एक Country (* Default, मेक्सिको, कोलंबिया, चिली या पेरू), एक Base price, और आकार XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से अधिक) की कीमतें होती हैं। खाली या 0 आकार कीमत Base price पर वापस जाती है। * Default पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। यदि किसी देश की कई पंक्तियाँ हों, तो पहली इस्तेमाल होती है। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार्य हैं; खाली, अमान्य या ऋणात्मक कीमतें 0 के रूप में सेव होती हैं। जब तक मैट्रिक्स में कम से कम एक पंक्ति न हो, चेकआउट पर कैरियर नहीं दिखता।
Calculation: Per order — size by the total cart weight (डिफ़ॉल्ट) पूरी कार्ट के पैकेज आकार के लिए एक कीमत लेता है। Per item — each unit priced by its own weight हर इकाई की कीमत उसके अपने वज़न के आकार से तय करता है और राशियाँ जोड़ता है।
Free shipping: कार्ट उप-योग से मुफ़्त शिपिंग चालू करता है।
Free shipping from: कार्ट उप-योग (छूट के बाद, टैक्स के बिना), जिससे ऊपर दर 0 होती है। केवल तभी इस्तेमाल होता है जब Free shipping चालू हो।
प्रतिबंध
Min weight (kg): यदि कार्ट इससे हल्की है तो कैरियर छिपाता है। 0 का अर्थ है कोई सीमा नहीं। यह Max weight (kg) से बड़ा नहीं हो सकता। उत्पादों के वज़न को आपके स्टोर की वज़न इकाई से बदला जाता है।
Max weight (kg): यदि कार्ट इससे भारी है तो कैरियर छिपाता है। डिफ़ॉल्ट: 25। 0 का अर्थ है कोई सीमा नहीं; खाली फ़ील्ड का अर्थ है 25 kg।
Minimum subtotal: कैरियर केवल तभी दिखाता है जब कार्ट उप-योग (छूट के बाद, टैक्स के बिना) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Restrict countries: कैरियर केवल नीचे दिए देशों के लिए ऑफ़र करता है। यह कैरियर ज़ोन के ऊपर एक अतिरिक्त फ़िल्टर है। यह तब उपयोगी है जब एक ज़ोन कई देशों को कवर करता हो।
Countries: 99minutos के देशों (मेक्सिको, कोलंबिया, चिली, पेरू) में से चयन। कई चुनने के लिए Ctrl (Cmd) दबाए रखें। केवल तभी इस्तेमाल होता है जब Restrict countries चालू हो। सभी 99minutos देशों की अनुमति के लिए खाली छोड़ें।
उन्नत
Debug log: दर गणनाएँ मॉड्यूल फ़ोल्डर में logs/vfd_99m_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। यह बंद होने पर भी API त्रुटियाँ लॉग होती हैं। API कुंजियाँ और ग्राहकों के नाम व पते कभी लॉग नहीं होते। काम पूरा होने पर लॉग बंद करें।
Log: डीबग लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से सेटिंग्स, कैरियर, कवरेज कैश और लॉग हट जाते हैं। बंद होने पर सब कुछ दोबारा इंस्टॉल के लिए रखा जाता है। ऑर्डर किसी भी स्थिति में रखे जाते हैं।
चेकआउट पर यह कैसे काम करता है
शिपिंग चरण पर PrestaShop मॉड्यूल से 99Minutos की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और कार्ट उप-योग में शामिल नहीं होते। कैरियर केवल तभी ऑफ़र होता है जब डिलीवरी देश मेक्सिको, कोलंबिया, चिली या पेरू हो (और यदि Restrict countries चालू है तो Countries सूची में हो)। फिर मॉड्यूल वज़न सीमाएँ और Minimum subtotal जाँचता है।
यदि कवरेज जाँच मोड चालू है, तो मॉड्यूल 99minutos API से पूछता है कि पोस्टकोड कवर है या नहीं। अनुरोध की समय-सीमा 10 सेकंड है और उत्तर कैश होता है, इसलिए वही पोस्टकोड नया अनुरोध नहीं भेजता। API त्रुटियाँ ग्राहक को कभी नहीं दिखाई जातीं: Strict मोड में कैरियर छिप जाता है, Soft मोड में मैट्रिक्स कीमत इस्तेमाल होती है। मुफ़्त शिपिंग कवरेज जाँच को नहीं छोड़ती।
कीमत डिलीवरी देश की मैट्रिक्स पंक्ति से, या * Default पंक्ति से ली जाती है। यदि दोनों में से कोई नहीं है, तो कैरियर छिपा दिया जाता है। यदि Free shipping चालू है और कार्ट उप-योग Free shipping from तक पहुँचता है, तो दर 0 होती है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
यदि कैरियर के ऑर्डर आने के बाद आप Shipping > Carriers में उसे संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण का अपने-आप अनुसरण करता है।
मॉड्यूल 99minutos से लाइव रेट कोट्स नहीं लेता: कीमतें हमेशा आपके मैट्रिक्स से आती हैं। यह 99minutos में शिपमेंट या ऑर्डर नहीं बनाता, लेबल (guides) प्रिंट नहीं करता, पार्सल ट्रैक नहीं करता, Punto99 पिकअप पॉइंट्स नहीं देता और कैश ऑन डिलीवरी नहीं संभालता। अपने 99minutos अकाउंट में हमेशा की तरह शिपमेंट बनाएँ।
लाइसेंस कुंजी
मॉड्यूल vibefox.net से VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox 99Minutos लाइसेंस ब्लॉक Modules > Module Manager > VibeFox 99Minutos > Configure पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) दिखाता है, और स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key बटन दिखाता है। इनके नीचे Product: presta-shipping-99minutos वाली पंक्ति और लिंक 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 अकाउंट में मुक्त करें।
सक्रिय कुंजी के बिना, 99Minutos कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager पर Alerts टैब में एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस की समय-सीमा समाप्त होती है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।
समस्या निवारण
चेकआउट पर 99Minutos नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable 99Minutos चालू है। डिलीवरी देश मेक्सिको, कोलंबिया, चिली या पेरू होना चाहिए और International > Locations में सक्रिय होना चाहिए। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है। जाँचें कि Price matrix में उस देश की पंक्ति या * Default पंक्ति है, और वज़न सीमाएँ, Minimum subtotal और Restrict countries भी जाँचें। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।
पोस्टकोड दर्ज होने के बाद ही कैरियर दिखता है: कवरेज जाँच के साथ यह अपेक्षित है। Strict मोड में यह तभी दिखता है जब API कवरेज की पुष्टि करे।
Strict मोड में कैरियर हमेशा छिपा रहता है: Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। HTTP 401 या 403 त्रुटि का अर्थ है कि API कुंजी अस्वीकार हुई: कुंजी जाँचें और यह भी कि Environment उससे मेल खाता है (sandbox और production कुंजियाँ अलग होती हैं)। यदि API उपलब्ध न होने पर भी ग्राहकों को मैट्रिक्स कीमत मिलनी चाहिए, तो Soft मोड इस्तेमाल करें।
कीमत अपेक्षा के अनुसार नहीं है: Calculation (प्रति ऑर्डर या प्रति आइटम), उत्पादों के वज़न और अपने स्टोर की वज़न इकाई (International > Localization) की जाँच करें। खाली या 0 आकार कीमत Base price पर जाती है। Tax में टैक्स नियम हो तो मैट्रिक्स कीमत पर टैक्स जुड़ता है।
बदलाव के बाद कवरेज परिणाम पुराने लगते हैं: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश किए गए कवरेज परिणाम साफ़ हो जाते हैं।
पेज कहता है कि 99Minutos कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटा दिया गया था। इसे दोबारा बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें। यही संदेश The settings were saved, but the carrier could not be updated. Reset the module to create it again. पर भी लागू होता है।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox 99Minutos के बगल का मेन्यू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। कवरेज कैश भी हमेशा हटाया जाता है। यदि Remove data on uninstall चालू है, तो कैरियर हटाया जाता है (ऑर्डर अपना इतिहास रखते हैं) और सेटिंग्स व लॉग हटा दिए जाते हैं। यदि यह बंद है, तो कैरियर केवल निष्क्रिय होता है और सभी सेटिंग्स रखी जाती हैं। मॉड्यूल दोबारा इंस्टॉल करने पर सेव किया गया कैरियर अनइंस्टॉल से पहले वाली स्थिति वापस पाता है, इसलिए Reset निष्क्रिय कैरियर को चालू नहीं करता।
99minutos उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल 99minutos से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।