Child pages
  • TOTVS Construção Gestão de Imóveis - Comissão V2.0 (12.1.2205 e posteriores).

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Parâmetro: Pagar Comissão para Imobiliária.API para recalcular e alterar informações da comissão já cadastrada.

...

Deck of Cards
idComissão!
Card
labelComissão Fluxograma |

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.

Card
labelCadastro do Modelo de Cálculo 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.  


Card
labelFunçã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


Jira
serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyTINPAD001-13628

Card
labelCadastro de Regra de 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.

Essa regra pode ser sobreposta no cadastro de cliente e fornecedor, conforme o destaque da informação abaixo



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,



Info
titleTipo de Integração de Comissão - Cadastro do Fornecedor.

Tipo de Integração de Comissão na aba do TCGI do Cadastro de Fornecedor para indicar o tipo de integração que será realizado no processo de integração da comissão com os outros sistemas (Compras, Financeiro ou Folha de Pagamento).

Ao gerar a comissão, o sistema irá verificar se o tipo de integração do  Fornecedor está preenchido e utilizará na comissão.

Caso esteja "Sem Integração", o sistema buscará a configuração da regra de comissão.

Inserir - Dados Complementares ( TCGI )

AbaC omissão - Tipo de  Integração : Receberá a Comissão por :

  • Sem Integração
  • TOTVS Compras e Faturamento
  • TOTVS Folha de Pagamento
  • TOTVS Gestão Financeira


Info
titlePagar Comissão para Imobiliária

Pagar Comissão para Imobiliária da Proposta

Pode definir se a comissão de um correto será paga a imobiliária. Somente com a opção marcada que esse parâmetro irá sobrepor a regra da comissão. 

Card
labelCadastro de Modalidade da Comissão |

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á .


Info
titleAssociar Parâmetro Integração na Modalidade

O processo  de Associar Modalidades aos Parâmetros de Integrção encontra-se na visão de modalidade da Comissão, onde o usuário poderá selecionar várias modalidades, e o wizard terá quatro etapas:
1 :  Para selecionar as coligadas que serão configuradas
2:   Outra para selecionar os parâmetros de movimento de todas as coligadas configuradas na 1 etapa;
3:   Outra para selecionar os parâmetros do Financeiro de todas as coligadas configuradas na 1 etapa
4:   Por fim selecionar os parâmetros de evento da Folha de Pagamentos e o centro de custo da coligada centralizadora, onde será associada para todas as coligadas da 1 etapa.
Não pode selecionar mais de um parâmetro da mesma coligada e, se não existir o parâmetro da coligada desejada, selecione um parâmetro como padrão de acesse o processo desse parâmetro e realize a cópia entre coligadas desse parâmetro

No final do Processo é feita a cópia dos parâmetros de Integração para Modalidade.



Card
accessKey15
id15
labelImóveis X Modalidades da Comissão |

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;


Info
titleAtenção

Uma Modalidade poderá ser associada em vários empreendimentos / unidades / subunidades ou a um Imóvel do Aluguel. 

Um empreendimento / unidade / subunidade/ imóvel poderá ter várias modalidades, mas com prioridade diferente quando houver interseção de datas;

As regras de validação sãos as mesmas do cadastro de Imóveis X Modalidades da Comissão 



Card
labelCadastro de Comissão |

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


Card
labelCampos Complementares |

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


Card
labelParâmetros do Movimento da 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.

Card
labelParâmetros Financeiro da Comissão |

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


Card
labelGerar 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 : Associa%C3%A7%C3%A3odosIm%C3%B3veisXModalidadesdaComiss%C3%A3o

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 ).

Card
labelExclusão de Comissão |

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.


Card
labelConstantes da Comissão |

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.

Card
labelAPI's da Comissão |

Tipo de API's 


Deck of Cards
idTipos de Apis
Card
labelComissão

Apis de Comissões

API: GET: http://localhost:8051/api/imb/v1/commission/103

API para buscar as comissões de acordo com o ID da comissão.

Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "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
        }
 ]
}
Expand
titleParâmetros

Parâmetros:

  • Id da comissão que fica no final da URL.

Dados recebidos:

  • idcomissao: Id da comissão;
  • idmodcomissao: Código da modalidade da comissão
  • data: Data da comissão;
  • codcolcontrato: Código da coligada do contrato;
  • contrato: Código do contrato;
  • codpessempr: Código do empreendimento;
  • nomefantasia: Nome fantasia do empreendimento;
  • numunid: código da unidade do contrato;
  • numsubunid: código da subunidade do contrato;
  • nomecorretor: Nome do Corretor Principal

  • statuscomissao: Status da Comissão
  • datavenda: data que a venda foi efetivada
  • valorcomissaototal: Valor total da comissão;
  • valorbase: valor da base de cálculo da comissão
  • valormar: valor máximo que uma comissão pode ter
  • comissionados: Lista dos comissionados da comissão.

Dados recebidos dos comissionados:

      • idcomissao: id da comissão pai;
      • iditemcomissao: Código desse item na comissão;
      • idregracomissao: Código da regra da comissão;
      • percentualcomissao: Percentual da Comissão do comissionado
      • valorcomissaocorretor: Valor da comissão do comissionado;
      • nroparcelas: quantidade de parcelas do comissionado;
      • statuscomissaocorretor: Status da Comissão do Comissionado;
      • codfuncao: código da função;
      • dscfuncao: Descrição da função;
      • tipoquempaga: Tipo de quem paga;
      • percentual: Percentual de quem paga a comissão - Cliente ou Empresa;
      • codcolcfo: Código da coligada do comissionado;
      • codcfo: Código do comissionado;
      • nomecfo: Nome do comissionado;
      • pagarcomissaoaimob: Pagar comissão a imobiliária;

      • tipoquempaga: Descrição de quem paga;

      • codtipoquempaga: Código de quem paga;

      • tipocomissao: Descrição do tipo da comissão;

      • codtipocomissao: Código do tipo da comissão;

      • tipocalculocomissaoitem: Descrição do tipo de cálculo da comissão;

      • codtipocalculocomissaoitem: Código do tipo de cálculo da comissão;

      • tipovalor: Descrição do tipo de valor da comissão;

      • codtipovalor: Código do tipo de valor da comissão;


