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

आवश्यकताएँ

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

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

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

Blue Express खाता (केवल लाइव दरों के लिए): लाइव दरों के लिए Blue Express ई-कॉमर्स खाता और उसकी API कुंजी (x-api-key) चाहिए। इसे Blue Express से माँगें: developers.bluex.cl या gpo.integraciones@bx.cl। आप जो सेवा उपयोग करते हैं (EX, PY या MD), वह आपके Blue Express अनुबंध में सक्षम होनी चाहिए। यदि आप केवल तय कीमतें उपयोग करते हैं, तो आपको API कुंजी की ज़रूरत नहीं है।

पिकअप पॉइंट: Blue Express मानचित्र ग्राहक के ब्राउज़र में widget-pudo.blue.cl से लोड होता है।

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

इंस्टॉलेशन

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

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

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

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

5. API कुंजी, सेवा, मूल ज़िले का कोड (जैसे SCL), यदि आपके स्टोर की मुद्रा CLP नहीं है तो CLP विनिमय दर, और तय कीमतें (जैसे CL=4500) डालें। देखें कॉन्फ़िगरेशन।

6. WooCommerce > Settings > Shipping > Shipping zones पर जाएँ और अपने चिली ज़ोन में VibeFox Blue Express जोड़ें। विधि की सेटिंग्स में शीर्षक और डिलीवरी प्रकार (घर पर डिलीवरी या Blue Express पॉइंट पर पिकअप) चुनें। दोनों विकल्प देने के लिए इसे दो बार जोड़ें।

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

मुख्य सेटिंग्स WooCommerce > Settings > Shipping > VibeFox Blue Express पर हैं। ये हर शिपिंग ज़ोन पर लागू होती हैं। ऐसी सेटिंग्स की चेतावनियाँ, जो विधि या लाइव दर को छिपा दें (API कुंजी नहीं, CLP विनिमय दर नहीं, तय कीमत तालिका खाली), पेज के ऊपर दिखाई जाती हैं। सेटिंग्स सहेजने पर कैश साफ़ हो जाता है।

ज़ोन विंडो (जब आप शिपिंग ज़ोन में विधि जोड़ते हैं)

Title: इस ज़ोन के लिए ग्राहक को दिखने वाला शिपिंग विधि का नाम। वैश्विक Name इस्तेमाल करने के लिए इसे खाली छोड़ें।

Delivery type: As in the global settings (डिफ़ॉल्ट), Home delivery या Pickup at a Blue Express point (PUDO)। घर पर डिलीवरी और पिकअप, दोनों देने के लिए विधि को एक ज़ोन में दो बार जोड़ें।

सामान्य

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

Name: चेकआउट पर दिखने वाला शिपिंग विधि का नाम। कोई ज़ोन अपना शीर्षक तय कर सकता है। डिफ़ॉल्ट: Blue Express।

Tax status: Blue Express की कीमतों में IVA शामिल है। यदि WooCommerce ऊपर से टैक्स न जोड़े तो None चुनें, और यदि जोड़े तो Taxable।

Blue Express API (लाइव दरों के लिए आवश्यक)

API key: आपकी Blue Express API कुंजी (x-api-key हेडर)। इसके बिना केवल तय कीमतें इस्तेमाल होती हैं।

Service: दर के लिए इस्तेमाल होने वाली Blue Express सेवा: Express (EX) (डिफ़ॉल्ट), Prioritario (PY) या SameDay (MD)। यह आपके Blue Express अनुबंध में सक्षम होनी चाहिए।

Origin district code: वह Blue Express ज़िला कोड जहाँ से आप शिप करते हैं, जैसे सैंटियागो के लिए SCL (डिफ़ॉल्ट)। संदेह हो तो Blue Express से पूछें।

CLP per 1 (your currency): Blue Express की कीमतें चिली पेसो (CLP) में हैं। यदि आपका स्टोर किसी और मुद्रा का उपयोग करता है, तो बताएँ कि उस मुद्रा की एक इकाई कितने CLP के बराबर है, जैसे 1050। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। यदि स्टोर की मुद्रा CLP है तो इसे अनदेखा किया जाता है।

कीमत

Rate source: कीमत कैसे निकाली जाती है।

Fixed prices: हर देश के लिए एक पंक्ति, COUNTRY_CODE=PRICE प्रारूप में, आपके स्टोर की मुद्रा में, जैसे CLP स्टोर में CL=4500 या EUR स्टोर में CL=4.50। दशमलव विभाजक के रूप में अल्पविराम या बिंदु स्वीकार होता है। अमान्य पंक्तियाँ सहेजते समय बताई जाती हैं। तय कीमतें किसी भी देश के लिए इस्तेमाल की जा सकती हैं।

Fixed price per: Order कीमत एक बार लेता है। Item (price x quantity) उसे कार्ट के आइटमों की संख्या से गुणा करता है। यह केवल तय कीमत पर लागू होता है। API दर हमेशा पूरी शिपमेंट के लिए होती है।

शर्तें

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

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

Minimum order subtotal: विधि केवल इस कार्ट उप-योग (स्टोर की मुद्रा) से ऊपर होने पर दिखाई जाती है। हमेशा दिखाने के लिए खाली छोड़ें।

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

मुफ़्त शिपिंग

Free shipping: कार्ट उप-योग से मुफ़्त शिपिंग चालू करता है।

Free from subtotal: वह कार्ट उप-योग (स्टोर की मुद्रा) जिससे शिपिंग मुफ़्त है।

