Comissão Fluxograma

1 - Cadastrar o Modelo de Cálculo da Comissão: Capa do modelo de cálculo para associar a regra de comissão.
2 - Cadastrar as Regras da Comissão: Entidades que irão receber a comissão.
3 - Cadastrar as Modalidades: As modalidades serão a base para associar as regras da modalidade.
4 - Imóveis X Modalidades: Associação dos imóveis com as modalidades de pagamento da comissão.

Cadastro do Modelo de Calculo Comissão.

Este cadastro , tem o objetivo de determinar a regra de cálculo de cada "vendedor" ou "entidade comissionada", independente se o pagamento da comissão for realizado pela empresa ou pelo próprio cliente. 

Primeiro é preciso habilitar o Perfil para usar o novo modulo Comissões 2.0

01.01.05 – Comissões 2.0

Os tipos de parâmetros que são definidos para o pagamento pela empresa e pelo cliente são diferentes e são eles:

Por empresa: 

• Valor fixo não vinculado ao recebimento das parcelas
  • Número de parcelas (caso o tipo "Valor fixo" seja selecionado)
• Percentual Máximo vinculado ao recebimento das parcelas
  • Percentual máximo vinculado ao recebimento (caso o tipo "Percentual máximo seja selecionado)
  • Fórmula para definir o % máximo vinculado ao recebimento (caso o tipo "Percentual máximo seja selecionado)

Por Cliente:

• Decrescente: Determina a prioridade dos componentes geradores de parcelas para realizar o pagamento da comissão;
• Parcelas Iguais: Determinar que o valor da comissão será rateado de forma igualitária entres todos os componentes utilizados na proposta;
• Proporcional: Determina que valor da comissão será descontado na forma proporcional de cada componente sobre o valor total.

Se marcar a opção 'Utilizar Componentes Específicos' é possível selecionar componentes/Valores de Integração específicos para o cálculo da comissão e definir a prioridade de uso cada um. 

Se desmarcado, serão utilizados todos os componentes/Valores de Integração da proposta do cliente/Plano de Financiamento 

• Se o tipo de Contrato for Venda  deve-se selecionar os componentes geradores de parcelas dos tipos Entrada, Principal e Minha Casa e Minha Vida para utilização no cálculo da comissão.
• Se o tipo de Contrato for Aluguel deve-se selecionar um determinado Código de Integração para utilização no calculo da comissão.  

Cadastro de Função

Menu Comissões 2.0 | Função

O objetivo do cadastro é informar as funções de quem recebe a comissão

Cadastro da Regra de Comissão

O objetivo do cadastro de regra de comissão é informar os dados para a realização do cálculo dos valores da comissão. As regras definidas nesse cadastro poderão ser associados ao cadastro de modalidade de comissão, podendo uma regra ser definida em mais de uma modalidade.

Para utilizar o Cadastro de regra de comissão , é preciso primeiro liberar acesso para o Perfil do usuário.

01.01.05.03 – Regra de Comissão

Comissão 2.0 | Regras da Comissão

Cadastro da Regra de Comissão tem:

Tipo de comissão:

• Comissão
• Prêmio
• Apuração Mensal

Tipo de Valor:

• Valor fixo
• Percentual
• Fórmula para definir o valor
• Fórmula para definir o percentual

Comissão recebida por:

• Imobiliária da proposta
• Corretor da proposta
• SDR da proposta
• Outro Comissionado (Diretor, Supervisor, Gerente, Secretária e etc.)
• Comissionado Avulso Portal de Imóveis  (Permite adicionar um comissionado, no Portal de Imóveis, não previsto na Modalidade, com um regra predefinida ) 

Tipo de integração:

• Folha de Pagamento
• Faturamento (Compras)
• Financeiro 
• Sem integração (essa opção sempre será utilizada em caso de pagamento pelo cliente)

Comissão paga por:

• Empresa
  
• Cliente
• Híbrido (parte empresa e parte cliente)

Código da Função:

Função (campo texto informativo para definir qual é a função de quem recebe a comissão)

Código do Comissionado:

Informar  o código do comissionado para:

• Diretor
• Supervisor
• Superintendente
• Presidente
• Secretaria

Chapa de Funcionário :
O fornecedor comissionado não está associado com a Chapa no TOTVS Folha de Pagamento, sendo que a integração configurada é com a Folha de Pagamento. Assim que possível, execute o processo de Associar Chapa ao Fornecedor da Comissão ou acesse o cadastro do Cli/For => Dados Complementares (TCGI) =>Ocupação Profissional => Tipo de Integração Folha de Pagamento e selecione a chapa 
Caso a Integração seja : TOTVS Folha de Pagamento , o Fornecedor tem que estar associado com uma Chapa do TOTVS Folha de Pagamento.

Parâmetro: Pagar Comissão para Imobiliária.

Este parâmetro marcado , indica que quem irá receber a Comissão será a Imobiliária e assim , depois repassar para o Vendedor.

Modelo de Cálculo:

Informar um tipo definido já cadastrado no Modelo de cálculo da comissão

Ordem de Cálculo da Regra :

É para definir a ordem que será aplicada a Regra de Comissão, principalmente quando o cálculo é realizado por fórmula,

Cadastro de Modalidade da Comissão 

Venda | Contratos | Comissões 2.0 | Modalidades da Comissão

O cadastro de modalidade de comissão é para definir as regras para o pagamento de uma comissão,  desta forma, poderá criar várias modalidades, seja global , por empreendimento, por unidade, por subunidade ou até por imóvel, permitindo assim que as regras cheguem até um nível com granularidade baixa, bem específico. O conceito é similar ao de modalidades da  venda. Nesse momento não será definido a sua vigência,  apenas a composição da modalidade da regra.

Tipo de Contrato 

Definir se é contrato de Venda ou Aluguel

Ativo 

Permite associar a modalidade a um empreendimento, unidade, subunidade ou imóvel.

Este parâmetro não desvincula a sua associação as entidades acima.

Tipos de Controle para o valor máximo da comissão:

Percentual:

Habilita percentual para que o usuário possa informar.

Valor Fixo:

Habilita o campo valor para que o usuário possa informar.

Fórmula percentual ou Fórmula valor:

Habilita Código da Fórmula : Para calcular o valor ou percentual máximo que será utilizado no cálculo da comissão de cada regra.

Não Controla:

Valor ou Percentual Máximo (esse campo não deverá ser preenchido se a opção do tipo de controle for "não controla". Caso contrário, deverá ser preenchido com valor, percentual ou fórmula, dependendo do tipo selecionado)

Código da Fórmula do valor base:

Fórmula valor Base - Fórmula para cálculo do valor base para calcular a Comissão, na integração com Portal de Imóveis o valor será calculado automaticamente, não precisando do uso de fórmulas
Valor Base - Valor Calculado pela Fórmula ou Enviado do Portal de Imóveis

Regras de Vencimentos das Parcelas

• 1ª Regra - Dias Mínimo 1º Pagamento: Dias mínimo para realizar o 1º pagamento da parcela não atrelado a baixa ou dias mínimo para realizar o pagamento a partir da data de baixa;
• 2ª Regra - Dias de Vencimento: Dias de vencimentos permitidos para realizar o cálculo da data de pagamento da comissão, o não preenchimento utilizará apenas as informações dos campos anteriores para o cálculo.
• 3ª Regra - Periodicidade: Periodicidade para cálculo dos vencimentos das parcelas não atrelado a baixa, pois na regra do atrelado sempre depende da data do pagamento;

Exemplos: Data da Comissão = Data da Venda = Data Base do Vencimento = 12/01/2022 , Valor da Comissão R$ 3000,00 em 3X para o corretor, não atrelado a baixa .

• Aplicando a regra do 1º vencimento:
  • 1ª Regra =  12/01/2022 + 10 dias = 22/01/2022; 
  • 2ª Regra = o dia 22 não está nos dias permitidos, então utilizarei o próximo dia a esta data que é 25/01/2022
  • 3ª Regra =o primeiro vencimento não utiliza essa regra, somente para as próximas parcelas 
• Aplicando a regra do 2º vencimento:
  • 3ª Regra = Aplica somente esta regra adicionado a periodicidade cadastra 1 em relação a data de vencimento anterior 
• Aplicando a regra do 3º vencimento:
  • 3ª Regra =Aplica somente esta regra adicionado a periodicidade cadastra 1 em relação a data de vencimento anterior

1º parcela, R$ 1000,00 Vencimento dia 25/01/2022 

2º parcela, R$ 1000,00 Vencimento dia 25/02/2022 

3º parcela, R$ 1000,00 Vencimento dia 25/03/2022 

Exemplos: Data da Comissão = Data da Venda = Data Base do Vencimento = 18/01/2022 , Valor da Comissão R$ 3000,00 em 3X para o corretor, não atrelado a baixa .

• Aplicando a regra do 1º vencimento:
  • 1ª Regra =  18/01/2022 + 10 dias = 28/01/2022; 
  • 2ª Regra 28/01/2022 não está nos dias permitidos, então utilizarei o próximo dia a esta data, mas não existe neste caso. Então, utilizarei o primeiro dia disponível 5 do próximo mês que é 05/02/2022
  • 3ª Regra =o primeiro vencimento não utiliza essa regra, somente para as próximas parcelas 
• Aplicando a regra do 2º vencimento:
  • 3ª Regra = Aplica somente esta regra adicionado a periodicidade cadastra 1 em relação a data de vencimento anterior 
• Aplicando a regra do 3º vencimento:
  • 3ª Regra =Aplica somente esta regra adicionado a periodicidade cadastra 1 em relação a data de vencimento anterior

1º parcela, R$ 1000,00 Vencimento dia 05/02/2022 

2º parcela, R$ 1000,00 Vencimento dia 05/03/2022 

3º parcela, R$ 1000,00 Vencimento dia 05/04/2022 

Exemplos: Data da Comissão = Data da Venda = Data Base do Vencimento = 12/01/2022 , Valor da Comissão R$ 3000,00 para o corretor, atrelado a baixa 50% do valor da parcela.

• 1º Baixa da Parcela do Plano de Financiamento  no dia 13/01/2022, no valor de R$ 2000,00:
  • 1ª Regra =  13/01/2022 + 10 dias = 23/01/2022; 
  • 2ª Regra = o dia 23 não está nos dias permitidos, então utilizarei o próximo dia a esta data que é 25/01/2022
  • 3ª Regra = não utiliza essa regra, pois depende sempre da baixa as próximas parcelas 
• 2º Baixa da Parcela do Plano de Financiamento  no dia 15/02/2022, no valor de R$ 5000,00
  
  • 1ª Regra =  15/02/2022 + 10 dias = 25/02/2022; 
  • 2ª Regra = o dia 25 está nos dias permitidos, então utilizárei-lo 25/01/2022
  • 3ª Regra = não utiliza essa regra, pois depende sempre da baixa as próximas parcelas 

1º parcela, R$ 1000,00 Vencimento dia 25/01/2022 

2º parcela, R$ 2000,00 Vencimento dia 25/02/2022 

Exemplo de uma Modalidade da Comissão Global, que poderia ser também uma para o empreendimento, uma para subunidade e até mesmo uma para o imóvel se a modalidade fosse de Aluguel.

Menu Regras da Modalidade

Objetivo de associar as regras da comissão a modalidade

Menu Parâmetros de Integração

Objetivo de associar os parâmetros de integração com outros sistemas, Financeiro, Movimento e Folha de Pagamento, para as coligadas que a modalidade impactará .

Associação dos Imóveis X Modalidades da Comissão

Venda | Contratos | Comissões 2.0 | Imóveis X Modalidades da Comissão

Essa tela, também, poderá ser acessada nas visões de  Modalidades da Comissão, Empreendimento, Unidade, Subunidade e Imóveis

O cadastro de associação de imóveis a modalidade de comissão é para definir as regras para o pagamento de uma comissão para um empreendimento, unidade, subunidade ou imóvel, permitindo assim que as regras cheguem até um nível com granularidade baixa, bem específico. O conceito é similar ao de tabelas de preço. Além disso, será possível trabalhar com a vigência da modalidade de comissão, para permitir a utilização de regras para um período específico, com a finalidade de permitir ações promocionais de comissionamento.

Ao cadastrar uma associação, os campos de Tipo de Contrato, Prioridade, Id Modalidade e Data de Início são campos obrigatórios 

Um empreendimento /unidade /subunidade/imóvel poderá ter várias modalidades, mas com prioridades diferentes quando houver interseção de datas para aquele nível de associação.

Quando associamos uma modalidade sem selecionar nenhum outro campo específico, isso que dizer que a modalidade é global e será usado para todas as coligadas, todos os empreendimentos e suas unidades,  a partir da data de início e até o seu término. O mesmo vale se o tipo de contrato fosse Aluguel .

Dica:

Se desejarmos fazer uma liquidação de carnaval, para incentivar os corretores a vender nesse período, para uma empreendimento específico ou um lote, devemos preencher os campos das imagens abaixo.

Note que essa modalidade é diferente da anterior e nela aumentamos o percentual de comissão pago ao corretor. 

Após esses cadastros teremos três modalidades associadas na base, sendo que o empreendimento 'Terra Nova', terá duas modalidades, o Lote 18 do empreendimento 'Loteamento Sem Nome' terá duas modalidades,  o empreendimento 'Loteamento Sem Nome'  terá somente uma modalidade, que é o Modelo Padrão e o Empreendimento '29 - Bella Vista', também terá uma modalidade, que é o Modelo Padrão.

A partir desses associações, vamos fazer alguns cenários de Geração de Comissão:

1.  Vou fazer uma venda para o Empreendimento '27 - Loteamento Sem Nome', Quadra 6 e Lote 18
   1. Na data de venda  01/01/2022, o sistema utilizará a modalidade 1- Padrão de Venda, pois ela está no período da venda;
   2. Na data de venda 27/02/2022, o sistema encontrará duas modalidades para o mesmo período, mas utilizará a modalidade 5- Queima de Estoque, pois ela é a mais específica (Definiu até a subunidade) ; 
      1. Caso houvesse duas modalidades diferentes para o mesmo período e para a mesma subunidade, o sistema irá desempatar com a prioridade;
2.  Vou fazer uma venda para o Empreendimento '28 - Terra Nova', Quadra 1 e Lote 1
   1. Na data de venda  01/01/2022, o sistema utilizará a modalidade 1- Padrão de Venda, pois ela está no período da venda;
   2. Na data de venda 27/02/2022, o sistema encontrará duas modalidades para o mesmo período, mas utilizará a modalidade 5- Queima de Estoque, pois ela é a mais específica (Definiu até o empreendimento) ; 
      1. Caso houvesse duas modalidades diferentes para o mesmo período e para o mesmo empreendimento, o sistema irá desempatar com a prioridade;
3.  Vou fazer uma venda para o Empreendimento '29 - Bella Vista', Quadra 2 e Lote 2
   1. Na data de venda  01/01/2022, o sistema utilizará a modalidade 1- Padrão de Venda, pois ela está no período da venda;
   2. Na data de venda 27/02/2022, o sistema encontrará apenas uma modalidade para o período, pois não foi definido nenhuma regra específica para esse empreendimento, então  utilizará também a modalidade '1- Padrão de Venda'; 

Processo - Associação dos Imóveis X Modalidades da Comissão

Através desse processo, a forma de comissionamento será mais flexível e vai ser definida em vários níveis diferentes.

Nesse processo, a modalidade, data de início e prioridade são campos obrigatórios.

O tipo de contrato vem da Modalidade, ou seja se for venda, só posso selecionar dados da Venda e se for aluguel, só pode selecionar dados do aluguel.

Se a Modalidade for Contrato de Venda, poderá associar :

1. Global;
2. Empreendimento;
3. Unidade:
4. Subunidade

Se a Modalidade for Contrato de Aluguel, poderá associar :

1. Global;
2. Imóvel;

Cadastro da Comissão

O cadastro de comissão tem a finalidade de realizar os cálculos dos valores da comissão de um contrato de Venda ou Aluguel para seus comissionados. 

No menu de Comissões 2.0 é possível criar campos complementares para o cadastro

1 : Liberar o Perfil para o cadastro de Comissão

2 : Clicar sobre Comissões 2.0

3 : Cadastro de Comissão ( Venda e Aluguel )

Menu Identificação:

Selecione o contrato comissionado e a modalidade que buscará os dados de cálculos associados a ela e os parâmetros de integração da coligada do contrato.

Ao utilizar o tipo de controle para o valor máximo da comissão, o sistema limitará a comissão total de seus comissionados com esse valor/percentual, trazendo uma maior segurança na gestão de pagamentos.

Menu Parâmetros Integração:

Selecione os parâmetros integração que serão utilizados nessa comissão com os outros produtos da Linha RM.

Menu Itens da Comissão - Comissionados:

O cadastro de itens da Comissão tem como objetivo informar as regras da modalidade e seus comissionados, preparando assim para realizar os cálculos de seus comissionados.

Ao selecionar a regra da comissão, o sistema preencherá os campos de valores associados a ela,  podendo ser alterados somente na situação de "Em Preparação" ou "Calculados".

Alterando um Item de Comissão

• % Quem paga -
  • Só pode alterar entre 1 e 100%;
    • se passar diferente será ignorado a alteração
    • Se deseja zerar o percentual para excluir um dos comissionados quem paga cliente ou empresa deve excluir o registro para o sistema manter apenas um deles e recalcular o percentual de quem paga.
    • se estou alterando o comissionado para 100% quem paga a comissão, exemplo Empresa, e existe o seu par, cliente,
      então essa ação deve ser feita deletando o cliente comissionado, pois os seus valores não existe mais, ficando zerados
  • Caso o percentual esteja 100 e seja reduzido, então deve-se criar o comissionado parte empresa ou parte cliente com a diferença;
  • Se alterar esse campo, sempre terá prioridade em relação a alteração do valor da comissão ou do percentual, vai depender do tipo de valor da comissão;
  • Serão bloqueados os campos de valores da comissão e liberados após salvar os dados
  • Alterando esse campo, ele interfere diretamente nos valores de %Comissão ou Valor da Comissão, pois mudando o percentual de quem paga vou alterar esses campos campos com  base na nova proporção de de quem paga.
    • Exemplo: Corretor quem paga é 100% empresa e o tipo valor da comissão é PERCENTUAL, que tem o valor de 2%.
      • Vou alterar o percentual de quem paga empresa para 60%, dessa forma o percentual da comissão ficara 60% de 2% = 1,2%;
      • Vou criar o corretor quem paga cliente que ficará com o restante de 40%, dessa forma ficará com o resto do percentual 0,8%;
    • O mesmo raciocínio valerá para o tipo Tipo de valor quando for valor comissão;
• Pagar a Imobiliária; (Está bloqueado nesse momento , não iremos liberar)
  • só pode alterar se não for imobiliária  e for quem paga empresa 
    • se passar diferente será ignorado a alteração
• Tipo de Cálculo;
  • Se quem paga for empresa,  pode alterar conforme o tipo de cálculo para 0 e 1
    • se passar diferente será ignorado a alteração;
  • Se quem paga for cliente, pode alterar para o tipo 0, 1 e 2;
    • se passar diferente será ignorado a alteração
• Nro de Parcelas;
  • Só pode alterar se quem paga for empresa;
    • se passar diferente será ignorado a alteração
• % Comissão;
  • só pode alterar se o tipo valor for Percentual e não tiver alterado o percentual de quem paga;
    • se passar diferente será ignorado a alteração
    • Exemplo:  Corretor quem paga é 50% empresa  e 50% cliente, o tipo valor da comissão é PERCENTUAL, que tem o valor total de 2%, sendo 1% para cliente e 1% para empresa.
      • Vou alterar o percentual da comissão do corretor empresa para 2% e a parte cliente ficará com 1%, dessa forma o percentual de quem paga não é mais 50% para cada, vou recalcular a proporção de ambos que ficará com 66,6667% parte empresa e  33,3332% parte cliente%;
      • Vou criar o corretor quem paga cliente que ficará com o restante de 40%, dessa forma ficará com o resto do percentual 0,8%;
    •  o mesmo raciocínio valerá para o tipo Tipo de valor quando for valor comissão;
    • Serão bloqueados os campos de percentual de quem paga a comissão e liberados após salvar os dados
• Valor Comissão.
  • Só pode alterar se o tipo valor for valor comissão e não tiver alterado o percentual de quem paga. 
    • se passar diferente será ignorado a alteração
  • Serão bloqueados os campos de percentual de quem paga a comissão e liberados após salvar os dados.

Deletando um item de comissão

Caso seja deletado um comissionado que tem comissão paga pela empresa e pelo cliente, o valor da comissão/percentual fica para uma das duas situações.

Sendo assim, caso apague o comissionado cliente, então o valor/percentual da comissão vai para comissionado empresa e vice-versa.

Se for um comissionado comum é apagada normalmente o registro

Incluindo um item de comissão

Caso seja incluindo um comissionado que tem comissão paga pela empresa com percentual menor que 100%, então será criado o comissionado cliente com o a diferença desse percentual e calculando a nova proporção do percentual da comissão em cima dessa proporção de cliente e empresa.

Se for criado um comissionado com regra quem paga 100%, regra padrão, então cria apenas o próprio registro.

Menu Parcelas da Comissão:

O cadastro tem como objetivo definir o parcelamento da comissão, vencimento e seus valores,  bem como controlar a integração de cada parcela com outros produtos da linha RM.

As parcelas podem ser fixas ou oriundas das baixas de lançamentos financeiros com o seu percentual de comprometimento

Cadastro de Campos Complementares da Comissão

Menu Comissões 2.0 | Campos Complementares

O objetivo do cadastro é criar colunas de qualquer tipo associada ao cadastro de comissão

Campo visualizado na Comissão

Parâmetros do Movimento da Comissão

Esse cadastro tem como objetivo definir os parâmetros para a integração com a TOTVS Gestão de Estoque, Compras e Faturamento. Informando a coligada, tipo de movimento, o produto, a filial, etc.

Se marcado, não será possível alterar os parâmetros default no processo.

Campo livre para a descrição.

Campos para selecionar a Coligada do Movimento

Campos para selecionar o Tipo de Movimento

Campos para selecionar o Produto

Campos para selecionar onde vai buscar a Filial.

Selecionando "Empreendimento", será informado a mesma filial do empreendimento da venda que estiver no cadastro da comissão;

Selecionando "Parâmetro", terá que informar a Filial no campo ao lado.

Campos para selecionar onde vai buscar a Natureza.

Selecionando "Não se Aplica", não será informado a Natureza;

Selecionando "Empreendimento", será informado a mesma Natureza do empreendimento da venda que estiver no cadastro da comissão;

Selecionando "Parâmetro", terá que informar a Natureza no campo ao lado.

Campos para selecionar onde vai buscar o Centro de Custo.

Selecionando "Não se Aplica", não será informado o Centro de Custo;

Selecionando "Empreendimento", será informado o mesmo Centro de Custo do empreendimento da venda que estiver no cadastro da comissão;

Selecionando "Unidade", será informado o mesmo Centro de Custo da unidade da venda que estiver no cadastro da comissão;

Selecionando "Parâmetro", terá que informar o Centro de Custo no campo ao lado. 

Campos para selecionar onde vai buscar o Rateio Centro de Custo

Selecionando "Não se Aplica", não será informado o Rateio Centro de Custo;

Selecionando "Empreendimento", será informado o mesmo Rateio Centro de Custo do empreendimento da venda que estiver no cadastro da comissão;

Selecionando "SubUnidade", será informado o mesmo Rateio Centro de Custo  da subunidade da venda que estiver no cadastro da comissão;

Campo para selecionar os mnemônicos do histórico que irão aparecer nos movimentos de faturamento.

Clicar com o botão direito  do mouse, para selecionar os mnemônicos.

Parâmetros do Financeiro da Comissão

Esse cadastro tem como objetivo definir os parâmetros para a integração com a TOTVS Financeiro.

Informar a coligada e os dados pertinentes para geração de lançamento a pagar na comissão

Processo - Gerar  Comissão

Sobre o Processo de Calcular a Comissão no TOTVS Gestão de Imóveis, antigamente a comissão era calculada ao salvar, com o novo processo , agora é possível calcular todos os itens de comissões e todas as comissões.
Esse processo está disponível na visão de Comissão.

Será também chamado no processo de Gerar Comissão para melhor usabilidade do usuário.

O cálculo seguirá a ordem dos valores da comissão e posteriormente as regras da comissão ordenado pela ordem de cálculo.

Tela da Venda 

Comissão:

• Calcular o Valor Base da Comissão se for via fórmula e jogar no campo Valor Comissão Base;
• Calcular o Valor Máximo da Comissão se o tipo definido o for Fórmula e jogar o seu valor para o campo valor ou percentual ;
  Armazenar o log de cálculo das fórmulas em sues campos correspondentes

Item de Comissão:

• Calcular na Ordem de Cálculo;
• Calcular o valor do item comissão e jogar seu valor para percentual ou valor e armazena a memória de cálculo da fórmula;
• Calcular a Fórmula de % máximo somente quando for implementado outro serviço de criar as parcelas vinculado ao recebimento.

Se o tipo comissão empresa for "Não vinculado a baixa", deverá gerar as parcelas das comissões e jogar o valor do arredondamento na última parcela, definir a data de vencimento de cada parcela. Se o tipo for vinculado a baixa, existirá um outro processo para gerar as parcelas e as baixas vinculadas as parcelas.

Exemplo da Geração de Comissão:

01 ) Cadastro da Modalidade de Calculo da Comissão 

Informo quantiade de Parcelas , pago pela empresa ou cliente... Se é fixo ou vinculado ao recebimento de parcelas.

02) Cadastro de Regra de Comissão.

