VibeFox Shippo for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

6. वैकल्पिक रूप से देश और वज़न की तालिका में फ़ॉलबैक कीमतें डालें, फिर Save पर क्लिक करें।

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

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

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

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

सामान्य

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

Name: चेकआउट पर ग्राहक को दिखने वाला कैरियर नाम। डिफ़ॉल्ट: Shippo Shipping। आवश्यक, अधिकतम 64 अक्षर।

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

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)। अनुमत दरों में सबसे सस्ती दर दिखती है। खाली छोड़ने पर किसी भी कैरियर की सबसे सस्ती दर दिखती है।

भेजने का स्थान (वह पता जहाँ से आपके पार्सल भेजे जाते हैं; खाली फ़ील्ड, यदि वह उसी देश में है, तो Shop Parameters > Contact > Stores में स्टोर के पते से भरे जाते हैं)

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

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

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

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

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

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

दरें

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

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

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

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

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

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

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

शर्तें

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

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

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

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

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

सामान्यतः कैरियर Shipping > Carriers में अपने शिपिंग ज़ोन में दिया जाता है। वैकल्पिक रूप से, इसे ज़ोन से स्वतंत्र, देश के अनुसार दिया जा सकता है।

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

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

उन्नत

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

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

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

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

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

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

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

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

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

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

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

ऑर्डर

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

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

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

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

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

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

Shippo चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Shippo shipping चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है और देश अनुमत है)। वज़न सीमा और Minimum subtotal जाँचें। लाइव दर न होने पर जाँचें कि देश, * Default या Other countries की कोई कीमत है। उत्पाद पेज पर उत्पादों को कुछ विशेष कैरियरों तक भी सीमित किया जा सकता है।

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

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

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

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

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

अनइंस्टॉल

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

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