Blue Express पॉइंट पर पिकअप (PUDO)

Pickup point by default: चालू होने पर Blue Express विधियाँ ग्राहक द्वारा चुने गए Blue Express पॉइंट पर डिलीवरी करती हैं। यह Delivery type = As in the global settings वाली ज़ोन विधियों का डिफ़ॉल्ट है। ऑर्डर देने के लिए ग्राहक को पॉइंट चुनना होगा।

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

Ignore shipping zones: विधि को तब भी पेश करता है जब वह मेल खाने वाले शिपिंग ज़ोन में नहीं जोड़ी गई हो। तब यह वैश्विक सेटिंग्स इस्तेमाल करती है (कोई ज़ोन शीर्षक या डिलीवरी प्रकार नहीं)।

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

उन्नत

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

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

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

जब ग्राहक डिलीवरी पता डालता है, तो प्लगइन कार्ट का वज़न, Minimum order subtotal और Excluded shipping classes जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो दर 0 होती है और Blue Express को कोई अनुरोध नहीं भेजा जाता।

लाइव दर के लिए पता चिली में होना चाहिए, जिसमें क्षेत्र (region) और शहर (कम्यून) हो। प्लगइन पहले Blue Express से कम्यून पहचानने के लिए कहता है, फिर सेवा, मूल ज़िले, गंतव्य और पार्सलों के लिए कीमत माँगता है। हर उत्पाद का वज़न और आयाम kg और cm में बदलकर भेजा जाता है। जिन उत्पादों में वज़न या आकार नहीं है, वे 0.01 kg, 10 x 10 x 10 cm के रूप में भेजे जाते हैं। घोषित मूल्य CLP में भेजा जाता है। CLP कीमत आपके स्टोर की मुद्रा में बदली जाती है।

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

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

प्लगइन Blue Express में शिपमेंट या लेबल नहीं बनाता, ट्रैकिंग नंबर नहीं देता और ट्रैकिंग अपडेट नहीं दिखाता। शिपमेंट अपने Blue Express खाते में बनाएँ। कम्यून के अनुसार क्षेत्रीय दर तालिकाएँ नहीं हैं: Blue Express API दर या हर देश की एक तय कीमत इस्तेमाल करें। लाइव दरें केवल चिली के लिए काम करती हैं।

पिकअप पॉइंट

डिलीवरी प्रकार Pickup at a Blue Express point (PUDO) होने पर ग्राहक को क्लासिक चेकआउट और ब्लॉक चेकआउट, दोनों में Blue Express विकल्प के नीचे Choose pickup point दिखता है। बटन आधिकारिक Blue Express मानचित्र खोलता है, जहाँ ग्राहक एक पॉइंट चुनता है। चुना गया पॉइंट उसके नाम और पते के साथ दिखता है, और बटन Change pickup point में बदल जाता है। इसके बाद दर को Blue Express पिकअप (PUDO) कीमत के साथ दोबारा गणना किया जाता है।

पॉइंट के बिना ऑर्डर नहीं दिया जा सकता: ग्राहक को Please choose a Blue Express pickup point. दिखता है। यह सर्वर पर जाँचा जाता है।

चुना गया पॉइंट अपने Blue Express एजेंसी कोड, नाम और पते के साथ ऑर्डर में सहेजा जाता है। एडमिन ऑर्डर स्क्रीन पर यह डिलीवरी पते के नीचे Blue Express pickup point के रूप में दिखता है। Blue Express मानचित्र पर कोई दूसरा पॉइंट चुनने या एजेंसी कोड, नाम और पता हाथ से डालने के लिए Edit पर क्लिक करें, फिर Save pickup point पर क्लिक करें। बदलाव ऑर्डर नोट में दर्ज होता है। ग्राहक पॉइंट को ऑर्डर पेज और ऑर्डर ईमेल (HTML और सादा टेक्स्ट) में देखता है। स्टोर को जाने वाले ईमेल में भी एजेंसी कोड दिखता है। मौजूदा ऑर्डर अपना पिकअप पॉइंट डेटा रखते हैं।

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

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

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

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

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

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

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

लाइव दरें नहीं दिख रहीं: Blue Express API only के साथ दर न होने पर विधि छिप जाती है। Debug log चालू करें, चेकआउट दोबारा लोड करें और WooCommerce > Status > Logs खोलें (स्रोत "vfd-blue-express")। आम कारण: API कुंजी नहीं, स्टोर की मुद्रा CLP नहीं और विनिमय दर नहीं, पते में क्षेत्र या कम्यून नहीं, कम्यून Blue Express द्वारा नहीं पहचाना गया, या API त्रुटि (जैसे API कुंजी अस्वीकार होने पर HTTP 401 या 403)। Blue Express API, fixed price if the API gives no rate के साथ, समस्या ठीक करते समय भी ग्राहकों को तय कीमत मिलती है।

Blue Express कीमत के ऊपर टैक्स जुड़ रहा है: Blue Express की कीमतों में IVA शामिल है। यदि WooCommerce ऊपर से टैक्स न जोड़े, तो Tax status को None पर सेट करें।

मानचित्र नहीं खुलता: मानचित्र ग्राहक के ब्राउज़र में widget-pudo.blue.cl से लोड होता है, इसलिए यह पता पहुँच योग्य होना चाहिए और आपकी साइट पर ब्लॉक नहीं होना चाहिए।

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

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

अनइंस्टॉल

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

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