VibeFox Aramex for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Aramex खाता (केवल लाइव दरों के लिए): लाइव दरें Aramex Rate Calculator API का उपयोग करती हैं। Aramex अपने खाताधारकों को API एक्सेस देता है। अपने Aramex खाता प्रबंधक से पूछें या Aramex की वेबसाइट पर Aramex Developers Solution Center देखें। आपको छह मान चाहिए: API उपयोगकर्ता नाम (आमतौर पर एक ईमेल पता), पासवर्ड, खाता नंबर, खाता PIN, खाता entity (उदाहरण के लिए DXB) और खाते का देश कोड (उदाहरण के लिए AE)। यदि आप केवल देश के अनुसार निश्चित मूल्य इस्तेमाल करते हैं, तो आपको Aramex खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

4. चुनें कि शिपिंग लागत कैसे गिनी जाएगी, संबंधित सेक्शन भरें (देखें Configuration) और Save पर क्लिक करें।

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

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

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

सामान्य

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

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

Shipping cost: कीमत कैसे गिनी जाती है।

लाइव दर न मिलने का कारण डीबग लॉग में लिखा जाता है। यह ग्राहक को कभी नहीं दिखाया जाता।

Aramex API खाता (केवल लाइव दरों के लिए ज़रूरी; छहों फ़ील्ड आवश्यक हैं)

Username: आपका Aramex API उपयोगकर्ता नाम, आमतौर पर एक ईमेल पता।

Password: आपका Aramex API पासवर्ड। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it दिखाता है। केवल बदलना हो तो नया मान लिखें।

Account number: आपका Aramex ग्राहक खाता नंबर।

Account PIN: आपके Aramex खाते का PIN। पासवर्ड की तरह, सेव करने के बाद यह दोबारा नहीं दिखता।

Account entity: आपके Aramex खाते का entity (कार्यालय) कोड, उदाहरण के लिए DXB, AMM या RUH।

Account country code: आपके Aramex खाते का 2 अक्षरों वाला देश कोड, उदाहरण के लिए AE।

Aramex सेवा (लाइव दरों के लिए इस्तेमाल होती है)

अगर डिलीवरी पता मूल देश में है, तो शिपमेंट का अनुमान Domestic के रूप में लगाया जाता है। बाकी सभी शिपमेंट का अनुमान International express के रूप में लगाया जाता है।

International service: विदेश के शिपमेंट के लिए Aramex उत्पाद: PPX Priority Parcel Express (डिफ़ॉल्ट), PDX Priority Document Express, PLX Priority Letter Express, DPX Value Express Parcels, EPX Economy Parcel Express, EDX Economy Document Express, GPX Ground Parcel Express या GDX Ground Document Express।

Domestic service: मूल देश के भीतर के शिपमेंट के लिए Aramex उत्पाद: ONP Overnight Parcel (डिफ़ॉल्ट), OND Overnight Document, SMP Same Day Parcel, SMD Same Day Document, SDD Same Day Delivery, EMD Early Morning Delivery, PEC Economy Delivery, PEX Road Express या HVY Heavy (20 kg और उससे अधिक)।

Payment type: शिपमेंट के लिए Aramex को कौन भुगतान करता है: Prepaid (भेजने वाला भुगतान करता है), Collect (पाने वाला भुगतान करता है) या Third party (तीसरा पक्ष)। आमतौर पर Prepaid।

API weight unit: Aramex को भेजी जाने वाली इकाई, KG या LB। उत्पादों का वज़न और आकार आपकी स्टोर इकाइयों से बदला जाता है। बिलिंग वज़न वास्तविक वज़न और आयतनी वज़न (लंबाई × चौड़ाई × ऊँचाई cm में / 5000) में से बड़ा होता है। न्यूनतम 0.5 kg है, जो बिना वज़न वाले उत्पादों पर भी लागू होता है।

Currency conversion rate: Aramex से आपकी दुकान की डिफ़ॉल्ट मुद्रा में कीमत बताने का अनुरोध किया जाता है। यदि Aramex फिर भी किसी दूसरी मुद्रा में जवाब देता है, तो दर को इस संख्या से गुणा किया जाता है (Aramex मुद्रा की 1 इकाई = आपकी डिफ़ॉल्ट मुद्रा की X इकाइयाँ)। ऐसे उद्धरण अस्वीकार करने के लिए इसे खाली छोड़ें, ताकि ग्राहक से कभी गलत मुद्रा में शुल्क न लिया जाए।

