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

आवश्यकताएँ

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

6. WooCommerce > Settings > Shipping > Shipping zones में किसी शिपिंग ज़ोन (जैसे "Singapore") में VibeFox Ninja Van जोड़ें, या Ignore shipping zones चालू करके देश चुनें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Ninja Van। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। वैश्विक Method title उपयोग करने के लिए इसे खाली छोड़ें।

सामान्य

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

Method title: कार्ट और चेकआउट में दिखाए जाने वाले शिपिंग विधि का नाम। कोई ज़ोन इसे बदल सकता है। डिफ़ॉल्ट: Ninja Van।

कीमतें (आपकी स्टोर मुद्रा में)

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

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: तब उपयोग होता है जब तालिका में गंतव्य देश की पंक्ति न हो (और * पंक्ति भी न हो), या पंक्ति में इस वज़न की कीमत न हो। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।

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) से लिए जाते हैं। दोनों दर्ज करें, या दोनों खाली छोड़ें ताकि WooCommerce > Settings > General में स्टोर के पते से ये अपने-आप पहचाने जा सकें: इंडोनेशिया, प्रांत, शहर और, यदि शहर में कई ज़ोन हैं, तो पते की पंक्ति में दिया जिला (Kecamatan)। गलत फ़ॉर्मेट वाला कोड त्रुटि संदेश के साथ साफ़ कर दिया जाता है।

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

शर्तें

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

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

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

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

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

Tax status: Taxable शिपिंग लागत पर WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। यदि तालिका की कीमतों में पहले से टैक्स (GST, SST, VAT) शामिल है, तो None चुनें।

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

Ignore shipping zones: नीचे दिए गए देशों के लिए Ninja Van देता है, भले ही विधि किसी शिपिंग ज़ोन में न जोड़ी गई हो।

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

उन्नत

Debug log: दर गणनाएँ WooCommerce > Status > Logs में लॉग करता है (स्रोत vfd_ninja_van)। ग्राहकों के पते लॉग नहीं होते। यह बंद होने पर भी विफल Tariff API अनुरोध लॉग होते हैं। काम पूरा होने पर इसे बंद कर दें।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से सभी Ninja Van सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लासें। यदि निःशुल्क शिपिंग लागू होती है, तो ग्राहक को विधि बिना शुल्क के दिखती है और Ninja Van को कोई अनुरोध नहीं जाता।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अनइंस्टॉल

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

Ninja Van उसके मालिक का ट्रेडमार्क है। यह प्लगइन Ninja Van से संबद्ध नहीं है और इसे Ninja Van का समर्थन प्राप्त नहीं है।