VibeFox Balikobot for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Balikobot खाता (लाइव दरों और पिकअप पॉइंट के लिए): आपको API एक्सेस वाला Balikobot खाता चाहिए। API उपयोगकर्ता और API कुंजी Balikobot क्लाइंट ज़ोन (client.balikobot.cz) में मिलते हैं। Balikobot सपोर्ट (podpora@balikobot.cz) आपके खाते और कैरियर के लिए API सक्रिय करता है। लाइव दरों के लिए ऐसा कैरियर और सेवा चाहिए जिसके लिए Balikobot "transportcosts" सपोर्ट करता हो। पिकअप पॉइंट के लिए ऐसा कैरियर चाहिए जो "branchlocator" सपोर्ट करता हो (उदाहरण के लिए Česká pošta, Zásilkovna, PPL, DPD, GLS)। यदि आप निश्चित न हों तो Balikobot सपोर्ट से पूछें। निश्चित मूल्य बिना खाते के काम करते हैं।

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

इंस्टॉलेशन

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

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

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

4. API उपयोगकर्ता और API कुंजी दर्ज करें, कैरियर और सेवा प्रकार, मूल्य स्रोत और देश के अनुसार मूल्य चुनें (देखें कॉन्फ़िगरेशन)। पिकअप सेवाओं के लिए Pickup point selection चालू करें। Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल Delivery by Balikobot डिलीवरी समय टेक्स्ट के साथ Balikobot कैरियर बनाता है। कैरियर को चेक गणराज्य, स्लोवाकिया और हंगरी के ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ मूल्य सेट न करें: मूल्य हमेशा मॉड्यूल से आता है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Balikobot > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। सहेजने के बाद आपको Settings saved. Cached rates and pickup points were cleared. दिखेगा। पेज के ऊपर उन सेटिंग्स की चेतावनियाँ दिखती हैं जो कैरियर, लाइव दरों या पिकअप पॉइंट को छिपा देंगी: API उपयोगकर्ता या API कुंजी के बिना लाइव दरें या पिकअप पॉइंट, Exchange rate के बिना CZK से भिन्न दुकान मुद्रा, निश्चित मूल्यों या फ़ॉलबैक के साथ खाली Country prices, दुकान की ऐसी वज़न इकाई जिसे मॉड्यूल नहीं पहचानता (तब वज़न kg माना जाता है; kg, g, lb या oz का उपयोग करें), और हटाया गया कैरियर। जो मान संख्या नहीं है वह सहेजा नहीं जाता, और फ़ील्ड का नाम बताते हुए चेतावनी दिखती है।

General

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

Name: ग्राहक को दिखने वाला शिपिंग विधि का नाम (कैरियर का नाम)। डिफ़ॉल्ट: Balikobot। आवश्यक, अधिकतम 64 अक्षर।

Tax status: None, या आपके किसी टैक्स नियम के साथ Taxable। टैक्स नियम चुनने पर उसका टैक्स शिपिंग मूल्य में जुड़ जाता है। यह चुनाव कैरियर में सहेजा जाता है। Balikobot की कीमतें आम तौर पर बिना VAT के होती हैं। डिफ़ॉल्ट: None।

Balikobot API खाता (लाइव दरों और पिकअप पॉइंट के लिए आवश्यक)

API user: क्लाइंट ज़ोन से आपका Balikobot API उपयोगकर्ता।

API key: क्लाइंट ज़ोन से आपकी Balikobot API कुंजी। सहेजने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. Clear the API user to remove the saved key. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Carrier: दरों और पिकअप पॉइंट के लिए उपयोग होने वाला Balikobot कैरियर: Česká pošta (डिफ़ॉल्ट), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) या Magyar Posta। यह आपके Balikobot खाते में सक्रिय होना चाहिए।

Service type: कैरियर का Balikobot सेवा कोड। डिफ़ॉल्ट: NP। Česká pošta के लिए: NP = डाकघर तक पार्सल, NB = Balíkovna तक पार्सल, DR = घर तक डिलीवरी। अन्य कैरियर के कोड Balikobot क्लाइंट ज़ोन और API दस्तावेज़ में सूचीबद्ध हैं।

