VibeFox Packeta for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x.

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

Packeta API कुंजी: यह Packeta क्लाइंट सेक्शन (client.packeta.com) में Client support के अंतर्गत मिलती है। इसमें 16 अक्षर और अंक होते हैं। चेकआउट पर विजेट खुलने के लिए इसकी ज़रूरत होती है, इसलिए API कुंजी दर्ज करने के बाद ही कैरियर ग्राहकों को दिखाया जाता है।

देश: चेक गणराज्य, स्लोवाकिया, हंगरी या रोमानिया आपके स्टोर के सक्रिय देश होने चाहिए, और उस ज़ोन में हों जिससे कैरियर जुड़ा है।

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

इंस्टॉलेशन

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

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

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

4. अपनी Packeta API key और अपनी कीमतें दर्ज करें: Country prices की कम से कम एक पंक्ति (जैसे * Default) या एक Fallback cost। Save पर क्लिक करें। पेज दिखाता है कि Packeta ने कुंजी स्वीकार की या नहीं।

इंस्टॉल होने पर मॉड्यूल Packeta pickup point कैरियर बनाता है, जिसका डिलीवरी समय पाठ Packeta pickup point or Z-BOX होता है। यह चेक गणराज्य, स्लोवाकिया, हंगरी और रोमानिया के ज़ोन और सभी ग्राहक समूहों से जुड़ा होता है। ज़ोन, ग्राहक समूह, डिलीवरी समय और लोगो Shipping > Carriers में बदले जा सकते हैं। वहाँ कीमतें न सेट करें: कीमत हमेशा मॉड्यूल से आती है।

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

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

कैरियर केवल उन देशों के लिए दिया जाता है जो Packeta के अपने पिकअप-पॉइंट नेटवर्क में हैं: CZ, SK, HU और RO। सेटिंग्स के ऊपर पेज API कुंजी जाँच का परिणाम और समस्याओं की चेतावनियाँ दिखाता है: API कुंजी नहीं है, कीमत नहीं है, चुने गए देश Packeta नेटवर्क से बाहर हैं, कैरियर गायब है, या स्टोर की वज़न इकाई मॉड्यूल की पहचान में नहीं आती।

सभी कीमतें और सीमाएँ दशमलव विभाजक के रूप में कॉमा या बिंदु स्वीकार करती हैं (4,99 या 4.99)। गलत या ऋणात्मक संख्या एक संदेश के साथ अस्वीकार की जाती है, और पिछला मान बना रहता है।

सामान्य

Enable/Disable: चेकआउट पर Packeta को चालू या बंद करता है।

Name: ग्राहक को दिखाया जाने वाला कैरियर का नाम। यही Shipping > Carriers में कैरियर का नाम भी है। डिफ़ॉल्ट: Packeta pickup point। आवश्यक, अधिकतम 64 अक्षर।

API key: client.packeta.com > Client support से मिली आपकी Packeta API कुंजी। आप 32 अक्षरों का API पासवर्ड भी चिपका सकते हैं: उसके केवल पहले 16 अक्षर, यानी API कुंजी, सेव होते हैं। API कुंजी सार्वजनिक है: विजेट खोलने के लिए इसे ग्राहक के ब्राउज़र को भेजा जाता है। नई कुंजी सेव करने पर उसकी जाँच Packeta के कैरियर फ़ीड से होती है, और पेज पर Packeta API key verified दिखता है, या यह कि Packeta ने कुंजी अस्वीकार की है। अगर जाँच नहीं हो सकी, तो कुंजी सेव हो जाती है और अगली बार सेव करने पर फिर से जाँची जाती है।

Widget language: पिकअप पॉइंट विजेट की भाषा। Store / visitor language (डिफ़ॉल्ट) पेज की भाषा का पालन करती है। आप इसे चेक, स्लोवाक, हंगेरियन, रोमानियाई, अंग्रेज़ी, जर्मन, पोलिश या यूक्रेनी भाषा पर भी तय कर सकते हैं।

Pickup point types: विजेट कौन-से Packeta पॉइंट दिखाए।

