VibeFox Ninja Van for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Ninja Van दर तालिका: आपके Ninja Van शिपर खाते की कीमतें या Ninja Van की बिक्री टीम से मिली कीमतें, जो मूल्य तालिका में दर्ज की जाती हैं। API कुंजियों की आवश्यकता नहीं है। इंडोनेशिया के अंदर वैकल्पिक लाइव कीमतें Ninja Van Tariff API का उपयोग करती हैं, जो सार्वजनिक है और इसके लिए प्रमाणीकरण की आवश्यकता नहीं होती।

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

इंस्टॉलेशन

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

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

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

4. मूल्य तालिका में अपनी Ninja Van कीमतें दर्ज करें। इंडोनेशिया के लिए, चाहें तो Live rates चालू करें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Ninja Van > Configure। ये सेटिंग्स कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। जब कोई संख्या वाला फ़ील्ड टेक्स्ट या ऋणात्मक संख्या रखता है, IDR conversion rate 0 होता है, Minimum weight (kg), Maximum weight (kg) से बड़ा होता है, या Method title 64 अक्षरों से लंबा होता है, तो कुछ भी सेव नहीं होता और एक त्रुटि दिखाई जाती है। यदि आपके स्टोर की वज़न इकाई मॉड्यूल द्वारा ज्ञात इकाइयों में से नहीं है, तो सेव करने के बाद एक चेतावनी दिखती है कि उत्पादों का वज़न किलोग्राम में माना जाएगा।

सामान्य

Enable Ninja Van: कैरियर को चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

Method title: कार्ट और चेकआउट में ग्राहक को दिखने वाला कैरियर का नाम। डिफ़ॉल्ट: Ninja Van। अनिवार्य, अधिकतम 64 अक्षर।

Tax: कैरियर का टैक्स नियम, या No tax (डिफ़ॉल्ट)। यदि तालिका की कीमतों में पहले से टैक्स (GST, SST, VAT) शामिल है, तो No tax चुनें।

कीमतें (आपके स्टोर की डिफ़ॉल्ट मुद्रा में, बिना टैक्स)

अपनी Ninja Van दर तालिका की कीमतें अपने स्टोर की डिफ़ॉल्ट मुद्रा में दर्ज करें। यदि आपकी दर तालिका SGD, MYR, IDR या किसी अन्य मुद्रा में है, तो पहले उसे परिवर्तित करें। यह तालिका इंडोनेशिया के बाहर के हर गंतव्य के लिए, और जब भी लाइव कीमत उपलब्ध न हो, तब उपयोग होती है।

Price table: हर गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर और हटाने के लिए ट्रैश आइकन पर क्लिक करें। जिन देशों की अपनी पंक्ति नहीं है, उन सभी के लिए * All other countries चुनें। हर पंक्ति में एक Base price और वज़न कॉलम होते हैं: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक और XL 5 kg से अधिक। खाली (या 0) वज़न कॉलम आधार मूल्य का उपयोग करता है। आधार मूल्य 0 का अर्थ है उस देश के लिए निःशुल्क शिपिंग। «9.99» और «9,99» दोनों स्वीकार किए जाते हैं। बिना कीमत वाली पंक्तियाँ सेव करने पर हटा दी जाती हैं, और हर देश की केवल पहली पंक्ति रखी जाती है।

Price for countries not in the table: तब उपयोग होता है जब तालिका में गंतव्य देश की पंक्ति (और * पंक्ति) न हो, या पंक्ति में इस वज़न की कीमत न हो। उस स्थिति में कैरियर छिपाने के लिए इसे खाली छोड़ें। 0 का अर्थ है निःशुल्क शिपिंग।

Price applies: कीमतें कैसे गिनी जाती हैं। यह लाइव कीमतों पर भी लागू होता है।

लाइव कीमतें (API) — इंडोनेशिया

Ninja Van Tariff API इंडोनेशिया के अंदर भेजे जाने वाले पार्सलों के लिए, अधिभार और छूट के बिना, मानक डिलीवरी शुल्क लौटाता है। Ninja Van यह केवल इंडोनेशिया के लिए देता है। जब Live rates चालू होता है, तो सेक्शन शीर्षक के नीचे की स्थिति पंक्तियाँ भेजने वाले स्थान का ज़ोन, गुम परिवर्तन दर, और अंतिम Tariff API उत्तर (वातावरण, समय और परिणाम) दिखाती हैं।

