VibeFox EasyPost for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

उत्पाद: उत्पादों का वज़न होना चाहिए, और बेहतर होगा कि आयाम भी हों।

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

इंस्टॉलेशन

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

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

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

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

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

6. यदि आपके स्टोर की मुद्रा USD नहीं है, तो USD exchange rate दर्ज करें। वैकल्पिक रूप से फ़ॉलबैक कीमतें भी दर्ज कर सकते हैं (कॉन्फ़िगरेशन देखें)।

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

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

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

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

पेज के शीर्ष पर, जब लाइव दरें उपयोग नहीं की जा सकतीं, तब प्लगइन चेतावनियाँ दिखाता है: API कुंजी नहीं है, भेजने वाले स्थान का ZIP कोड या देश नहीं है, या स्टोर की मुद्रा USD से अलग है और विनिमय दर नहीं है। टेस्ट API कुंजी सेट होने पर भी एक सूचना दिखती है। सेटिंग्स सहेजने के हर बार, कैश की गई EasyPost दरें हट जाती हैं।

सामान्य

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

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

EasyPost खाता

API key: EasyPost Dashboard > Account Settings > API Keys से आपकी EasyPost API कुंजी। प्रोडक्शन कुंजी (EZAK से शुरू होती है) असली दरें लौटाती है। टेस्ट कुंजी (EZTK से शुरू होती है) EasyPost की टेस्ट दरें लौटाती है; इसे केवल परीक्षण के लिए उपयोग करें।

Allowed carriers / services: वैकल्पिक, कॉमा से अलग किया गया। EasyPost के नामों के अनुसार कैरियर (USPS) या कैरियर और सेवा (USPS:Priority, UPS:Ground) दर्ज करें। अनुमत दरों में से सबसे सस्ती दर दिखाई जाती है। किसी भी कैरियर की सबसे सस्ती दर दिखाने के लिए इसे खाली छोड़ें।

भेजने का स्थान

वह पता जहाँ से आपके पार्सल भेजे जाते हैं। यदि Country आपके स्टोर का देश है, तो खाली फ़ील्ड WooCommerce > Settings > General में स्टोर के पते से भरे जाते हैं (और भेजने वाले का नाम साइट के शीर्षक से लिया जाता है)।

Sender name / company: भेजने वाले का नाम या कंपनी।

Street address: भेजने के पते की सड़क।

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

State: दो अक्षरों का राज्य कोड, जैसे CA या NY।

ZIP code: भेजने का ZIP या पिन कोड। लाइव दरों के लिए आवश्यक।

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

दरें

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

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

One parcel per item (every unit ships in its own box): हर उत्पाद को अलग पार्सल के रूप में आँका जाता है, और दर हर इकाई के लिए ली जाती है। फ़ॉलबैक कीमतें भी प्रति इकाई ली जाती हैं।

वज़न स्टोर की वज़न इकाई से औंस (न्यूनतम 1 oz) में और आयाम इंच में बदले जाते हैं। यदि किसी उत्पाद का आयाम नहीं है, तो पार्सल केवल वज़न से आँका जाता है।

USD exchange rate: EasyPost की दरें USD में होती हैं। 1 USD की कीमत आपके स्टोर की मुद्रा में दर्ज करें, उदाहरण के लिए 0.92। इसके बिना लाइव दरें उपयोग नहीं होतीं, केवल फ़ॉलबैक कीमतें होती हैं। स्टोर की मुद्रा USD होने पर इसकी ज़रूरत नहीं है। USD और CAD स्टोर EasyPost से अपनी मुद्रा में कोटेशन माँगते हैं। दशमलव विभाजक के रूप में बिंदु और कॉमा, दोनों स्वीकार किए जाते हैं।

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

फ़ॉलबैक कीमतें

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

Country prices: हर देश के लिए एक पंक्ति: दो अक्षरों का देश कोड, कोलन और कीमत, जैसे US:9.99। दूसरे प्रारूप की पंक्तियाँ अनदेखी की जाती हैं और सहेजते समय त्रुटि संदेश में सूचीबद्ध होती हैं।

