Omie é um ERP (Enterprise Resource Planning), que integramos com o nosso CRM da Leads2b por meio de uma integração Plug-and-Play. Por meio dessa integração é possível unir os dois sistemas através das entidades: "Cliente", "Produto", "Venda de produto".
Este recurso permite a integração rápida, fácil e sem custos adicionais de desenvolvimento para os clientes da parceria.
Essa funcionalidade está disponível para alguns planos. Verifique seu plano atual e garanta que isso esteja disponível para você!
Escopo geral
A integração da Leads2b com a Omie liga as informações de clientes, produtos e pedidos da Leads2b com as entidades de "Clientes/Fornecedores", "Produtos" e "Venda de produto" na Omie.
A comunicação da integração se comporta unilateral ou bilateralmente, dependo das entidades envolvidas. A entidade de "Clientes" na Leads2b, se comunica bilateralmente com a entidade de "Clientes/Fornecedores" da Omie. Isto quer dizer que a criação, edição e exclusão de um cliente em um dos sistemas afetará o outro também.
Para entender mais sobre quais são os campos que fazem parte da integração e às exceções de integração, vá para a seção de "Clientes".
A base de "Produtos" da Leads2b será preenchida pela Omie, já que esta integração é feita unilateralmente. Assim, qualquer criação, edição e exclusão na Omie será refletida na Leads2b. Por outro lado, o inverso não acontece.
Por fim, "Vendas/Pedidos" na Leads2b estão integradas ao módulo de "Venda de Produto" do Omie.
A integração se comporta bilateralmente, porém a criação fica por conta da Leads2b neste caso. Portanto, edição e exclusão são transferidas da Omie para a Leads2b e serão refletidas apenas para aqueles pedidos que foram criados através do sistema Leads2b.
Escopo: detalhamento das entidades
Cada entidade integrada apresenta suas próprias particularidades e comportamentos. A seguir, detalhamos cada uma com a informação de quais campos são utilizados na comunicação entre os dois sistemas.
Clientes
As entidades de "Clientes/Fornecedor" (Omie) e "Cliente" (Leads2b) estão sincronizadas simultaneamente com seus campos mais importantes.
Mapeamento fixo de campos:
Nome
Razão social
CNPJ
CPF
Telefone
Inscrição Estadual
Endereço
Complementos
Número
Bairro
CEP
Cidade
Estado
Vendedor padrão (Omie) <> Responsável (Leads2b)
Valor limite de cŕedito
Bloqueio de faturamento
Observações:
O campo responsável representa um usuário na Leads2b e, para integrar com a Omie, é preciso que haja um vendedor com o mesmo e-mail cadastrado na Omie
Ao cadastrar um cliente na Omie, se o campo “vendedor padrão” estiver preenchido e o mesmo não existir na Leads2b, o cliente será criado na Leads2b mas sem vínculo de responsável
Como na Leads2b é possível ter vários usuários responsáveis por um cliente, é importante destacar que este campo “Responsável” ou “Vendedor padrão" (Omie) seja alterado através da Omie. Afinal, as alterações realizadas na Leads2b não serão refletidas.
Produtos
Diferentemente das demais entidades, "Produtos" vêm apenas da Omie para a Leads2b. Ou seja, não podemos criar produtos na Leads2b e enviar para a Omie, pois isso não é aceito.
Mapeamento fixo de campos:
Descrição (Omie) <> Nome (Leads2b)
Código do produto (Omie) <> Código de integração (Leads2b)
NCM
Unidade
Preço Unitário
Inativo
Família (Omie) <> Categoria (Leads2b)
Observações Internas
Quantidade
Imagens.
Pedidos
A integração de "Venda de Produto" (Omie) ou "Pedidos" (Leads2b) funciona de forma bilateral mas com algumas particularidades. São elas:
A criação de pedidos é sincronizada apenas no sentido Leads2b → Omie
Como consequência do item 1, a atualização e exclusão de pedidos feita na Omie só será refletida na Leads2b quando o pedido em questão fora criado através do sistema Leads2b.
Algumas informações importantes, precisam estar preenchidas para uma venda ser integrada à Omie. Sendo que a falta dessas informações pode gerar problemas na integração. Portanto:
o cliente e o produto precisam existir no Omie, Além de estarem corretamente integrados e ativos
o cliente tem que ter CPF ou CNPJ preenchidos (caso obrigatoriedade esteja ativa)
o cliente obrigatoriamente tem que possuir o campo "Cidade/Estado" preenchido na Leads2b.
Mapeamento fixo de campos:
Cliente
Itens do pedido (descrição, quantidade, desconto, preço unitário)
Quantidade.
Observações:
Quando excluímos um "Pedido" na Leads2b, essa exclusão é automaticamente sincronizada e a venda é cancelada na Omie. Da mesma forma, quando excluímos uma venda na Omie, ela também é automaticamente excluída na Leads2b.
Como configurar a integração
Para ativar a integração entre Leads2b e Omie deve-se fornecer os dados da "Chave de Integração API" ("App Key" e "App Secret") do aplicativo. Afinal, a partir dessa configuração, será possível sincronizar as entidades de clientes, produtos e pedidos de forma rápida e prática.
Confira as etapas para obter as informações na Omie:
Etapa 1: obtenha dados de "App Key" e "App Secret" na Omie
1. Acesse o site da Omie e faça login na conta que será integrada com a Leads2b
2. Na página inicial do aplicativo, clique no símbolo de engrenagem (⚙️) e, em seguida, acesse "Resumo do App"
3. Na tela seguinte, localize o campo "Chave de Integração (API)" e copie os dados de "App Key" e "App Secret".
Etapa 2: comece a configurar na Leads2b
1. Na plataforma Leads2b, vá para o menu de "Integrações"
2. Em seguida, localize a opção "Omie" e clique em "Configurar"
3. Cole os dados de "App Key" e "App Secret" obtidos na etapa anterior. Certifique-se de inserir cada informação em seu campo correspondente. Ao terminar, clique em "Aplicar"
4. Em seguida, selecione alguns campos que são obrigatórios na Omie para criação de vendas/pedidos e clique em "Aplicar"
5. Configure os eventos/webhooks que serão disparados da Omie para Leads2b
Etapa 3: configure Webhooks na Omie
1. Na mesma seção onde você coletou a "App Key" e "App Secret", acesse o menu "Visitar o portal do desenvolvedor"
2. Acesse o link notificações do Webhooks
3. Na tela seguinte, clique sobre o botão "Adicionar novo Webhooks"
4. Agora, indique o endpoint disponibilizado pela Leads2b para receber os eventos do Omie e também informar quais os tipos iremos “escutar” para o correto funcionamento da integração
Lista de assuntos que devem ser selecionados:
ClienteFornecedor.Alterado
ClienteFornecedor.Excluido
ClienteFornecedor.Incluido
Produto.Alterado
Produto.Excluido
Produto.Incluido
Produto.MovimentacaoEstoque
VendaProduto.Alterada
VendaProduto.Cancelada
VendaProduto.Excluida
Após indicar o endpoint e selecionar os assuntos corretamente, prossiga clicando no botão "Salvar" no final da página.
Etapa 4: finalize a configuração
1. Para finalizar a configuração, voltamos à tela de configuração na Leads2b. Aqui, marque o checkbox para dar continuidade ao processo e, em seguida clicar em "Continuar"
2. Na sequência, você verá o modal informando sobre a carga inicial da base de clientes e produtos da Omie — que é realizada em segundo plano nesta configuração. Para continuar, clique no botão "Estou de acordo".
Para saber mais sobre a carga inicial, vá até a seção Carga inicial.
3. Por fim, confira as informações e clique em "Salvar"
Ao clicar em "Salvar", o processo de carga inicial de clientes e produtos é iniciado automaticamente. Uma vez finalizado, estará tudo pronto e as duas ferramentas estarão sincronizadas.
Você também pode acompanhar este processo através do menu, conforme imagem abaixo:
Carga inicial da base
Conforme visto nas etapas de configuração da integração, a Leads2b executa uma carga inicial de toda a base de clientes e produtos cadastrados na Omie. Este processo é um facilitador para que as informações fiquem sincronizados e a integração funcione corretamente.
Observações:
Ao realizar a carga inicial da base de produtos, todos os produtos já existentes na base da Leads2b serão removidos.
Dúvidas? É só consultar nosso suporte ao cliente.