API: POST: http://localhost:8051/api/imb/v1/commission/

Api para buscar comissões de acordo com o usuário logado.

Code Block
rootModelo Json Solicitação Geração Comissão
titleGET - Exemplo requisição
collapsetrue
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"
    }
}
Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "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
        }
    ]
}
Expand
titleParâmetros

Parâmetros:

  • TipoUsuarioComissionado: Corresponde ao tipo de usuário logado no Portal de Imóveis (0=Corretor, 1=Gerente, 2=Imobiliária);
  • CpfOuCnpjUsuarioComissionado: CPF ou CNPJ do usuário logado no Portal de Imóveis;
  • CpfOuCnpjSubordinados: Lista de CPF ou CNPJ dos usuários do Portal de Imóveis subordinados ao Superior/Gerente;
  • CnpjImobiliaria: CNPJ da imobiliária associada ao usuário logado no Portal de Imóveis, para restringe comissões da imobiliária;
  • DataInicial: Data Inicial do período para buscar as comissões;
  • DataFinal: Data final do período para buscar as comissões;
  • CodigoEmpreendimento: Filtro de restrição para empreendimento das comissões.

Dados Recebidos:

  • count: quantidade de itens encontrados.
  • hasNext: Se tem próximo item.
  • items: Lista dos itens encontrados.

Dados recebidos dos itens é o mesmo da primeira API da comissão por ID


API: GET: http://localhost:8051/api/imb/v1/commission/103/sellers

Api para buscar os comissionados de uma comissão específica e retorna a mesma estrutura da API de busca uma comissão.


API: GET: http://localhost:8051/api/imb/v1/commission/103/sellers/1

Api para buscar um comissionado específico de uma comissão específica e retorna a mesma estrutura da API de busca uma comissão.


API: DELETE: http://localhost:8051/api/imb/v1/commission/103/sellers/1

Api para deletar um comissionado específico de uma comissão específica e retorna a mesma estrutura da API de busca uma comissão.

Expand
titleParâmetros

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


API: PUT: http://localhost:8051/api/imb/v1/commission/103/sellers/1

Api para atualizar o dado de um comissionado específico de uma comissão específica e retorna a mesma estrutura da API de busca uma comissão.

Code Block
rootModelo Json Solicitação Geração Comissão
titlePUT - Exemplo requisição
collapsetrue
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 }


Expand
titleParâmetros
  • % 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;
    • 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;
  • 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

Parâmetros:

  • idcomissao: será utilizado da API;
  • iditemcomissao: será utilizado da API;
  • idregracomissao: Id da regra não permite alteração;
  • percentualcomissao: Informar o percentual da Comissão do comissionado, caso seja o tipo valor seja percentual
  • valorcomissaocorretor: Informar o percentual da Comissão do comissionado, caso seja o tipo valor seja valor;
  • nroparcelas: Informar a quantidade de parcelas do comissionado;
  • codfuncao: Código da função não permite alteração;
  • dscfuncao: Descrição da função não permite alteração;
  • tipoquempaga: Tipo de quem paga não permite alteração;
  • percentual: Informar o percentual de quem paga a comissão (Cliente ou Empresa);
  • codcolcfo: código da coligada do comissionado não permite alteração;
  • codcfo: Código do comissionado não permite alteração;
  • nomecfo: Nome do comissionado não permite alteração;
  • pagarcomissaoaimob: Pagar comissão a imobiliária não permite alteração;

  • tipoquempaga: Descrição de quem paga não permite alteração;

  • codtipoquempaga: Código de quem paga não permite alteração;

  • tipocomissao: Descrição do tipo da comissão não permite alteração;

  • codtipocomissao: Código do tipo da comissão não permite alteração;

  • tipocalculocomissaoitem: Descrição do tipo de cálculo da comissão não permite alteração;

  • codtipocalculocomissaoitem: Código do tipo de cálculo da comissão não permite alteração;

  • tipovalor: Descrição do tipo de valor da comissão não permite alteração;

  • codtipovalor: Código do tipo de valor da comissão não permite alteração;

Dados recebidos dos itens é o mesmo da primeira API da comissão por ID


API: POST: http://localhost:8051/api/imb/v1/commission/103/sellers/1

Api para incluir um comissionado específico de uma comissão específica e retorna a mesma estrutura da API de busca uma comissão.

Code Block
rootModelo Json Solicitação Geração Comissão
titlePOST - Exemplo requisição
collapsetrue
{   
    "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"    
}
Expand
titleParâmetros

Só pode criar uma comissionado o tipo quem recebe "Comissionado Avulso PI"  e esteja na modalidade dessa comissão, pois isso indica que o usuário permite incluir novos comissionados com valores defaults. É permitido inserir vários desse tipo e nunca para a mesma pessoa. Se já existir a pessoa para esse tipo de avulso basta realizar o Put desse registro. 

O Id da regra é o campo mais importante, pois ele busca esse comissionado avulso de sua modalidade e insere  com os valores defaults para essa 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.


