Como funciona uma integração

Uma integração leva um tipo de dado, como pedidos ou produtos, de um sistema da sua empresa até o WMS do armazém. Para isso, ela usa duas conexões, uma de cada lado, e um De/Para, que indica de qual campo vem cada informação. Cada vez que a integração é executada, a Encaixe registra uma execução. Para o registro que não chega ao WMS, a Encaixe abre uma pendência. Quando a integração sai do normal, a Encaixe abre um alerta.

flowchart LR
  O["Conexão de origem<br/>(ERP ou arquivo CSV)"] --> I[Integração]
  D["Conexão de destino<br/>(WMS)"] --> I
  M[De/Para publicado] --> I
  I -->|na frequência ou com Executar agora| E[Execução]
  E -->|registro entregue| W[WMS do armazém]
  E -->|registro não entregue| P[Pendência]
  E -->|integração fora do normal| A[Alerta]

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. A Encaixe testa a conexão antes de gravá-la. A conexão de Arquivo CSV não pede credenciais e é gravada sem teste. 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.

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 de uma execução pode ser Agendada, Manual (quando alguém usa Executar agora) ou Reprocessamento.

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 WMS 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 WMS 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.