VibeFox FedEx for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और बाद का संस्करण (4.1.0.3 पर परीक्षित)।

PHP: cURL एक्सटेंशन के साथ 8.0 या बाद का संस्करण।

FedEx खाता और API कुंजियाँ (केवल लाइव दरों के लिए): FedEx Developer Portal (developer.fedex.com) पर Rate API के साथ एक प्रोजेक्ट बनाएँ, अपना FedEx शिपिंग खाता जोड़ें और API Key तथा Secret Key कॉपी करें। आपको अपना 9 अंकों वाला FedEx खाता नंबर भी चाहिए। टेस्ट कुंजियाँ केवल तब काम करती हैं जब Sandbox चालू हो, और प्रोडक्शन कुंजियाँ केवल तब जब वह बंद हो। एक्सटेंशन OAuth 2.0 के साथ FedEx REST API का उपयोग करता है; इसे मीटर नंबर या वेब सेवाओं के पासवर्ड की ज़रूरत नहीं है। यदि आप केवल निश्चित कीमतें इस्तेमाल करते हैं, तो आपको FedEx कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_fedex-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_fedex.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_fedex-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए आपको Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox FedEx खोजें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।

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

5. API Key, Secret Key, 9 अंकों वाला FedEx खाता नंबर और Ship from पता (ZIP और, अमेरिका और कनाडा के लिए, 2 अक्षरों वाला राज्य) दर्ज करें। प्रोडक्शन कुंजियाँ इस्तेमाल करते समय Sandbox बंद करें। चाहें तो फ़ॉलबैक के रूप में निश्चित कीमतें दर्ज करें। Enable/Disable चालू करें और Save पर क्लिक करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_fedex.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 फ़ाइल के नाम से एक्सटेंशन कोड लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल हुए एक्सटेंशन की सूची में दिखाई देता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox FedEx खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. OpenCart 3 के चरण 4 और 5 की तरह लाइसेंस कुंजी और सेटिंग्स दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

इंस्टॉल के बाद, जब तक आप Enable/Disable चालू करके सेव नहीं करते, तब तक विधि बंद रहती है। यदि आप अनइंस्टॉल के बाद एक्सटेंशन फिर से इंस्टॉल करते हैं, तो आपकी रखी गई FedEx सेटिंग्स फिर से इस्तेमाल होती हैं।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox FedEx > Edit। खंड बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव FedEx टोकन और कैश्ड दरों को भी साफ़ करता है। केवल वे एडमिन उपयोगकर्ता जिनके पास इस एक्सटेंशन के लिए संशोधन की अनुमति है, सेटिंग्स सेव कर सकते हैं।

पेज के शीर्ष पर एक्सटेंशन ये चेतावनियाँ दिखाता है: तीन API क्रेडेंशियल में से कुछ ही भरे हैं, न API कुंजियाँ हैं न निश्चित कीमतें (तब विधि कभी नहीं दिखती), कोई ship-from ZIP नहीं है, अमेरिका या कनाडा के लिए ship-from राज्य नहीं है, FedEx खाते की मुद्रा में दरों के लिए स्टोर की मुद्रा में विनिमय दर नहीं है, कोई kg वज़न श्रेणी न होने पर एक्सटेंशन के लिए अज्ञात वज़न इकाई है (इसे System > Localisation > Weight Classes में जोड़ें), या बॉक्स साइज़ होने पर अज्ञात लंबाई इकाई है। संख्या वाले फ़ील्ड दशमलव बिंदु या अल्पविराम दोनों स्वीकार करते हैं। सेव करते समय गलत संख्या या बॉक्स साइज़, 0 की विनिमय दर, 3 अक्षरों का कोड न होने वाली खाता मुद्रा, या गलत नाम या क्रम की सूचना दी जाती है और वह सेव नहीं होता; फ़ील्ड अपना पिछला मान रखता है और बाकी फ़ील्ड सेव हो जाते हैं (The other settings were saved.)। न्यूनतम वज़न अधिकतम से अधिक हो तो उसकी भी सूचना दी जाती है, और दोनों वज़न अपने पिछले मान रखते हैं।