Exemplo do cadastro de Corretor Padrão

Neste exemplo de Regra ( Corretor Padrão ) , encontra-se de forma Hibrido ( 50 % para Empresa e 50 % Cliente ).

50% dos 2% = 1% pela Empresa 

50% dos 2% = 1 % pelo Cliente.

03) Cadastro da Modalidade 

Cadastro da Modalidade de Comissão - Inserir as regras que irão fazer parte da Modalidade , e neste exemplo , existem 4 regras cadastradas.

• Corretor Padrão
• Imobiliária
• SDR
• Diretor

04) Imóveis x Modalidades de Comissão

Cadastro de Imóveis x Modalidades de Comissões , esse cadastro irá definir a ordem que serão aplicadas as comissões. 

Sobre o cadastro de Imóveis x Modalidades de Comissão : TOTVS Construção Gestão de Imóveis - Comissão V2.0 (12.1.2205 e posteriores).

Gerando a Comissão:

Neste exemplo , informando um contrato de Venda ( Data Comissão ) onde irá pegar a Modalidade que se enquadra em seu cadastro de Prioridade.

Comissão gerada no valor total de 8 Mil Reais , encontra-se Calculada e correta , pois não ultrapassou o valor dos 10 Mil definidos para o valor de Comissão.

• Esses valores dos ítens da Comissão podem ser editados para se enquadrar no valor correto da Comissão.

