VibeFox J&T Express for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।

J&T Express Malaysia API एक्सेस (केवल लाइव कोट के लिए): लाइव कोट केवल मलेशिया के डिलीवरी पतों के लिए J&T Express Malaysia पर उपलब्ध हैं। आपको चार मान चाहिए। J&T Express Malaysia की वेबसाइट पर J&T VIP खाते के लिए आवेदन करें (मॉड्यूल पेज पर एक लिंक है): J&T आपको VIP ग्राहक कोड और VIP API कुंजी देता है। API खाता और अनुरोधों पर हस्ताक्षर करने के लिए निजी कुंजी API एकीकरण के लिए J&T द्वारा जारी की जाती है। ये अपने J&T खाता प्रबंधक से माँगें। J&T फ़िलीपींस, इंडोनेशिया और अन्य देशों के लिए कोई सार्वजनिक कोट API नहीं है, इसलिए इन देशों के लिए कीमत तालिका का उपयोग करें। यदि आप केवल कीमत तालिका और फ़ॉलबैक लागत का उपयोग करते हैं, तो आपको J&T API एक्सेस की ज़रूरत नहीं है।

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

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

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

4. कीमत तालिका और/या फ़ॉलबैक लागत भरें। मलेशिया के लाइव कोट के लिए, J&T API क्रेडेंशियल और भेजने वाले का पिन कोड भी दर्ज करें, और यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा MYR नहीं है तो मुद्रा रूपांतरण दर भी दर्ज करें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox J&T Express > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सेव कैश्ड J&T कोट भी साफ़ कर देता है। यदि लाइव कोट केवल आंशिक रूप से कॉन्फ़िगर हैं, तो पेज के शीर्ष पर चेतावनी में छूटी हुई सेटिंग्स दिखती हैं या बताया जाता है कि मुद्रा रूपांतरण दर गायब है। 0 या उससे अधिक संख्या न होने वाली राशियाँ त्रुटि के साथ अस्वीकार की जाती हैं, और इसी तरह 0 वाली Currency conversion rate तथा Max weight से बड़ी Min weight भी। यदि आपके स्टोर की वज़न इकाई पहचानी नहीं जाती, तो एक चेतावनी आपसे International > Localization में मानक इकाई सेट करने को कहती है।

सामान्य

इस पेज की सेटिंग्स सभी ज़ोन पर लागू होती हैं। कैरियर के ज़ोन, ग्राहक समूह और आकार सीमाएँ Shipping > Carriers में सेट होती हैं (या नीचे Ignore shipping zones का उपयोग करें)।

Enable J&T Express: कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।

Method title: कार्ट और चेकआउट में दिखाया जाने वाला कैरियर नाम। डिफ़ॉल्ट: J&T Express। अनिवार्य।

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

J&T Express Malaysia API (लाइव कोट) (वैकल्पिक, मलेशिया के डिलीवरी पतों के लिए; चारों क्रेडेंशियल आवश्यक हैं)

VIP customer code: आपका J&T Express VIP ग्राहक कोड। इसे साफ़ करने से सहेजी गई VIP API कुंजी भी मिट जाती है।

VIP API key: VIP कोड के साथ J&T Express द्वारा दी गई API कुंजी (पासवर्ड)। यह कभी लॉग में नहीं लिखी जाती। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

API account: आपके J&T Express API खाते का नाम। इसे साफ़ करने से सहेजी गई निजी कुंजी भी मिट जाती है।

API private key: API खाते की निजी कुंजी। इसका उपयोग केवल अनुरोधों पर हस्ताक्षर करने (SHA-256) के लिए होता है। यह कभी J&T को नहीं भेजी जाती और कभी लॉग में नहीं लिखी जाती। VIP API कुंजी की तरह, सेव करने के बाद यह फिर नहीं दिखाई जाती।

Sender postcode: वह मलेशियाई पिन कोड जहाँ से पार्सल भेजे जाते हैं। यदि स्टोर मलेशिया में है, तो Shop Parameters > Contact > Stores का स्टोर पिन कोड उपयोग करने के लिए इसे खाली छोड़ें। सेव करते समय स्पेस हटा दिए जाते हैं।

Currency conversion rate: J&T Express Malaysia के कोट MYR में होते हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा MYR नहीं है, तो दर्ज करें कि 1 MYR आपकी मुद्रा की कितनी इकाइयों के बराबर है (1 MYR = X)। इसके बिना लाइव कोट का उपयोग नहीं होता, और उसकी जगह कीमत तालिका या फ़ॉलबैक लागत लागू होती है। यदि आपकी डिफ़ॉल्ट मुद्रा MYR है, तो फ़ील्ड यह बताता है और दर की ज़रूरत नहीं होती: कोट जैसे हैं वैसे ही उपयोग होते हैं। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार्य हैं। दर 0 से बड़ी होनी चाहिए।

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

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

Fallback cost: वह कीमत जो तब उपयोग होती है जब न तो J&T और न ही तालिका कीमत देती है। उस स्थिति में कैरियर छिपाने के लिए इसे खाली छोड़ें। 0 का अर्थ है मुफ़्त शिपिंग।

Table / fallback price is: Per order कीमत एक बार लेता है। Per item (multiplied by the number of items) इसे कार्ट में आइटम की संख्या से गुणा करता है। J&T के लाइव कोट हमेशा पूरे ऑर्डर के लिए होते हैं।

शर्तें

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

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

