VibeFox FedEx for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

5. API Key, Secret Key, 9 अंकों का FedEx खाता नंबर और Ship from पता (ZIP और, अमेरिका व कनाडा के लिए, 2 अक्षरों का राज्य कोड) दर्ज करें। production कुंजियों का उपयोग करते समय Sandbox बंद करें।

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

7. वैकल्पिक रूप से, फ़ॉलबैक के लिए निश्चित कीमतें दर्ज करें।

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

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

Title (zone): चेकआउट पर इस विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए इसे खाली छोड़ें।

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

General

Enable/Disable: सभी ज़ोन में FedEx शिपिंग को एक साथ चालू या बंद करता है। डिफ़ॉल्ट: चालू।

Name: चेकआउट पर ग्राहक को दिखने वाली शिपिंग विधि का नाम। डिफ़ॉल्ट: FedEx।

Tax status: Taxable चुनने पर WooCommerce शिपिंग लागत पर टैक्स जोड़ता है, इसलिए बिना टैक्स वाला FedEx शुल्क उपयोग होता है। None चुनने पर FedEx का शुद्ध शुल्क जैसा है वैसा उपयोग होता है। डिफ़ॉल्ट: Taxable।

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

कुंजियों के बिना निश्चित कीमतें उपयोग होती हैं। इस सेक्शन में Clear cached FedEx token and rates लिंक है।

Sandbox: टेस्ट कुंजियों के साथ FedEx sandbox उपयोग करता है। production कुंजियों से असली दरें पाने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू।

API Key: आपके FedEx Developer Portal प्रोजेक्ट की API Key (client_id)।

Secret Key: उसी प्रोजेक्ट की Secret Key (client_secret)।

FedEx account number: प्रोजेक्ट से जुड़ा 9 अंकों का FedEx शिपिंग खाता।

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

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

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

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

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

भेजने का स्थान

वह पता जहाँ से FedEx पार्सल उठाता है या जहाँ आप पार्सल जमा करते हैं। लाइव दरों के लिए इसका उपयोग होता है।

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

State / province code: 2 अक्षरों का कोड, अमेरिका और कनाडा के लिए अनिवार्य, उदाहरण के लिए TN, CA या ON।

City: ship-from शहर।

ZIP / postal code: ship-from पोस्टल कोड। दरों का कोटेशन देने के लिए FedEx को इसकी ज़रूरत है।

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

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

Country prices: गंतव्य देश के अनुसार आपकी स्टोर मुद्रा में कीमत, हर पंक्ति में एक देश, CC=PRICE प्रारूप में, उदाहरण के लिए US=12.99 या CA=19,99। अन्य सभी देशों के लिए * का उपयोग करें, उदाहरण के लिए *=29.99। दूसरे प्रारूप की पंक्तियाँ अनदेखी की जाती हैं और सहेजते समय उनकी सूचना दी जाती है।

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

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

शर्तें

Free shipping from: कार्ट का सबटोटल जिससे यह विधि मुफ़्त होती है। कभी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।

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

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

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

Default product weight (kg): बिना वज़न वाले उत्पादों के लिए उपयोग होने वाला वज़न, FedEx दरों के लिए और ऊपर की वज़न सीमाओं के लिए। डिफ़ॉल्ट: 0.5।

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

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

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

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

एडवांस्ड

Debug log: API अनुरोधों और दर गणना को WooCommerce > Status > Logs में, स्रोत vfd-fedex के साथ लॉग करता है। API त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ, टोकन और ग्राहकों के पते कभी लॉग नहीं होते।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट दोबारा लोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-fedex चुनकर। गलत कुंजियाँ, गलत वातावरण (Sandbox बंद होने पर टेस्ट कुंजियाँ, या चालू होने पर production कुंजियाँ) और FedEx त्रुटि कोड वहाँ दर्ज होते हैं।

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

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

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

केवल कुछ सेवाएँ देनी चाहिए: डेवलपर vfd_fdx_allowed_services फ़िल्टर से सेवाएँ सीमित कर सकते हैं।

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

अनइंस्टॉल

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

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