VibeFox Servientrega for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या बाद का।

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

PHP: 8.0 या बाद का।

Servientrega खाता (केवल लाइव दरों के लिए): लाइव दरें Servientrega Cotizador Corporativo (कॉर्पोरेट कोटेशन API) का उपयोग करती हैं। आपको Servientrega का कॉर्पोरेट (क्रेडिट) खाता चाहिए जिसमें इसकी पहुँच हो। तीन मान चाहिए: उपयोगकर्ता, पासवर्ड और बिलिंग कोड (código de facturación, आमतौर पर SER से शुरू होता है)। ये आपके SISCLINET क्रेडेंशियल हैं और आपके Servientrega वाणिज्यिक सलाहकार द्वारा जारी किए जाते हैं। यदि आप केवल निश्चित मूल्य उपयोग करते हैं, तो Servientrega खाते की आवश्यकता नहीं है।

सर्वर पहुँच (केवल लाइव दरों के लिए): आपके सर्वर को HTTP पर web.servientrega.com तक पोर्ट 8058 (कोटेशन API) और पोर्ट 8081 (पासवर्ड एन्क्रिप्शन वेब सेवा) पर पहुँचना होगा।

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

इंस्टॉलेशन

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

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

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

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

5. लाइव दरों के लिए उपयोगकर्ता, पासवर्ड और बिलिंग कोड डालें, Servientrega उत्पाद चुनें, मूल स्थान (origin) का DANE कोड डालें और, यदि आपके स्टोर की मुद्रा COP नहीं है, तो मुद्रा रूपांतरण दर डालें (देखें «सेटिंग्स»)।

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

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

सेटिंग्स

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

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

हर बार जब आप सेटिंग्स सहेजते हैं, कैश किए गए Servientrega कोट और लॉगिन टोकन साफ़ हो जाते हैं। यदि सहेजी गई सेटिंग्स के साथ लाइव दरें काम नहीं कर सकतीं, तो सेटिंग्स के ऊपर एक चेतावनी कारण बताती है: उपयोगकर्ता, पासवर्ड या बिलिंग कोड का अभाव, रूपांतरण दर का अभाव, या मूल स्थान के DANE कोड का अभाव।

सामान्य

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

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

Servientrega API (कोलंबिया के लिए लाइव दरें) (वैकल्पिक; क्रेडेंशियल के बिना केवल निश्चित मूल्य उपयोग होते हैं)

User (login): आपका Servientrega / SISCLINET उपयोगकर्ता नाम।

Password: आपका Servientrega / SISCLINET पासवर्ड, जैसा आप टाइप करते हैं। प्लगइन इसे लॉगिन से पहले Servientrega वेब सेवा द्वारा एन्क्रिप्ट करवाता है, जैसा आधिकारिक Servientrega क्लाइंट करता है।

Billing code: आपके Servientrega खाते का बिलिंग कोड (código de facturación), जो SISCLINET में दिखता है। यह आमतौर पर SER से शुरू होता है।

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

Servientrega product: आपके Servientrega अनुबंध की वह सेवा जिसका कोट लिया जाता है।

बिल्ड वज़न वास्तविक और आयतनी वज़न में से बड़ा होता है।

Currency conversion rate: Servientrega COP में कोट करता है। यदि आपके स्टोर की मुद्रा COP नहीं है, तो अपनी स्टोर मुद्रा में 1 COP का मान डालें, उदाहरण के लिए 0.00023। घोषित पार्सल मूल्य भी इसी तरह COP में बदला जाता है। यदि आपके स्टोर की मुद्रा COP है, तो इसे खाली छोड़ें। यदि आपका स्टोर किसी अन्य मुद्रा का उपयोग करता है और यह फ़ील्ड खाली है, तो लाइव दरें उपयोग नहीं होतीं और निश्चित मूल्य लागू होते हैं। प्लगइन विनिमय दरें नहीं लाता। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार किए जाते हैं।

भेजने का स्थान (लाइव दरों के लिए उपयोग)

Origin city (DANE code): उस नगरपालिका का 8-अंकीय DANE कोड जहाँ से आप शिपिंग करते हैं, उदाहरण के लिए 11001000 Bogotá, 05001000 Medellín, 76001000 Cali या 08001000 Barranquilla। 5-अंकीय नगरपालिका कोड भी स्वीकार है। यदि यह खाली है और WooCommerce > Settings > General में आपका स्टोर पता कोलंबिया में है, तो स्टोर पते की नगरपालिका उपयोग होती है।

निश्चित मूल्य (जब कोई लाइव दर न हो तब उपयोग: क्रेडेंशियल न हों, गंतव्य कोलंबिया से बाहर हो, नगरपालिका अज्ञात हो, रूपांतरण दर का अभाव हो, या API त्रुटि या मार्ग के लिए कवरेज न हो)

