Quais os erros que podem ocorrer na homologação do Banrisul?
Visão geral
Durante a homologação de uma conta do Banrisul podem ocorrer rejeições relacionadas à configuração da forma de recebimento, aos dados do convênio, ao layout da remessa e às informações apresentadas no boleto.
Este artigo reúne os principais erros já identificados nesse processo e orienta o que deve ser ajustado no sistema para realizar uma nova tentativa de homologação.
Quando usar este artigo
Utilize este artigo quando uma remessa, boleto ou arquivo de retorno do Banrisul apresentar alguma inconsistência durante ou após a homologação da conta bancária.
Sintoma ou cenário
A conta do Banrisul foi configurada no sistema, mas o banco retornou uma inconsistência na remessa, no boleto ou no arquivo de retorno.
Os erros podem estar relacionados ao código do convênio, dados do beneficiário, layout da forma de recebimento, instruções de multa, identificação do banco no boleto ou tipo de retorno utilizado pelo Banrisul.
Benefício para o usuário ou operação
- Identificação mais rápida da origem da rejeição.
- Correção da configuração antes de uma nova tentativa de homologação.
- Redução de retrabalho na geração de boletos e remessas.
- Maior aderência do arquivo gerado pelo sistema ao padrão exigido pelo Banrisul.
Onde acessar / contexto de uso
As principais configurações são realizadas em: Empresa > Formas de recebimento
Pré-requisitos (Antes de começar)
- Ter os dados do convênio fornecidos pelo Banrisul.
- Ter acesso à forma de recebimento configurada para a conta.
- Ter em mãos a mensagem ou relatório de rejeição apresentado pelo banco.
- Identificar se o erro ocorreu no arquivo de remessa, no boleto ou no arquivo de retorno.
- Quando necessário, confirmar com a agência do Banrisul qual configuração deve ser utilizada para o convênio.
Causas prováveis
Os principais motivos estão relacionados a:
- Código de convênio diferente do cadastrado pelo Banrisul.
- Dados do beneficiário divergentes do cadastro bancário.
- Layout incompatível com o padrão utilizado pela conta.
- Configuração de protesto ou multa diferente da esperada pelo banco.
- Informações incorretas na linha digitável ou no código de barras.
- Ausência de informações obrigatórias no boleto.
- Tipo de retorno configurado de forma inadequada para a operação.
Como fazer ou corrigir
Erros no arquivo de remessa
Erro: O código beneficiário informado no header de lote e arquivo está incorreto
O código informado no sistema não corresponde ao convênio cadastrado no Banrisul.
Ação recomendada: confirme com a agência do Banrisul o código de convênio correto e compare com o cadastro da forma de recebimento. O convênio utilizado na configuração deve seguir exatamente a informação fornecida pelo banco.
Erro: O nome do beneficiário deve ser informado conforme cadastro na agência
O banco identificou divergência entre os dados do beneficiário informados no arquivo e aqueles cadastrados na agência.
Ação recomendada: acesse os dados cadastrais da empresa no sistema e confira se o CNPJ do beneficiário responsável pela conta bancária está correto. Após corrigir o cadastro, gere uma nova remessa de teste.
Erro: Posição 224 do segmento P deve constar zerada
Esse erro pode ocorrer quando a forma de recebimento está configurada com o layout inadequado ou quando existe uma configuração de protesto incompatível com o padrão esperado pelo Banrisul.
Ação recomendada:
- Acesse Empresa > Formas de recebimento.
- Abra a configuração da conta do Banrisul.
- Na parte superior direita da tela, acesse avançado.

