वापस

VibeFox Shippo for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या बाद का संस्करण।

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

उत्पाद: उत्पादों का वज़न और आयाम होने चाहिए। बिना आयाम वाले उत्पाद डिफ़ॉल्ट बॉक्स आकार उपयोग करते हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. अपना Shippo API टोकन पेस्ट करें और Ship from पता भरें। लाइव दरों के लिए पोस्टल कोड आवश्यक है।

6. Shippo rate currency चुनें (यदि आप अमेरिका से शिप करते हैं तो USD) और यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा अलग है, तो Exchange rate डालें।

7. वैकल्पिक रूप से फ़ॉलबैक कीमतें डालें, Enable Shippo shipping चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

पेज के ऊपर की चेतावनियाँ आपको बताती हैं कि विधि कभी दिखाई नहीं जा सकती या लाइव दरें उपयोग नहीं हो सकतीं: API टोकन नहीं है, शिप-फ़्रॉम पोस्टल कोड या देश नहीं है, विनिमय दर नहीं है, या स्टोर की वज़न या लंबाई इकाई एक्सटेंशन को ज्ञात नहीं है (System > Settings के Local टैब में kg, g, lb या oz और cm, mm, m या in का उपयोग करें)। टेस्ट टोकन सेट होने पर एक सूचना याद दिलाती है। सेव करते समय अमान्य नाम, संख्या न होने वाला मान, ऋणात्मक संख्या या मूल्य सेल, Maximum weight (kg) से बड़ा Minimum weight (kg), या पूर्णांक न होने वाला sort order त्रुटि के रूप में दर्ज होते हैं, और जब तक आप उन्हें सुधारते नहीं, कुछ भी सेव नहीं होता।

सामान्य

Enable Shippo shipping: चेकआउट पर यह विधि प्रस्तुत करता है। यह Extensions > Extensions > Shipping में एक्सटेंशन की स्थिति है।

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

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

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

Shippo खाता

API token: आपका Shippo API टोकन। लाइव स्टोर पर असली दरों के लिए लाइव टोकन (shippo_live_...) या Shippo टेस्ट दरों के लिए टेस्ट टोकन (shippo_test_...) उपयोग करें। टोकन केवल Shippo को भेजा जाता है और कभी लॉग नहीं होता। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान डालें।

Remove the saved API token: सहेजा गया टोकन हटाने के लिए इसे चालू करके सेव करें।

Allowed carriers / services: वैकल्पिक, कॉमा से अलग किया हुआ। कैरियर को उसी नाम से लिखें जो Shippo उसे देता है (USPS, UPS, FedEx, DHL Express), या Shippo सर्विस लेवल टोकन (usps_priority, ups_ground)। अनुमत दरों में सबसे सस्ती दर दिखाई जाती है। किसी भी कैरियर की सबसे सस्ती दर दिखाने के लिए खाली छोड़ें।

Ship from (वह पता जहाँ से आपके पार्सल भेजे जाते हैं)

जब शिप-फ़्रॉम देश आपके स्टोर का देश हो, तो खाली भेजने वाले का नाम और राज्य System > Settings में स्टोर के नाम और क्षेत्र से लिए जाते हैं। OpenCart में स्टोर की संरचित सड़क, शहर या पोस्टल कोड नहीं होते, इसलिए इन्हें यहाँ डालें।

Sender name / company: भेजने वाले का नाम। कस्टम्स घोषणा पर हस्ताक्षर के लिए भी इसका उपयोग होता है। यदि खाली है, तो स्टोर का नाम उपयोग होता है।

Street address: भेजने वाले की सड़क।

City: भेजने वाले का शहर।

State / province: दो अक्षरों वाला राज्य कोड, उदाहरण के लिए CA या NY। कुछ कैरियरों को इसकी आवश्यकता होती है।

Postal / ZIP code: लाइव दरों के लिए आवश्यक, उदाहरण के लिए 94105।

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

दरें

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

One parcel per order (the cart is packed into one box): सभी आइटम एक बॉक्स में रखे जाते हैं और एक बार दर लगाई जाती है। यह डिफ़ॉल्ट है।
One parcel per item (every unit ships in its own box): हर उत्पाद को अपना अलग पार्सल मानकर दर लगाई जाती है, और दर हर इकाई के लिए ली जाती है। फ़ॉलबैक कीमतें भी प्रति इकाई ली जाती हैं।

Default box size: आपके स्टोर की लंबाई इकाई (फ़ील्ड के नाम में दिखाई गई) में लंबाई x चौड़ाई x ऊँचाई, उदाहरण के लिए 30 x 20 x 10। Shippo को बॉक्स आकार चाहिए। यह तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। 30 x 20 x 10 cm उपयोग करने के लिए खाली छोड़ें। जो मान पढ़ा न जा सके, उसे सेव के बाद सूचना के साथ अनदेखा किया जाता है, और बाकी सेटिंग्स सेव हो जाती हैं।

