Como permitir a geração de cobranças extras com valor zerado

Visão geral

Este conteúdo detalha a configuração necessária no ERP Superlógica para permitir a geração de cobranças extras com o valor total igual a R$ 0,00, eliminando o bloqueio sistêmico padrão para lançamentos sem valor financeiro positivo.

Quando usar este artigo

Utilize este guia sempre que houver a necessidade de emitir um recibo ou registrar uma cobrança em que os descontos e bonificações anulem o valor das despesas, resultando em um total zerado, ou quando encontrar dúvidas sobre as regras de negócio associadas a este procedimento.

Sintoma ou cenário

Ao tentar gerar uma cobrança onde os créditos do locatário (descontos) igualam ou zeram os débitos (aluguel/taxas), o sistema impede a geração exibindo o erro "Valor da cobrança não informado". O usuário precisa liberar a emissão desse documento zerado para manter o controle de quitação do mês.

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

Permite o registro histórico de meses em que o inquilino teve isenção total.
Redução de erros e da necessidade de controles paralelos manuais..
Maior agilidade e autonomia na gestão das locações.

Onde acessar / contexto de uso

No menu principal, acesse Contratos > Contratos e utilize o ícone de engrenagem (Configurações) no canto superior direito.

Pré-requisitos (Antes de começar)

Perfil Exato: É necessário possuir o Acesso Administrativo (1000) ou Configurações - Alteração (1061) para ativar a flag, e Contratos - Alteração (2600001) para gerar as cobranças.
Recursos Sistêmicos: Módulo ativo em todos os planos.
Insumos e Dados Técnicos: Saber qual contrato necessita do lançamento da cobrança e a discriminação dos descontos aplicados.

Causas prováveis

Necessidade de devolução de valores ao inquilino, lançamento de meses de carência, descontos por benfeitorias ou outras despesas indenizatórias que tornem o valor final da cobrança do mês igual a R$ 0,00.

Como fazer ou corrigir

Implementamos uma nova configuração que permite registrar e salvar cobranças extras cujo valor total seja exatamente R$ 0,00. Esta atualização elimina a trava sistêmica que bloqueava lançamentos sem valor financeiro.

Como ativar e configurar

A funcionalidade pode ser habilitada diretamente nas configurações do módulo de contratos seguindo o caminho abaixo:

Acesse o menu: Contratos>Contratos > Configurações.
Localize a flag: “Lançar cobrança extra com valor zerado”.

3. Marque a opção e clique em salvar.

Resultado esperado

Ao ativar a configuração e salvar, o sistema permitirá a geração de cobranças extras com valor total igual a R$0,00. O documento será registrado no histórico financeiro do contrato como recibo interno de quitação do mês.

Quando escalar

Escale para o time de suporte técnico caso o sistema continue impedindo o salvamento da cobrança zerada mesmo com a flag devidamente marcada nas configurações, ou se ocorrerem erros sistêmicos graves (ex: tela em branco, Erro 500) ao tentar gerar o documento.

Informações que devem ser reunidas antes do escalonamento

Print da tela de erro (com a URL visível).
ID do contrato e da cobrança afetada.

Regras importantes / Observações

Mantenha os dados sempre atualizados para evitar inconsistências em relatórios futuros.
Atenção bancária: Cobranças zeradas não geram arquivo de remessa e não possuem registro no banco (pois as instituições financeiras não processam boletos de R$ 0,00). Elas servem estritamente como registro e recibo interno no ERP.

Problemas comuns e como resolver

Problema: O sistema exibe o erro padrão “Valor da cobrança não informado” e impede a geração do documento.
Causa provável: A tentativa de lançar uma cobrança zerada foi feita sem ativar a configuração geral.
Ação recomendada: Vá em Contratos > Contratos > Configurações, habilite a flag "Lançar cobrança extra com valor zerado" e tente novamente.
Problema: Inconsistência na hora de salvar a cobrança extra (botão não clica).
Causa provável: Falta de preenchimento de campos obrigatórios na composição da despesa.
Ação recomendada: Revise todos os campos marcados com asterisco na tela de lançamento.

Dúvidas relacionadas

P: O sistema agora aceita cobranças com valores negativos? R: Não. A nova funcionalidade flexibiliza apenas o valor total igual a R$ 0,00. Valores negativos continuam bloqueados para evitar inconsistências no Contas a Receber.

P: Como configuro o envio automático desse recibo/boleto zerado por e-mail? R: Isso pode ser feito ativando as notificações de emissão nas configurações da régua de cobrança, no menu Receitas > Régua de cobrança.

P: O que acontece se eu tentar lançar uma cobrança zerada sem ativar a flag? R: O sistema exibirá o erro padrão “Valor da cobrança não informado” e impedirá o salvamento da operação até que um valor maior que zero seja inserido ou a configuração seja habilitada.

Palavras-chave de busca

boleto zerado, cobrança valor zero, isenção de aluguel, carência total, mês gratuito locação, recibo interno, Superlógica imobiliárias