VibeFox Australia Post for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Australia Post PAC API कुंजी (केवल लाइव दरों के लिए): लाइव दरें Australia Post के Postage Assessment Calculator (PAC) API का उपयोग करती हैं। यह कुंजी मुफ़्त है: Australia Post Developer Centre (developers.auspost.com.au) पर PAC API कुंजी के लिए पंजीकरण करें। मॉड्यूल पेज पर पंजीकरण पेज का लिंक है। आपको वह 4 अंकों का ऑस्ट्रेलियाई पोस्टकोड भी चाहिए जहाँ से आप पार्सल भेजते हैं। यदि आप केवल हर देश के लिए निश्चित मूल्य उपयोग करते हैं, तो आपको API कुंजी की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

4. Rate source चुनें। लाइव दरों के लिए PAC API कुंजी, अपना भेजने वाला पोस्टकोड और, यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा AUD नहीं है, तो AUD विनिमय दर दर्ज करें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Australia Post > Configure। ये हर ज़ोन पर लागू होती हैं। पेज के शीर्ष पर Shipping > Carriers में कैरियर का नाम और ID दिखता है। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर कैश की गई Australia Post दरें भी साफ़ हो जाती हैं।

यदि लाइव दर स्रोत चुना गया है, लेकिन API कुंजी, 4 अंकों का भेजने वाला पोस्टकोड या AUD विनिमय दर नहीं है, तो सहेजने के बाद चेतावनी दिखाई जाती है। यह यह भी बताती है कि आपके ठीक करने तक क्या होगा: चेकआउट पर कैरियर छिपा रहता है, या फ़ॉलबैक मोड में हर देश के निश्चित मूल्य उपयोग होते हैं।

संख्यात्मक फ़ील्ड दशमलव विभाजक के रूप में बिंदु या कॉमा स्वीकार करते हैं। जो मान संख्या नहीं है या ऋणात्मक है, वह सहेजा नहीं जाता: चेतावनी फ़ील्ड का नाम बताती है और पिछला मान बना रहता है। यदि स्टोर की वज़न या आयाम इकाई (International > Localization) मॉड्यूल की जानी-पहचानी इकाई नहीं है, तो पेज भी चेतावनी देता है। तब उत्पादों का वज़न kg और आयाम cm माने जाते हैं।

सामान्य

Enable Australia Post: सभी ज़ोन में एक साथ कैरियर बंद करता है। यह वही स्विच है जो Shipping > Carriers में कैरियर की स्थिति है।

Method title: चेकआउट पर ग्राहक को दिखने वाला कैरियर का नाम। यह Shipping > Carriers में भी कैरियर का नाम है, और वहाँ कैरियर का नाम बदलने पर यह फ़ील्ड भी अपडेट हो जाता है। डिफ़ॉल्ट: Australia Post। अधिकतम 64 अक्षर: लंबा शीर्षक अस्वीकार होता है और कुछ सहेजा नहीं जाता। यदि फ़ील्ड खाली है या उसमें ऐसे अक्षर हैं जो PrestaShop कैरियर के नाम में अनुमति नहीं देता, तो चेतावनी दिखती है और Australia Post उपयोग होता है।

Tax status: शिपिंग लागत पर टैक्स कैसे लागू होता है।

Rate source: कीमत कैसे निकाली जाती है।

त्रुटि के विवरण लॉग में जाते हैं, ग्राहक तक कभी नहीं।

Australia Post API (live rates) (निश्चित मूल्यों के लिए आवश्यक नहीं)

PAC API key: आपकी मुफ़्त Australia Post PAC API कुंजी। यह AUTH-KEY हेडर में Australia Post को भेजी जाती है। सहेजने के बाद फ़ील्ड खाली हो जाता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Remove the saved API key: सहेजी गई कुंजी हटाने के लिए चालू करें और सहेजें। इसके बाद लाइव दरें बंद हो जाती हैं।

Ship-from postcode: 4 अंकों का ऑस्ट्रेलियाई पोस्टकोड जहाँ से पार्सल भेजे जाते हैं, जैसे 2000।

Domestic service: ऑस्ट्रेलिया के भीतर डिलीवरी के लिए उपयोग (22 kg तक, प्रत्येक ओर 105 cm तक): Parcel Post (डिफ़ॉल्ट) या Express Post।

