VibeFox iMile for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x तक।

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

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

iMile API खाता (केवल लाइव अनुमान के लिए): लाइव अनुमान iMile OpenAPI के "Estimated order delivery costs" का उपयोग करता है। आपको Customer ID और Secret key चाहिए (वह API कुंजी जो iMile आपके Customer ID के साथ जारी करता है)। टेस्ट क्लाइंट के लिए iMile डेवलपर पोर्टल (developer.imile.com) पर रजिस्टर करें। प्रोडक्शन कुंजियाँ आपके iMile अकाउंट मैनेजर से मिलती हैं। यदि आप केवल मूल्य तालिका इस्तेमाल करते हैं, तो आपको API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

4. Price table में अपनी iMile कीमतें दर्ज करें। वैकल्पिक रूप से Live rates (API) सेक्शन भरें और Live estimate चालू करें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।

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

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

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

जब Live estimate चालू हो लेकिन काम न कर सके, तो सेटिंग्स के ऊपर चेतावनियाँ दिखती हैं: Customer ID या Secret key खाली है, शिप-फ़्रॉम शहर या देश नहीं दिया गया है (या देश iMile बाज़ार नहीं है), विनिमय दरें नहीं हैं, या मूल्य तालिका खाली है और अन्य देशों के लिए कोई कीमत नहीं है। जब मॉड्यूल शॉप की वज़न इकाई नहीं पहचानता, तब भी चेतावनी दिखती है: तब उत्पादों के वज़न को किलोग्राम माना जाता है, इसलिए International > Localization (Local units) में इकाई सेट करें। सेव करते समय मॉड्यूल जाँचता है कि Method title मान्य है (अधिकतम 64 अक्षर), राशि और वज़न के फ़ील्ड 0 या उससे अधिक की संख्याएँ हैं, Minimum weight, Maximum weight से बड़ा नहीं है, और टैक्स नियम मौजूद है। नहीं तो वह त्रुटि दिखाता है और कुछ भी सेव नहीं करता।

सामान्य

Enable iMile: कैरियर चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।

Method title: कार्ट और चेकआउट में दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: iMile। आवश्यक।

लाइव दरें (API) (वैकल्पिक)

अगर iMile कोई अनुमान नहीं लौटाता (कुंजियाँ नहीं, शहर अभी दर्ज नहीं, त्रुटि, टाइमआउट, विनिमय दर नहीं), तो मूल्य तालिका इस्तेमाल होती है।

Live estimate: iMile से शिपिंग लागत पाने के लिए इसे चालू करें। डिफ़ॉल्ट: बंद। Live estimate बंद होने पर चेकआउट के दौरान iMile को कुछ भी नहीं भेजा जाता।

Environment: Production (openapi.imile.com) (डिफ़ॉल्ट) या Test (test-openapi.52imile.cn)। टेस्ट कुंजियाँ केवल टेस्ट सर्वर पर काम करती हैं और टेस्ट कीमतें देती हैं।

Customer ID: iMile द्वारा जारी क्लाइंट कोड (customerId), उदाहरण के लिए C2102192601। इसे साफ़ करने पर सहेजी गई Secret key भी साफ़ हो जाती है।

Secret key: iMile द्वारा Customer ID के साथ जारी की गई गुप्त कुंजी (API कुंजी)। यह अनुरोधों पर हस्ताक्षर करती है। सेव करने के बाद यह फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Signature: अनुरोधों पर हस्ताक्षर कैसे होंगे।

Ship-from country: वह देश जहाँ से आप भेजते हैं। डिफ़ॉल्ट रूप से यह आपकी शॉप का देश (Shop country) है। सूची में केवल वे देश होते हैं जिनके लिए मॉड्यूल के पास iMile देश कोड हैं।

