VibeFox Jadlog for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का।

Jadlog अनुबंध (लाइव कीमतों और Pickup पॉइंट्स के लिए): लाइव कीमतें और Pickup पॉइंट्स की सूची Jadlog Embarcador API से आती है। अनुबंध पर हस्ताक्षर होने के बाद आपका Jadlog फ़्रैंचाइज़ी पहुँच जारी करता है। आपको Embarcador API टोकन, अनुबंध में दर्ज प्रेषक का CNPJ (या CPF), चालू खाता (conta corrente) और, अगर आपके पास है, अनुबंध नंबर चाहिए। अगर आप केवल निश्चित कीमतें उपयोग करते हैं, तो आपको Jadlog अनुबंध की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. API टोकन चिपकाएँ, CNPJ, चालू खाता, अनुबंध नंबर और मूल CEP दर्ज करें, Jadlog सेवा चुनें, और अगर आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL नहीं है तो BRL विनिमय दर दर्ज करें। चाहें तो निश्चित कीमतें या फ़ॉलबैक लागत जोड़ें (कॉन्फ़िगरेशन देखें)।

6. Enable Jadlog home delivery, Enable Jadlog Pickup या दोनों चालू करें, और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

इंस्टॉल के बाद, दोनों विकल्प चालू करके सेव करने तक बंद रहते हैं। अगर अनइंस्टॉल के बाद आप एक्सटेंशन फिर से इंस्टॉल करते हैं, तो आपकी रखी हुई Jadlog सेटिंग्स फिर से उपयोग होती हैं।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Jadlog > Edit। ये सेटिंग्स दोनों Jadlog विकल्पों पर लागू होती हैं। सेक्शन बाईं ओर सूचीबद्ध हैं। एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव से कैश की गई Jadlog कीमतें और Pickup पॉइंट सूचियाँ भी साफ़ हो जाती हैं। केवल वे एडमिन उपयोगकर्ता जिनके पास इस एक्सटेंशन के लिए संशोधन की अनुमति है, सेटिंग्स सेव कर सकते हैं।

पेज के ऊपर एक्सटेंशन अधूरी सेटअप के लिए चेतावनियाँ दिखाता है: कोई API टोकन नहीं (केवल निश्चित कीमतें उपयोग होती हैं, और Pickup पॉइंट्स सूचीबद्ध नहीं हो सकते), कोई API टोकन और कोई निश्चित कीमत नहीं (विधि कभी नहीं दिखती), कोई CNPJ या चालू खाता नहीं, कोई मूल CEP नहीं, BRL में बेचने वाले न होने वाले स्टोर के लिए BRL विनिमय दर नहीं, और स्टोर में "kg" वज़न वर्ग या "cm" लंबाई वर्ग नहीं (तब वज़न और आयाम उनके वर्ग के इकाई नाम से बदले जाते हैं; System > Localisation > Weight Classes और Length Classes जाँचें)।