Tax status: शिपिंग कीमत पर लागू होने वाले टैक्स नियम। None (no tax on shipping) या Taxable के साथ आपके टैक्स नियम समूहों में से कोई एक। यह चुनाव कैरियर पर सेव होता है।

कीमतें

Packeta के पास सार्वजनिक दर API नहीं है। कीमतें इस तालिका से आती हैं और आपके स्टोर की मूल मुद्रा में, टैक्स छोड़कर, दर्ज की जाती हैं। किसी और मुद्रा में भुगतान करने वाले ग्राहक परिवर्तित कीमत देखते हैं।

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

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

Fallback cost: तब उपयोग होता है जब कीमत-तालिका में गंतव्य के लिए कोई पंक्ति न हो और * Default पंक्ति भी न हो। उस स्थान पर कैरियर न देने के लिए इसे खाली छोड़ें।

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

उपलब्धता

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

Maximum weight (kg): कार्ट का वज़न इससे अधिक होने पर कैरियर छिपा देता है। डिफ़ॉल्ट: 15। Packeta पिकअप पॉइंट और Z-BOX आमतौर पर 15 kg तक के पार्सल स्वीकार करते हैं; अपना Packeta अनुबंध जाँचें। खाली या 0 का अर्थ है कोई सीमा नहीं। अधिकतम से बड़ा न्यूनतम वज़न सेव करते समय अस्वीकार होता है, और पिछले दोनों मान बने रहते हैं।

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

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

Countries (ignore zones mode): इस मोड के लिए गंतव्य देश। सभी Packeta देशों का उपयोग करने के लिए खाली छोड़ें। Packeta पिकअप-पॉइंट नेटवर्क से बाहर के देश छोड़ दिए जाते हैं। कई चुनने के लिए Ctrl दबाकर क्लिक करें। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।

उन्नत

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

Log (last lines): डीबग लॉग की ताज़ा प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

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

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

शिपिंग चरण में PrestaShop मॉड्यूल से Packeta की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल शर्तें जाँचता है: डिलीवरी का देश Packeta नेटवर्क में है या नहीं, API कुंजी, ज़ोन-अनदेखी मोड में देशों की सूची, कार्ट का वज़न और न्यूनतम कार्ट सबटोटल। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है। अन्यथा कीमत देश-तालिका से आती है, फिर फ़ॉलबैक शुल्क से। यदि कोई कीमत नहीं है, तो कैरियर छिपा दिया जाता है।

जब ग्राहक Packeta कैरियर चुनता है, तो उसके नीचे Choose pickup point बटन दिखता है। यह ग्राहक के ब्राउज़र में आधिकारिक Packeta विजेट खोलता है, जिसमें गंतव्य देश, कार्ट का वज़न, चुने गए पॉइंट प्रकार और विजेट की भाषा भेजी जाती है। ग्राहक द्वारा पॉइंट चुनने के बाद उसका नाम और पता कैरियर के नीचे दिखते हैं, और बटन Change pickup point में बदल जाता है। पॉइंट कार्ट के साथ सेव होता है और पेज दोबारा लोड होने पर बना रहता है। डिलीवरी पता बदलने पर किसी दूसरे देश के लिए चुना गया पॉइंट हटा दिया जाता है।

चेकआउट के दौरान आपका सर्वर Packeta से कुछ नहीं माँगता। विजेट स्क्रिप्ट widget.packeta.com से लोड होती है। यदि किसी विज्ञापन या गोपनीयता ब्लॉकर, कंटेंट सिक्योरिटी पॉलिसी, या Packeta की सेवा बाधा के कारण यह ब्लॉक हो जाती है, तो ग्राहक को यह संदेश दिखता है: "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."

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

Packeta की कीमतें लाइव नहीं माँगी जातीं; वे आपकी तालिका से आती हैं। मॉड्यूल Packeta शिपमेंट नहीं बनाता, लेबल नहीं छापता या पार्सल ट्रैक नहीं करता, और डिफ़ॉल्ट रूप से घर तक डिलीवरी या साझेदार कैरियरों के पिकअप पॉइंट नहीं देता। ऑर्डर का पिकअप पॉइंट ID अपने सामान्य तरीके से Packeta को दें, उदाहरण के लिए client.packeta.com पर आयात करके।

