VibeFox Sameday Easybox for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

PHP: 8.0 या उसके बाद।

Sameday API उपयोगकर्ता नाम और पासवर्ड: API एक्सेस रोमानिया, हंगरी या बुल्गारिया में Sameday बिज़नेस अकाउंट का हिस्सा है। अपने Sameday अकाउंट मैनेजर या Sameday इंटीग्रेशन टीम से पूछें। क्रेडेंशियल अक्सर eAWB पोर्टल (eawb.sameday.ro, .hu या .bg) वाले ही होते हैं। डेमो API के लिए Sameday अलग टेस्ट क्रेडेंशियल देता है। API उपयोगकर्ता नाम और पासवर्ड के बिना विधि नहीं दिखाई जाती, क्योंकि ग्राहक लॉकर नहीं चुन पाएगा।

देश और काउंटी: आपके Sameday अकाउंट का देश System > Localisation > Countries में सक्षम होना चाहिए। Sameday अनुमान के लिए डिलीवरी पते की काउंटी (Region / State फ़ील्ड) चाहिए। OpenCart में रोमानिया और बुल्गारिया की काउंटी हैं, लेकिन OpenCart 3 में हंगरी की कोई नहीं (OpenCart 4.1 में हैं)। एक्सटेंशन इन्हें आपके लिए जोड़ सकता है (नीचे easybox लॉकर देखें)। इनके बिना कीमतें आपकी तालिका या बैकअप लागत से आती हैं।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर खोलें (अनज़िप करें)। उसमें README.txt, OpenCart 3 का पैकेज vfd_sameday_easybox-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_sameday_easybox.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_sameday_easybox-oc3-(version).ocmod.zip चुनें। एक्सटेंशन कोई OCMOD संशोधन नहीं जोड़ता, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ, एक्सटेंशन प्रकार Shipping चुनें, VibeFox Sameday Easybox ढूँढें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।

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

5. अपना Sameday API username और API password दर्ज करें, Sameday country चुनें, Enable/Disable चालू करें और Save पर क्लिक करें। पेज पर "Connected to Sameday ... easybox lockers" दिखना चाहिए। Pickup point और Easybox service आपके अकाउंट से भर जाते हैं।

6. अपनी कीमतें सेट करें: यदि आपकी स्टोर मुद्रा Sameday मुद्रा से अलग है तो Exchange rate of the estimate, और Country prices की एक पंक्ति (जैसे * Default) या एक Fallback cost।

7. यदि पेज बताता है कि OpenCart में आपके Sameday देश के लिए काउंटी नहीं हैं, तो easybox lockers सेक्शन में Add counties पर क्लिक करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_sameday_easybox.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Sameday Easybox ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 4 से 7 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल cron URL अलग है (देखें easybox लॉकर)।

इंस्टॉल के बाद Enable/Disable चालू करके सहेजने तक विधि बंद रहती है। यदि आप अनइंस्टॉल के बाद एक्सटेंशन फिर से इंस्टॉल करते हैं, तो रखी गई सेटिंग्स फिर से उपयोग होती हैं, पर विधि बंद स्थिति से शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सहेजता है। इस एक्सटेंशन के लिए संशोधन अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सहेज सकते हैं।

सेटिंग्स के ऊपर पेज कनेक्शन स्थिति दिखाता है: Sameday होस्ट, easybox लॉकर की संख्या और सूची कब अपडेट हुई, या यह कि Sameday ने उपयोगकर्ता नाम या पासवर्ड अस्वीकार किया। यह कॉन्फ़िगरेशन समस्याएँ भी सूचीबद्ध करता है, उदाहरण के लिए क्रेडेंशियल न होना, कीमत न होना, अनुमान के लिए विनिमय दर न होना, काउंटी न होना, किलोग्राम वज़न वर्ग न होना, या Sameday देश से बाहर के चुने हुए देश।

