Como funciona a inferência de validação do código de barras?

Sempre que uma fatura é processada, a CUBi analisa o código de barras (ou linha digitável) para verificar se ele é estruturalmente consistente e se as informações extraídas são compatíveis com os demais dados da fatura.

O resultado dessa análise é apresentado no campo Validação do Código de Barras, que resume as verificações realizadas automaticamente pela plataforma.

Essa validação tem como objetivo identificar possíveis problemas de extração, documentos corrompidos, linhas digitáveis incompletas ou inconsistências entre o código de barras e os dados da fatura.

A CUBi identifica automaticamente o tipo de documento antes de iniciar as validações.

Existem dois tipos possíveis:

• Boleto bancário (linha digitável com 47 dígitos)
• Documento de arrecadação (linha digitável com 48 dígitos)

Cada tipo de documento possui regras próprias de interpretação.

O que é validado?

Dependendo do tipo de documento, a CUBi pode validar:

• comprimento da linha digitável;
• tipo do documento;
• banco emissor (quando aplicável);
• segmento do arrecadador (para documentos de arrecadação);
• referência utilizada pelo documento;
• existência de valor codificado na linha digitável;
• valor monetário extraído do código de barras;
• compatibilidade entre o valor extraído e o valor total da fatura.

Como interpretar o Status de Validação? ✓ Documento de arrecadação

Exemplo:

✓ Documento de arrecadação | Segmento: Energia Elétrica e Gás | Referência: 6 | Valor: R$ 2.478,98 | ✓ Valor compatível

Significa que:

• a linha digitável foi identificada como um documento de arrecadação;
• o documento pertence ao segmento de Energia Elétrica e Gás;
• a referência indica que o valor está codificado na linha digitável;
• o valor extraído do código de barras coincide com o valor total da fatura.
  
  

Como interpretar o Status de Validação? ✓ Boleto bancário

Exemplo:

✓ Boleto bancário | Itaú | Moeda: BRL | Valor: R$ 1.250,35 | ✓ Valor compatível

Significa que:

• a linha digitável pertence a um boleto bancário;
• o banco emissor foi identificado;
• a moeda informada é Real (BRL);
• o valor extraído da linha digitável coincide com o valor da fatura.

Como interpretar o Status de Validação? ✓ Valor compatível

Quando exibido:

✓ Valor compatível

Significa que o valor codificado no código de barras é igual ao valor total extraído da fatura.

Essa é uma forte indicação de que a linha digitável foi interpretada corretamente.

✗ Valor divergente

Exemplo:

✗ Valor divergente (R$ 1.250,35 x R$ 1.249,90)

O primeiro valor corresponde ao valor obtido a partir do código de barras.

O segundo corresponde ao valor total extraído da fatura.

Essa divergência pode ocorrer por diversos motivos, como:

• erro de leitura do código de barras;
• documento digitalizado com baixa qualidade;
• código de barras parcialmente ilegível;
• fatura contendo multa, juros ou outros valores não refletidos no código de barras;
• documento emitido em layout não convencional.

Sempre que possível, recomenda-se conferir visualmente o documento nesses casos.

Alguns documentos de arrecadação não armazenam o valor dentro da própria linha digitável.

Nesses casos será exibido:

Valor não codificado

Isso não representa um erro.

Apenas indica que o emissor optou por um layout em que o valor não faz parte do código de barras, impossibilitando sua validação automática.

O que fazer quando houver divergências?

Caso o campo apresente mensagens como Valor divergente, recomenda-se:

1. verificar se a linha digitável foi extraída corretamente;
2. conferir se o documento enviado é legível;
3. comparar o valor impresso na fatura com o valor apresentado no status;
4. caso a divergência persista, encaminhar o documento ao suporte para análise.

Importante

A Validação do Código de Barras verifica a consistência estrutural do código e sua compatibilidade com os dados extraídos da fatura.

Este campo não confirma a autenticidade da cobrança, nem substitui validações realizadas junto ao banco emissor ou à concessionária responsável pelo documento.