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

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।

स्पेन में डिलीवरी: CityPaq लॉकर केवल स्पेन में उपलब्ध हैं, इसलिए कैरियर केवल स्पेन के डिलीवरी पतों के लिए दिखाया जाता है।

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

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Correos CityPaq खोजकर Configure पर क्लिक करें।

3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

इंस्टॉल होने पर मॉड्यूल Correos CityPaq कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट Delivery to a Correos CityPaq parcel locker होता है। कैरियर सभी ग्राहक समूहों और स्पेन ज़ोन को असाइन किया जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ Shipping > Carriers में बदली जा सकती हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Correos CityPaq > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। कीमतें और राशियाँ दशमलव कॉमा या दशमलव बिंदु दोनों स्वीकार करती हैं।

सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं: जब कैरियर नहीं मिला, जब प्राइस टेबल में स्पेन की पंक्ति और डिफ़ॉल्ट पंक्ति दोनों नहीं हैं, जब चुना गया लॉकर चयन काम नहीं कर सकता (आपकी सूची में कोई लॉकर नहीं, API क्रेडेंशियल्स नहीं), Correos API की अंतिम त्रुटि क्या थी, और जब आपके स्टोर की वज़न इकाई मॉड्यूल को ज्ञात नहीं है (तब उत्पादों के वज़न kg माने जाते हैं; International > Localization में kg, g, lb या oz सेट करें)। यदि नाम खाली, अमान्य या 64 अक्षरों से लंबा है, यदि कोई वज़न या राशि 0 या उससे अधिक की वैध संख्या नहीं है, या यदि Min weight (kg), Max weight (kg) से बड़ा है, तो पेज एक त्रुटि दिखाता है और कुछ भी सेव नहीं होता। प्राइस टेबल की अमान्य कीमतें और My lockers की अमान्य या दोहराई गई पंक्तियाँ चेतावनी के रूप में बताई जाती हैं, और बाकी सेव हो जाता है।

सामान्य

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

Enable/Disable: Correos CityPaq शिपिंग चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। यह कैरियर का नाम भी है। डिफ़ॉल्ट: Correos CityPaq। आवश्यक, अधिकतम 64 अक्षर।

Tax: कैरियर का टैक्स नियम। PrestaShop इस टैक्स को टेबल की कीमतों के ऊपर जोड़ता है। No tax का अर्थ है कि कीमतें अंतिम हैं।

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

Correos CityPaq के लिए रेट API प्रकाशित नहीं करता, इसलिए कीमत इसी टेबल से आती है। Correos के साथ अपने अनुबंध की कीमतें स्टोर की डिफ़ॉल्ट मुद्रा में, बिना टैक्स के दर्ज करें।

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

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

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

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

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

शर्तें

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

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

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

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

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

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

CityPaq लॉकर चयन

इस सेक्शन में Correos CityPaq के आधिकारिक फ़ाइंडर का लिंक है।

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

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

Customer enters the locker (code or address from the Correos finder): लॉकर कोड (जैसे S0000213D) या पते के लिए एक आवश्यक फ़ील्ड, 3 से 120 अक्षर, जिसमें 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।

सेव करने के बाद, दोनों फ़ील्ड खाली रहते हैं और Saved - leave empty to keep it दिखाते हैं। केवल बदलने के लिए नया मान दर्ज करें। सेव किए गए client ID और client secret हटाने के लिए Remove the saved client ID and client secret पर निशान लगाएँ और Save पर क्लिक करें। कुछ सेव न होने पर सेक्शन No credentials saved दिखाता है। क्रेडेंशियल्स या लॉकर चयन बदलने पर कैश की गई लॉकर सूचियाँ साफ़ हो जाती हैं।

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

Ignore shipping zones: स्पेन के हर पते के लिए CityPaq उपलब्ध कराता है, भले ही पते का ज़ोन कैरियर से जुड़ा न हो। चालू होने पर कैरियर बाद में बने ज़ोन सहित सभी सक्रिय ज़ोन से जुड़ जाता है। फिर से बंद करने पर कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं। बंद (अनुशंसित) का अर्थ है कि Shipping > Carriers में सेट ज़ोन उपयोग होते हैं।

उन्नत

Debug log: मॉड्यूल फ़ोल्डर में logs/vfd_cpq_debug.log.php में डीबग लाइनें लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। यह बंद होने पर भी Correos API त्रुटियाँ हमेशा लिखी जाती हैं। क्रेडेंशियल्स और व्यक्तिगत डेटा कभी लॉग नहीं किए जाते।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।

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

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

शिपिंग चरण पर PrestaShop मॉड्यूल से CityPaq की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। मॉड्यूल जाँचता है कि डिलीवरी पता स्पेन में है, कार्ट का वज़न और न्यूनतम ऑर्डर राशि ठीक है, स्पेन की मूल्य पंक्ति (या * पंक्ति) और पार्सल आकार ढूँढता है, और कीमत लौटाता है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है। कीमत आपकी स्टोर की डिफ़ॉल्ट मुद्रा में गणना होती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है। टैक्स कैरियर के टैक्स नियम से जोड़ा जाता है।