मूल्य (सभी मूल्य आपकी दुकान की डिफ़ॉल्ट मुद्रा में हैं)

Price source: मूल्य कैसे गणना किया जाता है।

Country prices: 2-अक्षर वाले देश कोड (जैसे CZ, SK) और मूल्यों की तालिका। देश जोड़ने के लिए Add row पर क्लिक करें और हटाने के लिए ट्रैश आइकन पर। बाकी सभी देशों के लिए देश कोड के रूप में * का उपयोग करें। दशमलव बिंदु या कॉमा से लिखे जा सकते हैं। यह निश्चित मोड में और API फ़ॉलबैक के रूप में उपयोग होता है। जिस देश का मूल्य नहीं है (और * वाली पंक्ति भी नहीं है), उसके लिए कोई निश्चित दर नहीं होती। अमान्य पंक्तियाँ सहेजते समय हटा दी जाती हैं, और एक चेतावनी उनकी सूची दिखाती है।

Fixed price per: Order मूल्य एक बार लेता है। Item (price x quantity) उसे कार्ट में आइटम की संख्या से गुणा करता है। यह केवल निश्चित मूल्यों पर लागू होता है। Balikobot की लाइव दर हमेशा पूरे पैकेज के लिए होती है।

Exchange rate: Balikobot मूल्य मुद्रा (आम तौर पर CZK) की 1 इकाई का आपकी दुकान की डिफ़ॉल्ट मुद्रा में मान, जैसे 0.04। केवल तभी उपयोग होता है जब Balikobot किसी अन्य मुद्रा में मूल्य लौटाए। ऐसे मूल्यों को अस्वीकार करने के लिए खाली छोड़ें, ताकि ग्राहक से कभी गलत राशि न ली जाए।

शर्तें

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

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

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

Free shipping: नीचे दी गई राशि से ऊपर मुफ़्त शिपिंग चालू करता है।

Free shipping from: वह कार्ट उप-योग (छूट के बाद, टैक्स के बिना) जिससे शिपिंग मुफ़्त है। इस स्थिति में API अनुरोध नहीं भेजा जाता।

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

आम तौर पर कैरियर Shipping > Carriers में अपने ज़ोन में पेश किया जाता है।

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

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

पिकअप पॉइंट

Pickup point selection: ग्राहक को पिकअप पॉइंट चुनना होगा। इसका उपयोग पिकअप सेवाओं के लिए करें, जैसे Česká pošta NP या NB, या Zásilkovna। इसके लिए API उपयोगकर्ता और API कुंजी चाहिए।

Selector width: पिकअप पॉइंट सूची की CSS चौड़ाई, जैसे 100% या 400px। डिफ़ॉल्ट: 100%।

उन्नत

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

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

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

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

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

निश्चित मोड में मूल्य Country prices से लिया जाता है। लाइव मोड में मॉड्यूल Balikobot को कैरियर, सेवा प्रकार, गंतव्य देश और पिन कोड, तथा kg में कार्ट का वज़न भेजता है। लाइव दर केवल तभी माँगी जाती है जब डिलीवरी पते में पिन कोड हो। किसी अन्य मुद्रा का मूल्य Exchange rate से परिवर्तित होता है, या यदि कोई दर सेट नहीं है तो अस्वीकार होता है। मूल्य आपकी डिफ़ॉल्ट मुद्रा में गणना किया जाता है और फिर ग्राहक की कार्ट मुद्रा में दिखाया जाता है।

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

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

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

पिकअप पॉइंट

Pickup point selection चालू होने पर, शिपिंग चरण में Balikobot कैरियर के नीचे पिकअप पॉइंट की सूची दिखती है। यह सूची डिलीवरी पते के देश, शहर और पिन कोड के लिए Balikobot "branchlocator" से लोड होती है। जब तक पते में शहर न हो, ग्राहक को Enter your city to see the pickup points. दिखता है। सूची 12 घंटे तक कैश होती है।