International service: ऑस्ट्रेलिया के बाहर डिलीवरी के लिए उपयोग (20 kg तक): International Standard (डिफ़ॉल्ट), International Express या International Courier।

Remove GST: घरेलू API कीमतों को 1.1 से भाग देता है। Australia Post की घरेलू कीमतों में 10% GST शामिल है। इसे तब चालू करें जब PrestaShop खुद शिपिंग पर टैक्स जोड़ता हो (Tax status = Taxable और कैरियर पर टैक्स नियम हो), ताकि GST दोगुना न लगे। अंतरराष्ट्रीय डाक पर GST नहीं लगता और इसे कभी नहीं बदला जाता।

AUD → (your currency) rate: लेबल में आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखती है। Australia Post की कीमतें AUD में हैं। यदि आपकी डिफ़ॉल्ट मुद्रा AUD नहीं है, तो बताएँ कि एक AUD आपकी मुद्रा की कितनी इकाइयों के बराबर है, जैसे 0.61। दर 0 से अधिक होनी चाहिए। इसके बिना लाइव दरें उपयोग नहीं होतीं। यदि आपकी डिफ़ॉल्ट मुद्रा AUD है, तो पेज बताता है कि किसी रूपांतरण की ज़रूरत नहीं है: फ़ील्ड खाली छोड़ें। दशमलव विभाजक के रूप में बिंदु और कॉमा दोनों स्वीकार होते हैं।

लाइव दरों के लिए पार्सल

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

Default product weight (kg): हर उस उत्पाद के लिए उपयोग होता है जिसमें वज़न नहीं है, Australia Post अनुरोध में और Min cart weight (kg) / Max cart weight (kg) की जाँच में। डिफ़ॉल्ट: 1।

