VibeFox Coordinadora for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Coordinadora API कुंजी (केवल लाइव कोट के लिए): लाइव कोट Coordinadora WooCommerce सेवा के माध्यम से Coordinadora Cotizador से आते हैं, वही सेवा जिसका आधिकारिक Coordinadora प्लगइन उपयोग करता है। Coordinadora यह API कुंजी उन ग्राहकों को देता है जिनका सक्रिय वाणिज्यिक समझौता है। अपने Coordinadora अकाउंट मैनेजर से पूछें या wc.coordinadora.com देखें। आपको उस शहर का 8 अंकों वाला DANE कोड भी चाहिए जहाँ से आप शिप करते हैं। कुंजी के बिना यह विधि केवल निश्चित मूल्य के साथ काम करती है।

उत्पाद: लाइव कोट के लिए कार्ट के हर उत्पाद में वज़न और आयाम (लंबाई, चौड़ाई, ऊँचाई) होने चाहिए।

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

इंस्टॉलेशन

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

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

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

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

5. API कुंजी, भेजने वाले शहर का DANE कोड और, यदि आपके स्टोर की मुद्रा COP नहीं है, तो COP विनिमय दर दर्ज करें। बैकअप के रूप में कोलंबिया के लिए कम से कम एक निश्चित मूल्य जोड़ें (देखें कॉन्फ़िगरेशन)।

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

7. सुनिश्चित करें कि आपके उत्पादों में वज़न और आयाम हों।

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

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

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

जब लाइव कोट काम नहीं कर सकते या विधि छिप जाएगी, तो सेटिंग्स पेज के ऊपर चेतावनियाँ दिखती हैं: भेजने वाले शहर का DANE कोड गायब या अमान्य है, COP विनिमय दर गायब है, या कोलंबिया के लिए कोई निश्चित मूल्य नहीं है। हर बार सेटिंग्स सहेजने पर कैश किए गए कोट साफ़ हो जाते हैं। संख्याएँ बिंदु या अल्पविराम से दर्ज की जा सकती हैं (9,99 = 9.99)।

सामान्य

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

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Coordinadora। ज़ोन का Title इसे बदल देता है।

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

Coordinadora लाइव रेट

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

API key: Coordinadora से मिली आपकी WooCommerce API कुंजी। यह कभी लॉग में नहीं लिखी जाती।

Origin city (DANE code): उस शहर का 8 अंकों वाला DANE कोड जहाँ से आप शिप करते हैं, जैसे 11001000 Bogotá, 05001000 Medellín, 76001000 Cali या 08001000 Barranquilla। 5 अंकों वाला नगरपालिका कोड भी स्वीकार होता है और 8 अंकों तक पूरा कर दिया जाता है।

COP per 1 unit of store currency: Coordinadora कोलंबियाई पेसो में कोट करता है। यदि आपके स्टोर की मुद्रा COP नहीं है, तो बताएँ कि आपकी मुद्रा की 1 इकाई के बराबर कितने COP होते हैं, जैसे 4300। यह दर घोषित मूल्य को COP में भेजने के लिए भी उपयोग होती है। खाली छोड़ने पर लाइव रेट उपयोग नहीं होते। यदि आपके स्टोर की मुद्रा COP है, तो खाली छोड़ें।

निश्चित मूल्य (API कुंजी न होने पर, कोलंबिया के बाहर के गंतव्यों के लिए, और लाइव कोट उपलब्ध न होने पर बैकअप के रूप में उपयोग होते हैं)

Prices by country: देशों की एक तालिका, जिसमें Price कॉलम और आपके स्टोर की मुद्रा में वैकल्पिक पैकेज-आकार मूल्य हों। आकार कार्ट के वज़न से तय होता है: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg से अधिक। जब आकार कॉलम 0 या खाली हो, तब Price उपयोग होता है। पंक्ति जोड़ने के लिए + Add country पर और हटाने के लिए क्रॉस पर क्लिक करें। * All other countries उन देशों पर लागू होता है जिनकी अपनी पंक्ति नहीं है। जिस देश की पंक्ति नहीं है (और जो * भी नहीं है), उसे निश्चित मूल्य नहीं मिलता। Price 0 हो और आकार-मूल्य न हो, तो वह पंक्ति मुफ़्त शिपिंग देती है।

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