Live rates: इंडोनेशिया के अंदर डिलीवरी के लिए Ninja Van की लाइव कीमतें प्राप्त करें। डिफ़ॉल्ट: बंद। इस विकल्प के बिना, चेकआउट के दौरान Ninja Van को कुछ भी नहीं भेजा जाता।

Environment: Production (api.ninjavan.co) (डिफ़ॉल्ट) या Sandbox — testing only (api-sandbox.ninjavan.co)।

Service level: वह सेवा जिसके लिए कीमत माँगी जाती है: Standard (डिफ़ॉल्ट), Express, Same day या Next day। यदि Ninja Van के पास मार्ग और सेवा के लिए कोई कीमत नहीं है, तो मूल्य तालिका उपयोग होती है।

Ship-from zone code L1 और Ship-from zone code L2: जिस जिले से आप भेजते हैं उसके L1 और L2 स्तर कोड, जैसे ID_A00007_01 और ID_B00069_01, जो Ninja Van की ज़ोन कोड मैपिंग (CSV) से लिए जाते हैं, जिसका पता फ़ील्ड के नीचे दिखता है। दोनों दर्ज करें, या दोनों खाली छोड़ें ताकि Shop Parameters > Contact > Stores में दुकान के पते से वे अपने-आप पहचाने जाएँ: इंडोनेशिया, राज्य (state), शहर, और यदि शहर में कई ज़ोन हैं, तो पते की पंक्ति में जिला (Kecamatan)। गलत प्रारूप वाला कोड चेतावनी के साथ मिटा दिया जाता है। यदि केवल एक कोड दर्ज है, तो चेतावनी दोनों दर्ज करने को कहती है, और एक स्थिति पंक्ति दिखाती है कि लाइव कीमतें माँगी नहीं जा रहीं।

IDR conversion rate: Tariff API शुल्क इंडोनेशियाई रुपिया (IDR) में लौटाता है। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा IDR है, तो इसे खाली छोड़ें। अन्यथा दर्ज करें कि 1 IDR आपके स्टोर की मुद्रा में कितना है, जैसे 0.000058। यह 0 से अधिक होना चाहिए। इसके बिना लाइव कीमतें उपयोग नहीं होतीं, और मूल्य तालिका उपयोग होती है।

शर्तें

Minimum weight (kg): कार्ट का वज़न इससे कम होने पर कैरियर छिपाता है। उत्पादों का वज़न आपकी स्टोर वज़न इकाई से किलोग्राम में बदला जाता है। 0 का अर्थ है कोई सीमा नहीं।

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

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

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

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

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

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

उन्नत

Debug log: दर गणनाएँ मॉड्यूल फ़ोल्डर में logs/vfd_njvn_debug.log.php में लॉग करता है। इस फ़ाइल को वेब से नहीं खोला जा सकता। ग्राहकों के पते लॉग नहीं होते। यह बंद होने पर भी विफल Tariff API अनुरोध लॉग होते हैं। काम पूरा होने पर इसे बंद करें।

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

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

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

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

कीमत देश की पंक्ति (या * पंक्ति) से आती है: वज़न कॉलम, नहीं तो आधार मूल्य, नहीं तो Price for countries not in the table। यदि कोई कीमत नहीं है, तो उस कार्ट के लिए कैरियर छिपा दिया जाता है। कीमत स्टोर की डिफ़ॉल्ट मुद्रा में गिनी जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

Live rates चालू होने पर, इंडोनेशिया के अंदर की डिलीवरी की कीमत पहले Ninja Van तय करता है। मॉड्यूल भेजने और डिलीवरी के पतों को Ninja Van ज़ोन कोड में बदलता है: राज्य (state), शहर या रीजेंसी (regency) और, कई ज़ोन वाले शहरों के लिए, पते की पंक्ति में लिखा जिला (Kecamatan)। यह कोड, वज़न और सेवा स्तर भेजता है और शुल्क को IDR से स्टोर की मुद्रा में बदलता है। Per item के साथ, हर अलग आइटम वज़न के लिए एक अनुरोध भेजा जाता है, प्रति कार्ट अधिकतम 5। अधिक अलग वज़न होने पर मूल्य तालिका उपयोग होती है।

