VibeFox EasyPost for OpenCart — सहायता

आवश्यकताएँ

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

PHP: cURL के साथ 8.0 या उसके बाद का संस्करण।

EasyPost खाता (केवल लाइव दरों के लिए): EasyPost की वेबसाइट पर एक खाता बनाएँ, EasyPost डैशबोर्ड में अपने कैरियर खाते (USPS, UPS, FedEx और अन्य) जोड़ें, और EasyPost Dashboard > Account Settings > API Keys से API कुंजी कॉपी करें। EasyPost खरीदे गए लेबल के लिए शुल्क लेता है, दर अनुरोधों के लिए नहीं। यदि आप केवल फ़ॉलबैक दाम इस्तेमाल करते हैं, तो आपको EasyPost खाते की ज़रूरत नहीं है।

उत्पाद: उत्पादों का वज़न होना चाहिए, और बेहतर होगा कि आयाम भी हों।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. अपनी EasyPost API कुंजी पेस्ट करें और Ship from पता भरें। लाइव दरों के लिए ZIP कोड ज़रूरी है।

6. यदि आपकी डिफ़ॉल्ट मुद्रा USD नहीं है, तो USD exchange rate दर्ज करें। वैकल्पिक रूप से फ़ॉलबैक दाम दर्ज करें (कॉन्फ़िगरेशन देखें)। Enable EasyPost shipping चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और सेटिंग्स OpenCart 3 के चरण 4 से 6 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

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

पेज के सबसे ऊपर एक्सटेंशन चेतावनियाँ दिखाता है, जब लाइव दरें इस्तेमाल नहीं हो सकतीं: API कुंजी नहीं है (फ़ॉलबैक दाम हों या न हों), शिपिंग का ZIP कोड या देश नहीं है, या डिफ़ॉल्ट मुद्रा USD नहीं है और कोई विनिमय दर नहीं है। जब टेस्ट API कुंजी सेट होती है तो एक नोट दिखता है, और जब आपके स्टोर की वज़न या लंबाई की इकाई (System > Settings > Option) एक्सटेंशन की जानी-पहचानी इकाइयों (kg, g, lb, oz; cm, mm, m, in) में नहीं है, तो एक चेतावनी दिखती है।

सेव करते समय, 64 अक्षरों से लंबा नाम, ऐसा Sort order जो पूर्ण संख्या नहीं है, या कोई अज्ञात टैक्स क्लास या जियो ज़ोन सेव होने से रोक देता है, और तब कुछ भी सेव नहीं होता। ऐसा मान जो संख्या नहीं है (या ऋणात्मक है), सेव नहीं होता: एक चेतावनी फ़ील्ड का नाम बताती है और पिछला मान रहता है, जबकि बाकी सेटिंग्स सेव हो जाती हैं। USD exchange rate 0 होने पर, या Minimum weight के Maximum weight से बड़ा होने पर भी यही होता है।

सामान्य

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

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम, अधिकतम 64 अक्षर। डिफ़ॉल्ट: EasyPost Shipping। यदि नाम खाली है, तो डिफ़ॉल्ट नाम इस्तेमाल होता है। जिस नाम में वर्ण < > ; = # { } हों, उसे चेतावनी के साथ डिफ़ॉल्ट नाम से बदल दिया जाता है।

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

EasyPost खाता

API key: EasyPost Dashboard > Account Settings > API Keys से आपकी EasyPost API कुंजी। प्रोडक्शन कुंजी (EZAK से शुरू) असली दरें लौटाती है। टेस्ट कुंजी (EZTK से शुरू) EasyPost की टेस्ट दरें लौटाती है; इसे केवल परीक्षण के लिए इस्तेमाल करें। सेव करने के बाद यह फ़ील्ड खाली रहता है और सहेजी गई कुंजी को छिपाकर दिखाता है, उदाहरण के लिए Saved key: EZAK******abcd. Leave the field empty to keep it. केवल बदलने के लिए नया मान दर्ज करें। कुंजी के बिना केवल फ़ॉलबैक दाम इस्तेमाल होते हैं।

Remove the saved API key: इसे चालू करें और सहेजी गई कुंजी मिटाने के लिए Save पर क्लिक करें।

Allowed carriers / services: वैकल्पिक, कॉमा से अलग। EasyPost के नामों के अनुसार कैरियर (USPS) या कैरियर और सेवा (USPS:Priority, UPS:Ground) दर्ज करें। अनुमत दरों में से सबसे सस्ती दर दिखाई जाती है। किसी भी कैरियर की सबसे सस्ती दर दिखाने के लिए खाली छोड़ें।

शिप फ़्रॉम

वह पता जहाँ से आपके पार्सल भेजे जाते हैं। यदि Country आपके स्टोर का देश है, तो खाली Sender name / company स्टोर के नाम से और खाली State आपके स्टोर के क्षेत्र (System > Settings) से लिया जाता है। OpenCart में स्टोर का कोई पोस्टल कोड नहीं होता, इसलिए ZIP कोड यहाँ दर्ज करना होगा।

