VibeFox DPD Pickup for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

DPD Slovakia: DPD Slovakia की सार्वजनिक parcelshop खोज को क्रेडेंशियल की आवश्यकता नहीं होती।

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

इंस्टॉलेशन

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

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox DPD Pickup ढूँढकर Configure पर क्लिक करें।

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

4. अपना DPD API चुनें। DPD लिथुआनिया, लातविया या एस्टोनिया के लिए API का उपयोगकर्ता नाम और पासवर्ड दर्ज करें। देश के अनुसार कीमतें जाँचें और Save पर क्लिक करें। फिर कनेक्शन जाँचने के लिए Refresh pickup points पर क्लिक करें (कॉन्फ़िगरेशन देखें)।

इंस्टॉल होने पर मॉड्यूल DPD Pickup point or locker डिलीवरी समय पाठ के साथ DPD Pickup Point कैरियर बनाता है। यह कैरियर स्लोवाकिया, लिथुआनिया, लातविया और एस्टोनिया के ज़ोन और सभी ग्राहक समूहों से जुड़ता है, बिना टैक्स नियम के। ज़ोन, ग्राहक समूह, डिलीवरी समय का पाठ, लोगो और आकार की सीमाएँ आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox DPD Pickup > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर कैश की गई पिकअप पॉइंट सूचियाँ भी साफ़ हो जाती हैं।

पेज के शीर्ष पर दी गई चेतावनियाँ बताती हैं कि DPD Baltic का उपयोगकर्ता नाम या पासवर्ड कब खाली है, कब कोई कीमत सेट नहीं है (दोनों स्थितियों में चेकआउट पर कैरियर नहीं दिखता), कब कैरियर हटाया गया है, और कब दुकान की वज़न इकाई (International > Localization, Local units) मॉड्यूल को ज्ञात नहीं है, जिससे उत्पादों का वज़न kg माना जाता है। किसी राशि या वज़न फ़ील्ड में ऐसा मान जो संख्या नहीं है, या ऋणात्मक संख्या, सहेजी नहीं जाती: फ़ील्ड खाली हो जाता है और चेतावनी उसका नाम बताती है। Country prices की वे पंक्तियाँ जो CC:PRICE प्रारूप में नहीं हैं, चेतावनी में सूचीबद्ध होती हैं और अनदेखी की जाती हैं।

सामान्य

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

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

Tax status: शिपिंग कीमत पर लागू होने वाला कैरियर का टैक्स नियम। None का अर्थ है कोई टैक्स नहीं। अन्य विकल्प Taxable के साथ आपकी दुकान के किसी टैक्स नियम का नाम दिखाते हैं।

DPD पिकअप पॉइंट सूची

पिकअप पॉइंट DPD से लोड होते हैं और 24 घंटे के लिए कैश होते हैं।

DPD API: वह DPD कंपनी जिसके साथ आपका खाता है। Baltic खाते अपने देश की वेब सेवा का उपयोग करते हैं।

API username (Baltic): आपका DPD Baltic वेब सेवा उपयोगकर्ता नाम। DPD Slovakia के लिए आवश्यक नहीं। इसे खाली करने पर सहेजा गया पासवर्ड भी हट जाता है।

API password (Baltic): आपका DPD Baltic वेब सेवा पासवर्ड। DPD Slovakia के लिए आवश्यक नहीं। सहेजने के बाद यह फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Pickup points: Refresh pickup points बटन कैश साफ़ करता है और अभी DPD से पिकअप पॉइंट लोड करता है: Baltic API के लिए लिथुआनिया, लातविया और एस्टोनिया, तथा DPD Slovakia के लिए ब्रातिस्लावा में एक परीक्षण खोज। यह प्रत्येक देश के लिए पिकअप पॉइंट की संख्या या त्रुटि दिखाता है। पहले सेटिंग्स सहेजें।

कीमतें

शिपिंग कीमतें देश के अनुसार निश्चित हैं, आपकी दुकान की डिफ़ॉल्ट मुद्रा में, टैक्स को छोड़कर। DPD की कीमतें API से नहीं माँगी जातीं।

Country prices: हर देश के लिए एक पंक्ति: CC:कीमत, जैसे EE:3.50। दशमलव के लिए अल्पविराम भी स्वीकार है। डिफ़ॉल्ट: SK:3.50, LT:4.00, LV:4.00, EE:4.00।

Fallback cost: उन देशों के लिए कीमत जो Country prices में नहीं हैं। डिफ़ॉल्ट: 5.00। केवल सूचीबद्ध देशों में कैरियर देने के लिए इसे खाली छोड़ें।