सामान्य

ये सेटिंग्स हर जियो ज़ोन पर लागू होती हैं। FedEx चेकआउट पर एक शिपिंग विकल्प के रूप में दिया जाता है: सबसे सस्ती FedEx सेवा, या जब FedEx कोई दर न दे तब निश्चित कीमत।

Enable/Disable: चेकआउट पर FedEx शिपिंग चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Name: चेकआउट पर ग्राहक को दिखाया जाने वाला शिपिंग विधि का नाम, अधिकतम 64 अक्षर, बिना < > ; = # { } के। डिफ़ॉल्ट: FedEx। आवश्यक।

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। टैक्स क्लास होने पर OpenCart शिपिंग लागत पर टैक्स जोड़ता है, इसलिए बिना टैक्स वाली FedEx राशि इस्तेमाल होती है। No tax होने पर FedEx की शुद्ध राशि जैसी है वैसी ही इस्तेमाल होती है।

Sort order: चेकआउट पर शिपिंग विधियों के बीच FedEx की स्थिति। एक पूर्णांक।

FedEx API (लाइव दरें)

यह खंड FedEx Developer Portal से लिंक करता है। कुंजियों के बिना निश्चित कीमतें इस्तेमाल होती हैं।

Sandbox: टेस्ट कुंजियों के साथ FedEx सैंडबॉक्स (apis-sandbox.fedex.com) इस्तेमाल करता है। असली दरों (apis.fedex.com) के लिए प्रोडक्शन कुंजियों के साथ इसे बंद करें। डिफ़ॉल्ट: चालू।

API Key: आपके FedEx Developer Portal प्रोजेक्ट की API Key (client_id)। इसे साफ़ करने से सेव की गई Secret Key भी हट जाती है।

Secret Key: उसी प्रोजेक्ट की Secret Key (client_secret)। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. Clearing the API Key removes it too. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

FedEx account number: प्रोजेक्ट से जुड़ा 9 अंकों वाला FedEx शिपिंग खाता। खाते (नेगोशिएटेड) की दरें इसी के लिए निकाली जाती हैं।

Rates: Account rates (your negotiated FedEx prices) (डिफ़ॉल्ट) या List rates (FedEx published prices)।

Residential delivery: ग्राहक के पते को आवासीय मानकर दरें निकालता है (FedEx Home Delivery, आवासीय अधिभार)। यदि आप ज़्यादातर व्यवसायों को भेजते हैं, तो इसे बंद करें। डिफ़ॉल्ट: चालू।

Box size (L x W x H): वैकल्पिक बॉक्स के आयाम, फ़ील्ड के नाम में दिखाई गई स्टोर की लंबाई इकाई में, जैसे 30x20x15। तब FedEx डाइमेंशनल वज़न लागू करता है। केवल वज़न के आधार पर दर निकालने के लिए खाली छोड़ें।

FedEx account currency: आपके FedEx खाते की मुद्रा, जैसे अमेरिकी खातों के लिए USD या कनाडा के लिए CAD। डिफ़ॉल्ट: USD। FedEx से हमेशा स्टोर की डिफ़ॉल्ट मुद्रा में भी कोटेशन देने को कहा जाता है।

Exchange rate: केवल तभी ज़रूरी है जब FedEx केवल खाते की मुद्रा में दरें दे और आपकी स्टोर डिफ़ॉल्ट मुद्रा अलग हो: खाते की मुद्रा की 1 इकाई का आपकी डिफ़ॉल्ट मुद्रा में मान, जैसे 0.92। इसके बिना ऐसी दरें इस्तेमाल नहीं होतीं, और किसी दूसरी मुद्रा की राशि कभी आपकी मुद्रा के रूप में नहीं दिखाई जाती।

