इंटीग्रेशन

E-Gestor ERP जोड़ें और ग्राहक, उत्पाद तथा बिक्री CRM में लाएँ

निजी टोकन से अपना E-Gestor खाता जोड़ें और ग्राहक, आपूर्तिकर्ता, उत्पाद, सेवाएँ, बिक्री तथा वित्तीय प्रविष्टियाँ CRM में लाएँ, बिना दोहराव बनाए।

E-Gestor एक ब्राज़ीली क्लाउड ERP है। जुड़ जाने के बाद CRM आपके E-Gestor खाते को पढ़ता है और ग्राहक, आपूर्तिकर्ता, उत्पाद, सेवाएँ, बिक्री तथा वित्तीय प्रविष्टियाँ यहाँ अद्यतन रखता है, जो E-Gestor कोड से जुड़ी रहती हैं। दोबारा सिंक करने पर कभी दोहरी प्रविष्टि नहीं बनती: जो रिकॉर्ड पहले से मौजूद है, वही अद्यतन होता है।

यह मॉडल BYO है ("अपना खाता खुद लाएँ"): आप अपने ही E-Gestor खाते और अपने ही निजी टोकन का उपयोग करते हैं। हम आपका डेटा कभी नहीं देखते और हमारी ओर से कोई शुल्क नहीं है। इंटीग्रेशन निष्क्रिय अवस्था में शुरू होता है: जब तक आप टोकन नहीं चिपकाते और उसे चालू नहीं करते, कुछ नहीं होता।

💡 सिंक एक ही दिशा में चलता है: E-Gestor से CRM में। CRM जो भी करता है, वह आपके ERP में कुछ नहीं लिखता। E-Gestor API से बिक्री को संपादित किया ही नहीं जा सकता (उसके दस्तावेज़ कहते हैं कि उसे हटाकर दोबारा बनाइए), और यहाँ से वहाँ रिकॉर्ड बनाने पर आपकी बहियाँ दोहरी हो जातीं।

आवश्यकताएँ

एक E-Gestor खाता। कोई सैंडबॉक्स नहीं है: हर खाता अलग होता है, इसलिए असली डेटा पर लगाने से पहले कनेक्शन आज़माना हो तो एक निःशुल्क परीक्षण खाता बनाएँ।
निजी टोकन, जो E-Gestor के भीतर सेटिंग्स → API (उसकी स्क्रीन पर: Configurações → API) में बनाया जाता है।
Sellio में व्यवस्थापक होना (सेटिंग्स प्रबंधित करने की अनुमति), ताकि आप टोकन को सेटिंग्स → इंटीग्रेशन में सहेज सकें।

चरण 1: E-Gestor में निजी टोकन बनाएँ

E-Gestor में साइन इन करें और सेटिंग्स मेन्यू खोलें (स्क्रीन पर: Configurações)।
API टैब पर जाएँ और निजी टोकन बनाएँ।
टोकन कॉपी करें। यह एक लंबा टेक्स्ट (एक JWT) है और यही एकमात्र दीर्घकालिक क्रेडेंशियल है: CRM इसी से छोटी अवधि के एक्सेस टोकन खुद बना लेता है।

चरण 2: टोकन को CRM में चिपकाएँ

सेटिंग्स → इंटीग्रेशन खोलें और "E-Gestor ERP" कार्ड ढूँढ़ें।
निजी टोकन चिपकाएँ और सहेजें। यह एन्क्रिप्टेड रूप में रखा जाता है और दोबारा कभी नहीं दिखाया जाता; बाद में मौजूदा टोकन बनाए रखने के लिए यह फ़ील्ड खाली छोड़ दें।
"कनेक्शन जाँचें" पर क्लिक करें। यह E-Gestor से आपकी कंपनी का विवरण पढ़ता है और खाते का नाम दिखाता है, ताकि कुछ भी चालू करने से पहले आप पक्का कर लें कि कंपनी सही है।
"क्या लाना है" में चुनें कि CRM को छह में से कौन-कौन से समूह पढ़ने हैं। ग्राहक, उत्पाद और बिक्री शुरू से चालू रहते हैं; सेवाएँ, प्राप्य खाते और देय खाते बंद रहते हैं।
सक्रिय करें पर क्लिक करें। पहला सिंक अगले निर्धारित चक्र में चलता है, या "अभी सिंक करें" से तुरंत।

CRM में हर चीज़ कहाँ पहुँचती है

CNPJ (14 अंक) वाला ग्राहक कंपनी बनता है; CPF वाला संपर्क। जो केवल आपूर्तिकर्ता या परिवहनकर्ता के रूप में पंजीकृत है, वह विक्रेता बनता है। ग्राहक और आपूर्तिकर्ता, दोनों के रूप में पंजीकृत होने पर वह ग्राहक के रूप में आता है।
उत्पाद और सेवाएँ उत्पाद बनते हैं; सेवा पर उत्पाद प्रकार "सेवा" का चिह्न लगता है।
बिक्री विक्रय आदेश बनती है, और जब वह ग्राहक पहले ही सिंक हो चुका हो तो उससे जुड़ जाती है। स्थिति 10 (कोटेशन) मसौदा बनती है, 50 (बिक्री) पुष्ट, और रद्द की गई बिक्री रद्द।
प्राप्य और देय खाते उस ग्राहक या आपूर्तिकर्ता की समयरेखा पर नोट बन जाते हैं जिनसे वे संबंधित हैं।

