VibeFox Andreani for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

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

इंस्टॉलेशन

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

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

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

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

इंस्टॉल होने पर मॉड्यूल दो कैरियर बनाता है:

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Andreani > Configure। हर अनुभाग का अपना Save बटन है, जो पूरा पेज सहेजता है। सहेजने के बाद आपको Settings saved. Cached token, branches and rates were cleared. दिखता है। लापता सेटिंग्स (API क्रेडेंशियल, अनुबंध नंबर, ARS विनिमय दर, अर्जेंटीना के लिए कोई कीमत नहीं, हटाया गया कैरियर) के बारे में चेतावनियाँ पेज के ऊपर दिखाई जाती हैं। यदि मॉड्यूल स्टोर की वज़न या आयाम इकाई नहीं पहचानता, तो भी चेतावनी दिखती है (तब वज़न kg और आयाम cm माने जाते हैं)। सहेजते समय 64 अक्षरों से लंबा नाम या Max weight (kg) से बड़ा Min weight (kg) अस्वीकार होता है, और कुछ भी सहेजा नहीं जाता। जो मान संख्या नहीं है, ऋणात्मक संख्या है, या 0 या उससे कम ARS exchange rate है, वह सहेजा नहीं जाता, और चेतावनी में फ़ील्ड का नाम दिखता है।

General

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

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

Tax status: None, या आपके किसी टैक्स नियम के साथ Taxable। टैक्स नियम होने पर स्टोर शिपिंग लागत में टैक्स जोड़ता है, इसलिए API दर बिना IVA के ली जाती है। None होने पर API दर IVA सहित ली जाती है। यह सेटिंग दोनों 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 kg, 0 का अर्थ है कोई सीमा नहीं।

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

Ignore shipping zones: ज़ोन सेट किए बिना नीचे दिए देशों के लिए Andreani उपलब्ध कराएँ। चालू करने पर दोनों कैरियर सभी ज़ोन से जुड़ जाते हैं, और बाद में बना ज़ोन तुरंत जुड़ जाता है। बंद करने पर कैरियरों को उनके पिछले ज़ोन वापस मिल जाते हैं।

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

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

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

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

दूसरा विकल्प

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

Enable second option: दूसरे कैरियर को चालू या बंद करता है। यह Shipping > Carriers में उसकी स्थिति वाला ही स्विच है। डिफ़ॉल्ट: बंद।

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 अनुरोध और दर गणनाएँ मॉड्यूल फ़ोल्डर में logs/vfd_andr_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल और टोकन कभी लॉग नहीं होते।

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

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

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

डिलीवरी चरण में PrestaShop हर Andreani कैरियर की कीमत मॉड्यूल से माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल देशों की जाँच करता है (जब Ignore shipping zones चालू हो), कार्ट का वज़न (उत्पादों के वज़न kg में बदले जाते हैं, और बिना वज़न वाले उत्पाद Default product weight (kg) उपयोग करते हैं) और Minimum subtotal।

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

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

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

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

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

पिकअप पॉइंट

जब Door to branch या Branch to branch वाला कैरियर चुना जाता है, तो डिलीवरी चरण में उसके नीचे एक प्रांत सूची और एक शाखा सूची दिखती है। प्रांत शिपिंग पते से पहले से चुना जाता है। शाखा सूची Andreani की सार्वजनिक शाखा API से आती है और 12 घंटे तक कैश रहती है। जो शाखाएँ पार्सल नहीं सौंपतीं, वे सूची में नहीं आतीं। कोई शाखा उपलब्ध न हो, तो ग्राहक को 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. दिखता है।

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

ऑर्डर

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

Admin order page: एक Andreani ब्लॉक मोडैलिटी और शाखा (नाम, ID और प्रांत) दिखाता है। बदलने के लिए Edit पर क्लिक करें, कोई दूसरा प्रांत और शाखा चुनें और Save पर क्लिक करें। आपको Branch updated. दिखेगा। केवल Andreani सूची की शाखाएँ सहेजी जा सकती हैं। सूची उपलब्ध न हो, तो शाखा नहीं बदली जा सकती।

ग्राहक: शाखा ऑर्डर पुष्टिकरण पेज और ऑर्डर विवरण पेज पर Andreani pickup branch: के रूप में दिखाई जाती है।

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

मौजूदा ऑर्डर अपना शाखा डेटा बनाए रखते हैं।

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

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

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

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

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

चेकआउट पर Andreani दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है (दूसरे कैरियर के लिए Enable second option भी)। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है, या Ignore shipping zones चालू करके Countries जाँचें। जाँचें कि Country prices में देश की पंक्ति है (निश्चित कीमतों या विकल्प के लिए), और वज़न सीमाएँ और Minimum subtotal जाँचें। Configure पेज के ऊपर की चेतावनियाँ पढ़ें। इसके अलावा, उत्पाद पेज पर उत्पाद कुछ कैरियरों तक सीमित हो सकते हैं।

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

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

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

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

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

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

अनइंस्टॉल

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

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