VibeFox UPS for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षित), या 4.0.2 और बाद के संस्करण (4.1.0.3 पर परीक्षित)।
PHP: 8.0 या उसके बाद का संस्करण, cURL एक्सटेंशन के साथ।
UPS Developer Portal ऐप (केवल लाइव दरों के लिए): UPS Developer Portal (developer.ups.com) में लॉग इन करें, "Rating" उत्पाद वाला एक ऐप बनाएँ, अपना UPS खाता लिंक करें और Client ID व Client Secret कॉपी करें। एक्सटेंशन OAuth 2.0 का उपयोग करता है। Access Key, उपयोगकर्ता नाम या पासवर्ड की ज़रूरत नहीं है। बातचीत से तय दरों के लिए आपको 6 अक्षरों वाला UPS खाता नंबर भी चाहिए। क्रेडेंशियल के बिना केवल निश्चित कीमतें इस्तेमाल होती हैं।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ही zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_ups-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_ups.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_ups-oc3-(version).ocmod.zip चुनें। एक्सटेंशन कोई OCMOD संशोधन नहीं जोड़ता, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में कॉपी भी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox UPS ढूँढें और Install (हरा + बटन) पर क्लिक करें।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।
4. Edit पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (License key देखें)।
5. Client ID और Client Secret, अपना UPS खाता नंबर (बातचीत से तय दरों के लिए) और Ship from पता दर्ज करें: पिन कोड, और अमेरिका व कनाडा के लिए 2 अक्षरों वाला राज्य कोड।
6. अगर आपके UPS खाते की मुद्रा स्टोर की डिफ़ॉल्ट मुद्रा से अलग है, तो UPS account currency और Exchange rate दर्ज करें।
7. चाहें तो बैकअप के रूप में निश्चित कीमतें दर्ज करें, Enable UPS shipping चालू करें और Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_ups.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox UPS ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और सेटिंग्स OpenCart 3 के चरण 4 से 7 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
इंस्टॉल करने के बाद, जब तक आप Enable UPS shipping चालू करके सेव नहीं करते, यह तरीका बंद रहता है। Ship from का देश शुरू में आपके स्टोर का देश होता है। अनइंस्टॉल के बाद एक्सटेंशन दोबारा इंस्टॉल करने पर, आपकी रखी गई UPS सेटिंग्स फिर से इस्तेमाल होती हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox UPS > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव से कैश किया गया UPS टोकन और दरें साफ़ हो जाती हैं। केवल इस एक्सटेंशन के लिए संशोधन अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं, कैश साफ़ कर सकते हैं या लॉग मिटा सकते हैं।
अगर नाम, कर वर्ग, सॉर्ट क्रम या जियो ज़ोन मान्य नहीं है, तो कुछ भी सेव नहीं होता और पेज कारण दिखाता है, जैसे Enter a valid name (64 characters max, without < > ; = # { }). Nothing was saved. अमान्य संख्याएँ (जैसे ऋणात्मक), गलत बॉक्स आकार, Min weight (kg) का Max weight (kg) से ऊपर होना, और ऐसे कीमत सेल जो संख्या नहीं हैं, सेव करते समय बताए जाते हैं: वह फ़ील्ड अपना पुराना मान रखता है और बाकी सेव हो जाता है। सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि Client ID और Client Secret में से केवल एक भरा है, कोई क्रेडेंशियल या निश्चित कीमत नहीं है (तब यह तरीका कभी नहीं दिखता), भेजने वाले का पिन कोड या राज्य गायब है, बिना खाता नंबर के खाता दरें चुनी गई हैं, विनिमय दर नहीं है, या स्टोर की वज़न या लंबाई इकाई एक्सटेंशन को पता नहीं है।
सामान्य
ये सेटिंग्स हर जियो ज़ोन पर लागू होती हैं। चेकआउट पर UPS एक शिपिंग विकल्प के रूप में दिया जाता है।
Enable UPS shipping: चेकआउट पर UPS को दिखाता या छिपाता है। डिफ़ॉल्ट: बंद।
Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: UPS। आवश्यक, अधिकतम 64 अक्षर, < > ; = # { } के बिना।
Tax class: शिपिंग लागत का कर वर्ग, या None (डिफ़ॉल्ट)। UPS दरें बिना करों के दी जाती हैं। कर वर्ग होने पर OpenCart अपना शिपिंग कर ऊपर से जोड़ता है।
Sort order: चेकआउट पर शिपिंग विधियों में UPS की स्थिति। एक पूर्ण संख्या।
UPS API (लाइव दरें)
Test mode: UPS के परीक्षण वातावरण का उपयोग करता है। परीक्षण दरें असली कीमतें नहीं हैं। लाइव दरों के लिए इसे बंद करें। डिफ़ॉल्ट: बंद।
Client ID: UPS Developer Portal में आपके ऐप का Client ID। इसे साफ़ करने से सेव किया गया Client Secret भी हट जाता है।
Client Secret: उसी ऐप का Client Secret। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
UPS account number: आपका 6 अक्षरों वाला UPS शिपर नंबर, जैसे A1B2C3। खाता (बातचीत से तय) दरों के लिए ज़रूरी है; प्रकाशित दरों के लिए वैकल्पिक।
Rates: कौन सी UPS कीमतें इस्तेमाल होंगी।
Measurement units: UPS को भेजी जाने वाली इकाइयाँ। स्टोर के वज़न और आकार बदले जाते हैं।
Residential delivery: ग्राहक के पतों को UPS के आवासीय अधिभार के साथ आवासीय पते के रूप में कोट करता है। अगर आप ज़्यादातर व्यवसायों को भेजते हैं तो इसे बंद करें। डिफ़ॉल्ट: चालू।
Box size (L x W x H): आपके स्टोर की लंबाई इकाई (फ़ील्ड के नाम में दिखाई गई) में वैकल्पिक बॉक्स आयाम, जैसे 30x20x15। UPS तब आयामी वज़न लागू करता है। केवल वज़न से कोट करने के लिए खाली छोड़ें।
UPS account currency: UPS भेजने वाले खाते के देश की मुद्रा में कोट करता है, जैसे अमेरिका के लिए USD, कनाडा के लिए CAD या यूरो क्षेत्र के लिए EUR। डिफ़ॉल्ट: USD।
Exchange rate: केवल तब ज़रूरी है जब UPS खाते की मुद्रा स्टोर की डिफ़ॉल्ट मुद्रा से अलग हो। खाते की मुद्रा की 1 इकाई का मूल्य आपकी डिफ़ॉल्ट मुद्रा में दर्ज करें, जैसे 0.92। इसके बिना ऐसी दरें इस्तेमाल नहीं होतीं और निश्चित कीमतें लागू होती हैं। विनिमय दरें अपने-आप अपडेट नहीं होतीं।
Cache: UPS टोकन उनकी समाप्ति तक कैश होते हैं (अधिकतम OpenCart कैश अवधि तक), दरें 1 घंटे, विफल अनुरोध 5 से 10 मिनट। तुरंत कैश खाली करने के लिए Clear cached UPS token and rates पर क्लिक करें।
Ship from (वह पता जहाँ से UPS पार्सल उठाता है या जहाँ आप पार्सल छोड़ते हैं; लाइव दरों के लिए उपयोग होता है)
Country: वह देश जहाँ से आप शिपिंग करते हैं। डिफ़ॉल्ट रूप से यह आपके स्टोर का देश है।
State / province code: 2 अक्षरों वाला कोड, अमेरिका और कनाडा के लिए ज़रूरी, जैसे NY, CA या ON। यह केवल इन दो देशों के लिए UPS को भेजा जाता है।
City: वह शहर जहाँ से आप शिपिंग करते हैं।
ZIP / postal code: वह पिन कोड जहाँ से आप शिपिंग करते हैं। UPS दरें कोट करने के लिए इसे चाहता है। OpenCart में स्टोर का पिन कोड नहीं होता, इसलिए इसे यहाँ दर्ज करें।
निश्चित कीमतें (जब कोई API क्रेडेंशियल दर्ज नहीं होते तब उपयोग होती हैं, और जब UPS कोई दर नहीं देता तब फ़ॉलबैक के रूप में; इस स्थिति में तरीका छिपाने के लिए दोनों खाली छोड़ें)
Country prices: स्टोर की डिफ़ॉल्ट मुद्रा में, बिना कर की कीमतें, गंतव्य देश के अनुसार। एक पंक्ति जोड़ने के लिए Add country पर क्लिक करें और एक पंक्ति हटाने के लिए हटाने वाला बटन। * Default (all other countries) किसी भी अन्य देश पर लागू होता है। एक वज़न कॉलम (XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg से ऊपर) उस कार्ट वज़न के लिए Price को बदल देता है। खाली सेल Price का उपयोग करते हैं। 0 का अर्थ मुफ़्त शिपिंग है। वज़न के लिए मान न होने वाली देश पंक्ति * पंक्ति पर चली जाती है। बिना किसी कीमत की पंक्तियाँ सेव नहीं होतीं।
Fallback cost: स्टोर की डिफ़ॉल्ट मुद्रा में एक निश्चित कीमत, जब कोई देश-आधारित कीमत मेल न खाए। इस स्थिति में तरीका छिपाने के लिए खाली छोड़ें।
Fixed price is: Per order (डिफ़ॉल्ट) पूरे कार्ट के वज़न के लिए कीमत एक बार लेता है। Per item (each item priced by its own weight x quantity) हर उत्पाद को उसके अपने वज़न (वज़न न होने पर डिफ़ॉल्ट वज़न) से तय करता है और उसकी मात्रा से गुणा करता है। UPS लाइव दरें हमेशा पूरे कार्ट के वज़न के लिए कोट होती हैं।
शर्तें
Free shipping from: वह कार्ट उप-योग (शिपिंग वाले उत्पाद, कूपन के बाद, कर से पहले) जिससे यह तरीका मुफ़्त है। तब UPS को कोई अनुरोध नहीं भेजा जाता। मुफ़्त शिपिंग कभी न देने के लिए खाली छोड़ें।
Minimum subtotal: यह तरीका तभी दिखाएँ जब कार्ट उप-योग कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Min weight (kg): इस तरीके के दिखने के लिए न्यूनतम कार्ट वज़न। 0 का अर्थ कोई सीमा नहीं (डिफ़ॉल्ट)।
Max weight (kg): इस कार्ट वज़न से ऊपर यह तरीका छिपाया जाता है। डिफ़ॉल्ट: 70, प्रति पैकेज UPS की सीमा (70 kg / 150 lbs)। 0 का अर्थ कोई सीमा नहीं, खाली का अर्थ 70।
Default product weight (kg): बिना वज़न वाले उत्पादों के लिए उपयोग होने वाला वज़न, UPS दरों, वज़न कॉलम और वज़न सीमाओं में। डिफ़ॉल्ट: 0.5। खाली का अर्थ भी 0.5 है।
Geo zone: UPS केवल इस जियो ज़ोन के पतों के लिए दें। All zones (डिफ़ॉल्ट) का अर्थ कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones के साथ उपयोग नहीं होता।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: जियो ज़ोन की जाँच नहीं करता। यह तरीका नीचे दिए देशों के लिए दिया जाता है।
Countries: उस मोड के लिए गंतव्य देश। खाली छोड़ने पर स्टोर के सभी सक्षम देश उपयोग होते हैं। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: API अनुरोधों और दर गणना को storage/logs/vfd_upsx_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_upsx_debug.log.php) में लॉग करता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ हमेशा दर्ज होती हैं, भले ही यह विकल्प बंद हो। क्रेडेंशियल, टोकन और ग्राहक के पते कभी लॉग नहीं होते। फ़ाइल 5 MB तक पहुँचने पर इसे vfd_upsx_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर, एक्सटेंशन हटाने से UPS सेटिंग्स, कैश किए गए टोकन और दरें, और लॉग हट जाते हैं। ऑर्डर के साथ सहेजी गई UPS सेवाएँ हमेशा रहती हैं। बंद होने पर, दोबारा इंस्टॉल करने के लिए सब कुछ रहता है।
आयात / निर्यात
Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। Client Secret निर्यात नहीं होता।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, जैसे किसी दूसरे स्टोर पर। मान सामान्य सेव की तरह जाँचे जाते हैं। सहेजा गया Client Secret बना रहता है।
चेकआउट पर यह कैसे काम करता है
जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह UPS की कीमत एक्सटेंशन से माँगता है। अगर Geo zone तय है और पता उसके बाहर है, तो UPS नहीं दिया जाता (Ignore shipping zones के साथ देशों की सूची तय करती है)। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: बाकी उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। उप-योग इन उत्पादों की कूपन छूट के बाद और कर से पहले की कीमत है। गिफ़्ट सर्टिफ़िकेट, रिवार्ड पॉइंट और स्टोर क्रेडिट गिने नहीं जाते। फिर एक्सटेंशन शर्तें जाँचता है: कार्ट वज़न और न्यूनतम उप-योग। अगर मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और UPS को कोई अनुरोध नहीं भेजा जाता।
एक्सटेंशन UPS से एक OAuth टोकन लेता है और उसकी समाप्ति तक रखता है। UPS द्वारा अस्वीकृत टोकन अपने-आप नवीनीकृत होता है और अनुरोध एक बार दोहराया जाता है। फिर वह पूरे कार्ट को एक पैकेज मानकर, आपके भेजने वाले पते से ग्राहक के पते तक की सभी सेवाएँ UPS Rating API से माँगता है। जिन देशों में OpenCart पिन कोड माँगता है, वहाँ अनुरोध तब तक रुकता है जब तक ग्राहक पिन कोड दर्ज न करे। अमेरिका से कनाडा या प्यूर्टो रिको के शिपमेंट के लिए UPS की ज़रूरत के अनुसार माल का मूल्य भेजा जाता है।
ग्राहक को सबसे सस्ती UPS सेवा वाला एक विकल्प दिखता है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में गिनी जाती है, उसके दशमलव तक गोल की जाती है, और चुने गए Tax class के कर के साथ ग्राहक की मुद्रा में दिखाई जाती है। UPS Access Point Economy कोट नहीं होती, क्योंकि एक्सटेंशन Access Point का पता नहीं लेता।
हर कोटेशन 1 घंटे तक कैश होता है। विफल अनुरोध 10 मिनट और विफल टोकन अनुरोध 5 मिनट तक याद रखे जाते हैं, ताकि किसी रुकावट से हर चेकआउट अपडेट धीमा न हो। HTTP टाइमआउट 15 सेकंड है।
अगर UPS कोई दर नहीं देता (API उपलब्ध नहीं, गलत क्रेडेंशियल, कोई सेवा नहीं, बिना विनिमय दर वाली दूसरी मुद्रा), तो कीमत Country prices से और फिर Fallback cost से आती है। अगर इनमें से कोई लागू नहीं होता, तो तरीका छिप जाता है। ग्राहक को UPS की त्रुटि के संदेश कभी नहीं दिखते। कारण डिबग लॉग में लिखा जाता है।
एक्सटेंशन केवल दरें गिनता है। यह UPS Access Point चयन नहीं देता, UPS लेबल या शिपमेंट नहीं बनाता, पिकअप बुक नहीं करता और पार्सल ट्रैक नहीं करता। यह कई UPS सेवाओं के बजाय एक विकल्प दिखाता है। बॉक्स में सामान भरने का कोई तर्क नहीं है: कार्ट को एक पैकेज के रूप में कोट किया जाता है। विनिमय दरें स्वचालित नहीं हैं।
OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में UPS चुनता है। यह तरीका OpenCart 3 जैसा ही काम करता है।
ऑर्डर
जब लाइव UPS दर पर ऑर्डर दिया जाता है, तो UPS सेवा ऑर्डर के साथ सहेजी जाती है। Sales > Orders के ऑर्डर पेज पर UPS service, जैसे UPS Ground, और Live rate (excl. tax) दिखाने वाला एक UPS पैनल होता है। ये मान ऑर्डर देते समय सहेजे जाते हैं। निश्चित कीमत या मुफ़्त शिपिंग वाले ऑर्डरों में ऐसा पैनल नहीं होता।
OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और ग्राहक हर बार दोबारा पुष्टि करने पर उसे अपडेट करता है। सहेजी गई UPS सेवा भी उसके साथ अपडेट होती है। अगर ग्राहक किसी दूसरी शिपिंग विधि पर जाता है, या कीमत निश्चित कीमत या मुफ़्त शिपिंग बन जाती है, तो सहेजी गई सेवा ऑर्डर से हटा दी जाती है। OpenCart 4 पर UPS पैनल History सेक्शन के ऊपर दिखता है।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox UPS लाइसेंस ब्लॉक Extensions > Extensions > Shipping > VibeFox UPS > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key फ़ील्ड में दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-shipping-ups लाइन और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल इस एक्सटेंशन के लिए Modify अनुमति वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँचा नहीं जा सकता, तो एक्सटेंशन आखिरी ज्ञात स्थिति पर काम करता रहता है।
एक कुंजी एक ही डोमेन पर काम करती है। अपने लाइसेंस और डोमेन आप अपने vibefox.net खाते में प्रबंधित करते हैं।
सक्रिय कुंजी के बिना UPS चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में यह विधि अब भी (unlicensed — visible to admins only) के चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना यह विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक याद दिलाने वाला संदेश दिखता है। × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की समय-सीमा समाप्त होने पर भी एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।
समस्या निवारण
UPS does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है और Enable UPS shipping चालू है। Geo zone जाँचें, या Ignore shipping zones चालू करके Countries जाँचें। वज़न सीमाएँ और Minimum subtotal जाँचें। काम करने वाले UPS क्रेडेंशियल के बिना इस तरीके को निश्चित कीमत (Country prices या Fallback cost) चाहिए। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।
Live rates do not appear: Edit पेज के ऊपर की चेतावनियाँ देखें। Debug log चालू करें, चेकआउट रिफ़्रेश करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। इसमें OAuth त्रुटियाँ (Client ID, Client Secret और Test mode जाँचें), UPS त्रुटि संदेश और मुद्रा की समस्याएँ दिखती हैं।
The rate is in USD but the store is not: UPS दरें भेजने वाले खाते की मुद्रा में लौटाता है। UPS account currency और Exchange rate सेट करें। विनिमय दर के बिना ऐसी दरें नज़रअंदाज़ होती हैं और निश्चित कीमत इस्तेमाल होती है।
"This measurement system is not valid for the selected country": Measurement units को Automatic (by ship-from country) पर रहने दें, या अपने भेजने वाले देश के लिए UPS जो इकाइयाँ चाहता है उन्हें चुनें।
The page warns about the weight or length unit: kg वाली कोई वज़न श्रेणी न होने पर अज्ञात वज़न इकाइयाँ kg के रूप में पढ़ी जाती हैं। System > Localisation > Weight Classes में kg की वज़न श्रेणी जोड़ें। स्टोर की अज्ञात लंबाई इकाई के कारण Box size cm के रूप में पढ़ा जाता है। स्टोर की लंबाई श्रेणी के रूप में cm, mm, m या in का उपयोग करें (System > Settings, Option टैब)।
Rates look outdated after a change: एक्सटेंशन पेज पर Save पर क्लिक करें या Clear cached UPS token and rates पर क्लिक करें।
The page says "Warning: You do not have permission to modify VibeFox UPS!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_ups (OpenCart 3) या extension/vfd_ups/shipping/vfd_ups (OpenCart 4) के लिए संशोधन अनुमति दें।
For developers: एक्सटेंशन OpenCart इवेंट चलाता है, जिन्हें दूसरे एक्सटेंशन सुन सकते हैं: vfd_ups/allowed_services और vfd_ups/excluded_services दिखाई जा सकने वाली UPS सेवाओं को सीमित करते हैं, vfd_ups/rate_request दर अनुरोध को बदलता है, vfd_ups/api_base_url API पता बदलता है, और vfd_ups/currency_codes UPS द्वारा लौटाए गए मुद्रा कोड को मैप करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox UPS के बगल में Uninstall (लाल − बटन) पर क्लिक करें। OpenCart हमेशा Enable UPS shipping, Sort order, Tax class और Geo zone रीसेट करता है। कैश किया गया UPS टोकन और दरें हमेशा हटाई जाती हैं। अगर Remove data on uninstall चालू है, तो UPS सेटिंग्स और डिबग लॉग भी हटाए जाते हैं। अगर यह बंद है, तो बाकी सेटिंग्स रहती हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर से इस्तेमाल होती हैं। ऑर्डर के साथ सहेजी गई UPS सेवाएँ कभी नहीं हटतीं, और मौजूदा ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox UPS के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
UPS उसके संबंधित मालिक का ट्रेडमार्क है। यह एक्सटेंशन UPS से संबद्ध नहीं है और न ही UPS द्वारा समर्थित है।