जब ग्राहक CityPaq चुनता है, तो कैरियर के नीचे CityPaq locker बॉक्स दिखता है। ग्राहक जैसे ही चुनाव करता है, वह कार्ट में सेव हो जाता है। अस्वीकार्य लॉकर को एक संदेश के साथ अस्वीकार किया जाता है, और पिछला चुनाव बना रहता है। Correos सूची के साथ, लॉकर कोड तभी स्वीकार होता है जब Correos ने उसे खोजे गए पोस्टल कोड के लिए दिया हो, और उसका नाम तथा पता Correos से लिया जाता है। ग्राहक प्रति कार्ट अधिकतम 30 अलग-अलग पोस्टल कोड खोज सकता है। उसके बाद उसे Too many searches. Please enter the CityPaq locker you found on the Correos map. दिखता है।

शिपिंग चरण का Continue बटन वैध लॉकर के बिना आगे नहीं बढ़ता। यह सर्वर पर भी जाँचा जाता है। ग्राहक को उदाहरण के लिए Please choose the CityPaq locker where you want to collect your parcel. दिखता है। ऑर्डर देने पर कार्ट का लॉकर ऑर्डर में सेव हो जाता है।

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

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

पिकअप बिंदु

चुना गया लॉकर ऑर्डर में सेव होता है। ग्राहक इसे ऑर्डर पुष्टि पेज पर और अपने ग्राहक खाते में ऑर्डर विवरण पेज पर CityPaq locker: के रूप में देखता है। ऑर्डर पुष्टि ईमेल में और Mail alerts मॉड्यूल के नए ऑर्डर ईमेल में लॉकर कैरियर की पंक्ति में जुड़ जाता है, जैसे Correos CityPaq - CityPaq locker: ...।

एडमिन के ऑर्डर पेज पर CityPaq locker ब्लॉक लॉकर और, यदि सूची से चुना गया हो, तो उसका Locker code: दिखाता है। इसे बदलने के लिए Change CityPaq locker फ़ील्ड का उपयोग करें और Save पर क्लिक करें: आपकी सूची के साथ, ड्रॉप-डाउन से दूसरा लॉकर चुनें; Correos सूची के साथ, लॉकर कोड (जिसकी Correos पर जाँच होती है) या पता दर्ज करें; बाकी मामलों में नया कोड या पता दर्ज करें। मौजूदा लॉकर रखने के लिए फ़ील्ड खाली छोड़ें। हर बदलाव ऑर्डर में एक निजी ऑर्डर संदेश जोड़ता है: CityPaq लॉकर बदला गया: ...। लॉकर बदलने के लिए ऑर्डर संपादित करने की अनुमति चाहिए। Modules पेजों तक पहुँच की ज़रूरत नहीं है।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। License — VibeFox Correos CityPaq लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox Correos CityPaq > Configure में सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक में छिपी हुई कुंजी, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-shipping-correos-citypaq वाली पंक्ति और लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल के लिए Configure अनुमति वाले कर्मचारी ही कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल आखिरी ज्ञात स्थिति के आधार पर काम करता रहता है।

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

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Correos CityPaq कैरियर नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए कैरियर आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

जब लाइसेंस की अवधि समाप्त होती है, मॉड्यूल चलता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। बैक ऑफिस में काम करते समय स्थिति अपने-आप फिर से जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब नहीं चाहिए। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।

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

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

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

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

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

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

पेज कहता है कि कैरियर नहीं मिला, या कैरियर अपडेट नहीं हो सका: कैरियर Shipping > Carriers में हटा दिया गया था। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें। रीसेट सेटिंग्स और कैरियर की स्थिति रखता है।

डेवलपर नोट्स: कार्ट और ऑर्डर का लॉकर vfd_cpq_locker तालिका में (आपके डेटाबेस प्रीफ़िक्स के साथ) सेव होता है। मॉड्यूल Correos के प्रोडक्शन "terminals" API का उपयोग करता है।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Correos CityPaq के बगल वाला मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी, लाइसेंस स्थिति, कैश की गई Correos लॉकर सूचियाँ और अंतिम API त्रुटि हमेशा हटा दी जाती हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटा दिया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग और बिना ऑर्डर वाली कार्ट के लॉकर हटा दिए जाते हैं। यदि यह बंद है, तो कैरियर केवल निष्क्रिय किया जाता है और सारी सेटिंग्स रखी जाती हैं। मॉड्यूल फिर से इंस्टॉल करने पर कैरियर की पिछली स्थिति लौट आती है। ऑर्डर में सेव हुए लॉकर कभी नहीं हटाए जाते।

Correos और CityPaq उनके संबंधित स्वामियों के ट्रेडमार्क हैं। यह मॉड्यूल Correos से संबद्ध नहीं है और Correos द्वारा समर्थित नहीं है।