Sender name / company: भेजने वाले का नाम या कंपनी। खाली का अर्थ है स्टोर का नाम (केवल उसी देश के लिए)।

Street address: शिप फ़्रॉम पते की सड़क।

City: शिप फ़्रॉम पते का शहर।

State: दो अक्षरों का राज्य कोड, उदाहरण के लिए CA या NY।

ZIP code: शिप फ़्रॉम का ZIP या पोस्टल कोड, उदाहरण के लिए 94105। लाइव दरों के लिए ज़रूरी।

Country: वह देश जहाँ से आप शिप करते हैं। डिफ़ॉल्ट: United States।

दरें

Parcels: कार्ट EasyPost को किस तरह भेजा जाता है।

वज़न स्टोर की वज़न इकाई से औंस (न्यूनतम 1 oz) में, और आयाम स्टोर की लंबाई इकाई से इंच में बदले जाते हैं। यदि किसी उत्पाद के आयाम नहीं हैं, तो पार्सल की दर केवल वज़न से तय होती है।

USD exchange rate: EasyPost की दरें USD में होती हैं। अपनी डिफ़ॉल्ट मुद्रा में 1 USD का दाम दर्ज करें, उदाहरण के लिए 0.92। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं, केवल फ़ॉलबैक दाम इस्तेमाल होते हैं। यदि डिफ़ॉल्ट मुद्रा USD है, तो इसकी ज़रूरत नहीं है। USD और CAD स्टोर EasyPost से अपनी मुद्रा में कोटेशन माँगते हैं। दशमलव विभाजक के रूप में बिंदु और कॉमा दोनों स्वीकार हैं।

Tax class: शिपिंग पर लागू टैक्स क्लास, या No tax। EasyPost की दरों में बिक्री कर शामिल नहीं होता।

फ़ॉलबैक दाम

इनका उपयोग तब होता है जब कोई लाइव दर न हो: API कुंजी न हो, EasyPost तक पहुँच न हो, कुंजी अस्वीकृत हो, या कोई कैरियर उस पते के लिए दर न दे। दाम स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स को छोड़कर होते हैं। ऐसे में विधि छिपाने के लिए दोनों फ़ील्ड खाली छोड़ें।

Country prices: हर देश के लिए एक पंक्ति: दो अक्षरों का देश कोड, कोलन और दाम, उदाहरण के लिए US:9.99। किसी और प्रारूप की पंक्तियाँ अनदेखी की जाती हैं और सेव करते समय चेतावनी में सूचीबद्ध होती हैं।

Other countries: ऊपर की सूची में न होने वाले देशों का दाम। उनके लिए विधि छिपाने के लिए खाली छोड़ें।

शर्तें

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

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

Minimum weight: जब कार्ट इससे हल्का हो, तो विधि छिपा दें; वज़न आपके स्टोर की वज़न इकाई में है (फ़ील्ड के लेबल में दिखाई गई)। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।

Maximum weight: जब कार्ट इससे भारी हो, तो विधि छिपा दें; वज़न आपके स्टोर की वज़न इकाई में है। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।

उपलब्धता

आम तौर पर जियो ज़ोन तय करता है कि विधि कहाँ दी जाए। वैकल्पिक रूप से, इसे जियो ज़ोन से स्वतंत्र, देश के अनुसार दिया जा सकता है।

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

Ignore shipping zones: नीचे दिए गए देशों के लिए विधि दें, चाहे वे जियो ज़ोन में हों या नहीं।

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

उन्नत

Debug log: EasyPost अनुरोधों को storage/logs/vfd_ep.log.php (OpenCart 4 में system/storage/logs/vfd_ep.log.php) में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। जब यह 5 MB तक पहुँचती है, तो उसे vfd_ep.old.log.php में ले जाया जाता है और एक नया लॉग शुरू होता है। API त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं, भले ही यह विकल्प बंद हो। API कुंजी और ग्राहक के पते कभी दर्ज नहीं होते।

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

Remove data on uninstall: चालू होने पर, एक्सटेंशन को अनइंस्टॉल करने पर उसकी सेटिंग्स और लॉग मिट जाते हैं। दिए गए ऑर्डर का EasyPost डेटा सुरक्षित रहता है। विधि बंद करने से सेटिंग्स कभी नहीं मिटतीं।

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

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

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मानों की जाँच सामान्य सेव की तरह होती है। सहेजी गई API कुंजी नहीं बदलती।

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

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

