VibeFox Jadlog for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Jadlog अनुबंध (लाइव शुल्क और Pickup बिंदुओं के लिए): लाइव शुल्क और Pickup बिंदुओं की सूची Jadlog Embarcador API से आती है। अनुबंध पर हस्ताक्षर होने के बाद आपका Jadlog फ़्रैंचाइज़ी पहुँच जारी करता है। आपको Embarcador API टोकन, अनुबंध में दर्ज प्रेषक का CNPJ (या CPF), चालू खाता (conta corrente) और, यदि हो, अनुबंध संख्या चाहिए। यदि आप केवल निश्चित शुल्क उपयोग करते हैं, तो आपको Jadlog अनुबंध की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. API टोकन चिपकाएँ, CNPJ, चालू खाता, अनुबंध संख्या और मूल CEP डालें, Jadlog सेवा चुनें, और यदि आपके स्टोर की मुद्रा BRL नहीं है तो BRL विनिमय दर डालें। चाहें तो निश्चित शुल्क या फ़ॉलबैक लागत जोड़ें (देखें कॉन्फ़िगरेशन)।

6. ब्राज़ील के लिए किसी शिपिंग ज़ोन में WooCommerce > Settings > Shipping > Shipping zones से VibeFox Jadlog जोड़ें, या Ignore shipping zones चालू करके देश चुनें। Jadlog Pickup बिंदु भी देने के लिए उसी ज़ोन में यह विधि दूसरी बार जोड़ें और सेवा के रूप में Pickup (40) चुनें।

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

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

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

Jadlog service (zone): इस ज़ोन विधि की सेवा। Same as the global setting मुख्य सेटिंग्स पेज की सेवा उपयोग करता है। उदाहरण के लिए, एक ही ज़ोन में घर पर डिलीवरी (.Package) और Jadlog Pickup बिंदु देने के लिए विधि दो बार जोड़ें।

जब ज़ोन का शीर्षक खाली हो और सेवा Pickup हो, तो वैश्विक शीर्षक में शब्द "Pickup" जोड़ दिया जाता है, ताकि दोनों विधियों के नाम अलग रहें।

सेटिंग्स पेज के शीर्ष पर अधूरे सेटअप के लिए प्लगइन चेतावनियाँ दिखाता है: API टोकन नहीं, CNPJ या चालू खाता नहीं, मूल CEP नहीं, या ऐसे स्टोर के लिए BRL विनिमय दर नहीं जो BRL में नहीं बेचता। हर बार सेटिंग्स सेव करने पर कैश किए गए Jadlog शुल्क और Pickup बिंदुओं की सूचियाँ मिटा दी जाती हैं।

सामान्य

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

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

Jadlog लाइव शुल्क

लाइव शुल्क केवल उन ब्राज़ीलियाई पतों के लिए माँगे जाते हैं जिनमें पूरा 8-अंकीय CEP हो।

API token: Jadlog से मिला Embarcador टोकन। इसे "Bearer" शब्द के साथ या बिना चिपकाया जा सकता है। केवल निश्चित शुल्क उपयोग करने के लिए खाली छोड़ें।

CNPJ: Jadlog अनुबंध में दर्ज प्रेषक का CNPJ (14 अंक) या CPF (11 अंक)। बिंदु, स्लैश और डैश अनुमत हैं। अंकों की संख्या गलत होने पर प्लगइन चेतावनी देता है।

Current account (conta corrente): आपका Jadlog चालू खाता नंबर। इसके और CNPJ के बिना Jadlog शुल्क कोट नहीं कर सकता, और केवल निश्चित शुल्क उपयोग होंगे।

Contract number: आपका Jadlog अनुबंध नंबर, यदि आपकी फ़्रैंचाइज़ी ने दिया हो।

Origin CEP: वह 8-अंकीय पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं। यह 00000-000 प्रारूप में सहेजा जाता है। यदि स्टोर का पता ब्राज़ील में है, तो WooCommerce > Settings > General का स्टोर पोस्टकोड उपयोग करने के लिए खाली छोड़ें।

Jadlog service: आपके अनुबंध की सेवा (modalidade): .Package (3, डिफ़ॉल्ट), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) या Pickup (40)। Pickup ग्राहक के पास के Jadlog Pickup बिंदु देता है। किसी ज़ोन की विधि अलग सेवा उपयोग कर सकती है।

Insurance type: Normal (N) (डिफ़ॉल्ट) या Own insurance policy (A — apólice), जैसा आपके Jadlog अनुबंध में तय हो।

Volumetric weight: Jadlog वास्तविक और आयतनी वज़न में से जो अधिक हो, उसके आधार पर शुल्क लेता है।

