Criação de cobranças de comissão em valores maiores do que o VGC: bloqueio de gerações redundantes

1. Geração de Cobranças de Comissão Limitada ao Valor da Comissão da Transação

Para proteger corretores, imobiliárias, franquias e parceiros externos contra erros operacionais e cobranças duplicadas, o PipeImob agora impede a criação de cobranças de comissão que ultrapassem o valor total da transação.

O sistema não permitirá gerar novas cobranças de comissão quando a soma das cobranças ativas (pagas, pendentes ou vencidas) já atingir ou ultrapassar o VGC — Valor Geral da Transação.

Essa trava é uma medida de segurança que evita que cobranças redundantes sejam emitidas por desconhecimento, desatenção ou erro operacional, trazendo mais clareza e previsibilidade para todas as partes envolvidas na transação.

2. Por que essa trava foi criada?

Essa funcionalidade foi desenvolvida pensando no bom andamento das operações dos nossos clientes e de seus clientes finais, visando garantir que:

Não haja pagamentos duplicados ou equivocados por parte do comprador do imóvel;
Corretores e imobiliárias tenham visibilidade correta sobre seus recebíveis, sem distorções que geram expectativas incorretas;
As franqueadoras recebam royalties de forma correta e proporcional, sem falhas ou excessos;
Os dados e documentos financeiros permaneçam organizados, evitando retrabalho e ruídos internos;
Cobranças sejam corretamente exibidas no DDA, sem confusão para o pagador;
E, principalmente, que o próprio fluxo da transação se mantenha íntegro do início ao fim.

Essa é, portanto, uma camada de proteção contra erros involuntários, que reforça a segurança do processo e contribui para a saúde financeira e operacional da operação.

3. O que fazer quando for necessário gerar uma nova cobrança, mas o sistema bloqueia?

Caso o sistema bloqueie a criação de uma nova cobrança, isso indica que o valor total já cobrado naquela transação está no limite do VGC. Nessa situação, o caminho é:

Revisar as cobranças existentes
O sistema já apresenta automaticamente as cobranças ativas no momento da tentativa de gerar uma nova.
Editar cobranças já existentes
Se a cobrança anterior precisa ser ajustada (por valor, vencimento ou qualquer outro motivo), é possível modificá-la diretamente — desde que o usuário tenha permissão.
Cancelar cobranças desnecessárias ou duplicadas, se for o caso, liberando espaço para uma nova cobrança legítima.

⚠ Importante: na prática, quando um usuário tenta gerar uma nova cobrança apesar do valor já ter sido atingido, é comum que ele esteja tentando corrigir ou complementar algo. Nesses casos, a alternativa correta será sempre editar ou cancelar as cobranças já existentes, conforme necessário.

4. Sobre permissões: quem pode fazer o quê?

A possibilidade de editar ou cancelar uma cobrança depende das permissões concedidas dentro do PipeImob. Essas permissões são controladas pelo guardião da subconta responsável pela cobrança e podem ser configuradas para permitir:

Edição de valores
Edição de vencimentos
Cancelamento de cobranças ativas
Geração de novas cobranças, sem acesso a edições posteriores

Caso você não tenha permissão suficiente, procure o guardião da subconta ou o administrador da sua imobiliária para solicitar os acessos necessários.

5. Clareza, segurança e previsibilidade

Com essa funcionalidade:

Você evita que um simples erro ou desatenção gere retrabalho, ruídos ou pagamentos indevidos;
Ganha mais controle sobre os recebimentos, com total alinhamento entre o que é cobrado e o que é realmente devido;
Protege o comprador, o corretor, a imobiliária e todos os demais envolvidos na transação.

6. O que será feito com as cobranças antigas que excedem o valor da transação?

Como parte da implementação dessa nova regra, o PipeImob realizará uma ação automática de correção nas transações que já possuem cobranças de comissão que ultrapassam o VGC.

As regras aplicadas serão:

Se já houver uma ou mais cobranças pagas que, somadas, atingem ou ultrapassam o VGC: quaisquer outras cobranças ainda abertas (pendentes ou vencidas) que excedam esse limite serão automaticamente canceladas.
Se não houver nenhuma cobrança paga, mas houver múltiplas cobranças abertas em excesso: o sistema irá cancelar automaticamente as cobranças mais antigas, mantendo apenas as mais recentes até o limite do valor da transação.

Todas essas ações serão acompanhadas de registro no histórico da transação, garantindo rastreabilidade sobre os cancelamentos realizados.

⚠️ Casos excepcionais — em que a simples exclusão de cobranças em aberto resultaria em um total de cobranças inferior ao VGC da transação, impossibilitando a adequação automática sem causar inconsistência — serão tratados individualmente pela equipe do PipeImob junto às imobiliárias envolvidas.

Isso garante que, mesmo nas exceções, a integridade da transação será mantida e nenhuma cobrança válida será indevidamente cancelada.

Essa limpeza será feita de forma automatizada, com o objetivo de evitar duplicidades, garantir a consistência dos dados financeiros e proteger todas as partes envolvidas nas transações.