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

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 5.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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 खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_sf_express फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox SF Express, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

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

5. मूल्य तालिका और/या बैकअप लागत भरें।

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

7. WooCommerce > Settings > Shipping > Shipping zones में VibeFox SF Express को किसी शिपिंग ज़ोन में जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox SF Express। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। खाली छोड़ने पर वैश्विक Method title उपयोग होता है।

जब भी आप सेटिंग्स सहेजते हैं, कैश किए गए SF Express मूल्य मिट जाते हैं। यदि लाइव मूल्य आंशिक रूप से सेट हैं, तो सेटिंग्स के ऊपर की चेतावनी में छूटी हुई सेटिंग्स या छूटी हुई रूपांतरण दर दिखती है।

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ विधि को चालू या बंद करता है।

Method title: कार्ट और चेकआउट में दिखने वाला शिपिंग विधि का नाम। कोई ज़ोन इसे बदल सकता है। डिफ़ॉल्ट: SF Express।

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

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

Customer code (partnerID): आपके FengQiao एप्लिकेशन का ग्राहक कोड (顾客编码)।

Checkword: उसी वातावरण का checkword (校验码)। इसका उपयोग केवल अनुरोधों पर हस्ताक्षर करने के लिए होता है और यह कभी भेजा या लॉग नहीं किया जाता।

Sandbox: सैंडबॉक्स क्रेडेंशियल्स के साथ परीक्षण के लिए FengQiao सैंडबॉक्स का उपयोग करें। सैंडबॉक्स मूल्य वास्तविक नहीं हैं। लाइव स्टोर में इसे बंद रखें। डिफ़ॉल्ट: off।

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: वह प्रांत जहाँ से पार्सल भेजे जाते हैं। यदि स्टोर चीन में है, तो खाली छोड़ें और WooCommerce > Settings > General में स्टोर पते का प्रांत उपयोग होगा।

Sender city: मानक चीनी शहर का नाम, जैसे 深圳市। यदि स्टोर चीन में है, तो खाली छोड़ने पर स्टोर का शहर उपयोग होगा।

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

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

Country prices: प्रति देश आधार मूल्य वाली एक तालिका। * Any other country पंक्ति उन सभी देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। 0 से अधिक का वज़न-श्रेणी मूल्य उस श्रेणी के पार्सल के लिए आधार मूल्य की जगह लेता है: ≤ 1 kg, ≤ 2 kg, ≤ 3 kg, ≤ 5 kg और > 5 kg। आधार मूल्य 0 होने का अर्थ है मुफ़्त शिपिंग। खाली आधार मूल्य का अर्थ है इस देश का कोई मूल्य नहीं है, और बैकअप लागत उपयोग होती है।

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): कार्ट का न्यूनतम वज़न किलोग्राम में। उत्पादों का वज़न आपकी स्टोर वज़न इकाई से परिवर्तित होता है। 0 का अर्थ है कोई सीमा नहीं।

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

Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लास के उत्पाद हैं, तो विधि छिपा दें।

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

Ignore shipping zones: विधि किसी ज़ोन में न जुड़ी हो तब भी नीचे दिए देशों के लिए उसे पेश करें। बंद होने पर विधि केवल उन्हीं शिपिंग ज़ोन में दिखती है जिनमें वह जुड़ी है।

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

उन्नत

Debug log: मूल्य गणनाएँ WooCommerce लॉग में लिखता है: WooCommerce > Status > Logs, स्रोत vfd-sf-express। API त्रुटियाँ हमेशा लॉग होती हैं, भले ही यह विकल्प बंद हो। कोई checkword या ग्राहक पते नहीं लिखे जाते।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सेटिंग्स, शिपिंग ज़ोन की विधियाँ और कैश हट जाते हैं। प्लगइन निष्क्रिय करने से कुछ भी नहीं हटता।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से मूल्य माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लास। यदि मुफ़्त शिपिंग लागू होती है और मूल्य तालिका या Fallback cost में गंतव्य का मूल्य है, तो विधि 0 मूल्य के साथ दिखाई जाती है और SF Express को कोई अनुरोध नहीं भेजा जाता। अन्यथा प्लगइन पहले SF Express से लाइव मूल्य माँगता है, और विधि को केवल तभी मुफ़्त दिखाता है जब मूल्य वापस आए।

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

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

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

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

यह विधि क्लासिक चेकआउट और कार्ट व चेकआउट ब्लॉक, दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है। अंग्रेज़ी और सरलीकृत चीनी अनुवाद शामिल हैं।

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

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

यह प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox SF Express पेज के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तिथि तक सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

सक्रिय कुंजी के बिना SF Express चेकआउट पर ग्राहकों को नहीं दिखाया जाता। लॉग इन किए स्टोर मैनेजर इसे अब भी (unlicensed — visible to admins only) चिह्न के साथ देखते हैं, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और परीक्षण कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

चेकआउट पर SF Express दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न की सीमाएँ, Minimum subtotal और Excluded shipping classes जाँचें। जाँचें कि तालिका या Fallback cost में देश का मूल्य है।

मूल्य SF Express से नहीं, तालिका से आ रहा है: लाइव मूल्यों के लिए ग्राहक कोड और checkword, प्रेषक प्रांत और शहर, प्रांत और चीनी शहर के नाम वाला मेनलैंड चीन का डिलीवरी पता, और (गैर-CNY स्टोर के लिए) रूपांतरण दर चाहिए। कारण देखने के लिए WooCommerce > Status > Logs खोलें, स्रोत vfd-sf-express चुनें। विफल अनुरोध 10 मिनट बाद फिर से किया जाता है।

लॉग में त्रुटि A1006: अमान्य हस्ताक्षर। checkword गलत है या दूसरे वातावरण का है। Sandbox सेटिंग जाँचें।

लॉग में त्रुटि A1004: मूल्य क्वेरी API आपके FengQiao एप्लिकेशन में नहीं जोड़ा गया है।

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

बदलाव के बाद मूल्य पुराने लगते हैं: सेटिंग्स पेज सहेजें। इससे कैश किए गए SF Express मूल्य मिट जाते हैं।

डेवलपर्स के लिए: फ़िल्टर vfd_sfex_quote_request मूल्य अनुरोध बदलता है, जैसे किसी अन्य उत्पाद कोड पर। vfd_sfex_api_url गेटवे URL बदलता है।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, यदि कुंजी किसी अन्य डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन निष्क्रिय करने पर सारा डेटा रहता है। पूरी तरह हटाने के लिए, उसे निष्क्रिय करें और Plugins पेज से हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। सेटिंग्स, ज़ोन विधियाँ और कैश केवल तब हटते हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।

SF Express उसके संबंधित मालिक का ट्रेडमार्क है। यह प्लगइन SF Express से संबद्ध नहीं है और इसे SF Express का समर्थन प्राप्त नहीं है।