Price per country: स्टोर मुद्रा में देशों और मूल्यों की तालिका। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें, और पंक्ति हटाने के लिए क्रॉस पर। Price किसी भी वज़न पर लागू होता है। वज़न कॉलम XS ≤1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg और XL >5 kg उस वज़न के लिए Price की जगह लेते हैं, जब उनका मान 0 से अधिक हो। * Default पंक्ति उन सभी देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है।

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

Fixed price applies: निश्चित मूल्य कैसे वसूले जाते हैं।

Servientrega की लाइव दरें हमेशा प्रति शिपमेंट होती हैं।

शर्तें

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

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

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

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

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

Tax status: Taxable शिपिंग लागत में WooCommerce कर जोड़ता है, None नहीं जोड़ता। Servientrega के कोट (ValorTotal) में वाहक के शुल्क पहले से शामिल हैं। यदि आप उस पर अतिरिक्त कर नहीं चाहते, तो None चुनें।

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

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

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

उन्नत

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

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

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

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

कोलंबिया के गंतव्य के लिए और क्रेडेंशियल सेट होने पर, प्लगइन ग्राहक की नगरपालिका का DANE कोड खोजता है। वह पिन कोड या शहर वाले फ़ील्ड में टाइप किए DANE कोड का उपयोग करता है, या विभाग और शहर का मिलान लगभग 1,130 नगरपालिकाओं की अंतर्निहित तालिका से करता है। एक्सेंट और "D.C." को अनदेखा किया जाता है। जो शहर का नाम केवल एक विभाग में मौजूद है, वह विभाग न लिखे जाने पर भी मिल जाता है।

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

लॉगिन टोकन समाप्त होने तक रखा जाता है, अधिकतम 4 दिन। अस्वीकृत टोकन एक बार अपने-आप नवीनीकृत होता है। हर कोट प्रति मार्ग और पार्सल 1 घंटे तक कैश होता है, इसलिए वही कार्ट नया अनुरोध नहीं भेजता। विफल अनुरोध (एन्क्रिप्शन, लॉगिन या कोट) 10 मिनट तक कैश होते हैं, ताकि हर रिफ़्रेश पर चेकआउट Servientrega का इंतज़ार न करे। प्रति अनुरोध टाइमआउट 10 सेकंड है।

यदि कोई लाइव दर नहीं है, तो मूल्य निश्चित मूल्य तालिका से लिया जाता है, फिर Fallback cost से। यदि दोनों लागू न हों, तो विधि छिप जाती है। ग्राहक को कभी API त्रुटि नहीं दिखती। कारण डीबग लॉग में लिखा जाता है।

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

प्लगइन केवल दरों की गणना करता है। यह गाइड (guías), लेबल या स्टिकर नहीं बनाता, पिकअप का अनुरोध नहीं करता, शिपमेंट ट्रैक या रद्द नहीं करता, और ग्राहकों को Servientrega कार्यालय (Centro de Soluciones) चुनने नहीं देता। गाइड SISCLINET या अपने Servientrega पोर्टल में बनाएँ। कैश ऑन डिलीवरी (logística de recaudo) का मूल्य नहीं बताया जाता। लाइव कोट केवल कोलंबिया के भीतर घरेलू शिपमेंट के लिए हैं। इक्वाडोर, पेरू, पनामा और अंतरराष्ट्रीय शिपमेंट निश्चित मूल्य उपयोग करते हैं।

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

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

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

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

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

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

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

लाइव दरें नहीं दिख रहीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd_servientrega। आम कारण: रूपांतरण दर का अभाव (स्टोर मुद्रा COP नहीं है), मूल स्थान का DANE कोड न होना, ग्राहक का विभाग या शहर अभी न डाला गया हो या ज्ञात नगरपालिका न हो, गलत क्रेडेंशियल, या मार्ग के लिए कवरेज न होना। यदि आपने निश्चित मूल्य सेट किए हैं, तो ये मामले उन्हीं से कवर होते हैं।

लॉगिन विफल: उपयोगकर्ता, पासवर्ड और बिलिंग कोड अपने Servientrega वाणिज्यिक सलाहकार से जाँचें। विफल लॉगिन के बाद प्लगइन अगले प्रयास से पहले 10 मिनट प्रतीक्षा करता है। तुरंत दोबारा कोशिश करने के लिए सेटिंग्स सहेजें।

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

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

डेवलपर्स के लिए: vfd_svtg_quote_request और vfd_svtg_default_dimensions फ़िल्टर कोट अनुरोध और बिना आयाम वाले उत्पादों के आयाम समायोजित करते हैं। vfd_svtg_api_base और vfd_svtg_soap_url एंडपॉइंट बदलते हैं, उदाहरण के लिए यदि Servientrega आपको कोई दूसरा सर्वर दे।

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

अनइंस्टॉल

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

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