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:
- 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
- Preencher corretamente todos os campos obrigatórios do objeto
beneficiario:Campos obrigatórios no objeto
beneficiarioAo utilizar o objeto
beneficiariono corpo da requisição, os seguintes campos devem ser obrigatoriamente preenchidos:codigooucodigoConvenioconta.agenciaconta.bancoconta.numeroinscricao
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.