Recalculando Comissão:

Neste exemplo , a Comissão foi gerada no valor de 11 Mil Reais , ultrapassando o valor da Comissão de 10 Mil reais , neste caso será editada um dos item de Comissão para que o valor possa se enquadrar dentro dos 10 Mil.

 Lembrando que o Status fica = Limite de Valor Extrapolado

Após editar o Valor do ìtem , pode clicar em Calcular no Item.

Calcular no cadastro da Visão de Comissão

Ou Recalcular Comissão.

Passando a ficar Correta a comissão  ( Calculada ).

Exclusão de Comissão

Para Excluir uma ou mais comissões, é preciso apenas marcar as comissões que deseja excluir e depois clicar no ícone de exclusão.

Ao excluir um Contrato de venda que não esteja efetivada, será excluído automaticamente todas as comissão associadas a essa venda.

Constantes da Comissão

Para fins de entendimento das classificações dos dados no módulo de comissão, estão listadas abaixo todas as constantes utilizadas nele, como também para apoiar na criação de relatórios:

• Tipo Origem do Contrato: 

            0 - Venda;

            1 - Aluguel;

            2 -  Condomínio Empreendimento.

• Tipo de Comissão Controle do Valor Máximo:

            0 - Percentual;

            1 - Valor Fixo;

            2 - Formula Valor;

            3 - Formula Percentual;

            4 - Não Controla.