Calculation type: Per order कीमत एक बार लेता है। Per item (price x quantity) कीमत को कार्ट में आइटमों की संख्या से गुणा करता है।

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

उपलब्धता

कैरियर तब भी छिप जाता है जब DPD ग्राहक के पते के लिए कोई पिकअप पॉइंट नहीं लौटाता या DPD API तक पहुँचा नहीं जा सकता, क्योंकि बिना पिकअप पॉइंट के ऑर्डर डिलीवर नहीं हो सकता।

Min weight (kg): कार्ट का न्यूनतम वज़न। उत्पादों का वज़न आपकी दुकान की वज़न इकाई से बदला जाता है। खाली या 0 का अर्थ है कोई सीमा नहीं।

Max weight (kg): इससे भारी कार्ट को कैरियर नहीं दिखता। डिफ़ॉल्ट: 31.5। 0 का अर्थ है कोई सीमा नहीं। अपने देश में DPD पिकअप पॉइंट और लॉकर की पार्सल सीमाएँ जाँचें। Max weight (kg) से बड़ा Min weight (kg) अस्वीकार किया जाता है, और कुछ भी सहेजा नहीं जाता।

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

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

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

पिकअप पॉइंट चयनकर्ता

City order: प्रमुख शहर (तालिन, रीगा, विल्नियस, ब्रातिस्लावा और अन्य) पहले दिखाता है। डिफ़ॉल्ट रूप से चालू।

City list width: शहर सूची की CSS चौड़ाई, जैसे 100% या 300px। डिफ़ॉल्ट: 100%।

Pickup point list width: पिकअप पॉइंट सूची की CSS चौड़ाई, जैसे 100% या 400px। डिफ़ॉल्ट: 100%।

उन्नत

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

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

Remove data on uninstall: चालू होने पर मॉड्यूल हटाने से मॉड्यूल की सेटिंग्स और कैरियर हट जाते हैं। ऑर्डर में सहेजा गया पिकअप पॉइंट हमेशा बना रहता है।

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

शिपिंग चरण पर PrestaShop मॉड्यूल से DPD Pickup की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल देश (Ignore shipping zones के साथ), कार्ट का वज़न और न्यूनतम सबटोटल जाँचता है, उस देश की कीमत (या फ़ॉलबैक लागत) लेता है, और यदि सबटोटल पर्याप्त है तो मुफ़्त शिपिंग लागू करता है। फिर वह पते के लिए DPD पिकअप पॉइंट लोड करता है। यदि DPD कोई भी नहीं लौटाता, उससे संपर्क नहीं हो पाता, या Baltic क्रेडेंशियल नहीं हैं, तो कैरियर छिप जाता है। कीमत दुकान की डिफ़ॉल्ट मुद्रा में गणना की जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

पिकअप पॉइंट सूची 24 घंटे और खाली सूची 1 घंटे के लिए कैश होती है। असफल अनुरोध 5 मिनट तक याद रखा जाता है, इसलिए DPD की रुकावट चेकआउट को कभी धीमा नहीं करती। API समय-सीमा 15 सेकंड है।

यदि आप Shipping > Carriers में किसी कैरियर को उसके ऑर्डर होने के बाद संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सहेजता है। मॉड्यूल नए संस्करण का अपने-आप पालन करता है।

मॉड्यूल DPD की कीमतें नहीं माँगता, DPD शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, मैनिफ़ेस्ट नहीं बनाता, कूरियर पिकअप का ऑर्डर नहीं देता, पार्सल ट्रैक नहीं करता या मानचित्र नहीं दिखाता। केवल DPD Baltic वेब सेवा और DPD Slovakia parcelshop खोज समर्थित हैं।

पिकअप पॉइंट

जब ग्राहक DPD Pickup चुनता है, तो कैरियर के नीचे एक शहर सूची और एक पिकअप पॉइंट सूची दिखती है। ग्राहक के पते का शहर पहले से चुना होता है। ग्राहक के चुनते ही चुनाव कार्ट में सहेज लिया जाता है। DPD Slovakia के साथ, पता पूरा होने तक ग्राहक को Enter your city and postcode to see the DPD pickup points nearby. दिखता है, उसके बाद आस-पास के पॉइंट। यदि DPD के पास उस पते के लिए कोई पॉइंट नहीं है, तो ग्राहक को No DPD pickup points are available for this address right now. Please check the address or choose another shipping method. दिखता है।

पिकअप पॉइंट आवश्यक है। उसके बिना ग्राहक आगे नहीं बढ़ सकता और उसे Please select a DPD pickup point. दिखता है। सर्वर जाँचता है कि पॉइंट ग्राहक के पते के लिए DPD सूची का है। जाली या पुराना चुनाव The selected DPD pickup point is not available for this address. Please choose another one. के साथ अस्वीकार किया जाता है।

