VibeFox CTT for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

CTT e-commerce खाता (केवल लाइव दरों और CTT पॉइंट के लिए): लाइव दरें और CTT पॉइंट पर डिलीवरी CTT e-commerce API का उपयोग करते हैं। आपको enviosecommerce.ctt.pt पर CTT e-commerce खाता चाहिए (CTT Expresso अनुबंध वाले ग्राहकों के लिए, या CTT से प्रस्ताव माँगें)। उस खाते के की-प्रबंधन पेज पर एक सार्वजनिक और एक निजी कुंजी का जोड़ा बनाएँ। App ID (X-APPID) आपके एकीकरण के लिए CTT जारी करता है: अपने CTT e-commerce संपर्क से पूछें। CTT यह भी तय करता है कि आपका App ID कौन-से API फ़ंक्शन (लागत अनुमान, CTT पॉइंट) उपयोग कर सकता है। अंत में, आपके खाते में CTT का Carrier ID चाहिए। कुंजियाँ सेव होने के बाद सेटिंग्स पेज आपके खाते के कैरियर सूचीबद्ध करता है। यदि आप केवल प्राइस टेबल और घर पर डिलीवरी का उपयोग करते हैं, तो आपको API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. प्राइस टेबल भरें (कम से कम एक Portugal या * Default पंक्ति)। वैकल्पिक रूप से CTT API कुंजियाँ और Carrier ID भरें और Live rates चालू करें (देखें कॉन्फ़िगरेशन)।

6. WooCommerce > Settings > Shipping > Shipping zones में पुर्तगाल के लिए एक ज़ोन खोलें या बनाएँ और VibeFox CTT जोड़ें। मेथड सेटिंग्स में शीर्षक और डिलीवरी प्रकार चुनें। या Ignore shipping zones चालू करें और देश चुनें।

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

कीमतें, API कुंजियाँ और शर्तें एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox CTT। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप मेथड को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में दो फ़ील्ड होते हैं:

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

Delivery: To the customer's address (डिफ़ॉल्ट) या To a CTT point or parcel locker chosen at checkout। CTT पॉइंट के लिए वैश्विक सेटिंग्स में CTT API कुंजियाँ और Carrier ID चाहिए। एक ही ज़ोन में मेथड को दो बार जोड़ें, ताकि घर पर डिलीवरी और CTT पॉइंट डिलीवरी साथ-साथ दी जा सकें।

सेटिंग्स के ऊपर की चेतावनियाँ आपको पुर्तगाल के लिए गायब कीमत, अधूरी API कुंजियों, गायब Carrier ID, बिना विनिमय दर वाली स्टोर मुद्रा और CTT API से विफल कनेक्शन के बारे में बताती हैं। जब भी आप सेटिंग्स सेव करते हैं, कैश की गई CTT प्रतिक्रियाएँ साफ़ हो जाती हैं।

सामान्य

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

Name: चेकआउट पर दिखने वाला शिपिंग मेथड का नाम, उदाहरण के लिए "CTT Expresso"। डिफ़ॉल्ट: CTT। ज़ोन का Title इसे बदल देता है।

Tax status: Taxable कीमत के ऊपर WooCommerce शिपिंग टैक्स (उदाहरण के लिए IVA) जोड़ता है; None का अर्थ है कि कीमत अंतिम है।

CTT e-commerce API (लाइव दरें, CTT पॉइंट) (वैकल्पिक; कुंजियों के बिना प्राइस टेबल का उपयोग होता है)

Public key: आपके CTT e-commerce खाते के की-प्रबंधन पेज की सार्वजनिक कुंजी।

Private key: हर अनुरोध पर हस्ताक्षर करने के लिए उपयोग की जाने वाली गुप्त कुंजी (HMAC-SHA256)। यह कभी CTT को नहीं भेजी जाती और लॉग में नहीं लिखी जाती।

App ID (X-APPID): आपके एकीकरण के लिए CTT द्वारा जारी की गई एप्लिकेशन कुंजी।

Carrier ID: आपके खाते में CTT कैरियर का ID, जो लाइव दरों और CTT पॉइंट खोज के लिए उपयोग होता है। कुंजियाँ सेव होने के बाद आपके खाते के कैरियर इस फ़ील्ड के नीचे सूचीबद्ध होते हैं, और जो CTT पॉइंट का समर्थन करते हैं, उन पर चिह्न लगा होता है।

