Criando uma nova integração por automação

O primeiro passo que vamos precisar fazer é criar uma nova integração, essa integração é responsável por manter as configurações comuns e fazer o vínculo entre as ações do sistema e as chamadas externas que vão ser feitas pelas automações.

Vamos começar indo até a página de integrações (Integrações → Integrações ERP → Métodos, ou pelo link {{seu_dns}}/admin/#/erpintegration/method), nessa página fica listado todas as integrações criadas.

Open

Para criar uma integração nova é preciso clicar no botão +, na listagem do tipo de integração nós vamos escolher Integração por automações, que é o objetivo desse manual.

Open

Após isso é aberto a página de configuração da integração, nessa página é feita as configurações de algumas funções da integração assim como configurar qual automação vai rodar para cada função

As configurações da integração são divididas por seções, a primeira delas são algumas configurações comuns a todas as integrações, que são:

Obrigatórias

• Ativo: Diz se a integração esta ativa ou não, uma integração desabilitada não vai ser chamada durante as chamadas de funções do sistema, o valor padrão é Sim.

• Permitir conexão insegura: Permite que as requisições sejam feitas sem a verificação de certificado SSL, habilitar essa opção pode ser perigoso e não é recomendado, use apenas se realmente necessário, o valor padrão é Não.

• Procedimento para Pedidos Migração: Procedimento que vai ser usado na criação de pedido quando o usuário já existir no ERP, os valores são os seguintes:

  • Criar pedido: Vai chamar o fluxo normal de criação de pedido no ERP, chamando a função Criação de pedido.

  • Criar chamado (Padrão): Vai ter um outro fluxo para pedidos de clientes existentes, chamando a função Criação de pedido para cliente já existente

  • Ignorar: Não vai fazer procedimento nenhum de criação de pedido no ERP, apenas enviar o email de pedido

Opcionais

• Descrição ERP: Um texto para identificar a integração, pode ser qualquer texto, ele ajuda a identificar a integração em alguns lugares do sistema, o valor padrão é vazio.

• Enviar razão social da empresa como nome: Pode ser usado dentro de uma integração para determinar se um pedido empresarial vai para o ERP com o nome do cliente sendo a razão social da empresa, como essa opção depende de cada integração ela não tem uso para essa em específico, o valor padrão é Não.

• Ignorar checagem de usuário na integração: Quando um pedido é processado pelo sistema nós fazemos uma checagem no ERP para conferir se o cliente já existe, e então seguimos o fluxo adequado se existe ou não, essa opção ignora essa checagem e cria o pedido baseado apenas no tipo de pedido e procedimento de migração, o valor padrão é não.

• Método PIX Fallback: Método pix que vai ser chamado no pagamento da fatura caso outros métodos não batam com a regra de cobrança, o valor padrão é vazio

• Consultar pendência interna: Chama as funções Listar faturas e Pegar texto para avaliar pendência interna para checar, na etapa de validação do pedido, se aquele cliente já possui alguma pendência com o provedor, o valor padrão é sim.

• Reprova automática por pendencia interna: Caso essa opção esteja ativa e a consulta de pendência interna retornar alguma pendência, o pedido em questão vai ser dado como cancelado, ao invés de dar apenas um alerta no PDF do pedido como na opção desligada, o valor padrão é não.

• Dias para dívidas virarem pendências internas: Quanto tempo (em dias) para que um boleto vencido seja considerado uma pendência interna, o valor padrão é 60 dias.

• Palavras-chave para pendências internas: conjunto de palavras (separadas por vírgula sem espaço) que vão ser checadas com a resposta da função Pegar texto para avaliar pendência interna para saber se há uma pendência interna, o valor padrão é vazio.

• Nome do Beneficiário: Nome do beneficiário que aparece no boleto do totem, o valor padrão é vazio.

• Forçar caixa alta para todos as requisições?: Essa opção transforma todos os valores das requisições em caixa-alta, tem pouca utilidade pra essa integração em específico, o valor padrão é Não.

Após essas configurações pode salvar a página, ainda temos coisas que vamos configurar nessa página, mas primeiro é preciso criar as automações que vão popular essa integração.