VibeFox Coordinadora for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Coordinadora > Configure। वे कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव से कैश किए गए Coordinadora कोट भी साफ़ हो जाते हैं। संख्याएँ बिंदु या कॉमा से लिखी जा सकती हैं (9,99 = 9.99)।

जब कोई संख्या या तालिका की कीमत अमान्य या ऋणात्मक हो, COP per 1 unit of store currency 0 हो, Min weight, Max weight से अधिक हो, या Name 64 अक्षरों से लंबा हो, तब पेज सेव करने से इनकार करता है और त्रुटि दिखाता है। जब तक आप सुधार नहीं करते, कुछ भी सेव नहीं होता।

जब लाइव कोट काम नहीं कर सकते या कैरियर छिप जाएगा, तब पेज के ऊपर चेतावनियाँ दिखती हैं: Origin city (DANE code) खाली या अमान्य है, डिफ़ॉल्ट मुद्रा COP न होने पर भी COP per 1 unit of store currency नहीं भरा गया है, या कोलंबिया (या *) के लिए कोई निश्चित मूल्य नहीं है। API कुंजी और ऐसे निश्चित मूल्य के बिना कैरियर कोलंबियाई पतों के लिए कभी नहीं दिखाया जाता। जब स्टोर की वज़न या आयाम इकाई International > Localization (Local units) में मॉड्यूल के लिए अज्ञात हो, तब भी चेतावनी दिखती है; तब उत्पाद वज़न को kg और आयाम को cm माना जाता है।

सामान्य

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

Name: चेकआउट पर ग्राहक को दिखाया जाने वाला कैरियर नाम। डिफ़ॉल्ट: Coordinadora। आवश्यक।

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

Coordinadora लाइव दरें

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

API key: Coordinadora से मिली आपकी Coordinadora WooCommerce API कुंजी। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। कुंजी कभी लॉग में नहीं लिखी जाती।

Remove the saved API key: केवल तब दिखता है जब कोई कुंजी सेव हो। इसे चालू करें और कुंजी हटाने के लिए Save पर क्लिक करें; फिर कैरियर केवल निश्चित मूल्यों का उपयोग करता है।

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 में भेजने के लिए भी उपयोग होती है। खाली छोड़ने पर लाइव दरें उपयोग नहीं होतीं। दर 0 से अधिक होनी चाहिए। यदि आपकी डिफ़ॉल्ट मुद्रा 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 का मतलब कोई सीमा नहीं। यह Min weight से कम नहीं हो सकता।

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

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

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

Countries: Coordinadora केवल इन गंतव्य देशों के लिए दिखाता है। केवल सक्रिय देश सूचीबद्ध होते हैं। कैरियर के ज़ोन के सभी देशों की अनुमति देने के लिए खाली छोड़ें।

उन्नत

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

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

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

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

शिपिंग चरण पर PrestaShop मॉड्यूल से Coordinadora की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और कोट में शामिल नहीं होते। मॉड्यूल पहले शर्तें जाँचता है: अनुमत देश, कार्ट वज़न और न्यूनतम ऑर्डर सबटोटल। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और Coordinadora को कोई अनुरोध नहीं जाता।

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

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

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

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

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

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

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

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

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

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

चेकआउट पर Coordinadora नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Coordinadora चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है। Countries, वज़न सीमाएँ और Minimum order subtotal जाँचें। लाइव कोट के बिना, देश या * के लिए निश्चित मूल्य मौजूद होना चाहिए। उत्पाद पेज पर उत्पादों को कुछ कैरियरों तक सीमित भी किया जा सकता है।

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

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

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

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

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

अनइंस्टॉलेशन

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

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