Integrações

Conectar o E-Gestor ERP e trazer clientes, produtos e vendas para o CRM

Conecte a sua conta do E-Gestor com o token pessoal e traga clientes, fornecedores, produtos, serviços, vendas e lançamentos financeiros para o CRM, sem duplicar registros.

O E-Gestor é um ERP brasileiro em nuvem. Depois de conectado, o CRM lê a sua conta do E-Gestor e mantém aqui os clientes, fornecedores, produtos, serviços, vendas e lançamentos financeiros, vinculados pelo código do E-Gestor. Sincronizar de novo nunca cria duplicatas: atualiza o registro que já existe.

O modelo é BYO ("traga a sua conta"): você usa a sua própria conta do E-Gestor e o seu token pessoal. Nós nunca vemos os seus dados e não há custo nosso. A integração nasce inerte: nada acontece até você colar o token e ativar.

💡 A sincronização é de mão única: do E-Gestor para o CRM. Nada que o CRM faz escreve no seu ERP. As vendas não podem ser editadas pela API do E-Gestor (a documentação deles manda apagar e criar outra), e criar registros de cá para lá duplicaria a sua escrituração.

Pré-requisitos

Uma conta no E-Gestor. Não existe ambiente de testes: cada conta é isolada, então crie uma conta de teste gratuita se quiser experimentar a conexão antes de apontar para os seus dados reais.
O token pessoal, gerado dentro do E-Gestor em Configurações → API.
No Sellio, ser administrador (permissão de gerir configurações) para salvar o token em Configurações → Integrações.

Passo 1: gere o token pessoal no E-Gestor

Entre no E-Gestor e abra o menu Configurações.
Vá até a aba API e gere o token pessoal.
Copie o token. É um texto longo (um JWT) e é a única credencial de longa duração: o CRM usa ele para emitir sozinho os tokens de acesso curtos.

Passo 2: cole o token no CRM

Abra Configurações → Integrações e localize o cartão "E-Gestor ERP".
Cole o token pessoal e salve. Ele é guardado cifrado e nunca é exibido de volta; deixe o campo em branco depois para manter o atual.
Clique em "Testar conexão". Ele lê os dados da sua empresa no E-Gestor e mostra o nome da conta, para você confirmar que é a empresa certa antes de ativar qualquer coisa.
Em "O que trazer", escolha quais dos seis grupos o CRM deve ler. Clientes, produtos e vendas já nascem ligados; serviços, contas a receber e contas a pagar nascem desligados.
Clique em Ativar. A primeira sincronização roda no próximo ciclo agendado, ou na hora com "Sincronizar agora".

Onde cada coisa cai no CRM

Cliente com CNPJ (14 dígitos) vira Empresa; com CPF, vira Contato. Quem está cadastrado só como fornecedor ou transportadora vira Fornecedor. Quem é cliente e fornecedor ao mesmo tempo entra como cliente.
Produtos e serviços viram Produtos; o serviço entra com o tipo de produto "Serviço".
Vendas viram Pedidos de venda, ligados ao cliente quando esse cliente já foi sincronizado. Situação 10 (orçamento) vira Rascunho, 50 (venda) vira Confirmado, e venda cancelada vira Cancelado.
Contas a receber e a pagar viram notas na linha do tempo do cliente ou do fornecedor a que pertencem.

O que não vem, e por quê

Saldo de estoque. O CRM tem módulo próprio de estoque, com ledger de movimentação; gravar nele um número vindo do ERP faria dois sistemas afirmarem o mesmo saldo.
Notas fiscais (NF-e e NFS-e), compras, formas de pagamento e plano de contas. Existem na API do E-Gestor, mas não têm objeto correspondente aqui, e inventar um por causa de um conector seria mudar o produto por fora.
Campos personalizados do seu E-Gestor. O conector lê os campos documentados de cada recurso.
O CPF da pessoa física não tem campo padrão no objeto Contato, então ele é gravado com o nome tax_id. Crie um campo personalizado com esse nome exato em Contato se quiser vê-lo na ficha; Empresa e Fornecedor já têm esse campo.

Atualização na hora (webhook)

O E-Gestor pode chamar o CRM sempre que um registro mudar, para você não esperar a próxima sincronização agendada.

Copie o endereço do webhook mostrado no cartão, no Sellio.
No E-Gestor, abra Configurações → API → Webhooks e cadastre esse endereço, marcando os módulos Contatos, Produtos e Vendas.
De volta ao Sellio, clique em "Testar conexão" outra vez: ele busca o token de segurança que o E-Gestor gerou para o seu webhook e guarda cifrado. A partir daí, qualquer chamada que não traga exatamente esse token é descartada.

💡 Os módulos Usuários e Financeiro do webhook não são usados de propósito. O evento financeiro traz só um código e não diz se ele é de um recebimento ou de um pagamento, então agir nele arriscaria mexer no registro errado. Esses lançamentos continuam chegando pela sincronização agendada, que sabe de qual recurso veio cada linha. Registro apagado no E-Gestor também não é apagado no CRM: aqui a sua equipe costuma tê-lo enriquecido.

Velocidade e limites

O E-Gestor permite 60 requisições por minuto e devolve 50 registros por página. O conector fica abaixo desse limite de propósito e para antes de estourá-lo, então a primeira importação de uma conta grande termina ao longo de algumas execuções em vez de falhar no meio. Cada execução continua de onde a anterior parou e, como tudo é ancorado no código do E-Gestor, execuções que se sobrepõem atualizam em vez de duplicar.

Solução de problemas

"O E-Gestor recusou o token pessoal": o token foi revogado ou gerado de novo no ERP. Gere um novo em Configurações → API e cole outra vez.
Nada aparece depois de ativar: confira se o grupo que você esperava está em "Trazer do E-Gestor" e use "Sincronizar agora" em vez de esperar o ciclo diário.
O webhook parece não disparar: confirme que o endereço foi cadastrado no E-Gestor com os módulos Contatos, Produtos e Vendas marcados, e que você clicou em "Testar conexão" depois de cadastrá-lo, para o token de segurança bater.
Valores parecem errados por uma casa decimal: o CRM guarda os preços como decimais, exatamente como o E-Gestor os envia. Se um preço está errado aqui, ele está errado lá também.

Abrir este artigo dentro do sistema →