VibeFox Loggi for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Loggi खाता (केवल लाइव कीमतों के लिए): लाइव कीमत Loggi GraphQL API का उपयोग करती है, जिसके लिए एक API कुंजी चाहिए जो Loggi बिज़नेस खातों के लिए जारी करता है। अपने Loggi खाता प्रबंधक या Loggi इंटीग्रेशन सपोर्ट (integracoes@loggi.com) से संपर्क करें; Loggi API दस्तावेज़ docs.api.loggi.com पर भी देखें। आपको तीन मान चाहिए: आपके Loggi खाते का ईमेल, API कुंजी और आपके स्टोर का संख्यात्मक ID। यदि आपके Loggi खाते में केवल नए Loggi REST प्लेटफ़ॉर्म API के लिए क्रेडेंशियल (client ID और secret) हैं, तो लाइव कीमत उपलब्ध नहीं है और निश्चित कीमतें उपयोग होती हैं। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो आपको Loggi खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

4. Loggi API ईमेल, API कुंजी, Shop ID और पिकअप पता दर्ज करें और, यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL नहीं है, तो BRL विनिमय दर भी दर्ज करें। सुरक्षा जाल के रूप में निश्चित कीमतें जोड़ें (देखें कॉन्फ़िगरेशन) और Save पर क्लिक करें।

5. Shipping > Carriers में Loggi कैरियर के ज़ोन में ब्राज़ील जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

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

सभी सेटिंग्स मॉड्यूल के पेज पर हैं: Modules > Module Manager > VibeFox Loggi > Configure। ये कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। हर सेव Loggi की कैश की गई कीमतों को भी साफ़ करता है।

पेज के शीर्ष की चेतावनियाँ अधूरे सेटअप को दिखाती हैं: API क्रेडेंशियल नहीं हैं (केवल निश्चित कीमतें उपयोग होती हैं), API क्रेडेंशियल और निश्चित कीमतें दोनों नहीं हैं (कैरियर कभी नहीं दिखता), पिकअप पता नहीं है, BRL विनिमय दर नहीं है, या स्टोर की वज़न या आयाम इकाई ऐसी है जिसे मॉड्यूल नहीं पहचानता (तब इसे kg या cm माना जाता है; इकाइयाँ International > Localization में सेट करें)। यदि कोई मान अमान्य है, जैसे ऋणात्मक संख्या, तो पेज एक त्रुटि दिखाता है और कुछ भी सेव नहीं होता।

सामान्य

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

Method title: कार्ट और चेकआउट में ग्राहक को दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Loggi। अनिवार्य, अधिकतम 64 अक्षर।

Loggi API (लाइव कीमत) (केवल निश्चित कीमतें उपयोग करने के लिए क्रेडेंशियल खाली छोड़ें)

API e-mail: आपके Loggi खाते का ईमेल। API कुंजी इसी खाते की है। यह एक मान्य ईमेल पता होना चाहिए।

API key: आपकी Loggi API कुंजी। यह केवल Loggi को भेजी जाती है और कभी लॉग नहीं होती। सेव करने के बाद यह फ़ील्ड खाली रहता है और Saved — leave empty to keep it; clear the API e-mail to remove it. दिखाता है। नया मान केवल तभी दर्ज करें जब उसे बदलना हो। यदि आप API e-mail बदलते हैं, तो नए ईमेल की API कुंजी भी दर्ज करें, नहीं तो पेज एक त्रुटि दिखाएगा और कुछ भी सेव नहीं होगा। सेव की गई कुंजी हटाने के लिए API e-mail खाली करें और सेव करें।

Shop ID: Loggi डैशबोर्ड में आपके स्टोर का संख्यात्मक ID (pk)। केवल धनात्मक संख्या स्वीकार की जाती है। कोई दूसरा मान त्रुटि के साथ अस्वीकार होता है।

Staging: परीक्षण क्रेडेंशियल के साथ Loggi का स्टेजिंग वातावरण उपयोग करता है। स्टेजिंग और प्रोडक्शन के खाते और कुंजियाँ अलग होती हैं। डिफ़ॉल्ट: बंद।

Pickup address: वह पता जहाँ से Loggi पार्सल उठाता है, एक पंक्ति में: गली और मकान नंबर, मोहल्ला, शहर, राज्य और CEP, जैसे Rua Example, 123 - Bairro, São Paulo - SP, 01310-100। यदि आपके स्टोर का पता ब्राज़ील में है और उसमें पता और शहर भरा है, तो इसे खाली छोड़ें ताकि Shop Parameters > Contact > Stores का स्टोर पता उपयोग हो। पिकअप पते के बिना Loggi अनुमान नहीं लगा सकता और केवल निश्चित कीमतें उपयोग होती हैं।