Live rates: ग्राहक द्वारा सड़क, पोस्टल कोड और शहर डालने के बाद CTT से कीमत (लागत अनुमान) माँगता है। जब तक पता अधूरा है, और जब भी CTT कीमत नहीं देता, तब प्राइस टेबल का उपयोग होता है। CTT इस कीमत को अनुमान कहता है। डिफ़ॉल्ट: बंद।

Service ID: वैकल्पिक। जब CTT कई सेवाएँ लौटाता है, तो वह सेवा उपयोग होती है जिसका यह ServiceId है। सबसे सस्ती सेवा के लिए खाली छोड़ें।

Exchange rate: CTT कीमतें यूरो में होती हैं। यदि आपकी स्टोर मुद्रा अलग है, तो बताएँ कि CTT मुद्रा की 1 इकाई के बराबर आपकी स्टोर मुद्रा की कितनी इकाइयाँ हैं। इसके बिना, किसी अन्य मुद्रा में लाइव दरें उपयोग नहीं होतीं और प्राइस टेबल लागू होती है।

Default product size (cm): बिना आयाम वाले उत्पादों के लिए CTT को भेजी गई लंबाई x चौड़ाई x ऊँचाई। डिफ़ॉल्ट: 30x20x15। जिन उत्पादों के आयाम हैं, वे अपने आयाम उपयोग करते हैं। आयाम cm में और वज़न आपकी स्टोर इकाइयों से grams में बदले जाते हैं।

कीमतें (सेक्शन शीर्षक आपकी स्टोर मुद्रा दिखाता है)

अपने CTT अनुबंध या CTT की सार्वजनिक मूल्य सूची की कीमतें स्टोर मुद्रा में डालें। लाइव दरें बंद होने पर यह टेबल कीमत तय करती है। लाइव दरें चालू होने पर यह बैकअप के रूप में काम करती है।

Price table: हर गंतव्य के लिए एक पंक्ति। एक देश चुनें, Portugal - Azores (PT-AC), Portugal - Madeira (PT-MA) या * Default (other destinations)। हर पंक्ति में एक बेस कीमत (Price) और आकार XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से ऊपर) के लिए वैकल्पिक कीमतें होती हैं। खाली (या 0) आकार-कीमत बेस कीमत का उपयोग करती है। जिस पंक्ति में दोनों खाली हों, वह मेथड छिपा देती है। Azores पंक्ति पुर्तगाली पोस्टल कोड 9500-9999 पर लागू होती है, और Madeira पंक्ति (Porto Santo सहित) 9000-9499 पर। इनके न होने पर Portugal पंक्ति लागू होती है। पंक्ति जोड़ने के लिए + Add destination पर क्लिक करें, और हटाने के लिए क्रॉस पर। कीमतें दशमलव बिंदु या अल्पविराम दोनों स्वीकार करती हैं। अमान्य पंक्तियाँ सेव करते समय बताई जाती हैं।

Calculation: टेबल की कीमत कैसे तय होती है।

लाइव CTT कीमत हमेशा पूरी शिपमेंट के लिए होती है।

शर्तें

Min weight (kg): मेथड दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं।

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

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

Excluded shipping classes: जब कार्ट का कोई भी आइटम इन WooCommerce शिपिंग क्लासों में से किसी एक का हो, तो मेथड छिपाएँ।

फ़्री शिपिंग

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

Free shipping from: कार्ट का सबटोटल (छूट के बाद, टैक्स से पहले) जिससे यह मेथड 0 लागत का होता है। यह तभी लागू होता है जब मेथड की कीमत हो। केवल तभी उपयोग होता है जब Free shipping चालू हो।

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

Ignore shipping zones: ग्राहक के ज़ोन में मेथड न होने पर, नीचे दिए देशों में यह मेथड देता है।

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

उन्नत

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

Remove data on uninstall: चालू होने पर, प्लगइन हटाने से उसकी सेटिंग्स और ज़ोन मेथड हट जाते हैं। प्लगइन निष्क्रिय करने से डेटा कभी नहीं हटता। ऑर्डर कभी नहीं बदले जाते।

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

जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से कीमत माँगता है। प्लगइन पहले कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास जाँचता है। Live rates चालू होने और पूरा पता होने पर, वह CTT को डिलीवरी पता और हर कार्ट लाइन के लिए मात्रा, grams में वज़न और cm में आयाम भेजता है, और लौटी कीमत दिखाता है। अन्यथा, या जब CTT कीमत नहीं देता (API त्रुटि, timeout, कवरेज नहीं, आपके App ID के लिए फ़ंक्शन सक्षम नहीं), तो कीमत टेबल से आती है। यदि फ़्री शिपिंग लागू होती है, तो कीमत 0 होती है।

