VibeFox Frenet for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Frenet खाता (केवल लाइव दरों के लिए): Frenet पैनल (painel.frenet.com.br) में एक मुफ़्त खाता बनाएँ, जिन कैरियर्स का आप उपयोग करते हैं उन्हें सक्रिय करें और अपना API टोकन कॉपी करें। यदि आप केवल निश्चित कीमतें इस्तेमाल करते हैं, तो आपको Frenet खाते की ज़रूरत नहीं है।

उत्पाद: सटीक कीमतों के लिए वज़न और आयाम भरें। जिन उत्पादों में ये नहीं हैं, उनकी दर 0.3 kg और 16 × 11 × 2 cm मानकर निकाली जाती है (Correios का सबसे छोटा डिब्बा)।

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

इंस्टॉलेशन

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

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

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

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

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

6. ब्राज़ील के लिए किसी शिपिंग ज़ोन में VibeFox Frenet जोड़ें: WooCommerce > Settings > Shipping > Shipping zones। या Ignore shipping zones चालू करें और देश चुनें।

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

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

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

पेज के शीर्ष पर प्लगइन चेतावनियाँ दिखाता है: API टोकन नहीं है (केवल निश्चित कीमतें इस्तेमाल होती हैं, या अगर निश्चित कीमतें भी नहीं हैं तो विधि कभी नहीं दिखती), 8 अंकों का मूल CEP नहीं है, या स्टोर मुद्रा BRL नहीं है और विनिमय दर नहीं है। सेटिंग्स सेव करने पर कैश की गई दरें साफ़ हो जाती हैं। कीमत के फ़ील्ड में दशमलव विभाजक के रूप में बिंदु और अल्पविराम, दोनों स्वीकार होते हैं।

सामान्य

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

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

Frenet लाइव दरें

Frenet आपके Frenet खाते में सक्रिय कैरियर्स की तुलना करता है और कार्ट के लिए उनकी कीमतें लौटाता है। लाइव दरें केवल ब्राज़ील के उन पतों के लिए माँगी जाती हैं जिनमें पूरा 8 अंकों का CEP हो।

API token: Frenet पैनल से आपका Frenet API टोकन। केवल निश्चित कीमतें इस्तेमाल करने के लिए इसे खाली छोड़ें।

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

Service to offer: Cheapest service (डिफ़ॉल्ट) या Fastest service। Frenet कई सेवाएँ लौटाता है, और विधि एक ही कीमत दिखाती है।

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

निश्चित कीमतें

जब API टोकन न हो, उन देशों के लिए जहाँ Frenet सेवा नहीं देता, और जब भी Frenet कोई कीमत नहीं लौटाता (API उपलब्ध नहीं, CEP सेवा-क्षेत्र में नहीं) तब इस्तेमाल होती हैं।

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 इस्तेमाल होता है। Price 0 हो तो उस देश के लिए मुफ़्त शिपिंग है। बाकी सभी देशों के लिए * Default इस्तेमाल करें। जिन पंक्तियों में कोई कीमत नहीं है, वे सेव करते समय हट जाती हैं।

Fallback cost: तब इस्तेमाल होता है जब न Frenet और न ही तालिका कोई कीमत देती है। विधि छिपाने के लिए इसे खाली छोड़ें।

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

शर्तें

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

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

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

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

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

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

उत्पादों के वज़न को स्टोर की इकाई से kg में बदला जाता है।

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

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

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

उन्नत

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

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

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

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

पूरे 8 अंकों के CEP वाले ब्राज़ील के पते के लिए, प्लगइन Frenet को मूल और गंतव्य CEP, हर कार्ट आइटम (kg में वज़न, cm में आयाम, मात्रा, SKU और श्रेणियाँ), BRL में ऑर्डर मूल्य और पहला लागू कूपन भेजता है। जब तक CEP अधूरा है, कोई अनुरोध नहीं किया जाता। Frenet आपके सक्रिय कैरियर्स की सेवाएँ लौटाता है। त्रुटि वाली या बिना कीमत वाली सेवाएँ छोड़ दी जाती हैं। प्लगइन सबसे सस्ती या सबसे तेज़ सेवा चुनता है और कीमत को आपकी स्टोर मुद्रा में बदल देता है। कैरियर, सेवा और डिलीवरी का समय ऑर्डर की शिपिंग लाइन के साथ सहेजे जाते हैं और एडमिन ऑर्डर स्क्रीन पर दिखाए जाते हैं।

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

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

प्लगइन केवल दरें निकालता है। यह शिपमेंट नहीं बनाता, लेबल नहीं छापता या पार्सल ट्रैक नहीं करता; ये सुविधाएँ Frenet अपने पैनल में देता है। यह प्रति कार्ट एक ही Frenet सेवा दिखाता है, कई नहीं, और पिकअप पॉइंट या लॉकर की सुविधा नहीं देता। Frenet केवल ब्राज़ील के भीतर के लिए दरें देता है; अन्य देशों के लिए निश्चित कीमतें इस्तेमाल करें।

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

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

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

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

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

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

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

लाइव दरें नहीं दिख रहीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-frenet चुनें। वहाँ कारण दिखेगा: अस्वीकृत टोकन (HTTP 401 या 403), मूल CEP न होना, BRL विनिमय दर न होना, Frenet पैनल में कोई कैरियर सक्रिय न होना, या छोड़ी गई सेवाओं के संदेश।

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

बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सेव करें। इससे कैश की गई दरें साफ़ हो जाएँगी।

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

अनइंस्टॉल

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

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