VibeFox Envioclick for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Envioclick खाता (केवल लाइव दरों के लिए): मेक्सिको या कोलंबिया में API एक्सेस वाला Envioclick खाता। API कुंजी आपके Envioclick खाते में Mi cuenta (ऊपर दाईं ओर) > Información del API में है। यदि आप केवल तय कीमतें उपयोग करते हैं, तो Envioclick खाते की ज़रूरत नहीं है।

User-Agent (केवल मेक्सिको): Envioclick Mexico को हर API अनुरोध के लिए User-Agent मान चाहिए। यह Envioclick सपोर्ट से माँगें (soporte.tecnico@envioclick.com)।

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

इंस्टॉलेशन

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

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

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

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

5. API कुंजी डालें, API देश चुनें, User-Agent (मेक्सिको), मूल पिनकोड या DANE कोड और मूल पता डालें। यदि आपकी स्टोर मुद्रा MXN या COP नहीं है, तो विनिमय दर डालें।

6. वैकल्पिक: देश के अनुसार तय कीमतें और फ़ॉलबैक लागत जोड़ें।

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

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

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

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

API कुंजी सेट होने पर, यदि लाइव दरें काम नहीं कर सकतीं तो प्लगइन पेज के ऊपर चेतावनियाँ दिखाता है: MXN या COP के अलावा किसी स्टोर मुद्रा के लिए विनिमय दर न होना, मेक्सिको के लिए User-Agent न होना, मूल पिनकोड या DANE कोड न होना, या कोलंबिया के लिए मूल पता न होना। हर बार सेटिंग सेव करने पर कैश की गई दरें साफ़ हो जाती हैं। संख्या वाले फ़ील्ड दशमलव विभाजक के रूप में बिंदु और कॉमा दोनों स्वीकार करते हैं।

सामान्य

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

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

Carrier in the title: लाइव दरों के लिए शीर्षक के बगल में कैरियर और अनुमानित डिलीवरी समय दिखाता है, जैसे "Envioclick Shipping (Estafeta Express, 1 day)"। यह सेटिंग चाहे जो हो, कैरियर ऑर्डर में सेव होता है और ऑर्डर ईमेल में दिखता है। डिफ़ॉल्ट: चालू।

Envioclick API (लाइव दरें)

वैकल्पिक। API कुंजी के बिना केवल तय कीमतें उपयोग होती हैं। लाइव दरें केवल API देश के गंतव्यों के लिए माँगी जाती हैं। अन्य देशों में शिपिंग तय कीमतें उपयोग करती है।

API key: Mi cuenta > Información del API से आपकी Envioclick API कुंजी।

API country: आपके Envioclick खाते का देश।

User-Agent (Mexico): Envioclick सपोर्ट द्वारा जारी मान (soporte.tecnico@envioclick.com)। मेक्सिको के लिए अनिवार्य है; इसके बिना मेक्सिको के लिए लाइव दरें नहीं माँगी जातीं। कोलंबिया के लिए वैकल्पिक है।

Carrier choice: Cheapest (डिफ़ॉल्ट) या Fastest (then cheapest)। Envioclick कई कैरियर से दरें लौटाता है, और ग्राहक को एक ही दर मिलती है।

Branch pickup rates: "Ocurre" दरों पर भी विचार करता है, जहाँ ग्राहक पार्सल कैरियर की शाखा से लेता है। बंद होने पर केवल घर तक डिलीवरी की दरें उपयोग होती हैं। कैश-ऑन-डिलीवरी (COD) सेवाएँ कभी उपयोग नहीं होतीं। डिफ़ॉल्ट: बंद।

Currency conversion rate: Envioclick MXN (मेक्सिको) या COP (कोलंबिया) में दरें देता है। यदि आपकी स्टोर मुद्रा अलग है, तो 1 MXN या 1 COP का मान अपनी स्टोर मुद्रा में डालें, जैसे 0.05। घोषित पार्सल मूल्य भी उसी तरह बदला जाता है। यदि स्टोर मुद्रा MXN या COP है तो खाली छोड़ें। इसके बिना दूसरी मुद्रा में लाइव दरें उपयोग नहीं होतीं।

भेजने का स्थान

लाइव दरों के लिए उपयोग होता है। यदि स्टोर API देश में है, तो खाली फ़ील्ड WooCommerce > Settings > General के स्टोर पते से भरे जाते हैं।

Origin postcode / DANE code: मेक्सिको: 5-अंकीय पिनकोड। कोलंबिया: नगरपालिका का 8-अंकीय DANE कोड, जैसे बोगोटा के लिए 11001000।

Origin address: पिकअप पते की सड़क और नंबर। कोलंबिया के लिए अनिवार्य, मेक्सिको के लिए वैकल्पिक।

तय कीमतें

तब उपयोग होती हैं जब लाइव दर नहीं होती: API कुंजी न होना, गंतव्य API देश से बाहर होना, API त्रुटि, या मार्ग के लिए कोई कैरियर न होना।

Price per country: स्टोर मुद्रा में देशों और कीमतों की तालिका। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। * Default पंक्ति उन सभी देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है।

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

Fixed price applies: Per order कीमत एक बार लेता है। Per item (price × quantity) उसे कार्ट में आइटमों की संख्या से गुणा करता है। Envioclick की लाइव दरें हमेशा प्रति शिपमेंट होती हैं।

शर्तें