क्या नहीं आता, और क्यों

स्टॉक शेष। CRM का अपना इन्वेंटरी मॉड्यूल है, जिसमें गतिविधियों का बही-खाता रहता है; ERP से कोई संख्या उसमें लिखने का अर्थ होगा कि दो सिस्टम एक ही शेष पर दावा कर रहे हैं।
चालान (NF-e और NFS-e), खरीद, मूल्य तालिकाएँ, भुगतान विधियाँ और खातों का चार्ट। ये E-Gestor API में उपलब्ध हैं, पर यहाँ इनके लिए कोई मेल खाता ऑब्जेक्ट नहीं है, और किसी कनेक्टर के लिए एक ऑब्जेक्ट गढ़ना उत्पाद को बाहर से बदल देता।
आपके E-Gestor के कस्टम फ़ील्ड। कनेक्टर हर संसाधन के प्रलेखित फ़ील्ड ही पढ़ता है।
व्यक्ति का CPF संपर्क ऑब्जेक्ट पर किसी मानक फ़ील्ड में नहीं आता, इसलिए वह tax_id नाम से लिखा जाता है। उसे रिकॉर्ड पर देखना हो तो संपर्क पर ठीक इसी नाम का कस्टम फ़ील्ड बनाएँ; कंपनी और विक्रेता में यह फ़ील्ड पहले से मौजूद है।

वास्तविक समय के अपडेट (webhook)

जब भी कोई रिकॉर्ड बदलता है, E-Gestor CRM को कॉल कर सकता है, ताकि आपको अगले निर्धारित सिंक की प्रतीक्षा न करनी पड़े।

Sellio के कार्ड पर दिखाया गया webhook URL कॉपी करें।
E-Gestor में सेटिंग्स → API → Webhooks खोलें (उसकी स्क्रीन पर: Configurações → API → Webhooks) और वह URL पंजीकृत करें, तथा Contacts, Products और Sales मॉड्यूल चालू करें।
Sellio में लौटकर फिर से "कनेक्शन जाँचें" पर क्लिक करें: यह वह सुरक्षा टोकन ले आता है जो E-Gestor ने आपके webhook के लिए बनाया है, और उसे एन्क्रिप्टेड रूप में रखता है। उसके बाद जो भी कॉल ठीक वही टोकन साथ नहीं लाती, वह हटा दी जाती है।

💡 webhook के Users और Financial मॉड्यूल जान-बूझकर उपयोग नहीं किए जाते। वित्तीय घटना केवल एक कोड लाती है और यह नहीं बताती कि वह कोड प्राप्य है या देय, इसलिए उस पर कार्रवाई करने में गलत रिकॉर्ड छूने का जोखिम रहता। वे प्रविष्टियाँ निर्धारित सिंक से आती रहती हैं, जिसे पता होता है कि हर पंक्ति किस संसाधन से आई थी। E-Gestor में हटाया गया रिकॉर्ड CRM में भी नहीं हटाया जाता: आपकी टीम ने आम तौर पर उसे यहाँ समृद्ध किया होता है।

गति और सीमाएँ

E-Gestor प्रति मिनट 60 अनुरोधों की अनुमति देता है और प्रति पृष्ठ 50 रिकॉर्ड लौटाता है। कनेक्टर जान-बूझकर उस सीमा के भीतर रहता है और उस तक पहुँचने से पहले रुक जाता है, इसलिए किसी बड़े खाते का पहला आयात बीच में विफल होने के बजाय कुछ चक्रों में पूरा होता है। हर चक्र वहीं से आगे बढ़ता है जहाँ पिछला रुका था, और चूँकि सब कुछ E-Gestor कोड से बँधा है, इसलिए एक-दूसरे पर पड़ने वाले चक्र दोहराव नहीं बनाते, बल्कि अद्यतन करते हैं।

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

"E-Gestor ने निजी टोकन अस्वीकार कर दिया": टोकन ERP में रद्द कर दिया गया या दोबारा बनाया गया। सेटिंग्स → API (Configurações → API) में नया टोकन बनाएँ और उसे फिर से चिपकाएँ।
चालू करने के बाद कुछ नहीं दिखता: जाँचें कि जिस समूह की आप अपेक्षा कर रहे थे वह "E-Gestor से लाएँ" पर सेट है, और दैनिक चक्र की प्रतीक्षा करने के बजाय "अभी सिंक करें" का उपयोग करें।
webhook चलता नहीं दिखता: पक्का करें कि URL को E-Gestor में Contacts, Products और Sales मॉड्यूल चालू करके पंजीकृत किया गया था, और पंजीकरण के बाद आपने "कनेक्शन जाँचें" पर क्लिक किया था, ताकि सुरक्षा टोकन मेल खाए।
संख्याएँ एक दशमलव इधर-उधर लगती हैं: CRM कीमतें दशमलव में ठीक वैसे ही रखता है जैसे E-Gestor उन्हें भेजता है। यदि कोई कीमत यहाँ गलत है, तो वह वहाँ भी गलत है।

इस लेख को सिस्टम के भीतर खोलें →