Parâmetros:

  • idcomissao: será utilizado da comissão que está inserindo a regra;
  • iditemcomissao: sequencial que será criado pela API;
  • idregracomissao: Código da regra da comissão do comissionado que será inserido;
  • percentualcomissao: Informar o percentual da Comissão do comissionado ou buscará o valor default da regra
  • valorcomissaocorretor: Será calculado com base do percentual ou informar o valor da comissão do comissionado ou buscará o valor default da regra;
  • nroparcelas: Informar a quantidade de parcelas do comissionado ou buscará o valor default da regra;
  • codfuncao: Informar o código da função ou buscará o valor default da regra;
  • dscfuncao: Descrição da função - Buscará o valor default da regra;
  • tipoquempaga: Informar o tipo de quem paga ou buscará o valor default da regra;
  • percentual: Informar o percentual de quem paga a comissão (Cliente ou Empresa) ou buscará o valor default da regra;
  • codcolcfo: Informar o código da coligada do comissionado;
  • codcfo: Informar o código do comissionado;
  • nomecfo: Nome do comissionado;
  • pagarcomissaoaimob: Pagar comissão a imobiliária - Buscará o valor default da regra;

  • tipoquempaga: Descrição de quem paga - Buscará o valor default da regra;

  • codtipoquempaga: Código de quem paga - Buscará o valor default da regra;

  • tipocomissao: Descrição do tipo da comissão - Buscará o valor default da regra;

  • codtipocomissao: Código do tipo da comissão - Buscará o valor default da regra;

  • tipocalculocomissaoitem: Descrição do tipo de cálculo da comissão - Buscará o valor default da regra;

  • codtipocalculocomissaoitem: Código do tipo de cálculo da comissão - Buscará o valor default da regra;

  • tipovalor: Descrição do tipo de valor da comissão - Buscará o valor default da regra;

  • codtipovalor: Código do tipo de valor da comissão - Buscará o valor default da regra;


Dados recebidos dos itens é o mesmo da primeira API da comissão por ID


API: GET: http://localhost:8051/api/imb/v1/commission/103/single_sellers/

API para buscar a regra do comissionado avulso para o Lookup do portal de imóvel, para todos os comissionados do tipo avulso que estejam na modalidade da regra da comissão editada, seguir o padrão abaixo de URI 

Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
[
    {
        "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
    }
]
Expand
titleParâmetros

Dados recebidos dos itens é o mesmo do padrão da primeira API dos comissionados


API: POST: http://localhost:8051/api/imb/v1/commission/generate

API para gerar a comissão de forma automática.

Code Block
rootModelo Json Solicitação Geração Comissão
titlePOST - Exemplo requisição
collapsetrue
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"
  }
}
Expand
titleParâmetros

Parâmetros:

  • codColContrato: Código da coligada do contrato;
  • contrato: Código do contrato;
  • dataComissao: Data da comissão;
  • valorBaseComissao: Valor base da comissão;
  • cpfOuCnpjCorretorProposta: CPF ou CNPJ do corretor;
  • cpfOuCnpjImobiliariaProposta: CPF ou CNPJ da Imobiliária;
  • cpfOuCnpjSDRProposta: CPF ou CNPJ do SDR.

Dados recebidos dos itens é o mesmo da primeira API da comissão por ID



API: POST: http://localhost:8051/api/imb/v1/commission/103/recalculates

API para recalcular e alterar informações da comissão já cadastrada.

Code Block
rootModelo Json Solicitação Geração Comissão
titlePOST - Exemplo requisição
collapsetrue
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"
}
Expand
titleParâmetros

Parâmetros:

  • valorbase: Valor base da comissão (Obs.: Caso não informado, será utilizado o valor da venda);
  • data: Data da comissão (Obs.: Caso não informado, será utilizado a data da venda);

Dados recebidos dos itens é o mesmo da primeira API da comissão por ID


API: GET: http://localhost:8051/api/imb/v1/commission/103/sellers/payments

API para retornar as parcelas de pagamento da comissão

Expand
titleRegras

Regras:

  • Se quem paga for o cliente, então devolve a parcela criada na comissão com os comissionados e seus valores;
  • Se quem paga for  a empresa e o tipo de cálculo que quem paga NÃO for atrelado a baixa, então devolve as parcelas criadas na comissão com os comissionados e seus valores;
  • Se quem paga for a empresa e o tipo de cálculo que quem paga for atrelado a baixa, teremos que fazer uma previsão desse pagamento com base no plano de financiamento gerado e a data de vencimento e calcular quando seria pago a comissão e qual o percentual dessa parcela seria destinado a comissão 
Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
[
    {
        "idcomissao": 33,
        "iditemcomissao": 1,
        "tipocomissao": "Comissão",
        "tipoquemrecebe": "Corretor da Proposta",
        "tipoquempaga": "Empresa",
        "tipocalculo": "Valor Fixo",
        "dscfuncao": "Corretor padrão",
        "nomecomissionado": "TESTE",
        "nroparcela": 1,
        "datapagamento": "2022-03-10T00:00:00",
        "valorparcela": 6000.0
    },
    {
        "idcomissao": 33,
        "iditemcomissao": 1,
        "tipocomissao": "Comissão",
        "tipoquemrecebe": "Corretor da Proposta",
        "tipoquempaga": "Empresa",
        "tipocalculo": "Valor Fixo",
        "dscfuncao": "Corretor padrão",
        "nomecomissionado": "TESTE",
        "nroparcela": 2,
        "datapagamento": "2022-04-10T00:00:00",
        "valorparcela": 6000.0
    },
    {
        "idcomissao": 33,
        "iditemcomissao": 1,
        "tipocomissao": "Comissão",
        "tipoquemrecebe": "Corretor da Proposta",
        "tipoquempaga": "Empresa",
        "tipocalculo": "Valor Fixo",
        "dscfuncao": "Corretor padrão",
        "nomecomissionado": "TESTE",
        "nroparcela": 3,
        "datapagamento": "2022-05-10T00:00:00",
        "valorparcela": 6000.0
    },
    {
        "idcomissao": 33,
        "iditemcomissao": 2,
        "tipocomissao": "Comissão",
        "tipoquemrecebe": "Corretor da Proposta",
        "tipoquempaga": "Cliente",
        "tipocalculo": "Proporcional",
        "dscfuncao": "Corretor padrão",
        "nomecomissionado": "TESTE",
        "nroparcela": 1,
        "datapagamento": "2022-03-10T00:00:00",
        "valorparcela": 2000.0
    }
]



Card
labelPlano de Financiamento

Apis de Plano de Financiamento 

API: GET: http://localhost:8051/api/imb/v1/modalities/1/enterprises/20_28

API que retorna os valores das condições de financiamento de todas as subunidades de um empreendimento, utilizando uma modalidade para simular


API: GET: http://localhost:8051/api/imb/v1/modalities/1/enterprises/20_28_000001

