VibeFox Correios for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Correios अनुबंध (केवल लाइव दामों के लिए): लाइव दाम Correios Web Services (CWS) प्राइस API का उपयोग करते हैं और posting card वाले Correios अनुबंध के क्रेडेंशियल चाहिए। तीन जानकारियाँ चाहिए: आपका Meu Correios उपयोगकर्ता (आम तौर पर अनुबंध का CNPJ या CPF), API एक्सेस कोड और posting card नंबर। एक्सेस कोड Correios Web Services पोर्टल (cws.correios.com.br; होमोलोगेशन के लिए cwshom.correios.com.br) पर बनाएँ। आपको उस CEP की भी ज़रूरत है जहाँ से आप भेजते हैं। क्रेडेंशियल के बिना प्लगइन केवल तय दामों के साथ काम करता है।

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

इंस्टॉलेशन

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

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

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

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

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

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

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

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

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

सेटिंग्स पेज चेतावनी दिखाता है जब लाइव दाम या विधि काम नहीं कर सकती: तीन में से कुछ ही क्रेडेंशियल भरे हैं, मूल CEP नहीं है, गैर-BRL मुद्रा वाले स्टोर के लिए BRL दर नहीं है, या न क्रेडेंशियल हैं न तय दाम। हर बार सेटिंग्स सहेजने पर कैश किए गए दाम और API टोकन मिट जाते हैं। संख्याएँ बिंदु या कॉमा के साथ लिखी जा सकती हैं।

सामान्य

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

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

Tax status: Taxable शिपिंग लागत पर WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

Correios API (ब्राज़ील में लाइव दाम)

ब्राज़ील के पतों के लिए दाम Correios प्राइस API से आता है। यदि API दाम नहीं देता (API बंद है, CEP सेवा में नहीं है, पार्सल बहुत बड़ा है), तो Country prices का तय दाम उपयोग होता है, या यदि वह नहीं है तो विधि छिप जाती है।

API user: आपका Meu Correios पोर्टल लॉगिन, आम तौर पर अनुबंध का CNPJ या CPF।

Access code: Correios Web Services पोर्टल में बना API एक्सेस कोड (código de acesso)। यह पोर्टल का पासवर्ड नहीं है।

Posting card: आपके अनुबंध का posting card (cartão de postagem) नंबर: 10 अंक, आम तौर पर दो शून्य से शुरू होता है, जैसे 0012345678। छोटे नंबर आगे शून्य जोड़कर पूरे किए जाते हैं। आप Correios वेबसाइट के Correios Fácil पेज पर नंबर जाँच सकते हैं।

Homologation: होमोलोगेशन एक्सेस कोड के साथ Correios का होमोलोगेशन (परीक्षण) वातावरण उपयोग करता है। लाइव स्टोर पर इसे बंद रखें।

Origin CEP: वह CEP (8 अंक) जहाँ से पार्सल भेजे जाते हैं, जैसे 01001-000।

Service: चेकआउट पर दाम तय होने वाली Correios सेवा। रिटेल कोड: PAC (04510, डिफ़ॉल्ट), SEDEX (04014), SEDEX 12 (04782), SEDEX 10 (04790), SEDEX Hoje (04804)। अनुबंध कोड: PAC (03298), SEDEX (03220), SEDEX 12 (03140), SEDEX 10 (03158), SEDEX Hoje (03204), Correios Mini Envios (04227)। अनुबंध कोड के लिए ऐसे अनुबंध का posting card चाहिए जिसमें वह सेवा शामिल हो।

Other service code: वैकल्पिक, आपके अनुबंध का 5 अंकों वाला सेवा कोड जो सूची में नहीं है, जैसे 03085। भरने पर यह Service की जगह उपयोग होता है।

Package format: Correios को भेजी जाने वाली वस्तु का प्रकार।

Default product weight (kg): बिना वज़न वाले हर उत्पाद के लिए Correios को भेजा जाने वाला वज़न। Default: 0.3। उत्पादों का वज़न और आकार आपके स्टोर की इकाइयों से बदला जाता है, और कार्ट को एक पार्सल के रूप में दाम दिया जाता है।

BRL → store currency rate: फ़ील्ड का नाम आपके स्टोर की मुद्रा दिखाता है। Correios के दाम BRL में होते हैं। यदि आपके स्टोर की मुद्रा BRL नहीं है, तो दर्ज करें कि 1 BRL आपकी मुद्रा की कितनी इकाइयों के बराबर है, जैसे 0.17। इसके बिना लाइव दाम उपयोग नहीं होते। यदि आपके स्टोर की मुद्रा BRL है, तो इसे खाली छोड़ें।

