VibeFox FedEx for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: cURL एक्सटेंशन के साथ 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. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox FedEx खोजकर Configure पर क्लिक करें।

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

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

इंस्टॉल होने पर मॉड्यूल FedEx कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट FedEx delivery होता है। कैरियर सभी ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें न सेट करें: कीमत हमेशा मॉड्यूल से आती है।

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

सारी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox FedEx > Configure। ये कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव के साथ कैश किया गया FedEx टोकन और दरें भी साफ़ हो जाती हैं।

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

सामान्य

Enable/Disable: FedEx शिपिंग चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

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

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

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

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

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

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

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

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: शिप-फ़्रॉम शहर।

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

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

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

Country prices: 2 अक्षरों वाले गंतव्य देश कोड और आपके स्टोर की डिफ़ॉल्ट मुद्रा में (टैक्स के बिना) कीमतों की एक तालिका। देश जोड़ने के लिए Add row पर क्लिक करें, और हटाने के लिए ट्रैश आइकन पर। अन्य सभी देशों के लिए देश कोड के रूप में * इस्तेमाल करें। वे पंक्तियाँ जिनमें देश कोड (या *) और कीमत न हो, अनदेखी की जाती हैं और सेव करते समय बताई जाती हैं।

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। उत्पादों के वज़न को आपके स्टोर की वज़न इकाई (kg, g, lb या oz) से बदला जाता है, जो International > Localization (Local units) में सेट होती है।

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

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

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

उन्नत

Debug log: API अनुरोधों और दर की गणना को मॉड्यूल फ़ोल्डर में logs/vfd_fdx_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। API त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ, टोकन और ग्राहक के पते कभी लॉग नहीं होते।

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

Remove data on uninstall: चालू होने पर मॉड्यूल हटाने से सभी मॉड्यूल सेटिंग्स, कैरियर और ऑर्डरों में सहेजी गई FedEx सेवाएँ हट जाती हैं। बंद होने पर पुनः इंस्टॉल के लिए सब कुछ रखा जाता है।

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

शिपिंग चरण में PrestaShop मॉड्यूल से FedEx कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल पहले अनुमत देशों (Ignore shipping zones के साथ), कार्ट के वज़न और न्यूनतम सबटोटल की जाँच करता है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और FedEx को कोई अनुरोध नहीं भेजा जाता।

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

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

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

यदि आप Shipping > Carriers में कैरियर को उसके ऑर्डर होने के बाद संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।

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

ऑर्डर

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

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox FedEx लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox FedEx > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key फ़ील्ड में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: Check now (स्टेटस फिर से जाँचें), Change key (दूसरी कुंजी दर्ज करें) और Remove key (इस स्टोर से कुंजी हटाएँ)। उनके नीचे Product: presta-shipping-fedex की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल वे कर्मचारी कुंजी बदल सकते हैं जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

सक्रिय कुंजी के बिना FedEx कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर भी नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

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

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

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

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

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

पेज कहता है कि FedEx कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया जा चुका है। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।

केवल कुछ सेवाएँ दी जानी चाहिए: डेवलपर actionVfdFdxAllowedServices हुक से सेवाओं को सीमित कर सकते हैं। actionVfdFdxRateRequest और actionVfdFdxApiBaseUrl हुक दर अनुरोध और API पते को बदलते हैं।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox FedEx के बगल वाला मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। कैश किए गए टोकन और दरें हमेशा हटाई जाती हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटा दिया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग तथा ऑर्डरों में सहेजी गई FedEx सेवाएँ हटा दी जाती हैं। यदि यह बंद है, तो कैरियर केवल निष्क्रिय होता है और सभी सेटिंग्स रखी जाती हैं। मॉड्यूल फिर से इंस्टॉल करने पर (या Reset पर) सहेजे गए कैरियर को अनइंस्टॉल से पहले वाली स्थिति वापस मिल जाती है।

FedEx उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल FedEx से संबद्ध नहीं है और FedEx द्वारा अनुमोदित नहीं है।