API que retorna os valores das condições de financiamento de todas as subunidades de uma unidade de um empreendimento, utilizando uma modalidade para simular


API: GET: http://localhost:8051/api/imb/v1/modalities/1/enterprises/20_28_000001_000101

API que retorna os valores das condições de financiamento de todas a subunidade de uma unidade de um empreendimento, utilizando uma modalidade para simular


Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
[
    {
        "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
            }
        ]
    }
]
Expand
titleParâmetros

Parâmetros:

  • codcoligada: coligada do empreendimento;
  • codpessempr: código do emprrendimento;
  • numunid: código de unidade;
  • numsubunid: código da subunidade;
  • area: área da subunidade;
  • precoM2: preço do m2 da subunidade;
  • precosubunid: preço da subunidade;
  • componentesgeradores: componentes da modalidade;
    • codgrupo: código do grupo que pertence a modalidade;
    • codcompn: código do componente;
    • descompn: descrição do componente;
    • valorparcela: valor do componente;


API: GET: http://localhost:8051/api/imb/v1/Sales/20_1914/rules

API que retorna os principais campos e valores da condição de financiamento, por venda e utilizando uma modalidade para simular e enviar a proposta


API: GET: http://localhost:8051/api/imb/v1/Sales/20_1912/rules/generate/1

API que retorna os principais campos e valores da condição de financiamento, por venda e utilizando uma modalidade para simular e enviar a proposta


API: POST: http://localhost:8051/api/imb/v1/Sales/20_1912/modality_rules

API que gera e retorna o plano de financiamento da proposta de venda a partir de uma modalidade


API: DELETE: http://localhost:8051/api/imb/v1/sales/1_46/rules/1/components/1

 API para deletar apenas os componentes do gerador de parcela (entrada e principal), sendo que ao deletar esses componentes serão deletados os componentes dependentes como juros e cm se forem o caso.


API: GET: http://localhost:8051/api/imb/v1/Sales/1_46/modality_rules

API que retorna os componentes da modalidade que não estejam já inserido na regra da venda.


API: POST: http://localhost:8051/api/imb/v1/sales/1_46/rules

API para inserir um componente da modalidade na regra da venda

Code Block
rootModelo Json Solicitação Geração Comissão
titlePOST - Exemplo requisição
collapsetrue
{
	"codgrupo": 2,
	"codcompn": 30,
	"dsccompn": "Anual",
	"qtdparc": 5,
	"valorparcela": 10000,
	"valortotal": 10000,
	"dataprimeirovencimento": "2022-06-20T00:00:00"
}


API: PUT ou PATCH: http://localhost:8051/api/imb/v1/sales/1_46/rules/1/components/1

API para editar componente da regra da venda. somente permite a edição de um campo por vez, exceto a data de vencimento que pode editar com outros campos. Isso, porque um campo interfere em outro cálculo.

Code Block
rootModelo Json Solicitação Geração Comissão
titlePOST - Exemplo requisição
collapsetrue
{
	"qtdparc": 10,
	"valorparcela": 6000,
	"valortotal": 0,
	"dataprimeirovencimento": "2019-07-26T00:00:00"
}
Expand
titleCampos Editáveis
  • 1º Vencimento; permite editar sempre
  • Nro de Parcelas; permite editar sempre
  • Valor Parcela; somente pode editar se não for price, sac e sacre
  • Valor Total. permite editar sempre


API: GET: http://localhost:8051/api/imb/v1/sales/20_1/plans

API que retornar o plano de financiamento com as parcelas geradas a partir das regras cadastradas na proposta

Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
[
    {
        "codcoligada": 1,
        "numvenda": 4,
        "codgrupo": 1,
        "codtipoparc": 1,
        "dsctipoparc": "Sinal",
        "numparc": 1,
        "codcompn": 1,
        "dsccompn": "Sinal",
        "datavencimento": "2002-01-10T00:00:00",
        "valorparcela": 20000.0,
        "valororiginal": 20000.0,
        "valorjuros": 0.0,
        "valorcm": 0.0,
        "valoroutros": 0.0
    }
]




Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
[
    {
        "codcoligada": 20,
        "numvenda": 1914,
        "codgrupo": 1,
        "codcompn": 1,
        "dsccompn": "Entrada - Teste",
        "qtdparc": 8,
        "valorparcela": 5580.0,
        "valortotal": 44640.0,
        "dataprimeirovencimento": "2017-07-26T00:00:00",
        "codmodelocalculo": 0,
        "dscmodelocalculo": "Base",
        "percentualcomponente": 30.0,
        "valorcomissaocliente": 0.0
    },
    {
        "codcoligada": 20,
        "numvenda": 1914,
        "codgrupo": 1,
        "codcompn": 2,
        "dsccompn": "Mensal",
        "qtdparc": 160,
        "valorparcela": 1268.24,
        "valortotal": 104160.0,
        "dataprimeirovencimento": "2017-08-26T00:00:00",
        "codmodelocalculo": 2,
        "dscmodelocalculo": "PRICE",
        "percentualcomponente": 70.0,
        "valorcomissaocliente": 0.0
    }
]
Expand
titleParâmetros

Parâmetros:

  • codcoligada: coligada do empreendimento;
  • numvenda : Número da venda;
  • codgrupo: código do grupo que pertence a modalidade;
  • codcompn: código do componente;
  • dsccompn: descrição do componente;
  • qtdparc: quantidade de parcela do plano
  • valorparcela: valor do componente;
  • valortotal: Valor total do Componente financiado
  • dataprimeirovencimento: data do primeiro vencimento
  • codmodelocalculo: código do modelo de financiamento;
  • dscmodelocalculo: descrição do modelo de financiamento;
  • percentualcomponente: percentual do componente sobre o valor da proposta;
  • valorcomissaocliente: Valor retido na comissão do pagamento pelo cliente;



API: GET: http://localhost:8051/api/imb/v1/Sales/20_1914/VPL

