VibeFox Chilexpress for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद।

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

PHP: 8.0 या उसके बाद।

Chilexpress API कुंजियाँ (केवल लाइव दरों के लिए): Chilexpress डेवलपर पोर्टल (developers.wschilexpress.com) पर एक खाता बनाएँ और दो उत्पादों की सदस्यता लें: Rating (Cotizador) और Coverage (Coberturas / Georreferencia)। हर उत्पाद की अपनी सदस्यता कुंजी होती है। टेस्ट कुंजियाँ केवल टेस्ट वातावरण में काम करती हैं; प्रोडक्शन कुंजियाँ Chilexpress के ऐसे व्यावसायिक ग्राहकों को दी जाती हैं जिनका ग्राहक अनुबंध है। आपको उस comuna का Chilexpress county कोड भी चाहिए जहाँ से आप शिप करते हैं, उदाहरण के लिए STGO। यदि आप केवल निश्चित कीमतें इस्तेमाल करते हैं, तो API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. कीमत तालिका भरें। लाइव दरों के लिए दोनों सदस्यता कुंजियाँ, अपना origin county कोड डालें और यदि स्टोर की मुद्रा CLP नहीं है तो CLP विनिमय दर भी डालें, फिर दर स्रोत चुनें (देखें कॉन्फ़िगरेशन)।

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

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

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

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

सेटिंग्स पेज के शीर्ष पर समस्याएँ दिखती हैं: API दरें चुनी गई हैं पर कुंजी, origin county कोड या CLP विनिमय दर गायब है, या कीमत तालिका में चिली या डिफ़ॉल्ट (* Default) की पंक्ति नहीं है। सेटिंग्स सहेजने पर कैश की गई दरें और comuna सूचियाँ साफ़ हो जाती हैं। संख्याएँ बिंदु या कॉमा के साथ लिखी जा सकती हैं; गलत संख्या सहेजी नहीं जाती और एक त्रुटि दिखती है।

सामान्य

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

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। Default: Chilexpress.

Tax status: Taxable (यदि कर चालू हैं) शिपिंग लागत में WooCommerce कर जोड़ता है, None नहीं जोड़ता। Chilexpress API दरें जैसी उद्धृत की गई हैं वैसे ही इस्तेमाल होती हैं। यदि उद्धरण में पहले से IVA शामिल है और आपका स्टोर उसके ऊपर और कर जोड़ेगा, तो None चुनें।

दरें

Rate source: कीमत कहाँ से आती है।

लाइव दरें केवल चिली के गंतव्यों के लिए उपलब्ध हैं। अन्य देश हमेशा निश्चित कीमतें इस्तेमाल करते हैं।

Country prices: गंतव्य देशों की तालिका, जिसमें Price कॉलम और आपकी स्टोर मुद्रा में पार्सल आकार के अनुसार वैकल्पिक कीमतें होती हैं। आकार कार्ट के वज़न से तय होता है: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक, XL 5 kg से ऊपर। आकार को 0 पर छोड़ने पर Price इस्तेमाल होता है। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। * Default पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। जिस देश की पंक्ति नहीं है (और * भी नहीं), उसकी निश्चित कीमत नहीं होती। जिस पंक्ति की कीमत और आकार-कीमत दोनों 0 हों, उसके लिए शिपिंग मुफ़्त है।

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

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

Test environment: Chilexpress के टेस्ट वातावरण (qaservices.wschilexpress.com) का इस्तेमाल करता है। इसे टेस्ट कुंजियों के साथ उपयोग करें और लाइव स्टोर पर बंद करें।

Rating API key: Rating (Cotizador) उत्पाद की सदस्यता कुंजी।

Coverage API key: Coverage (Coberturas / Georreferencia) उत्पाद की सदस्यता कुंजी। इसका इस्तेमाल ग्राहक की comuna का Chilexpress county कोड खोजने के लिए होता है (चेकआउट पर शहर फ़ील्ड)।

Origin county code: वह Chilexpress county (comuna) कोड जहाँ से आप शिप करते हैं, 2–5 अक्षर, उदाहरण के लिए STGO (Santiago Centro), PROV (Providencia), LCON (Las Condes), VALP (Valparaíso) या CONC (Concepción)। जो मान county कोड नहीं है, उसे त्रुटि के साथ अस्वीकार किया जाता है।

