VibeFox Balikobot for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित)।

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

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 पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_balikobot-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_balikobot.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_balikobot-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए आपको Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Balikobot खोजें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।

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

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

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_balikobot.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Balikobot खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. OpenCart 3 के चरण 4 और 5 की तरह लाइसेंस कुंजी और सेटिंग्स दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

इंस्टॉल होने पर एक्सटेंशन चेकआउट और ऑर्डर के पिकअप पॉइंट के लिए एक टेबल बनाता है। जब तक आप Enable/Disable चालू करके सेव नहीं करते, तब तक यह विधि बंद रहती है। अनइंस्टॉल के बाद एक्सटेंशन दोबारा इंस्टॉल करने पर, आपकी रखी हुई Balikobot सेटिंग्स फिर से उपयोग होती हैं।

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

सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Balikobot > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। सेव करने के बाद आपको Settings saved. Cached rates and pickup points were cleared. दिखेगा। केवल इस एक्सटेंशन के लिए बदलाव की अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं।

कुछ त्रुटियाँ सेव को रोक देती हैं, और तब कुछ भी सेव नहीं होता: खाली या बहुत लंबा Name, ऐसा Sort Order जो पूर्ण संख्या नहीं है, या अज्ञात टैक्स क्लास या जियो ज़ोन। बाकी समस्याएँ चेतावनी के रूप में दिखती हैं, और बाकी सेटिंग्स सेव हो जाती हैं: जो मान संख्या नहीं है (या ऋणात्मक है) वह सेव नहीं होता और चेतावनी फ़ील्ड का नाम बताती है। अमान्य Country prices पंक्तियाँ हटा दी जाती हैं और सूचीबद्ध की जाती हैं।

ऐसी सेटिंग्स के बारे में चेतावनियाँ, जो विधि, लाइव दरों या पिकअप पॉइंट को छिपा देंगी, पेज के ऊपर दिखती हैं: API उपयोगकर्ता या API कुंजी के बिना लाइव दरें या पिकअप पॉइंट, Exchange rate के बिना CZK से अलग स्टोर मुद्रा, निश्चित मूल्य या फ़ॉलबैक मोड में खाली Country prices, और ऐसा स्टोर जिसमें kg इकाई वाला वज़न क्लास नहीं है (तब उत्पादों का वज़न इकाई के नाम से पढ़ा जाता है: kg, g, lb या oz)।

सामान्य

Enable/Disable: चेकआउट पर Balikobot शिपिंग चालू या बंद करता है। डिफ़ॉल्ट: बंद।

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

Sort Order: शिपिंग विधियों की सूची में इस विधि की स्थिति। एक पूर्ण संख्या।

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: देशों और मूल्यों की सूची। पंक्ति जोड़ने के लिए Add row पर क्लिक करें, और किसी पंक्ति को हटाने के लिए हटाने वाले बटन पर। अपनी पंक्ति न रखने वाले सभी देशों के लिए * All other countries चुनें। दशमलव के लिए बिंदु या अल्पविराम चल सकता है। निश्चित मोड में और API फ़ॉलबैक के रूप में उपयोग होता है। जिस देश का मूल्य नहीं है (और * पंक्ति भी नहीं है), उसके लिए कोई निश्चित दर नहीं होती, इसलिए विधि उस देश के लिए छिपी रहती है।

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

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

शर्तें

Min weight (kg): जब कार्ट इससे हल्की हो तो विधि छिपाएँ। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)। उत्पादों का वज़न उनकी OpenCart वज़न क्लास से बदला जाता है।

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

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

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

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

Tax Class: इस क्लास का कर शिपिंग मूल्य में जुड़ता है। Balikobot मूल्य आमतौर पर VAT के बिना होते हैं। डिफ़ॉल्ट: --- None ---।

उपलब्धता

आमतौर पर यह विधि यहाँ चुने गए जियो ज़ोन में दी जाती है (All Zones का अर्थ है हर जगह)। Ignore geo zone इसके बजाय सूची के देशों में इसे देता है।

Geo Zone: यह विधि केवल इस जियो ज़ोन के पतों के लिए दें। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं।

Ignore geo zone: नीचे दिए देशों में, जियो ज़ोन की परवाह किए बिना, विधि दें।

Countries: इस मोड के गंतव्य देश। सभी देशों की अनुमति के लिए खाली छोड़ें। यह केवल Ignore geo zone के साथ उपयोग होता है।

पिकअप पॉइंट

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

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

उन्नत

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

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

Remove data on uninstall: चालू होने पर एक्सटेंशन को अनइंस्टॉल करने से सेटिंग्स, लॉग और बिना ऑर्डर वाले चेकआउट के पिकअप पॉइंट हट जाते हैं। बंद होने पर (डिफ़ॉल्ट) सेटिंग्स रखी जाती हैं। ऑर्डर में सेव किए गए पिकअप पॉइंट हमेशा रखे जाते हैं।

आयात / निर्यात

