Parametrizações de ambiente para a comissão com novas funcionalidades do TCGI


Clique aqui e veja como parametrizar o Perfil de Acesso para manipular a Comissão do PI


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:

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


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:


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)


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:

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


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

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


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 ou Propostas / Comissão.

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

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

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:

Campos da tela de comissão:


Adicionar e Editar comissionados avulsos

Na comissão com novas funcionalidades, 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.


Para realizar esta ação acesse a tela de Proposta, selecione uma Proposta Em Preparação e acesse o menu de Comissão:


Na tela de Dados de Comissão da Proposta, utilize os botões para Adicionar Comissionado ou acione o botão "..." de um comissionado já existente, para ter acesso às opções de Visualizar, Editar ou Excluir, conforme as permissões aplicadas no Perfil do TCGI, para este Usuário;



O botão para Adicionar Comissionado somente será habilitado na interface de Comissões da Proposta do PI, se a Modalidade de Comissão tiver uma Regra de Comissão com o Tipo Pessoa Quem Recebe configurado para Comissionado Avulso Portal de Imóveis.


Alterando um Item de Comissão


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.


Segurança dos campos da edição da comissão com novas funcionalidades

Para usar esse recurso, os usuários, como por exemplo o corretor, deverão ter seu cadastro sincronizado com o backoffice. Pois a segurança de edição/inserção/deleção dos registros da comissão e de seus campos serão feitos no perfil de segurança de Globais. 



O CPF desse Usuário de Acesso (FCFO.CODUSUARIOACESSO) deve ser igual, no cadastro de Usuários (USUARIO.CPFCNPJ) do Portal de Imóveis (PI) e no cadastro de Clientes/Fornecedor (FCFO.CGCCFO) do RM.

Com o uso da nova Comissão, a ferramenta de Manutenção de Usuários permite que os usuários de acesso ao RM para os Corretores do Portal de Imóveis sejam criados automaticamente com base em um perfil de acesso predefinido.



Os corretores poderão ter um perfil que não permita editar a comissão, já os supervisores poderão ter um perfil que permita a edição. Nessa controle será possível tirar a permissão dos corretores de editar o número de parcelas a serem pagas ou até mesmo o valor.  Através da aba acesso a campos, procurando a tabela XCOMISSCOESITEM, retirando a permissão de alterar esses campos ou até mesmo de visualizar.  


Comportamento do Portal de Imóveis ao salvar proposta na comissão com novas funcionalidades

O Portal de Imóveis, quando utilizar a comissão com novas funcionalidades, 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 a utilização da comissão com novas funcionalidades, 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.