• Tipo Comissão Calculo:

            0 - Valor Fixo Não Vinculado Ao Recebimento de Parcelas;

            1 - Percentual Máximo Vinculado Ao Recebimento de Parcelas.

• Tipo Comissão Calculo Cliente:

            0 - Decrescente;

            1 - Parcelas Iguais;

            2 - Proporcional.

• Tipo Comissão Regra:

            0 - Comissão;

            1 - Premio;

            2 - Apuração Mensal.

• Tipo Comissão Valor:

            0 - Percentual;

            1 - Valor Fixo;

            2 - Formula Valor;

            3 - Formula Percentual.

• Tipo Comissão Quem Paga:

            0 - Empresa;

            1 - Cliente;

            2 - Hibrido.

• Tipo Status Comissão:

            0 - Em Preparação;

            1 - Calculada;

            2 - Em Integração;

            3 - Concluída.

• Tipo Comissão Integração:

            0 - TOTVS Gestão Estoque Compras Faturamento;

            1 - TOTVS Folha De Pagamento;

            2 - TOTVS Financeiro;

            3 - Sem Integração.

• Tipo Origem Comissão:

            0 - Default;

            1 - Sistema;

            2 - PVI;

            3 - Visão Venda;

            4 - Conversor;

            5 - Processo Gerar.

