VibeFox Andreani for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित), डिफ़ॉल्ट थीम के साथ।

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

Andreani खाता (केवल लाइव दरों के लिए): लाइव दरें Andreani की कोट API का उपयोग करती हैं। Andreani बिज़नेस ग्राहकों को API क्रेडेंशियल, एक क्लाइंट कोड और अनुबंध संख्याएँ देता है, आमतौर पर लगभग 300 शिपमेंट प्रति माह से। developers.andreani.com देखें या ventapyme@andreani.com पर लिखें। आपको API उपयोगकर्ता नाम और पासवर्ड, क्लाइंट कोड (código de cliente) और अनुबंध संख्या चाहिए। Andreani हर सेवा (होम डिलीवरी, शाखा पिकअप) के लिए अलग अनुबंध जारी करता है। API एक्सेस के बिना तय कीमतों का उपयोग करें। शाखा चयनकर्ता क्रेडेंशियल के बिना काम करता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. नाम, दर स्रोत, देशवार कीमतें (जैसे AR=5000) और लाइव दरों के लिए API क्रेडेंशियल, क्लाइंट कोड और अनुबंध संख्या भरें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।

OpenCart 4

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

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

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

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

इंस्टॉल के बाद Enable/Disable और Enable second option बंद रहते हैं, और जब तक आप कोई विकल्प चालू करके Save नहीं करते, चेकआउट पर Andreani नहीं दिखता। अनइंस्टॉल के बाद दोबारा इंस्टॉल करने पर, आपकी रखी हुई Andreani सेटिंग्स फिर से उपयोग होती हैं, लेकिन दोनों विकल्प बंद रहते हैं: उन्हें चालू करें और Save पर क्लिक करें।

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

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

पेज के शीर्ष पर गायब सेटिंग्स के बारे में चेतावनियाँ दिखती हैं: बिना API उपयोगकर्ता नाम और पासवर्ड के या बिना अनुबंध संख्या के API दरें चुनी गई हैं, स्टोर की मुद्रा ARS न होने पर ARS exchange rate नहीं है, या Country prices में अर्जेंटीना की कोई कीमत नहीं है। यदि स्टोर की वज़न या लंबाई इकाई एक्सटेंशन को ज्ञात नहीं है, तो भी चेतावनी दिखती है (तब वज़न kg और आयाम cm माने जाते हैं)।

सहेजते समय खाली नाम, 64 अक्षरों से लंबा नाम या वह नाम जिसमें < > ; = # { } में से कोई अक्षर हो, Max weight (kg) से बड़ा Min weight (kg), या पूर्ण संख्या न होने वाला Sort order अस्वीकार हो जाता है और कुछ भी सहेजा नहीं जाता। ऐसा मान जो संख्या न हो, ऋणात्मक संख्या, या 0 या उससे कम ARS exchange rate सहेजा नहीं जाता, और एक चेतावनी फ़ील्ड का नाम बताती है।

सामान्य

Andreani के चेकआउट पर दो विकल्प हैं: मुख्य विकल्प, जो यहाँ और Andreani API तथा Delivery and rates में सेट होता है, और Second option। दोनों डिलीवरी विधि चरण में Andreani शीर्षक के नीचे दिखते हैं।

Enable/Disable: Andreani के मुख्य विकल्प को चालू या बंद करता है। डिफ़ॉल्ट: बंद। दूसरे विकल्प का अपना स्विच है।

Name: चेकआउट पर ग्राहक को दिखने वाला मुख्य विकल्प का नाम। डिफ़ॉल्ट: Andreani। अनिवार्य।

Tax status: None (the API rate is taken with IVA) (डिफ़ॉल्ट), या आपकी टैक्स क्लासों में से कोई एक। टैक्स क्लास होने पर OpenCart शिपिंग लागत पर टैक्स जोड़ता है, इसलिए API दर IVA के बिना ली जाती है। None होने पर API दर IVA सहित ली जाती है। दोनों विकल्पों पर लागू होता है।

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

Andreani API (लाइव दरों के लिए आवश्यक)

Environment: Sandbox / QA (apisqa.andreani.com) (डिफ़ॉल्ट) या Production (apis.andreani.com)। वह वातावरण चुनें जिससे आपके क्रेडेंशियल जुड़े हैं।

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

API password: आपका Andreani API पासवर्ड। सहेजने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. Clearing the API username removes it too. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Client code: Andreani द्वारा दिया गया क्लाइंट कोड (código de cliente), उदाहरण के लिए CL0000000।

Contract number: दरों के लिए उपयोग होने वाली सेवा का अनुबंध, उदाहरण के लिए होम डिलीवरी। दूसरा विकल्प कोई दूसरा अनुबंध उपयोग कर सकता है, उदाहरण के लिए शाखा पिकअप के लिए।

