VibeFox Frenet for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x.

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

Frenet खाता (केवल लाइव दरों के लिए): Frenet पैनल (painel.frenet.com.br) में एक मुफ़्त खाता बनाएँ, जिन कैरियर्स का आप उपयोग करते हैं उन्हें सक्रिय करें, और अपना API टोकन कॉपी करें। यदि आप केवल निश्चित कीमतों का उपयोग करते हैं, तो आपको Frenet खाते की ज़रूरत नहीं है।

उत्पाद: सटीक कीमतों के लिए वज़न और आयाम भरें। इनके बिना उत्पादों की दर 0.3 kg और 16 × 11 × 2 cm (Correios का सबसे छोटा बॉक्स) मानकर दी जाती है।

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

इंस्टॉलेशन

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

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

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

4. API टोकन चिपकाएँ और मूल CEP दर्ज करें। यदि आपकी डिफ़ॉल्ट दुकान मुद्रा BRL नहीं है, तो BRL विनिमय दर दर्ज करें। वैकल्पिक रूप से निश्चित कीमतें और फ़ॉलबैक लागत जोड़ें। Save पर क्लिक करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Frenet > Configure। वे कैरियर के हर ज़ोन पर लागू होती हैं। हर खंड का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर कैश की गई Frenet दरें भी साफ़ हो जाती हैं। कीमत के फ़ील्ड में दशमलव विभाजक के रूप में बिंदु और कॉमा दोनों स्वीकार होते हैं; जो मान संख्या नहीं है, उसे "…" must be a number. संदेश के साथ अस्वीकार किया जाता है। ऋणात्मक राशियाँ और वज़न, 0 या उससे कम का BRL exchange rate, और Maximum weight से बड़ा Minimum weight भी अस्वीकार होते हैं। त्रुटि होने पर कुछ भी सहेजा नहीं जाता।

पेज के शीर्ष पर मॉड्यूल चेतावनियाँ दिखाता है: API टोकन नहीं है (तब केवल निश्चित कीमतें इस्तेमाल होती हैं, या निश्चित कीमतें भी न हों तो कैरियर कभी नहीं दिखता), 8 अंकों का मूल CEP नहीं है, या विनिमय दर के बिना डिफ़ॉल्ट मुद्रा BRL नहीं है। यदि आपकी दुकान की वज़न या आयाम इकाई मॉड्यूल नहीं पहचानता, तब भी चेतावनी मिलती है; ऐसी इकाई को kg या cm माना जाता है। International > Localization (Local units) में मानक इकाई सेट करें (kg, g, lb या oz; cm, mm, m या in)।

सामान्य

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

Method title: कार्ट और चेकआउट में दिखने वाला कैरियर का नाम। Default: Frenet. आवश्यक, अधिकतम 64 अक्षर।

Frenet लाइव दरें

Frenet आपके Frenet खाते में सक्रिय कैरियर्स की तुलना करता है और कार्ट के लिए उनकी कीमतें लौटाता है। लाइव दरें केवल ब्राज़ील के उन पतों के लिए माँगी जाती हैं जिनमें पूरा 8 अंकों का CEP है। इस खंड में Frenet पैनल का लिंक है।

API token: Frenet पैनल से लिया गया आपका Frenet API टोकन। केवल निश्चित कीमतें इस्तेमाल करने के लिए इसे खाली छोड़ें। सहेजने के बाद यह फ़ील्ड खाली रहता है और A token is saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजा गया टोकन हटाने के लिए Remove the saved token पर निशान लगाएँ और सहेजें।

Origin CEP: वह CEP (पिन कोड) जहाँ से पार्सल भेजे जाते हैं, जैसे 00000-000. यदि दुकान का पता ब्राज़ील में है, तो Shop Parameters > Contact > Stores का दुकान पिन कोड इस्तेमाल करने के लिए इसे खाली छोड़ें। 8 अंकों से कम का CEP जैसा लिखा गया हो वैसा ही सहेजा जाता है, और पेज Frenet: the origin CEP must have 8 digits. दिखाता है।

Service to offer: Cheapest service (डिफ़ॉल्ट) या Fastest service. Frenet कई सेवाएँ लौटाता है, और कैरियर एक ही कीमत दिखाता है।

BRL exchange rate: Frenet ब्राज़ीलियाई रियल में दर देता है। यदि आपकी डिफ़ॉल्ट मुद्रा BRL नहीं है, तो बताएँ कि डिफ़ॉल्ट मुद्रा में 1 BRL कितने का है, जैसे 0.16। दर और घोषित ऑर्डर मूल्य इसी से परिवर्तित होते हैं। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। जब डिफ़ॉल्ट मुद्रा BRL हो, तब फ़ील्ड Not needed (shop currency is BRL) दिखाता है।

निश्चित कीमतें

जब API टोकन न हो, जिन देशों में Frenet सेवा नहीं देता उनके लिए, और जब भी Frenet कोई कीमत नहीं लौटाता (API बंद है, CEP सेवा क्षेत्र में नहीं है) तब इस्तेमाल होती हैं।

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

