VibeFox Andreani for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_andreani फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Andreani, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

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

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

6. WooCommerce > Settings > Shipping > Shipping zones पर जाएँ, अर्जेंटीना के लिए कोई ज़ोन खोलें या बनाएँ, और VibeFox Andreani जोड़ें। ज़ोन विंडो में आप इस विकल्प का शीर्षक, डिलीवरी मोडैलिटी और इसके लिए अलग अनुबंध सेट कर सकते हैं। आप Ignore shipping zones भी चालू कर सकते हैं और इसके बजाय देश चुन सकते हैं।

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

मुख्य सेटिंग्स WooCommerce > Settings > Shipping > VibeFox Andreani पर हैं। ये सभी शिपिंग ज़ोन पर लागू होती हैं। गुम सेटिंग्स (API क्रेडेंशियल, अनुबंध संख्या, विनिमय दर, अर्जेंटीना के लिए कीमत नहीं) की चेतावनियाँ पेज के शीर्ष पर दिखती हैं। जब भी आप सेटिंग्स सहेजते हैं, कैश किया गया टोकन, शाखा सूची और दरें साफ़ हो जाती हैं।

ज़ोन विंडो (जब आप शिपिंग ज़ोन में विधि जोड़ते हैं)

Title: चेकआउट पर इस विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए खाली छोड़ दें।

Delivery modality: Use global setting या चार मोडैलिटी में से एक (नीचे देखें)। दोनों विकल्प देने के लिए विधि को ज़ोन में दो बार जोड़ें, उदाहरण के लिए डोर टू डोर और शाखा से पिकअप।

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

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ Andreani शिपिंग चालू या बंद करता है।

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

Tax status: Taxable का अर्थ है कि WooCommerce शिपिंग लागत पर टैक्स जोड़ता है, इसलिए API दर IVA के बिना ली जाती है। None का अर्थ है कि API दर IVA सहित ली जाती है।

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

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

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

API password: आपका Andreani API पासवर्ड।

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।

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

उपलब्धता

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

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

Minimum subtotal: विधि तभी दिखाएँ जब कार्ट का सबटोटल कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ दें।

Excluded shipping classes: यदि कार्ट का कोई आइटम चुनी गई WooCommerce शिपिंग क्लास में है, तो विधि छिप जाती है।

Ignore shipping zones: विधि को शिपिंग ज़ोन में जोड़े बिना भी नीचे दिए देशों के लिए उपलब्ध कराएँ।

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

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

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

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

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

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

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

उन्नत

Debug log: API अनुरोध और दर गणनाएँ WooCommerce > Status > Logs में लॉग करता है (स्रोत "vfd-andreani")। त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल और टोकन कभी लॉग नहीं होते।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सभी सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। डिएक्टिवेट करने से कुछ नहीं हटता। ऑर्डर में सहेजा गया शाखा डेटा हमेशा रहता है।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो प्लगइन कार्ट का वज़न जाँचता है (उत्पादों के वज़न kg में बदले जाते हैं; बिना वज़न वाले उत्पाद Default product weight (kg) उपयोग करते हैं), Minimum subtotal और Excluded shipping classes जाँचता है।

निश्चित मोड में कीमत 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 कोई दर नहीं लौटाता (और विकल्प के रूप में कोई निश्चित कीमत नहीं है), तो विधि नहीं दिखाई जाती। Per item के साथ निश्चित कीमत को आइटमों की संख्या से गुणा किया जाता है।

यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

पिकअप बिंदु

Door to branch या Branch to branch होने पर, चेकआउट पर Andreani विकल्प के नीचे एक प्रांत सूची और एक शाखा सूची दिखाई देती है, क्लासिक चेकआउट और Checkout ब्लॉक, दोनों में। प्रांत शिपिंग पते से पहले से चुना जाता है। शाखा सूची Andreani की सार्वजनिक शाखा API से आती है और 12 घंटे तक कैश होती है। जो शाखाएँ पार्सल नहीं सौंपतीं, वे सूची में नहीं आतीं। यदि कोई शाखा उपलब्ध नहीं है, तो ग्राहक को एक संदेश दिखता है और वह कोई अन्य शिपिंग विधि चुन सकता है।

शाखा चुने बिना ऑर्डर नहीं दिया जा सकता: ग्राहक को Please select an Andreani pickup branch. दिखता है। यह दोनों चेकआउट के लिए सर्वर पर जाँचा जाता है।

चुनी गई शाखा ऑर्डर में सहेजी जाती है। एडमिन ऑर्डर स्क्रीन पर मोडैलिटी और शाखा शिपिंग पते के नीचे दिखती हैं। किसी दूसरे प्रांत और शाखा को चुनने के लिए Edit पर क्लिक करें। ग्राहक शाखा को ऑर्डर पेज और ऑर्डर ईमेल (HTML और सादा टेक्स्ट) में Andreani pickup branch के रूप में देखता है। मौजूदा ऑर्डर अपना शाखा डेटा बनाए रखते हैं।

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

यह प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Andreani के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का उपयोग करें, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Andreani नहीं दिखता। लॉग-इन किए स्टोर मैनेजर इसे अब भी देखते हैं, (unlicensed — visible to admins only) के चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस की समय-सीमा समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

चेकआउट पर Andreani दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के पते के ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है और देश अनुमत है)। जाँचें कि Country prices में देश के लिए एक पंक्ति है (निश्चित कीमतों या विकल्प के लिए), और वज़न सीमाएँ, Minimum subtotal और Excluded shipping classes जाँचें। सेटिंग्स पेज के शीर्ष पर दी गई चेतावनियाँ पढ़ें।

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

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

शिपिंग टैक्स गलत लगता है: Tax status Taxable पर होने पर IVA के बिना Andreani दर उपयोग होती है और WooCommerce अपना टैक्स जोड़ता है। None पर होने पर IVA सहित दर उपयोग होती है और WooCommerce टैक्स नहीं जोड़ता। यदि आप Taxable उपयोग करते हैं, तो जाँचें कि WooCommerce टैक्स सेट हैं।

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

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

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।

अनइंस्टॉल

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

Andreani उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Andreani से संबद्ध नहीं है और Andreani द्वारा अनुमोदित नहीं है।