VibeFox Instabee for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x.

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

Budbee API क्रेडेंशियल (केवल पार्सल बॉक्स चयन के लिए): एक API key और एक API secret। Instabee इन्हें डिलीवरी समझौते वाले मर्चेंट को जारी करता है। अपने Instabee संपर्क से पूछें या Instabee merchant portal का उपयोग करें। API दस्तावेज़ developer.budbee.com पर है। क्रेडेंशियल के बिना कैरियर फ़िक्स्ड कीमतों के साथ काम करता है, लेकिन ग्राहक पार्सल बॉक्स नहीं चुन सकते।

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

इंस्टॉलेशन

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

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

3. अपनी VibeFox लाइसेंस कुंजी License key में डालें, जो Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में है, और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Prices सेक्शन भरें और पार्सल बॉक्स सेलेक्टर के लिए अपनी Budbee API key और API secret डालें (कॉन्फ़िगरेशन देखें)। Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल Instabee parcel box कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट Delivery to an Instabee parcel box होता है। कैरियर सभी कस्टमर ग्रुप्स और स्वीडन, फ़िनलैंड, डेनमार्क, नीदरलैंड और बेल्जियम के ज़ोन में असाइन होता है। ज़ोन, कस्टमर ग्रुप, डिलीवरी समय और लोगो Shipping > Carriers में बदले जा सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Instabee > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है।

सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि जब API क्रेडेंशियल में से केवल एक डाला गया है, जब कोई API क्रेडेंशियल नहीं है, जब देश की कीमतें और फ़ॉलबैक लागत दोनों नहीं हैं, जब आखिरी Budbee API अनुरोध विफल हुआ (तारीख, समय और कारण के साथ), जब Instabee कैरियर नहीं मिला और जब स्टोर की वज़न इकाई पहचानी नहीं गई (International > Localization में Local units के तहत kg, g, lb या oz सेट करें)। सेटिंग्स सेव करने पर कैश की गई पार्सल बॉक्स सूचियाँ और आखिरी API त्रुटि साफ़ हो जाती हैं। यदि मेथड का नाम या टैक्स स्थिति मान्य नहीं है, या Min weight (kg), Max weight (kg) से बड़ा है, तो कुछ भी सेव नहीं होता और एक त्रुटि दिखती है।

General

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

Method name: चेकआउट पर ग्राहक को दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Instabee parcel box। आवश्यक, अधिकतम 64 अक्षर।

Tax status: None का मतलब है कि नीचे की कीमतें अंतिम हैं। टैक्स नियम के साथ Taxable का मतलब है कि PrestaShop नीचे की कीमतों के ऊपर उस नियम का शिपिंग टैक्स जोड़ता है।

पार्सल बॉक्स सेलेक्टर (Budbee API)

API क्रेडेंशियल होने पर ग्राहक चेकआउट पर अपने पोस्टल कोड के पास का पार्सल बॉक्स चुनता है, और बॉक्स ऑर्डर पर सेव होता है। दोनों फ़ील्ड आवश्यक हैं। दोनों सेट होने तक सेलेक्टर बंद रहता है।

API key: आपकी Budbee API key (HTTP Basic का यूज़रनेम)।

API secret: आपका Budbee API secret (HTTP Basic का पासवर्ड)। यह कभी लॉग में नहीं लिखा जाता।

सेव करने के बाद दोनों फ़ील्ड खाली रहते हैं और Saved - leave empty to keep it. दिखाते हैं। केवल बदलने के लिए नया मान डालें। सेव किए गए क्रेडेंशियल हटाने के लिए Remove the saved API key and secret पर निशान लगाकर सेव करें। कुछ भी सेव न होने पर पेज No credentials saved. दिखाता है।

Test environment: Budbee staging API (api.staging.budbee.com) का उपयोग करता है। इसे केवल Instabee से मिले staging क्रेडेंशियल के साथ चालू करें। लाइव स्टोर इसे बंद रखते हैं (api.budbee.com)। डिफ़ॉल्ट: बंद।

कीमतें (सेक्शन शीर्षक में आपके शॉप की डिफ़ॉल्ट मुद्रा दिखती है)

सभी कीमतें शॉप की डिफ़ॉल्ट मुद्रा में, टैक्स के बिना होती हैं। दशमलव कॉमा और दशमलव बिंदु दोनों मान्य हैं (49,90 = 49.90)। ग्राहक को कीमत कार्ट की मुद्रा में दिखती है।

Calculation type: कीमत कैसे लागू होती है।

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

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

शर्तें

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