CTT कीमत 1 घंटे तक कैश होती है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 5 मिनट तक याद रखा जाता है, ताकि चेकआउट हर रिफ़्रेश पर CTT का इंतज़ार न करे। API timeout 12 सेकंड है।

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

API कुंजियाँ भरे होने पर, प्लगइन CTT को डिलीवरी पता, उत्पादों के वज़न और आयाम, और आपके स्टोर का URL भेजता है, ताकि कीमत या निकटतम CTT पॉइंट मिल सकें।

प्लगइन शिपमेंट नहीं बनाता, लेबल नहीं छापता, पिकअप का अनुरोध नहीं करता, ट्रैकिंग नंबर नहीं देता, या CTT पॉइंट का मानचित्र नहीं दिखाता। पूरे स्टोर के लिए एक ही प्राइस टेबल और API सेटिंग्स का एक ही सेट है। ज़ोन केवल शीर्षक और डिलीवरी प्रकार में अलग होते हैं।

पिकअप पॉइंट

जिस ज़ोन मेथड का Delivery CTT पॉइंट पर सेट है, उसके लिए चेकआउट पर मेथड के नीचे एक खोज फ़ील्ड और एक सूची दिखती है। डिलीवरी पते की स्वतः खोज होती है। ग्राहक पोस्टल कोड या शहर से अन्य CTT पॉइंट खोज सकता है, और ऑर्डर देने से पहले एक चुनना आवश्यक है। यह सर्वर पर भी जाँचा जाता है। CTT पॉइंट सूचियाँ 6 घंटे तक कैश होती हैं। यदि CTT तक पहुँच नहीं हो पाती, तो ग्राहक को एक संदेश दिखता है और वह बाद में फिर कोशिश कर सकता है या कोई अन्य शिपिंग मेथड चुन सकता है।

चुना गया पॉइंट ऑर्डर में सेव होता है। यह ऑर्डर एडमिन में डिलीवरी पते के नीचे, ऑर्डर प्राप्ति पेज पर, My account > Orders में और ऑर्डर ईमेल (HTML और सादा टेक्स्ट दोनों) में CTT point के रूप में दिखता है।

ऑर्डर एडमिन में, CTT पॉइंट के आगे Change पर क्लिक करें, पोस्टल कोड या शहर से खोजें और कोई दूसरा पॉइंट चुनें। बदलाव तुरंत सेव होता है और ऑर्डर नोट जोड़ता है।

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

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

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

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

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

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

चेकआउट पर CTT नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मेथड ग्राहक के देश के ज़ोन में जोड़ा गया है (या Ignore shipping zones चालू है और देश की अनुमति है)। जाँचें कि गंतव्य की प्राइस टेबल में पंक्ति है (या * Default पंक्ति), कार्ट का वज़न Min weight और Max weight के बीच है, Minimum order amount पूरा है, और कोई उत्पाद बाहर रखी गई शिपिंग क्लास का नहीं है।

ग्राहक CTT पॉइंट नहीं चुन सकता: चयनकर्ता केवल उस ज़ोन मेथड के लिए दिखता है जिसका Delivery CTT पॉइंट पर सेट है, और केवल तभी जब सार्वजनिक कुंजी, निजी कुंजी, App ID और Carrier ID भरे हों। Debug log चालू करें और WooCommerce > Status > Logs देखें।

लाइव दरें नहीं दिखतीं: जब तक ग्राहक सड़क, पोस्टल कोड और शहर नहीं डालता, तब तक प्राइस टेबल उपयोग होती है। सेटिंग्स के ऊपर की चेतावनियाँ और लॉग देखें। "405" उत्तर का अर्थ है कि यह फ़ंक्शन आपके App ID के लिए सक्षम नहीं है: CTT से पूछें। यूरो में न चलने वाले स्टोर में Exchange rate भरें।

CTT API से कनेक्शन विफल: सेटिंग्स के ऊपर की चेतावनी त्रुटि दिखाती है। कुंजियाँ और App ID जाँचें। प्लगइन कुछ मिनट बाद अपने-आप फिर से कोशिश करता है।

टैक्स सहित या टैक्स रहित कीमतें: Tax status Taxable होने पर WooCommerce कीमत के ऊपर शिपिंग टैक्स जोड़ता है। None होने पर कीमत अंतिम होती है।

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

अनइंस्टॉल

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

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