BRL exchange rate: Loggi की कीमतें ब्राज़ीलियाई रियल में होती हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL है, तो यह फ़ील्ड ज़रूरी नहीं है और पेज यह बताता है। अन्यथा दर्ज करें कि 1 BRL आपके स्टोर की मुद्रा में कितना है, जैसे 0.16। इसके बिना लाइव कीमतें उपयोग नहीं होतीं। केवल धनात्मक संख्या स्वीकार होती है। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार हैं।

निश्चित कीमतें (आपके स्टोर की डिफ़ॉल्ट मुद्रा में, कर को छोड़कर)

निश्चित कीमतें तब उपयोग होती हैं जब Loggi API कॉन्फ़िगर न हो, गंतव्य ब्राज़ील के बाहर हो या पूरा CEP न हो, और जब भी Loggi कोई कीमत न लौटाए (API उपलब्ध न हो, कुंजी अस्वीकार हो, पता कवरेज से बाहर हो)।

Price table: हर गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर और हटाने के लिए ट्रैश आइकन पर क्लिक करें। जिन देशों की अपनी पंक्ति नहीं है, उन सबके लिए * All other countries चुनें। हर पंक्ति में एक Base price और वज़न कॉलम हैं: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg और XL >5 kg। खाली (या 0) वज़न कॉलम बेस कीमत उपयोग करता है। बेस कीमत 0 का अर्थ है मुफ़्त शिपिंग। "9.99" और "9,99" दोनों स्वीकार हैं। खाली पंक्तियाँ और उसी देश की दूसरी पंक्ति सेव करते समय हटा दी जाती हैं।

Price for countries not in the table: तब उपयोग होता है जब Loggi की लाइव कीमत न हो और तालिका में गंतव्य देश की पंक्ति (और * पंक्ति) न हो। उस स्थिति में कैरियर छिपाने के लिए इसे खाली छोड़ें।

Fixed price applies: निश्चित कीमतें कैसे गिनी जाती हैं। Loggi की लाइव कीमत पूरे कार्ट को कवर करती है और उसे कभी गुणा नहीं किया जाता।

शर्तें

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

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

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

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

Tax: कैरियर का टैक्स नियम, या No tax। यदि आपकी कीमतों और Loggi की कीमत में पहले से कर शामिल है, तो No tax चुनें।

वज़न सीमाओं और वज़न कॉलमों के लिए, बिना वज़न वाला उत्पाद 0 kg माना जाता है।

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

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

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

उन्नत

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

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

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

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

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

पूरे 8 अंकों के CEP वाले ब्राज़ील के पते के लिए, मॉड्यूल Loggi पैकेज बनाता है: हर आइटम को इस तरह घुमाया जाता है कि उसकी सबसे छोटी भुजा ऊँचाई बने, और आइटम एक ही पैकेज में तब तक रखे जाते हैं जब तक वह 55 × 55 × 55 cm और 20 kg के भीतर रहता है। बिना वज़न या आयाम वाले उत्पाद हर भुजा पर 1 cm माने जाते हैं, और हर पैकेज का वज़न कम से कम 100 g माना जाता है। Loggi एक अनुमान में 2 पैकेज स्वीकार करता है, इसलिए बड़े कार्ट कई अनुरोधों में भेजे जाते हैं और कुल योग जोड़े जाते हैं। मॉड्यूल Loggi को आपका Shop ID, पिकअप पता, डिलीवरी पता और पैकेज भेजता है, और Loggi के कुल योग को BRL से आपके स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है। फिर कीमत ग्राहक के कार्ट की मुद्रा में दिखाई जाती है।

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

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

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

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

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

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

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

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

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

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

केवल निश्चित कीमतें दिखती हैं: मॉड्यूल पेज पर Log फ़ील्ड देखें। त्रुटियाँ हमेशा लॉग होती हैं। हर चरण देखने के लिए Debug log चालू करें और चेकआउट रीलोड करें। आम कारण: API ईमेल, कुंजी या Shop ID गायब, पिकअप पता नहीं, BRL से अलग स्टोर मुद्रा के लिए BRL exchange rate नहीं, अभी पूरा 8 अंकों का CEP नहीं, उत्पाद 55 cm से बड़ा या 20 kg से भारी है, या पता Loggi कवरेज से बाहर है।

लॉग में HTTP 401 या 403: Loggi ने API ईमेल या कुंजी अस्वीकार की। उन्हें Loggi के साथ जाँचें और सुनिश्चित करें कि Staging क्रेडेंशियल से मेल खाता है: स्टेजिंग और प्रोडक्शन की कुंजियाँ अलग हैं।

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

कीमतें सटीक नहीं हैं: अपने उत्पादों का वज़न और आयाम भरें। इनके बिना उत्पाद हर भुजा पर 1 cm और हर पैकेज कम से कम 100 g माने जाते हैं।

Per item Loggi की कीमत को गुणा नहीं करता: यह जानबूझकर है। Loggi की लाइव कीमत पूरे कार्ट को कवर करती है। Per item केवल निश्चित कीमतों पर लागू होता है।

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

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

अनइंस्टॉल

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

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