API que retornar o cálculo da VPL da proposta do cliente comparando com a proposta padrão 

Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "codcoligada": 20,
    "numvenda": 1914,
    "valortabelaprecopadrao": "R$ 148.800,00",
    "valortabelaprecoproposta": "R$ 148.800,00",
    "valorfinanciadoatulizadopadrao": "R$ 287.060,89",
    "valorfinanciadoatulizadoproposta": "R$ 287.060,89",
    "valorpadraovpl": "R$ 144.684,63",
    "valorpropostavpl": "R$ 144.684,63",
    "percentualtma": "0,948900%",
    "aprovada": false,
    "itensvpl": [
        {
            "nomeparametro": "Prazo de Financiamento",
            "valortabela": "160",
            "valorproposta": "160"
        },
        {
            "nomeparametro": "% Captação a Vista",
            "valortabela": "2,00%",
            "valorproposta": "2,00%"
        },
        {
            "nomeparametro": "% Captação até Entrega",
            "valortabela": "0,00%",
            "valorproposta": "0,00%"
        },
        {
            "nomeparametro": "% Captação até 1 mês Antes Entrega",
            "valortabela": "0,00%",
            "valorproposta": "0,00%"
        },
        {
            "nomeparametro": "% Captação até Metade da proposta em relação a Entrega da Subunidade",
            "valortabela": "0,00%",
            "valorproposta": "0,00%"
        },
        {
            "nomeparametro": "Valor m2",
            "valortabela": "R$ 195,17",
            "valorproposta": "R$ 195,17"
        },
        {
            "nomeparametro": "Valor m2 VPL",
            "valortabela": "R$ 98,37",
            "valorproposta": "R$ 98,37"
        },
        {
            "nomeparametro": "% Diferenca do VPL",
            "valortabela": "0,00%",
            "valorproposta": "0,00%"
        }
    ]
}
Expand
titleParâmetros

Parâmetros:

  • codcoligada: coligada do empreendimento;
  • numvenda : Número da venda;
  • valortabelaprecopadrao:  Valor da Tabela de Preço Padrão da modalidade padrão
  • valortabelaprecoproposta: Valor da Tabela de Preço Padrão da modalidade padrão
  • valorfinanciadoatulizadopadrao: Valor sumarizado dos componentes de Entrada e Principal da modalidade padrão
  • valorfinanciadoatulizadoproposta: Valor sumarizado dos componentes de Entrada e Principal da modalidade proposta
  • valorpadraovpl: Valor sumarizado das parcelas da modalidade padrão - Inclui todos os valores de todos os componentes
  • valorpropostavpl: Valor sumarizado das parcelas da modalidade proposta- Inclui todos os valores de todos os componentes
  • percentualtma: Percentual da TMA - Taxa mínima de atratividade. A TMA é basicamente uma taxa de desconto que representa o retorno mínimo que o investidor deseja obter.
  • aprovada:  O VPL foi aprovado, true ou false
  • itensvpl: 
    • nomeparametro: Prazo de Financiamento
    • valortabela: Nro de Meses do componente principal
    • valorproposta:  Nro de Meses do componente principal
    • nomeparametro: % Captação a Vista
    • valortabela: Percentual do componente de entrada
    • valorproposta:  Percentual do componente de entrada
    • nomeparametro: % Captação até Entrega
    • valortabela: Percentual do valor previsto para receber até a entrega
    • valorproposta:  Percentual do valor previsto para receber até a entrega
    • nomeparametro: % Captação até 1 mês Antes Entrega
    • valortabela: Percentual do valor previsto para receber até um mês antes da entrega
    • valorproposta:  Percentual do valor previsto para receber até um mês antes da entrega
    • nomeparametro: % Captação até Metade da proposta em relação a Entrega da Subunidade
    • valortabela: Percentual do valor previsto para receber até a metade do tempo que falta para entrega
    • valorproposta:  Percentual do valor previsto para receber até a metade do tempo que falta para entrega
    • nomeparametro: Valor m2
    • valortabela: Valor do m2 
    • valorproposta:  Valor do m2 
    • nomeparametro: Valor m2 VPL
    • valortabela: Valor do m2 com a VPL
    • valorproposta:  Valor do m2 com a VPL
    • nomeparametro: % Diferenca do VPL
    • valortabela: Percentual de diderença da VPL em reação ao padrão, nesse caso sempre será 0, pois é a coluna do padrão
    • valorproposta:  Percentual de diderença da VPL em reação ao padrão,  se for maior que 0, está abaixo da tabela padrão e se for maior que 0, está acima da padrão
Card
labelParâmetros

Apis de Parâmetros

API: GET: http://localhost:8051/api/imb/v1/parameters/getParameter?company=0&parameter=UTILIZACOMISSAOVERSAO2

API para verificar se a comissão 2.0 está ativada.

Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "company": 0,
    "name": "UTILIZACOMISSAOVERSAO2",
    "value": "1"
}
Expand
titleParâmetros

Dados recebidos:

  • company: Código da coliga. (0 para coligada global);
  • name: Nome do parâmetro para verificação;
  • value: Pode ser 1 ou 0. Se 1, está ativado e 0 está desativado.
Card
labelSegurança

Apis de Seguranças

API: GET: http://localhost:8051/api/imb/v1/securitys/813000033/companys/20/persons/111.222.333-50

API que retorna as permissões de uma tag de segurança por coligada e por CPF


API: GET:http://localhost:8051/api/imb/v1/securitys/813000033/companys/20/persons/111.222.333-50/tables/xcomissoes

API que retorna as permissões de uma tag de segurança por coligada, CPF e por restrições de campos de uma tabela


API: GET: http://localhost:8051/api/imb/v1/securitys/813000033/tags/0_1_3_2/companys/20/persons/111.222.333-50

API que retorna as permissões de uma tag de segurança e subtags (ExecuteId, InsertId, DeleteId, EditId), por coligada e por CPF


API: GET:http://localhost:8051/api/imb/v1/securitys/813000033/tags/0_1_3_2/companys/20/persons/111.222.333-50/tables/xcomissoes

API que retorna as permissões de uma tag de segurança e subtags (ExecuteId, InsertId, DeleteId, EditId), por coligada, CPF e por restrições de campos de uma tabela


