Erro ao imprimir boletos: valor inválido no campo “campoLivreCodigoBarras”

Visão geral

Este conteúdo apresenta as possíveis causas e orientações para o incidente “Valor inválido no campo campoLivreCodigoBarras” ao tentar imprimir boletos registrados.

Quando usar este artigo

Utilize este procedimento quando houver falha na impressão de boletos causada por inconsistências no layout bancário da forma de recebimento.

Sintoma ou cenário

Ao tentar visualizar ou imprimir um boleto, o sistema apresenta a mensagem: “Valor inválido no campo campoLivreCodigoBarras”.

Benefício para o usuário ou operação

• Facilita a identificação de inconsistências bancárias; 
• Permite corrigir erros de layout da conta; 
• Evita falhas na geração de boletos e remessas; 
• Garante conformidade com o padrão bancário exigido.

Onde acessar / contexto de uso

Acesse o sistema com suas credenciais e navegue até o menu correspondente ao módulo Condomínio > Formas de recebimento.

Pré-requisitos (Antes de começar)

• Perfil Exato: Permissão de edição das formas de recebimento;
• Recursos Sistêmicos: Conta configurada com remessa bancária;
• Insumos e Dados Técnicos: Dados de homologação bancária e layout da conta.

Causas prováveis

Esse erro pode ocorrer durante a impressão de boletos e indica que há inconsistência no preenchimento dos dados do layout bancário vinculado à forma de recebimento. Cada banco possui uma estrutura específica que deve ser seguida para garantir a correta geração do boleto e dos arquivos de remessa enviados para registro.

Como fazer ou corrigir

Para corrigir o erro, siga os passos abaixo:

1. Acesse Condomínio > Formas de recebimento;
2. Localize a forma de recebimento da conta configurada como “Com remessa”;
3. Passe o mouse sobre ela e clique em Editar;
4. Confirme o alerta de desativação da conta e prossiga clicando em Próximo;
5. Na tela de preenchimento do layout, revise se os dados estão preenchidos conforme as orientações do banco correspondente; Preenchimento padrão de layout para homologação.
6. Realize as correções necessárias e salve as alterações;
7. Para reativar a forma de recebimento, selecione a opção “Já gerei” > “Não houve erro”;
8. Teste novamente a impressão do boleto.

Resultado esperado

O boleto será gerado corretamente, permitindo impressão sem falhas no código de barras.

Quando escalar

Escale quando todas as informações do layout estiverem corretas conforme a homologação bancária e o erro continuar sendo apresentado.

Informações que devem ser reunidas antes do escalonamento

• Print da mensagem de erro; 
• Banco utilizado; 
• Carteira configurada; 
• Print completo do layout bancário; 
• Documento de homologação do banco; 
• Linha digitável do boleto, se houver geração parcial.

Regras importantes / Observações

• Cada banco possui regras próprias para composição do campo livre do boleto; 
• Alterações incorretas no layout podem impactar não apenas a impressão, mas também o registro bancário e o processamento da remessa; 
• A revisão deve ser realizada utilizando exatamente os dados fornecidos pelo banco durante a homologação; 
• Quantidade de caracteres, dígitos verificadores e preenchimento de zeros à esquerda podem variar conforme o banco e a carteira utilizada; 
• Durante a edição da conta, a forma de recebimento poderá ficar temporariamente desativada até a conclusão da validação; 
• Após salvar as alterações, recomenda-se realizar testes de impressão e geração de remessa antes de utilizar a conta novamente em produção.

Problemas comuns e como resolver

• Problema: Boleto continua apresentando erro após revisar os dados.
• Causa provável: Alguma informação do layout bancário permanece divergente da homologação do banco ou incompatível com a carteira utilizada.
• Ação recomendada: Revise novamente os dados da homologação bancária e valide especialmente campos como carteira, convênio, código do beneficiário e quantidade de posições exigidas pelo banco.

Dúvidas relacionadas

P: O erro pode impedir também o registro da cobrança? R: Sim. Inconsistências no layout bancário podem impactar tanto a impressão quanto o registro e processamento das remessas bancárias.

P: Se o boleto já foi registrado, será necessário emitir uma nova cobrança? R: Não. Após corrigir as informações da forma de recebimento, basta realizar novamente a impressão do boleto. A linha digitável e o código de barras serão gerados corretamente com base na configuração atualizada.

Palavras-chave de busca

Erro ao imprimir boletos valor inválido no campo campoLivreCodigoBarras, erro campo livre boleto, erro código de barras boleto, layout bancário inválido, boleto com remessa, forma de recebimento, homologação bancária, erro ao imprimir