Fallback cost: तब इस्तेमाल होती है जब न Frenet और न ही तालिका कोई कीमत दे। कैरियर छिपाने के लिए इसे खाली छोड़ें।

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

शर्तें

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

Maximum weight: कार्ट का वज़न इससे अधिक होने पर कैरियर छिपाता है, kg में। Default: 30 (फ़ील्ड खाली होने पर भी यही इस्तेमाल होता है)। 0 का अर्थ है कोई सीमा नहीं। यह Minimum weight से कम नहीं हो सकता।

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

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

Tax: कैरियर का टैक्स नियम, या No tax. Frenet की कीमतें कैरियर की अंतिम कीमतें हैं। यदि PrestaShop को इन पर टैक्स नहीं जोड़ना है तो No tax चुनें।

उत्पादों के वज़न और आयाम आपकी दुकान की इकाइयों से kg और cm में बदले जाते हैं।

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

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

Ignore shipping zones: कोई भी ज़ोन मेल खाए, नीचे दिए गए देशों के लिए Frenet देता है। सहेजने पर कैरियर सभी ज़ोन में जोड़ा जाता है, और बाद में बनाए गए ज़ोन में भी। जब आप इसे फिर से बंद करते हैं, तो कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं।

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

उन्नत

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

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

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

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

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

पूरे 8 अंकों के CEP वाले ब्राज़ील के पते के लिए मॉड्यूल Frenet को मूल और गंतव्य CEP, कार्ट का हर आइटम (kg में वज़न, cm में आयाम, मात्रा, उत्पाद संदर्भ और श्रेणियाँ), BRL में ऑर्डर मूल्य और कार्ट का पहला कूपन कोड भेजता है। CEP अधूरा होने तक कोई अनुरोध नहीं किया जाता। Frenet आपके सक्रिय कैरियर्स की सेवाएँ लौटाता है। त्रुटि वाली या बिना कीमत की सेवाएँ छोड़ दी जाती हैं। मॉड्यूल सबसे सस्ती या सबसे तेज़ सेवा चुनता है और कीमत को आपकी डिफ़ॉल्ट मुद्रा में बदलता है। फिर कीमत ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

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

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

ऑर्डर

जब Frenet कैरियर के साथ ऑर्डर दिया जाता है, तो मॉड्यूल सहेजता है कि उसकी शिपिंग कीमत कैसे गणना की गई थी। बैक ऑफिस के ऑर्डर पेज पर फिर इन पंक्तियों के साथ एक Frenet ब्लॉक दिखता है:

Carrier: Frenet कैरियर और सेवा, जैसे Correios या Jadlog की कोई सेवा। लाइव दरों के लिए दिखती है।

Delivery time: Frenet द्वारा लौटाया गया कार्य दिवसों में डिलीवरी का समय। लाइव दरों के लिए दिखता है।

Price source: Live Frenet quote, Fixed price (price per country), Fallback cost या Free shipping.

मॉड्यूल की अनइंस्टॉलेशन पर भी यह डेटा रखा जाता है, Remove data on uninstall के साथ भी।

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

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

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

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

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

चेकआउट पर Frenet दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Frenet चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है, या Ignore shipping zones चालू है और देश की अनुमति है। मॉड्यूल पेज के शीर्ष की चेतावनियाँ, वज़न की सीमाएँ और Minimum order amount देखें। सामान्य कारण: ग्राहक ने अभी पूरा 8 अंकों का CEP दर्ज नहीं किया है और कोई निश्चित कीमत नहीं है, या Frenet ने इस मार्ग के लिए कोई सेवा नहीं लौटाई और कोई निश्चित कीमत नहीं है। उत्पाद पेज पर उत्पादों को कुछ कैरियर्स तक सीमित भी किया जा सकता है।

लाइव दरें दिखाई नहीं देतीं: Debug log चालू करें, चेकआउट को फिर से लोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: मूल CEP नहीं है, BRL विनिमय दर नहीं है, ग्राहक का CEP अधूरा है, वज़न या राशि की सीमा है, या छोड़ी गई सेवाओं के संदेश।

लॉग कहता है कि API टोकन अस्वीकार हुआ (HTTP 401 या 403): Frenet पैनल से टोकन फिर से कॉपी करें और API token में चिपकाएँ।

लॉग कहता है कि Frenet ने कोई सेवा नहीं लौटाई: Frenet पैनल में कम से कम एक कैरियर सक्रिय करें।

मेरी दुकान यूरो या डॉलर में बेचती है: Frenet BRL में उत्तर देता है। BRL exchange rate दर्ज करें (डिफ़ॉल्ट मुद्रा में 1 BRL कितने का है)।

Frenet कीमत के ऊपर टैक्स लगता है: Frenet की कीमतें कैरियर की अंतिम कीमतें हैं। Tax को No tax पर सेट करें।

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

पेज कहता है कि Frenet कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया जा चुका है। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें। तब तक सहेजने पर The settings were saved, but the carrier could not be updated. दिखता है।

अनइंस्टॉल

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

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