VibeFox Econt for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।
Econt: Econt अनुबंध या API कुंजी की ज़रूरत नहीं है। ऑफ़िस सूची Econt का सार्वजनिक नामावली डेटा है। Econt को केवल देश कोड भेजा जाता है, ग्राहक का कोई डेटा नहीं। e-Econt यूज़रनेम और पासवर्ड केवल तभी भरें जब Econt आपके स्टोर से प्राधिकरण माँगे। e-Econt लॉगिन का तरीका Econt डेवलपर पेज (econt.com/developers) पर बताया गया है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Econt ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. देश के अनुसार कीमतें सेट करें और अन्य विकल्प जाँचें (देखें कॉन्फ़िगरेशन), फिर Save पर क्लिक करें। कनेक्शन जाँचने के लिए Load offices from Econt now पर क्लिक करें।
इंस्टॉल के समय मॉड्यूल Delivery to an Econt office or Econtomat डिलीवरी समय टेक्स्ट के साथ Econt Express कैरियर बनाता है। कैरियर बुल्गारिया और रोमानिया के ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Econt > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। कीमत और शर्तें कैरियर के हर ज़ोन पर लागू होती हैं।
पेज के ऊपर मॉड्यूल चेतावनियाँ दिखाता है: Econt कैरियर नहीं मिला, डेमो API चालू है, बुल्गारिया या रोमानिया के लिए कोई कीमत सेट नहीं है (तब कैरियर कभी नहीं दिखाया जाता), किसी देश के लिए आखिरी ऑफ़िस अनुरोध विफल रहा, या आपके स्टोर की वज़न इकाई मॉड्यूल को ज्ञात नहीं है (तब वज़न kg माना जाता है; इकाई International > Localization में Local units के तहत सेट करें)। संख्या फ़ील्ड दशमलव कॉमा स्वीकार करते हैं, उदाहरण के लिए 5,99। अगर संख्या फ़ील्ड में ऐसा कुछ हो जो संख्या या ऋणात्मक संख्या नहीं है, या Minimum weight (kg), Maximum weight (kg) से बड़ा है, तो एक त्रुटि फ़ील्ड का नाम बताती है और कुछ भी सेव नहीं होता।
सामान्य
Enable/Disable: Econt डिलीवरी चालू या बंद करता है। यह वही स्विच है जो Shipping > Carriers में कैरियर की स्थिति है।
Name: कार्ट और चेकआउट में दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Econt Express। आवश्यक, अधिकतम 64 अक्षर।
Tax: कैरियर का टैक्स नियम, या No tax। PrestaShop नीचे की कीमतों पर यह टैक्स जोड़ता है। No tax होने पर कीमतें अंतिम होती हैं।
Econt ऑफ़िस सूची
ऑफ़िस और Econtomat, Econt API से लोड होते हैं और 24 घंटे तक कैश रहते हैं।
Demo API: परीक्षण डेटा वाला Econt डेमो API उपयोग करता है। लाइव स्टोर पर इसे बंद रखें। डेमो ऑफ़िस के ID असली ऑफ़िस से अलग होते हैं। डेमो मोड में, जब कोई लॉगिन सेट न हो, तब Econt का सार्वजनिक परीक्षण खाता उपयोग होता है।
Econt username: वैकल्पिक। HTTP Basic प्राधिकरण के लिए आपका e-Econt लॉगिन।
Econt password: वैकल्पिक। यह स्टोर के डेटाबेस में सेव होता है और कभी लॉग में नहीं लिखा जाता। सेव करने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया हुआ पासवर्ड हटाने के लिए Remove the saved password पर टिक लगाकर सेव करें।
Office list: हर देश के लिए कैश किए गए ऑफ़िस की संख्या और वे कब लोड हुए, यह दिखाता है। Load offices from Econt now बटन सूचियाँ तुरंत फिर से लोड करता है और परिणाम देश के अनुसार दिखाता है। लोड विफल होने पर पिछली सफल लोडिंग के ऑफ़िस रखे जाते हैं। इस बटन के बिना, सूची पहले चेकआउट पर अपने-आप लोड होती है। Demo API, यूज़रनेम या पासवर्ड बदलने पर कैश की गई सूचियाँ मिट जाती हैं।
चेकआउट पर ऑफ़िस चयनकर्ता
Show: ग्राहक कौन-से बिंदु चुन सकते हैं।
City order: सबसे बड़े शहर पहले दिखाता है (सोफ़िया, प्लोवदीव, वर्ना, बुखारेस्ट और अन्य)। बंद होने पर शहर वर्णमाला क्रम में होते हैं। डिफ़ॉल्ट: चालू।
City list width: शहर सूची की CSS चौड़ाई, जैसे 100% या 300px। डिफ़ॉल्ट: 100%।
Office list width: ऑफ़िस सूची की CSS चौड़ाई, जैसे 100% या 400px। डिफ़ॉल्ट: 100%।
कीमतें (सेक्शन शीर्षक में आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखती है)
कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स रहित होती हैं। मॉड्यूल Econt से लाइव दरें नहीं माँगता। बुल्गारिया 1 जनवरी 2026 से यूरो का उपयोग करता है, इसलिए बुल्गारियाई स्टोर आमतौर पर EUR में कीमतें दर्ज करता है।
Price per country: हर पंक्ति में एक देश (या कॉमा से अलग): देश कोड, कोलन, कीमत, जैसे BG:5.99 और RO:8.99 (ये डिफ़ॉल्ट हैं)। दशमलव कॉमा भी चलेगा: BG:5,99। कीमत 0 हो तो डिलीवरी मुफ़्त होती है। फ़ील्ड खाली हो तो डिफ़ॉल्ट कीमतें BG:5.99 और RO:8.99 इस्तेमाल होती हैं (Ignore zones के साथ, कैरियर ज़ोन के बाहर के देशों को तब कोई कीमत नहीं मिलती)। किसी और प्रारूप की प्रविष्टियाँ अनदेखी होती हैं और सेव करते समय चेतावनी में सूचीबद्ध होती हैं। बाकी सेव हो जाता है।
Calculation: Per order कीमत एक बार लेता है। Per item (price x quantity) कीमत को उन आइटम की संख्या से गुणा करता है जिन्हें शिपिंग चाहिए।
Price for other countries: उस Econt देश (बुल्गारिया या रोमानिया) के लिए उपयोग होती है जो ऊपर सूचीबद्ध नहीं है। खाली या 0 होने पर उस देश में कैरियर छिप जाता है।
शर्तें
कार्ट सबटोटल का अर्थ है वे उत्पाद जिन्हें शिपिंग चाहिए, छूट के बाद और टैक्स से पहले।
Free shipping from: वह कार्ट सबटोटल जिससे डिलीवरी मुफ़्त होती है। कभी मुफ़्त डिलीवरी न देने के लिए इसे खाली छोड़ें।
Minimum subtotal: कैरियर तभी दिखाएँ जब कार्ट सबटोटल कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Minimum weight (kg): हल्के कार्ट के लिए कैरियर छिपाएँ। उत्पादों का वज़न आपके स्टोर की वज़न इकाई से kg में बदला जाता है। कोई सीमा न रखने के लिए खाली छोड़ें।
Maximum weight (kg): भारी कार्ट के लिए कैरियर छिपाएँ। कोई सीमा न रखने के लिए खाली छोड़ें।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore zones: जब डिलीवरी पते का ज़ोन कैरियर से जुड़ा न हो, तब भी नीचे दिए देशों में Econt ऑफ़र करें। चालू करने पर कैरियर हर सक्रिय ज़ोन से जुड़ जाता है, और बाद में बने ज़ोन भी जुड़ते हैं। फिर से बंद करने पर कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं। जो ज़ोन जुड़े थे वे सामान्य रूप से चलते रहते हैं। Econt केवल बुल्गारिया और रोमानिया के लिए ऑफ़र होता है।
Countries: बुल्गारिया और/या रोमानिया। यह केवल Ignore zones के साथ उपयोग होता है। कुछ भी चिह्नित न हो तो स्टोर जिन सभी Econt देशों में शिपिंग करता है, वे शामिल होते हैं।
उन्नत
Debug log: डीबग संदेश मॉड्यूल फ़ोल्डर में logs/vfd_ecn_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। API त्रुटियाँ हमेशा दर्ज होती हैं। पासवर्ड या ग्राहक डेटा नहीं लिखा जाता।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से Econt सेटिंग्स, कैरियर और लॉग हट जाते हैं। बंद होने पर सेटिंग्स दोबारा इंस्टॉल के लिए रहती हैं। ऑर्डर में सेव किए गए ऑफ़िस हमेशा रहते हैं।
चेकआउट पर यह कैसे काम करता है
कैरियर केवल बुल्गारिया और रोमानिया के लिए ऑफ़र होता है। शिपिंग चरण में PrestaShop मॉड्यूल से Econt की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल वज़न सीमाएँ और न्यूनतम सबटोटल जाँचता है, फिर देश की कीमत लेता है। अगर कार्ट सबटोटल Free shipping from तक पहुँचे, तो कीमत 0 होती है। अगर देश के लिए ऑफ़िस सूची उपलब्ध न हो, तो कैरियर छिपा दिया जाता है, क्योंकि डिलीवरी हमेशा ऑफ़िस पर होती है। कीमत डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।
जब ग्राहक Econt चुनता है, तो कैरियर के नीचे दो सूचियाँ दिखती हैं: City और Office / Econtomat। ऑफ़िस सूची हर पेज पर एक बार लोड होती है, और केवल तब जब Econt चुना गया हो। Econtomat सूची में चिह्नित होते हैं। चुनाव तुरंत कार्ट में सेव होता है। अगर ऑफ़िस सूची लोड न हो सके, तो ग्राहक को Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method. दिखता है।
जब ग्राहक शिपिंग चरण में Continue पर क्लिक करता है, तो मॉड्यूल सर्वर पर जाँचता है कि ऑफ़िस चुना गया है और वह डिलीवरी देश की Econt सूची में मौजूद है (Show के अनुसार फ़िल्टर होकर)। ऑफ़िस न चुने जाने पर ग्राहक को Please select an Econt office or Econtomat. दिखता है। सूची में न होने वाला ऑफ़िस The selected Econt office is not available for the shipping country. Please select it again. के साथ अस्वीकार होता है। ऑफ़िस का नाम हमेशा Econt सूची से लिया जाता है, ब्राउज़र से नहीं। चयनकर्ता Classic थीम और Hummingbird के साथ काम करता है।
ऑफ़िस सूची लाइव और डेमो API के लिए अलग-अलग 24 घंटे तक कैश रहती है। अगर Econt से संपर्क न हो, तो आखिरी सफल सूची इस्तेमाल होती है और 10 मिनट तक Econt से दोबारा नहीं पूछा जाता। API टाइमआउट 15 सेकंड है। ऑफ़िस सूची https://ee.econt.com/services/ (लाइव) या https://demo.econt.com/ee/services/ (डेमो) से आती है।
अगर ऑर्डर होने के बाद आप Shipping > Carriers में कैरियर संपादित करते हैं, तो PrestaShop उसे नए कैरियर संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।
मॉड्यूल केवल निश्चित कीमतें इस्तेमाल करता है। यह Econt से लाइव कीमतें नहीं माँगता, वेबिल या लेबल नहीं बनाता, कूरियर नहीं बुलाता, पार्सल ट्रैक नहीं करता, कैश ऑन डिलीवरी नहीं संभालता और किसी पते पर डिलीवरी नहीं करता। केवल बुल्गारिया और रोमानिया की ऑफ़िस सूची है।
पिकअप बिंदु
ऑर्डर देते समय, कार्ट के लिए चुना गया ऑफ़िस ऑर्डर के साथ सेव होता है: शहर, ऑफ़िस का नाम और पता, और Econt ऑफ़िस कोड। e-Econt में शिपमेंट बनाते समय ऑफ़िस कोड का उपयोग करें।
बैक ऑफ़िस ऑर्डर पेज: Econt office / Econtomat ब्लॉक में ऑफ़िस और Office code दिखते हैं। Change के अंतर्गत ऑर्डर के देश का दूसरा शहर और ऑफ़िस चुनें और Save पर क्लिक करें। बदलाव तुरंत सेव होता है और एक निजी ऑर्डर संदेश पुराना और नया ऑफ़िस दर्ज करता है। अगर ऑफ़िस चुने बिना Save पर क्लिक करें, तो ब्लॉक में Select a city and an office first - nothing was changed. लिखा आता है। ऑर्डर संपादित करने की अनुमति वाला कोई भी कर्मचारी ऑफ़िस बदल सकता है; मॉड्यूल पेज का एक्सेस ज़रूरी नहीं है। अगर ऑफ़िस सूची लोड न हो सके, तो ब्लॉक Econt offices cannot be loaded right now. दिखाता है।
एक ही कार्ट से कई ऑर्डर: ऑफ़िस पहले ऑर्डर का होता है। उसी कार्ट से दिया गया दूसरा ऑर्डर ऑफ़िस नहीं पाता: लॉग में एक त्रुटि लिखी जाती है, और उसके ब्लॉक में बताया जाता है कि इस कार्ट का ऑफ़िस किसी और ऑर्डर का है। ऑफ़िस ग्राहक के साथ तय करें और e-Econt में शिपमेंट हाथ से बनाएँ।
ग्राहक: ऑफ़िस ग्राहक के ऑर्डर पेज और ऑर्डर पुष्टि पेज पर दिखता है, और ऑर्डर पुष्टि ईमेल तथा स्टोर को भेजे गए नए ऑर्डर ईमेल में कैरियर के नाम के साथ जुड़ जाता है।
ऑफ़िस के नाम, जब स्टोर की भाषा बुल्गारियाई या रोमानियाई हो, तब स्थानीय भाषा में (बुल्गारिया के लिए सिरिलिक में) दिखते हैं, और बाकी स्थितियों में अंग्रेज़ी में।
लाइसेंस कुंजी
मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Econt, Modules > Module Manager > VibeFox Econt > Configure का पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और बटन Check now स्थिति फिर से जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। उनके नीचे Product: presta-shipping-econt वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Econt कैरियर चेकआउट पर ग्राहकों को नहीं दिखता और कोई दर नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। कोई cron जॉब ज़रूरी नहीं है। मॉड्यूल अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
चेकआउट पर Econt नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है, और डिलीवरी देश बुल्गारिया या रोमानिया है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है (या Ignore zones चालू करें और Countries जाँचें)। जाँचें कि देश के लिए कीमत, वज़न सीमाएँ और Minimum subtotal सेट हैं। सेटिंग्स में Office list की पंक्ति देखें: देश के लिए ऑफ़िस सूची उपलब्ध न होने तक कैरियर छिपा रहता है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।
ऑफ़िस सूची लोड नहीं होती: Load offices from Econt now पर क्लिक करें और परिणाम पढ़ें, या सेटिंग्स पेज के ऊपर की चेतावनी देखें। त्रुटियाँ हमेशा लॉग में लिखी जाती हैं; अधिक विवरण के लिए Debug log चालू करें और Log फ़ील्ड देखें। अगर Econt आपके स्टोर के लिए प्राधिकरण माँगता है, तो Econt username और Econt password भरें।
ग्राहकों को परीक्षण ऑफ़िस दिखते हैं: Demo API चालू है। लाइव स्टोर पर इसे बंद करें।
कीमतें किस मुद्रा में हैं? आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स रहित। ग्राहक उन्हें अपनी कार्ट मुद्रा में देखते हैं।
कीमत के ऊपर टैक्स लगता है: कैरियर का एक टैक्स नियम है। अगर आपकी कीमतों में VAT पहले से शामिल है, तो Tax को No tax पर सेट करें।
पेज कहता है कि Econt कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटा दिया गया था। इसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox Econt के बगल वाला मेन्यू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटती हैं। कैश की गई ऑफ़िस सूचियाँ हमेशा हटती हैं। अगर Remove data on uninstall चालू है, तो कैरियर हटाया जाता है (ऑर्डर अपना इतिहास रखते हैं) और सेटिंग्स तथा लॉग हटाए जाते हैं। अगर बंद है, तो कैरियर केवल निष्क्रिय होता है और सभी सेटिंग्स रहती हैं। मॉड्यूल फिर से इंस्टॉल करने पर सेव किया गया कैरियर उसी स्थिति के साथ लौट आता है। मॉड्यूल रीसेट करने पर कैरियर की मौजूदा स्थिति बनी रहती है। ऑर्डर में सेव किए गए ऑफ़िस हमेशा रहते हैं।
Econt, उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Econt से संबद्ध नहीं है और न ही Econt द्वारा समर्थित है।