Min weight: कार्ट इससे हल्का हो तो कैरियर छिपाएँ (kg में)। उत्पादों के वज़न को आपके स्टोर की वज़न इकाई से बदला जाता है। 0 का अर्थ है कोई सीमा नहीं। यह Max weight से बड़ा नहीं हो सकता।

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

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

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

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

उन्नत

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

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

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

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

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

अन्यथा लागत उस पहले स्रोत से ली जाती है जो कीमत देता है:

1. J&T लाइव कोट: केवल तब जब चारों API क्रेडेंशियल और भेजने वाले का पिन कोड सेट हों, डिलीवरी देश मलेशिया हो, ग्राहक ने 5 अंकों का पिन कोड दर्ज किया हो, और उन स्टोर के लिए जिनकी डिफ़ॉल्ट मुद्रा MYR नहीं है, रूपांतरण दर सेट हो। मॉड्यूल J&T को भेजने वाले और प्राप्तकर्ता के पिन कोड और कार्ट का वज़न (कम से कम 0.1 kg) मानक सेवा EZ, एक पार्सल के लिए भेजता है, और लौटाई गई MYR कीमत को आपके स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है।

2. देश की कीमतें: डिलीवरी देश की पंक्ति, या * पंक्ति, कार्ट के वज़न स्तर की कीमत के साथ।

3. फ़ॉलबैक लागत।

यदि इनमें से कोई भी कीमत नहीं देता, तो उस कार्ट के लिए कैरियर छिपा दिया जाता है। Per item केवल तालिका और फ़ॉलबैक कीमतों पर लागू होता है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक के कार्ट की मुद्रा में दिखाई जाती है।

J&T का हर उत्तर 1 घंटे तक कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रीफ़्रेश पर J&T का इंतज़ार न करे। अनुरोध की समय-सीमा 10 सेकंड है। यदि J&T कोई त्रुटि, शून्य कीमत या कोई उत्तर नहीं देता, तो ग्राहक को कोई त्रुटि नहीं दिखती। तालिका या फ़ॉलबैक कीमत उपयोग होती है, और कारण लॉग में लिखा जाता है।

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

मॉड्यूल केवल शिपिंग लागत की गणना करता है। यह कंसाइनमेंट नोट, वेबिल या लेबल नहीं बनाता, पिकअप बुक नहीं करता, शिपमेंट रद्द या ट्रैक नहीं करता, और ग्राहकों को पिकअप पॉइंट चुनने नहीं देता। शिपमेंट सामान्य रूप से अपने J&T खाते में बनाएँ और ट्रैक करें। यह मॉड्यूल आधिकारिक J&T Express Malaysia प्लगइन के अनुरोध प्रारूप के अनुसार बनाया गया है। लाइव जाने से पहले अपने J&T खाते से कीमतों की पुष्टि करें।

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

यह मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। Modules > Module Manager > VibeFox J&T Express > Configure पर लाइसेंस ब्लॉक License — VibeFox J&T Express सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, साथ ही स्थिति (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे पंक्ति Product: presta-shipping-jt-express और लिंक 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 खाते में मुक्त करें।

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

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

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

चेकआउट पर J&T Express नहीं दिख रहा: जाँचें कि लाइसेंस सक्रिय है और Enable J&T Express चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न सीमाएँ और Minimum subtotal जाँचें। जाँचें कि Country prices में देश की पंक्ति या * पंक्ति है, या Fallback cost सेट है। उत्पाद पेज पर कुछ उत्पाद केवल कुछ कैरियर तक सीमित भी हो सकते हैं। Debug log चालू करें और मॉड्यूल पेज पर Log फ़ील्ड देखें।

कीमत J&T से नहीं, तालिका से आ रही है: लाइव कोट के लिए चारों API क्रेडेंशियल, भेजने वाले का पिन कोड, 5 अंकों के पिन कोड वाला मलेशियाई डिलीवरी पता और, MYR के अलावा मुद्रा वाले स्टोर के लिए Currency conversion rate चाहिए। मॉड्यूल पेज के शीर्ष की चेतावनियाँ जाँचें। यदि J&T अनुरोध अस्वीकार करता है या उत्तर नहीं देता, तो त्रुटि लॉग होती है और तालिका या फ़ॉलबैक कीमत उपयोग होती है। विफल अनुरोध 10 मिनट बाद फिर से भेजा जाता है।

फ़िलीपींस या इंडोनेशिया के लिए लाइव कोट नहीं: J&T इन देशों के लिए कोई सार्वजनिक कोट API नहीं देता। वहाँ कीमत तालिका और फ़ॉलबैक लागत उपयोग करें।

एक देश को गलती से मुफ़्त शिपिंग मिल रही है: उसकी पंक्ति की आधार कीमत 0 है (खाली आधार कीमत 0 के रूप में सहेजी जाती है)। आधार कीमत दर्ज करें या पंक्ति हटाएँ। Free shipping from भी जाँचें।

बदलाव के बाद दरें पुरानी लग रही हैं: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश्ड J&T कोट साफ़ हो जाते हैं।

पेज कहता है कि J&T Express कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया था। इसे फिर बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।

डेवलपर हुक: हुक actionVfdJtexQuoteRequest कोट अनुरोध का बॉडी बदलता है (उदाहरण के लिए सेवा का प्रकार), और actionVfdJtexApiUrl कोट एंडपॉइंट बदलता है।

अनइंस्टॉल

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

J&T Express उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल J&T Express से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।