Como funciona uma integração

Uma integração leva informações de um sistema de origem para um sistema de destino. O ERP pode enviar dados para o WMS e o WMS pode enviar dados para o ERP. Cada integração atende a uma operação específica, como enviar pedidos ao armazém ou lançar no ERP o estoque recebido.

Para isso, a integração usa duas conexões e um De/Para, que indica de qual campo vem cada informação. Cada execução registra o resultado das entregas. Os registros que precisam de correção aparecem como pendências e os problemas de funcionamento podem gerar alertas.

flowchart TB
  O[Conexão de origem] --> I[Integração]
  D[Conexão de destino] --> I
  M[De/Para publicado] --> I
  I --> E[Execução]
  E -->|entrega| S[Sistema de destino]
  S -->|resultado da entrega| E
  E --> R[Registros entregues ou pendentes]

Na integração Recebimentos do Senior WMS → estoque do Bling, a origem é o WMS e o destino é o ERP. A Encaixe confere o recebimento com a nota de entrada antes de lançar o estoque. Essa operação é diferente da confirmação de que um envio chegou ao WMS: ela tem seus próprios dados, De/Para e execuções.

Na tela de cada integração, você vê a frequência, a próxima execução, os números do dia e o histórico de execuções.

Conexão

A conexão guarda os dados de acesso a um dos sistemas da sua empresa, como o Totvs Protheus ou o Senior WMS. As conexões que usam o teste direto são verificadas antes de serem gravadas. No Bling, você autoriza o acesso na conta do ERP para concluir a conexão. Para enviar arquivos, use Importações. As credenciais de acesso são criptografadas e ninguém consegue visualizá-las depois de salvas.

Cada conexão mostra uma situação: Conectado, Conectado com restrições, Sem conexão ou Ainda não testada.

Saiba mais em Conexões e em Conectar um sistema.

Integração

A integração liga uma conexão de origem a uma conexão de destino para um tipo de dado. O nome dela mostra os dois lados, por exemplo Pedidos do Protheus → Senior WMS.

Nas integrações entre sistemas, você escolhe a Frequência: A cada 15 minutos, A cada 30 minutos, A cada hora ou Uma vez por dia. Você também pode pausar a integração. Enquanto ela estiver pausada, nenhuma execução acontece.

Ao lado do nome, a integração mostra a situação operacional, que indica como ela está funcionando: Operacional, Atenção, Pausada ou Falha.

Saiba mais em Tela da integração, Adicionar uma integração e Situações operacionais.

De/Para

O De/Para mostra de qual campo do sistema de origem vem cada valor e em qual campo do sistema de destino ele é gravado. A Encaixe já traz uma sugestão para cada integração.

A integração só é executada depois que alguém da sua empresa publica o De/Para. Até lá, nenhuma execução acontece: nem as agendadas, nem as pedidas com Executar agora, nem os reprocessamentos.

Saiba mais em Como funciona o De/Para e em Publicar o De/Para.

Execução

Cada vez que a integração é executada, a Encaixe registra uma execução. A Origem mostra como ela foi iniciada:

• Agendada: na frequência configurada;
• Manual: por uma solicitação, como Executar agora ou a confirmação de um arquivo;
• Aviso do WMS: por um aviso recebido do WMS;
• Reprocessamento: pela ação Reprocessar em uma pendência.

Os tipos de importação de arquivo não têm frequência. Cada arquivo confirmado pode gerar uma execução. Veja Enviar um arquivo CSV.

Na tela, cada execução aparece com uma destas situações:

Situação	O que significa
Na fila	A execução foi pedida e ainda não começou.
Em andamento	A execução está lendo e enviando os registros.
Concluída	Todos os registros foram entregues.
Concluída com pendências	A execução terminou, mas alguns registros não foram entregues.
Aguardando confirmação	Os registros foram enviados e o sistema de destino ainda não confirmou o recebimento.
Falhou	A execução parou antes de concluir o envio.
Não executada	A execução não começou, porque a anterior ainda estava em andamento ou porque a integração foi pausada.

Saiba mais em Execuções e em Investigar uma execução.

Pendência

Uma pendência é um registro que não chegou ao sistema de destino, por exemplo porque o WMS recusou o registro ou porque os dados eram inválidos. A pendência fica Aberta até alguém agir:

• Reprocessar envia o registro de novo. Se o sistema de destino já tinha aceitado o registro, nada é reenviado e a pendência passa para Resolvida;
• Dispensar tira a pendência da contagem de pendências abertas. Você precisa informar o motivo, e a pendência continua registrada para consulta, com a situação Dispensada.

Saiba mais em Central de problemas e em Resolver uma pendência.

Alerta

Um alerta avisa que uma integração saiu do normal. A Encaixe abre um alerta nestes casos:

• Execução com falha: uma execução terminou com a situação Falhou;
• Taxa de sucesso: a taxa de sucesso ficou abaixo do mínimo;
• Sem execução concluída: nenhuma execução foi concluída em um período;
• Pendências abertas: as pendências abertas passaram de um limite.

Quando um alerta é aberto, todas as pessoas da sua empresa que têm acesso à Encaixe recebem um e-mail. O alerta fica Aberto até alguém usar Marcar como visto, e então passa para Visto. Quando o problema que abriu o alerta deixa de acontecer, o alerta passa para Resolvido.

Saiba mais em Acompanhar os alertas.