Minimum weight (kg): इस कार्ट वज़न से कम होने पर विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। Envioclick की दरों में कैरियर के टैक्स पहले से शामिल होते हैं, इसलिए शिपिंग पर दोबारा टैक्स न लगे, इसके लिए None चुनें।

शिपिंग ज़ोन के बिना उपलब्धता

Ignore shipping zones: Envioclick को नीचे दिए देशों के लिए पेश करता है, भले ही वह किसी शिपिंग ज़ोन में न जोड़ा गया हो।

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

उन्नत

Debug log: दर गणनाएँ और API त्रुटियाँ WooCommerce > Status > Logs में, स्रोत vfd_envioclick के रूप में लॉग करता है। API कुंजी और ग्राहक के पते लॉग नहीं होते। काम पूरा होने पर बंद करें।

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

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

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

यदि API कुंजी सेट है और गंतव्य API देश में है, तो प्लगइन Envioclick से दरें माँगता है। मेक्सिको में अनुरोध तब भेजा जाता है जब ग्राहक 5-अंकीय पिनकोड दर्ज कर दे। कोलंबिया में विभाग और नगरपालिका पहचाने जाने पर अनुरोध भेजा जाता है (अक्षरों की बड़ाई-छोटाई और मात्रा-चिह्न मायने नहीं रखते, "Bogotá D.C." भी काम करता है)। प्लगइन वह सबसे सस्ती या सबसे तेज़ घर-डिलीवरी दर चुनता है जो कैश-ऑन-डिलीवरी न हो, और उसे आपकी स्टोर मुद्रा में बदलता है।

पार्सल हमेशा एक ही बॉक्स होता है: कुल वज़न को kg में बदला जाता है, और सबसे बड़े आइटम की लंबाई व चौड़ाई ली जाती है, जबकि ऊँचाई इतनी रखी जाती है कि सभी आइटमों का कुल आयतन समा जाए। बिना आयाम वाले उत्पादों को 10 × 10 × 10 cm माना जाता है। बिना वज़न वाला कार्ट 0.5 kg के रूप में भेजा जाता है। घोषित मूल्य कार्ट का उप-योग है।

एक ही मार्ग और पार्सल के लिए हर दर 1 घंटे तक कैश होती है। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि एक अनुपलब्ध API हर चेकआउट अपडेट को धीमा न करे। API का टाइमआउट 10 सेकंड है। यदि Envioclick त्रुटि लौटाए या मार्ग के लिए कोई कैरियर न हो, तो ग्राहक को कोई त्रुटि नहीं दिखती: तय कीमत उपयोग होती है, या विधि छिप जाती है। कारण डीबग लॉग में लिखा जाता है।

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

प्लगइन केवल दरें गणना करता है। यह शिपिंग गाइड या लेबल नहीं बनाता, पिकअप का अनुरोध नहीं करता, और शिपमेंट को ट्रैक या रद्द नहीं करता। यह कैरियर चुनने का विकल्प नहीं देता बल्कि एक ही दर देता है, और कैश-ऑन-डिलीवरी सेवाएँ, अतिरिक्त बीमा या कई पार्सल की दरें उपयोग नहीं करता। लाइव दरें केवल घरेलू हैं।

ऑर्डर

जब कोई ऑर्डर Envioclick की लाइव दर से दिया जाता है, तो कैरियर और सेवा ऑर्डर में सेव हो जाते हैं। एडमिन ऑर्डर स्क्रीन पर डिलीवरी पते के नीचे अनुमानित डिलीवरी समय के साथ Envioclick carrier दिखता है। ग्राहक के ऑर्डर पेज और ऑर्डर ईमेल (HTML और प्लेन टेक्स्ट) में Shipping carrier दिखता है। कोट का Envioclick दर ID ऑर्डर की शिपिंग लाइन के साथ छिपे डेटा के रूप में सेव होता है; यह ऑर्डर स्क्रीन पर नहीं दिखता। शिपिंग गाइड अपने Envioclick खाते में बनाएँ।

तय कीमत पर दिए गए ऑर्डर में कोई कैरियर नहीं होता।

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

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: सेटिंग पेज के ऊपर की चेतावनियाँ पढ़ें, फिर Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd_envioclick। आम कारण: विनिमय दर न होना (स्टोर मुद्रा MXN या COP नहीं है), User-Agent न होना (मेक्सिको), मूल पिनकोड या DANE कोड न होना, ग्राहक का पिनकोड (मेक्सिको) या शहर (कोलंबिया) अभी दर्ज न होना, गंतव्य API देश से बाहर होना, या मार्ग के लिए कोई कैरियर न होना।

विनिमय दर क्यों? Envioclick केवल मेक्सिकन या कोलंबियन पेसो में कीमतें लौटाता है। प्लगइन पेसो की राशि को कभी दूसरी मुद्रा की तरह नहीं दिखाता।

कोलंबिया: शहर पहचाना नहीं जाता: ग्राहक को विभाग चुनना होगा और नगरपालिका का नाम टाइप करना होगा। पिनकोड की तरह दर्ज 8-अंकीय DANE कोड भी काम करता है। डेवलपर vfd_evc_dane_code फ़िल्टर से DANE कोड दे सकते हैं।

शिपिंग पर टैक्स दो बार लग रहा है: Envioclick की दरों में कैरियर के टैक्स पहले से शामिल हैं। Tax status को None पर सेट करें।

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

डेवलपर फ़िल्टर: vfd_evc_quotation_request (अनुरोध बॉडी), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions और vfd_evc_package_description।

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

अनइंस्टॉल

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

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