API: GET: http://localhost:8051/api/imb/v1/securitys/813000033/tags/4/companys/20/persons/111.222.333-50

API que retorna as permissões de uma tag de segurança e subtag (TagId), por coligada e por CPF


API: GET:http://localhost:8051/api/imb/v1/securitys/813000033/tags/4/companys/20/persons/111.222.333-50/tables/xcomissoes

API que retorna as permissões de uma tag de segurança e subtags (TagId), por coligada, CPF e por restrições de campos de uma tabela


Code Block
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "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!"
        }
    ]
}
Expand
titleParâmetros

Dados recebidos:

  • codColigada: Código da coligada do usuário;

  • codUsuario: Código do usuário;

  • securityId:  Tag de segurança;

  • executeId: Tag de visualizar utilizada na verificação;

  • insertID: Tag de inserir utilizada na verificação;
  • deleteID: Tag de deletar utilizada na verificação;
  • editID: Tag de edição utilizada na verificação;
  • tagId: Qualquer tipo de tag que queira verificar;
  • allowEdit: Permite editar;
  • allowInsert: Permite inserir;

  • allowView: Permite visualizar;

  • allowDelete: Permite deletar;

  • allowTagId: Permite executar um tag que foi passada;
  • imbTableFieldRestrictionsSecurity: permissões dos campos da tabela definido no parâmetro






Card
labelFórmulas Comissão |

Fórmulas Comissão

Info
titleImportante!

Para acessar todas as funções de fórmula do TCGI: Gestão - Funções de Fórmulas - Contratos de Venda

TABCOMISSOESRetorna o valor de um campo da tabela de comissão. | Primeiro argumento nome do campo. Segundo argumento tipo do campo. Legenda: (V = Valor; I = Inteiro; S = Conjunto de Caracteres; D = Data e Hora)
CONTEXTOUsa como contexto a chave da tabela "XCOMISSOES".
SINTAXETABCOMISSOES('CampoReferencia','TipoDeRetorno')
TABCOMISSOESCOMPLRetorna o valor de um campo da tabela de campos complementares da comissão da venda. Primeiro argumento nome do campo. Segundo argumento tipo do campo. Legenda: (V = Valor; I = Inteiro; S = Conjunto de Caracteres; D = Data e Hora)
CONTEXTOUsa como contexto a chave da tabela "XCOMISSOES".
SINTAXETABCOMISSOESCOMPL('CampoReferencia','TipoDeRetorno')
TABCOMISSOESITEMRetorna o valor de um campo da tabela de item da comissao. Primeiro argumento nome do campo. Segundo argumento tipo do campo. Legenda: (V = Valor; I = Inteiro; S = Conjunto de Caracteres; D = Data e Hora)
CONTEXTOUsa como contexto a chave da tabela "XCOMISSOES".
SINTAXETABCOMISSOESITEM('CampoReferencia','TipoDeRetorno')
TABCOMISSOESITEMPARCELARetorna o valor de um campo da tabela de parcela do item da comissão. Primeiro argumento nome do campo. Segundo argumento tipo do campo. Legenda: (V = Valor; I = Inteiro; S = Conjunto de Caracteres; D = Data e Hora)
CONTEXTOUsa como contexto a chave da tabela "XCOMISSOES".
SINTAXETABCOMISSOESITEMPARCELA('CampoReferencia','TipoDeRetorno')
VALORTOTALCOMISSAO

Retorna o valor total da comissão (Soma os itens da comissão)

CONTEXTOUsa o contexto da "XCOMISSOES"
SINTAXEVALORTOTALCOMISSAO
VALORSALDOCOMISSAO

Retorna o valor do saldo da comissão (Soma os itens da comissão)

CONTEXTOUsa o contexto da "XCOMISSOES"
SINTAXEVALORSALDOCOMISSAO
PERCENTUALTOTALCOMISSAO

Retorna o valor total do percentual da comissão (Soma os itens da comissão)

CONTEXTOUsa o contexto da "XCOMISSOES"  
SINTAXEPERCENTUALTOTALCOMISSAO
QTDECOMISSIOANDOSCOMISSAO

Retorna a quantidade de comissionados da comissão (Soma os itens da comissão)

CONTEXTOUsa o contexto da "XCOMISSOES"  
SINTAXEQTDECOMISSIOANDOSCOMISSAO
PERCENTUALCOMISSIONADO

Retorna o percentual do comissionado (empresa + cliente) da comissão

CONTEXTOUsa o contexto da "XCOMISSOESITEM" COM JOIN "XCOMISSOES"    
SINTAXEPERCENTUALCOMISSIONADO
VALORCOMISSIONADO

Retorna o valor do comissionado (empresa + cliente) da comissão

CONTEXTOUsa o contexto da "XCOMISSOESITEM" COM JOIN "XCOMISSOES"    
SINTAXEVALORCOMISSIONADO



Info
titleExemplo Fórmula

Neste exemplo, a comissão tem um percentual máximo de 6%, podendo reduzir esse valor se o corretor der mais que 8% de desconto no valor do imóvel. 

Valor da tabela de Preço do Imóvel R$ 100.000,00 

Valor de Desconto R$ 10.000,00 

Percentual de desconto 10%

Desta forma irei reduzir a comissão em 2% = (10% - 8%) que será reduzido do corretor esse valor. A Comissão do corretor é 3% e ele receberá apenas 1%.


Info
titleVeja a fórmula do Percentual Máximo da Comissão

Baixe a fórmula aqui


Fórmula no correto e a ordem de cálculo dele é 5 para ser o último a calcular e os demais coloquei 1


Info
titleVeja a fórmula de cálculo de percentual de limite do corretor

Baixe a fórmula aqui





Card
labelProcesso de Integrar/Cancelar Parcelas de 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


Deck of Cards
idTipos de Integração
Card
idTOTVS Gestão de Estoque Compras e Faturamento
labelTOTVS Gestão de Estoque Compras e Faturamento e Gestão Financeira |

