VibeFox Sameday Easybox for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Sameday API उपयोगकर्ता नाम और पासवर्ड: API पहुँच रोमानिया, हंगरी या बुल्गारिया में Sameday बिज़नेस खाते का हिस्सा है। अपने Sameday खाता प्रबंधक या Sameday इंटीग्रेशन टीम से पूछें। ये क्रेडेंशियल अक्सर eAWB पोर्टल (eawb.sameday.ro, .hu या .bg) वाले ही होते हैं। डेमो API के लिए Sameday अलग टेस्ट क्रेडेंशियल देता है। API उपयोगकर्ता नाम और पासवर्ड के बिना यह विधि नहीं दिखाई जाती, क्योंकि ग्राहक लॉकर नहीं चुन पाएगा।

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

इंस्टॉलेशन

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

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

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

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

5. Sameday का API username और API password डालें, Sameday country चुनें और सेव करें। पेज पर "Connected to Sameday ... easybox lockers" दिखना चाहिए। Pickup point और Easybox service आपके खाते से भर जाते हैं।

6. अपनी कीमतें सेट करें: यदि आपकी स्टोर मुद्रा Sameday की मुद्रा से अलग है तो Exchange rate of the estimate, और Country prices की एक पंक्ति (उदाहरण के लिए * Default) या Fallback cost।

7. WooCommerce > Settings > Shipping > Shipping zones में अपने Sameday देश के शिपिंग ज़ोन में VibeFox Sameday Easybox जोड़ें, या Ignore shipping zones चालू करें।

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

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

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

सेटिंग्स के ऊपर पेज कनेक्शन की स्थिति दिखाता है: Sameday होस्ट, easybox लॉकर की संख्या और सूची कब अपडेट हुई, या यह कि Sameday ने उपयोगकर्ता नाम या पासवर्ड अस्वीकार किया। यह कॉन्फ़िगरेशन की समस्याएँ भी सूचीबद्ध करता है, जैसे क्रेडेंशियल न होना, कीमत न होना, या अनुमान के लिए विनिमय दर न होना।

सभी कीमतें और सीमाएँ दशमलव विभाजक के रूप में अल्पविराम या बिंदु स्वीकार करती हैं (4,99 या 4.99)। अमान्य संख्या एक संदेश के साथ अस्वीकार की जाती है।

सामान्य

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

Name: ग्राहक को दिखने वाला शिपिंग विधि का नाम। कोई ज़ोन इसे अपने Title से बदल सकता है। Default: Sameday easybox.

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

Sameday खाता (API)

सेव करने पर प्लगइन Sameday में लॉग इन करता है और आपकी सेवाएँ, पिकअप पॉइंट और easybox लॉकर की सूची लोड करता है। सूची हर दिन रीफ़्रेश होती है।

API username: आपका Sameday API उपयोगकर्ता नाम।

API password: आपका Sameday API पासवर्ड। यदि Sameday इसे अस्वीकार करता है, तो 10 मिनट तक दोबारा कोशिश नहीं होती।

Sameday country: आपके Sameday खाते का देश: Romania (api.sameday.ro) (डिफ़ॉल्ट), Hungary (api.sameday.hu) या Bulgaria (api.sameday.bg)। उस देश के लॉकर दिए जाते हैं, और यह विधि केवल इसी गंतव्य देश के लिए दिखती है।

Test mode: डेमो क्रेडेंशियल के साथ Sameday डेमो API का उपयोग करता है।

कीमतें

उपयोग का क्रम यह है: Sameday अनुमान (जब Pickup point और Easybox service सेट हों), फिर देश की कीमत तालिका, और अंत में फ़ॉलबैक लागत। तालिका की कीमतें स्टोर की मुद्रा में डाली जाती हैं।

Pickup point: आपका Sameday पिकअप पॉइंट, जहाँ से Sameday पार्सल उठाता है। सफल लॉगिन के बाद यह आपके खाते के पिकअप पॉइंट की सूची होती है, और डिफ़ॉल्ट पॉइंट अपने-आप चुना जाता है। Sameday अनुमान के लिए आवश्यक। केवल कीमत तालिका उपयोग करने के लिए - not set (price table only) - चुनें।

