Integração

Bem-vindo à área de integração do Demander 🚀

Este guia foi criado para ERPs e desenvolvedores que precisam integrar seus sistemas ao nosso força de vendas.

Aqui você vai entender, de forma direta:

Como funciona a integração com o Demander.
Quais são os tipos de fluxo de dados.
Quais mecanismos você pode usar.
E qual abordagem faz mais sentido para o seu cenário.

📌 Primeiro, entenda se o seu cenário precisa de integração

A melhor forma de trabalhar com o Demander é por meio da integração entre sistemas.

Quando a empresa possui um ERP integrado ao Demander, o ERP deve ser a origem oficial dos dados cadastrais. Nesse caso, informações como clientes, produtos, vendedores e preços devem ser cadastradas ou alteradas no ERP e enviadas ao Demander pela integração.

Porém, também é possível trabalhar sem integração e realizar os cadastros diretamente no Demander. Esse cenário faz sentido principalmente quando a empresa não possui um ERP integrado ou quando determinado campo não é enviado pelo ERP.

👉 Veja como identificar se o seu cenário deve utilizar cadastro manual ou integração no artigo Cadastro manual e integração com ERP.

🔄 Como funciona a integração com o Demander?

Se o seu cenário utiliza integração, é importante entender que ela pode acontecer em dois fluxos independentes:

Envio de dados: informações do ERP são enviadas para o Demander.
Consulta de dados: informações do Demander são consultadas pelo ERP.

Você não precisa utilizar o mesmo mecanismo para os dois fluxos.

Isso é intencional e permite escolher a tecnologia mais adequada para cada necessidade, considerando fatores como volume de dados, periodicidade, desempenho e esforço de implementação.

A seguir, vamos explicar cada um desses fluxos e os mecanismos disponíveis.

🔃 Tipos de fluxos de dados

No Demander, é possível dividir a integração em dois fluxos principais: envio de dados e consulta de dados.

Cada fluxo possui objetivos e características diferentes e em muitos cenários é comum utilizar tecnologias distintas para cada um deles.

Entender essa separação é importante para definir a melhor estratégia de integração, considerando fatores como volume de dados, periodicidade, desempenho e esforço de implementação.

Abaixo estão os dois tipos de fluxos utilizados nas integrações com o Demander.

Envio de dados para o Demander (Dados do ERP → Demander)

Esse é o fluxo onde o seu ERP ou sistema envia informações para o Demander.

Exemplos:

Vendedores.
Clientes.
Produtos.
Atualizações cadastrais no geral.

👉 Aqui você está alimentando o força de vendas.

Consulta de dados no Demander (Dados do Demander → ERP)

Nesse caso, o seu sistema busca dados do Demander para uso interno.

Exemplos:

Pedidos realizados pelos vendedores.
Clientes cadastrados pelos vendedores.
Clientes alterados pelos vendedores.
Outras opções de recebimentos de dados no ERP.

👉 Aqui você está consumindo dados do força de vendas.

💡 Por que separar envio e consulta?

Pois cada fluxo tem características diferentes.

O envio de dados:

Pode envolver grande volume de dados.
Pode exigir validação de layout.
A periodicidade pode ser diferente entre empresas e segmentos.

A consulta de dados:

A periodicidade pode ser diferente entre empresas e segmentos.
Pode depender do modelo do ERP (código, estrutura, esforço, entre outras opções).

Mecanismos de integração

Atualmente, o Demander oferece três mecanismos de integração:

API de Arquivo Texto

Como funciona:

Integração baseada em arquivos texto.
Codificação UTF-8.
Campos separados por pipe (|).
Cada linha é um registro/tabela, sendo a tabela diferenciada pelo primeiro campo.
Os demais campos seguem o layout específico de cada entidade.

Exemplo simplificado:
18|123|Empresa Exemplo|CNPJ|... (18 significa clientes, 123 seria o código do cliente e assim para o restante dos campos)

✅ Pontos fortes:

Alto desempenho para grandes volumes de dados.
Facilita processamento em lote.
Liberdade do ERP de parametrização na periodicidade e manipulação interna.

⚠️ Pontos de atenção:

Validação de layout fica por conta da implementação.
Pode exigir mais esforço inicial de desenvolvimento.
Caso o ERP não trabalhe com arquivos textos pode ter dificuldades iniciais.

📝 Documentações:

Sincronizador Demander

O Sincronizador Demander é um executável em Java que atua como ponte entre o seu banco de dados e o força de vendas.

Resumidamente, funciona como uma interface para transformar os dados do banco de dados do ERP ou do Demander em arquivos texto (no layout Demander).

Internamente o Sincronizador utiliza a API de arquivo texto, portanto compartilha alguns pontos positivos e de atenção do mecanismo anterior.

Como funciona:

Instalado em um servidor ou máquina com acesso ao banco do ERP.
Permite configurar scripts de: leitura, inserção e atualização.
Gera automaticamente arquivos no layout do Demander (depende diretamente dos scripts).
Também consome arquivos do Demander já prontos.