सेव करते समय, किसी एक विकल्प का अमान्य शीर्षक (खाली, 64 अक्षरों से लंबा या < > ; = # { } वाला), Sort order जो पूर्ण संख्या नहीं है, या कोई ऐसी टैक्स क्लास या जियो ज़ोन जो मौजूद नहीं है, सेव को त्रुटि के साथ रोक देता है। अन्य गलत मान सेटिंग्स के ऊपर एक टिप्पणी के साथ सेव होते हैं: अमान्य या 0 से कम संख्या सेव नहीं होती, न्यूनतम वज़न अधिकतम से बड़ा हो तो दोनों सहेजे गए वज़न बने रहते हैं, जो BRL विनिमय दर धनात्मक संख्या नहीं है वह साफ़ हो जाती है, 8 अंकों से कम CEP या 14 अंकों से कम CNPJ (CPF के लिए 11) जैसा दर्ज है वैसा ही चेतावनी के साथ सेव होता है, और कीमत टेबल में अज्ञात देश वाली पंक्ति हटा दी जाती है तथा अमान्य कीमत खाली छोड़ दी जाती है।

सामान्य

Jadlog के दो डिलीवरी विकल्प हैं: Jadlog home delivery (यह सेक्शन) और Jadlog Pickup (अपना अलग सेक्शन)। इस पेज की सेटिंग्स दोनों पर लागू होती हैं।

Enable Jadlog home delivery: नीचे चुनी गई सेवा के साथ ग्राहक के पते तक Jadlog डिलीवरी देता है। डिफ़ॉल्ट: off।

Method title: चेकआउट पर ग्राहक को दिखने वाले घर तक डिलीवरी विकल्प का नाम। डिफ़ॉल्ट: Jadlog। अनिवार्य, अधिकतम 64 अक्षर।

Sort order: चेकआउट पर शिपिंग विधियों के बीच Jadlog की स्थिति। एक पूर्ण संख्या।

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। Jadlog की कीमतें अंतिम वाहक कीमतें हैं। अगर OpenCart को उन पर टैक्स नहीं जोड़ना है, तो No tax चुनें। यह दोनों विकल्पों पर लागू होता है।

Jadlog लाइव कीमतें

लाइव कीमतें केवल ब्राज़ील के उन पतों के लिए माँगी जाती हैं जिनका पूरा 8-अंकीय CEP है।

API token: Jadlog का Embarcador टोकन। इसे "Bearer" शब्द के साथ या उसके बिना चिपकाया जा सकता है। केवल निश्चित कीमतें उपयोग करने के लिए इसे खाली छोड़ें। सेव के बाद फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। बदलने के लिए ही नया मान दर्ज करें। कोई टोकन सहेजा न होने पर पेज No token saved. दिखाता है।

Remove the saved API token: इसे चिह्नित करें और सहेजे गए टोकन को हटाने के लिए Save पर क्लिक करें।

CNPJ: Jadlog अनुबंध में दर्ज प्रेषक का CNPJ (14 अंक) या CPF (11 अंक), उदाहरण के लिए 00.000.000/0000-00।

Current account (conta corrente): आपका Jadlog चालू खाता नंबर। इसके और CNPJ के बिना Jadlog कोट नहीं कर सकता और केवल निश्चित कीमतें उपयोग होती हैं।

Contract number: आपका Jadlog अनुबंध नंबर, अगर आपकी फ़्रैंचाइज़ी ने आपको एक दिया है।

Origin CEP: वह पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, 8 अंक (00000-000)। लाइव कीमतों के लिए आवश्यक: OpenCart में स्टोर का पोस्टकोड नहीं होता, इसलिए इस फ़ील्ड के बिना केवल निश्चित कीमतें उपयोग होती हैं।

Jadlog service: घर तक डिलीवरी के लिए आपके अनुबंध की सेवा (modalidade): .Package (3, डिफ़ॉल्ट), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12) या Emergencial (14)। Jadlog Pickup (40) दूसरा विकल्प है।

Insurance type: आपके Jadlog अनुबंध में तय के अनुसार Normal (N) (डिफ़ॉल्ट) या Own insurance policy (A - apolice)।

Volumetric weight: Jadlog वास्तविक और आयतनी वज़न में से बड़ा वज़न लेता है।

BRL exchange rate: Jadlog ब्राज़ीलियाई रियाल में कोट करता है। अगर आपके स्टोर की डिफ़ॉल्ट मुद्रा BRL है, तो यह फ़ील्ड ज़रूरी नहीं है। अन्यथा दर्ज करें कि 1 BRL आपकी डिफ़ॉल्ट मुद्रा में कितना है, उदाहरण के लिए 0.16। Jadlog की कीमत इस दर से गुणा होती है, और Jadlog को भेजा गया घोषित ऑर्डर मूल्य वापस BRL में बदला जाता है। दर के बिना लाइव कीमतें उपयोग नहीं होतीं और केवल निश्चित कीमतें लागू होती हैं।

Delivery time: चेकआउट पर घर तक डिलीवरी विकल्प के शीर्षक के बगल में, और हर Pickup पॉइंट के बगल में, Jadlog द्वारा लौटाया गया डिलीवरी समय दिखाता है (उदाहरण के लिए "Jadlog (3 business days)")। डिफ़ॉल्ट रूप से चालू। डिलीवरी समय हमेशा ऑर्डर के साथ सेव होता है।

Jadlog Pickup

Jadlog Pickup सेवा के साथ दूसरा डिलीवरी विकल्प। इसे API टोकन चाहिए। बिना पॉइंट्स के यह विकल्प छिपा रहता है।

Enable Jadlog Pickup: चेकआउट पर चुने गए Jadlog Pickup पॉइंट तक डिलीवरी देता है। डिफ़ॉल्ट: off।