Default parcel length (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 22।

Default parcel width (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 16।

Default parcel height (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 8।

जब उत्पादों में आयाम होते हैं, तो पार्सल उनमें से सबसे बड़ी लंबाई और चौड़ाई लेता है, और ऊँचाई तब तक बढ़ती है जब तक पार्सल सभी आइटमों का आयतन न समा ले।

निश्चित मूल्य (निश्चित मूल्यों के साथ और लाइव दरों के फ़ॉलबैक के रूप में उपयोग होते हैं)

Country prices: 2 अक्षरों के देश कोड (AU, NZ, US आदि) और आपके स्टोर की डिफ़ॉल्ट मुद्रा में कीमतों की तालिका, कर को छोड़कर। किसी देश को जोड़ने के लिए Add row पर और किसी को हटाने के लिए × लिंक पर क्लिक करें। बाकी सभी देशों के लिए * का उपयोग करें। बिना कीमत वाले देश (और * पंक्ति न होने पर) के लिए कोई निश्चित दर नहीं है, इसलिए उस देश के लिए कैरियर छिप जाता है। अमान्य देश कोड या बिना कीमत वाली पंक्तियाँ सहेजते समय हटा दी जाती हैं। कीमतें जोड़ने तक तालिका खाली रहती है।

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

शर्तें

Min cart weight (kg): कार्ट का वज़न इस मान से कम हो तो कैरियर छिपाएँ। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

शिपिंग ज़ोन के बिना उपलब्धता

आम तौर पर कैरियर उन ज़ोन में दिया जाता है जो Shipping > Carriers में उसके लिए चुने गए हैं।

Ignore shipping zones: नीचे दिए देशों के लिए कैरियर दें, चाहे कोई भी ज़ोन मेल खाए। सहेजने पर कैरियर सभी ज़ोन से जुड़ जाता है, और बाद में बनाए गए ज़ोन अपने-आप जुड़ जाते हैं। विकल्प बंद करने पर कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं।

Countries: इस मोड के लिए गंतव्य देश। सभी सक्रिय देशों की अनुमति के लिए खाली छोड़ें। कई देश चुनने के लिए Ctrl (Mac पर Cmd) दबाए रखें और क्लिक करें। यह केवल Ignore shipping zones के साथ उपयोग होता है।

उन्नत

Debug log: दर गणनाएँ modules/vfd_australia_post/logs/vfd_ap.log.php में लॉग करता है। वेब से यह फ़ाइल नहीं खोली जा सकती। API त्रुटियाँ हमेशा लॉग होती हैं। API कुंजी और ग्राहकों के पोस्टकोड लॉग नहीं होते। काम पूरा होने पर लॉग बंद करें।

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

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

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

शिपिंग चरण पर PrestaShop मॉड्यूल से Australia Post की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। मॉड्यूल पहले शर्तें जाँचता है: Countries सूची (Ignore shipping zones के साथ), कार्ट का वज़न और Minimum order amount। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और Australia Post को कोई अनुरोध नहीं जाता।

निश्चित मूल्य मोड में कीमत तालिका से ली जाती है। लाइव दर मोड में मॉड्यूल Australia Post को पार्सल का वज़न भेजता है और, ऑस्ट्रेलिया के भीतर डिलीवरी के लिए, भेजने और डिलीवरी के पोस्टकोड तथा पार्सल का आकार; अंतरराष्ट्रीय डिलीवरी के लिए गंतव्य देश। घरेलू लाइव दर तभी माँगी जाती है जब डिलीवरी पते में 4 अंकों का पोस्टकोड हो। जब पार्सल Australia Post की सीमा (घरेलू 22 kg या 105 cm, अंतरराष्ट्रीय 20 kg) से बड़ा हो, तो कोई अनुरोध नहीं भेजा जाता। AUD कीमत आपकी दर से बदली जाती है, और यदि Remove GST चालू है तो घरेलू कीमतों से GST हटाया जाता है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में निकाली जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

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

मॉड्यूल केवल दरें निकालता है। यह शिपिंग लेबल, eParcel या MyPost Business शिपमेंट या मैनिफ़ेस्ट नहीं बनाता, पार्सल को ट्रैक नहीं करता, और ग्राहकों को पार्सल लॉकर या डाकघर चुनने नहीं देता। कार्ट हमेशा एक पार्सल के रूप में मूल्यांकित होती है। लेटर, सैचेल और अनुबंध (eParcel) दरें शामिल नहीं हैं।

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

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

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

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

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

चेकआउट पर Australia Post नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Australia Post चालू है (कैरियर Shipping > Carriers में सक्रिय है)। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है और देश Countries में अनुमति प्राप्त है)। कार्ट वज़न सीमाएँ और Minimum order amount जाँचें। निश्चित मूल्य मोड में जाँचें कि देश या * की कीमत है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें, और मॉड्यूल पेज पर Log फ़ील्ड देखें। उसमें कारण दिखता है: API कुंजी या भेजने वाला पोस्टकोड नहीं है, अभी 4 अंकों का डिलीवरी पोस्टकोड नहीं है, पार्सल सीमा से बाहर है, AUD विनिमय दर नहीं है, या Australia Post की त्रुटि संदेश है। Live rates, fixed price if the API gives no rate के साथ, आपके समस्या ठीक करने तक ग्राहकों को निश्चित मूल्य मिलता रहता है।

मेरा स्टोर AUD में नहीं है: विनिमय दर (आपकी डिफ़ॉल्ट मुद्रा की कितनी इकाइयाँ एक AUD के बराबर हैं) AUD → (your currency) rate फ़ील्ड में दर्ज करें। निश्चित मूल्य हमेशा डिफ़ॉल्ट मुद्रा में रहते हैं।

शिपिंग पर GST दोगुना लगता है: Australia Post की घरेलू कीमतों में 10% GST शामिल है। यदि Tax status Taxable है और कैरियर पर टैक्स नियम है, तो Remove GST चालू करें, या Tax status को None पर सेट करें।

शिपिंग पर टैक्स नहीं जुड़ रहा: Tax status = Taxable होने पर टैक्स कैरियर के टैक्स नियम से आता है। उसे Shipping > Carriers में चुनें। जब तक कैरियर के पास टैक्स नियम नहीं है, मॉड्यूल पेज चेतावनी दिखाता है।

कीमत बहुत ज़्यादा या बहुत कम है: उत्पादों का वज़न और आयाम तथा Parcel for live rates के डिफ़ॉल्ट मान जाँचें। Item (price × quantity) के साथ निश्चित मूल्य आइटमों की संख्या से गुणा होते हैं।

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

पेज कहता है कि Australia Post कैरियर हटा दिया गया था: कैरियर Shipping > Carriers में हटाया गया था। उसे फिर बनाने के लिए मॉड्यूल पेज पर Save पर क्लिक करें, या Modules > Module Manager में मॉड्यूल रीसेट करें।

अनइंस्टॉल

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

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