Como Resolver o Erro - "00424-CONVENIO NAO MARCADO PARA TROCA DE MENSAGEM PARA ENTRADA ONLINE"

[Gines]

Fala Dev, beleza?!

Ao trabalhar com a integração de boletos e outros serviços bancários via WebService, é comum encontrar erros que refletem configurações incompletas ou inconsistências na comunicação entre o sistema do cliente e o banco. Um desses erros é o "00424-CONVENIO NÃO MARCADO PARA TROCA DE MENSAGEM PARA ENTRADA ONLINE", que ocorre em dois cenários específicos no WebService do Santander, versão 1.

Cenário 1: Habilitação do WebService sem liberação do banco

Neste cenário, o cliente realizou todos os passos necessários para habilitar o WebService no sistema interno, configurando corretamente as credenciais e permissões, mas o banco ainda não concluiu a liberação no ambiente solicitado. Ou seja, o convênio foi habilitado no cliente, mas o Santander ainda não liberou o acesso para o uso do serviço de troca de mensagens online.

- Causas:

• Configurações do convênio foram iniciadas, mas falta o banco concluir o processo.
• Eventual atraso na sincronização entre a solicitação de ativação feita pelo cliente e a liberação pelo Santander.

- Soluções:

• Entrar em contato com o suporte do Santander, solicitando a verificação da ativação do convênio no ambiente correto (produção ou homologação, dependendo do caso).
• Confirmar com o banco se todos os procedimentos foram devidamente seguidos e se há algum problema interno impedindo a liberação.

Cenário 2: Consumo do ambiente incorreto (homologação vs. produção)

Outro erro comum que pode causar a rejeição "00424" ocorre quando o cliente habilitou o convênio para o ambiente de homologação, mas está tentando consumir os serviços diretamente no ambiente de produção, ou vice-versa. Como cada ambiente tem suas próprias configurações e permissões, o erro ocorre porque o convênio não foi marcado no ambiente que está sendo consumido.

- Causas:

• O cliente configurou corretamente o ambiente de homologação, mas está consumindo o WebService de produção.
• Alternativamente, o cliente pode ter configurado o ambiente de produção, mas está consumindo o WebService de homologação.

- Soluções:

• Verificar qual ambiente está sendo consumido (produção ou homologação).
• Ajustar as configurações de consumo do WebService para garantir que correspondam ao ambiente habilitado no banco.
• Confirmar com o banco qual ambiente está corretamente configurado e ativo para evitar confusão entre homologação e produção.

Conclusão

O erro reflete problemas relacionados à habilitação ou ao uso incorreto dos ambientes de comunicação com o banco. Garantir que o convênio esteja corretamente ativado e que o ambiente correto (produção ou homologação) seja consumido são passos essenciais para evitar esse erro.

Caso o problema persista, o cliente deve sempre confirmar com o suporte técnico do Santander o status da ativação e o ambiente correto para a troca de mensagens online.

Precisa de Assistência Adicional?

Se, após seguir essas estratégias, o problema persistir, não hesite em contatar nosso suporte técnico. Ao fornecer detalhes específicos da requisição, como os parâmetros de timeout e os logs de exceções, você ajudará a acelerar o processo de resolução e garantir que o problema seja solucionado de forma eficaz. 

Até mais Dev!