शर्तें

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

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

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

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

Free shipping: नीचे दिए सबटोटल से मुफ़्त डिलीवरी चालू करता है।

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

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

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

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

उन्नत

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

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

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

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

API कुंजी वाले कोलंबियाई पते के लिए प्लगइन गंतव्य शहर का DANE कोड इस क्रम में खोजता है: शहर फ़ील्ड में DANE कोड (कोलंबियाई विभाग और शहर चेकआउट प्लगइन इसे लिखते हैं, उदाहरण के लिए MEDELLIN (ANT) (05001000)), 8 अंकों वाला पिन कोड, या विभाग मुख्यालयों और लगभग 40 सबसे बड़े शहरों की अंतर्निहित सूची। सूची का शहर चुने गए विभाग से मिलाया जाता है। एक्सेंट और अक्षरों का आकार (केस) अनदेखा किया जाता है।

फिर प्लगइन Coordinadora को गंतव्य DANE कोड और हर उत्पाद को भेजने वाले शहर, उसके वज़न (kg), आयाम (cm), मात्रा और घोषित मूल्य (COP) के साथ भेजता है। स्टोर की इकाइयाँ अपने-आप परिवर्तित होती हैं। Coordinadora COP में मूल्य लौटाता है, और प्लगइन उसे आपके स्टोर की मुद्रा में बदल देता है। हर कोट 1 घंटे तक कैश होता है। विफल अनुरोध 10 मिनट तक याद रखा जाता है, ताकि Coordinadora की रुकावट हर चेकआउट रिफ़्रेश को धीमा न करे। API टाइमआउट 10 सेकंड है।

जब लाइव कोट उपलब्ध न हो (API त्रुटि, अज्ञात शहर, बिना वज़न या आयाम वाला उत्पाद, सेटिंग्स गायब), तो निश्चित मूल्य लिया जाता है। यदि वह भी न हो, तो विधि छिप जाती है। त्रुटि का विवरण WooCommerce लॉग में जाता है, कभी ग्राहक को नहीं दिखता।

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

प्लगइन केवल रेट की गणना करता है। यह शिपमेंट या गाइड (guías) नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप (recogidas) बुक नहीं करता, पार्सल ट्रैक नहीं करता, कैश ऑन डिलीवरी (recaudo) नहीं लेता और Droop पिकअप पॉइंट नहीं देता; इनके लिए Coordinadora पोर्टल का उपयोग करें। यह उसी दिन की डिलीवरी का कोट नहीं देता, और अंतरराष्ट्रीय गंतव्य निश्चित मूल्य उपयोग करते हैं।

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

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

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

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

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

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

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

लाइव रेट नहीं दिखता, केवल निश्चित मूल्य दिखता है: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-coordinadora। सामान्य कारण: गंतव्य शहर पहचाना नहीं गया, किसी उत्पाद में वज़न या आयाम नहीं है, भेजने वाले शहर का DANE कोड या COP विनिमय दर नहीं है, या Coordinadora ने त्रुटि लौटाई।

गंतव्य शहर पहचाना नहीं गया: कोलंबियाई विभाग और शहर चेकआउट प्लगइन इंस्टॉल करें, जो शहर फ़ील्ड में DANE कोड लिखता हो। डेवलपर vfd_crd_dane_cities और vfd_crd_destination_dane फ़िल्टर से और शहर मैप कर सकते हैं।

क्या रेट में टैक्स शामिल है? रेट वही है जो Coordinadora कोट करता है। Tax status को Taxable पर रखने से WooCommerce उसके ऊपर शिपिंग टैक्स जोड़ता है; यदि कोट में पहले से टैक्स है, तो None चुनें।

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

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

अनइंस्टॉल

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

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