Jadlog Pickup title: चेकआउट पर इस विकल्प का नाम। डिफ़ॉल्ट: Jadlog Pickup। अनिवार्य, अधिकतम 64 अक्षर।

Points to show: कितने Pickup पॉइंट्स दिखाने हैं, 1 से 10 तक। डिफ़ॉल्ट: 5।

निश्चित कीमतें (जब API टोकन न हो, उन देशों के लिए जहाँ Jadlog सेवा नहीं देता, और जब भी Jadlog कोई कीमत न लौटाए, तब उपयोग होती हैं)

Price per country: स्टोर की डिफ़ॉल्ट मुद्रा में Country, Price, XS, S, M, L और XL कॉलम वाली टेबल। पंक्ति जोड़ने के लिए Add country पर क्लिक करें और हटाने के लिए × बटन। साइज़ कॉलम कार्ट के वज़न से चुना जाता है: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक, XL 5 kg से ऊपर। साइज़ कॉलम खाली हो तो Price उपयोग होता है। कीमत 0 का अर्थ है उस देश के लिए मुफ़्त शिपिंग। बाकी सभी देशों के लिए * Default (other countries) उपयोग करें।

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

Fixed price applies: Per order (डिफ़ॉल्ट) कीमत एक बार लेता है। Per item (price x quantity) इसे कार्ट के आइटमों की संख्या से गुणा करता है। यह केवल निश्चित कीमतों और फ़ॉलबैक लागत पर लागू होता है। Jadlog की कीमतें पूरे कार्ट को पहले से कवर करती हैं।

शर्तें

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

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

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

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

उपलब्धता

Geo zone: Jadlog केवल इस जियो ज़ोन के पतों के लिए दें। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जब Ignore shipping zones चालू हो, तब जियो ज़ोन की जाँच नहीं होती। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं।

Ignore shipping zones: चालू होने पर Geo zone की जाँच नहीं होती और नीचे के देशों के लिए Jadlog दिया जाता है। बंद होने पर (डिफ़ॉल्ट), केवल Geo zone लागू होता है।

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

उन्नत

Debug log: हर Jadlog अनुरोध और प्रतिक्रिया को storage/logs/vfd_jdlg_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_jdlg_debug.log.php) में लॉग करता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ और बिना पॉइंट वाले Jadlog Pickup ऑर्डर इस विकल्प के बंद होने पर भी हमेशा लॉग होते हैं। टोकन, CNPJ और खाता कभी लॉग नहीं होते, और ग्राहक का CEP छोटा कर दिया जाता है। काम पूरा होने पर लॉग बंद कर दें।

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

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

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

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

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

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से हर Jadlog विकल्प की कीमत माँगता है: घर तक डिलीवरी और Jadlog Pickup एक Jadlog विधि के अंतर्गत दो विकल्पों के रूप में दिखते हैं। Ignore shipping zones चालू होने पर, Jadlog केवल तभी दिया जाता है जब देश की अनुमति हो (जियो ज़ोन की जाँच नहीं होती)। अन्यथा, अगर Geo zone सेट है और पता उसके बाहर है, तो Jadlog नहीं दिया जाता। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। ऑर्डर राशि, कूपन छूट के बाद और टैक्स से पहले, शिपिंग की ज़रूरत वाले उत्पादों की कीमत है। एक्सटेंशन कार्ट वज़न और न्यूनतम ऑर्डर राशि की जाँच करता है। अगर उप-योग Free shipping from तक पहुँचता है, तो डिलीवरी मुफ़्त होती है और Jadlog को कीमत का अनुरोध नहीं भेजा जाता।

ब्राज़ील के किसी डिलीवरी पते के लिए जिसका पूरा 8-अंकीय CEP है, एक्सटेंशन Jadlog को मूल और गंतव्य CEP, वज़न, आपका CNPJ, चालू खाता, अनुबंध, सेवा, बीमा प्रकार और घोषित ऑर्डर मूल्य भेजता है। उत्पादों के वज़न को उनके OpenCart वज़न वर्ग से kg में, और आयामों को उनके लंबाई वर्ग से cm में बदला जाता है। बिना वज़न वाले कार्ट को 0.1 kg माना जाता है। लौटाई गई कीमत आपकी डिफ़ॉल्ट मुद्रा में बदली जाती है, उसके दशमलव अंकों तक पूर्णांकित होती है, और चुने गए Tax class के टैक्स के साथ ग्राहक की मुद्रा में दिखाई जाती है। अगर कोई लाइव कीमत नहीं है (कोई टोकन नहीं, ब्राज़ील के बाहर का पता, अधूरा CEP, BRL दर नहीं, Jadlog की त्रुटि), तो एक्सटेंशन Price per country टेबल का उपयोग करता है, फिर Fallback cost। अगर इनमें से कोई भी कीमत नहीं देता, तो उस कार्ट के लिए विकल्प छिप जाता है।