Shippo rate currency: वह मुद्रा जिसमें Shippo आपके कैरियरों का मूल्य बताता है, यानी शिप-फ़्रॉम देश की मुद्रा: USD (US), CAD (कनाडा), GBP (UK), EUR (यूरोज़ोन) या AUD (ऑस्ट्रेलिया)। डिफ़ॉल्ट: USD। Shippo जो दरें आपके स्टोर की डिफ़ॉल्ट मुद्रा में लौटाता है, उन्हें हमेशा जैसा है वैसा उपयोग किया जाता है।

Exchange rate: Shippo दर मुद्रा की 1 इकाई का, आपके स्टोर की डिफ़ॉल्ट मुद्रा में मूल्य, उदाहरण के लिए 0.92। यदि दोनों समान हैं तो इसकी ज़रूरत नहीं है। इसके बिना दूसरी मुद्रा की दरें उपयोग नहीं होतीं और फ़ॉलबैक कीमतें लागू होती हैं। एक्सटेंशन मुद्राएँ अपने-आप नहीं बदलता।

फ़ॉलबैक कीमतें (जब लाइव दर न हो तब उपयोग होती हैं: API टोकन नहीं है, Shippo तक पहुँच नहीं है, टोकन अस्वीकार हुआ, या पते के लिए कैरियर दरें नहीं हैं; कीमतें स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स छोड़कर; इस स्थिति में विधि छिपाने के लिए दोनों फ़ील्ड खाली छोड़ें)

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 पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। जिस पंक्ति की सभी सेल खाली सहेजी जाती हैं, वह 0 चार्ज करती है, इसलिए जो पंक्तियाँ आप नहीं भरेंगे उन्हें हटा दें।

Other countries: ऊपर की तालिका में न दिखने वाले देशों की कीमत (जब * Default पंक्ति न हो)। इन देशों के लिए विधि छिपाने के लिए खाली छोड़ें।

शर्तें

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

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

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

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

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

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

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

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

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

उन्नत

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

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

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

इम्पोर्ट / एक्सपोर्ट

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

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

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

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

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

प्रति ऑर्डर मोड में आइटम एक बॉक्स में रखे जाते हैं: सबसे बड़े आइटमों की सबसे लंबी और मध्य भुजा, और सभी इकाइयों की सबसे छोटी भुजाएँ जोड़कर। यदि किसी उत्पाद का आयाम नहीं है, तो पूरे पार्सल के लिए डिफ़ॉल्ट बॉक्स आकार उपयोग होता है। प्रति आइटम मोड में हर उत्पाद को अपना अलग पार्सल मानकर दर लगाई जाती है और दर को उसकी मात्रा से गुणा किया जाता है।

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

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

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

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

ऑर्डर

जब लाइव Shippo दर वाला ऑर्डर दिया जाता है, तो एक्सटेंशन चुना गया Carrier / service रखता है, और प्रति ऑर्डर एक पार्सल के लिए Estimated delivery days भी। ऑर्डर को Sales > Orders में खोलें: ये ऑर्डर इतिहास के ऊपर Shippo पैनल में दिखते हैं, ताकि आप Shippo में मेल खाने वाला लेबल खरीद सकें। डेटा ऑर्डर के साथ सहेजा जाता है: कार्ट या सेटिंग्स में बाद के बदलाव इसे नहीं बदलते। विधि बंद करने के बाद भी पैनल दिखता है। फ़ॉलबैक कीमत या मुफ़्त शिपिंग वाले ऑर्डरों में Shippo पैनल नहीं होता।

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

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

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

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

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

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

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

लाइव दरें नहीं दिख रहीं: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: API टोकन या शिप-फ़्रॉम पोस्टल कोड नहीं है; स्टोर की डिफ़ॉल्ट मुद्रा विनिमय दर के बिना Shippo दर मुद्रा से अलग है; ग्राहक ने अभी तक अपना पोस्टल कोड नहीं डाला है; आपके Shippo खाते का कोई कैरियर उस पते की सेवा नहीं करता; या Shippo खाता अभी सत्यापित नहीं हुआ है।

लाइव स्टोर पर टेस्ट दरें: एक टेस्ट टोकन (shippo_test_...) Shippo की टेस्ट दरें लौटाता है। लाइव टोकन (shippo_live_...) उपयोग करें।

अप्रत्याशित देशों के लिए मुफ़्त शिपिंग: कीमत तालिका में कोई खाली पंक्ति देखें, खासकर खाली * Default पंक्ति। जिस पंक्ति की सभी सेल खाली हैं, वह 0 चार्ज करती है।

गलत वज़न या बॉक्स आकार: यदि पेज किसी अज्ञात वज़न या लंबाई इकाई की चेतावनी देता है, तो System > Settings के Local टैब में kg, g, lb या oz वज़न क्लास और cm, mm, m या in लंबाई क्लास सेट करें।

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

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

डेवलपर्स के लिए: Shippo API पता सेटिंग vfd_shpo_api_url से बदला जा सकता है (परीक्षण के लिए); सेटिंग्स पेज पर इसके लिए कोई फ़ील्ड नहीं है।

अनइंस्टॉल

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

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

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