1. Inconsistência em Dados Cadastrais
Estes são os erros mais frequentes e impedem o registro do boleto por falhas na identificação das partes envolvidas:
- CPF/CNPJ Inválido: O número do documento do pagador ou beneficiário não é válido ou não está preenchido corretamente.
- CEP Inválido ou Incompatível: O CEP informado não consta na base dos Correios, não é numérico ou não pertence à cidade/estado informada no endereço.
- Nome do Pagador Ausente: O campo de nome do pagador é obrigatório e não foi informado ou está mal posicionado no arquivo.
- Endereço Incompleto: Falta de informações obrigatórias como logradouro ou município.
2. Erros de Lógica Financeira e Datas
Ocorrem quando os valores ou prazos informados não seguem as regras de negócio do banco:
- Data de Vencimento Retroativa: Envio de títulos com data de vencimento anterior à data de processamento da remessa sem a instrução específica.
- Valor do Desconto Superior ao Valor do Título: Erros de preenchimento onde o desconto ou abatimento concedido é maior ou igual ao valor nominal do boleto.
- Juros e Multa Incorretos: Informar data de início de juros anterior ao vencimento ou aplicar percentuais de juros/multa não permitidos (ex: juros maior que o valor do título).
- Valor Nominal Inválido: Títulos com valor zero (exceto em casos específicos como boleto proposta) ou acima do limite permitido pelo banco.
3. Falhas de Formatação e Estrutura (Arquivos CNAB)
Erros técnicos na geração do arquivo TXT que comprometem a leitura pelo sistema bancário:
- Caracteres Especiais Não Permitidos: Uso de acentos, cedilhas ("ç", "ã") ou símbolos em campos de texto fixo onde o banco exige apenas caracteres básicos.
- Campos Numéricos com Letras: Preenchimento de campos exclusivamente numéricos (como valores e datas) com vírgulas, pontos ou letras.
- Divergência nos Totais de Controle: O registro "Trailer" (final do arquivo) indica uma quantidade de títulos ou soma de valores diferente do que realmente consta no corpo do arquivo.
- Header e Trailer Formatados Incorretamente: Erros na composição das linhas de abertura e fechamento do lote ou do arquivo.
4. Configurações de Carteira e Conta
Problemas relacionados à parametrização da conta do cliente no banco:
- Carteira Inválida ou Não Contratada: O arquivo indica uma modalidade de cobrança (ex: Carteira 18) que não está prevista no contrato da empresa com o banco.
- Nosso Número Duplicado: Tentativa de registrar um título com um "Nosso Número" que já foi utilizado anteriormente no cadastro do banco.
- Agência/Conta Não Liberada: A conta corrente informada pode estar encerrada ou não possuir permissão ativa para operar com o serviço de cobrança.
- Duplicidade de Remessa: Envio acidental do mesmo arquivo de remessa mais de uma vez no mesmo dia.
5. Erros Específicos de Integração via API
Para sistemas que utilizam APIs em vez de arquivos de texto:
- Falha de Autenticação (HTTP 401): Credenciais inválidas, x-api-key não informada ou token de acesso expirado.
- Parâmetro Obrigatório Ausente (HTTP 400): Falta de campos essenciais no corpo da requisição JSON (ex: codigoBeneficiario ou tipoCobranca).
- Boleto Não Localizado (HTTP 422): Tentativa de alterar ou baixar um boleto informando uma linha digitável ou nosso número inexistente.
- Limite de Requisições Excedido (HTTP 429): Envio de muitas solicitações em um curto espaço de tempo (rate limit).