- No campo Layout, selecione Agência 4 dígitos.
- Se a opção de protesto estiver habilitada, desmarque a configuração de protesto.
- Salve a alteração.
- Gere uma nova remessa de teste.
A posição 224 faz parte do segmento P do CNAB 240 e corresponde ao código para baixa/devolução no leiaute do Banrisul.
Erro: Incluir o segmento R com instrução de multa
Quando o layout Agência 4 dígitos estiver sendo utilizado com CNAB 240 e houver cobrança de multa, a remessa precisa conter a informação correspondente.
Ação recomendada: nos dados da remessa, habilite a opção Enviar multa na remessa e gere uma nova remessa de teste.
A necessidade dessa configuração também está indicada na documentação atual da Superlógica para homologação do Banrisul.
Erros no boleto
Erro: O endereço do beneficiário informado difere do cadastrado na agência
O endereço apresentado no boleto não corresponde ao cadastro mantido pelo Banrisul.
Ação recomendada: confira os dados cadastrais da empresa no sistema, principalmente o CNPJ utilizado como beneficiário da conta, e compare as informações com o cadastro mantido na agência. Caso exista divergência no cadastro bancário, confirme com o Banrisul quais dados devem prevalecer.
Erro: A linha digitável e o código de barras apresentam erro na constante utilizada
A rejeição está relacionada à constante utilizada na composição do boleto.
Ação recomendada:
- Acesse Empresa > Formas de recebimento.
- Abra a configuração da conta do Banrisul.
- Clique em avançado.
- No campo Layout, selecione Agência 4 dígitos.
- Salve a configuração.
- Gere um novo boleto de teste e uma nova remessa para validação.
Erros no retorno
Erro: O retorno não apresenta os juros pagos corretamente
Após a homologação, o tipo de arquivo de retorno utilizado pelo Banrisul pode precisar ser ajustado para que os juros pagos sejam enviados corretamente ao sistema.
Ação recomendada: solicite ao gerente da conta do Banrisul a alteração do tipo de retorno padrão 1 para o tipo 2, conforme orientação registrada na documentação utilizada para essa configuração.
O retorno é utilizado pelo sistema para processar as informações de pagamento. Por isso, a configuração do tipo de retorno deve estar de acordo com o padrão contratado para a conta.
O leiaute oficial atual do Banrisul mantém os campos de acréscimos, valor pago e valor líquido no arquivo de retorno CNAB 240.
Resultado esperado
Após a correção, a configuração da forma de recebimento deverá gerar o boleto e o arquivo de remessa de acordo com os parâmetros aceitos pelo Banrisul.
A remessa corrigida deve ser enviada novamente ao banco para validação. Após a aprovação, a conta poderá seguir o fluxo de homologação e utilização em produção.
Quando escalar
Escale quando:
- O sistema não permitir salvar uma configuração que esteja de acordo com os dados fornecidos pelo Banrisul.
- A remessa gerada pelo sistema for rejeitada mesmo após a configuração ter sido conferida com o banco.
- O boleto apresentar informações diferentes das configurações cadastradas no sistema.
- O arquivo de retorno processado pelo sistema apresentar comportamento incompatível com o conteúdo enviado pelo Banrisul.
- Houver necessidade de analisar o arquivo gerado pelo sistema para identificar uma divergência que não possa ser corrigida pela configuração disponível.
Problemas relacionados ao cadastro do convênio, aprovação da remessa, validação do boleto ou configuração do retorno no banco devem ser confirmados diretamente com o Banrisul.
Informações para escalonamento
- Conta bancária e agência utilizadas na homologação.
- Código do convênio informado pelo Banrisul.
- Layout configurado na forma de recebimento.
- CNAB utilizado.
- Mensagem ou relatório de rejeição retornado pelo banco.
- Arquivo de remessa gerado pelo sistema.
- Boleto gerado para homologação, quando o erro estiver relacionado ao boleto.
- Arquivo de retorno, quando o problema ocorrer durante o processamento do retorno.
- Print da configuração da forma de recebimento.
- Data e horário da tentativa.
- Orientação ou alteração solicitada pelo Banrisul, quando houver.
Regras importantes / Observações
- O Banrisul utiliza o código bancário 041.
- Para a configuração da forma de recebimento, a Superlógica indica normalmente CNAB 240, podendo ser utilizado CNAB 400 quando solicitado pelo banco.
- O layout Agência 4 dígitos deve ser utilizado quando essa configuração for necessária para o padrão da conta.
- Quando o layout Agência 4 dígitos for utilizado com CNAB 240, a configuração Enviar multa na remessa deve ser observada quando houver cobrança de multa.
- Os parâmetros de homologação podem variar conforme o convênio e a orientação da agência. Os dados fornecidos pelo Banrisul devem prevalecer sobre um preenchimento padrão.
- A homologação da cobrança depende da validação do banco. Salvar a configuração no sistema não significa que a conta já esteja homologada.
- O leiaute oficial do Banrisul atualmente disponibilizado para cobrança segue o padrão FEBRABAN CNAB 240, versão 10.3.
Problemas comuns e como resolver
Problema: A remessa é rejeitada porque o código do convênio está incorreto.
Causa provável: O código cadastrado no sistema não corresponde ao convênio informado pelo Banrisul.
Ação recomendada: Solicite ao banco o código correto do convênio, ajuste o cadastro da forma de recebimento e gere uma nova remessa de teste.
Problema: O sistema apresenta erro relacionado ao dígito da agência ou da conta.
Causa provável: O padrão da conta exige a utilização do layout Agência 4 dígitos.
Ação recomendada: Acesse a configuração da forma de recebimento, clique em avançado, selecione o layout Agência 4 dígitos e salve novamente.
Problema: A remessa com CNAB 240 é rejeitada por ausência da configuração de multa.
Causa provável: O layout Agência 4 dígitos está sendo utilizado sem a opção necessária para envio da multa na remessa.
Ação recomendada: Acesse os dados da remessa, marque Enviar multa na remessa e gere uma nova remessa de teste.
Problema: O boleto apresenta divergência nas informações do beneficiário.
Causa provável: Os dados cadastrais utilizados pelo sistema não correspondem ao cadastro mantido pelo Banrisul.
Ação recomendada: Compare os dados cadastrais do sistema com os dados da agência e corrija as informações divergentes antes de gerar um novo boleto.
Problema: Os pagamentos com juros não são processados com o valor correto após o retorno.
Causa provável: O tipo de retorno utilizado pelo Banrisul não está configurado no padrão necessário para trazer os juros pagos.
Ação recomendada: Solicite ao gerente do Banrisul a alteração do tipo de retorno para o padrão indicado para a conta e, após a alteração, valide um novo arquivo de retorno.
Dúvidas relacionadas (FAQ)
P: Qual é o código do banco Banrisul?
R: O código bancário do Banrisul é 041.
P: Qual CNAB devo utilizar na homologação do Banrisul?
R: Normalmente, utilize CNAB 240. O CNAB 400 deve ser utilizado quando for solicitado pelo banco para o convênio da conta.
P: Quando devo utilizar o layout Agência 4 dígitos?
R: Utilize esse layout quando a configuração da conta apresentar erro relacionado aos dígitos da agência ou conta ou quando esse padrão for solicitado para o convênio.
P: O que fazer quando o Banrisul rejeita a remessa por causa do código do convênio?
R: Confirme com a agência o código correto do convênio e compare a informação com o cadastro da forma de recebimento antes de gerar uma nova remessa.
P: A configuração da forma de recebimento garante que a conta está homologada?
R: Não. A configuração é apenas uma etapa do processo. A remessa e os boletos de teste precisam ser validados pelo Banrisul antes da utilização em produção.
P: Quem deve tratar um problema no convênio ou na validação feita pelo banco?
R: A validação do convênio, a aprovação da remessa e as orientações sobre o padrão bancário devem ser tratadas diretamente com o Banrisul. O suporte da Superlógica deve atuar quando houver necessidade de analisar o comportamento do ERP ou os arquivos gerados/processados pelo sistema.
Palavras-chave de busca
homologação Banrisul, erros homologação Banrisul, erro remessa Banrisul, erro boleto Banrisul, código convênio Banrisul, código beneficiário Banrisul, layout agência 4 dígitos Banrisul, CNAB 240 Banrisul, segmento R Banrisul, enviar multa na remessa Banrisul, retorno Banrisul, forma de recebimento Banrisul, homologar conta Banrisul, cobrança bancária Banrisul, Suporte ERP Imobiliárias