चुना गया पॉइंट ऑर्डर में सहेजा जाता है। यह ऑर्डर कन्फ़र्मेशन पेज और ग्राहक के ऑर्डर विवरण में DPD pickup point: के रूप में दिखता है। ऑर्डर कन्फ़र्मेशन ईमेल में यह कैरियर के नाम के बाद जोड़ा जाता है। दुकान को जाने वाला नया ऑर्डर ईमेल (ps_emailalerts) भी पॉइंट ID दिखाता है। ऑर्डर में सहेजा गया नाम DPD से आता है, ब्राउज़र से नहीं।

बैक ऑफिस के ऑर्डर पेज पर DPD pickup point ब्लॉक पॉइंट का नाम, उसकी ID और देश दिखाता है। Edit पर क्लिक करें, एक शहर और दूसरा पॉइंट चुनें, फिर Save पर क्लिक करें। पॉइंट की जाँच ऑर्डर के पते के लिए DPD सूची से होती है, और पेज Pickup point updated. या Pickup point not found for the order address. दिखाता है। पॉइंट बदलने के लिए ऑर्डर संपादित करने की अनुमति चाहिए, Modules पेज तक पहुँच नहीं। हर बदलाव ऑर्डर के Advanced Parameters > Logs में पुराने पॉइंट, नए पॉइंट और कर्मचारी के साथ दर्ज होता है। DPD Slovakia के साथ पॉइंट बदलने के लिए ऑर्डर में डिलीवरी शहर और पिन कोड होना चाहिए।

यदि एक कार्ट कई ऑर्डरों में बँटती है, तो पिकअप पॉइंट पहले ऑर्डर के साथ रहता है। अन्य ऑर्डर No pickup point was selected for this order. दिखाते हैं, डीबग लॉग में उनमें से हर एक के लिए त्रुटि होती है, और वहाँ का Edit The pickup point of this cart belongs to another order of the same cart. Nothing was changed. दिखाता है। ऐसे ऑर्डर का पॉइंट आपको DPD को हाथ से देना होगा।

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

मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox DPD Pickup Modules > Module Manager > VibeFox DPD Pickup > Configure का पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी छिपाकर (मास्क करके), स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) दिखती है, साथ ही बटन: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस दुकान से कुंजी हटाने के लिए। इनके नीचे पंक्ति Product: presta-shipping-dpd-pickup और लिंक 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 खाते में स्लॉट मुक्त करें।

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

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

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

चेकआउट पर DPD Pickup नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है (या Ignore shipping zones चालू है और देश की अनुमति है)। मॉड्यूल पेज के शीर्ष की चेतावनियाँ देखें और Refresh pickup points पर क्लिक करें। वज़न और सबटोटल सीमाएँ जाँचें और यह भी कि देश की कोई कीमत (या फ़ॉलबैक लागत) है। उत्पाद पेज पर उत्पादों को कुछ कैरियरों तक सीमित भी किया जा सकता है।

Refresh pickup points के बाद त्रुटि: परिणाम में हर देश के लिए DPD त्रुटि दिखती है। उदाहरण के लिए, "Login failed" का अर्थ है कि DPD ने Baltic क्रेडेंशियल अस्वीकार किए, इसलिए कोई पिकअप पॉइंट लोड नहीं हो सकता। DPD से API उपयोगकर्ता नाम और पासवर्ड जाँचें।

DPD Slovakia में कोई पॉइंट नहीं दिखता: पॉइंट तब दिखते हैं जब ग्राहक शहर और पिन कोड दर्ज कर देता है। DPD केवल उस पते के 50 km के भीतर के पॉइंट सूचीबद्ध करता है। डेवलपर मॉड्यूल हुक actionVfdDpdSkSearchRadius से दायरा बदल सकते हैं।

कारण ढूँढना: Debug log चालू करें, चेकआउट दोबारा लोड करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। हर निर्णय वहाँ लिखा जाता है। API त्रुटियाँ हमेशा दर्ज होती हैं। API उपयोगकर्ता नाम और पासवर्ड लॉग में कभी नहीं लिखे जाते।

बदलाव के बाद पिकअप पॉइंट पुराने लगते हैं: मॉड्यूल पेज पर Save या Refresh pickup points पर क्लिक करें। दोनों कैश की गई सूचियाँ साफ़ कर देते हैं।

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

अनइंस्टॉल

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

DPD अपने-अपने स्वामी का ट्रेडमार्क है। यह मॉड्यूल DPD से संबद्ध नहीं है और DPD द्वारा अनुमोदित नहीं है।