अन्यथा एक्सटेंशन EasyPost को शिप-फ़्रॉम पता, डिलीवरी का पता और पार्सल भेजता है, और आपके सभी कैरियर खातों की दरें प्राप्त करता है। वह अनुमत सबसे सस्ती दर चुनता है, उसे स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है, और चुने गए Tax class के टैक्स के साथ ग्राहक की मुद्रा में दिखाता है। उन देशों के लिए जो System > Localisation > Countries में Postcode Required चिह्नित हैं, अनुरोध केवल तब किया जाता है जब डिलीवरी के पते में पोस्टल कोड हो। OpenCart के मानक डेटा में अमेरिका के लिए यह चिह्न बंद है, इसलिए बिना ZIP कोड वाला अमेरिकी पता भी भेजा जाता है; तब EasyPost त्रुटि लौटाता है और फ़ॉलबैक दाम इस्तेमाल होता है।

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

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

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

ऑर्डर

जब EasyPost विधि वाला ऑर्डर दिया जाता है, तो चेकआउट पर दिखाई गई दर ऑर्डर के साथ सहेजी जाती है। एडमिन ऑर्डर पेज (Sales > Orders) इतिहास के ऊपर EasyPost shipping पैनल दिखाता है:

Carrier / service: दर का EasyPost कैरियर और सेवा, उदाहरण के लिए USPS Priority। प्रति-आइटम-एक-पार्सल मोड में इस्तेमाल की गई सभी सेवाएँ सूचीबद्ध होती हैं।

Estimated delivery days: EasyPost द्वारा लौटाए गए डिलीवरी दिन (केवल प्रति-ऑर्डर-एक-पार्सल मोड में, जब EasyPost उन्हें लौटाता है)।

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

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

एक्सटेंशन बाद में बंद कर दिया जाए, तब भी यह पैनल दिखता है। एडमिन में बाद के ऑर्डर बदलावों से ये मान नहीं बदलते। इनका उपयोग अपने EasyPost खाते में लेबल खरीदने के लिए करें। जब भी चेकआउट पुष्टि के चरण पर पहुँचता है, OpenCart एक ऑर्डर रिकॉर्ड बनाता है; ऐसे अधूरे ऑर्डरों की सहेजी गई दरें 30 दिन बाद हटा दी जाती हैं।

OpenCart 4 में चेकआउट एक ही ऑर्डर रखता है और ग्राहक हर बार दोबारा पुष्टि करने पर उसे अपडेट करता है। सहेजी गई दर उसी के साथ अपडेट होती है: यह वही दर है जो ग्राहक ने चेकआउट पर देखी थी। यदि ग्राहक किसी दूसरी शिपिंग विधि पर जाता है, तो उस ऑर्डर के लिए पैनल नहीं दिखता।

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

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

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

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

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

चेकआउट पर EasyPost नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable EasyPost shipping चालू है। Geo zone (या Ignore shipping zones और Countries), वज़न सीमाएँ और Minimum subtotal जाँचें। लाइव दर के बिना विधि को देश के लिए या Other countries के लिए फ़ॉलबैक दाम चाहिए। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।

लाइव दरें नहीं दिखतीं: एक्सटेंशन पेज के ऊपर की चेतावनियाँ पढ़ें, फिर Debug log चालू करें, चेकआउट को रीलोड करें और Log फ़ील्ड देखें। आम कारण: API कुंजी या शिप-फ़्रॉम ZIP कोड नहीं है, USD न होने वाला स्टोर बिना USD exchange rate के है, डिलीवरी के पते में अभी ZIP कोड नहीं है, आपके EasyPost खाते का कोई कैरियर उस पते को सेवा नहीं देता, या Allowed carriers / services सभी दरों को छाँट देता है।

दरें टेस्ट दामों जैसी लगती हैं: एक टेस्ट कुंजी (EZTK...) सेट है। लाइव स्टोर पर प्रोडक्शन कुंजी (EZAK...) इस्तेमाल करें।

दरें कुछ मिनटों के लिए रुक गईं: टाइमआउट, अस्वीकृत कुंजी या EasyPost सर्वर त्रुटि के बाद एक्सटेंशन 5 मिनट के लिए अनुरोध रोकता है और फ़ॉलबैक दाम इस्तेमाल करता है। API कुंजी और लॉग जाँचें।

क्या टैक्स शामिल है? EasyPost की दरों में बिक्री कर शामिल नहीं होता। शिपिंग पर टैक्स जोड़ने के लिए Tax class में टैक्स क्लास चुनें।

बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश की गई EasyPost दरें साफ़ हो जाती हैं।

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

डेवलपर्स के लिए: अन्य एक्सटेंशन OpenCart इवेंट vfd_easypost/shipment_request, vfd_easypost/selected_rate और vfd_easypost/api_url से अनुरोध का मुख्य भाग, चुनी गई दर और API का बेस URL समायोजित कर सकते हैं।

अनइंस्टॉल

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

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

EasyPost अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन EasyPost से संबद्ध नहीं है और EasyPost द्वारा समर्थित नहीं है।