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 Integraçõ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.

Ativar a integração

1. Em Integração, selecione a integração que você quer ativar;
2. 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;
3. 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. Em Recebimentos do Senior WMS → estoque do Bling, por exemplo, o WMS é a origem e o Bling é o destino.

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 a verificação passar e houver espaço no plano, a integração é ativada e sua tela abre com a frase Integração ativada. Ela recebe um De/Para sugerido, ainda em rascunho.

A integração Recebimentos do Senior WMS → estoque do Bling exige uma confirmação adicional. Ela é salva como Rascunho, e sua tela abre para que você confirme que nada mais lança o estoque dessas notas no ERP: nem a importação do XML, nem uma pessoa, nem outra integração. Confira essa condição antes de marcar a confirmação e clicar em Ativar.

Se o limite do plano impedir a ativação, a integração também fica salva como rascunho. A tela informa o limite e as opções disponíveis.

flowchart TD
  A[Ativar] --> B{Verificação prévia}
  B -->|passou| C{Exige confirmação de estoque?}
  C -->|sim| R[Rascunho: confira e confirme]
  C -->|não| L{Há espaço no plano?}
  R --> L
  L -->|sim| D[Revise e publique o De/Para]
  L -->|não| P[Rascunho: confira o limite do plano]
  D --> E[Integração pode executar]
  B -->|não passou| F[Nenhuma integração é criada]

Importante

A integração só é executada depois que alguém revisar e publicar o De/Para sugerido. Até lá, a tela da integração mostra o quadro Aguardando a revisão do De/Para. Veja como fazer em Publicar o De/Para.

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.