VibeFox Shippo for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_shippo फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Shippo, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

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

6. Shippo rate currency चुनें (यदि आप अमेरिका से भेजते हैं तो USD), और यदि आपका स्टोर कोई अन्य मुद्रा उपयोग करता है तो विनिमय दर दर्ज करें।

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

8. WooCommerce > Settings > Shipping > Shipping zones में किसी शिपिंग ज़ोन में VibeFox Shippo जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Shippo। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। वैश्विक Name उपयोग करने के लिए इसे खाली छोड़ें।

हर बार जब आप सेटिंग्स सहेजते हैं, कैश की गई Shippo दरें साफ़ हो जाती हैं। सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि विधि कब कभी नहीं दिखाई जा सकती या लाइव दरें कब उपयोग नहीं हो सकतीं: API टोकन नहीं है, भेजने वाले का पिन कोड या देश नहीं है, या विनिमय दर नहीं है। टेस्ट टोकन सेट होने पर एक सूचना याद दिलाती है।

सामान्य

Enable/Disable: विधि को सभी ज़ोन में एक साथ चालू या बंद करता है।

Name: चेकआउट पर दिखने वाला शिपिंग विधि का नाम। कोई ज़ोन अपने Title से इसे बदल सकता है। डिफ़ॉल्ट: Shippo Shipping।

Shippo खाता

API token: आपका Shippo API टोकन। असली स्टोर पर असली दरों के लिए लाइव टोकन (shippo_live_...) उपयोग करें, या Shippo की टेस्ट दरों के लिए टेस्ट टोकन (shippo_test_...)।

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

Ship from (वह पता जहाँ से आपके पार्सल भेजे जाते हैं; खाली फ़ील्ड तब WooCommerce > Settings > General के स्टोर पते से भरे जाते हैं, जब वह उसी देश में हो)

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 (अमेरिका), CAD (कनाडा), GBP (यूके), EUR (यूरोज़ोन) या AUD (ऑस्ट्रेलिया)। डिफ़ॉल्ट: USD। Shippo जो दरें स्टोर की मुद्रा में लौटाता है, वे हमेशा जैसी हैं वैसी उपयोग होती हैं।

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

Tax status: Taxable WooCommerce को आपके कर नियमों के अनुसार शिपिंग पर कर जोड़ने देता है; None ऐसा नहीं करता। Shippo की दरों में बिक्री कर शामिल नहीं होता।

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

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

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

शर्तें

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

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

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

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

Disabled shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लास में से किसी का उत्पाद हो, तो विधि छिपा दें।

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

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

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

उन्नत

Debug log: Shippo अनुरोधों को WooCommerce > Status > Logs में, स्रोत vfd-shippo के अंतर्गत लॉग करता है। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। API टोकन और ग्राहक के पते कभी लॉग नहीं होते।

Remove data on uninstall: चालू होने पर, प्लगइन हटाने से उसकी सेटिंग्स और शिपिंग ज़ोन की विधियाँ हट जाती हैं। प्लगइन निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: कार्ट वज़न, न्यूनतम सबटोटल और अक्षम शिपिंग क्लास। यदि मुफ़्त शिपिंग लागू होती है, तो विधि 0 की कीमत के साथ दिखाई जाती है और Shippo को कोई अनुरोध नहीं जाता।

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

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

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

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

यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

ऑर्डर

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

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Shippo पेज के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now उपयोग करें, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उस डोमेन का स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Shippo नहीं दिखता। लॉग-इन किए स्टोर मैनेजरों को यह अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके उसकी जाँच कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण आवश्यक है। स्थिति पृष्ठभूमि में अपने-आप दोबारा जाँची जाती है।

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

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

लाइव दरें दिखाई नहीं देतीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-shippo। आम कारण: API टोकन या भेजने वाले का पिन कोड नहीं है, स्टोर की मुद्रा बिना विनिमय दर के Shippo rate currency से अलग है, ग्राहक का पिन कोड अभी दर्ज नहीं हुआ है, आपके Shippo खाते का कोई कैरियर उस पते पर सेवा नहीं देता, या Shippo खाता अभी सत्यापित नहीं हुआ है।

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

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

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

डेवलपर्स के लिए: फ़िल्टर vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate और vfd_shpo_api_url अनुरोध बॉडी, कस्टम घोषणा-पत्र, चुनी हुई दर और API URL बदलते हैं।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

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

Shippo उसके संबंधित मालिक का ट्रेडमार्क है। यह प्लगइन Shippo से संबद्ध नहीं है और Shippo द्वारा समर्थित नहीं है।