Adicionar uma integração

Use este procedimento para ativar uma nova integração entre dois sistemas que a sua empresa já conectou à Encaixe.

Você precisa ter o papel Administrador ou Operador. Os dois sistemas da integração precisam estar conectados e testados em Conexões. Se ainda não estiverem, siga Conectar um sistema.

Como acessar

Em Conexões, clique em Adicionar integração. O mesmo botão aparece no Dashboard, acima das integrações, quando a empresa já tem pelo menos uma.

Tela Adicionar integração com as opções de integração, a frequência e o botão Ativar

Ativar a integração

Em Integração, selecione a integração que você quer ativar;
Em Frequência, selecione de quanto em quanto tempo ela deve ser executada: A cada 15 minutos, A cada 30 minutos, A cada hora ou Uma vez por dia;
Clique em Ativar.

Cada opção de integração mostra o nome, com o sistema de origem antes da seta e o sistema de destino depois dela, por exemplo Pedidos do Protheus → Senior WMS. Abaixo do nome aparecem os dois sistemas. A integração criada recebe esse mesmo nome.

A marca Já ativa indica que a sua empresa já tem essa integração ativa. A opção continua disponível, mas a tela já vem com uma opção ainda não ativa selecionada, quando houver.

A frequência já vem marcada em A cada 30 minutos. Você pode alterá-la depois, na tela da integração.

Depois da ativação

Ao clicar em Ativar, é feita uma verificação prévia, que confere se as duas conexões foram testadas, se os sistemas oferecem os serviços de que a integração precisa e se existe um De/Para sugerido para ela.

Se tudo estiver certo, a tela Conexões abre com a frase Integração ativada. A integração é criada com a situação Ativa, passa a aparecer no Dashboard e recebe um De/Para sugerido, ainda em rascunho.

flowchart LR
  A[Ativar] --> B{Verificação prévia}
  B -->|passou| C[Integração ativa]
  C --> D[Você revisa e publica o De/Para]
  D --> E[Primeira execução no horário agendado]
  B -->|não passou| F[Nenhuma integração é criada]

Depois da ativação, a regra de novas tentativas da integração aparece em Novas tentativas, na tela da integração.

Opção indisponível

Uma opção aparece esmaecida, com a palavra Indisponível, quando falta alguma coisa para ativá-la. Abaixo da palavra, a tela diz o motivo:

Motivo na tela	O que fazer
Falta conectar {sistema}.	Clique em Conectar {sistema}, ao lado do motivo. A tela Conectar um sistema abre com esse sistema já selecionado.
Ainda não confirmamos que sua instalação oferece: {serviço}.	No Totvs Protheus, clique em Testar os endpoints do Totvs Protheus e siga Configurar o mapa de endpoints. Nos outros sistemas, fale com o suporte.
Esta integração não está disponível nesta versão da Encaixe.	Fale com o suporte.

Enquanto nenhuma opção estiver disponível, o botão Ativar fica desabilitado.

Falha na verificação prévia

Se a verificação prévia encontrar um problema no momento da ativação, a tela continua aberta, com a frequência que você escolheu, e mostra o quadro A verificação prévia não passou e a integração continua desligada. Confira a integração selecionada antes de tentar de novo. Abaixo do quadro aparece um ou mais destes motivos:

Motivo na tela	O que fazer
A conexão de origem ainda não foi testada.	Abra a conexão do sistema de origem em Conexões. Se a situação for Sem conexão ou Ainda não testada, substitua a credencial para testá-la de novo.
A conexão de destino ainda não foi testada.	Faça o mesmo com a conexão do sistema de destino.
O sistema conectado não oferece um recurso de que esta integração precisa: {recurso}.	No Totvs Protheus, teste os endpoints da instalação. Nos outros sistemas, fale com o suporte.
O sistema de destino confirma as entregas depois, e o canal de confirmação não está disponível.	Fale com o suporte.
A versão publicada desta integração não existe nesta versão da Encaixe.	Fale com o suporte.
Esta integração não tem um De/Para padrão, então não é possível ativá-la.	Fale com o suporte.

Nenhuma integração é criada quando a verificação prévia não passa.

Saiba mais em Conexões e em Como funciona uma integração.