Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

e-Bank recuperarconfiguraçãobeneficário

Não foi possível recuperar os dados de configuração da conta com os dados do beneficário informados! Verifique.

Esse erro ocorre quando a API tenta buscar as configurações da conta do beneficiário, mas os dados fornecidos no corpo da requisição são incompletos ou inválidos . Exemplo de JSON com erro {

Atualizado em 14 de abr. de 2025, 21:53

Problema

Esse erro ocorre quando a API tenta buscar as configurações da conta do beneficiário, mas os dados fornecidos no corpo da requisição são incompletos ou inválidos.

Exemplo de JSON com erro

{
    "testing": "true",
    "beneficiario": {
        "codigo": "123",
        "codigoConvenio": "",
        "conta": {
            "agencia": "",
            "banco": "756",
            "numero": ""
        },
        "inscricao": ""
    },
    "dataEmissaoFinal": "2025-01-01",
    "dataEmissaoInicial": "2025-01-05",
    "numeroNoBanco": [
        "123",
        "456"
    ]
}

Solução

Como resolver

Existem duas formas de resolver esse erro:

  1. Utilizar o parâmetro configurationIdna querystring:
    Recomendado quando os dados do beneficiário já estão cadastrados no sistema.
    GET /api/endpoint?configurationId=SEU_CONFIGURATION_ID 
  2. Preencher corretamente todos os campos obrigatórios do objeto beneficiario:

    Campos obrigatórios no objeto beneficiario

    Ao utilizar o objeto beneficiario no corpo da requisição, os seguintes campos devem ser obrigatoriamente preenchidos:

    • codigooucodigoConvenio
    • conta.agencia
    • conta.banco
    • conta.numero
    • inscricao

    Certifique-se de que nenhum dos campos listados acima esteja vazio ou ausente.
Dica:sempre que possível, prefira utilizar o configurationIdpara evitar inconsistências nos dados do beneficiário.