Ship-from city: वह शहर जहाँ से आपके पार्सल भेजे जाते हैं, वैसे ही लिखा हुआ जैसे iMile शहर सूची में है (उदाहरण के लिए Dubai, Riyadh)। Shop Parameters > Contact > Stores में दिए गए शॉप शहर का उपयोग करने के लिए खाली छोड़ें।

Ship-from province: वैकल्पिक, उदाहरण के लिए Dubai या Riyadh Province।

iMile service: iMile को भेजा जाने वाला ऑर्डर प्रकार: Delivery order (100) (डिफ़ॉल्ट) या Express order (1100)। Express आपके खाते और देश के लिए सक्षम होना चाहिए।

Goods category: iMile को भेजे जाने वाले सामान का प्रकार: Normal goods (डिफ़ॉल्ट), Sensitive (cosmetics, liquids...), With battery, Batteries / power banks, Documents या Parcel।

Exchange rates: iMile गंतव्य देश की मुद्रा में अनुमान देता है। हर मुद्रा के लिए एक पंक्ति दर्ज करें, जिसमें आपकी शॉप की डिफ़ॉल्ट मुद्रा में 1 इकाई की कीमत हो, उदाहरण के लिए "AED = 0.25" या "SAR = 0.24"। दशमलव विभाजक के रूप में बिंदु या अल्पविराम दोनों स्वीकार हैं। शॉप की अपनी मुद्रा के लिए दर की ज़रूरत नहीं है। दर के बिना उस मुद्रा के अनुमान इस्तेमाल नहीं होते और उसकी जगह मूल्य तालिका ली जाती है। वही दर iMile को घोषित कार्ट मूल्य भी बदलती है। अमान्य पंक्तियाँ सेव करते समय हटा दी जाती हैं।

मूल्य (जब लाइव अनुमान बंद हो तब इस्तेमाल होते हैं, और जब iMile अनुमान नहीं लौटाता तब बैकअप के रूप में)

अपना iMile टैरिफ़ शॉप की डिफ़ॉल्ट मुद्रा में, कर को छोड़कर, दर्ज करें। यदि वह AED, SAR या किसी अन्य मुद्रा में है, तो पहले उसे बदलें।

Price table: गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर क्लिक करें और हटाने के लिए ट्रैश आइकन। जो देश अपनी पंक्ति में नहीं हैं, उन सबके लिए एक पंक्ति चुनने हेतु * All other countries चुनें। हर पंक्ति में एक Base price और वैकल्पिक वज़न कॉलम होते हैं: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg और XL >5 kg। खाली (या 0) वज़न कॉलम आधार मूल्य इस्तेमाल करता है। 0 आधार मूल्य का अर्थ है उस देश में मुफ़्त शिपिंग। "9.99" और "9,99" दोनों स्वीकार हैं। बिना किसी कीमत वाली पंक्तियाँ और ऋणात्मक कीमतें सेव करते समय हटा दी जाती हैं। हर देश के लिए केवल एक पंक्ति रखी जाती है।

Price for countries not in the table: शॉप की डिफ़ॉल्ट मुद्रा में एक कीमत। यह तब इस्तेमाल होती है जब तालिका में गंतव्य देश की पंक्ति नहीं है (और * पंक्ति भी नहीं), या जब पंक्ति में इस वज़न की कीमत नहीं है। उस स्थिति में कैरियर छिपाने के लिए खाली छोड़ें।

Price applies: तालिका की कीमत कैसे वसूल की जाती है।

वही चुनाव लाइव अनुमान पर भी लागू होता है: प्रति ऑर्डर पूरे कार्ट के साथ एक पार्सल भेजता है; प्रति आइटम हर अलग पार्सल के लिए अनुमान माँगता है और इकाइयों की संख्या से गुणा करता है। अगर कार्ट में 5 से अधिक अलग पार्सल हैं, तो मूल्य तालिका इस्तेमाल होती है।

उत्पादों का वज़न और आयाम आपकी शॉप की इकाइयों से किलोग्राम और सेंटीमीटर में बदले जाते हैं।

