VibeFox SF Express for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या बाद का संस्करण।

SF Express खाता (केवल लाइव कीमतों के लिए): लाइव कीमतें SF Express के FengQiao ओपन प्लेटफ़ॉर्म (open.sf-express.com) का उपयोग करती हैं। आपको SF Express का मासिक खाता और FengQiao पर एक डेवलपर खाता चाहिए। वहाँ पंजीकरण करें, एक एप्लिकेशन बनाएँ, उसमें API "Delivery time standard and price query" (EXP_RECE_QUERY_DELIVERTM) जोड़ें और ग्राहक कोड तथा checkword कॉपी करें। सैंडबॉक्स और प्रोडक्शन के checkword अलग-अलग होते हैं। यदि आप केवल प्राइस टेबल का उपयोग करते हैं, तो SF Express खाते की ज़रूरत नहीं है।

चीन के प्रांत (केवल लाइव कीमतों के लिए): लाइव कीमत के लिए डिलीवरी पते का प्रांत चाहिए, जो पते का OpenCart ज़ोन (Region / State) है। OpenCart में चीन के ज़ोन हैं, लेकिन तिब्बत नहीं है। एक्सटेंशन आपके लिए इसे जोड़ सकता है (नीचे Chinese provinces देखें)।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. प्राइस टेबल और/या फ़ॉलबैक लागत भरें।

6. मेनलैंड चीन में लाइव कीमतों के लिए, ग्राहक कोड और checkword, भेजने वाला प्रांत और शहर डालें, और यदि आपके स्टोर की मुद्रा CNY नहीं है तो मुद्रा रूपांतरण दर भी डालें। यदि पेज माँगे तो Add Chinese provinces पर क्लिक करें। पहले Sandbox और सैंडबॉक्स क्रेडेंशियल से परीक्षण करें।

7. Enable SF Express चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

सेव करते समय एक्सटेंशन मानों की जाँच करता है। खाली विधि शीर्षक, 64 अक्षरों से लंबा या < > ; = # { } वाला शीर्षक, संख्या न होने वाला मान, ऋणात्मक राशि या वज़न, 0 की मुद्रा रूपांतरण दर, Max weight (kg) से बड़ा Min weight (kg), प्राइस टेबल में गलत कीमत, या पूर्णांक न होने वाला sort order, एक संदेश के साथ अस्वीकार किए जाते हैं, और जब तक आप उन्हें सुधारते नहीं, कुछ भी सेव नहीं होता। सेटिंग्स के ऊपर की चेतावनियाँ आपको बताती हैं कि लाइव कीमतें आंशिक रूप से सेट हैं (छूटी हुई सेटिंग्स सूचीबद्ध होती हैं), मुद्रा रूपांतरण दर गायब है, स्टोर में चीन के ज़ोन नहीं हैं, या स्टोर में kg वज़न इकाई या cm लंबाई इकाई नहीं है और उसकी डिफ़ॉल्ट इकाई एक्सटेंशन के लिए अज्ञात है।

सामान्य

Enable SF Express: चेकआउट पर SF Express दिखाता या छिपाता है। डिफ़ॉल्ट: बंद।

Method title: कार्ट और चेकआउट में दिखने वाला विधि का नाम। डिफ़ॉल्ट: SF Express। आवश्यक, अधिकतम 64 अक्षर।

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax। टैक्स क्लास चुनने पर, उस लागत पर आपके स्टोर का शिपिंग टैक्स जुड़ जाता है। यदि SF Express की कीमत में पहले से वह सब शामिल है जो आप लेना चाहते हैं, तो No tax चुनें।

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

SF Express FengQiao API (लाइव कीमतें) (वैकल्पिक, मेनलैंड चीन के डिलीवरी पतों के लिए)

Customer code (partnerID): आपके FengQiao एप्लिकेशन का ग्राहक कोड (顾客编码)। इसे खाली करने से सहेजा गया checkword भी मिट जाता है, जिससे आप क्रेडेंशियल हटा सकते हैं।

Checkword: उसी वातावरण का checkword (校验码)। इसका उपयोग केवल अनुरोधों पर हस्ताक्षर करने के लिए होता है और यह कभी भेजा या लॉग नहीं किया जाता। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान डालें।

Sandbox: सैंडबॉक्स क्रेडेंशियल से परीक्षण के लिए FengQiao सैंडबॉक्स (sfapi-sbox.sf-express.com) का उपयोग करता है। सैंडबॉक्स कीमतें असली नहीं होतीं। लाइव स्टोर में इसे बंद रखें। डिफ़ॉल्ट: बंद।