Cache: बटन Clear cached FedEx token and rates कैश को तुरंत खाली कर देता है। FedEx टोकन समाप्त होने तक कैश रहते हैं, दरें 1 घंटे और विफल अनुरोध 5 से 10 मिनट तक।

Ship from

वह पता जहाँ से FedEx पिकअप करता है या जहाँ आप पार्सल छोड़ते हैं। यह लाइव दरों के लिए इस्तेमाल होता है।

Country: वह देश जहाँ से आप शिप करते हैं। डिफ़ॉल्ट: United States।

State / province code: 2 अक्षरों वाला कोड, अमेरिका और कनाडा के लिए आवश्यक, जैसे TN, CA या ON।

City: शिप-फ़्रॉम शहर।

ZIP / postal code: शिप-फ़्रॉम पोस्टल कोड। FedEx को दरें निकालने के लिए इसकी ज़रूरत होती है। OpenCart में स्टोर का पोस्टल कोड नहीं होता, इसलिए इसे यहाँ दर्ज करें।

निश्चित कीमतें

तब इस्तेमाल होती हैं जब कोई API कुंजी दर्ज न हो, और तब फ़ॉलबैक के रूप में जब FedEx कोई दर न दे (API बंद है, गलत कुंजियाँ, कोई सेवा नहीं)। उस स्थिति में विधि छिपाने के लिए दोनों फ़ील्ड खाली छोड़ें।

Country prices: गंतव्य देशों और कीमतों की सूची, स्टोर की डिफ़ॉल्ट मुद्रा में, बिना टैक्स के। पंक्ति जोड़ने के लिए Add row पर क्लिक करें और हटाने के लिए × बटन। ऐसे हर देश के लिए जिसकी अपनी पंक्ति नहीं है, कीमत के लिए * Any other country चुनें। बिना वैध देश या कीमत वाली पंक्तियाँ अनदेखी की जाती हैं और सेव करते समय उनकी सूचना दी जाती है।

Fallback cost: जब कोई देश-वार कीमत मेल न खाए, तब लागू होने वाली निश्चित कीमत। विधि छिपाने के लिए खाली छोड़ें।

Fixed price is: Per order (डिफ़ॉल्ट) कीमत एक बार लेता है। Per item (price x number of items) इसे कार्ट में आइटमों की संख्या से गुणा करता है। यह केवल निश्चित कीमतों पर लागू होता है। FedEx की लाइव दरें हमेशा पूरे कार्ट के वज़न के लिए निकाली जाती हैं।

शर्तें

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

Minimum subtotal: विधि तभी दिखाएँ जब वही सबटोटल कम से कम इस राशि का हो। हमेशा दिखाने के लिए खाली छोड़ें।

Min weight (kg): विधि दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।

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

Default product weight (kg): बिना वज़न वाले उत्पादों के लिए इस्तेमाल होने वाला वज़न, FedEx दरों के लिए, और ऊपर की वज़न सीमाओं के लिए। डिफ़ॉल्ट: 0.5; खाली फ़ील्ड का भी अर्थ है 0.5 kg। उत्पादों का वज़न हर उत्पाद की वज़न श्रेणी से बदला जाता है।

Geo zone: FedEx केवल इस जियो ज़ोन के पतों के लिए पेश करता है। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones चालू होने पर इसका उपयोग नहीं होता।

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

Ignore shipping zones: जियो ज़ोन की जाँच किए बिना नीचे के देशों के लिए विधि पेश करता है। डिफ़ॉल्ट: बंद।

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

उन्नत

Debug log: API अनुरोध और दर गणनाएँ storage/logs/vfd_fdx_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_fdx_debug.log.php) में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ लॉग बंद होने पर भी हमेशा दर्ज होती हैं। कुंजियाँ, टोकन, खाता नंबर और ग्राहक के पते कभी दर्ज नहीं होते। फ़ाइल 5 MB तक पहुँचने पर उसे vfd_fdx_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।

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

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

आयात / निर्यात

