Erro na integração com a PontoTel

MENSAGEM

Ao acessar a tela "Configurações de Gateway" (Configurações >> Avançado >> Configurações Gateway), o sistema pode exibir diferentes tipos de erros:

• Erro imediato ao abrir a tela ou ao validar a integração com a PontoTel
• Falha no carregamento de recursos (404 Not Found)
• Erros de JavaScript (TypeError, ReferenceError)
• Token ausente ou inválido
• Tela permanece em modo de edição sem permitir salvamento
• Registros de aplicações não são exibidos

SITUAÇÃO

Esses erros ocorrem quando o usuário tenta acessar a tela "Configurações de Gateway" para cadastrar ou visualizar aplicações integradas, ou ao validar o link no campo "Endereço Sankhya". A tela realiza validações contínuas de comunicação com o gateway, e qualquer falha nessa comunicação impede o funcionamento adequado da funcionalidade.

As situações mais comuns incluem:

• Tentativa de cadastrar nova aplicação em base de testes
• Verificação de configurações de integrações existentes (como PontoTel ou Mercos)
• Acesso após atualização do sistema ou mudança de datacenter
• Utilização de IP interno para acessar a base

SOLUÇÃO

A solução varia conforme a causa do erro. Siga as orientações abaixo de acordo com sua situação:

Para validação do link "Endereço Sankhya":

Copie o link do campo "Endereço Sankhya" na tela "Configurações de Gateway" e cole no navegador.

Verifique o resultado do teste:
• Se o link abrir corretamente, a porta de integração está funcionando.
• Se o link não funcionar, revise as configurações de segurança do servidor, como firewall ou regras de rede, que possam estar bloqueando conexões externas.

Após realizar os ajustes necessários, repita o teste acessando novamente o link no navegador para confirmar se a comunicação foi restabelecida.

Para erros relacionados ao firewall (infraestrutura):

Entre em contato com o provedor de infraestrutura responsável pelo firewall.

Solicite a liberação dos IPs do gateway:
• "Ambiente de Produção": Porta 40014.
• "Ambiente Sandbox": Mesma porta configurada na base.

Aguarde a confirmação e teste novamente o acesso.

Para erros de acesso via IP interno:

Crie um DNS público para a base que está apresentando o erro.

Acesse a aplicação utilizando o endereço externo/DNS público.

Realize as configurações necessárias na tela "Configurações de Gateway".

Mantenha o endereço público acessível.

Para erros após atualização ou mudança de datacenter:

Acesse a tela "Configurações de Gateway" utilizando o IP externo.

Atualize as informações, especialmente o link de comunicação com o banco de dados.

Salve as alterações.

CAUSA

Os erros na tela "Configurações de Gateway" podem ter diferentes causas:

1. Restrições de rede/firewall: Bloqueios de conexões externas impedem a comunicação do Gateway.

2. Acesso via IP interno: O Gateway exige que o endereço seja público e acessível externamente.

3. Alterações no ambiente Cloud: Mudanças como atualização de sistema ou relocação de datacenter exigem a atualização do link de comunicação com o banco de dados.

4. Configuração de URL desatualizada: URLs desatualizadas no IP externo impedem o reflexo correto nos ambientes de acesso.