Problema
Este erro ocorre quando o campo numeroNaEmpresa enviado para o banco contém caracteres inválidos.
No e-Bank, esse campo corresponde ao mapeamento interno numeroNaEmpresa.
O banco permite apenas caracteres alfanuméricos, ou seja:
[0-9 A-Z a-z espaço]
Se forem enviados caracteres especiais como hífen, ponto, barra ou qualquer outro símbolo, a requisição será rejeitada.
Exemplo incorreto:
"numeroNaEmpresa": "031966-01"
Neste caso, o hífen (-) torna o valor inválido.
Solução
Como resolver
Remova qualquer caractere especial do campo numeroNaEmpresa, mantendo apenas letras, números e espaço.
Exemplo corrigido:
"numeroNaEmpresa": "03196601"
Antes de enviar a requisição para registro do boleto, recomenda-se aplicar uma validação preventiva na aplicação para garantir que o valor esteja dentro do padrão permitido.
Dica: Se o seu ERP utiliza máscara de formatação (como hífens ou barras), remova esses caracteres antes de enviar os dados para a API bancária.