Guia de Erros da API de Cancelamento do Winthor – MáximaTech

Este documento foi elaborado para ajudá-lo a identificar e resolver erros que podem ocorrer durante a comunicação entre o Extrator Máxima e a API de cancelamento do Winthor.

Cada erro abaixo contém uma explicação, possíveis causas e orientações de como proceder.

⚠️ Erro 01 – Connection Refused

Descrição:
Http Request Exception: Connection Refused

Significado:
A requisição enviada pelo Extrator Máxima (serviço que roda localmente no seu servidor Linux) foi recusada pelo servidor de destino da API de cancelamento.

Possíveis causas:

• O servidor da API de cancelamento (de terceiros) está bloqueando conexões vindas do IP onde o Extrator está instalado.
• A API de cancelamento está temporariamente fora do ar.
• A URL ou porta configurada para a chamada está incorreta.
• Há um bloqueio de saída de rede ou firewall no ambiente local impedindo a comunicação.

Soluções recomendadas:

1. Verifique se o link (URL) da API de cancelamento está correto.
2. Verifique se o seu servidor Linux possui acesso externo à internet e ao domínio informado.
3. Caso o problema persista, entre em contato com o responsável pela API de cancelamento solicitando a liberação do IP do seu servidor onde o Extrator está instalado.

🔐 Erro 02 – Senha Inválida

Descrição:
Credenciais inválidas

Significado:
A senha informada é inválida para autenticação com a API de Cancelamento do Winthor.

Como proceder:
→ Entre em contato com o suporte da MáximaTech para que a senha seja validada ou atualizada.

👤 Erro 03 – Usuário Não Encontrado

Descrição:
Usuário informado não foi encontrado

Significado:
O usuário informado não existe ou não está cadastrado corretamente para autenticação no Extrator da MáximaTech.

Como proceder:
→ Entre em contato com o suporte da MáximaTech para validação e correção do cadastro do usuário.

⏱️ Erro 04 – Timeout

Descrição:
Timeout ao realizar a requisição

Significado:
A requisição enviada pelo Extrator demorou mais do que o tempo limite configurado para receber uma resposta da API de cancelamento.

Possíveis causas:

• O link da API de cancelamento está incorreto.
• A API de cancelamento está fora do ar.
• O servidor da API de cancelamento está bloqueando o IP do seu servidor Linux.
• Conexão de rede instável ou lenta entre o seu ambiente e o servidor da API.

Soluções recomendadas:

1. Verifique se o endereço da API de cancelamento está correto.
2. Teste a conexão com a API utilizando uma ferramenta como Postman ou curl.
3. Caso o servidor de destino esteja bloqueando o IP do seu servidor, solicite a liberação ao responsável pela API de cancelamento.
4. Aguarde alguns minutos e tente novamente, pois o problema pode ser temporário.

🌐 Erro 05 – Host Não Conhecido

Descrição:
Host não é conhecido

Significado:
O domínio informado na configuração da API de cancelamento não pôde ser resolvido (problema de DNS ou endereço incorreto).

Possíveis causas:

• O link da API de cancelamento está incorreto (precisa ser atualizado pela MáximaTech conforme o cliente informar).
• Problemas de DNS no servidor Linux.
• Conexão de rede instável ou falha temporária de resolução de nome.
• Domínio da API de cancelamento realmente fora do ar.

Soluções recomendadas:

1. Verifique se o link da API de cancelamento informado está correto.
2. Teste o domínio com os comandos ping ou nslookup no seu servidor Linux.
3. Confirme se seu servidor Linux possui acesso externo à internet e ao domínio informado.
4. Se for necessário alterar o link, entre em contato com o suporte da MáximaTech, informando o novo endereço da API de cancelamento fornecido pelo seu parceiro ou fornecedor.
5. Caso o problema persista mesmo com o link correto, entre em contato com o responsável pela API de cancelamento.

❓ Erro 99 – Erro Genérico / Desconhecido

Descrição:
Erro padrão – não foi possível obter informações detalhadas

Significado:
Ocorreu um erro inesperado durante a comunicação com a API, sem detalhes suficientes para identificar a causa exata.

Possíveis causas:

• Instabilidade momentânea de rede.
• Queda temporária na conexão entre o Extrator e a API.
• Problemas de conversão ou resposta inválida.
• Erro interno da API de cancelamento.
• Bloqueio momentâneo do IP do seu servidor Linux.

Soluções recomendadas:

1. Tente novamente após alguns minutos — o erro pode ter sido momentâneo.
2. Verifique os logs do Extrator para obter mais detalhes.
3. Confirme se sua conexão de rede e DNS estão funcionando corretamente.
4. Caso o problema persista, contate o suporte da Máxima, informando os detalhes da requisição e da API envolvida.

🧾 Observações Gerais

• Os erros 02 e 03 indicam falhas diretas na autenticação com a API da Máxima.
  → Nesses casos, entre em contato diretamente com o suporte da Máxima.
• Os erros 01, 04, 05 e 99 geralmente estão relacionados à comunicação entre o Extrator e a API de cancelamento, que pertence a outra empresa (terceiros).
  → Nesses casos, o responsável pela API de cancelamento deve ser acionado para verificar bloqueios, instabilidades ou links incorretos.