BRL exchange rate: Jadlog ब्राज़ीलियाई रियल (BRL) में कोट करता है। यदि आपके स्टोर की मुद्रा BRL है, तो यह फ़ील्ड ज़रूरी नहीं है। अन्यथा, बताएँ कि 1 BRL आपके स्टोर की मुद्रा में कितने का है, जैसे 0.16। Jadlog शुल्क को इस दर से गुणा किया जाता है, और Jadlog को भेजे गए घोषित ऑर्डर मूल्य को वापस BRL में बदला जाता है। दर के बिना लाइव शुल्क उपयोग नहीं होते और केवल निश्चित शुल्क लागू होते हैं। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।

Delivery time: Jadlog से मिला डिलीवरी समय विधि के शीर्षक के आगे दिखाता है, जैसे "Jadlog (3 कार्य दिवस)"। डिफ़ॉल्ट रूप से चालू। डिलीवरी समय हमेशा ऑर्डर में सहेजा जाता है।

Jadlog Pickup बिंदु (Pickup (40) सेवा द्वारा उपयोग; API टोकन चाहिए)

Points to show: कितने Pickup बिंदु देने हैं, 1 से 10 तक। डिफ़ॉल्ट: 5।

निश्चित शुल्क (API टोकन न होने पर, उन देशों के लिए जिनमें Jadlog सेवा नहीं देता, और जब भी Jadlog कोई शुल्क नहीं लौटाता तब उपयोग होता है)

Price per country: स्टोर की मुद्रा में एक तालिका, जिसके कॉलम Country, Price, XS, S, M, L और XL हैं। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें, और हटाने के लिए क्रॉस पर। आकार का कॉलम कार्ट के वज़न से चुना जाता है: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक, XL 5 kg से ऊपर। आकार कॉलम खाली होने पर Price उपयोग होता है। शुल्क 0 हो तो उस देश के लिए मुफ़्त शिपिंग है। अन्य सभी देशों के लिए देश के रूप में * Default उपयोग करें। बिना किसी शुल्क की पंक्तियाँ सेव करते समय हटा दी जाती हैं।

Fallback cost: तब उपयोग होता है जब न Jadlog और न तालिका शुल्क देती है। उस स्थिति में विधि छिपाने के लिए खाली छोड़ें।

Fixed price applies: Per order शुल्क एक बार लेता है। Per item (price × quantity) उसे कार्ट में आइटमों की संख्या से गुणा करता है। यह केवल निश्चित शुल्क और फ़ॉलबैक लागत पर लागू होता है। Jadlog शुल्क पहले से पूरे कार्ट को कवर करते हैं।

शर्तें

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

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

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

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

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

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

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

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

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

उन्नत

Debug log: हर Jadlog अनुरोध और उत्तर को WooCommerce > Status > Logs में, स्रोत vfd-jadlog के साथ, दर्ज करता है। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा दर्ज होती हैं। टोकन, CNPJ और खाता कभी दर्ज नहीं होते, और ग्राहक का CEP छोटा करके दर्ज होता है। काम पूरा होने पर लॉग बंद करें।

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

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

जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से शुल्क माँगता है। प्लगइन पहले शर्तें जाँचता है: कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। यदि कार्ट का उप-योग Free shipping from तक पहुँचे, तो डिलीवरी मुफ़्त होती है और Jadlog को शुल्क का कोई अनुरोध नहीं भेजा जाता।

पूरे 8-अंकीय CEP वाले ब्राज़ील के डिलीवरी पते के लिए प्लगइन Jadlog को मूल और गंतव्य CEP, वज़न, आपका CNPJ, चालू खाता, अनुबंध, सेवा, बीमा प्रकार और घोषित ऑर्डर मूल्य भेजता है, और लौटाया गया शुल्क आपके स्टोर की मुद्रा में दिखाता है। बिना वज़न वाले कार्ट को 0.1 kg माना जाता है। यदि कोई लाइव शुल्क नहीं है (टोकन नहीं, पता ब्राज़ील के बाहर, अधूरा CEP, BRL विनिमय दर नहीं, Jadlog त्रुटि), तो प्लगइन पहले Price per country तालिका और फिर Fallback cost उपयोग करता है। यदि इनमें से कोई भी शुल्क न दे, तो उस कार्ट के लिए विधि छिपा दी जाती है।

हर शुल्क 1 घंटे तक कैश में रहता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट तक कैश में रहता है। यदि Jadlog उत्तर न दे, सर्वर त्रुटि लौटाए या टोकन अस्वीकार करे, तो 10 मिनट तक API को फिर से नहीं बुलाया जाता। API टाइमआउट 10 सेकंड है। ग्राहक को कभी API त्रुटि नहीं दिखती। कारण लॉग में लिखा जाता है।

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

