VibeFox ShipStation for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

ShipStation खाता: ShipStation में अपने कैरियर जोड़ें (Settings > Shipping > Carriers), फिर ShipStation > Settings > Account > API Settings से API Key और API Secret कॉपी करें। API पहुँच आपके ShipStation प्लान पर निर्भर है। यदि पेज उपलब्ध नहीं है, तो आपके प्लान में API पहुँच शामिल नहीं है। प्लगइन ShipStation API V1 (API Key और API Secret) का उपयोग करता है। केवल एक API कुंजी वाले ShipStation API V2 खाते समर्थित नहीं हैं। कुंजियों के बिना केवल वैकल्पिक मूल्य उपयोग होते हैं।

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

इंस्टॉलेशन

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

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

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

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

5. API Key और API Secret चिपकाएँ, शिप-फ़्रॉम पोस्टल कोड दर्ज करें और सहेजें। पेज अब आपके खाते के कैरियर कोड दिखाएगा। जो कोड चाहिए उन्हें Carrier codes में डालें और फिर से सहेजें।

6. यदि आपके स्टोर की मुद्रा ShipStation खाते की मुद्रा से अलग है, तो Exchange rate सेट करें।

7. चाहें तो वैकल्पिक मूल्य भरें।

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

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

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

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

हर बार जब आप सेटिंग्स सहेजते हैं, कैश की गई ShipStation दरें साफ़ हो जाती हैं और API Key और API Secret की जाँच होती है। फिर पेज आपके खाते से जुड़े कैरियर उनके कोड सहित दिखाता है, उदाहरण: "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)"। सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि लाइव दरें कब काम नहीं कर सकतीं: कुंजियाँ नहीं हैं, कैरियर कोड नहीं है, शिप-फ़्रॉम पोस्टल कोड नहीं है, विनिमय दर नहीं है, कनेक्शन जाँच विफल है, या कैरियर कोड आपके खाते से जुड़े नहीं हैं।

सामान्य

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

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

ShipStation खाता

API Key: ShipStation > Settings > Account > API Settings की API Key।

API Secret: उसी पेज की API Secret।

Carrier codes: एक या अधिक ShipStation कैरियर कोड, कॉमा से अलग किए हुए, उदाहरण: stamps_com, ups_walleted। अधिकतम 5 कोड उपयोग होते हैं, और हर कैरियर के लिए एक API अनुरोध भेजा जाता है। इन कैरियरों की सबसे सस्ती दर दिखाई जाती है। कोड सेव करने के बाद दिखने वाली सूची से लें।

Allowed services: वैकल्पिक, कॉमा से अलग ShipStation सेवा कोड, उदाहरण: usps_priority_mail, ups_ground। ऊपर के कैरियरों की सबसे सस्ती सेवा दिखाने के लिए खाली छोड़ें।

Package code: "package" (डिफ़ॉल्ट) आपके अपने बॉक्स की दर निकालता है और कैरियर के लिफ़ाफ़े व फ़्लैट-रेट बॉक्स बाहर रखता है। कैरियर द्वारा दी जाने वाली सभी पैकेज प्रकारों की दरें निकालने के लिए खाली छोड़ें।

शिप-फ़्रॉम

Ship-from postal code: लाइव दरों के लिए आवश्यक। ShipStation केवल पोस्टल कोड से दरें निकालता है, और यह कोड आपके ShipStation खाते के देश में होना चाहिए। WooCommerce > Settings > General में दिया गया स्टोर पोस्टकोड उपयोग करने के लिए खाली छोड़ें।

दरें

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

ShipStation account currency: वह मुद्रा जिसमें ShipStation दरें लौटाता है: USD, CAD, GBP, AUD, NZD या EUR। डिफ़ॉल्ट: USD (US खाते)।

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

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

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

Prices by country: देश के अनुसार बेस मूल्य और पार्सल वज़न के अनुसार आकार कॉलम वाली तालिका: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg और XL >5 kg। पंक्ति जोड़ने के लिए + Add country पर और पंक्ति हटाने के लिए क्रॉस पर क्लिक करें। खाली आकार बेस मूल्य उपयोग करता है। बेस मूल्य 0 का अर्थ है मुफ़्त शिपिंग। * Default (all other countries) पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है।

Other countries: वह मूल्य जब तालिका में देश का मूल्य न हो। इस स्थिति में विधि छिपाने के लिए खाली छोड़ें।

शर्तें

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

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

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

Maximum weight: इस कार्ट वज़न से ऊपर विधि छिप जाती है, आपके स्टोर की वज़न इकाई में। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

उन्नत

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

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

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

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

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

ShipStation से हर कैरियर कोड के लिए एक बार पूछा जाता है। प्लगइन अनुमत सबसे सस्ती दर को स्टोर की मुद्रा में बदलकर विधि के नाम के नीचे दिखाता है।

हर उत्तर 1 घंटे के लिए कैश होता है। जब ShipStation बिना उपयोगी दर के उत्तर देता है, तो वह उत्तर 10 मिनट तक याद रखा जाता है। जब ShipStation कुंजियाँ अस्वीकार करता है या पहुँच से बाहर है, तो अनुरोध 5 मिनट के लिए रुक जाते हैं। दर-सीमा के बाद का विराम ShipStation के रीसेट समय के अनुसार होता है। अनुरोध की समय-सीमा 12 सेकंड है। प्लगइन निष्क्रिय करने पर कैश की गई दरें साफ़ हो जाती हैं।

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

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

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

ऑर्डर

ऑर्डर की शिपिंग पंक्ति चुनी हुई Service सहेजती है, उदाहरण: "USPS Ground Advantage - Package"। यह आपको एडमिन ऑर्डर स्क्रीन पर दिखती है और आप ShipStation में मिलता-जुलता लेबल बना सकते हैं।

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

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

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

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

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

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

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

चेकआउट ShipStation दर की जगह वैकल्पिक मूल्य दिखाता है: सेटिंग्स पेज के शीर्ष की चेतावनियाँ देखें (कुंजियाँ, कैरियर कोड, शिप-फ़्रॉम पोस्टल कोड, विनिमय दर)। Debug log चालू करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-shipstation। ग्राहक का पोस्टल कोड आवश्यक है। उसके दर्ज होने से पहले कोई अनुरोध नहीं किया जाता।

कौन सा कैरियर कोड डालें: कुंजी और सीक्रेट के साथ सेटिंग्स सहेजें। पेज आपके खाते के कैरियर कोड दिखाता है। उनमें से एक या अधिक उपयोग करें।

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

डेवलपरों के लिए: फ़िल्टर vfd_shst_rate_request, vfd_shst_selected_rate और vfd_shst_api_url कैरियर-वार दर अनुरोध, चुनी गई दर और API बेस URL बदलते हैं।

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

अनइंस्टॉल

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

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