👉 Na prática: você conecta direto ao banco e deixa o Sincronizador cuidar da transformação de dados. Sendo necessário montar os scripts de acordo com o padrão do banco de dados e do layout Demander.

✅ Pontos fortes:

Reduz significativamente o esforço de desenvolvimento.
Automatiza geração e leitura de arquivos no layout do Demander.
Ideal para quem quer rapidez na implementação.

⚠️ Pontos de atenção:

Dependência de um executável rodando no ambiente.
Caso a instalação esteja na nuvem, possui algumas dificuldades em alguns cenários na instalação.
Em alguns processos mais complexos pode haver dificuldades (inserção de pedidos e itens do pedido).

📝 Documentações:

Sincronizador do Demander

API REST (JSON)

A API REST do Demander permite integrar dados via requisições HTTP usando JSON.

É o mecanismo de integração mais novo da Demander, portanto não possui todos os endpoints homologados, porém novos endpoints serão implementados conforme demanda.

✅ Pontos fortes:

Padrão moderno de integração (HTTP + JSON).
Permite maior controle na lógica da aplicação.

⚠️ Pontos de atenção:

Pode não ser ideal para grandes volumes.
Ainda em evolução (novos endpoints de acordo com a demanda).

📝 Documentações:

API de integração do Demander

💡 Sugestões para diferentes cenários

Conforme já comentado, entendemos a integração como algo a ser avaliado de acordo com a realidade de cada aplicação e empresa, portanto nessa seção vamos sugerir mecanismos de integração em diferentes fluxos e realidades das empresas.

Menos trabalho, mais resultados

Com o objetivo de implantar uma integração funcional e simples, a sugestão da Demander seria utilizar o Sincronizador Demander, para ambos os fluxos.

Construir as consultas de seleção de dados de acordo com o layout do ERP-Demander e criar scripts de inserção de dados para tabelas principais ou temporárias, para depois ler nas tabelas de produção com alguma rotina interna do próprio sistema terceiro.

Mais independência para o terceiro

Se o objetivo é garantir maior independência e poder de decisão para a sua aplicação, a sugestão da Demander seria utilizar uma das APIs de integração, indo de acordo com a sua preferência de tecnologia.

Neste formato, é possível controlar a periodicidade e quais dados são enviados, além de conseguir criar telas por dentro da aplicação, para auxiliar na utilização dos usuários, suporte e possíveis evoluções, mesmo que aumente a complexidade.

Cenário mais comum

Conforme novas integrações vão surgindo, é possível notar um padrão que funciona muito bem e garante um trabalho consideravelmente menor, porém entrega uma independência grande para o terceiro.

Esse padrão seria a sugestão mais comum da Demander, sendo dividir os fluxos de integração e trabalhar com mecanismos diferentes.

Para o envio de dados do ERP para o Demander, trabalhar com o Sincronizador Demander. Visto que não é necessário criar código com publicações, somente instalar o executável, conectar o banco e criar os scripts de seleção de dados conforme o layout.

Para a consulta de dados do Demander para o ERP, trabalhar com uma das APIs de integração, indo de acordo com a sua preferência de tecnologia. Visto que a inserção de dados no ERP pode ser controlada com maior independência pelo terceiro, auxiliando no suporte e possíveis evoluções, além de garantir a qualidade do dado de entrada no sistema.

🔗 Integrações com ERPs já padronizadas

Além das opções de integração apresentadas neste artigo, o Demander possui integrações já padronizadas com alguns ERPs.

Essas integrações existem para facilitar a implantação e reduzir o esforço necessário para desenvolver e manter uma integração do zero. Quando o ERP já possui uma integração padronizada com o Demander, parte das regras, estruturas e processos necessários já está definida.

Isso permite que a empresa aproveite uma integração já preparada para aquele ERP, em vez de precisar construir toda a comunicação entre os sistemas de forma personalizada.

👉 Se você utiliza um ERP que já possui uma integração padronizada com o Demander, consulte o menu Integrações nativas com ERPs relacionado com esse artigo para verificar as opções disponíveis e entender como funciona cada integração.

💬 Ficou em dúvida se o seu ERP possui uma integração padronizada com o Demander? Entre em contato com a nossa equipe. Estamos à disposição para ajudar a identificar o melhor caminho para o seu cenário.

🛒 Integrações com sistemas de e-commerce

O Demander também pode ser integrado a sistemas de e-commerce.

Esse tipo de integração possui necessidades diferentes de uma integração tradicional com um ERP. Além do envio e recebimento de dados cadastrais, podem existir processos específicos relacionados ao catálogo de produtos, clientes, preços, pedidos e demais informações utilizadas entre o e-commerce e o força de vendas.

Por isso, as integrações com e-commerce possuem uma documentação própria, com orientações específicas para esse cenário.

👉 Se o seu objetivo é integrar o Demander com uma plataforma de e-commerce, consulte o menu Integração com e-commerces relacionado com esse artigo para conhecer as opções disponíveis e entender como esse cenário funciona.

💬 Não tem certeza se o seu sistema se enquadra nesse cenário? Entre em contato com a nossa equipe. Podemos ajudar a entender as características da sua plataforma e indicar o caminho mais adequado.