प्लगइन केवल शुल्क की गणना करता है और Pickup बिंदुओं की सूची देता है। यह Jadlog शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, कलेक्शन का अनुरोध नहीं करता, शिपमेंट रद्द नहीं करता या पार्सल ट्रैक नहीं करता। यह Pickup बिंदुओं का मानचित्र नहीं दिखाता और Jadlog से अंतर्राष्ट्रीय कोटेशन नहीं माँगता। अन्य देशों के लिए निश्चित शुल्क उपयोग करें।

Pickup बिंदु

Pickup (40) सेवा वाली विधि केवल ब्राज़ील के पतों के लिए दी जाती है। जब ग्राहक पूरा 8-अंकीय CEP दर्ज करता है, तो प्लगइन Jadlog से पास के सक्रिय Pickup बिंदु माँगता है और अधिकतम Points to show बिंदु देता है। हर बिंदु अपना शुल्क रखने वाला अलग शिपिंग विकल्प है, जैसे "Jadlog Pickup: बिंदु का नाम — पता"। ग्राहक शिपिंग विकल्प चुनकर बिंदु चुनता है, और यह क्लासिक चेकआउट तथा Cart व Checkout ब्लॉक, दोनों में एक-सा है।

हर बिंदु का शुल्क Jadlog से माँगा जाता है। यदि Jadlog किसी बिंदु के लिए शुल्क नहीं देता, तो निश्चित शुल्क उपयोग होता है, और बिना किसी शुल्क वाला बिंदु सूची से बाहर रह जाता है। Pickup बिंदुओं की सूचियाँ 12 घंटे तक कैश में रहती हैं।

API टोकन के बिना, 8-अंकीय CEP के बिना, जब Jadlog उपलब्ध न हो, या जब पास में कोई सक्रिय बिंदु न हो, तब Pickup विधि छिप जाती है। बिना बिंदु के ऑर्डर भेजा नहीं जा सकता।

ऑर्डर

ऑर्डर की शिपिंग पंक्ति में Jadlog सेवा और, यदि Jadlog ने लौटाया हो, कार्य दिवसों में डिलीवरी समय सहेजा जाता है। Pickup ऑर्डर के लिए शिपिंग पंक्ति के नाम में बिंदु का नाम और पता होता है, और ऑर्डर में Pickup बिंदु का नाम, पता और ID भी सहेजे जाते हैं। ये एडमिन ऑर्डर स्क्रीन पर शिपिंग पंक्ति के नीचे दिखते हैं। ग्राहक चुना हुआ बिंदु धन्यवाद पेज और ऑर्डर ईमेल में देखता है।

शिपमेंट Jadlog सिस्टम में आप स्वयं बुक करें। ऑर्डर में वह सेवा और Pickup बिंदु ID दिखती है जो इसके लिए चाहिए।

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

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

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

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

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

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

Jadlog चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश अनुमत है)। सेटिंग्स पेज के शीर्ष की चेतावनियाँ, वज़न की सीमाएँ, Minimum order amount और Excluded shipping classes देखें। यदि ग्राहक ने अभी पूरा 8-अंकीय CEP नहीं डाला है, तो केवल निश्चित शुल्क उपयोग हो सकते हैं, इसलिए Price per country में एक पंक्ति या Fallback cost जोड़ें।

केवल निश्चित शुल्क दिखते हैं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs को स्रोत vfd-jadlog के साथ खोलें। उसमें कारण दिखेगा: CNPJ या चालू खाता नहीं, मूल CEP नहीं, गंतव्य CEP अधूरा, BRL विनिमय दर नहीं, या Jadlog की त्रुटि का संदेश।

लॉग में HTTP 401 या 403: Jadlog ने API टोकन अस्वीकार किया है। अपनी Jadlog फ़्रैंचाइज़ी से जाँचें। इस त्रुटि के बाद API 10 मिनट के लिए रुक जाता है। सेटिंग्स सेव करने से यह रुकावट हट जाती है, इसलिए आप तुरंत फिर से कोशिश कर सकते हैं।

Pickup बिंदु नहीं दिखते: Pickup विधि को API टोकन और ब्राज़ील में पूरा 8-अंकीय CEP चाहिए। यदि CEP के पास Jadlog के सक्रिय बिंदु नहीं हैं, तो विधि छिप जाती है। कारण के लिए लॉग देखें।

शुल्क मेरी मुद्रा के बजाय रियल में दिखते हैं: BRL exchange rate डालें (आपके स्टोर की मुद्रा में 1 BRL कितने का है)।

शुल्क बहुत कम या बहुत अधिक लगते हैं: उत्पादों के वज़न और आयाम भरें। बिना वज़न वाले कार्ट को 0.1 kg माना जाता है, और आयतनी वज़न के लिए आयाम चाहिए।

बदलाव के बाद शुल्क पुराने लगते हैं: सेटिंग्स पेज सेव करें। इससे कैश किए गए Jadlog शुल्क और Pickup बिंदुओं की सूचियाँ मिट जाती हैं।

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

अनइंस्टॉल

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

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