Max weight (kg): इस कार्ट वज़न से अधिक होने पर कैरियर छिपाता है। पार्सल बॉक्स लगभग 20 kg तक ले सकते हैं। डिफ़ॉल्ट: 20। 0 का मतलब कोई सीमा नहीं। यह Min weight (kg) से कम नहीं हो सकता।

Minimum order amount: कैरियर केवल तभी दिखाता है जब कार्ट का उप-योग (शिपिंग वाले उत्पाद, छूट के बाद, टैक्स से पहले) इस राशि तक पहुँचता है। हमेशा दिखाने के लिए खाली छोड़ें।

Free shipping from: कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) जिससे कैरियर मुफ़्त होता है। कभी मुफ़्त न करने के लिए खाली छोड़ें।

यदि इन फ़ील्ड या Fallback cost में कोई मान संख्या नहीं है, तो वह सेव नहीं होता, पिछला मान बना रहता है, और चेतावनी फ़ील्ड का नाम बताती है।

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

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

Ignore shipping zones: नीचे के देशों में कैरियर देता है, भले ही उसके ज़ोन में वे देश न हों। कैरियर सभी सक्रिय ज़ोन से जुड़ता है, जिनमें बाद में बने ज़ोन भी शामिल हैं। विकल्प फिर से बंद करने पर कैरियर को वे ज़ोन वापस मिल जाते हैं जो उसके पास पहले थे।

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

एडवांस्ड

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

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

Remove data on uninstall: चालू होने पर मॉड्यूल हटाने से सेटिंग्स और कैरियर हट जाते हैं। बंद होने पर हटाने से केवल कैरियर बंद होता है। ऑर्डर पर सेव किए गए पार्सल बॉक्स हमेशा रहते हैं।

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

शिपिंग चरण में PrestaShop मॉड्यूल से Instabee की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। मॉड्यूल शर्तें जाँचता है: कार्ट का वज़न और न्यूनतम ऑर्डर राशि, और Ignore shipping zones के साथ अनुमत देश। यदि कार्ट का उप-योग Free shipping from तक पहुँचता है, तो कीमत 0 होती है। अन्यथा कीमत गंतव्य देश की Country prices पंक्ति, * पंक्ति या Fallback cost से ली जाती है। यदि कीमत न मिले, तो कैरियर छिप जाता है।

जब ग्राहक Instabee कैरियर चुनता है और API क्रेडेंशियल सेट हैं, तो स्वीडन, फ़िनलैंड, डेनमार्क, नीदरलैंड और बेल्जियम के लिए कैरियर के नीचे एक Parcel box ब्लॉक आता है। यह डिलीवरी पते के पोस्टल कोड के पास के बॉक्स दूरी के अनुसार क्रमबद्ध करके, नाम, पते और दूरी के साथ दिखाता है। ग्राहक कोई दूसरा पोस्टल कोड लिख सकता है और Search पर क्लिक कर सकता है (या Enter दबा सकता है)। पोस्टल कोड डाले जाने तक ब्लॉक उसे माँगता है। यदि कोई बॉक्स नहीं मिलता, तो ग्राहक से कोई दूसरा पोस्टल कोड आज़माने या दूसरा शिपिंग तरीका चुनने को कहा जाता है। अन्य देशों के लिए कैरियर बिना बॉक्स के दिया जाता है।

पार्सल बॉक्स आवश्यक है। चुना गया बॉक्स कार्ट में तभी सेव होता है जब वह उस पोस्टल कोड की Budbee सूची में हो। ग्राहक डिलीवरी चरण में Continue पर क्लिक करता है, तो मॉड्यूल सर्वर पर बॉक्स की फिर से जाँच करता है। अन्यथा ग्राहक को Please choose an Instabee parcel box. दिखता है। बॉक्स का नाम Budbee सूची से लिया जाता है, ब्राउज़र से नहीं। यदि ग्राहक पते का डिलीवरी देश या पोस्टल कोड बदलता है, तो पिछला चुनाव हट जाता है।

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

Budbee API तक पहुँच न होने पर ग्राहक को Parcel boxes cannot be loaded right now. You can place the order without choosing a box - the shop will assign one. दिखता है। तब ऑर्डर चिह्नित होता है, और शिपमेंट बुक करते समय आप बॉक्स चुनते हैं। पहले चुना गया ऐसा बॉक्स, जिसकी उस समय जाँच नहीं हो सकती, सुरक्षित रहता है और उसे अप्रमाणित चिह्नित किया जाता है।

सेलेक्टर Classic और Hummingbird थीम के साथ काम करता है। यदि ऑर्डर आने के बाद आप Shipping > Carriers में कैरियर बदलते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण को अपने-आप मानता है।