हर कीमत 1 घंटे के लिए कैश होती है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट के लिए कैश होता है। अगर Jadlog जवाब नहीं देता, सर्वर त्रुटि लौटाता है, या टोकन अस्वीकार करता है, तो 10 मिनट तक API को दोबारा नहीं बुलाया जाता। API टाइमआउट 10 सेकंड है। ग्राहक को कभी API त्रुटि नहीं दिखती। कारण लॉग में लिखा जाता है।

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

एक्सटेंशन केवल कीमतों की गणना करता है और केवल Pickup पॉइंट्स सूचीबद्ध करता है। यह Jadlog शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, कलेक्शन का अनुरोध नहीं करता, शिपमेंट रद्द नहीं करता या पार्सल ट्रैक नहीं करता। यह Pickup पॉइंट्स का मैप नहीं दिखाता और Jadlog से अंतरराष्ट्रीय कोट नहीं माँगता। अन्य देशों के लिए निश्चित कीमतें उपयोग करें।

पिकअप पॉइंट

Jadlog Pickup विकल्प केवल ब्राज़ील के पतों के लिए दिया जाता है, और केवल तब जब Enable Jadlog Pickup चालू हो और API टोकन सहेजा गया हो। जब ग्राहक पूरा 8-अंकीय CEP दर्ज कर देता है, तो एक्सटेंशन Jadlog से उसके सबसे नज़दीकी सक्रिय Pickup पॉइंट्स माँगता है और विकल्प के नीचे Points to show तक पॉइंट्स सूचीबद्ध करता है, हर एक अपनी कीमत के साथ, जैसे "पॉइंट का नाम — कीमत (3 business days) — पता"। अगर सूची अभी कैश नहीं है, तो ग्राहक के Jadlog Pickup चुनने पर उसे बैकग्राउंड में लोड किया जाता है, ताकि डिलीवरी विधि चरण Jadlog का इंतज़ार न करे।

हर पॉइंट की कीमत Jadlog से माँगी जाती है। अगर Jadlog किसी पॉइंट के लिए कोई कीमत नहीं देता, तो निश्चित कीमत उपयोग होती है, और जिस पॉइंट की कोई कीमत नहीं है वह छोड़ दिया जाता है। पॉइंट सूचियाँ 12 घंटे के लिए कैश होती हैं। विकल्प की कीमत चुने गए पॉइंट की कीमत होती है। पॉइंट चुने जाने से पहले, यह सबसे नज़दीकी उस पॉइंट की कीमत होती है जिसकी कीमत है। ग्राहक के पॉइंट चुनने के बाद, Jadlog Pickup के बगल में दिखाई गई कीमत अपडेट होती है।

पॉइंट अनिवार्य है। अगर ग्राहक डिलीवरी विधि चरण में बिना पॉइंट के Continue पर क्लिक करता है, तो उसे Please select a Jadlog Pickup point. दिखता है। एक्सटेंशन सर्वर पर जाँचता है कि वह पॉइंट डिलीवरी CEP के लिए Jadlog सूची में है। अगर नहीं है, तो ग्राहक को The selected Jadlog Pickup point is not in the Jadlog list for this CEP. Please choose the point again. दिखता है। अगर CEP अधूरा है, आसपास कोई पॉइंट नहीं है, या Jadlog उपलब्ध नहीं है, तो विकल्प के नीचे एक संदेश दिखाया जाता है।

API टोकन के बिना, Jadlog उपलब्ध न होने पर, या आसपास कोई सक्रिय पॉइंट न होने पर, Jadlog Pickup विकल्प छिप जाता है। बिना पॉइंट वाला ऑर्डर भेजा नहीं जा सकता।