Origin branch code: कोट के लिए वैकल्पिक मूल शाखा (sucursalOrigen)। अपने अनुबंध में कॉन्फ़िगर की गई शाखा उपयोग करने के लिए इसे खाली छोड़ें।

डिलीवरी और दरें

Delivery modality: मुख्य विकल्प का डिलीवरी मोड। पहला भाग बताता है कि Andreani पार्सल कहाँ से उठाता है (आपका पता या वह शाखा जहाँ आप उसे देते हैं)। दूसरा भाग बताता है कि ग्राहक उसे कहाँ पाता है।

Rate source: कीमत कैसे गणना होती है।

Country prices: आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स के बिना, हर गंतव्य देश के लिए एक तय कीमत, प्रति पंक्ति एक देश, CC=PRICE प्रारूप में, उदाहरण के लिए AR=5000। यह तय मोड में और API विफल होने पर बैकअप के रूप में उपयोग होती है। जिन देशों की पंक्ति नहीं है, उनकी तय कीमत नहीं होती। दूसरे प्रारूप की पंक्तियाँ अनदेखी की जाती हैं, और सहेजते समय एक चेतावनी उन्हें सूचीबद्ध करती है।

ARS exchange rate: Andreani अर्जेंटीना पेसो में कोट करता है। केवल तभी ज़रूरी है जब आपके स्टोर की डिफ़ॉल्ट मुद्रा ARS न हो: आपकी स्टोर मुद्रा में 1 ARS की कीमत, उदाहरण के लिए 0.001। इसके बिना API दरें उपयोग नहीं होतीं।

Default product weight (kg): API से दरें माँगते समय और वज़न सीमाएँ जाँचते समय, बिना वज़न वाले उत्पादों के लिए उपयोग होता है। खाली का अर्थ है 0,5 kg।

Calculation type: Per order (डिफ़ॉल्ट) कीमत एक बार लेता है। Per item (price x number of items) Country prices की तय कीमत को कार्ट में आइटमों की संख्या से गुणा करता है। Andreani की लाइव दर पहले से पूरे कार्ट के लिए होती है और उसे गुणा नहीं किया जाता।

उपलब्धता

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

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

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

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

Ignore shipping zones: जियो ज़ोन चाहे जो भी हो, Andreani को नीचे दिए देशों के लिए दें। डिफ़ॉल्ट: बंद।

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

मुफ़्त शिपिंग

Free shipping: मुफ़्त शिपिंग की सीमा चालू करता है। डिफ़ॉल्ट: बंद।

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

दूसरा विकल्प

अपने नाम, डिलीवरी मोड और अनुबंध वाला दूसरा Andreani विकल्प, जैसे मुख्य विकल्प में "a domicilio" और यहाँ "retiro en sucursal", ताकि दोनों दिए जा सकें। बाकी सभी सेटिंग्स साझा होती हैं।

Enable second option: चेकआउट पर दूसरा विकल्प देता है। डिफ़ॉल्ट: बंद।

Second option name: चेकआउट पर इस विकल्प का नाम। डिफ़ॉल्ट: Andreani - branch pickup। अनिवार्य।

Delivery modality: Use global setting या चार मोड में से कोई एक। डिफ़ॉल्ट: Door to branch (Puerta a Sucursal)।

Contract number: Andreani हर सेवा (होम डिलीवरी, शाखा पिकअप) के लिए अलग अनुबंध जारी करता है। वैश्विक अनुबंध उपयोग करने के लिए इसे खाली छोड़ें।

शाखा चयनकर्ता (Door to branch और Branch to branch के लिए दिखाया जाता है)

Province select width: प्रांत सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 300px। डिफ़ॉल्ट: 100%।

Branch select width: शाखा सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 400px। डिफ़ॉल्ट: 100%।

उन्नत

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

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

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

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

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

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

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से हर सक्रिय Andreani विकल्प की कीमत माँगता है। यदि Geo zone सेट है और Ignore shipping zones बंद है, तो जियो ज़ोन के बाहर के पतों के लिए Andreani नहीं दिया जाता। केवल वे उत्पाद गिने जाते हैं जिनका Requires Shipping Yes पर सेट है: बाकी उत्पाद वज़न नहीं जोड़ते और उप-योग में शामिल नहीं होते। फिर एक्सटेंशन देश (जब Ignore shipping zones चालू हो), कार्ट का वज़न (उत्पादों का वज़न kg में बदला जाता है, बिना वज़न वाले उत्पाद Default product weight (kg) लेते हैं) और Minimum subtotal जाँचता है। उप-योग शिपिंग वाले उत्पादों की कीमत है, कूपन छूट के बाद और टैक्स से पहले।