Easybox service: easybox डिलीवरी के लिए Sameday सेवा, आमतौर पर "Locker NextDay" (कोड LN), जो अपने-आप चुनी जाती है। Sameday अनुमान के लिए आवश्यक।

Exchange rate of the estimate: Sameday अनुमान अपने देश की मुद्रा में देता है: RON, HUF या BGN (यूरो में बेचने वाले बुल्गारियाई स्टोर्स के लिए EUR)। यदि आपका स्टोर किसी दूसरी मुद्रा में बेचता है, तो Sameday मुद्रा की 1 इकाई का मान अपनी स्टोर मुद्रा में डालें, उदाहरण के लिए 0.20। इसके बिना अनुमान का उपयोग नहीं होता और कीमत तालिका लागू होती है। लेव और यूरो अपने-आप निश्चित दर पर बदल दिए जाते हैं।

Table price: Per order कीमत एक बार लेता है। Per item (price x quantity) इसे भेजे जाने योग्य वस्तुओं की संख्या से गुणा करता है। यह तालिका कीमत और फ़ॉलबैक लागत पर लागू होता है। Sameday अनुमान हमेशा पूरे पार्सल के लिए होता है।

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

Fallback cost: तब उपयोग होता है जब Sameday अनुमान न हो और देश तालिका में गंतव्य के लिए पंक्ति न हो। उस स्थिति में विधि न दिखाने के लिए इसे खाली छोड़ें।

Free shipping from: कार्ट उप-योग (छूट के बाद, कर के बिना), जिससे आगे easybox डिलीवरी मुफ़्त है। यह केवल वहीं लागू होता है जहाँ कीमत मिलती है: देश की पंक्ति, * Default पंक्ति या फ़ॉलबैक लागत (तब अनुमान नहीं माँगा जाता), या Sameday अनुमान। मुफ़्त शिपिंग कभी न देने के लिए इसे खाली छोड़ें।

उपलब्धता

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

Maximum weight (kg): इससे भारी पार्सल को easybox डिलीवरी नहीं दी जाती। Default: 30। अपने Sameday अनुबंध की सीमा और easybox बॉक्स के आकार जाँचें। खाली या 0 का अर्थ है कोई सीमा नहीं।

Minimum cart subtotal: विधि केवल तभी दें जब कार्ट उप-योग (छूट के बाद, कर के बिना) इस राशि तक पहुँचे।

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

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

Countries (ignore zones mode): इस मोड के लिए गंतव्य देश। Sameday देश इस्तेमाल करने के लिए खाली छोड़ें। Sameday देश से अलग देश छोड़ दिए जाते हैं। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।

उन्नत

Debug log: कीमत गणना, API कॉल और लॉकर चयन को WooCommerce > Status > Logs में लिखता है (स्रोत "vfd-sameday-easybox")। API त्रुटियाँ हमेशा दर्ज होती हैं। पासवर्ड, टोकन या ग्राहक का व्यक्तिगत डेटा दर्ज नहीं होता। काम पूरा होने पर लॉग बंद करें।

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

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

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

अन्यथा, जब ग्राहक शहर और ज़िला डाल देता है, तब प्लगइन Sameday से अनुमान माँगता है। यह आपका पिकअप पॉइंट और सेवा, पार्सल का वज़न, और ग्राहक का सड़क का पता, शहर, ज़िला और पिन कोड भेजता है। नाम, ईमेल या फ़ोन नंबर नहीं भेजा जाता। बुखारेस्ट को आधिकारिक Sameday प्लगइन की तरह "Sector 1" के रूप में भेजा जाता है। अनुमान आपकी स्टोर मुद्रा में बदला जाता है। यदि अनुमान नहीं है (सेट अप नहीं, अभी शहर या ज़िला नहीं, त्रुटि, विनिमय दर नहीं), तो कीमत देश तालिका से आती है, फिर फ़ॉलबैक लागत से। कीमत न हो तो विधि छिप जाती है।

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

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

प्लगइन AWB (शिपमेंट) नहीं बनाता, लेबल प्रिंट नहीं करता, पार्सल ट्रैक नहीं करता या कैश ऑन डिलीवरी नहीं संभालता। इसमें घर पर कूरियर डिलीवरी या Sameday मैप विजेट नहीं है। AWB Sameday eAWB पोर्टल में या अपने सामान्य टूल में बनाएँ, ऑर्डर पर दिख रहे लॉकर ID के साथ।

