VibeFox Correos CityPaq for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Correos API क्रेडेंशियल्स (केवल लाइव लॉकर सूची के लिए): Correos CityPaq सूची, Correos के "terminals" API से सक्रिय लॉकर पढ़ती है। Correos डेवलपर पोर्टल पर "terminals" API खोलें और अपने एप्लिकेशन के लिए Request access का उपयोग करें। Correos अपने व्यावसायिक ग्राहकों के अनुरोध स्वीकृत करता है और client ID तथा client secret भेजता है। ये पोर्टल पर My applications के अंतर्गत भी दिखते हैं। यदि ग्राहक लॉकर स्वयं दर्ज करते हैं या आपकी सूची से चुनते हैं, तो आपको API क्रेडेंशियल्स की आवश्यकता नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. प्राइस टेबल भरें और चुनें कि ग्राहक लॉकर कैसे चुनेगा (देखें कॉन्फ़िगरेशन)।

6. स्पेन के लिए शिपिंग ज़ोन में WooCommerce > Settings > Shipping > Shipping zones के अंतर्गत VibeFox Correos CityPaq जोड़ें, या Ignore shipping zones चालू करें।

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

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

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

सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि प्राइस टेबल में कोई उपयोगी पंक्ति नहीं है, चुना गया लॉकर विकल्प काम नहीं कर सकता (आपकी सूची में कोई लॉकर नहीं, API क्रेडेंशियल्स नहीं) और Correos API की अंतिम त्रुटि क्या थी। कीमतें और राशियाँ दशमलव कॉमा या दशमलव बिंदु, दोनों स्वीकार करती हैं।

सामान्य

CityPaq लॉकर केवल स्पेन में हैं, इसलिए यह विधि दूसरे देशों के लिए कभी नहीं दी जाती।

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

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Correos CityPaq।

Tax status: Taxable प्राइस टेबल की कीमतों पर WooCommerce टैक्स जोड़ता है; None नहीं जोड़ता।

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

Price table: Spain (ES) के लिए एक पंक्ति और/या डिफ़ॉल्ट पंक्ति *। हर पंक्ति में एक बेस Price और पार्सल आकारों XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से अधिक) के लिए वैकल्पिक कीमतें होती हैं। आकार की कीमत 0 हो या खाली हो, तो बेस कीमत उपयोग होती है। पंक्ति जोड़ने के लिए + Add row पर क्लिक करें और हटाने के लिए क्रॉस पर। Correos के अनुबंध की कीमतें अपनी स्टोर मुद्रा में दर्ज करें। मेल खाती पंक्ति न होने पर विधि छिप जाती है। अमान्य कीमतें और दोहराई गई पंक्तियाँ सेव करते समय बताई जाती हैं।

Calculation type: पार्सल का आकार कैसे तय होता है।

Per order (size by the total cart weight): पूरे कार्ट के लिए एक कीमत, कुल वज़न के अनुसार चुनी जाती है। यह डिफ़ॉल्ट है।

Per item (size by each item weight, multiplied by quantity): हर उत्पाद को अपने आकार की कीमत मिलती है, जिसे उसकी मात्रा से गुणा किया जाता है, और कीमतें जोड़ दी जाती हैं।

उत्पादों के वज़न को आपकी स्टोर की वज़न इकाई (kg, g, lbs या oz) से kg में बदला जाता है।

शर्तें

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

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

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

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

मुफ़्त शिपिंग

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

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

CityPaq लॉकर चयन

Locker selection: ऑर्डर देने से पहले ग्राहक लॉकर कैसे चुनता है। डिफ़ॉल्ट: ग्राहक लॉकर दर्ज करता है।

Customer chooses from the Correos CityPaq list (Correos API, credentials below): ग्राहक, डिलीवरी पते के पोस्टल कोड के सक्रिय CityPaq लॉकर देखता है और 5 अंकों का कोई दूसरा पोस्टल कोड खोज सकता है। जिस पोस्टल कोड पर लॉकर नहीं है, वहाँ पहले उसी क्षेत्र के, फिर उसी प्रांत के लॉकर सूचीबद्ध होते हैं, जिसमें निकटतम पोस्टल कोड पहले आते हैं। हर लॉकर में उसका नाम, पता, पोस्टल कोड, शहर और खुलने का समय दिखता है। यदि सूची लोड नहीं हो पाती या कुछ नहीं मिलता, तो ग्राहक लॉकर स्वयं दर्ज करता है।

Customer enters the locker (code or address from the Correos finder): लॉकर कोड (जैसे S0000213D) या पते के लिए आवश्यक फ़ील्ड, साथ में आधिकारिक Correos CityPaq फ़ाइंडर का लिंक।

Customer chooses from my list of lockers (below): My lockers के लॉकर से भरी आवश्यक ड्रॉप-डाउन सूची। ग्राहक के पोस्टल कोड के पास के लॉकर पहले दिखते हैं।

Do not ask for a locker: चेकआउट पर लॉकर के बारे में कोई प्रश्न नहीं पूछा जाता।

API क्रेडेंशियल्स के बिना Correos सूची चुनने पर, या My lockers खाली होने पर अपनी सूची चुनने पर, ग्राहकों से लॉकर स्वयं दर्ज करने को कहा जाता है।

