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

आवश्यकताएँ

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

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

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

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

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

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

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

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

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

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

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

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

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

सामान्य

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

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

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

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

VIP customer code: आपका J&T Express VIP ग्राहक कोड।

VIP API key: VIP कोड के साथ J&T Express द्वारा दी गई API कुंजी (पासवर्ड)। इसे कभी लॉग में नहीं लिखा जाता।

API account: आपके J&T Express API खाते का नाम।

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

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

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

कीमत तालिका और फ़ॉलबैक (मलेशिया के अलावा अन्य देशों के लिए उपयोग होती है, जब लाइव कोट कॉन्फ़िगर न हों या 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 और न ही तालिका कोई कीमत देती है। उस स्थिति में विधि को छिपाने के लिए इसे खाली छोड़ें।

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 (kg): कार्ट इससे भारी हो तो विधि छिपाएँ। डिफ़ॉल्ट: 50। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

एडवांस्ड

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

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

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लास। यदि कार्ट सबटोटल Free shipping from तक पहुँचता है, तो विधि 0 लागत के साथ दिखाई जाती है, लेकिन केवल तभी जब देश की कोई कीमत हो: Country prices में एक पंक्ति, एक Fallback cost, या J&T का लाइव कोट। J&T से केवल तभी पूछा जाता है जब तालिका और फ़ॉलबैक लागत कोई कीमत न दें।

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

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

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

3. Fallback cost.

यदि इनमें से कोई भी कीमत न दे, तो विधि छिप जाती है। Per item केवल तालिका और फ़ॉलबैक कीमतों पर लागू होता है।

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

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

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

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

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

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

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

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

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

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

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

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

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

बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग पेज सेव करें। इससे कैश किए J&T कोट साफ़ हो जाते हैं।

डेवलपर हुक: फ़िल्टर vfd_jtex_quote_request कोट अनुरोध का मुख्य भाग (जैसे सेवा प्रकार) बदलता है, vfd_jtex_api_url कोट एंडपॉइंट बदलता है, और मानक फ़िल्टर woocommerce_shipping_vfd_jt_express_is_available उपलब्धता नियंत्रित करता है।

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

अनइंस्टॉल

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

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