लॉकर चयन

जब ग्राहक यह विधि चुनता है, तो उसके नीचे दो सूचियों वाला easybox locker ब्लॉक दिखता है: - Select city - और - Select easybox locker -। यदि ग्राहक के शहर में लॉकर हैं, तो वह शहर पहले से चुना जाता है। हर लॉकर अपना नाम और पता दिखाता है। चेकआउट रीफ़्रेश होने या पेज दोबारा लोड होने पर चुनाव याद रहता है।

लॉकर अनिवार्य है। इसके बिना चेकआउट "Please choose a Sameday easybox locker." संदेश के साथ रुक जाता है। सर्वर जाँचता है कि चुना गया लॉकर सूची में है, क्लासिक और ब्लॉक, दोनों चेकआउट में। नकली या हटाई गई लॉकर ID को "The selected easybox locker is not available any more. Please choose another easybox locker." संदेश के साथ अस्वीकार किया जाता है। ऑर्डर के साथ सेव नाम और पता सूची से आते हैं, ब्राउज़र से नहीं।

एडमिन ऑर्डर स्क्रीन: शिपिंग पते के नीचे Sameday easybox locker, नाम और पते के साथ, और Sameday AWB के लिए Locker ID। यदि easybox ऑर्डर में लॉकर नहीं है, तो स्क्रीन पर "No easybox locker was selected for this order." लिखा आता है।

धन्यवाद पेज और ऑर्डर व्यू: Sameday easybox locker: नाम और पते के साथ।

ऑर्डर ईमेल: HTML और प्लेन-टेक्स्ट ईमेल में लॉकर का नाम और पता। एडमिन ईमेल में Locker ID भी होती है।

डेटाबेस में लॉकर ऑर्डर मेटा _vfd_sdeb_locker_id (AWB के लिए Sameday लॉकर ID) और _vfd_sdeb_locker_name (नाम और पता) में सेव होता है।

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

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

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

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

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

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

Sameday easybox चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API उपयोगकर्ता नाम और पासवर्ड डाले गए हैं और सेटिंग्स पेज पर "Connected to Sameday" लिखा है, और गंतव्य देश आपके Sameday खाते का देश है। जाँचें कि कीमत उपलब्ध है (Sameday अनुमान, देश की पंक्ति, * Default पंक्ति या Fallback cost), वज़न और उप-योग की सीमाएँ, Excluded shipping classes, और यह कि विधि सही ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है)। कारण देखने के लिए Debug log चालू करें और WooCommerce > Status > Logs देखें।

Sameday ने API उपयोगकर्ता नाम या पासवर्ड अस्वीकार किया: उन्हें जाँचें और दोबारा सेव करें। डेमो क्रेडेंशियल केवल Test mode चालू होने पर, और लाइव क्रेडेंशियल केवल बंद होने पर काम करते हैं। तब तक, यदि सेव की हुई लॉकर सूची है तो वह दी जाती है, और Sameday अनुमान इस्तेमाल नहीं होता।

कीमत Sameday से नहीं, मेरी तालिका से आ रही है: अनुमान के लिए Pickup point, Easybox service और, यदि आपकी स्टोर मुद्रा Sameday मुद्रा से अलग है, तो Exchange rate of the estimate चाहिए। अनुमान तभी माँगा जाता है जब ग्राहक शहर और ज़िला डाल दे। जब Sameday पहुँच में न हो या त्रुटि लौटाए, तब तालिका या फ़ॉलबैक लागत इस्तेमाल होती है; कारण लॉग में है।

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

गलती से शिपिंग मुफ़्त है: Country prices में वे पंक्तियाँ जाँचें जिनका Price 0 है, खासकर वह * Default पंक्ति जो + Add country से जोड़ी गई और भरी नहीं गई।

सीमा-पार लॉकर: डेवलपर vfd_sdeb_countries फ़िल्टर से गंतव्य देश जोड़ सकते हैं। लॉकर सूची हमेशा आपके खाते की होती है।

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

अनइंस्टॉल

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

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