OpenCart 4 पर Pickup पॉइंट्स की सूची Shipping method options विंडो में, Jadlog Pickup विकल्प के नीचे दिखती है। यह बैकग्राउंड में लोड होती है, पहले कैश से और फिर Jadlog से बाकी पॉइंट्स की कीमतों के साथ। ग्राहक पॉइंट चुनने के बाद विंडो में Jadlog Pickup के बगल की कीमत अपडेट होती है। विंडो का Continue बटन वैध पॉइंट के बिना आगे नहीं बढ़ता, और वही संदेश दिखते हैं।

ऑर्डर

जब Jadlog विकल्प के साथ ऑर्डर दिया जाता है, तो एक्सटेंशन Jadlog सेवा सहेजता है और, अगर Jadlog ने लौटाया हो, तो कार्य-दिवसों में डिलीवरी समय भी। Jadlog Pickup ऑर्डर के लिए यह पॉइंट का नाम, पता और ID भी सहेजता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और ग्राहक हर बार दोबारा पुष्टि करने पर उसे अपडेट करता है; ऑर्डर का Jadlog डेटा उसी के साथ अपडेट होता है। अगर ग्राहक उस ऑर्डर को किसी दूसरी शिपिंग विधि पर बदल देता है, तो उसका Jadlog डेटा हटा दिया जाता है।

पॉइंट, विकल्प के शीर्षक के बाद, ऑर्डर की शिपिंग विधि में जुड़ जाता है, उदाहरण के लिए Jadlog Pickup:, उसके बाद पॉइंट का नाम और पता। यह पाठ एडमिन और ग्राहक खाते के ऑर्डर पेजों, ऑर्डर ईमेल और इनवॉइस पर दिखता है।

एडमिन ऑर्डर पेज (Sales > Orders) पर Jadlog पैनल दिखता है, जिसमें Jadlog service, Delivery time और Jadlog Pickup के लिए Pickup point, Pickup point address और Pickup point ID होते हैं। OpenCart 4 पर यह पैनल History के ऊपर दिखता है।

शिपमेंट Jadlog सिस्टम में स्वयं बुक करें। ऑर्डर उस सेवा और Pickup पॉइंट ID को दिखाता है जिसकी आपको ज़रूरत है।

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

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

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

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

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

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

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

चेकआउट पर Jadlog दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Jadlog home delivery (या Enable Jadlog Pickup) चालू है। Geo zone जाँचें, या Ignore shipping zones चालू करके Countries जाँचें। एक्सटेंशन पेज के ऊपर की चेतावनियाँ, वज़न सीमाएँ, Minimum order amount और यह जाँचें कि उत्पादों का Requires Shipping Yes पर सेट है। अगर ग्राहक ने अभी तक पूरा 8-अंकीय CEP दर्ज नहीं किया है, तो केवल निश्चित कीमतें उपयोग हो सकती हैं, इसलिए Price per country पंक्ति या Fallback cost जोड़ें।

केवल निश्चित कीमतें दिखती हैं: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: कोई CNPJ या चालू खाता नहीं, कोई मूल CEP नहीं, गंतव्य CEP अधूरा है, कोई BRL विनिमय दर नहीं, या Jadlog की त्रुटि का संदेश।

लॉग में HTTP 401 या 403: Jadlog ने API टोकन अस्वीकार किया। इसे अपने Jadlog फ़्रैंचाइज़ी से जाँचें। इस त्रुटि के बाद API 10 मिनट के लिए रुक जाता है। सेटिंग्स सेव करने से यह रुकावट हट जाती है, इसलिए आप तुरंत फिर से कोशिश कर सकते हैं।

Pickup पॉइंट्स दिखाई नहीं देते: Jadlog Pickup विकल्प के लिए Enable Jadlog Pickup, API टोकन और ब्राज़ील में पूरा 8-अंकीय CEP चाहिए। अगर CEP के पास Jadlog का कोई सक्रिय पॉइंट नहीं है, तो विकल्प छिप जाता है। कारण के लिए लॉग देखें।

कीमतें मेरी मुद्रा के बजाय रियाल में हैं: BRL exchange rate दर्ज करें (1 BRL आपके स्टोर की डिफ़ॉल्ट मुद्रा में कितना है)।

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

Jadlog कीमतों पर टैक्स जुड़ रहा है: Tax class को No tax पर सेट करें।

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

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

अनइंस्टॉल

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

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

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