पिकअप पॉइंट

पिकअप पॉइंट ज़रूरी है। यदि ग्राहक बिना पॉइंट चुने शिपिंग चरण में Continue पर क्लिक करता है, तो वह चरण पूरा नहीं होता और ग्राहक को यह संदेश दिखता है: "Please choose a Packeta pickup point." यदि चुना गया पॉइंट डिलीवरी पते से अलग देश में है, तो ग्राहक को यह संदेश दिखता है: "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." मॉड्यूल पॉइंट ID की पुष्टि Packeta से नहीं करता; वह केवल यह जाँचता है कि कोई पॉइंट चुना गया है और उसका देश मेल खाता है।

ऑर्डर बनने पर पॉइंट उससे जोड़ दिया जाता है:

बैक ऑफिस ऑर्डर पेज: नाम, पता, Pickup point ID और देश वाला Packeta pickup point ब्लॉक। यदि किसी Packeta ऑर्डर में पॉइंट नहीं है, तो ब्लॉक कहता है: "No pickup point was selected for this order."

ऑर्डर पुष्टि और ऑर्डर विवरण पेज: Packeta pickup point: के साथ नाम और पता।

ऑर्डर ईमेल: ऑर्डर पुष्टि ईमेल में कैरियर की जानकारी के साथ पॉइंट का नाम और पता जोड़ा जाता है। विक्रेता के लिए नए ऑर्डर वाले ईमेल में Pickup point ID भी शामिल होता है।

पॉइंट मॉड्यूल की तालिका vfd_pckt_point (कार्ट, ऑर्डर, पॉइंट ID, नाम और पता, देश) में संग्रहीत होता है।

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

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

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

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

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

चेकआउट पर Packeta नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API key दर्ज है, और डिलीवरी देश CZ, SK, HU या RO है। जाँचें कि उस देश के लिए कीमत सेट है (देश की पंक्ति, * Default पंक्ति या Fallback cost), वज़न और सबटोटल की सीमाएँ, और यह कि कैरियर Shipping > Carriers में ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है (या Ignore shipping zones चालू है)। उत्पाद पेज पर उत्पादों को कुछ कैरियरों तक सीमित भी किया जा सकता है। सेटिंग्स पेज के ऊपर कॉन्फ़िगरेशन समस्याएँ सूचीबद्ध होती हैं। कारण Log (last lines) में देखने के लिए Debug log चालू करें।

Packeta ने API कुंजी अस्वीकार की: client.packeta.com > Client support से API कुंजी दोबारा कॉपी करें और सेव करें। तब तक चेकआउट पर विजेट नहीं खुल सकता।

विजेट नहीं खुलता: Packeta स्क्रिप्ट किसी विज्ञापन या गोपनीयता ब्लॉकर, कंटेंट सिक्योरिटी पॉलिसी या Packeta की सेवा बाधा से ब्लॉक हो गई है। अपनी कंटेंट सिक्योरिटी पॉलिसी में widget.packeta.com की अनुमति दें। डेवलपर actionVfdPcktWidgetUrl हुक से स्क्रिप्ट URL बदल सकते हैं।

गलती से शिपिंग मुफ़्त है: Country prices में वे पंक्तियाँ जाँचें जिनका Price 0 है, खासकर वह * Default पंक्ति जो Add country से जोड़ी गई और खाली छोड़ दी गई। साथ ही Free shipping from जाँचें।

वज़न सीमाएँ या वज़न कॉलम गलत लगते हैं: यदि पेज स्टोर की वज़न इकाई पर चेतावनी देता है, तो International > Localization (Local units) में kg, g, lb या oz सेट करें। अन्य इकाइयों को किलोग्राम माना जाता है।

अन्य देश या कैरियर: डिफ़ॉल्ट रूप से कैरियर CZ, SK, HU और RO के लिए काम करता है। डेवलपर actionVfdPcktCountries हुक से देश जोड़ सकते हैं, और actionVfdPcktWidgetOptions हुक से कैरियर ID विजेट को दे सकते हैं।

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

अनइंस्टॉल

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

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