Histórico da Página

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;

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

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

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

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

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 }

• % 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

{   
    "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"    
}

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

[
    {
        "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
    }
]

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

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"
  }
}

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

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"
}

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

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 

[
    {
        "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
    }
]