Códigos de erro

Por status HTTP (comuns a toda a API)

StatusSituação típica
400Campo obrigatório ausente ou formato inválido
401Token, x-api-key, cooperativa ou beneficiário inválido/divergente
404Endpoint ou recurso não encontrado
415Content-Type não suportado
422Regra de negócio não atendida
429Limite de TPS excedido
504Tempo de resposta excedido (autenticação/gateway)

Limites (TPS e paginação)

OperaçãoLimite
Cadastro de boleto20 req/s
Consulta por Nosso Número15 req/s
Consulta de liquidados por dia20 req/s
Liquidados por dia500 registros/página
Movimentações financeiras1.000 registros/página

Por regra de negócio (422)

os cenários mais frequentes: título já liquidado, baixado, rejeitado, aguardando confirmação, ou já em fluxo de protesto/negativação; comando incompatível com a situação atual do título; espécie de documento que não permite a operação; beneficiário sem o produto/permissão necessário (ex.: Serasa para negativação, modalidade híbrida para QR Code).



Did this page help you?