भेजने का पता (मूल पता) (लाइव दरों के लिए इस्तेमाल होता है)

Origin country: वह देश जहाँ से आप भेजते हैं। डिफ़ॉल्ट रूप से यह आपकी दुकान का देश है।

Origin city: वह शहर जहाँ से आप भेजते हैं। Aramex इसे आवश्यक मानता है।

Origin state / emirate: वैकल्पिक।

Origin postcode: वैकल्पिक।

यदि मूल देश आपकी दुकान का देश है, तो खाली फ़ील्ड Shop Parameters > Contact > Stores में दुकान के पते से भर दिए जाते हैं।

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

Price per country: 2 अक्षरों वाले देश कोड और कीमतों की तालिका, आपकी दुकान की डिफ़ॉल्ट मुद्रा में, कर को छोड़कर। किसी देश को जोड़ने के लिए Add row पर क्लिक करें और हटाने के लिए ट्रैश आइकन पर। बाकी सभी देशों के लिए देश कोड के रूप में * इस्तेमाल करें। जिन देशों की कीमत नहीं है (यदि * वाली पंक्ति नहीं है), उन्हें निश्चित दर नहीं मिलती, इसलिए उनके लिए कैरियर छिप जाता है।

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

शर्तें

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

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

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

Free shipping: नीचे दी गई राशि से मुफ़्त Aramex डिलीवरी चालू करें।

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

Tax: कैरियर का कर नियम, या No tax। Aramex की लाइव दरों में पहले से VAT शामिल हो सकता है। ऐसे में कर दोबारा न लगे, इसके लिए No tax चुनें।

Countries: Aramex केवल इन गंतव्य देशों के लिए दें। कैरियर के ज़ोन के सभी देशों की अनुमति के लिए खाली छोड़ें।

उन्नत

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

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

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

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

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

निश्चित मोड में कीमत तालिका से ली जाती है। लाइव मोड में मॉड्यूल Aramex को मूल और डिलीवरी पते, बिलिंग वज़न, सेवा और आपकी डिफ़ॉल्ट मुद्रा भेजता है, और लौटाया गया कुल उपयोग करता है। लाइव दर तभी माँगी जाती है जब डिलीवरी पते में शहर या पोस्टकोड हो। कीमत आपकी डिफ़ॉल्ट मुद्रा में गिनी जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

हर जवाब 1 घंटे तक कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रीफ़्रेश पर Aramex का इंतज़ार न करे। API टाइमआउट 10 सेकंड है।

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

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

मॉड्यूल केवल दरों की गणना करता है। यह Aramex शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता और ग्राहक को Aramex कार्यालय चुनने नहीं देता। पार्सल हमेशा Aramex को एक टुकड़े के रूप में भेजा जाता है।

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: API क्रेडेंशियल गायब, Aramex त्रुटि कोड, मूल शहर न होना, डिलीवरी शहर या पोस्टकोड न होना, वज़न या राशि की सीमा, या दूसरी मुद्रा में कोटेशन। Aramex live rates, fixed prices if the API fails के साथ आपके समस्या ठीक करने तक ग्राहकों को निश्चित कीमत मिलती रहती है।

लॉग में ERR75 त्रुटि: Aramex ने लॉगिन अस्वीकार किया। अपने Aramex खाता प्रबंधक के साथ उपयोगकर्ता नाम, पासवर्ड, खाता नंबर, PIN, entity और देश कोड जाँचें।

दूसरी मुद्रा में कोटेशन अस्वीकार: Aramex ने आपकी डिफ़ॉल्ट मुद्रा से अलग मुद्रा में जवाब दिया। Currency conversion rate भरें, या Aramex से अपनी मुद्रा में कीमत बताने को कहें।

शिपिंग पर कर दोगुना लग रहा है: Aramex के कुल में VAT पहले से शामिल हो सकता है। Tax को No tax पर सेट करें।

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

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

अनइंस्टॉल

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

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