Intégrations

Connecter l'ERP E-Gestor et importer clients, produits et ventes dans le CRM

Connectez votre compte E-Gestor avec un jeton personnel et importez clients, fournisseurs, produits, services, ventes et écritures financières dans le CRM, sans créer de doublons.

E-Gestor est un ERP brésilien en nuage. Une fois la connexion établie, le CRM lit votre compte E-Gestor et tient à jour ici les clients, fournisseurs, produits, services, ventes et écritures financières, reliés par le code E-Gestor. Synchroniser à nouveau ne crée jamais de doublons : l'enregistrement qui existe déjà est mis à jour.

Le modèle est BYO (« apportez votre propre compte ») : vous utilisez votre propre compte E-Gestor et votre propre jeton personnel. Nous ne voyons jamais vos données et cela ne vous coûte rien de notre côté. L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas collé le jeton et activé l'intégration.

💡 La synchronisation va dans un seul sens : de E-Gestor vers le CRM. Rien de ce que fait le CRM n'écrit dans votre ERP. Les ventes ne peuvent pas du tout être modifiées via l'API E-Gestor (leur documentation indique de supprimer puis de recréer), et créer des enregistrements là-bas depuis ici dupliquerait votre comptabilité.

Prérequis

Un compte E-Gestor. Il n'y a pas d'environnement de test : chaque compte est séparé, alors créez un compte de test gratuit si vous voulez essayer la connexion avant de la pointer vers vos données réelles.
Le jeton personnel, généré dans E-Gestor sous Paramètres → API (Configurações → API).
Dans Sellio, être administrateur (permission de gérer les paramètres) pour enregistrer le jeton sous Paramètres → Intégrations.

Étape 1 : générer le jeton personnel dans E-Gestor

Connectez-vous à E-Gestor et ouvrez le menu Paramètres (Configurações).
Allez dans l'onglet API et générez le jeton personnel.
Copiez le jeton. C'est un long texte (un JWT) et c'est le seul identifiant de longue durée : le CRM s'en sert pour générer lui-même les jetons d'accès de courte durée.

Étape 2 : coller le jeton dans le CRM

Ouvrez Paramètres → Intégrations et trouvez la carte « E-Gestor ERP ».
Collez le jeton personnel et enregistrez. Il est stocké chiffré et n'est jamais réaffiché ; laissez ensuite le champ vide pour conserver le jeton actuel.
Cliquez sur « Tester la connexion ». Le CRM lit les informations de votre entreprise dans E-Gestor et affiche le nom du compte, pour que vous puissiez confirmer qu'il s'agit de la bonne entreprise avant d'activer quoi que ce soit.
Sous « Ce qu'il faut importer », choisissez lesquels des six groupes le CRM doit lire. Clients, produits et ventes sont activés au départ ; services, comptes clients et comptes fournisseurs sont désactivés.
Cliquez sur Activer. La première synchronisation a lieu au prochain cycle programmé, ou tout de suite avec « Synchroniser maintenant ».

Où arrive chaque chose dans le CRM

Un client avec un CNPJ (14 chiffres) devient une Entreprise ; avec un CPF, un Contact. Une personne enregistrée uniquement comme fournisseur ou comme transporteur devient un Fournisseur. Enregistrée à la fois comme client et comme fournisseur, elle arrive comme client.
Les produits et les services deviennent des Produits ; un service est marqué avec le type de produit « Service ».
Les ventes deviennent des Commandes, reliées au client lorsque celui-ci a déjà été synchronisé. Le statut 10 (devis) devient Brouillon, 50 (vente) devient Confirmée, et une vente annulée devient Annulée.
Les comptes clients et les comptes fournisseurs deviennent des notes sur la chronologie du client ou du fournisseur auquel ils appartiennent.

Ce qui n'est pas importé, et pourquoi

Les soldes de stock. Le CRM a son propre module d'inventaire avec un registre de mouvements ; y écrire un nombre venu de l'ERP reviendrait à avoir deux systèmes qui revendiquent le même solde.
Les factures (NF-e et NFS-e), les achats, les tables de prix, les moyens de paiement et le plan comptable. Ils sont disponibles dans l'API E-Gestor mais n'ont pas d'objet correspondant ici, et en inventer un pour un connecteur reviendrait à changer le produit depuis l'extérieur.
Les champs personnalisés de votre E-Gestor. Le connecteur lit les champs documentés de chaque ressource.
Le CPF d'un particulier n'a pas de champ standard sur l'objet Contact, il est donc écrit sous le nom tax_id. Créez un champ personnalisé portant exactement ce nom sur Contact si vous voulez le voir sur la fiche ; Entreprise et Fournisseur ont déjà ce champ.

Mises à jour en temps réel (webhook)

E-Gestor peut appeler le CRM chaque fois qu'un enregistrement change, pour que vous n'ayez pas à attendre la prochaine synchronisation programmée.

Copiez l'URL du webhook affichée sur la carte dans Sellio.
Dans E-Gestor, ouvrez Paramètres → API → Webhooks (Configurações → API → Webhooks) et enregistrez cette URL, en activant les modules Contacts, Produits et Ventes.
De retour dans Sellio, cliquez à nouveau sur « Tester la connexion » : le CRM récupère le jeton de sécurité que E-Gestor a généré pour votre webhook et le stocke chiffré. À partir de là, tout appel qui ne porte pas exactement ce jeton est écarté.

💡 Les modules Utilisateurs et Financier du webhook ne sont pas utilisés, et c'est volontaire. L'événement financier ne transporte qu'un code, et il ne dit pas si ce code correspond à une créance ou à une dette : agir dessus risquerait de toucher le mauvais enregistrement. Ces écritures arrivent quand même par la synchronisation programmée, qui sait de quelle ressource vient chaque ligne. Un enregistrement supprimé dans E-Gestor n'est pas supprimé dans le CRM non plus : votre équipe l'a généralement enrichi ici.

Vitesse et limites

E-Gestor autorise 60 requêtes par minute et renvoie 50 enregistrements par page. Le connecteur reste volontairement sous cette limite et s'arrête avant de l'atteindre, de sorte que le premier import d'un gros compte se termine sur quelques exécutions au lieu d'échouer à mi-chemin. Chaque exécution reprend là où la précédente s'est arrêtée et, comme tout est ancré au code E-Gestor, des exécutions qui se recouvrent mettent à jour au lieu de dupliquer.

Dépannage

« E-Gestor a rejeté le jeton personnel » : le jeton a été révoqué ou régénéré dans l'ERP. Générez-en un nouveau sous Paramètres → API (Configurações → API) et collez-le à nouveau.
Rien n'apparaît après l'activation : vérifiez que le groupe attendu est réglé sur « Importer depuis E-Gestor », et utilisez « Synchroniser maintenant » au lieu d'attendre le cycle quotidien.
Le webhook ne semble pas se déclencher : confirmez que l'URL a bien été enregistrée dans E-Gestor avec les modules Contacts, Produits et Ventes activés, et que vous avez cliqué sur « Tester la connexion » après l'avoir enregistrée, pour que le jeton de sécurité corresponde.
Les nombres semblent décalés d'une décimale : le CRM stocke les prix en décimaux, exactement comme E-Gestor les envoie. Si un prix est faux ici, il est faux là-bas aussi.

Ouvrir cet article dans le système →