Regra de Comissão se encontra com a seguinte configuração:

  • Corretor Padrão  ( TOTVS GESTÃO FINANCEIRA )
  • Imobiliária ( TOTVS GESTÃO FINANCEIRA )
  • SDR ( TOTVS GESTÃO DE ESTOQUE COMPRAS E FATURAMENTO )

Modalidade da Comissão configurada nos Parâmetros de Integração com :

  • TOTVS Gestão de Estoque Compras e Faturamento
  • TOTVS Gestão Financeira

Comissão Gerada e Status dos itens ( Calculada )

Selecionar a Comissão e em seguida : Processo | Integrar as Parcelas da Comissão

Após processar ( Integrar as Parcelas da Comissão )

As parcelas passam a ficar com o Status de ( EM INTEGRAÇÃO ) , Lembrando que a parcela de CLIENTE não é integrada.


Após a execução do processo de Integração 


Gerada a Integração com TOTVS Gestão Financeira 

Gerada Integração com TOTVS Gestão de Estoque Compras e Faturamento.


Card
idTOTVS Folha de Pagamento
labelTOTVS Folha de Pagamento |

TOTVS Folha de Pagamento

O Portal de Imóveis hoje trabalha com o CPF do corretor (ou CNPJ da imobiliária). Essa informação é automaticamente associada ao fornecedor no RM. Para facilitar a integração e não obrigar uma configuração de chapa relacionada ao funcionário no portal, iremos trabalhar sempre com fornecedores na comissão do TCGI. Para facilitar a integração da comissão com a Folha de Pagamento, foi criado um processo para esse vínculo.

Funcionário cadastrado no TOTVS Folha de Pagamento

Vínculo pode ser como antes , no cadastro do Fornecedor em :

Integrações | Dados Complementares ( TCGI )

Ocupação Profissional

Em Tipo de Integração : Receberá a Comissão por :

Informar a Integração com o TOTVS Folha de Pagamento e em seguinda selecionar a Chapa do Funcionário.


Pelo Processo de Comissão:

Selecionar Comissão 2.0 e em seguida : Associar Chapa ao Fornecedor da Comissão

Associação já encontra o Funcionário com mesmo CPF e faz a associação com Fornecedor.

Chapa do funcionário associada ao Fornecedor.


Integrando Comissão Folha de Pagamento

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 sem o uso da ´formula de validação ou com o uso dela.
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

Regra de Modalidade cadastrada com Tipo de Integração ( Folha de Pagamento ) e Comissionado e sua Chapa informada.

Comissão gerada e Integrada.

Id da Folha de Pagamento na Parcela de Comissão

TOTVS Folha de Pagamento - Em grupo de eventos - Identificação ( Marcar : Lançar eventos da Integração com outros aplicativos ) Subsituir.

Integração com outros Aplicativos ( Marcar : TOTVS Incorporação - Comissão Mensal ).

Por fim : Clicar em ( Lançar ).

Envelope Gerado!

Card
idCancelar Integração das Parcelas
labelCancelar Integração das Parcelas |

Se quiser Cancelar a Integração das Parcelas , basta Selecionar a Comissão e em seguida : Processos | Cancelar Integrações das Parcelas da Comissão

Podendo cancelar todas parcelas ou apenas uma determinada Competência.

Card
idIntegrar Parcela via Fórmula
labelIntegrar Parcela via Fórmula |

Exemplo de Integrar Parcela via Fórmula

1 - Modelo de Cálculo da Comissão - Parametrizado para Utilizar Fórmula.

Neste Exemplo , modelo de Cálculo esta parametrizado para gerar ( 4 PARCELAS ) e utiliza Fórmula que valida para INTEGRAR apenas a Parcela 1 , parcela 2 , 3 e 4 não irão Integrar.

Se a Parcela for 1 ( Integrar ) se for diferente ( Não Integrar ).

Exemplo de Fórmula: 

Se TABCOMISSOESITEMPARCELA ('NUMPARC','I')=1 Entao   1 Senao   0 FimSe  


Cadastrada em seguida uma Regra da Comissão ( Neste exemplo comissão para Corretor da Proposta e utilizando a Modalidade de Cálculo parametrizada com a Fórmula.

Cadastrada Modalidade da Comissão com os dados:

  • Regras x Modalidades da Comissão
  • Parâmetros de Integração
  • Imóveis x Modalidades da Comissão

Gerando a Comissão 

Comissão Gerada com 4 Parcelas e calculada (Conforme parametrizado Modelo de Cálculo da comissão ).


Selecionar a Comissão e em seguida : Processos | Integrar as Parcelas da Comissão


Apenas Parcela 1 encontra-se Integrada , as parcelas 2 , 3 e 4 não se encontram Integradas.

Pois a Fórmula criada para esse exemplo , irá validar apenas a Parcela = 1


Card
labelProcesso gerar ou cancelar parcela atrelada a baixa |

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.

Card
labelNova visão de comissão no Portal de Imóveis |

Parametrizações de ambiente para a comissão 2.0

Panel
titleColor#FF9000
titlePrimeiro Passo - Configurações de CORS

O arquivo web.config dentro da instalação do Portal de Imóveis normalmente localizado em FrameHTML\web\app\Imb\PVI\api deve possuir as seguintes tags relacionadas as operações CORS dentro da tag custom headers. Abaixo um exemplo deste arquivo:

Code Block
languagephp
themeConfluence
<configuration>
<system.webServer>
    <rewrite>
        <rules>
          <rule name="ignore-ui" stopProcessing="true">
            <match url="^ui" />
            <action type="None" />
          </rule>
          <rule name="ignore-ui-json" stopProcessing="true">
            <match url="^pvi-openapi.json" />
            <action type="None" />
          </rule>
          <rule name="slim catch all" enabled="true">
              <match url=".*" />
              <action type="Rewrite" url="index.php" />
              <conditions>
                  <add input="{URL}" pattern="sync*" negate="true" />
              </conditions>
          </rule>
        </rules>
    </rewrite>
    <httpProtocol>
    <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="*" />
    </customHeaders>
  </httpProtocol>
</system.webServer>
</configuration>
Panel
titleColor#FF9000
titleSegundo Passo - Configurações da porta ApiPort 

A porta API deve ser definida para que a comunicação entre o host e o portal de imóveis aconteça de forma transparente. Abaixo os locais onde esta porta deve estar parametrizada:

Info

1) Arquivos .config do rm.host.exe e rm.host.service.exe