कुछ त्रुटियाँ सहेजना रोक देती हैं, और तब कुछ भी सहेजा नहीं जाता: Enter a valid name (1-64 characters, without < > ; = # { })., Sort order must be a whole number., एक अमान्य टैक्स क्लास या जियो ज़ोन। अन्य समस्याएँ केवल एक मान को प्रभावित करती हैं: सभी कीमतें और सीमाएँ दशमलव विभाजक के रूप में अल्पविराम या बिंदु स्वीकार करती हैं (4,99 या 4.99), और अमान्य या ऋणात्मक संख्या सहेजी नहीं जाती। एक चेतावनी फ़ील्ड का नाम बताती है, और पिछला मान बना रहता है।

सामान्य

Enable/Disable: चेकआउट पर विधि दिखाता या छिपाता है। यह Extensions > Extensions > Shipping में एक्सटेंशन की स्थिति है। डिफ़ॉल्ट: बंद।

Name: ग्राहक को दिखाई देने वाली शिपिंग विधि का नाम। डिफ़ॉल्ट: Sameday easybox। अधिकतम 64 वर्ण।

Tax class: --- None --- (डिफ़ॉल्ट) का अर्थ है कि कीमत अंतिम है। किसी टैक्स क्लास के साथ, OpenCart उस क्लास का टैक्स कीमत में जोड़ता है।

Sort order: चेकआउट पर शिपिंग विधियों के बीच इस विधि की स्थिति। एक पूर्ण संख्या।

Sameday अकाउंट (API)

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

API username: आपका Sameday API उपयोगकर्ता नाम।

API password: आपका Sameday API पासवर्ड। यह फिर कभी नहीं दिखाया जाता: सहेजा गया रखने के लिए फ़ील्ड खाली छोड़ें। उपयोगकर्ता नाम खाली करने पर पासवर्ड भी हट जाता है। यदि Sameday इसे अस्वीकार करता है, तो 10 मिनट तक दोबारा कोशिश नहीं होती।

Sameday country: आपके Sameday अकाउंट का देश: Romania (api.sameday.ro) (डिफ़ॉल्ट), Hungary (api.sameday.hu) या Bulgaria (api.sameday.bg)। उसके लॉकर पेश किए जाते हैं, और विधि केवल इसी गंतव्य देश के लिए दिखाई जाती है।

Test mode: डेमो क्रेडेंशियल के साथ Sameday डेमो API (sameday-api.demo.zitec.com) का उपयोग करता है।

कीमतें (सेक्शन शीर्षक आपकी स्टोर की डिफ़ॉल्ट मुद्रा दिखाता है)

उपयोग का क्रम यह है: Sameday अनुमान (जब Pickup point और Easybox service सेट हों), फिर देश अनुसार कीमत तालिका, और अंत में बैकअप लागत। तालिका की कीमतें स्टोर की डिफ़ॉल्ट मुद्रा में दर्ज की जाती हैं। किसी अन्य मुद्रा में भुगतान करने वाले ग्राहकों को परिवर्तित कीमत दिखती है।

Pickup point: आपका Sameday पिकअप पॉइंट, जहाँ Sameday पार्सल इकट्ठा करता है। सफल लॉगिन के बाद यह आपके अकाउंट के पिकअप पॉइंट की सूची होती है, और डिफ़ॉल्ट अपने-आप चुना जाता है। उससे पहले यह ID के लिए एक फ़ील्ड है। Sameday अनुमान के लिए आवश्यक। केवल कीमत तालिका उपयोग करने के लिए - not set (price table only) - चुनें।

Easybox service: easybox डिलीवरी के लिए Sameday सेवा, आमतौर पर "Locker NextDay" (कोड LN), जो अपने-आप चुनी जाती है। Sameday अनुमान के लिए आवश्यक।

Exchange rate of the estimate: Sameday अनुमान अपने देश की मुद्रा में देता है: RON, HUF या BGN (यूरो में बेचने वाले बुल्गेरियाई स्टोर्स के लिए EUR)। यदि आपका स्टोर किसी अन्य मुद्रा में बेचता है, तो Sameday मुद्रा की 1 इकाई का आपकी स्टोर मुद्रा में मान दर्ज करें, उदाहरण के लिए 0.20। दर 0 से अधिक होनी चाहिए। इसके बिना अनुमान का उपयोग नहीं होता और कीमत तालिका लागू होती है। Lev और euro निश्चित दर पर अपने-आप परिवर्तित होते हैं।

Table price: Per order कीमत एक बार लेता है। Per item (price x quantity) इसे आइटमों की संख्या से गुणा करता है। यह तालिका कीमत और बैकअप लागत पर लागू होता है। Sameday अनुमान हमेशा पूरे पार्सल के लिए होता है।

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

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

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

उपलब्धता

Minimum weight (kg): कार्ट इससे कम वज़न का हो तो विधि छिपाएँ। वज़न उत्पादों के वज़न वर्ग से परिवर्तित होता है। खाली या 0 का अर्थ है कोई सीमा नहीं।

Maximum weight (kg): इससे भारी पार्सलों को easybox डिलीवरी नहीं दी जाती। डिफ़ॉल्ट: 30। अपने Sameday अनुबंध की सीमा और easybox बॉक्स आकार जाँचें। खाली या 0 का अर्थ है कोई सीमा नहीं। अधिकतम वज़न से बड़ा न्यूनतम वज़न सहेजा नहीं जाता: एक चेतावनी यह बताती है, और पिछले मान बने रहते हैं।

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

Geo zone: विधि केवल इस जियो ज़ोन के पतों के लिए पेश करें। All Zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones चालू होने पर इसकी जाँच नहीं होती।

Ignore shipping zones: चालू होने पर जियो ज़ोन की जाँच नहीं होती, और विधि नीचे चुने गए देशों के लिए पेश होती है (सूची खाली हो तो Sameday देश)। बंद होने पर केवल ऊपर का जियो ज़ोन लागू होता है।

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

easybox लॉकर

Locker list: दिखाता है कि कितने शहरों में कितने easybox लॉकर लोड हैं और कब। Refresh the locker list now उसे फिर से लोड करता है। सूची सेटिंग्स सहेजने पर ताज़ा होती है, और एक दिन पुरानी होने पर चेकआउट अनुरोध के बाद (अधिकतम एक घंटे में एक बार)। निश्चित रोज़ाना ताज़ा करने के लिए, यहाँ दिखाए गए URL को अपने सर्वर के cron जॉब से रोज़ एक बार कॉल करें। OpenCart 3 पर यह ऐसा दिखता है: https://your-store/index.php?route=extension/shipping/vfd_sameday_easybox/cron&token=(token), OpenCart 4 पर ऐसा: https://your-store/index.php?route=extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox.cron&token=(token)। URL को ठीक वैसे ही कॉपी करें जैसे सेटिंग्स उसे दिखाती हैं। URL में एक गुप्त टोकन होता है। सही टोकन के बिना यह एक त्रुटि लौटाता है और Sameday से संपर्क नहीं करता। विधि बंद होने पर भी यह कुछ नहीं करता।

Counties: दिखाता है कि OpenCart में आपके Sameday देश के लिए कितनी काउंटी हैं। यदि कोई नहीं है, तो Add counties पर क्लिक करें। एक्सटेंशन उस देश की काउंटी System > Localisation > Zones में जोड़ता है, और पते के फ़ॉर्म का Region / State फ़ील्ड उन्हें सूचीबद्ध करता है। जो काउंटी पहले से हैं, वे दोबारा नहीं जोड़ी जातीं। OpenCart 4.1 में तीनों देशों की काउंटी पहले से हैं, इसलिए वहाँ बटन की ज़रूरत नहीं है।

उन्नत

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

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

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

आयात / निर्यात

Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। API पासवर्ड निर्यात नहीं होता।

Import: पहले निर्यात किया गया JSON चिपकाएँ और Import पर क्लिक करें। मान उसी जाँच से गुज़रते हैं जो फ़ॉर्म से होती है। सहेजा गया पासवर्ड बना रहता है।

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से Sameday easybox की कीमत माँगता है। एक्सटेंशन जियो ज़ोन (या Ignore shipping zones के देश), आपके Sameday अकाउंट का डिलीवरी देश, API क्रेडेंशियल और उपयोग योग्य लॉकर सूची, कार्ट वज़न और न्यूनतम कार्ट उप-योग की जाँच करता है। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है। उप-योग कूपन छूट के बाद, कर के बिना, इन उत्पादों की कीमत है। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को विधि बिना लागत के दिखती है।

अन्यथा, ग्राहक शहर और काउंटी दर्ज करने के बाद एक्सटेंशन Sameday से अनुमान माँगता है। यह आपका पिकअप पॉइंट और सेवा, पार्सल का वज़न, और ग्राहक का सड़क का पता, शहर, काउंटी और पिन कोड भेजता है। नाम, ईमेल या फ़ोन नंबर नहीं भेजे जाते। बुखारेस्ट को आधिकारिक Sameday प्लगइन की तरह "Sector 1" के रूप में भेजा जाता है। अनुमान आपकी स्टोर मुद्रा में परिवर्तित होता है। यदि अनुमान नहीं है (सेट नहीं, अभी शहर या काउंटी नहीं, त्रुटि, विनिमय दर नहीं), तो कीमत देश तालिका से, फिर बैकअप लागत से आती है। कीमत न होने पर विधि छिपा दी जाती है। कीमत ग्राहक की मुद्रा में चुने गए Tax class के टैक्स के साथ दिखती है।

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

यह एक्सटेंशन AWB (शिपमेंट) नहीं बनाता, लेबल प्रिंट नहीं करता, पार्सल ट्रैक नहीं करता या कैश ऑन डिलीवरी नहीं संभालता। इसमें घर तक कूरियर डिलीवरी या Sameday मैप विजेट नहीं है। ऑर्डर पर दिखाए गए लॉकर ID के साथ Sameday eAWB पोर्टल या अपने सामान्य टूल में AWB बनाएँ।

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Sameday easybox चुनता है। कीमतें OpenCart 3 जैसी ही हैं।

पिकअप पॉइंट

जब ग्राहक विधि चुनता है, तो उसके नीचे दो सूचियों वाला एक easybox locker ब्लॉक दिखता है: - Select city - और - Select easybox locker -। डिलीवरी पते का शहर यदि वहाँ लॉकर हैं तो पहले से चुना होता है। हर लॉकर अपना नाम और पता दिखाता है। चयन तुरंत चेकआउट के लिए सहेजा जाता है, इसलिए डिलीवरी चरण दोबारा खोलने पर भी यह बना रहता है।

लॉकर अनिवार्य है। उसके बिना ग्राहक आगे नहीं बढ़ सकता और उसे "Please choose a Sameday easybox locker." दिखता है। जब ग्राहक Continue पर क्लिक करता है, तो सर्वर जाँचता है कि चुना गया लॉकर सूची में है। जाली या हटाया गया लॉकर ID "The selected easybox locker is not available any more. Please choose another easybox locker." के साथ अस्वीकार होता है। यदि सूची लोड नहीं हो सकती, तो ग्राहक को "The easybox lockers could not be loaded. Please try again in a moment or choose another shipping method." दिखता है। ऑर्डर के साथ सहेजे गए नाम और पते सूची से आते हैं, ब्राउज़र से नहीं।

ऑर्डर पेज, ईमेल और इनवॉइस: लॉकर ऑर्डर की शिपिंग विधि में जोड़ा जाता है, उदाहरण के लिए "Sameday easybox: नाम - पता" (पहले विधि का नाम, फिर लॉकर)। ग्राहक इसे ऑर्डर पुष्टि, ऑर्डर इतिहास और ऑर्डर ईमेल में देखता है, और आप इसे इनवॉइस पर देखते हैं।

एडमिन ऑर्डर पेज: Sales > Orders में, ऑर्डर पेज पर नाम और पते के साथ एक Sameday easybox locker पैनल होता है, और Sameday AWB के लिए Locker ID। यदि किसी easybox ऑर्डर में लॉकर नहीं है, तो पैनल "No easybox locker was selected for this order." कहता है। यह पैनल विधि बंद होने पर भी दिखता है।

OpenCart 4 पर easybox locker ब्लॉक Shipping method options विंडो में, Sameday easybox विकल्प के नीचे दिखता है, और शहर की सूची हर बार विंडो खुलने पर फिर से लोड होती है, क्योंकि वन-पेज चेकआउट पर पता बदल सकता है। विंडो का Continue बटन वैध लॉकर के बिना आगे नहीं बढ़ता, उन्हीं संदेशों के साथ। OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और ग्राहक जब भी फिर से पुष्टि करता है तो उसे अपडेट करता है, और ऑर्डर का लॉकर उसके साथ अपडेट होता है। ऑर्डर पेज का पैनल History सेक्शन के ऊपर दिखता है।

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

यह एक्सटेंशन vibefox.net से VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Sameday Easybox लाइसेंस ब्लॉक Extensions > Extensions > Shipping > VibeFox Sameday Easybox > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और बटन Check now (स्थिति दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-shipping-sameday-easybox की पंक्ति और लिंक Manage licenses and domains in your account है, जो आपका vibefox.net अकाउंट खोलता है। कुंजी केवल वे एडमिन उपयोगकर्ता बदल सकते हैं जिनके पास इस एक्सटेंशन के लिए Modify अनुमति है। ब्लॉक के पाठ एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने अकाउंट में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँचा नहीं जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। स्लॉट अपने vibefox.net अकाउंट में मुक्त करें।

सक्रिय कुंजी के बिना, Sameday easybox ग्राहकों को चेकआउट पर नहीं दिखाया जाता और कोई कीमत न माँगी जाती है न गिनी जाती है। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन में लॉग इन है, उसे स्टोर में यह विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और परीक्षण कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन को नहीं देखता, इसलिए सक्रिय कुंजी के बिना विधि सभी के लिए छिपी रहती है। एडमिन Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

चेकआउट पर Sameday easybox दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API उपयोगकर्ता नाम और पासवर्ड दर्ज हैं और सेटिंग्स पेज "Connected to Sameday" दिखाता है, और गंतव्य देश आपके Sameday अकाउंट का देश है। जाँचें कि कोई कीमत उपलब्ध है (Sameday अनुमान, देश पंक्ति, * Default पंक्ति या Fallback cost), वज़न और उप-योग सीमाएँ, Geo zone और Ignore shipping zones के देश। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है। Log फ़ील्ड में कारण देखने के लिए Debug log चालू करें।

Sameday ने API उपयोगकर्ता नाम या पासवर्ड अस्वीकार किया: उन्हें जाँचें और फिर सहेजें। डेमो क्रेडेंशियल केवल Test mode चालू होने पर काम करते हैं, प्रोडक्शन क्रेडेंशियल केवल बंद होने पर। तब तक, यदि सहेजी गई लॉकर सूची है तो वह पेश होती है, और Sameday अनुमान का उपयोग नहीं होता।

कीमत Sameday से नहीं, मेरी तालिका से आ रही है: अनुमान के लिए Pickup point, Easybox service, आपके Sameday देश की काउंटी, और यदि स्टोर मुद्रा Sameday मुद्रा से अलग है तो Exchange rate of the estimate चाहिए। यह केवल तब माँगा जाता है जब ग्राहक शहर और काउंटी दर्ज कर चुका हो। जब Sameday पहुँच में नहीं होता या त्रुटि लौटाता है, तो तालिका या बैकअप लागत उपयोग होती है; कारण लॉग में है।

लॉकर सूची पुरानी है या गायब है: Refresh the locker list now पर क्लिक करें या सेटिंग्स सहेजें। यदि ताज़ा करना विफल होता है, तो पिछली सूची उपयोग होती है और स्थिति यह बताती है।

गलती से शिपिंग मुफ़्त है: Free shipping from और Price 0 वाली Country prices पंक्तियाँ जाँचें, खासकर वह * Default पंक्ति जो Add country से जोड़ी गई और खाली छोड़ी गई।

वज़न सीमाएँ या वज़न कॉलम मेल नहीं खाते: यदि पेज बताता है कि इकाई "kg" वाला कोई वज़न वर्ग नहीं है, तो System > Localisation > Weight Classes में एक किलोग्राम वज़न वर्ग जोड़ें।

पेज पर लिखा है "Warning: You do not have permission to modify VibeFox Sameday Easybox!": आपके एडमिन उपयोगकर्ता समूह केवल सेटिंग्स देख सकते हैं। System > Users > User Groups में समूह को extension/shipping/vfd_sameday_easybox (OpenCart 3) या extension/vfd_sameday_easybox/shipping/vfd_sameday_easybox (OpenCart 4) के लिए संशोधन अनुमति दें।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, Shipping प्रकार चुनें और VibeFox Sameday Easybox के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। OpenCart हमेशा Enable/Disable, Sort order, Tax class और Geo zone को रीसेट करता है। सहेजी गई लॉकर सूची, खाता जाँच परिणाम और सभी कैश हमेशा हटाए जाते हैं। यदि Remove data on uninstall चालू है, तो बाकी सेटिंग्स, cron टोकन और लॉग भी हट जाते हैं। यदि बंद है, तो वे रहते हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर उपयोग होते हैं। मौजूदा ऑर्डर सहेजा गया लॉकर बनाए रखते हैं।

OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल की गई एक्सटेंशन सूची में VibeFox Sameday Easybox के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Sameday और easybox उनके संबंधित स्वामियों के ट्रेडमार्क हैं। यह एक्सटेंशन Sameday से संबद्ध नहीं है और Sameday द्वारा समर्थित नहीं है।