Tipo de API's 

{
    "idcomissao": 103,
    "idmodcomissao": 1,
    "data": "2022-01-01T00:00:00",
    "codcolcontrato": 20,
    "contrato": "1911",
    "codpessempr": 27,
    "nomefantasia": "JARDIM DAS ORQUÍDEAS ",
    "numunid": "000021",
    "nomeunid": "000021",
    "numsubunid": "000012",
    "nomecorretor": "SILVERIO MORAIS",
    "statuscomissao": "Calculada",
    "datavenda": "2022-01-01T00:00:00",
    "valorcomissaototal": 3600.0000,
    "valorbase": 90000.0000,
    "valormax": 3600.0000,
    "comissionados": [
        {
            "idcomissao": 103,
            "iditemcomissao": 1,
            "idregracomissao": 1,
            "stateentity": 0,
            "percentualcomissao": 0.5000,
            "valorcomissaocorretor": 450.0000,
            "nroparcelas": 3,
            "statuscomissaocorretor": "Calculada",
            "codfuncao": 4,
            "dscfuncao": "Corretor",
            "percentual": 50.0000,
            "codcolcfo": 0,
            "codcfo": "01;C100338",
            "nomecfo": "SILVERIO MORAIS",
            "pagarcomissaoaimob": 0,
            "tipoquempaga": "Empresa",
            "codtipoquempaga": 0,
            "tipocomissao": "Comissão",
            "codtipocomissao": 0,
            "tipocalculocomissaoitem": "Valor Fixo",
            "codtipocalculocomissaoitem": 0,
            "tipovalor": "Fórmula Percentual",
            "codtipovalor": 3
        },
        {
            "idcomissao": 103,
            "iditemcomissao": 2,
            "idregracomissao": 1,
            "stateentity": 0,
            "percentualcomissao": 0.5000,
            "valorcomissaocorretor": 450.0000,
            "nroparcelas": 1,
            "statuscomissaocorretor": "Calculada",
            "codfuncao": 4,
            "dscfuncao": "Corretor",
            "percentual": 50.0000,
            "codcolcfo": 0,
            "codcfo": "01;C100338",
            "nomecfo": "SILVERIO MORAIS",
            "pagarcomissaoaimob": 0,
            "tipoquempaga": "Cliente",
            "codtipoquempaga": 1,
            "tipocomissao": "Comissão",
            "codtipocomissao": 0,
            "tipocalculocomissaoitem": "Descrescente",
            "codtipocalculocomissaoitem": 0,
            "tipovalor": "Fórmula Percentual",
            "codtipovalor": 3
        },
        {
            "idcomissao": 103,
            "iditemcomissao": 3,
            "idregracomissao": 2,
            "stateentity": 0,
            "percentualcomissao": 1.0000,
            "valorcomissaocorretor": 900.0000,
            "nroparcelas": 3,
            "statuscomissaocorretor": "Calculada",
            "codfuncao": 5,
            "dscfuncao": "Imobiliária",
            "percentual": 100.0000,
            "codcolcfo": 0,
            "codcfo": "01;C100577",
            "nomecfo": "SILVA && SILVA",
            "pagarcomissaoaimob": 0,
            "tipoquempaga": "Empresa",
            "codtipoquempaga": 0,
            "tipocomissao": "Comissão",
            "codtipocomissao": 0,
            "tipocalculocomissaoitem": "Valor Fixo",
            "codtipocalculocomissaoitem": 0,
            "tipovalor": "Percentual",
            "codtipovalor": 0
        }
 ]
}