तय दाम (ब्राज़ील के बाहर के देशों, API क्रेडेंशियल के बिना, और जब API दाम न दे तब विकल्प के रूप में)

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

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

शर्तें

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

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

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

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

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

Free shipping from: वह कार्ट उप-योग जिससे शिपिंग मुफ़्त है। उस स्थिति में कोई API अनुरोध नहीं भेजा जाता।

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

Ignore shipping zones: कोई भी मेल खाने वाला ज़ोन हो, नीचे दिए देशों के लिए विधि प्रदान करें।

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

उन्नत

Debug log: दाम गणनाएँ WooCommerce > Status > Logs में, स्रोत vfd-correios के तहत दर्ज करता है। API त्रुटियाँ यह विकल्प बंद होने पर भी हमेशा दर्ज होती हैं। API उपयोगकर्ता, एक्सेस कोड, posting card, टोकन और ग्राहक CEP दर्ज नहीं होते।

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

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

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

क्रेडेंशियल सेट होने पर ब्राज़ील के पते के लिए, प्लगइन पहले आपके posting card के लिए API टोकन लेता है। टोकन अनुबंध और क्षेत्रीय कार्यालय के नंबर भी देता है, इसलिए दाम आपके अनुबंध का दाम होता है। फिर वह मूल और गंतव्य CEP, ग्राम में पार्सल वज़न और cm में पार्सल आकार के आधार पर चुनी गई सेवा का दाम माँगता है। दाम तभी माँगा जाता है जब गंतव्य CEP 8 अंकों का हो। जब सभी उत्पादों के आयाम हों, तो पार्सल का आकार उन्हीं से अनुमानित होता है; अन्यथा Correios का न्यूनतम आकार भेजा जाता है। 30 kg से अधिक के पार्सल API को नहीं भेजे जाते। BRL दाम आपकी दर से बदला जाता है। सेवा ऑर्डर की शिपिंग पंक्ति में Correios service के रूप में सहेजी जाती है और ऑर्डर एडमिन में दिखती है।

हर दाम प्रति पार्सल 1 घंटे के लिए कैश होता है। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि API बंद होने से हर चेकआउट अपडेट धीमा न हो। टोकन समाप्ति से थोड़ा पहले तक कैश रहता है और अपने-आप नवीनीकृत होता है; यदि Correios उसे अस्वीकार करे, तो नया टोकन माँगा जाता है और दाम अनुरोध एक बार दोहराया जाता है। API का टाइमआउट 12 सेकंड है।

यदि API दाम नहीं देता, तो तय दाम उपयोग होता है, या यदि तय दाम नहीं है तो विधि छिप जाती है। ग्राहक को API त्रुटि का विवरण कभी नहीं दिखता; वह WooCommerce लॉग में जाता है।

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

प्लगइन केवल दाम गणना करता है। यह Correios के अंतरराष्ट्रीय दाम (Exporta Fácil, Packet), डिलीवरी समय के अनुमान, लेबल, प्री-पोस्टिंग, घोषणाएँ या ट्रैकिंग नहीं लाता। ग्राहक Correios एजेंसी या लॉकर नहीं चुन सकते। अतिरिक्त सेवाएँ (घोषित मूल्य, हाथ में सौंपना, प्राप्ति सूचना) नहीं जोड़ी जातीं। हर स्टोर पर एक ही Correios सेवा दिखती है, और मुद्रा दरें अपने-आप अपडेट नहीं होतीं।

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

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

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

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

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

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

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

विधि Correios दाम की जगह तय दाम दिखाती है: WooCommerce > Status > Logs खोलें, स्रोत vfd-correios चुनें। Correios की त्रुटि वहाँ दर्ज होती है: गलत एक्सेस कोड, सेवा आपके अनुबंध में नहीं, CEP सेवा में नहीं, 30 kg से बड़ा पार्सल या आकार सीमा से बड़ा। यह भी देखें कि मूल CEP सेट है, और यदि स्टोर की मुद्रा BRL नहीं है तो BRL दर सेट है। हर गणना देखने के लिए Debug log चालू करें।

टोकन अनुरोध विफल होता है: API उपयोगकर्ता, एक्सेस कोड, posting card और वातावरण जाँचें। होमोलोगेशन एक्सेस कोड केवल Homologation चालू होने पर काम करता है, और उत्पादन कोड केवल तब जब यह विकल्प बंद हो।

बदलाव के बाद दाम पुराने लगते हैं: सेटिंग्स पेज सहेजें। इससे कैश किए गए दाम और API टोकन मिट जाते हैं।

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

अनइंस्टॉल

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

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