VibeFox Cargoson for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Cargoson खाता (केवल लाइव कीमतों के लिए): लाइव कीमतें Cargoson की फ़्रेट प्राइस API का उपयोग करती हैं। फ़्रेट कीमत की क्वेरी के लिए API एक्सेस वाली Cargoson सदस्यता चाहिए (लिखे जाने के समय Advanced प्लान या उससे ऊपर)। API कुंजी आपके Cargoson खाते में जारी होती है; यदि आपके प्लान में API सेटिंग्स दिखाई नहीं देतीं, तो Cargoson सहायता से संपर्क करें। कीमतें उस खाते से जुड़े कैरियर्स और मूल्य सूचियों से आती हैं। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो आपको Cargoson खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

4. चुनें कि शिपिंग लागत कैसे गणना की जाएगी, और संबंधित अनुभाग भरें: निश्चित कीमतें और, लाइव कीमतों के लिए, API कुंजी और संग्रह पिन कोड (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल Delivery by the cheapest Cargoson carrier डिलीवरी समय टेक्स्ट के साथ Cargoson कैरियर बनाता है। कैरियर सभी ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सारी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Cargoson > Configure। वे कैरियर के हर ज़ोन पर लागू होती हैं। हर अनुभाग का अपना Save बटन है, जो पूरा पेज सहेजता है। सहेजने के बाद आपको Settings saved. Cached Cargoson prices were cleared. दिखता है। दशमलव संख्याएँ बिंदु (point) या कॉमा से लिखी जा सकती हैं। यदि कोई संख्या फ़ील्ड में टेक्स्ट या ऋणात्मक संख्या है, Currency conversion rate 0 है, Minimum weight, Maximum weight से बड़ा है, Method title 64 अक्षरों से लंबा है, Price currency 3-अक्षर का कोड नहीं है, या कीमत तालिका की किसी पंक्ति में अमान्य देश कोड या कीमत है, तो कुछ भी सहेजा नहीं जाता और पेज त्रुटि दिखाता है। यदि मॉड्यूल स्टोर की वज़न इकाई नहीं पहचानता, तो सहेजने के बाद एक चेतावनी दिखती है कि उत्पादों के वज़न किलोग्राम में माने जाते हैं; इकाई International > Localization (Local units) में सेट करें।

General

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

Method title: कार्ट और चेकआउट में दिखाया जाने वाला कैरियर का नाम। डिफ़ॉल्ट: Cargoson। आवश्यक। Shipping > Carriers में भी यही कैरियर का नाम है।

Shipping cost: कीमत कैसे गणना होती है।

लाइव कीमत न मिलने का कारण मॉड्यूल लॉग में लिखा जाता है। यह ग्राहक को कभी नहीं दिखाया जाता।

Cargoson API (केवल लाइव कीमतों के लिए आवश्यक)

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

Remove the saved API key: सहेजी गई कुंजी होने पर दिखाई देता है। इसे चालू करके सहेजें, कुंजी हट जाएगी।

Carrier: कौन सी कीमतें उपयोग होंगी। ग्राहक को एक ही दर दिखती है।

Package type code: कीमत क्वेरी के साथ भेजा जाने वाला Cargoson पैकेज प्रकार कोड। डिफ़ॉल्ट: CLL। Cargoson API के उदाहरण EUR (EUR पैलेट) और FIN (FIN पैलेट) का उपयोग करते हैं। पार्सल के लिए अपने Cargoson खाते का पैकेज कोड उपयोग करें। ऑर्डर कुल कार्ट वज़न के साथ एक पैकेज के रूप में भेजा जाता है।

Price currency: आपके Cargoson खाते में कीमतों की मुद्रा, 3-अक्षर के कोड के रूप में। डिफ़ॉल्ट: EUR। API मुद्रा कोड के बिना राशि लौटाता है।

Currency conversion rate: केवल तब आवश्यक है जब कीमत की मुद्रा आपके स्टोर की डिफ़ॉल्ट मुद्रा से अलग हो: Cargoson मुद्रा की 1 इकाई = आपकी डिफ़ॉल्ट मुद्रा की X इकाइयाँ। ऐसी कीमतें अस्वीकार करने के लिए इसे खाली छोड़ें, ताकि ग्राहक से कभी गलत मुद्रा में शुल्क न लिया जाए।

इससे भेजें (संग्रह पता) (लाइव कीमतों के लिए उपयोग होता है)

Collection country: वह देश जहाँ से आप भेजते हैं। डिफ़ॉल्ट रूप से यह आपके स्टोर का देश है।

Collection postcode: वह पिन कोड जहाँ से आप भेजते हैं। Cargoson इसे आवश्यक मानता है। यदि यह खाली है और संग्रह देश आपके स्टोर का देश है, तो Shop Parameters > Contact > Stores से स्टोर का पिन कोड उपयोग होता है।

Cargoson को भेजी गई संग्रह तिथि स्टोर के समय क्षेत्र में आज है, या सप्ताहांत पर अगला सोमवार।

निश्चित कीमतें (जब Shipping cost Fixed prices हो तब उपयोग होती हैं, और लाइव कीमतों के लिए विकल्प के रूप में भी)

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

Fixed price applies: Per order कीमत एक बार लेता है। Per item (price × quantity) इसे कार्ट में आइटमों की संख्या से गुणा करता है। Cargoson की लाइव कीमतें हमेशा प्रति शिपमेंट होती हैं।

शर्तें

Minimum weight: इस कार्ट वज़न से कम होने पर कैरियर छिपाएँ, किलोग्राम में। 0 का अर्थ है कोई सीमा नहीं।

Maximum weight: इस कार्ट वज़न से अधिक होने पर कैरियर छिपाएँ, किलोग्राम में। डिफ़ॉल्ट: 25। 0 का अर्थ है कोई सीमा नहीं।

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

Free shipping: नीचे दी गई ऑर्डर राशि पहुँचने पर मुफ़्त डिलीवरी चालू करें।

Free shipping from: कार्ट का उप-योग (छूट के बाद, कर से पहले) जिससे डिलीवरी मुफ़्त होती है। यह केवल तब उपयोग होता है जब Free shipping चालू हो।

Tax: कैरियर का टैक्स नियम, या No tax। Cargoson में कैरियर की कीमतें आमतौर पर बिना कर (VAT के बिना) होती हैं। यदि आपकी कीमतों में पहले से कर शामिल है, तो No tax चुनें।

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

आमतौर पर कैरियर उन ज़ोन में पेश किया जाता है जो उसे Shipping > Carriers में सौंपे गए हैं।

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

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

एडवांस्ड

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

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

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

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

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

निश्चित मोड में कीमत तालिका से ली जाती है। लाइव मोड में मॉड्यूल Cargoson को संग्रह तिथि, संग्रह देश और पिन कोड, डिलीवरी देश और पिन कोड, तथा पैकेज प्रकार कोड और कुल कार्ट वज़न (कम से कम 0.1 kg) वाला एक पैकेज भेजता है। लाइव कीमत केवल तब माँगी जाती है जब डिलीवरी पते में पिन कोड हो। Cargoson आपके कैरियर्स की कीमतें लौटाता है; मॉड्यूल सबसे सस्ती चुनता है (यदि कोई कैरियर चुना गया हो, तो उसी में से) और ज़रूरत हो तो उसे आपकी डिफ़ॉल्ट मुद्रा में बदलता है। कीमत आपकी डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

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

मॉड्यूल केवल दरों की गणना करता है। यह Cargoson में शिपमेंट या बुकिंग नहीं बनाता, लेबल प्रिंट नहीं करता या पार्सल ट्रैक नहीं करता, और ग्राहक पार्सल मशीन या पिकअप पॉइंट नहीं चुन सकते। कार्ट को कुल वज़न वाले एक पैकेज के रूप में कोट किया जाता है; पैकेज के आयाम नहीं भेजे जाते। केवल सबसे सस्ती कीमत दिखती है, कैरियर्स की सूची नहीं।

ऑर्डर

Cargoson ऑर्डर के पेज पर एक Cargoson shipping ब्लॉक दिखता है, जिसमें चेकआउट पर गणना की गई दर होती है:

Carrier, Service और Cargoson service ID: कोट किया गया Cargoson कैरियर और सेवा, जो तब दिखती है जब लाइव कीमत उपयोग हुई हो।

Price source: Cargoson live price, Fixed price या Free shipping threshold।

Calculated price (excl. tax): आपके स्टोर की डिफ़ॉल्ट मुद्रा में कीमत।

कोट ऑर्डर देने पर सहेजा जाता है और बाद में नहीं बदलता। शिपमेंट Cargoson में या उसके अपने इंटीग्रेशन से बुक करें।

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

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

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

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

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

Cargoson चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Cargoson चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है और देश Countries में है)। वज़न सीमाएँ और Minimum order amount जाँचें। निश्चित मोड में जाँचें कि देश या * के लिए कार्ट के आकार की कीमत है। उत्पाद पेज पर उत्पादों को कुछ कैरियर्स तक सीमित भी किया जा सकता है।