Service: दर के लिए इस्तेमाल होने वाली Chilexpress सेवा। यदि गंतव्य के लिए वह उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा इस्तेमाल होती है।

CLP exchange rate: Chilexpress चिली पेसो में दर बताता है। यह केवल तब चाहिए जब आपके स्टोर की मुद्रा CLP न हो: आपकी स्टोर मुद्रा में 1 CLP की कीमत, उदाहरण के लिए 0.001। इसके बिना API दरें इस्तेमाल नहीं होतीं।

उपलब्धता

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

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

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

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

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

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

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

Free shipping: मुफ़्त शिपिंग की सीमा चालू करता है।

Free shipping from: कार्ट का उप-योग जिससे शिपिंग मुफ़्त हो जाती है। केवल तब इस्तेमाल होता है जब Free shipping चालू हो। ऐसे में API अनुरोध नहीं भेजा जाता।

उन्नत

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

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

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

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

चिली के पते और API दर स्रोत के लिए, प्लगइन क्षेत्र और comuna शहर फ़ील्ड से लेता है और उस क्षेत्र की comuna सूची (Coverage API) में Chilexpress county कोड खोजता है। उच्चारण चिह्न, खाली जगहें और वर्तनी के रूप अनदेखे किए जाते हैं, इसलिए Ñuñoa और Nunoa मेल खाते हैं, और Santiago, Santiago Centro से मेल खाता है। शहर फ़ील्ड में सीधे लिखा county कोड भी स्वीकार होता है। फिर प्लगइन Rating API को मूल और गंतव्य के county कोड, कार्ट का वज़न (कम से कम 0.1 kg), पार्सल के आयाम (सबसे बड़े उत्पाद की लंबाई और चौड़ाई, ऊँचाइयाँ एक पर एक), और घोषित मूल्य के रूप में CLP में कार्ट का उप-योग भेजता है। Chilexpress अपनी सेवाएँ लौटाता है; प्लगइन चुनी हुई या सबसे सस्ती सेवा इस्तेमाल करता है और पेसो राशि को आपके स्टोर की मुद्रा में बदलता है। सेवा का नाम ऑर्डर की शिपिंग पंक्ति पर Chilexpress service के रूप में सहेजा जाता है।

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

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

प्लगइन केवल दरों की गणना करता है। यह शिपमेंट या ट्रांसपोर्ट ऑर्डर (OT) नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता या पार्सल ट्रैक नहीं करता; शिपमेंट अपने Chilexpress खाते में बुक करें। ग्राहक Chilexpress ऑफ़िस नहीं चुन सकते, और कोई comuna चयनकर्ता नहीं है: ग्राहक मानक शहर फ़ील्ड में comuna लिखता है। अंतरराष्ट्रीय शिपमेंट निश्चित कीमतें इस्तेमाल करते हैं।

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

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

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

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

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

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

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

लाइव दर नहीं दिखती, उसकी जगह निश्चित कीमत इस्तेमाल होती है: पहले सेटिंग्स पेज के शीर्ष पर चेतावनियाँ देखें। अन्यथा Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-chilexpress। आम कारण: कोई comuna जिसे Chilexpress नहीं पहचानता (शहर फ़ील्ड और क्षेत्र जाँचें), गलत उत्पाद या वातावरण की कुंजी, या ऐसा गंतव्य जहाँ Chilexpress की सेवा नहीं है।

लॉग में HTTP 401 या 403: सदस्यता कुंजी गलत है, निष्क्रिय है, या किसी दूसरे उत्पाद या वातावरण की है। टेस्ट कुंजियाँ केवल Test environment चालू होने पर काम करती हैं।

दूसरी मुद्रा वाले स्टोर में API दरें इस्तेमाल नहीं होतीं: CLP exchange rate डालें।

क्या API दरों में IVA शामिल है या नहीं? वे ठीक वैसे ही इस्तेमाल होती हैं जैसे Chilexpress उन्हें उद्धृत करता है। यदि आपका स्टोर शिपिंग पर कर जोड़ता है और उद्धरण में पहले से IVA है, तो Tax status को None पर सेट करें।

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

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

अनइंस्टॉल

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

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