VibeFox Servientrega for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x

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

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

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

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

इंस्टॉलेशन

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

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

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

4. लाइव दरों के लिए उपयोगकर्ता, पासवर्ड और बिलिंग कोड दर्ज करें, Servientrega उत्पाद चुनें, मूल स्थान का DANE कोड दर्ज करें और यदि आपकी स्टोर मुद्रा COP नहीं है तो मुद्रा रूपांतरण दर दर्ज करें। यदि आपके स्टोर में अभी कोलंबिया के विभाग नहीं हैं तो Add Colombian departments पर क्लिक करें (देखें कॉन्फ़िगरेशन)।

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

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

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

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

यदि सहेजी गई सेटिंग्स के साथ लाइव दरें काम नहीं कर सकतीं, तो फ़ॉर्म के ऊपर एक चेतावनी कारण बताती है: उपयोगकर्ता, पासवर्ड या बिलिंग कोड का न होना, रूपांतरण दर का न होना, या मूल स्थान का DANE कोड न होना। यदि आपकी स्टोर का वज़न या आयाम इकाई (International > Localization, Local units) मॉड्यूल को ज्ञात नहीं है, तब भी चेतावनी दिखती है; तब वज़न को kg और आयामों को cm माना जाता है। सेव करते समय, जो मान संख्या नहीं है, ऋणात्मक संख्या, 0 रूपांतरण दर, अधिकतम वज़न से बड़ा न्यूनतम वज़न, तालिका में गलत मूल्य, या 64 अक्षरों से लंबा विधि शीर्षक त्रुटि के साथ अस्वीकार कर दिया जाता है और कुछ भी सहेजा नहीं जाता।

सामान्य

Enable Servientrega: सभी ज़ोन में एक साथ कैरियर चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।

Method title: कार्ट और चेकआउट में ग्राहक को दिखने वाला कैरियर नाम। डिफ़ॉल्ट: Servientrega। अनिवार्य, अधिकतम 64 अक्षर।

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

User (login): आपका Servientrega / SISCLINET उपयोगकर्ता। इसे खाली करने पर सहेजा गया पासवर्ड भी हट जाता है।

Password: आपका Servientrega / SISCLINET पासवर्ड, जैसा आप टाइप करते हैं। लॉगिन से पहले मॉड्यूल इसे Servientrega वेब सेवा द्वारा एन्क्रिप्ट करवाता है। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

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 है तो खाली छोड़ें। यदि आपकी स्टोर कोई और मुद्रा इस्तेमाल करती है और यह फ़ील्ड खाली है, तो लाइव दरें नहीं ली जातीं और निश्चित मूल्य लागू होते हैं। मॉड्यूल विनिमय दरें नहीं लाता। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।

Colombian departments: विभाग एक ही नाम वाली नगरपालिकाओं में फ़र्क करने में मदद करता है। PrestaShop में डिफ़ॉल्ट रूप से कोलंबिया के विभाग नहीं होते; इनके बिना केवल वे शहर नाम पहचाने जाते हैं जो कोलंबिया में अद्वितीय हैं। Add Colombian departments पर क्लिक करें ताकि 33 विभाग कोलंबिया के राज्यों (states) के रूप में जुड़ जाएँ (ISO कोड ANT, DC…), कोलंबिया के लिए Contains states चालू करें और कोलंबियाई पता फ़ॉर्म में विभाग फ़ील्ड जोड़ें। जो विभाग पहले से मौजूद हैं, वे दोबारा नहीं जोड़े जाते। सब कुछ तैयार होने पर, फ़ील्ड बताता है कि कोलंबियाई पतों के कितने विभाग हैं।

Ship from (लाइव दरों के लिए उपयोग)

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

निश्चित मूल्य (जब कोई लाइव दर न हो तब उपयोग होते हैं: कोई क्रेडेंशियल नहीं, कोलंबिया के बाहर का गंतव्य, अज्ञात नगरपालिका, रूपांतरण दर का न होना, 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 0 से अधिक होने पर उस वज़न के लिए Price की जगह लेते हैं। * Default पंक्ति उन सभी देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। बिना किसी मूल्य वाली पंक्ति सहेजी नहीं जाती।

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

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

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

शर्तें

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

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

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

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

Tax: कैरियर का टैक्स नियम, या No tax। Servientrega के कोट (ValorTotal) में कैरियर के शुल्क पहले से शामिल होते हैं। यदि आप ऊपर से टैक्स नहीं जोड़ना चाहते तो No tax चुनें।

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

आमतौर पर कैरियर Shipping > Carriers में उसे सौंपे गए ज़ोन में दिया जाता है।

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

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

उन्नत

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

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

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

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

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

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

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

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

ग्राहक कभी API त्रुटि नहीं देखता। डीबग लॉग चालू होने पर कारण लॉग में लिखा जाता है।

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

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

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

मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Servientrega लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox Servientrega > Configure में सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक मास्क की हुई कुंजी, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: Check now स्थिति दोबारा जाँचने के लिए, Change key कोई दूसरी कुंजी दर्ज करने के लिए, और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: presta-shipping-servientrega वाली पंक्ति और 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 खाते में मुक्त करें।

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

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

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

चेकआउट पर Servientrega दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Servientrega चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है, या Ignore shipping zones चालू करके Countries जाँचें। वज़न सीमाएँ और Minimum order amount भी देखें। लाइव दर न होने पर, जाँचें कि देश या * Default पंक्ति का मूल्य है, या Fallback cost सेट है। उत्पाद पेज पर उत्पाद कुछ कैरियरों तक सीमित भी हो सकते हैं।

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

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

ग्राहक का शहर पहचाना नहीं जाता: Add Colombian departments पर क्लिक करें ताकि ग्राहक अपना विभाग चुन सकें। दुर्लभ वर्तनी के लिए ग्राहक 8 अंकों का DANE कोड पिन कोड के रूप में दर्ज कर सकता है।

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

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

डेवलपर्स के लिए: हुक actionVfdSvtgDaneCode और actionVfdSvtgQuoteRequest गंतव्य DANE कोड और कोट अनुरोध बदलने देते हैं।

अनइंस्टॉल

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

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