ग्राहक पॉइंट चुनते ही चयन कार्ट में सहेज लिया जाता है। यह चयन अनिवार्य है: शिपिंग चरण में Continue और Place order Please select a pickup point. के साथ ब्लॉक रहते हैं। सर्वर यह भी जाँचता है कि चुना गया पॉइंट डिलीवरी पते का है। अन्यथा ग्राहक को The selected pickup point is not available for your shipping address. Please choose a pickup point again. दिखता है। यदि कोई पॉइंट नहीं मिलता, तो ग्राहक से शहर और पिन कोड जाँचने या कोई अन्य शिपिंग विधि चुनने के लिए कहा जाता है। यदि पॉइंट लोड नहीं हो पाते, तो ग्राहक से बाद में फिर कोशिश करने या कोई अन्य शिपिंग विधि चुनने के लिए कहा जाता है।

चुना गया पिकअप पॉइंट ऑर्डर में सहेजा जाता है। बैक ऑफ़िस के ऑर्डर पेज पर यह Balikobot pickup point ब्लॉक में Balikobot शाखा ID और कैरियर के साथ दिखता है, जो Balikobot में शिपमेंट बनाते समय चाहिए। ऑर्डर के पते के पास कोई अन्य पॉइंट चुनने के लिए Change पर क्लिक करें और फिर Save पर क्लिक करें। पॉइंट बदलने के लिए केवल ऑर्डर संपादित करने का अधिकार चाहिए, मॉड्यूल पेज की पहुँच नहीं। यदि ऑर्डर में कोई पॉइंट नहीं है, तो ब्लॉक No pickup point was selected for this order. दिखाता है।

ग्राहक को ऑर्डर की पुष्टि पेज और ऑर्डर विवरण में पॉइंट Pickup point: के रूप में दिखता है। ऑर्डर पुष्टि ईमेल में और दुकान के लिए नए ऑर्डर ईमेल में (Mail alerts मॉड्यूल) यह कैरियर के नाम के बाद जोड़ा जाता है। मौजूदा ऑर्डर अपना पिकअप पॉइंट डेटा बनाए रखते हैं।

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

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

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

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

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

चेकआउट पर Balikobot नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। मॉड्यूल पेज के ऊपर की चेतावनियाँ पढ़ें। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है, या Ignore shipping zones चालू करके Countries जाँचें। वज़न सीमाएँ और Minimum order amount जाँचें। निश्चित मोड में जाँचें कि देश या * का मूल्य है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: API क्रेडेंशियल नहीं हैं, अभी पिन कोड नहीं है, कैरियर और सेवा के लिए Balikobot त्रुटि (जैसे authorization failed, API उपयोगकर्ता और API कुंजी जाँचें), या Exchange rate के बिना किसी अन्य मुद्रा का मूल्य। Live Balikobot rate, fixed price if the API fails के साथ, समस्या ठीक करते समय भी ग्राहकों को निश्चित मूल्य मिलता रहता है।

मूल्य गलत मुद्रा में हैं: निश्चित मूल्य आपकी दुकान की डिफ़ॉल्ट मुद्रा में हैं। Balikobot लाइव मूल्य आपके Balikobot अनुबंध की मुद्रा में लौटाता है (आम तौर पर CZK)। यदि वह आपकी डिफ़ॉल्ट मुद्रा से अलग है, तो Exchange rate सेट करें।

क्या VAT शामिल है: Balikobot मूल्य आम तौर पर बिना VAT के होते हैं। Tax status को किसी टैक्स नियम पर सेट करने पर PrestaShop शिपिंग का टैक्स जोड़ता है।

सूची में कोई पिकअप पॉइंट नहीं: जाँचें कि API उपयोगकर्ता और कुंजी सेट हैं, कैरियर "branchlocator" सपोर्ट करता है, और डिलीवरी पते में शहर और पिन कोड है। Balikobot त्रुटि के लिए लॉग देखें।

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

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

डेवलपर्स के लिए: मॉड्यूल के पास API पता (actionVfdBlkbApiUrl), "transportcosts" पैकेज (actionVfdBlkbTransportcostsPackage) और पिकअप पॉइंट की संख्या (actionVfdBlkbPickupMaxResults, डिफ़ॉल्ट 30) बदलने के लिए अपने हुक हैं।

अनइंस्टॉल

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

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