Export: सेटिंग्स को JSON फ़ाइल के रूप में सेव करने के लिए Download JSON पर क्लिक करें। Secret Key निर्यात नहीं होती।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मानों की जाँच सामान्य सेव की तरह होती है। सेव की गई Secret Key बनी रहती है।

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से FedEx की कीमत माँगता है। यदि कोई Geo zone सेट है (और Ignore shipping zones बंद है) और पता उसके बाहर है, तो FedEx पेश नहीं होता। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: बाकी उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। सबटोटल इन उत्पादों की कीमत है, कूपन छूट के बाद और टैक्स से पहले; गिफ़्ट सर्टिफ़िकेट, रिवॉर्ड पॉइंट और स्टोर क्रेडिट को ध्यान में नहीं रखा जाता। फिर एक्सटेंशन अनुमत देशों (Ignore shipping zones के साथ), कार्ट के वज़न और न्यूनतम सबटोटल की शर्तें जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और FedEx को कोई अनुरोध नहीं जाता।

अन्यथा, यदि API Key, Secret Key और खाता नंबर सेट हैं, तो एक्सटेंशन एक OAuth टोकन लेता है और FedEx Rate API को ship-from पता, डिलीवरी पता, कार्ट का वज़न (kg में, या जिन स्टोर्स की वज़न श्रेणी lb या oz है उनके लिए lb में), बॉक्स साइज़ यदि सेट है, और पसंदीदा मुद्रा के रूप में आपकी डिफ़ॉल्ट मुद्रा भेजता है। OpenCart में जिन देशों के लिए Postcode Required चालू है, उनमें अनुरोध तभी किया जाता है जब ग्राहक पोस्टल कोड दर्ज कर दे। अंतरराष्ट्रीय शिपमेंट के लिए कार्ट का कस्टम्स मूल्य भेजा जाता है। राज्य कोड केवल अमेरिका और कनाडा के लिए भेजे जाते हैं।

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

टोकन समाप्त होने तक कैश रहता है और FedEx के अस्वीकार करने पर अपने-आप दोबारा माँगा जाता है। कोटेशन 1 घंटे तक कैश रहते हैं। विफल दर अनुरोध 10 मिनट और विफल टोकन अनुरोध 5 मिनट तक याद रखा जाता है, ताकि किसी रुकावट से हर चेकआउट अपडेट धीमा न हो। API का टाइमआउट 15 सेकंड है। यदि FedEx जवाब न दे, तो ग्राहक को कोई त्रुटि नहीं दिखती: निश्चित कीमत इस्तेमाल होती है, या विधि छिप जाती है। कारण डिबग लॉग में लिखा जाता है।

एक्सटेंशन केवल दरें निकालता है। यह FedEx शिपमेंट नहीं बनाता, लेबल नहीं छापता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता, और ग्राहकों को FedEx लोकेशन चुनने नहीं देता। यह कई के बजाय एक ही विकल्प (सबसे सस्ती सेवा) दिखाता है, और बॉक्स पैकिंग नहीं होती: कार्ट को एक ही पैकेज के रूप में कोट किया जाता है।

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और विंडो Shipping method options में FedEx चुनता है। यह विधि OpenCart 3 की तरह ही काम करती है।

ऑर्डर

जब FedEx वाला ऑर्डर दिया जाता है, तो ग्राहक को दिखाई गई दर ऑर्डर के साथ सेव होती है। Sales > Orders में ऑर्डर पेज पर एक FedEx shipping पैनल होता है। इसमें दर की FedEx service (लाइव दरों के लिए), Price source (FedEx live rate, Fixed price (no live rate), या Free shipping threshold) और आपकी डिफ़ॉल्ट मुद्रा में Calculated price (excl. tax) दिखाई देती है। ऑर्डर देते समय ये मान फ़्रीज़ हो जाते हैं: बाद में सेटिंग्स में बदलाव करने से ये नहीं बदलते। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और ग्राहक हर बार पुष्टि करने पर उसे अपडेट करता है: सेव की गई FedEx दर उसके साथ अपडेट होती है, और जब ग्राहक दूसरी शिपिंग विधि चुनता है तो वह हट जाती है।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox FedEx, Extensions > Extensions > Shipping > VibeFox FedEx > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। License key में कुंजी दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) दिखाता है, और इनके बटन: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-shipping-fedex वाली पंक्ति और 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 पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

