VibeFox Estafeta for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

DrEnvio खाता (केवल लाइव दरों के लिए): Estafeta की लाइव दरें DrEnvio से आती हैं, जो मेक्सिको में Estafeta का साझेदार है। drenvio.com पर खाता बनाएँ, Estafeta सक्रिय करें, वहाँ अपना पिकअप पता सेट करें और DrEnvio पैनल से API कुंजी कॉपी करें। यह वही कुंजी है जो आधिकारिक DrEnvio प्लगइन उपयोग करता है। यदि आप केवल अपनी कीमतें उपयोग करते हैं, तो DrEnvio खाते की आवश्यकता नहीं है।

उत्पाद: लाइव दरों के लिए उत्पादों का वज़न दर्ज होना चाहिए।

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

इंस्टॉलेशन

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

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

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

4. DrEnvio API key दर्ज करें और यदि चाहें तो Origin postcode भी। यदि आपकी डिफ़ॉल्ट मुद्रा MXN नहीं है, तो MXN exchange rate दर्ज करें। MX के लिए देश की कीमत सेट करें, या यदि DrEnvio के पास दर न होने पर भी कैरियर दिखाई देना चाहिए, तो Fallback cost सेट करें। Save पर क्लिक करें।

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

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

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

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

सामान्य

कैरियर के ज़ोन, ग्राहक समूह और आकार सीमाएँ Shipping > Carriers में सेट होती हैं। ये सेटिंग्स हर ज़ोन पर लागू होती हैं।

Enable/Disable: Estafeta शिपिंग चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

Name: चेकआउट पर ग्राहक को दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Estafeta। आवश्यक। अमान्य नाम की सूचना दी जाती है और पिछला नाम रखा जाता है।

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

लाइव दरें (DrEnvio API)

पते के लिए सबसे सस्ती Estafeta सेवा प्रस्तुत की जाती है। कुंजी के बिना अगले सेक्शन की कीमतें उपयोग होती हैं।

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

Remove the saved API key: केवल तब दिखता है जब कुंजी सहेजी गई हो। कुंजी हटाने के लिए इसे Yes पर सेट करें और सहेजें। फिर केवल Country prices और Fallback cost उपयोग होते हैं। ऊपर के फ़ील्ड में दर्ज कुंजी सहेजी गई कुंजी की जगह लेती है।

Origin country: पिकअप पते का दो-अक्षरों वाला देश कोड। डिफ़ॉल्ट: MX। इसे केवल Origin postcode के साथ भेजा जाता है।

Origin postcode: पिकअप पते का 5-अंकों वाला पिनकोड। अपने DrEnvio खाते में सहेजा गया मूल पता उपयोग करने के लिए इसे खाली छोड़ें। जो पिनकोड 5 अंकों का नहीं है, उसे सहेजते समय साफ़ कर दिया जाता है और सूचना दी जाती है।

MXN exchange rate: DrEnvio मेक्सिकन पेसो में कोटेशन देता है। यह केवल तब चाहिए जब आपकी डिफ़ॉल्ट मुद्रा MXN न हो: आपकी डिफ़ॉल्ट मुद्रा में 1 MXN का मूल्य, जैसे 0.05। इसके बिना लाइव दरें उपयोग नहीं होतीं।

लाइव दर के बिना कीमतें

जब API कुंजी न हो या DrEnvio Estafeta की दर न लौटाए, तब उपयोग होती हैं (API उपलब्ध न हो, पिनकोड अज्ञात हो, या पिनकोड अभी दर्ज न हुआ हो)। कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स के बिना, दी जाती हैं।

Country prices: हर पंक्ति में एक गंतव्य देश, CC:PRICE प्रारूप में, जैसे MX:150। दशमलव के लिए बिंदु या कॉमा उपयोग करें, हज़ार का विभाजक नहीं। दूसरे प्रारूप के हिस्से अनदेखे किए जाते हैं और सहेजते समय सूचित किए जाते हैं।

Fallback cost: वह कीमत जब न लाइव दर हो और न देश की कीमत। कैरियर छिपाने के लिए इसे खाली छोड़ें; 0 का अर्थ है मुफ़्त शिपिंग।

Calculation type: Per order कीमत एक बार लेता है। Per item (price x number of items) इसे कार्ट में आइटम की संख्या से गुणा करता है। यह Country prices और Fallback cost पर लागू होता है। DrEnvio की लाइव दर हमेशा पूरे पार्सल की कीमत होती है।

शर्तें

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

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