यह मॉड्यूल लाइव रेट की गणना नहीं करता, शिपमेंट बुक नहीं करता, लेबल प्रिंट नहीं करता, ट्रैकिंग नंबर या ट्रैकिंग ईमेल नहीं देता, Budbee Home डिलीवरी समय-स्लॉट नहीं देता और मैप नहीं दिखाता। चुने गए बॉक्स के लिए पार्सल को अपने Instabee / Budbee merchant टूल में बुक करें।

पिकअप पॉइंट

ऑर्डर बनने पर बॉक्स एक बार फिर जाँचा जाता है और ऑर्डर पर सेव होता है। उसके बाद स्टोरफ़्रंट उसे नहीं बदल सकता। बॉक्स इन जगहों पर दिखता है:

बैक ऑफ़िस ऑर्डर पेज: बॉक्स के नाम, पते और Box ID के साथ Instabee parcel box ब्लॉक। यदि चेकआउट पर बॉक्स की जाँच नहीं हो सकी, तो उसे not verified (Budbee API was unavailable at checkout) चिह्नित किया जाता है। यदि API उपलब्ध न होने के कारण कोई बॉक्स नहीं चुना गया, तो ब्लॉक कहता है Not chosen - the Budbee API was unavailable at checkout. Choose the box when you book the shipment.

ऑर्डर कन्फ़र्मेशन पेज और ग्राहक खाते में ऑर्डर विवरण: Instabee parcel box: बॉक्स के नाम और पते के साथ।

ऑर्डर ईमेल: ग्राहक को भेजे गए ऑर्डर कन्फ़र्मेशन ईमेल में कैरियर के नाम के साथ बॉक्स जोड़ा जाता है। शॉप को जाने वाले नए ऑर्डर ईमेल (PrestaShop के Mail alerts मॉड्यूल से) में भी बॉक्स ID दिखता है। यदि API उपलब्ध न होने के कारण कोई बॉक्स नहीं चुना गया, तो केवल शॉप वाला ईमेल इसका उल्लेख करता है।

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

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

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

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

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

चेकआउट पर Instabee नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के ग्रुप को कवर करता है, या Ignore shipping zones चालू है और देश अनुमत है। जाँचें कि देश की कीमत है, या * पंक्ति या Fallback cost मौजूद है। वज़न की सीमाएँ और Minimum order amount जाँचें। सेटिंग्स के ऊपर की चेतावनी बताती है कि कोई कीमत कॉन्फ़िगर नहीं है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है। कारण Log फ़ील्ड में देखने के लिए Debug log चालू करें।

ग्राहकों को पार्सल बॉक्स की सूची नहीं दिखती: सूची तभी आती है जब API key और API secret दोनों भरे हों, देश स्वीडन, फ़िनलैंड, डेनमार्क, नीदरलैंड या बेल्जियम हो, और एक पोस्टल कोड डाला गया हो। आखिरी API त्रुटि सेटिंग्स के ऊपर दिखती है। विवरण मॉड्यूल पेज पर Log फ़ील्ड में हैं। अधिक जानकारी के लिए Debug log चालू करें।

लॉग में HTTP 401 या 403: Budbee ने API key या secret को अस्वीकार किया। उन्हें जाँचें, और सुनिश्चित करें कि Test environment आपके क्रेडेंशियल से मेल खाता है (staging क्रेडेंशियल केवल तब जब test environment चालू हो)।

किसी पोस्टल कोड के लिए बॉक्स नहीं: Budbee उस पोस्टल कोड को सेवा नहीं देता। ग्राहक कोई दूसरा पोस्टल कोड खोज सकता है या दूसरा शिपिंग तरीका चुन सकता है।

ग्राहक डिलीवरी चरण से आगे नहीं बढ़ सकता: सूची से पार्सल बॉक्स चुनना आवश्यक है, जब तक Budbee API तक पहुँच न हो। खोजे गए पोस्टल कोड की सूची में न होने वाला बॉक्स सेव नहीं होता, और ग्राहक को This parcel box is not in the Budbee list for the postal code. Please choose the parcel box again. दिखता है।

बदलाव के बाद पुरानी बॉक्स सूचियाँ: मॉड्यूल पेज पर Save पर क्लिक करें। इससे कैश की गई बॉक्स सूचियाँ साफ़ हो जाती हैं।

पेज कहता है कि Instabee कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया था। इसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें। यही बात The settings were saved, but the carrier could not be updated. संदेश पर लागू होती है। रीसेट से कैरियर की स्थिति बनी रहती है: जो कैरियर आपने बंद किया था, वह बंद रहता है।

अनइंस्टॉल

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

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