एक कुंजी एक ही डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया स्टोर का पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को FedEx शिपिंग विधि नहीं दिखाई जाती और कोई दर नहीं निकाली जाती। वह एडमिन उपयोगकर्ता जो उसी ब्राउज़र में एडमिन में लॉग इन है, फिर भी स्टोर में यह विधि देखता है, और उस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप लाइसेंस खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉग इन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना यह विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक याद दिलाने वाला संदेश दिखाई देता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

चेकआउट पर FedEx नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Geo zone, या Ignore shipping zones और Countries जाँचें। एक्सटेंशन पेज के ऊपर की चेतावनियाँ, वज़न की सीमाएँ और Minimum subtotal जाँचें। लाइव दर के बिना विधि को एक देश-वार कीमत, एक * Any other country पंक्ति या एक Fallback cost चाहिए। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। वहाँ गलत कुंजियाँ, गलत माहौल (Sandbox बंद होने पर टेस्ट कुंजियाँ, या चालू होने पर प्रोडक्शन कुंजियाँ), डिलीवरी पोस्टल कोड का न होना और FedEx की त्रुटि कोड दर्ज होते हैं।

मेरा स्टोर USD में नहीं है: FedEx से आपके स्टोर की डिफ़ॉल्ट मुद्रा में दर माँगी जाती है। यदि आपका खाता केवल अपनी मुद्रा लौटाता है, तो FedEx account currency और Exchange rate सेट करें। विनिमय दर के बिना ऐसी दरें अनदेखी होती हैं और निश्चित कीमत इस्तेमाल होती है, इसलिए USD की राशि कभी यूरो में नहीं दिखती।

क्या "Per item" FedEx दर को गुणा करता है? नहीं। Per item केवल निश्चित कीमतों पर लागू होता है।

बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज को सेव करने से कैश साफ़ हो जाता है। आप Clear cached FedEx token and rates पर भी क्लिक कर सकते हैं।

पेज कहता है "Warning: You do not have permission to modify VibeFox FedEx!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_fedex (OpenCart 3) या extension/vfd_fedex/shipping/vfd_fedex (OpenCart 4) के लिए संशोधन की अनुमति दें।

डेवलपर्स के लिए: अन्य एक्सटेंशन OpenCart इवेंट vfd_fedex/api_base_url, vfd_fedex/allowed_services और vfd_fedex/rate_request (catalog/vfd_fedex/... के रूप में रजिस्टर) के माध्यम से API पता, अनुमत FedEx सेवाएँ और दर अनुरोध बदल सकते हैं; सेटिंग vfd_fdx_api_url परीक्षण के लिए API पता बदलती है और सेटिंग्स पेज पर इसका कोई फ़ील्ड नहीं है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, Shipping प्रकार चुनें और VibeFox FedEx के आगे Uninstall (लाल − बटन) पर क्लिक करें। OpenCart हमेशा Enable/Disable, Sort order, Tax class और Geo zone को रीसेट करता है। कैश्ड टोकन और दरें हमेशा हटाई जाती हैं। यदि Remove data on uninstall चालू है, तो FedEx सेटिंग्स और डिबग लॉग भी हटा दिए जाते हैं। यदि बंद है, तो बाकी सेटिंग्स रखी जाती हैं और एक्सटेंशन फिर से इंस्टॉल करने पर फिर से इस्तेमाल होती हैं। ऑर्डरों की FedEx दरें दोनों स्थितियों में रखी जाती हैं, और ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox FedEx के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

FedEx उसके स्वामी का ट्रेडमार्क है। यह एक्सटेंशन FedEx से संबद्ध नहीं है और न ही FedEx द्वारा समर्थित है।