Min weight: कैरियर दिखने के लिए कार्ट का न्यूनतम वज़न, kg में। 0 का अर्थ है कोई सीमा नहीं।

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

यदि Min weight, Max weight से अधिक है, तो सहेजते समय त्रुटि दिखती है और दोनों वज़न नहीं बदलते। उत्पादों का वज़न स्टोर की वज़न इकाई से kg में बदला जाता है।

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

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

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

उन्नत

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

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

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

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

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

अन्यथा मॉड्यूल DrEnvio को गंतव्य देश और पिनकोड, कार्ट का वज़न, आइटम की संख्या और MXN में सबटोटल भेजता है, साथ ही यदि आपने कोई origin postcode सेट किया है तो वह भी। मेक्सिकन पिनकोड में 5 अंक होने चाहिए; जब तक ग्राहक ऐसा पिनकोड वाला डिलीवरी पता नहीं डालता, कोई अनुरोध नहीं किया जाता। DrEnvio आपके खाते के सभी कैरियर्स के कोटेशन लौटाता है। मॉड्यूल केवल Estafeta के कोटेशन उपयोग करता है, शून्य कीमतें छोड़ देता है, सबसे सस्ता चुनता है और उसे आपकी डिफ़ॉल्ट मुद्रा में बदलता है। फिर कीमत ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

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

मॉड्यूल केवल दरों की गणना करता है। वह शिपमेंट नहीं बनाता, लेबल (guías) प्रिंट नहीं करता या पार्सल ट्रैक नहीं करता; शिपमेंट अपने DrEnvio या Estafeta खाते में बनाएँ। ग्राहक कोई विशेष Estafeta सेवा या Estafeta कार्यालय नहीं चुन सकता, और विनिमय दरें स्वचालित रूप से अपडेट नहीं होतीं।

ऑर्डर

जब Estafeta कैरियर वाला ऑर्डर दिया जाता है, तो मॉड्यूल उसकी कार्ट के लिए गणना की गई दर रखता है। बाद में होने वाली पुनर्गणना, जैसे बैक ऑफिस के ऑर्डर पेज पर, उसे नहीं बदलती।

Orders > Orders में ऑर्डर पेज पर एक Estafeta ब्लॉक दिखता है:

Estafeta service: DrEnvio कोटेशन की Estafeta सेवा और उसका डिलीवरी समय। यह केवल लाइव दरों के लिए दिखता है।

Price source: Live DrEnvio rate, Country price (no live rate), Fallback cost (no live rate) या Free shipping threshold।

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

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

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

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

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

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

चेकआउट पर Estafeta नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है और देश की अनुमति है)। मॉड्यूल पेज के ऊपर की चेतावनियाँ, वज़न सीमाएँ और Minimum subtotal देखें। API कुंजी के बिना, या जब DrEnvio के पास Estafeta की दर न हो, तब कैरियर को गंतव्य के लिए देश की कीमत या फ़ॉलबैक लागत चाहिए। उत्पाद पेज पर उत्पादों को कुछ कैरियर्स तक सीमित भी किया जा सकता है।

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट को दोबारा लोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: API कुंजी नहीं है; ऐसे स्टोर के लिए विनिमय दर नहीं है जिसकी डिफ़ॉल्ट मुद्रा MXN नहीं है; पिनकोड गायब या अमान्य है; API कुंजी अस्वीकार हुई (DrEnvio HTTP 401 या 403, API कुंजी जाँचें); उस मार्ग के लिए Estafeta की दर नहीं है (लॉग में वे कैरियर्स सूचीबद्ध होते हैं जो DrEnvio ने लौटाए); या दर MXN के अलावा किसी मुद्रा में है।

क्या कीमत में IVA शामिल है? यह आपके DrEnvio खाते पर निर्भर है। यदि DrEnvio की कीमतों में पहले से IVA शामिल है, तो Tax को No tax पर सेट करें।

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

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

ऑर्डर पेज पर Estafeta ब्लॉक नहीं है: यह ब्लॉक केवल उन ऑर्डरों के लिए दिखता है जो मॉड्यूल इंस्टॉल रहने के दौरान Estafeta कैरियर से दिए गए थे। Remove data on uninstall चालू रखकर अनइंस्टॉल करने पर सहेजी गई सेवाएँ मिट जाती हैं।

अनइंस्टॉल

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

Estafeta और DrEnvio अपने-अपने स्वामियों के ट्रेडमार्क हैं। यह मॉड्यूल न तो Estafeta या DrEnvio से संबद्ध है और न ही उनसे अनुमोदित है।