Exemplo - Solicitação visualizar Comissões:  
{
    "TipoUsuarioComissionado": "0",
    "CpfOuCnpjUsuarioComissionado": {
        "CpfCnpj": "099.821.769-78"
    },
    "CpfOuCnpjSubordinados": [
        { "CpfCnpj": "" },
        { "CpfCnpj": "" }
    ],
    "CnpjImobiliaria": {
        "CpfCnpj": ""
    },
    "DataInicial": null,
    "DataFinal": null,
    "CodigoEmpreendimento": null
}
ou simplificada
	{
    "TipoUsuarioComissionado": "0",
    "CpfOuCnpjUsuarioComissionado": {
        "CpfCnpj": "011.211.841-50"
    }
}

{
    "count": 3,
    "hasNext": false,
    "items": [
        {
            "idcomissao": 7,
            "idmodcomissao": 4,
            "data": "2022-03-04T00:00:00",
            "codcolcontrato": 1,
            "contrato": "2578",
            "codpessempr": 2019,
            "nomefantasia": "EMPREENDIMENTO MODELOS DE CÁLCULO",
            "numunid": "03",
            "numsubunid": "000025",
            "nomecorretor": "Corretor da Proposta",
            "statuscomissao": "Em Preparação",
            "datavenda": "2022-02-11T00:00:00",
            "valorcomissaototal": 1000.0000
        },
        {
            "idcomissao": 14,
            "idmodcomissao": 4,
            "data": "2022-03-11T00:00:00",
            "codcolcontrato": 1,
            "contrato": "9896",
            "codpessempr": 2019,
            "nomefantasia": "EMPREENDIMENTO MODELOS DE CÁLCULO",
            "numunid": "03",
            "numsubunid": "000030",
            "nomecorretor": "Corretor da Proposta",
            "statuscomissao": "Em Preparação",
            "datavenda": "2022-03-11T00:00:00",
            "valorcomissaototal": 11000.0000
        }
    ]
}

Posso usar um JSON básico, apenas com o campo alterado
{"percentualcomissao": 2.0000}

ou completo com a estrutura do comissionado
{
"idcomissao": 103,     
"iditemcomissao": 1,     
"idregracomissao": 1,     
"percentualcomissao": 0.6000,     
"valorcomissaocorretor": 450.0000,     
"nroparcelas": 3,     
"statuscomissaocorretor": "Calculada",     
"codfuncao": 4,     
"dscfuncao": "Corretor",     
"percentual": 50.0000,     
"codcolcfo": 0,     
"codcfo": "01;C100338",     
"nomecfo": "SILVERIO MORAIS",     
"pagarcomissaoaimob": 0,     
"tipoquempaga": "Empresa",     
"codtipoquempaga": 0,     
"tipocomissao": "Comissão",     
"codtipocomissao": 0,     
"tipocalculocomissaoitem": "Valor Fixo",     
"codtipocalculocomissaoitem": 0,     
"tipovalor": "Fórmula Percentual",     
"codtipovalor": 3 }

{   
    "idcomissao": 103,
    "iditemcomissao": null,
    "idregracomissao": 11,    
    "percentualcomissao": 1.0000,
    "valorcomissaocorretor": 0.0000,
    "nroparcelas": 5,    
    "codfuncao": 7,
    "dscfuncao": "Avulso",
    "percentual": 50.0000,
    "codcolcfo": 0,
    "codcfo": "01;C100338",
    "nomecfo": "SILVERIO MORAIS",    
    "codtipoquempaga": 0,
    "tipoquempaga": "Empresa",    
    "codtipocomissao": 0,
    "tipocomissao": "Comissão",        
    "codtipocalculocomissaoitem": 0,
    "tipocalculocomissaoitem": "Valor Fixo",
    "codtipovalor": 0,
    "tipovalor": "Fórmula"    
}