तय मोड में कीमत Country prices से ली जाती है। लाइव दर मोड में एक्सटेंशन Andreani API में लॉग इन करता है और गंतव्य पिनकोड, अनुबंध, क्लाइंट कोड, kg में वज़न, उत्पाद आयामों से निकला आयतन, और घोषित मूल्य (ARS में कार्ट उप-योग) के साथ कोट माँगता है। लाइव दर केवल एक वैध अर्जेंटीना पिनकोड (4 अंक, या C1425ABC जैसा CPA) के लिए माँगी जाती है। स्टोर की मुद्रा ARS न होने पर ARS राशि को ARS exchange rate से बदला जाता है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है, उसके दशमलव स्थानों तक राउंड की जाती है, और चुने हुए Tax status के टैक्स के साथ ग्राहक की मुद्रा में दिखाई जाती है।

लॉगिन टोकन अधिकतम 23 घंटे रखा जाता है और Andreani के अस्वीकार करने पर अपने-आप नवीनीकृत होता है। कोट 1 घंटे तक कैश होते हैं। विफल API कॉल 5 मिनट तक दोबारा नहीं की जाती। यह सब OpenCart कैश में रहता है, इसलिए कोई प्रविष्टि OpenCart कैश की अवधि (डिफ़ॉल्ट 1 घंटा) से अधिक नहीं रहती और उसके बाद उसे फिर से माँगा जाता है। API त्रुटियाँ ग्राहक को कभी नहीं दिखाई जातीं: विकल्प छिप जाता है, या बैकअप मोड में तय कीमत उपयोग होती है। कारण लॉग में लिखा जाता है।

यदि Free shipping चालू है और कार्ट उप-योग Free shipping from तक पहुँचता है, तो कीमत 0 होती है। मुफ़्त शिपिंग केवल तभी लागू होती है जब विकल्प की कोई कीमत हो: यदि Andreani API कोई दर नहीं देता और बैकअप के लिए कोई तय कीमत नहीं है, तो विकल्प नहीं दिखाया जाता।

एक्सटेंशन Andreani शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता और पार्सल ट्रैक नहीं करता। इनके लिए Andreani वेब पोर्टल का उपयोग करें।

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

पिकअप पॉइंट

जब Door to branch या Branch to branch वाला विकल्प दिया जाता है, तो डिलीवरी विधि चरण में उसके ठीक नीचे एक प्रांत सूची और एक शाखा सूची दिखती है। प्रांत डिलीवरी पते के क्षेत्र के आधार पर पहले से चुना जाता है। शाखा सूची Andreani की सार्वजनिक शाखा API से आती है और अधिकतम 12 घंटे तक कैश होती है (OpenCart कैश की अवधि के भीतर)। जो शाखाएँ पार्सल नहीं सौंपतीं, वे सूची में नहीं आतीं। डिलीवरी चरण स्वयं कभी Andreani का इंतज़ार नहीं करता: यदि सूची अभी कैश में नहीं है, तो वह पृष्ठभूमि में लोड होती है और ग्राहक को थोड़ी देर Loading Andreani branches... दिखता है। यदि कोई शाखा उपलब्ध नहीं है, तो ग्राहक को No Andreani branches available right now. Please try again later or choose another shipping method. दिखता है।

चुनाव उसी समय सहेजा जाता है जब ग्राहक उसे चुनता है। केवल Andreani की वर्तमान सूची की शाखा स्वीकार की जाती है। शाखा के बिना डिलीवरी चरण में Continue आगे नहीं बढ़ता, और ग्राहक को Please select an Andreani pickup branch. दिखता है। ग्राहक के आगे बढ़ने पर सर्वर शाखा की दोबारा जाँच करता है। यदि शाखा सूची से हट गई है, तो ग्राहक को The selected Andreani branch is not available. Please choose another one. दिखता है।

OpenCart 4 पर प्रांत सूची और शाखा सूची विंडो Shipping method options में, Andreani शाखा विकल्प के ठीक नीचे दिखती हैं, उन्हीं पाठों और जाँचों के साथ। विंडो में शाखा के बिना Continue को Please select an Andreani pickup branch. के साथ विकल्प के नीचे रोका जाता है। यदि ग्राहक के आगे बढ़ने पर स्टोर शाखा अस्वीकार करता है, तो संदेश चेकआउट पेज के शीर्ष पर दिखता है और विंडो खुली रहती है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और हर पुष्टि पर उसे अपडेट करता है; ऑर्डर की शाखा भी उसी के साथ अपडेट होती है, और ग्राहक के किसी दूसरी शिपिंग विधि में बदलने पर वह हटा दी जाती है।