My lockers: तब उपयोग होता है जब Locker selection आपकी सूची पर सेट हो। हर पंक्ति में एक लॉकर: CODE | Name | Address | Postal code | City। कोड और नाम आवश्यक हैं। अमान्य और दोहराई गई पंक्तियाँ सेव करते समय बताई जाती हैं।

Correos CityPaq सूची (API) (केवल Correos CityPaq सूची के साथ उपयोग होती है)

इस सेक्शन में Correos डेवलपर पोर्टल के "terminals" API पेज का लिंक है। केवल लॉकर की सूची पढ़ी जाती है। कीमतें हमेशा प्राइस टेबल से आती हैं।

API client ID: Correos डेवलपर पोर्टल पर आपके एप्लिकेशन का client_id।

API client secret: Correos डेवलपर पोर्टल पर आपके एप्लिकेशन का client_secret।

क्रेडेंशियल्स या लॉकर चयन बदलने पर कैश की गई लॉकर सूचियाँ साफ़ हो जाती हैं।

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

Ignore shipping zones: स्पेन के हर पते के लिए CityPaq देता है, भले ही कोई शिपिंग ज़ोन इस विधि को शामिल न करता हो। बंद (अनुशंसित) होने पर इसे वहीं दिया जाता है जहाँ आपने इसे किसी शिपिंग ज़ोन में जोड़ा है।

उन्नत

Debug log: WooCommerce > Status > Logs में, स्रोत vfd-correos-citypaq के साथ डीबग पंक्तियाँ लिखता है। Correos API त्रुटियाँ हमेशा लॉग होती हैं, भले ही यह विकल्प बंद हो। क्रेडेंशियल्स और व्यक्तिगत डेटा कभी लॉग नहीं होते।

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

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

जब ग्राहक स्पेन में डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से एक रेट माँगता है। प्लगइन कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखे गए शिपिंग क्लास जाँचता है, स्पेन (या * पंक्ति) की प्राइस पंक्ति और पार्सल आकार खोजता है, और कीमत दिखाता है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है।

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

Correos सूची हर पोस्टल कोड के लिए 12 घंटे कैश होती है। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रिफ़्रेश पर Correos का इंतज़ार न करे। API टाइमआउट 12 सेकंड है। ग्राहक को तकनीकी त्रुटि कभी नहीं दिखती, केवल एक छोटा संदेश और मैनुअल फ़ील्ड दिखते हैं।

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

प्लगइन Correos से लाइव रेट नहीं लेता, कोई मैप नहीं दिखाता, शिपमेंट पहले से पंजीकृत नहीं करता, लेबल प्रिंट नहीं करता, पिकअप का अनुरोध नहीं करता और पार्सल ट्रैक नहीं करता। ऑर्डर में सेव लॉकर का उपयोग करके अपने Correos खाते में शिपमेंट बनाएँ।

पिकअप पॉइंट

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

ऑर्डर एडमिन में आप Change CityPaq locker फ़ील्ड में लॉकर बदल सकते हैं: अपनी सूची से कोई दूसरा लॉकर चुनें, या नया कोड या पता टाइप करें। Correos सूची के साथ, टाइप किए गए लॉकर कोड की Correos पर जाँच होती है। मौजूदा लॉकर रखने के लिए फ़ील्ड खाली छोड़ें। हर बदलाव ऑर्डर में एक नोट जोड़ता है।

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

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

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

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

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

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

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

Correos सूची चुने होने पर भी ग्राहकों को लॉकर टाइप करना पड़ता है: जाँचें कि API client ID और API client secret भरे हुए हैं, और सेटिंग्स के ऊपर की चेतावनी देखें। उसमें Correos API की अंतिम त्रुटि दिखती है। HTTP 401/403 का मतलब है कि Correos ने क्रेडेंशियल्स अस्वीकार किए: उन्हें जाँचें और सुनिश्चित करें कि आपके एप्लिकेशन को "terminals" API की पहुँच है। त्रुटि के बाद अगला प्रयास 10 मिनट बाद होता है।

किसी पोस्टल कोड के लिए कोई लॉकर नहीं: Correos को उस पोस्टल कोड, उसके क्षेत्र या उसके प्रांत में कोई सक्रिय लॉकर नहीं मिला। ग्राहक कोई दूसरा पोस्टल कोड खोज सकता है, या Correos CityPaq फ़ाइंडर पर मिला लॉकर दर्ज कर सकता है।

मेरे लॉकर की ड्रॉप-डाउन सूची नहीं दिखती: My lockers खाली है या उसकी पंक्तियाँ अमान्य हैं। हर पंक्ति में कम से कम CODE | Name होना चाहिए।

ग्राहक लॉकर कोड कहाँ पाते हैं: लॉकर फ़ील्ड के नीचे लिंक किए गए Correos CityPaq फ़ाइंडर पर।

डेवलपर नोट्स: लॉकर ऑर्डर मेटा _vfd_cpq_locker (हर जगह दिखने वाला टेक्स्ट) और _vfd_cpq_locker_id (लॉकर कोड, जब वह Correos सूची या आपकी सूची से चुना गया हो) में सेव होता है। प्लगइन Correos का प्रोडक्शन "terminals" API उपयोग करता है। इस API के लिए कोई सैंडबॉक्स दस्तावेज़ित नहीं है।

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

अनइंस्टॉल

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

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