VibeFox 99Minutos for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

99minutos API कुंजी (केवल कवरेज जाँच के लिए): इसे अपने 99minutos खाता प्रबंधक से लें या 99minutos डेवलपर पोर्टल (developers.99minutos.com) पर प्राप्त करें। Sandbox और production कुंजियाँ अलग होती हैं। यदि आप केवल प्राइस मैट्रिक्स का उपयोग करते हैं, तो आपको API कुंजी की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. Price matrix भरें (कम से कम एक पंक्ति, जैसे "* Default"), और वैकल्पिक रूप से API कुंजी और कवरेज जाँच मोड चुनें (देखें कॉन्फ़िगरेशन)।

6. WooCommerce > Settings > Shipping > Shipping zones में मेक्सिको, कोलंबिया, चिली या पेरू को कवर करने वाले शिपिंग ज़ोन में VibeFox 99Minutos जोड़ें।

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

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

Method title (zone): इस ज़ोन में ग्राहक को दिखने वाला नाम। वैश्विक Method title उपयोग करने के लिए इसे खाली छोड़ें।

सेटिंग्स सेव करते समय, यदि प्राइस मैट्रिक्स खाली है या API कुंजी के बिना कवरेज जाँच मोड चुना गया है, तो पेज चेतावनी देता है।

सामान्य

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

Method title: चेकआउट पर ग्राहक को दिखाया गया शिपिंग विधि का नाम। कोई ज़ोन इसे बदल सकता है। डिफ़ॉल्ट: 99Minutos।

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

99minutos API (कवरेज जाँच) (वैकल्पिक)

API का उपयोग केवल यह जाँचने के लिए होता है कि 99minutos ग्राहक के पोस्टकोड पर डिलीवरी करता है या नहीं। कीमत हमेशा मैट्रिक्स से आती है।

Coverage check: पोस्टकोड जाँचा जाए या नहीं, और कैसे।

कवरेज जाँच के साथ, विधि तभी दिखती है जब ग्राहक पोस्टकोड दर्ज करे। परिणाम कैश होते हैं: कवर 6 घंटे, कवर नहीं 30 मिनट, API त्रुटि 5 मिनट। 99minutos को केवल पोस्टकोड भेजा जाता है।

API key: आपकी 99minutos API कुंजी, जिसे Bearer टोकन के रूप में 99minutos कवरेज endpoint पर भेजा जाता है। कवरेज जाँच चालू होने पर आवश्यक है। फ़ील्ड मास्क्ड होता है।

Environment: Sandbox (test) (डिफ़ॉल्ट) या Production। Sandbox और production अलग-अलग API कुंजियाँ उपयोग करते हैं, इसलिए अपनी कुंजी से मेल खाता वातावरण चुनें।

दरें

कीमतें आपकी स्टोर मुद्रा में होती हैं और जैसी दर्ज की जाती हैं वैसी ही उपयोग होती हैं, बिना रूपांतरण के।

Price matrix: गंतव्य देशों और कीमतों की एक तालिका। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। हर पंक्ति में एक Country, एक 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): यदि कार्ट इससे भारी है तो विधि छिपाएँ। डिफ़ॉल्ट: 25। 0 का अर्थ कोई सीमा नहीं।

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

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

Restrict countries: विधि केवल नीचे दिए गए देशों के लिए दें। यह शिपिंग ज़ोन के ऊपर एक अतिरिक्त फ़िल्टर है: विधि को फिर भी किसी ज़ोन में जोड़ना होगा। तब उपयोगी जब एक ज़ोन कई देशों को कवर करता हो।

Countries: 99minutos देशों (मेक्सिको, कोलंबिया, चिली, पेरू) में से चुनाव। केवल तब उपयोग होता है जब Restrict countries चालू हो। सभी 99minutos देशों की अनुमति देने के लिए खाली छोड़ें।

उन्नत

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

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

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

विधि केवल तभी दी जाती है जब डिलीवरी देश मेक्सिको, कोलंबिया, चिली या पेरू हो (और यदि Restrict countries चालू है, तो वह Countries सूची में हो)। जब ग्राहक डिलीवरी पता दर्ज करता है, तो प्लगइन कार्ट वज़न सीमाएँ, Minimum subtotal और Excluded shipping classes जाँचता है।

यदि कवरेज जाँच मोड चालू है, तो प्लगइन फिर 99minutos API से पूछता है कि पोस्टकोड कवर है या नहीं। अनुरोध की समय-सीमा 10 सेकंड है और उत्तर कैश होता है, इसलिए वही पोस्टकोड नया अनुरोध नहीं भेजता। API त्रुटियाँ ग्राहक को कभी नहीं दिखाई जातीं: Strict मोड में विधि छिपती है, Soft मोड में मैट्रिक्स कीमत उपयोग होती है। मुफ़्त शिपिंग कवरेज जाँच को नहीं छोड़ती।

कीमत डिलीवरी देश की मैट्रिक्स पंक्ति से, या * Default पंक्ति से ली जाती है। यदि दोनों में से कोई नहीं है, तो विधि छिपती है। यदि Free shipping चालू है और कार्ट उप-योग Free shipping from तक पहुँचता है, तो दर 0 होती है।

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

प्लगइन 99minutos से लाइव रेट कोट्स नहीं लेता: कीमतें हमेशा आपकी मैट्रिक्स से आती हैं। यह 99minutos में शिपमेंट या ऑर्डर नहीं बनाता, लेबल (guides) प्रिंट नहीं करता, पार्सल ट्रैक नहीं करता, Punto99 पिकअप पॉइंट्स नहीं देता और कैश ऑन डिलीवरी नहीं संभालता। शिपमेंट अपने 99minutos खाते में सामान्य रूप से बनाएँ।

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

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

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

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

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

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

99Minutos चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के पते के ज़ोन में जुड़ी है। डिलीवरी देश मेक्सिको, कोलंबिया, चिली या पेरू होना चाहिए। जाँचें कि Price matrix में उस देश की पंक्ति है या * Default पंक्ति है, और वज़न सीमाएँ, Minimum subtotal, Excluded shipping classes और Restrict countries देखें।

विधि केवल पोस्टकोड दर्ज करने के बाद दिखती है: कवरेज जाँच के साथ यह अपेक्षित व्यवहार है। Strict मोड में यह तभी दिखती है जब API कवरेज की पुष्टि करे।

Strict मोड में विधि हमेशा छिपी रहती है: Debug log चालू करें, चेकआउट रीलोड करें, और WooCommerce > Status > Logs खोलें (स्रोत "vfd-99minutos")। HTTP 401 या 403 त्रुटि का अर्थ है कि API कुंजी अस्वीकार की गई: कुंजी और Environment का मिलान जाँचें (sandbox और production कुंजियाँ अलग होती हैं)। यदि API उपलब्ध न होने पर भी ग्राहकों को मैट्रिक्स कीमत मिलनी चाहिए, तो Soft मोड उपयोग करें।

कीमत अपेक्षा के अनुरूप नहीं है: Calculation (प्रति ऑर्डर या प्रति आइटम), उत्पादों का वज़न, और आपके स्टोर की वज़न इकाई जाँचें। खाली या 0 आकार कीमत Base price पर वापस जाती है।

अन्य देश: डेवलपर vfd_99m_supported_countries फ़िल्टर से समर्थित देशों की सूची बदल सकते हैं।

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

अनइंस्टॉल

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

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