Export: सेटिंग्स को JSON फ़ाइल के रूप में सेव करने के लिए Download JSON पर क्लिक करें। API कुंजी निर्यात नहीं होती।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मानों की जाँच सामान्य सेव की तरह होती है। सेव की गई API कुंजी बनी रहती है।

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से Balikobot का मूल्य माँगता है। यदि Geo Zone सेट है (और Ignore geo zone बंद है) और पता उसके बाहर है, तो Balikobot नहीं दिया जाता। Ignore geo zone चालू होने पर Countries सूची तय करती है। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। इसके बाद एक्सटेंशन कार्ट का वज़न और Minimum order amount जाँचता है। ऑर्डर राशि उन उत्पादों का मूल्य है जिन्हें शिप करना है, कूपन छूट के बाद और कर से पहले। यदि मुफ़्त शिपिंग लागू होती है, तो मूल्य 0 होता है और Balikobot को कोई अनुरोध नहीं जाता।

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

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

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

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Balikobot चुनता है। यह विधि OpenCart 3 की तरह ही काम करती है; पिकअप पॉइंट सूची का वर्णन पिकअप पॉइंट में किया गया है।

पिकअप पॉइंट

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

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

OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है। Shipping method options विंडो में Balikobot विधि के नीचे पिकअप पॉइंट सूची दिखती है, उन्हीं पाठों और जाँचों के साथ। विंडो हर बार खुलने पर सूची लोड होती है, क्योंकि उसी चेकआउट पेज पर पता बदल सकता है, और जहाँ संभव हो वहाँ कैश से आती है। यदि ग्राहक विंडो में बिना मान्य पॉइंट के Continue पर क्लिक करता है, तो संदेश चेकआउट पेज के ऊपर दिखता है और विंडो खुली रहती है। OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और हर पुष्टि पर उसे अपडेट करता है; ऑर्डर का पिकअप पॉइंट भी उसी के साथ अपडेट होता है।

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

एडमिन ऑर्डर पेज (Sales > Orders, View) पर Balikobot pickup point पैनल पॉइंट, उसकी Balikobot ID और कैरियर दिखाता है, जो Balikobot में शिपमेंट बनाते समय चाहिए। Change पर क्लिक करें, ऑर्डर पते के पास कोई दूसरा पॉइंट चुनें और Save पर क्लिक करें। ऑर्डर की शिपिंग विधि का टेक्स्ट भी अपडेट होता है, और आपको Pickup point updated. दिखता है। पॉइंट बदलने के लिए केवल ऑर्डर बदलने की अनुमति चाहिए, एक्सटेंशन सेटिंग्स तक पहुँच नहीं। यदि किसी ऑर्डर में पॉइंट नहीं है, तो पैनल No pickup point was selected for this order. दिखाता है। Balikobot बंद होने पर भी पैनल काम करता है: मौजूदा ऑर्डर अपना पिकअप पॉइंट डेटा रखते हैं, और आप फिर भी पॉइंट बदल सकते हैं।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। Extensions > Extensions > Shipping > VibeFox Balikobot > Edit पेज पर पहला ब्लॉक लाइसेंस ब्लॉक License — VibeFox Balikobot है, जो सेटिंग्स के ऊपर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) दिखती है, और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-shipping-balikobot वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल इस एक्सटेंशन के लिए Modify अनुमति वाले एडमिन उपयोगकर्ता कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन आखिरी ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया गया स्टोर का पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Balikobot नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में यह विधि अब भी दिखती है, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना यह विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

चेकआउट पर Balikobot नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। एक्सटेंशन पेज के ऊपर की चेतावनियाँ पढ़ें। Geo Zone (या Ignore geo zone और Countries), वज़न सीमाएँ और Minimum order amount जाँचें। निश्चित मोड में, जाँचें कि देश या * All other countries का मूल्य है। जाँचें कि उत्पादों में Requires Shipping Yes पर है।

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

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

क्या VAT शामिल है: Balikobot मूल्य आमतौर पर VAT के बिना होते हैं। Tax Class चुनने पर OpenCart शिपिंग पर कर जोड़ता है।

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

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

पेज कहता है "Warning: You do not have permission to modify VibeFox Balikobot!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_balikobot (OpenCart 3) या extension/vfd_balikobot/shipping/vfd_balikobot (OpenCart 4) के लिए बदलाव की अनुमति दें।

डेवलपर्स के लिए: Balikobot API पता सेटिंग vfd_blkb_api_url (परीक्षण के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसका कोई फ़ील्ड नहीं है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox Balikobot के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart हमेशा Enable/Disable, Sort Order, Tax Class और Geo Zone रीसेट करता है। कैश की गई दरें और पिकअप पॉइंट हमेशा हटा दिए जाते हैं, और पिकअप पॉइंट पैनल और चेकआउट सूची काम करना बंद कर देते हैं। यदि Remove data on uninstall चालू है, तो सेटिंग्स, लॉग और बिना ऑर्डर वाले चेकआउट के पिकअप पॉइंट भी हटा दिए जाते हैं। यदि बंद है, तो बाकी सेटिंग्स रखी जाती हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर से उपयोग होती हैं। ऑर्डर में सेव किए गए पिकअप पॉइंट का डेटा कभी नहीं हटता, और मौजूदा ऑर्डर की शिपिंग विधि का टेक्स्ट पिकअप पॉइंट को बनाए रखता है।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Balikobot के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

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