Para entender e configurar a tag de apiPort nos arquivos do host, siga o procedimento clicando neste link (clique aqui)

Info

2) Arquivo config.json dentro da pasta config em wwwroot:

Normalmente localizado em C:\TOTVS\CorporeRM\RM.Net\wwwroot\config.
O parâmetro apiServer deve estar configurado com a URL do Portal de Imóveis + porta da API. Abaixo um exemplo deste arquivo:

Code Block
languagephp
themeConfluence
{
	"apiServer": "http://127.0.0.1:8051",
	"apiKeyGoogleMaps": "AIzaSyDVv839l_pKP0DnZJEvkrKzUv675"
}

Onde http://127.0.0.1 é a URL do portal de Imóveis e 8051 é a porta da API (ApiPort)

Info

3) Dentro do Portal de Imóveis deveremos definir em /backend/parametros, aba TOTVSo parâmetro API REST TOTVS: URL

Esta é a mesma URL definida no arquivo .config da pasta wwwroot como exemplificado acima.

Panel
titleColor#FF9000
titleTerceiro Passo - Sincronização do Portal de Imóveis

Após as configurações acima, o ambiente do Portal de Imóveis deve ser sincronizado em  /backend/sincronizar, opção de Parâmetros.
Estando a sincronização realizada, o Portal de Imóveis estará pronto para gerar as comissões.

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.

Adicionar e Editar comissionados avulsos


Na comissão 2.0, o portal de imóveis permitirá a inclusão e edição de comissionados avulsos de acordo com os comissionados avulsos informados na respectiva modalidade de comissão....

Alterando um Item de Comissão

  • Permitir editar apenas os campos
    • percentual quem paga;
    • Nro de parcelas (liberar a edição se for empresa, cliente sempre bloqueado);
    • % comissão, permitir a edição se o tipo de valor for percentual
    • valor comissão , permitir a edição se o tipo de valor for valor;
    • Demais campos bloqueados;


  • Regras de edição da tela 
    • Quem Paga comissão (Está bloqueado a alteração pois a definição do híbrido está no percentual de quem paga)
    • % 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 a alteração)
      • 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; (Está bloqueado a alteração)
      • 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.

  • permitir editar/inserir apenas os campos
    • Regra do comissionado avulso;
    • Função; 
    • Nome do comissionado;
    • percentual quem paga;
    • Nro de parcelas (liberar a edição se for empresa, cliente sempre bloqueado);
    • % comissão, permitir a edição se o tipo de valor for percentual
    • valor comissão , permitir a edição se o tipo de valor for valor;
    • Demais campos bloqueados;


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.

Card
labelDesconto da comissão na venda |

Comissionado tipo cliente

Sumarizar os valores dos comissionados do tipo quem paga cliente de uma venda e descontar esse valor do valor da venda, do item da venda e ratear o desconto nas regras geradoras do plano de financiamento (Tipo entrada, principal e etc.)
O valor da comissão do cliente será descontado na geração do plano de financiamento da venda, ou seja, antes de gerar o plano você deve cadastrar a comissão e depois gerar o plano, nessa momento será feito todo o cálculo de desconto da comissão na venda. Não será permitido editar a comissão que tenha descontado a comissão no plano de financiamento, desde que tenha a comissão paga pelo cliente. Se não existir esse tipo de comissão, então será permitido editar a comissão em qualquer momento, pois quem paga a comissão é a empresa, e isso não afeta o valor da venda.
Ao excluir o financiamento é desfeito o desconto da comissão nas regras, no item da venda e no valor da venda. Esse ponto de descontar e desfazer é o melhor ponto, pois cerca qualquer vulnerabilidade do sistema em questão de sincronismo de quando descontar ou não.  

Não será permitido ter tipos de cálculos de cliente diferente na comissão, ou seja, todos os comissionados tem que ser desconto decrescente, proporcional ou parcelas iguais.

Não será permitido editar o tipo de calculo do cliente e quais componentes serão descontado na tela do PVI, esse tipo de cálculo deverá ser cadastrado previamente e respeitado a regra da empresa, sem interferência do corretor.

Formas de cálculo de desconto da comissão paga pelo cliente com o seguinte exemplo:

  • Tenho no plano dois componentes: 
    • Entrada: Valor : R$5.000,00 em 5X = R$1000,00 por parcela; - Prioridade 1 (modelo de cálculo)
    • Mensal Valor: R$ 100.000,00 em 50X = R$2.000,00 por parcela;  - Prioridade 2
    • Valor Comissão pagamento cliente: R$8.000,00
  1. Decrescente: Determina a prioridade dos componentes geradores de parcelas para realizar o pagamento da comissão;
    • O sistema terá que  descontar R$8.000,00, sendo:
      • 5000 da entrada, ou seja, não terá entrada no plano
      • 3000 do mensal, pois usei a prioridade definida no castrado do modelo de cálculo
  2. Parcelas Iguais: Determina que valor da comissão será descontado na forma proporcional de cada componente sobre o valor total;
    • O sistema terá que  descontar R$8.000,00, sendo que o total de parcelas é 50 + 5 = 55:
      • entrada são 5 parcelas: 5 /55 *   R$8.000,00 = R$727,28
      • mensal  são 50 parcelas: 50 /55 *   R$8.000,00 = R$7272,72
  3. Proporcional: Determina que valor da comissão será descontado na forma proporcional de cada componente sobre o valor total
    • O sistema terá que  descontar R$8.000,00, sendo que o total  do plano é 5.000+100.000 = 105.000:
      • entrada com valor de 5.000:  5000/105.000 *   R$8.000,00 = R$400,00
      • mensal  com valor de 100.000 parcelas: 100000/105.000 *  R$8.000,00 = R$7.600,00