किसी Andreani विकल्प के तहत चुनी गई शाखा, किसी दूसरे विकल्प या दूसरी शिपिंग विधि से दिए गए ऑर्डर का हिस्सा नहीं होती।

यह चयनकर्ता OpenCart 3 की डिफ़ॉल्ट थीम के वन-पेज चेकआउट और OpenCart 4 की डिफ़ॉल्ट थीम के चेकआउट के लिए बना है। डिलीवरी चरण के अलग लेआउट वाली थीम में चयनकर्ता की स्क्रिप्ट में बदलाव करना पड़ सकता है।

ऑर्डर

ऑर्डर डिलीवरी मोड और, शाखा वाले मोड के लिए, चुनी गई शाखा सहेजता है।

Shipping method of the order: शाखा को शिपिंग विधि के पाठ में जोड़ा जाता है, जैसे Andreani - branch pickup: और शाखा का नाम। यदि विकल्प के नाम में शाखा का उल्लेख नहीं है, तो शाखा के नाम से पहले Pickup branch: (या यदि नाम में Andreani नहीं है तो Andreani pickup branch:) जोड़ा जाता है, जैसे Andreani - Pickup branch: और शाखा का नाम। यह पाठ ग्राहक और स्टोर को भेजे गए ऑर्डर ईमेल, ग्राहक के ऑर्डर इतिहास, इनवॉइस और एडमिन ऑर्डर पेज पर दिखता है। OpenCart पाठ को 128 अक्षरों तक सीमित करता है; शाखा का पूरा डेटा एक्सटेंशन रखता है। OpenCart का ऑर्डर सफलता पेज शिपिंग विधि नहीं दिखाता।

Admin order page: Sales > Orders में एक ऑर्डर खोलें। एक Andreani पैनल Andreani modality और शाखा वाले मोड के लिए Andreani branch (नाम, ID और प्रांत) दिखाता है। बदलने के लिए Edit पर क्लिक करें, दूसरा प्रांत और शाखा चुनें और Save पर क्लिक करें। आपको Branch updated. दिखेगा, और ऑर्डर के शिपिंग विधि पाठ में शाखा भी बदल दी जाएगी। केवल Andreani सूची की शाखाएँ सहेजी जा सकती हैं। यदि सूची उपलब्ध नहीं है, तो आपको The Andreani branch list is not available right now - the branch cannot be changed. दिखेगा। शाखा बदलने के लिए sale/order की संशोधन अनुमति और extension/shipping/vfd_andreani (OpenCart 3) या extension/vfd_andreani/shipping/vfd_andreani (OpenCart 4) तक पहुँच चाहिए। एक्सटेंशन बंद होने पर भी Andreani से दिए गए ऑर्डरों के लिए यह पैनल दिखता है।

एक्सटेंशन बंद होने पर Andreani पैनल नहीं दिखता। शाखा डेटा सहेजा रहता है, और ऑर्डर का शिपिंग विधि पाठ नहीं बदलता। मौजूदा ऑर्डर अपना शाखा डेटा रखते हैं।

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

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

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

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

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

चेकआउट पर Andreani नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है (दूसरे विकल्प के लिए Enable second option भी), और इंस्टॉल के बाद आपने Save पर क्लिक किया है। Geo zone, या Ignore shipping zones और Countries जाँचें। जाँचें कि Country prices में देश के लिए पंक्ति है (तय कीमतों या बैकअप के लिए), वज़न सीमाएँ और Minimum subtotal। Edit पेज के शीर्ष की चेतावनियाँ पढ़ें। जाँचें कि उत्पादों का Requires Shipping Yes पर सेट है।

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

मेरा स्टोर अर्जेंटीना पेसो में नहीं है:ARS exchange rate को अपने स्टोर की डिफ़ॉल्ट मुद्रा में 1 ARS के मान पर सेट करें।

शिपिंग टैक्स गलत लगता है:Tax status में टैक्स क्लास होने पर IVA के बिना Andreani दर उपयोग होती है और OpenCart अपना टैक्स जोड़ता है। None होने पर IVA सहित दर उपयोग होती है और कोई टैक्स नहीं जुड़ता। जाँचें कि स्टोर सेटिंग्स में टैक्स चालू हैं और टैक्स क्लास में अर्जेंटीना के लिए दरें हैं।

सूची में कोई शाखा नहीं: Andreani शाखा API ने जवाब नहीं दिया। विफल अनुरोध 5 मिनट बाद दोबारा किया जाता है। लॉग देखें।

गलत प्रांत पहले से चुना गया है: प्रांत डिलीवरी पते के क्षेत्र से पढ़ा जाता है। ग्राहक हमेशा कोई और प्रांत चुन सकता है।

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

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

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

अनइंस्टॉल

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

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

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