[
    {
        "idcomissao": 103,
        "iditemcomissao": 0,
        "idregracomissao": 11,
        "stateentity": 0,
        "percentualcomissao": 1.0000,
        "valorcomissaocorretor": 0.0,
        "nroparcelas": 3,
        "codfuncao": 7,
        "dscfuncao": "Avulso",
        "percentual": 100.0000,
        "codcolcfo": 0,
        "pagarcomissaoaimob": 0,
        "tipoquempaga": "Empresa",
        "codtipoquempaga": 0,
        "tipocomissao": "Comissão",
        "codtipocomissao": 0,
        "tipocalculocomissaoitem": "Valor Fixo",
        "codtipocalculocomissaoitem": 0,
        "tipovalor": "Percentual",
        "codtipovalor": 0
    },
    {
        "idcomissao": 103,
        "iditemcomissao": 0,
        "idregracomissao": 15,
        "stateentity": 0,
        "percentualcomissao": 1.0000,
        "valorcomissaocorretor": 0.0,
        "nroparcelas": 3,
        "codfuncao": 8,
        "dscfuncao": "Secretária",
        "percentual": 100.0000,
        "codcolcfo": 0,
        "pagarcomissaoaimob": 0,
        "tipoquempaga": "Empresa",
        "codtipoquempaga": 0,
        "tipocomissao": "Prêmio",
        "codtipocomissao": 1,
        "tipocalculocomissaoitem": "Valor Fixo",
        "codtipocalculocomissaoitem": 0,
        "tipovalor": "Percentual",
        "codtipovalor": 0
    }
]

Exemplo - Solicitação Geração da Comissão:

{
  "codColContrato": 1,
  "contrato": "54",
  "dataComissao": "2022-03-25",
  "valorBaseComissao": 8000,
  "cpfOuCnpjCorretorProposta": {
    "cpfCnpj": "812.406.850-09"
  },
  "cpfOuCnpjImobiliariaProposta": {
    "cpfCnpj": "384.042.140-34"
  },
  "cpfOuCnpjSDRProposta": {
    "cpfCnpj": "384.042.140-34"
  }
}

Exemplo - Solicitação Recalculo da Comissão:  
Opcional, caso queira mudar a data e o valor, se não passar nada somente recalcula buscando o valores da venda 
{
    "valorbase": 90000.0000,
    "data": "2022-03-11"
}

[
    {
        "codcoligada": 20,
        "codpessempr": 28,
        "numunid": "000001",
        "numsubunid": "000101",
        "area": 100.0,
        "precoM2": 2117.35,
        "precosubunid": 211735.27,
        "componentesgeradores": [
            {
                "codgrupo": 1,
                "codcompn": 1,
                "descompn": "8 x Entrada - Teste",
                "valorparcela": 7940.07
            },
            {
                "codgrupo": 1,
                "codcompn": 2,
                "descompn": "160 x Mensal",
                "valorparcela": 1804.64
            }
        ]
    },
    {
        "codcoligada": 20,
        "codpessempr": 28,
        "numunid": "000001",
        "numsubunid": "000102",
        "area": 100.0,
        "precoM2": 2483.88,
        "precosubunid": 248388.22,
        "componentesgeradores": [
            {
                "codgrupo": 1,
                "codcompn": 1,
                "descompn": "8 x Entrada - Teste",
                "valorparcela": 9314.56
            },
            {
                "codgrupo": 1,
                "codcompn": 2,
                "descompn": "160 x Mensal",
                "valorparcela": 2117.04
            }
        ]
    }
]

{
    "company": 0,
    "name": "UTILIZACOMISSAOVERSAO2",
    "value": "1"
}

{
    "count": 1,
    "hasNext": false,
    "items": [
        {
            "codColigada": 20,
            "codUsuario": "mestre",
            "securityId": 813000346,
            "executeId": 0,
            "insertID": 1,
            "deleteID": 2,
            "editID": 3,
            "tagId": 0,
            "allowEdit": true,
            "allowInsert": true,
            "allowView": true,
            "allowDelete": false,
            "allowTagId": true,
            "imbTableFieldRestrictionsSecurity": [
                {
                    "tableName": "XCOMISSOES",
                    "columnName": "PERCENTUALMAX",
                    "denyEdit": true,
                    "denyView": false,
                    "podeConsultar": "T",
                    "podeAlterar": "F"
                },
                {
                    "tableName": "XCOMISSOES",
                    "columnName": "PERCENTUALMAX",
                    "denyEdit": true,
                    "denyView": false,
                    "podeConsultar": "T",
                    "podeAlterar": "F"
                },
                {
                    "tableName": "XCOMISSOES",
                    "columnName": "PERCENTUALMAX",
                    "denyEdit": true,
                    "denyView": false,
                    "podeConsultar": "T",
                    "podeAlterar": "F"
                }
            ],
            "systemMensage": "Usuário Logado com Sucesso!"
        }
    ]
}

Fórmulas Comissão

Processo de Integrar/Cancelar Parcelas de Comissão

O Processo de Gerar/cancelar Integração da Comissão no RM enviará as informações das parcelas da comissão, de acordo com cada regra.
A comissão pode ser integrada com o uso da Fórmula de validação ou sem o uso.
Somente parcela com status de calculada que será integrada.
O cancelamento da integração pode ser feito de todas as parcelas ou de uma competência.

Os tipos de integração disponível são TOTVS Gestão de Estoque Compras e Faturamento,  TOTVS Gestão Financeira e TOTVS Folha de Pagamento.

Liberar Perfil do Usuário para utilizar o processo de Integração das Parcelas da Comissão

Tipos de Processos da Integração e Cancelamento da Integração das Parcelas

Processo de gerar ou cancelar parcela de comissão atrelada a baixa de lançamento

Estes processos encontram-se  na visão de Comissão , como mostra a figura abaixo:

Processo de Gerar/cancelar Parcela de Comissão Atrelado a Baixa, que irá buscar todas as baixas em uma determinada competência para as comissões que tenham o tipo de cálculo atrelado a baixa.

Ao realizar a baixa de uma parcela que esteja associada a comissão através do contrato de venda, o sistema irá buscar o percentual da máximo vinculado a parcela para gerar a parcela de comissão na competência da baixa, da mesma forma. o sistema irá cancelar a parcela de uma competência específica.

