Problema
Beneficiário não encontrado
Beneficiário+não+encontrado
Foi retornado o erro Beneficiário não encontrado durante o registro do boleto.
Este erro indica que o banco não localizou o código do beneficiário (cedente) informado na requisição.
Na maioria dos casos trata-se de erro de configuração, onde o código informado não corresponde ao cadastro existente no banco.
Solucao
✔ Possíveis causas
- Código do beneficiário configurado incorretamente.
- Beneficiário não cadastrado ou não habilitado no banco.
- Dados bancários inconsistentes.
✔ Como resolver
- Verifique junto ao banco qual é o código correto do beneficiário.
- Revise a configuração do cedente no sistema.
- Corrija o campo Beneficiario.Codigo na requisição.
✔ Exemplo via JSON
"beneficiario": {
"codigo": "CODIGO CORRETO AQUI",
"conta": {
"agencia": "9999",
"banco": "000"
},
"inscricao": "99999999999999",
"nome": "Nome do Beneficiario"
}✔ Exemplo visual de configuração incorreta