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

🔑 Entrar 🆕 Criar conta 💓 Saúde dos Serviços

🔙 Voltar para problemas

e-Bank requisiçãoboletoconsulta

Não é permitido consultar mais que 100 boletos por requisição.

Esse erro acontece quando a requisição de consulta de boletos excede o limite máximo permitido de 100 boletos por chamada.

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

Problema

Esse erro acontece quando a requisição de consulta de boletos excede o limite máximo permitido de 100 boletos por chamada.

Solucao

A API permite consultar boletos informando uma lista no campo numeroNoBanco, porém essa lista deve conter no máximo 100 itens.

Exemplo de requisição válida

Consulta de boletos com até 100 itens no endpoint:

POST /api/v1/boleto/consultar?configurationId=SEU_CONFIGURATION_ID


{
  "testing": false,
  "numeroNoBanco": [
    "242156001",
    "242158187",
    "252182714",
    "252182765",
    "252182773",
    "252182790",
    "252182803",
    "252182811",
    "252182820",
    "252182838",
    "252182846",
    "252182854",
    "252182862"
    // até no máximo 100 boletos
  ]
}

Como resolver

Garanta que o array numeroNoBancotenha no máximo 100 elementos.
Caso precise consultar mais de 100 boletos, divida a lista em múltiplas requisições.

Dica:utilize paginação ou controle por lotes se for necessário processar grandes volumes de boletos.