VibeFox ShipStation for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

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

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

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

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

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

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

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

सभी सेटिंग्स मॉड्यूल के पेज पर हैं: Modules > Module Manager > VibeFox ShipStation > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर ShipStation के कैश्ड दरें हटती हैं और API Key व API Secret की जाँच होती है। फिर पेज पर आपके खाते से जुड़े कैरियर उनके कोड सहित दिखते हैं, उदाहरण के लिए "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)"।

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

सामान्य

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

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

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

ShipStation खाता

API Key: ShipStation > Settings > Account > API Settings से API Key। यह केवल ShipStation को भेजी जाती है और कभी लॉग नहीं होती। सहेजने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तभी नया मान दर्ज करें।

API Secret: उसी पेज की API Secret। इसे कुंजी की तरह ही रखा जाता है।

Remove the saved API key and secret: कुंजियाँ सहेजे जाने पर दिखता है। इसे चुनकर सहेजें, दोनों हट जाएँगी।

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

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

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

शिप फ़्रॉम

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

दरें

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

One parcel per order (the cart is packed into one box): सभी आइटम एक बॉक्स में रखे जाते हैं और एक बार दर निकाली जाती है।

One parcel per item (every unit ships in its own box): हर उत्पाद अपना अलग पार्सल मानकर दर निकाला जाता है, और हर यूनिट के लिए शुल्क लिया जाता है। वैकल्पिक मूल्य भी प्रति यूनिट लिए जाते हैं।

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

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

वैकल्पिक मूल्य (जब लाइव दर न हो तब उपयोग होते हैं: 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 का अर्थ है कोई सीमा नहीं।

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

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

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

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

उन्नत

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

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

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

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

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

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

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

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

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

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

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

ऑर्डर

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

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

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

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

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

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

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

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

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

ShipStation कनेक्शन जाँच विफल हुई: संदेश कारण बताता है। API Key और API Secret जाँचें, फिर जाँच दोहराने के लिए दोबारा सहेजें।

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

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

अनइंस्टॉल

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

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