Other countries: ऊपर की सूची में न होने वाले देशों की कीमत। उनके लिए विधि छिपाने के लिए खाली छोड़ें।

शर्तें

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

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

Minimum weight: जब कार्ट का वज़न इससे कम हो तो विधि छिपाएँ (स्टोर की वज़न इकाई में)। 0 का अर्थ है कोई सीमा नहीं।

Maximum weight: जब कार्ट का वज़न इससे अधिक हो तो विधि छिपाएँ (स्टोर की वज़न इकाई में)। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

उन्नत

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

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

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

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

अन्यथा प्लगइन EasyPost को भेजने वाला पता, डिलीवरी पता और पार्सल भेजता है, और आपके सभी कैरियर खातों की दरें प्राप्त करता है। यह अनुमत सबसे सस्ती दर चुनता है, उसे स्टोर की मुद्रा में बदलता है, और आपकी विधि के नाम के नीचे दिखाता है। जिन देशों में पोस्टल कोड चाहिए, वहाँ अनुरोध तभी भेजा जाता है जब ग्राहक उसे दर्ज कर ले।

एक ही पते और पार्सल के लिए हर उत्तर 1 घंटे तक कैश में रहता है। जिस पते पर उपयोग करने योग्य दरें नहीं मिलतीं, उसे 10 मिनट तक याद रखा जाता है। टाइमआउट, अस्वीकृत कुंजी, दर सीमा (rate limit) या EasyPost सर्वर त्रुटि के बाद 5 मिनट तक कोई अनुरोध नहीं भेजा जाता। API टाइमआउट 10 सेकंड है। इन सभी स्थितियों में ग्राहक को कोई त्रुटि नहीं दिखती: फ़ॉलबैक कीमत उपयोग होती है, या यदि फ़ॉलबैक कीमत नहीं है तो विधि छिप जाती है।

चुने गए कैरियर और सेवा, और एक-पार्सल मोड में अनुमानित डिलीवरी दिन, ऑर्डर की शिपिंग पंक्ति के साथ सहेजे जाते हैं। आप इन्हें एडमिन ऑर्डर स्क्रीन पर देखते हैं।

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

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

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

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: सेटिंग्स पेज के शीर्ष की चेतावनियाँ पढ़ें, फिर Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-easypost। सामान्य कारण: API कुंजी या भेजने के स्थान का ZIP कोड नहीं है, USD से अलग स्टोर में USD exchange rate नहीं है, ग्राहक ने अभी ZIP कोड दर्ज नहीं किया है, आपके EasyPost खाते का कोई कैरियर पते की सेवा नहीं देता, या Allowed carriers / services सभी दरों को छान देता है।

दरें टेस्ट कीमतों जैसी लगती हैं: एक टेस्ट कुंजी (EZTK...) सेट है। लाइव स्टोर पर प्रोडक्शन कुंजी (EZAK...) उपयोग करें।

दरें कुछ मिनटों के लिए रुक गईं: टाइमआउट, अस्वीकृत कुंजी या EasyPost सर्वर त्रुटि के बाद प्लगइन 5 मिनट के लिए अनुरोध रोकता है और फ़ॉलबैक कीमतें उपयोग करता है। API कुंजी और लॉग जाँचें।

क्या टैक्स शामिल है? EasyPost की दरों में बिक्री कर शामिल नहीं है। Tax status Taxable होने पर WooCommerce आपकी कर सेटिंग्स के अनुसार शिपिंग पर टैक्स लगाता है।

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

डेवलपर हुक: फ़िल्टर vfd_ep_shipment_request (अनुरोध बॉडी), vfd_ep_selected_rate (चुनी गई दर), vfd_ep_api_url (API बेस URL) और woocommerce_shipping_vfd_easypost_is_available प्लगइन को समायोजित करते हैं।

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

अनइंस्टॉल

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

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