Integrazioni

Collega E-Gestor ERP e porta clienti, prodotti e vendite nel CRM

Collega il tuo account E-Gestor con un token personale e porta clienti, fornitori, prodotti, servizi, vendite e movimenti finanziari nel CRM, senza creare duplicati.

E-Gestor è un ERP brasiliano in cloud. Una volta collegato, il CRM legge il tuo account E-Gestor e tiene aggiornati qui clienti, fornitori, prodotti, servizi, vendite e movimenti finanziari, collegati tramite il codice E-Gestor. Sincronizzare di nuovo non crea mai duplicati: aggiorna il record che esiste già.

Il modello è BYO ("porta il tuo account"): usi il tuo account E-Gestor e il tuo token personale. Non vediamo mai i tuoi dati e non c'è alcun costo da parte nostra. L'integrazione nasce inerte: non succede nulla finché non incolli il token e non la attivi.

💡 La sincronizzazione va in una sola direzione: da E-Gestor al CRM. Nulla di ciò che fa il CRM viene scritto nel tuo ERP. Le vendite non si possono proprio modificare tramite l'API di E-Gestor (la loro documentazione dice di cancellarle e ricrearle), e creare lì i record da qui duplicherebbe la tua contabilità.

Requisiti

Un account E-Gestor. Non esiste un ambiente di prova: ogni account è separato, quindi crea un account di test gratuito se vuoi provare la connessione prima di puntarla ai tuoi dati reali.
Il token personale, generato dentro E-Gestor in Impostazioni (Configurações) → API.
In Sellio, essere amministratore (permesso di gestire le impostazioni) per salvare il token in Impostazioni → Integrazioni.

Passo 1: genera il token personale in E-Gestor

Accedi a E-Gestor e apri il menu Impostazioni (Configurações).
Vai alla scheda API e genera il token personale.
Copia il token. È un testo lungo (un JWT) ed è l'unica credenziale di lunga durata: il CRM la usa per generare da solo i token di accesso brevi.

Passo 2: incolla il token nel CRM

Apri Impostazioni → Integrazioni e trova la scheda "E-Gestor ERP".
Incolla il token personale e salva. Viene conservato cifrato e non viene più mostrato; più avanti lascia il campo vuoto per mantenere quello attuale.
Fai clic su "Prova connessione". Legge i dati della tua azienda da E-Gestor e mostra il nome dell'account, così puoi confermare che sia l'azienda giusta prima di attivare qualsiasi cosa.
In "Che cosa portare" scegli quali dei sei gruppi il CRM deve leggere. Clienti, prodotti e vendite partono attivi; servizi, crediti da incassare e debiti da pagare partono disattivati.
Fai clic su Attiva. La prima sincronizzazione parte al ciclo programmato successivo, oppure subito con "Sincronizza adesso".

Dove finisce ogni cosa nel CRM

Un cliente con CNPJ (14 cifre) diventa un'Azienda; con CPF, un Contatto. Chi è registrato solo come fornitore o come trasportatore diventa un Fornitore. Se è registrato sia come cliente sia come fornitore, entra come cliente.
Prodotti e servizi diventano Prodotti; un servizio viene contrassegnato con il tipo di prodotto "Servizio".
Le vendite diventano Ordini di vendita, collegati al cliente quando quel cliente è già stato sincronizzato. Lo stato 10 (preventivo) diventa Bozza, il 50 (vendita) diventa Confermato e una vendita annullata diventa Annullata.
I crediti da incassare e i debiti da pagare diventano note nella cronologia del cliente o del fornitore a cui appartengono.

Che cosa non arriva, e perché

Le giacenze di magazzino. Il CRM ha il proprio modulo di inventario con un registro dei movimenti; scriverci dentro un numero preso dall'ERP significherebbe avere due sistemi che dichiarano la stessa giacenza.
Le fatture (NF-e e NFS-e), gli acquisti, i listini prezzi, i metodi di pagamento e il piano dei conti. Sono disponibili nell'API di E-Gestor ma qui non hanno un oggetto corrispondente, e inventarne uno per un connettore cambierebbe il prodotto dall'esterno.
I campi personalizzati del tuo E-Gestor. Il connettore legge i campi documentati di ciascuna risorsa.
Il CPF della persona fisica non ha un campo standard sull'oggetto Contatto, quindi viene scritto sotto il nome tax_id. Crea un campo personalizzato con esattamente quel nome su Contatto se vuoi vederlo nella scheda; Azienda e Fornitore hanno già quel campo.

Aggiornamenti in tempo reale (webhook)

E-Gestor può chiamare il CRM ogni volta che un record cambia, così non devi aspettare la sincronizzazione programmata successiva.

Copia l'URL del webhook mostrato nella scheda in Sellio.
In E-Gestor apri Impostazioni (Configurações) → API → Webhooks e registra quell'URL, attivando i moduli Contatti, Prodotti e Vendite.
Torna in Sellio e fai clic di nuovo su "Prova connessione": recupera il token di sicurezza che E-Gestor ha generato per il tuo webhook e lo salva cifrato. Da quel momento, ogni chiamata che non porta esattamente quel token viene scartata.

💡 I moduli Utenti e Finanziario del webhook non vengono usati di proposito. L'evento finanziario porta solo un codice e non dice se quel codice è un credito o un debito, quindi agire su di esso rischierebbe di toccare il record sbagliato. Quelle voci arrivano comunque con la sincronizzazione programmata, che sa da quale risorsa proviene ogni riga. Un record cancellato in E-Gestor non viene cancellato nemmeno nel CRM: di solito il tuo team lo ha arricchito qui.

Velocità e limiti

E-Gestor consente 60 richieste al minuto e restituisce 50 record per pagina. Il connettore resta sotto quel limite di proposito e si ferma prima di raggiungerlo, così la prima importazione di un account grande si completa nell'arco di alcune esecuzioni invece di fallire a metà. Ogni esecuzione riprende dal punto in cui si è fermata la precedente e, poiché tutto è ancorato al codice E-Gestor, le esecuzioni che si sovrappongono aggiornano invece di duplicare.

Risoluzione dei problemi

"E-Gestor ha rifiutato il token personale": il token è stato revocato o rigenerato nell'ERP. Generane uno nuovo in Impostazioni (Configurações) → API e incollalo di nuovo.
Non compare nulla dopo l'attivazione: verifica che il gruppo che ti aspettavi sia impostato su "Porta da E-Gestor" e usa "Sincronizza adesso" invece di aspettare il ciclo giornaliero.
Il webhook sembra non scattare: conferma che l'URL sia stato registrato in E-Gestor con i moduli Contatti, Prodotti e Vendite attivi, e che tu abbia fatto clic su "Prova connessione" dopo averlo registrato, così il token di sicurezza corrisponde.
I numeri sembrano sbagliati di un decimale: il CRM salva i prezzi come decimali, esattamente come li invia E-Gestor. Se un prezzo è sbagliato qui, è sbagliato anche lì.

Apri questo articolo dentro il sistema →