शर्तें

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

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

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

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

Tax: कैरियर का टैक्स नियम, या No tax। यदि तालिका की कीमतों और iMile अनुमानों में पहले से VAT शामिल है, तो No tax चुनें।

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

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

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

उन्नत

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

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

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

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

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

लाइव अनुमान चालू होने पर मॉड्यूल iMile को शिप-फ़्रॉम देश, प्रांत और शहर, गंतव्य देश, राज्य, शहर और पिन कोड, kg में कार्ट का वज़न, cm³ में आकार (उत्पाद आयामों से), कार्ट मूल्य, iMile सेवा और सामान श्रेणी भेजता है। अनुमान हमेशा प्रीपेड के रूप में माँगा जाता है, इसलिए कैश-ऑन-डिलीवरी शुल्क शामिल नहीं होते। लाइव अनुमान तभी माँगा जाता है जब ग्राहक शहर वाला डिलीवरी पता दर्ज कर चुका हो, और केवल तब जब कार्ट के हर उत्पाद का वज़न हो। हर उत्तर 1 घंटे तक कैश होता है। विफल अनुरोध 5 मिनट तक कैश होता है। टाइमआउट या सर्वर त्रुटि के बाद 2 मिनट तक iMile से नहीं पूछा जाता, और अस्वीकृत कुंजियों के बाद 5 मिनट तक, ताकि चेकआउट हर रीफ़्रेश पर iMile का इंतज़ार न करे। API टाइमआउट 12 सेकंड है। समाप्त हो चुका एक्सेस टोकन अपने आप नवीनीकृत होता है।

अनुमान आपकी विनिमय दरों से शॉप की डिफ़ॉल्ट मुद्रा में बदला जाता है। अगर iMile कोई उपयोगी अनुमान नहीं देता (कुंजियाँ सेट नहीं, शहर अभी दर्ज नहीं, अज्ञात शहर, त्रुटि, टाइमआउट, विनिमय दर नहीं), तो ग्राहक को कोई त्रुटि नहीं दिखती और तालिका की कीमत इस्तेमाल होती है। अगर तालिका में भी कीमत नहीं है, तो कैरियर छिप जाता है। कारण लॉग में लिखा जाता है। कीमत आपकी डिफ़ॉल्ट मुद्रा में गणना की जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

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

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

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

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

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

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

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

iMile अनुमान की जगह तालिका की कीमत दिखती है: Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। आम कारण: Live estimate बंद है, कुंजियाँ नहीं हैं, ग्राहक ने अभी शहर दर्ज नहीं किया, iMile शहर की वर्तनी नहीं पहचानता, उत्पादों का वज़न नहीं है, गंतव्य मुद्रा की विनिमय दर नहीं है, या API त्रुटि। सेटिंग्स के ऊपर की चेतावनियाँ भी देखें।

लॉग में "sign is invalid": Secret key जाँचें, फिर Signature = SimpleKey आज़माएँ।

कुंजियाँ अस्वीकार हो रही हैं: Customer ID, Secret key और Environment जाँचें। टेस्ट कुंजियाँ केवल टेस्ट सर्वर पर काम करती हैं।

शहर के नाम मेल नहीं खाते: शहर के नाम iMile शहर सूची से मेल खाने चाहिए। डेवलपर इन्हें actionVfdImileLiveRequest हुक से, और देश कोड actionVfdImileLiveCountryCode हुक से मैप कर सकते हैं।

कीमतें गलत मुद्रा में हैं: मूल्य तालिका शॉप की डिफ़ॉल्ट मुद्रा में है। AED, SAR या MXN टैरिफ़ दर्ज करते समय उसे बदलें। लाइव अनुमान Exchange rates से बदले जाते हैं।

शिपिंग पर टैक्स दो बार लगता है: अगर आपकी कीमतों में पहले से VAT शामिल है, तो Tax को No tax पर सेट करें।

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

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

अनइंस्टॉल

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

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