SF Express product: कौन सा SF Express उत्पाद उसकी कीमत के साथ दिखाया जाए।

Cheapest product offered by SF Express: डिफ़ॉल्ट। SF Express द्वारा लौटाई गई सबसे कम कीमत उपयोग होती है।

SF Express Priority (顺丰特快, code 1): केवल इस उत्पाद की कीमत।

SF Standard Express (顺丰标快, code 2): केवल इस उत्पाद की कीमत।

Sender province: वह प्रांत जहाँ से पार्सल भेजे जाते हैं, जैसे Guangdong / 广东। यदि स्टोर चीन में है, तो पहला विकल्प आपके स्टोर का क्षेत्र (System > Settings > Store > Local) उपयोग करता है। तब प्रांत के नाम के साथ Same as the store region दिखता है, अन्यथा — Select —।

Sender city: शहर का मानक चीनी नाम, जैसे 深圳市। लाइव कीमतों के लिए आवश्यक: OpenCart में स्टोर का पता मुक्त-पाठ है, इसलिए शहर उससे कभी नहीं लिया जाता।

Currency conversion rate: SF Express की कीमतें CNY (युआन) में होती हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा CNY नहीं है, तो लिखें कि एक CNY आपकी मुद्रा की कितनी इकाइयों के बराबर है (1 CNY = ? इकाइयाँ), जैसे 0.13। इसके बिना लाइव कीमतें उपयोग नहीं होतीं। यदि स्टोर की मुद्रा CNY है, तो फ़ील्ड बताता है कि इसकी ज़रूरत नहीं है और कीमतें जैसी हैं वैसी ही उपयोग होती हैं। दशमलव विभाजक के रूप में बिंदु और अल्पविराम, दोनों स्वीकार्य हैं।

Chinese provinces: दिखाता है कि SF Express के 32 प्रांतों, स्वायत्त क्षेत्रों और नगरपालिकाओं में से कितने OpenCart में चीन के ज़ोन हैं और कौन-से गायब हैं। गायब प्रांत के पते को प्राइस टेबल की कीमत मिलती है। Add Chinese provinces पर क्लिक करने पर केवल गायब प्रांत चीन के ज़ोन के रूप में जुड़ते हैं (ISO कोड, और "Tibet / 西藏" जैसा नाम)। मौजूदा ज़ोन नहीं बदले जाते। इस क्लिक के बिना कुछ नहीं बदलता। इस तरह जोड़े गए ज़ोन अनइंस्टॉल के बाद भी स्टोर में रहते हैं।

प्राइस टेबल और फ़ॉलबैक (हांगकांग, मकाऊ, ताइवान और अन्य देशों के लिए उपयोग, जब लाइव कीमतें सेट नहीं हैं या SF Express कीमत नहीं देता; कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स छोड़कर)

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

Fallback cost: तब उपयोग होती है जब न SF Express और न ही टेबल कीमत देता है। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।

Table / fallback price is: टेबल और फ़ॉलबैक कीमतों से शुल्क कैसे लिया जाए।

Per order (tier by the total cart weight): कार्ट के कुल वज़न से मेल खाने वाली श्रेणी की कीमत, एक बार लगाई जाती है।

Per item (every item is priced by its own weight): हर आइटम का मूल्य उसकी अपनी वज़न श्रेणी से तय होता है और उसकी मात्रा से गुणा किया जाता है। फ़ॉलबैक लागत आइटमों की संख्या से गुणा होती है।

SF Express की लाइव कीमतें हमेशा पूरे ऑर्डर के लिए होती हैं।

शर्तें

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

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

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

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

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

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

Ignore shipping zones: जियो ज़ोन चाहे जो भी हो, नीचे दिए गए देशों के लिए SF Express दें। बंद होने पर जियो ज़ोन तय करता है और देशों की सूची उपयोग नहीं होती।

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

उन्नत

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

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

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

इम्पोर्ट / एक्सपोर्ट

Export: सेटिंग्स को checkword के बिना JSON फ़ाइल में सहेजने के लिए Download JSON पर क्लिक करें।

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। मानों की जाँच सामान्य सेव की तरह होती है। सहेजा गया checkword बना रहता है।

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

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