Tariff API प्रति मिनट 20 अनुरोधों की अनुमति देता है, इसलिए उत्तर 6 घंटे, विफलताएँ 5 मिनट और «इस मार्ग के लिए कोई कीमत नहीं» 1 घंटे तक कैश होते हैं। मॉड्यूल कभी प्रति मिनट 18 से अधिक अनुरोध नहीं भेजता, और HTTP 429 उत्तर के बाद एक घंटे के लिए रुक जाता है। API का टाइमआउट 12 सेकंड है। यदि Ninja Van जवाब नहीं देता, त्रुटि लौटाता है, मार्ग के लिए कोई कीमत नहीं है, या पता मेल नहीं खाता, तो मूल्य तालिका की कीमत उपयोग होती है। त्रुटियाँ लॉग में जाती हैं, ग्राहक तक कभी नहीं।

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

मॉड्यूल केवल कीमतें गिनता है। यह Ninja Van के ऑर्डर नहीं बनाता, एयरवे बिल (AWB) प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता या COD नहीं संभालता। इसके लिए Ninja Van Dashboard का उपयोग करें। कोई पिकअप पॉइंट (Ninja Points) चयनकर्ता नहीं है: कैरियर घर-घर डिलीवरी वाला है। लाइव कीमतें इंडोनेशिया के बाहर उपलब्ध नहीं हैं।

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

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

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

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

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

चेकआउट पर Ninja Van नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Ninja Van चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश का ज़ोन और ग्राहक समूह कवर करता है (या Ignore shipping zones चालू करें और Countries देखें)। वज़न सीमाएँ और Minimum order amount जाँचें, और यह भी कि देश, * पंक्ति या Price for countries not in the table में कीमत है। उत्पाद पेज पर उत्पाद कुछ कैरियर तक सीमित भी हो सकते हैं।

कुछ पतों के लिए लाइव कीमत उपयोग नहीं होती: गंतव्य का मिलान Ninja Van ज़ोन से होना चाहिए: इंडोनेशिया, राज्य (state), शहर या रीजेंसी (regency) और, कई ज़ोन वाले शहरों के लिए, पते की पंक्ति में जिला (Kecamatan)। अन्यथा मूल्य तालिका की कीमत उपयोग होती है। Debug log चालू करें, चेकआउट रीलोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें।

लाइव कीमतें बिल्कुल नहीं माँगी जातीं: लाइव कीमतें (API) — इंडोनेशिया के नीचे की स्थिति पंक्तियाँ कारण दिखाती हैं: दुकान का पता इंडोनेशिया में नहीं है या भेजने का ज़ोन पहचाना नहीं जा सका (दोनों ज़ोन कोड दर्ज करें), दोनों में से केवल एक कोड दर्ज है, दर्ज कोड ज़ोन कोड मैपिंग में जोड़ी नहीं बनाते, या IDR conversion rate गायब है।

अनुरोध सीमा पहुँच गई (HTTP 429): लाइव अनुरोध एक घंटे के लिए रोक दिए जाते हैं और इस बीच मूल्य तालिका उपयोग होती है।

कीमतें किस मुद्रा में हैं: तालिका और शर्तें आपके स्टोर की डिफ़ॉल्ट मुद्रा में हैं। लाइव कीमतें रुपये (IDR) में होती हैं, और जब तक आपके स्टोर की मुद्रा IDR न हो, IDR conversion rate से परिवर्तित होती हैं।

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

डेवलपर: जिस स्टोर में अपना जिला (Kecamatan) फ़ील्ड है, वह actionVfdNjvnTariffZone हुक से ज़ोन कोड दे सकता है।

अनइंस्टॉल

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

Ninja Van अपने-अपने स्वामी का ट्रेडमार्क है। यह मॉड्यूल Ninja Van से संबद्ध नहीं है और इसे Ninja Van का समर्थन प्राप्त नहीं है।