लाइव कीमतें दिखाई नहीं देतीं: मॉड्यूल पेज पर Log फ़ील्ड देखें। API त्रुटियाँ हमेशा दर्ज होती हैं; हर गणना देखने के लिए Debug log चालू करें। आम कारण: अभी तक डिलीवरी पिन कोड नहीं डाला गया, संग्रह पिन कोड नहीं है, API कुंजी अस्वीकार हुई (गलत या समाप्त कुंजी, या आपके Cargoson प्लान में API एक्सेस नहीं), मार्ग या वज़न के लिए कोई कैरियर नहीं, या दूसरी मुद्रा में कीमत। Cargoson live prices, fixed prices if the API fails के साथ समस्या ठीक करते समय भी ग्राहकों को निश्चित कीमत मिलती रहती है।

Cargoson पैकेज प्रकार अस्वीकार करता है: अपने Cargoson खाते का वह पैकेज कोड उपयोग करें जो Package type code में है। कारण लॉग में दिखता है।

दूसरी मुद्रा की कीमत अस्वीकार होती है: Price currency को अपनी Cargoson कीमतों की मुद्रा पर सेट करें और Currency conversion rate दर्ज करें।

शिपिंग पर कर दोगुना लगता है: आपकी Cargoson कीमतों में पहले से VAT शामिल है। Tax को No tax पर सेट करें।

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

पेज कहता है कि Cargoson कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया जा चुका है। उसे दोबारा बनाने के लिए Modules > Module Manager में मॉड्यूल को रीसेट करें।

अनइंस्टॉल

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

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