ग्राहक कोड और checkword सेट होने पर, मेनलैंड चीन के डिलीवरी पते के लिए, एक्सटेंशन SF Express को आपका भेजने वाला प्रांत और शहर, ग्राहक का प्रांत और शहर, कार्ट का वज़न (कम से कम 0.1 kg) और कार्ट का आयतन (उन उत्पादों से जिनके तीनों आयाम हैं) भेजता है। अनुरोध आपके checkword से हस्ताक्षरित होता है। SF Express कीमतें CNY में लौटाता है; एक्सटेंशन चुनी गई कीमत को आपके स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है और उसके दशमलव स्थानों तक राउंड करता है। फिर कीमत ग्राहक की मुद्रा में, चुनी गई Tax class के टैक्स के साथ दिखाई जाती है।

SF Express मानक चीनी नामों से पते पहचानता है। ग्राहक का प्रांत पते के Region / State ज़ोन से आता है, जिसका मिलान उसके नाम से होता है। "Hong Kong" ज़ोन मेनलैंड का प्रांत नहीं है और उसे प्राइस टेबल की कीमत मिलती है। शहर चीनी में लिखा होना चाहिए, जैसे 广州市। बीजिंग, शंघाई, तियानजिन और चोंगक़िंग के लिए शहर अपने-आप भर जाता है। लैटिन अक्षरों में लिखा शहर, जैसे "Guangzhou", प्राइस टेबल की कीमत पाता है।

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

यदि लाइव कीमत नहीं है, तो कीमत प्राइस टेबल से और फिर Fallback cost से आती है। यदि कोई भी लागू नहीं होता, तो विधि छिप जाती है। ग्राहक को कभी त्रुटि नहीं दिखती। त्रुटि लॉग में लिखी जाती है।

एक्सटेंशन केवल कीमतें निकालता है। यह वेबिल या लेबल नहीं बनाता, SF Express में ऑर्डर नहीं बनाता, पिकअप बुक नहीं करता, और शिपमेंट रद्द या ट्रैक नहीं करता। शिपमेंट सामान्य रूप से अपने SF Express खाते में बनाएँ और ट्रैक करें। ग्राहक SF सर्विस पॉइंट या लॉकर नहीं चुन सकते। SF Express का उपयोग डोर-टू-डोर कूरियर के रूप में होता है। लाइव कीमतें केवल मेनलैंड चीन के डिलीवरी पतों के लिए मौजूद हैं। यह एक्सटेंशन FengQiao दस्तावेज़ीकरण और नकली प्रतिक्रियाओं के आधार पर बनाया गया है, इसलिए लाइव जाने से पहले अपने SF Express खाते (पहले सैंडबॉक्स में) से कीमतों की पुष्टि करें।

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

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox SF Express लाइसेंस ब्लॉक Extensions > Extensions > Shipping > VibeFox SF Express > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी छिपी हुई (मास्क) दिखती है, साथ में स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन), और ये बटन: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-shipping-sf-express वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। कुंजी केवल वही एडमिन उपयोगकर्ता बदल सकते हैं जिनके पास इस एक्सटेंशन के लिए Modify अनुमति है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

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

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

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

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

कीमत SF Express से नहीं, टेबल से आ रही है: लाइव कीमतों के लिए ग्राहक कोड और checkword, भेजने वाला प्रांत और शहर, प्रांत और चीनी शहर नाम वाला मेनलैंड चीन का डिलीवरी पता, और (CNY के अलावा मुद्रा वाले स्टोर के लिए) मुद्रा रूपांतरण दर चाहिए। एक्सटेंशन पेज के ऊपर की चेतावनियाँ पढ़ें, फिर Debug log चालू करें, चेकआउट रीलोड करें और कारण देखने के लिए Log फ़ील्ड देखें। विफल अनुरोध 10 मिनट बाद फिर से किया जाता है।

लॉग में हस्ताक्षर त्रुटि दिखती है: checkword गलत है या दूसरे वातावरण का है। Sandbox सेटिंग जाँचें। यदि SF Express कहता है कि API की अनुमति नहीं है, तो अपने FengQiao एप्लिकेशन में मूल्य क्वेरी API जोड़ें।

तिब्बत के पते टेबल की कीमत पाते हैं: एक्सटेंशन पेज के API सेक्शन में Add Chinese provinces पर क्लिक करें।

हांगकांग: प्राइस टेबल और फ़ॉलबैक लागत के साथ काम करता है। FengQiao मूल्य क्वेरी मेनलैंड चीन के पतों के लिए है।

बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश की गई SF Express कीमतें साफ़ हो जाती हैं।

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

डेवलपर्स के लिए: OpenCart इवेंट vfd_sf_express/quote_request और vfd_sf_express/api_url किसी दूसरे एक्सटेंशन को कीमत अनुरोध (जैसे किसी दूसरे उत्पाद कोड पर) और गेटवे URL बदलने देते हैं।

अनइंस्टॉल

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

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

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