Exemplo para se Gerar e Cancelar comissão Atrelada a Baixa:

Gerando Parcela de Comissão:

Contrato de Venda encontra-se com Parcela Paga!

Modelo de Cálculo , cadastrado com o Tipo de Comissão Paga pela Empresa : Percentual máximo vínculado ao recebimento das parcelas.

Modalidade de Comissão cadastrada com o Modelo de Cálculo e vinculada ao contrato de venda na qual encontra-se uma parcela PAGA.

Comissão encontra-se gerada para o contrato de Venda 9899 e SEM PARCELA de comissão.

Selecionando a Comissão e em seguida : Processos | Gerar Parcela da Comissão Atrelado a Baixa.

Podendo selecionar o Mês corrente ou Data Específica.

Parcela de Comissão criada.

Mostrando o Lançamento da Baixa juntamente com a Parcela de Comissão Gerada.

Excluir Parcela de Comissão

Selecionar a Comissão na qual foi gerada parcela e em seguida : Processos | Excluir Parcela da Comissão Atrelado a Baixa.

Seleciona a Competência e em seguida - Executar.

Parcela Excluída.

Nova visão de comissão no Portal de Imóveis

A nova visão da comissão no Portal de Imóveis será acessada através do menu Corretores / Comissão 2.0 ou Propostas / Comissão.

Esta visão somente estará disponível se o parâmetro que utiliza a comissão 2.0 estiver marcado no backoffice e uma sincronia tiver sido feita.

Para dar acesso ao menu, verifique o cadastro de grupo de usuário, no meu Corretores / Comissão 2.0.

Esta visão será uma visão agrupadora, ou seja, irá agrupar as comissões dos usuários de acordo com os parâmetros de filtro ou situação da comissão e papel do usuário no sistema.

Papeis de usuários acessando a comissão do portal de imóveis:

• Quando o usuário é um usuário que possui subordinados, este usuário terá acesso as suas comissões, bem como as comissões de seus usuários subordinados.
• Quando o usuário é um corretor, ele somente terá acesso as suas comissões, sem visualizar as comissões dos outros usuários.
• Quando o usuário é um administrador, ou seja, um analista de TI que acessa o portal de imóveis, ele terá acesso a todas as comissões cadastradas.

Campos da tela de comissão:

• Filtro de data: Possibilita uma filtragem pela data de inclusão da comissão no sistema;
• Filtro de situação: Filtra somente as situações definidas. Integradas, calculadas, em preparação e concluídas;
• Dados da comissão: Os dados da comissão no RM;
• Corretor: O corretor que participa da comissão no sistema;
• Empreendimento: O empreendimento associado a comissão;
• Data da venda: Data da venda no RM;
• Valor: Valor da comissão.
• Opções:
  
  • Ver: Visualiza a comissão e sua distribuição de valores. O item da comissão do RM será exibido nesta tela;
  • Aprovar: Para fluxos de aprovação de gestores;
  • Excluir: Exclui a comissão.

Comportamento do Portal de Imóveis ao salvar proposta na comissão 2.0

O Portal de Imóveis, quando utilizar a comissão 2.0, terá um comportamento de salvar a proposta no backoffice antes da mesma tornar-se uma venda. Isto deve-se ao fato de que, todo o cálculo da comissão será realizado pelo RM. Desta forma, o corretor ao salvar a proposta, irá enviar o registro de venda com status "Proposta" e terá a sua comissão já gerada no RM.

Este registro ainda poderá sofrer alterações e possui somente valores básicos, como a informação da unidade e seu preço de venda no momento em que a proposta foi gerada.

Ao enviar o contrato para o backoffice, através do fluxo normal do Portal, este registro terá seu status alterado de "Proposta" para "Vendido". e todas as informações serão atualizadas neste registro.

Calculo da comissão de proposta salva

Existem algumas premissas para que a comissão seja salva automaticamente no backoffice quando a proposta for salva no Portal de Imóveis.

Deveremos primeiro criar uma modalidade e essa modalidade deve possuir suas regras, bem como seus imóveis parametrizados. Para entender melhor como cadastrar uma modalidade, verificar nesta mesma página a sessão de modalidades da comissão.

Para quaisquer outros tipos de comissionados, por exemplo, gerentes, diretores, ou superiores, a modalidade deverá possuir uma regra que envolva o tipo "Outro Comissionado" e esta pessoa deverá ser cadastrada diretamente na modalidade em questão.

Estando estes pré requisitos aceitos, o Portal de imóveis irá informar, quando salvarmos a proposta, que a comissão foi gerada automaticamente no RM. Para consultar a comissão, basta utilizar o menu como orientado acima.

Quaisquer mudanças que ocorram no RM, como alteração de usuários, valores, percentuais serão refletidas no Portal de Imóveis.

Quando há a alteração de valores de uma proposta, por exemplo, uma alteração de valor ou um desconto que influencie no cálculo de valores da comissão, o portal de imóveis irá recalcular a comissão quando a proposta for salva com os novos valores.

Exclusão da comissão

Existem etapas onde, o backoffice irá excluir automaticamente uma comissão gerada

No cenário onde o tempo de reserva da proposta é derrubado, o backoffice irá excluir automaticamente as comissões geradas através desta proposta. Ou seja, quando o status da minha proposta equivale a "Proposta Cancelada" toda comissão será excluída do backoffice.

Há também momentos onde a comissão tem a sua etapa alterada manualmente pelo próprio corretor ou gerente para "Proposta Cancelada". Nestes casos a comissão no backoffice também será excluída.

Se caso esta mesma proposta tenha seu status alterado para algum diferente de "Proposta Cancelada", a comissão será refeita no backoffice, no momento da alteração de etapa.

Desfazendo venda no backoffice

Tendo em vista que com a comissão 2.0, o portal de imóveis passa a salvar as propostas também no backoffice após a sua criação no portal, alteramos o processo de Excluir Venda no Backoffice, que passa a se chamar "Desfazer Venda no Backoffice".

A única diferença neste processo é que não iremos mais excluir a venda mas sim, alterar o status da mesma de "Vendida" para "Proposta". Alterando também o status da subunidade que passará de vendida para o status definido no Portal de Imóveis na Etapa ao qual a proposta irá voltar.