बहुत कम कंपनियाँ एक ही सिस्टम पर चलती हैं। जब Odoo मुख्य ERP हो, तब भी उसे आमतौर पर किसी पेमेंट गेटवे, शिपिंग कैरियर, बैंक, ऑनलाइन स्टोर, अटेंडेंस डिवाइस या पुराने एप्लिकेशन से संवाद करना पड़ता है। इन कड़ियों की गुणवत्ता तय करती है कि आपका डेटा भरोसेमंद है या आपकी टीम हर महीने अंतरों का हाथ से मिलान करने में समय लगाती है।
Odoo 19 Enterprise एक परतदार टूलबॉक्स देता है: ऐप्स से कॉन्फ़िगर किए जाने वाले बिल्ट-इन कनेक्टर, डेवलपर्स के लिए एक्सटर्नल API, वेबहुक प्राप्त करने और भेजने वाले ऑटोमेशन नियम, और उन मामलों के लिए फ़ाइल इम्पोर्ट जहाँ लाइव कनेक्शन संभव नहीं है। जब आपको कई सिस्टम के बीच समन्वय चाहिए, तो मिडलवेयर टूल इनके ऊपर काम करते हैं।
स्रोतों के बारे में एक टिप्पणी: यह लेख संस्करण 19.0 के लिए Odoo के आधिकारिक दस्तावेज़ों (odoo/documentation रिपॉज़िटरी) पर आधारित है। मेनू, विकल्प और प्लान की शर्तें संस्करणों और होस्टिंग प्रकारों के बीच बदल सकती हैं, इसलिए प्रोडक्शन में लागू करने से पहले हर चरण की पुष्टि हमेशा किसी टेस्ट या डुप्लिकेट डेटाबेस में करें।
सही इंटीग्रेशन पैटर्न चुनें
तकनीक से नहीं, व्यावसायिक ज़रूरत से शुरुआत करें। पूछें कि कौन-सा डेटा जाना चाहिए, किस दिशा में, कितनी जल्दी, और मास्टर रिकॉर्ड का स्वामी कौन है। फिर ज़रूरत पूरी करने वाला सबसे हल्का विकल्प चुनें।
- बिल्ट-इन कनेक्टर का उपयोग तब करें जब Odoo पहले से प्रदाता को सपोर्ट करता हो, जैसे सूचीबद्ध पेमेंट प्रोवाइडर, शिपिंग कैरियर, बैंक सिंक्रोनाइज़ेशन प्रदाता या Amazon कनेक्टर।
- एक्सटर्नल API का उपयोग तब करें जब किसी दूसरे एप्लिकेशन को अपने शेड्यूल पर Odoo रिकॉर्ड पढ़ने या लिखने हों।
- इनकमिंग वेबहुक का उपयोग तब करें जब किसी बाहरी सिस्टम को कोई घटना होते ही उसे Odoo में भेजना हो।
- आउटगोइंग वेबहुक का उपयोग तब करें जब Odoo को किसी बदलाव के बाद दूसरे सिस्टम को सूचित करना हो, उदाहरण के लिए जब कोई रिकॉर्ड बने या कोई फ़ील्ड अपडेट हो।
- मिडलवेयर का उपयोग तब करें जब कई सिस्टम शामिल हों, जब डेटा में भारी रूपांतरण की ज़रूरत हो, या जब आपको केंद्रीय पुनःप्रयास और मॉनिटरिंग चाहिए।
- फ़ाइल इम्पोर्ट का उपयोग तब करें जब दूसरा पक्ष केवल फ़ाइलें देता हो, जैसे CAMT.053, OFX, QIF, CSV या XLSX फ़ॉर्मेट में बैंक स्टेटमेंट।
Odoo 19 में एक्सटर्नल API: JSON-2 और API कुंजियाँ
Odoo 19 में JSON-2 API पेश किया गया है, जो ORM के एक हिस्से को HTTP पर उपलब्ध कराता है। हर कॉल /json/2/ के बाद मॉडल नाम और मेथड नाम वाले एंडपॉइंट पर एक POST अनुरोध होती है, उदाहरण के लिए res.partner मॉडल का search_read मेथड। अनुरोध के बॉडी में मेथड के आर्ग्युमेंट JSON के रूप में होते हैं।
ऑथेंटिकेशन के लिए Authorization हेडर में बेयरर टोकन के रूप में भेजी गई API कुंजी का उपयोग होता है। यूज़र ID और पासवर्ड के साथ कोई अलग लॉगिन चरण नहीं है, इसलिए कुंजी ही यूज़र की पहचान करती है और इंटीग्रेशन उसी यूज़र के एक्सेस अधिकारों के साथ काम करता है।
कुंजी मैन्युअल रूप से बनाने के लिए अपनी यूज़र Preferences खोलें, Account Security पर जाएँ और New API Key चुनें। विवरण और अवधि आवश्यक हैं, और कुंजी का मान केवल एक बार दिखाया जाता है, इसलिए उसे तुरंत किसी सुरक्षित सीक्रेट वॉल्ट में रखें। दस्तावेज़ों के अनुसार कुंजियाँ तीन महीने से अधिक के लिए नहीं बनाई जा सकतीं, इसलिए शुरुआत से ही कुंजी रोटेशन की दिनचर्या की योजना बनाएँ।
जब एक सर्वर कई डेटाबेस होस्ट करता है, तो वैकल्पिक X-Odoo-Database हेडर Odoo को बताता है कि कॉल किस डेटाबेस के लिए है। रिवर्स प्रॉक्सी के पीछे यह सुनिश्चित करें कि Host हेडर Odoo तक सही ढंग से पहुँचे।
हर JSON-2 कॉल अपने डेटाबेस ट्रांज़ैक्शन में चलती है: सफल होने पर कमिट होती है और त्रुटि पर रोलबैक। आप कई कॉल को एक ट्रांज़ैक्शन में नहीं जोड़ सकते, इसलिए ऐसी कई छोटी कॉल के बजाय, जो डेटा को आधा-अधूरा अपडेट छोड़ सकती हैं, संबंधित काम करने वाले एक ही मेथड को प्राथमिकता दें, जैसे search_read या कोई बिज़नेस मेथड।
त्रुटियाँ 4xx या 5xx HTTP स्टेटस और एक JSON बॉडी के साथ लौटाई जाती हैं जिसमें name और message शामिल होते हैं। आपके क्लाइंट कोड को दोनों पढ़कर लॉग करने चाहिए।
पुराने XML-RPC और JSON-RPC: अपने माइग्रेशन की योजना बनाएँ
कई मौजूदा इंटीग्रेशन पुराने XML-RPC एंडपॉइंट या JSON-RPC एंडपॉइंट का उपयोग करते हैं। Odoo 19 में ये डिप्रिकेटेड हैं, और आधिकारिक दस्तावेज़ों के अनुसार इन्हें Odoo 22 में हटाया जाना निर्धारित है। ये आज भी काम करते हैं, लेकिन नई परियोजनाएँ JSON-2 पर बनाई जानी चाहिए, और मौजूदा परियोजनाओं को सूचीबद्ध करके अपने अपग्रेड रोडमैप के हिस्से के रूप में माइग्रेट किया जाना चाहिए।
- पुराने एंडपॉइंट को कॉल करने वाली हर स्क्रिप्ट, कनेक्टर और थर्ड-पार्टी टूल की सूची बनाएँ।
- लॉगिन और पासवर्ड ऑथेंटिकेशन को हर इंटीग्रेशन के लिए समर्पित API कुंजियों से बदलें।
- प्रति कॉल एक ट्रांज़ैक्शन वाले व्यवहार के कारण, जहाँ संभव हो, बहु-चरणीय क्रमों को एक ही कॉल में फिर से लिखें।
- प्रोडक्शन ट्रैफ़िक बदलने से पहले माइग्रेट किए गए संस्करण का किसी डुप्लिकेट डेटाबेस पर परीक्षण करें।
प्लान की उपलब्धता भी मायने रखती है। दस्तावेज़ों के अनुसार एक्सटर्नल API के माध्यम से डेटा तक पहुँच केवल Custom Odoo प्राइसिंग प्लान पर उपलब्ध है, One App Free या Standard पर नहीं। Odoo Online पर API-आधारित इंटीग्रेशन डिज़ाइन करने से पहले अपना सब्सक्रिप्शन जाँच लें।
वेबहुक और ऑटोमेशन नियम
ऑटोमेशन नियम Odoo को कस्टम मॉड्यूल के बिना घटनाओं पर प्रतिक्रिया करने देते हैं। Odoo 19 Enterprise में आप इन्हें Studio से Automations मेनू के माध्यम से प्रबंधित करते हैं, और इनकमिंग वेबहुक की भी Studio में अपनी Webhooks प्रविष्टि होती है। डेवलपर मोड अधिक नियंत्रण देता है, जिसमें लक्ष्य मॉडल का चुनाव भी शामिल है।
इनकमिंग वेबहुक के लिए On webhook ट्रिगर के साथ एक नियम बनाएँ। Odoo URL अपने-आप बनाता है; बाहरी सिस्टम उस URL पर JSON पेलोड के साथ एक POST अनुरोध भेजता है। लक्ष्य रिकॉर्ड कोड Odoo को बताता है कि पेलोड किस रिकॉर्ड से संबंधित है, और Actions To Do टैब तय करता है कि आगे क्या होगा, आमतौर पर एक Execute Code ऐक्शन जब आपको किसी रिकॉर्ड को अपडेट करने के बजाय रिकॉर्ड बनाने हों।
बनाते और समस्या निवारण करते समय Log Calls सक्षम करें। यह URL पर आए अनुरोधों का इतिहास दर्ज करता है, जिसे आप नियम पर Logs स्मार्ट बटन से खोल सकते हैं।
वेबहुक URL को एक रहस्य की तरह रखें। दस्तावेज़ चेतावनी देते हैं कि इसे साझा करने से डेटाबेस तक अनचाहा एक्सेस मिल सकता है। यदि यह उजागर हो जाए, तो नया URL बनाने के लिए Rotate Secret का उपयोग करें और बाहरी सिस्टम को अपडेट करें।
आउटगोइंग सूचनाओं के लिए किसी नियम में Send Webhook Notification ऐक्शन जोड़ें। यह आपके चुने गए फ़ील्ड के मानों के साथ आपके बताए URL पर एक POST अनुरोध भेजता है, और एक नमूना पेलोड लाइव होने से पहले संरचना जाँचने में मदद करता है।
Execute Code ऐक्शन लिखते समय डेटाबेस लॉग तालिका में संदेश लिखने के लिए log फ़ंक्शन का उपयोग करें, ताकि विफलताएँ केवल सर्वर लॉग में ही नहीं, बल्कि फ़ंक्शनल यूज़र्स को भी दिखें।
Studio, Odoo Enterprise का हिस्सा है। Community में Studio इंटरफ़ेस नहीं है, इसलिए यही ज़रूरतें आमतौर पर डेवलपर मोड कॉन्फ़िगरेशन या किसी डेवलपर द्वारा बनाए रखे गए छोटे कस्टम मॉड्यूल से पूरी की जाती हैं।
सामान्य इंटीग्रेशन के लिए बिल्ट-इन कनेक्टर
कोड लिखने से पहले जाँचें कि क्या Odoo पहले से उस प्रदाता को कवर करता है। बिल्ट-इन कनेक्टर हर रिलीज़ के साथ बनाए रखे जाते हैं और आमतौर पर सबसे सुरक्षित विकल्प होते हैं।
- पेमेंट गेटवे: इन्हें Accounting, Website या Sales ऐप में Configuration, फिर Payment Providers से कॉन्फ़िगर करें। सूचीबद्ध प्रदाताओं में Stripe, Adyen, PayPal, Paymob, Mollie, Razorpay और अन्य शामिल हैं। Credentials टैब में क्रेडेंशियल दर्ज करें और पहले सैंडबॉक्स क्रेडेंशियल के साथ Test mode का उपयोग करें, आदर्श रूप से इनवॉइस नंबरिंग की सुरक्षा के लिए किसी डुप्लिकेट डेटाबेस पर। पेमेंट जर्नल एक Bank जर्नल होना चाहिए।
- शिपिंग कैरियर: इन्हें Inventory सेटिंग्स के Shipping Connectors सेक्शन से सक्षम करें। समर्थित कनेक्टर में DHL Express, FedEx, UPS, Sendcloud, EasyPost और अन्य शामिल हैं। हर शिपिंग विधि टेस्ट वातावरण में शुरू होती है; प्रोडक्शन पर स्विच करने से वास्तविक लेबल बनते हैं जिनका कैरियर बिल भेज सकता है, इसलिए पहले दरें और लेबल सत्यापित करें। Debug Requests विकल्प आदान-प्रदान किए गए संदेशों को लॉग करता है।
- बैंक: बैंक सिंक्रोनाइज़ेशन Plaid, Yodlee, Salt Edge, Ponto, Enable Banking और Basiq जैसे थर्ड-पार्टी प्रदाताओं के माध्यम से लेन-देन इम्पोर्ट करता है, और इसके लिए वैध Enterprise सब्सक्रिप्शन आवश्यक है। जहाँ आपका बैंक कवर नहीं है, वहाँ Accounting डैशबोर्ड पर Bank जर्नल से स्टेटमेंट फ़ाइलें इम्पोर्ट करें।
- ई-कॉमर्स और मार्केटप्लेस: Odoo का अपना eCommerce ऐप उसी डेटाबेस को साझा करता है, इसलिए किसी कनेक्टर की ज़रूरत नहीं होती। Amazon के लिए Amazon Connector ऑर्डर को सेल्स ऑर्डर में सिंक्रोनाइज़ करता है और आंतरिक संदर्भ से उत्पादों का मिलान करता है।
- अटेंडेंस डिवाइस: Attendances ऐप किसी समर्पित डिवाइस पर कियोस्क मोड और बैकएंड से चेक-इन को सपोर्ट करता है। अन्य विक्रेताओं के बायोमेट्रिक टर्मिनल आधिकारिक दस्तावेज़ों में शामिल नहीं हैं, इसलिए उन्हें आमतौर पर किसी कस्टम मॉड्यूल या मिडलवेयर के माध्यम से जोड़ा जाता है जो चेक-इन को Odoo में भेजता है।
n8n जैसे मिडलवेयर
n8n जैसे मिडलवेयर प्लेटफ़ॉर्म Odoo और अन्य सिस्टम के बीच काम करते हैं। ये थर्ड-पार्टी टूल हैं, Odoo का हिस्सा नहीं, और ये ऊपर वर्णित उसी एक्सटर्नल API और वेबहुक के माध्यम से Odoo से संवाद करते हैं।
ये तब उपयोगी हैं जब एक घटना से कई सिस्टम अपडेट होने हों, जब फ़ील्ड मैपिंग जटिल हो, या जब आपको केंद्रीय त्रुटि प्रबंधन और पुनःप्रयास के साथ एक दृश्य प्रवाह चाहिए। इसकी क़ीमत यह है कि होस्ट करने, सुरक्षित करने, मॉनिटर करने और अपग्रेड करने के लिए एक और घटक जुड़ जाता है, और API एक्सेस के लिए प्लान की वही शर्तें फिर भी लागू होती हैं।
डिज़ाइन नियम: आइडेम्पोटेंसी, त्रुटि प्रबंधन और लॉगिंग
इंटीग्रेशन की अधिकांश समस्याएँ दोहराए गए संदेशों, आंशिक विफलताओं और चुपचाप होने वाली त्रुटियों से आती हैं। पहले दिन से ही इनके लिए डिज़ाइन करें।
- हर लेखन को आइडेम्पोटेंट बनाएँ: बाहरी संदर्भ को Odoo रिकॉर्ड पर संग्रहीत करें और बनाने से पहले उसे जाँचें, ताकि दोबारा भेजा गया वेबहुक या पुनःप्रयास की गई कॉल डुप्लिकेट ऑर्डर या भुगतान न बनाए।
- तय करें कि हर फ़ील्ड का स्वामी कौन है, और कभी भी दो सिस्टम को एक ही मान ओवरराइट न करने दें।
- जहाँ संभव हो, एक व्यावसायिक संचालन को एक ही कॉल में रखें, क्योंकि हर JSON-2 कॉल अपना अलग ट्रांज़ैक्शन है।
- केवल अस्थायी विफलताओं पर बढ़ते अंतराल के साथ पुनःप्रयास करें, और स्थायी विफलताओं को समीक्षा कतार में भेजें।
- हर आदान-प्रदान के लिए अनुरोध, प्रतिक्रिया और Odoo रिकॉर्ड संदर्भ लॉग करें, Log Calls, Debug Requests या अपने मिडलवेयर के इतिहास का उपयोग करके।
- पहले कुछ सप्ताहों के दौरान मात्रा और विफलताओं की प्रतिदिन निगरानी करें, और भुगतान, शिपमेंट और बैंक शेष जैसे योगों का सिस्टम के बीच मिलान करें।
सुरक्षा चेकलिस्ट
- एक समर्पित इंटीग्रेशन यूज़र बनाएँ जिसके पास केवल वही एक्सेस अधिकार हों जिनकी इंटीग्रेशन को ज़रूरत है, और उसी यूज़र से उसकी API कुंजी बनाएँ।
- हर इंटीग्रेशन के लिए एक कुंजी का उपयोग करें, विवरण में उसका उद्देश्य दर्ज करें, छोटी अवधि चुनें और समाप्त होने से पहले उसे रोटेट करें।
- कुंजियाँ और वेबहुक URL किसी सीक्रेट मैनेजर में रखें, कभी भी स्प्रेडशीट, चैट संदेशों या सोर्स कोड में नहीं।
- किसी विक्रेता के साथ संबंध समाप्त होने या लीक का संदेह होने पर तुरंत कुंजियाँ रद्द करें और वेबहुक सीक्रेट रोटेट करें।
- हमेशा HTTPS का उपयोग करें, और हर इंटीग्रेशन को प्रोडक्शन में सक्षम करने से पहले किसी डुप्लिकेट डेटाबेस पर बनाएँ और परखें।
1CBMS कैसे मदद कर सकता है
1CBMS मिस्र और इराक की कंपनियों के लिए Odoo 19 इंटीग्रेशन डिज़ाइन और लागू करता है, पेमेंट प्रोवाइडर, कैरियर और बैंक फ़ीड कॉन्फ़िगर करने से लेकर JSON-2 API और वेबहुक इंटीग्रेशन बनाने, पुरानी XML-RPC स्क्रिप्ट माइग्रेट करने, और कस्टम मॉड्यूल या मिडलवेयर के माध्यम से अटेंडेंस डिवाइस तथा इन-हाउस सिस्टम जोड़ने तक। हम डेटा स्वामित्व और प्रवाहों की मैपिंग से शुरुआत करते हैं, सब कुछ किसी डुप्लिकेट डेटाबेस में परखते हैं, और स्पष्ट दस्तावेज़ीकरण तथा मॉनिटरिंग सौंपते हैं ताकि आपकी टीम आँकड़ों पर भरोसा कर सके। अपने इंटीग्रेशन परिदृश्य की समीक्षा के लिए www.1cbms.com पर हमसे संपर्क करें।