Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

O PVI ou Portal de Vendas de Imóveis é Imóveis é um software desenvolvido com o propósito de auxiliar as equipes de vendas das construtoras e imobiliárias no processo de gestão de vendas. 
Ao desenvolver o PVIPortal de Imóveis, a principal finalidade foi dar visibilidade, transparência e controle durante todo o ciclo da venda, sempre integrando as informações do RM.

Exibir filhos

...

idPVI - Manual do Usuário

...

labelPVI em Geral

...

idPVI - Manuel do Usuário

...

labelFrontend

Processos PVI - Frontend

...

idProcessos do PVI.

...

labelPré-Venda |

O menu Pré-Venda possui informações importantes que podem ser utilizadas antes de realizar a proposta.

...

idPré-Venda

...

labelBrinde na compra |

...

.

Para aprender e entender mais acerca do Portal de Imóveis, comece pelo link abaixo que irá guiá-lo por todos os processos e rotinas da ferramenta.

Cadastro de Empreendimento no RM - visualizado no PVI

Image Removed

Cadastado Empreendimento dentro do RM e após Sincronizmo , visualizado no PVI como mostra a imagem acima em : Empreendimentos

Image Removed

Mapa de Disponibilidade 

Image Removed,

Cadastro de Blocos no PVi - Mostra os Blocos cadastrados no RM com sua quantidade

Image Removed

Para efetuar a reserva ou simular, basta selecinar a Unidade e marcar a opção desejada. ( Neste Exemplo : Simular ).

Ao selecionar uma Unidade, o PVI mostra as Tabelas de Preços vinculada ao Empreendimento.

Cadastro das tabelas de preços no RM e o vínculo ao Empreendimento , como são feitos :

Image Removed

No RM , o cadastro de tabela de Preço vinculada ao Empreendimnto PVI , Mostra 3 Ativas e 2 Canceladas, As cancelas não são visualizadas no PVI , sendo informado no PVI as efetivadas.

Image Removed

Descrição da Tabela de Preço que é visualizada no PVI e dentro da Tabela de Preço , vinculada a Modalidade que será utilizada para o Plano de Financiamento.

Image Removed

Ao Seguir o Processo de Simular ( Print Acima )  - Mostra na tela do PVI os Componentes que estão cadastrados dentro da Tabela de Preço do RM .

Image Removed

Uma unidade só pode ter uma proposta , campo Imobiliária será preenchido automaticamente ao inserir o Corretor que está vinculao a ela , mas esse campo Imobiliária não é necessário preenchimento.

Corretor não é associado a nenhuma imobiliária e faz uma venda , e esta venda foi especifica para uma Imobiliária , ai neste camo de Imobiliária é informada a mesma e a comissão é paga para Imobiliária que fica responsável por repassar ao Corretor sua comissão. 

No cadastro da Pessoa, pode buscar um já existente informando o CPF ou pode cadastrar um novo nesta tela de proposta.

Image Removed

Relembrando sobre Comissão que já foi faldo no Help de Backend.

Ai define quem vai pagar a comissão , se será o cliente ou empresa , isso será fundamental na hora de enviar para o TCGI o valor da Proposta e essa % de Comissão é realizada pelas 4 Etapas na configuração de Comissão. ( Relembrar ) 

Image Removed

Primeiro buscar em Empreendimento = Neste exemplo 0% e ai irá buscar no cadastro de usuário a % de comissão que será pago .

Image Removed

Segunda busca no Cadstro de Usuarios - Como estou com Mestre , achou 8% e a busca para neste momento , PVI não faz a busca mais em Imobiliária e Grupo de usuários.

Informações
 

Para adicionar algum brinde na compra a uma determinada proposta basta acessar o menu Pré-Venda>>Brinde de compra, ou então

basta que as proposta tenham brindes cadastrados, que na simulação da proposta serão listados os brindes cadastrados.

Image Removed

Nesta opção você deverá associar o brinde da proposta ao empreendimento desejado, basta clicar no botão Adicionar.

Image Removed

Então será exibido a tela de cadastro do brinde, no campo empreendimento deverá ser informado o empreendimento no qual o brinde será associado

Image Removed

Logo após salvar o brinde ao empreendimento associado, em simular a proposta, na parte inferior da tela será exibido o o brinde que foi adicionado

aquele imóvel.

Image Removed

Marcando o checkbox Participa, você estará habilitando essa opção para ser visível no documento de impressão.

Card
labelSimular reserva - Tabela de Preço RM / PVI |
Informações
titleObservação sobre Restringe e Não Restringe Modalidade no PVI !!

Image Removed

 O PVI lê as modalidades do TCGI,  as modalidades podem ser RESTRINGE NO PVI ou NÃO RESTRINGE NO PVI. Comportamento de cada tipo:
- NÃO RESTRINGE - Modalidade pode receber qualquer componente mesmo que não esteja cadastrado na modalidade originalmente.
Ex: modalidade no RM
- Sinal
- Mensal
- Financiamento

NO PVI foi definido uma proposta com os componentes Sinal, Mensal, Anual, semestral e financiamento. Desta forma a modalidade NÂO RESTRINGE aceita esta proposta com novos componentes que não estavam orignalmente na modalidade.

- RESTRINGE NO PVI - Neste caso o PVI apresentará a modalidade exatamente como ela está definida no RM e não permitirá acrescentar novos componentes, somente eliminar.

Processo de integração da venda seguem duas situações
MODELO DE MODALIDADE - se a modalidade for RESTRINGE NO PVI, a volta da venda será de acordo com a modalidade, ou seja, no mesmos grupos e somente os mesmos componentes da modalidade.

Se o modelo da modalidade for NÃO RESTRINGE NO PVI, ao enviar a venda para o RM o PVI irá consultar o parâmetro em backend > parametros > TOTVS, Separar componente em grupos, se este parâmetro for SIM, a venda será criada com cada componente da venda em um grupo distinto e em cada grupo serão copiados todos os componentes de reajuste.
Se o parâmetro acima for NÂO, ao enviar a venda o PVI colocará todos os componentes no mesmo grupo e somente abrirá um novo grupo caso na proposta existam mais de um componente do mesmo tipo.

Image Removed

Exemplo:

Proposta cuja modalidade = NÂO restringe e saparar componentes por grupo ( NÃO ).

  • Sinal
  • Mensal
  • Mensal
  • Anual
  • Financiamento

Ao enviar a venda o PVI agrupará os componentes.

Grupo 1

  • Sinal
  • Mensal
  • Anual
  • Financiamento

Grupo 2

  • Mensal

Image Removed

Após conferência , validar valores - Validar.

Image Removed

Por fim , Salvar Proposta.

Image Removed

Image Removed

Comissão - Para que serve esse campo na Proposta ao editar ?

Image Removed

Uma venda existe uma parceria com outro corretor que ficou combinado o pagamento de uma parte da comissão , A comissão fechada é em 8% pelo contrato , neste caso , pode incluir um novo corretor e informar a % de comissão para pagamento , mas o total delas não pode ultrapassar os 8% , se incluir 1% para o novo corretor , tem que tirar 1% dos 8 acima .. Ficando 7% e 1 % totalizando os 8%.

Em Propostas : A proposta criada , fica na tela do PVI ( Status = Aprovada )

Image Removed

Para imprimir a Proposta : Basta clicar no Botão da Imagem .

Image Removed

Image Removed

Enviar proposta por E-mail , tem Tags que podem ser incluidas no corpo do e-mail ao enviar a Proposta.

Documentos da Pessoa : Conforme parametrização do cadastro da Pessoa , se tiver algum documento obrigatório , vai ser informado e ai o usuário pode ou não aprovar o documento.

Image Removed

Tabela de Preço: Ao utiliza financiamento padrão e o componente gerador de parcela calcula por fórmula será apresentado um botão 'Calcular', possibilitando a atualização do valor da parcela de acordo com a fórmula utilizada. Caso seja utilizado outro modelo de financiamento o valor da parcela será apresentando considerando o Valor Unidade / Quantidade de parcelas.

Image Removed

Card
labelAvançar Etapa - Assinar Proposta |

Image Removed

Para avançar a Etapa da Proposta : Selecionar a Proposta e em Seguida o Botão da imagem acima.

Image Removed

Selecionar opção : Avançar Etapa da Proposta

Image Removed

Selecionar a etapa que a proposta será avançada e em Seguida ( Salvar ).

Image Removed

Proposta passando para Status : CONTRATO ASSINADO

Image Removed

E o status de Contrato Assinado no PVI - Permite enviar venda para o BackOffice e esta vinculado ao Contrato Assinado do TCGI conforme já informado nos cadastros do Backend.

Card
labelEnviar contrato para o RM |

Image Removed

Contrato assinado - Agora voltar a clicar no botão ao lado da Proposta e : Enviar Contrato para o Backoffice.

Informações
titleImportante:

Para envio da venda, faz-se necessário que no TGGI o parâmetro de venda sequencial esteja habilitado. Em instalações em que o parâmetro de venda sequencial não estiver habilitado fica sujeito a erro de chave duplicada ao enviar a venda.

Image Removed

É carregado os dados da Proposta.

Para que a venda tenha lançamentos financeiros a receber gerados, a Classificação da entidade Cliente/Fornecedor deve ser Cliente ou Ambos. Portanto o PVI ao enviar uma venda para o RM, de um prospect cadastrado como fornecedor, irá alterar a Classificação do cadastro Cliente/Fornecedor do backoffice para "Ambos", quando localizado pelo CPF/CNPJ.

Image Removed

Clicar em Iniciar o processo de 7 etapas.

Image Removed.

Image Removed

Image Removed

Contrato enviado para o RM.

Sistema passa por 7 passos.

Image Removed

Contrato enviado para o RM.

Image Removed

PVI lhe dá opção de Excluir a Proposta depois que encontra-se Assinada.

Card
labelComissão paga pelo Cliente |

Image Removed

Uma nova Proposta feita com Cliente pagando a Comissão.

Image Removed

Imprimir Proposta para verficar o valor antes de enviar para TCGI.

Image Removed

Mostra a Comissão sendo paga pelo Cliente neste momento.

Enviar para o TCGI o contrato para verificar o valor.

Image Removed

Id da Venda = 978

Image Removed

Venda enviada para o RM.

Image Removed

Venda chegou no TCGI com valor de 92 Mil Reais.

Card
labelComissão paga pela Empresa ( Vendedor no Contrato de venda do TCGI ) |

Image Removed

Primeiro passo para se realizar uma proposta com comissão paga pela empresa e que possa sair vendedor no contrato de Venda / Aluguel no TCGI - Verificar cadastro de Cliente/Fornecedor no RM.

Observar o CPF do cadastro.

Em Dados Adicionais : Verificar usuario vinculado e e-mail do Usuário.

Image Removed

Dados importantes para cadastro de Usuario no PVI :

  • CPF 
  • E-mail

Verificar se usuario tem permissão no TCGI.

Image Removed

Feita as validações , verificar cadastro de usuário no PVI em : BACKEND | Usuários 

Cadastro deve possuir o mesmo CPF e mesmo E-mail do cadastro feito no RM.

Image Removed

Efetuar uma nova reserva

Image Removed

Na proposta o Corretor tem que estar preenchido com o Usuário PVI vinculado ao usuário RM.

Image Removed

Quem paga Comissão : Empresa 

Por fim , validar proposta e Salvar em seguida.

Enviando Contrato para o TCGI>>>>>

Image Removed

Contrato : 980 envaido para o TCGI.

Image Removed

Contrato enviado para TCGI.

Localizar contrato 980 em seguida : Anexos | Vendedores

Image Removed

Vendedor incluído no contrato de Venda/Aluguel

Image Removed

Valor total no contrato , diferente do contrato que comissão é paga pelo cliente que já vem descontando os 8%.

Image Removed

No cadastro do Vendedor , incluir o valor da parcela e quantidade de parcela ( pagar a comissão ).

Campos Complementares - Informar o valor da Comissão.

Selecionar Processos | Gerar Comissão( ões ).

Image Removed

Processo executado.

Image Removed

Movimento gerado para TOTVS Getão de Estoque, compras e Faturamento.

Card
labelComissão paga por AMBOS |

Comissão paga por Ambos ( Empresa e Cliente ) Dividem o valor de Comissão conforme parametrização.

Image Removed

Parâmetros do Empreendimento = Informo se a comissão será paga pela Empresa , Cliente ou Ambos , mas esse parametro pode ser informado nos parametros do PVI em Propostas e o Percentual da Comissão ou na própria Proposta.

Sobre o Valor da % de comissão que será pago pela Empresa e Cliente , é cadastrado no Empreendimento e pode ser editado na própria proposta do PVI se o cadastro do usuario no PVI ( Grupo de usuários estiver parametrizado para que possa editar ).

Image Removed

Proposta no PVI = Valor de 100.000 Reais 

E neste exemplo a comissão esta marcada como ( AMBOS ) e 50% para Cliente e Empresa .

Image Removed

Proposta criada.

Image Removed

Visão de Comissão no PVI.

Image Removed

PVI mostrando o valor que Cliente e Empresa irão pagar para Gerente e Corretor.

Image Removed

Proposta impressa ( valores ).

Image Removed

Contrato assinado - Enviar para TCGI.

Image Removed

Proposta enviada para o RM ( Venda = 986 ).

Image Removed

Contrato enviado para o TCGI

Image Removed

Vendedor - Corretor incluído no Contrato de Venda do TCGI para inserir a Comissão.

Card
labelEmpreendimento |

Image Removed

Tela de Empreendimento do Frontend ,pega toda configuração do Empreendimento no BacKend , Informações cadastradas, efetuar a simulão de proposta.

Card
labelCorretores |

Importante!
Ao realizar uma proposta, o corretor poderá selecionar a imobiliária atual no campo Imobiliária, mas por padrão será auto selecionado a imobiliária definida no cadastro do usuário.
Esta informação será gravada no momento em que a proposta é feita. Desta forma o PVI consolida um histórico de imobiliárias que o corretor pertence ou pertencia no momento em que a proposta foi realizada.

Relatórios gerenciais

É importante notar que o campo imobiliaria_proposta (imobiliária_id) da tabela proposta será o responsável pelo armazenamento das informações a respeito deste histórico de imobiliárias. Abaixo, segue um exemplo de select onde extraímos esta informação diretamente do banco.

Image Removed

Usamos o comando COALESCE para buscar primeiro em proposta se houver valor para imobiliária, se existir, este será o valor a ser considerado, caso não exista aí buscamos a imobiliária vinculada ao usuário. Vale lembrar que isso é para manter compatibilidade com as propostas antigas, a partir da nova versão, se houver imobiliária ela sempre estará disponível na proposta.

Card
label| API

Acessar Documentação da API

Com a instalação do PVI é disponibilizado a documentação técnica das APIS utilizadas e as respectivas rotas consumidas pelo portal. Para acessar a documentação no Swagger é necessário adicionar o caminho a seguir 'api/ui/#/' no endereço do Portal em seu navegador.

Por exemplo: Considerando uma instalação local do PVI utilizando a porta 8000 para visualizar a documentação é necessário digitar o seguinte endereço no navegador.

Image Removed

               Servidor:Porta/api/ui/#/

Essa documentação é sempre atualizada considerando as novas APIS e as alterações nas existentes. 

Configuração da API - CORS

Para o consumo da API do portal de vendas diretamente por browsers(navegadores) ou client http de aplicativos front end como fetch API, jQuery, Axios, Angular Http, etc, será necessário que a instalação do portal envie na requisição de resposta alguns cabeçalhos específicos que para não infringir a política de CORS. Caso queira entender mais sobre CORS clique aqui

Os cabeçalhos necessários são:

  • Access-Control-Allow-Origin
  • Access-Control-Allow-Headers
  • Access-Control-Allow-Methods

Dado que o portal usa o IIS para servir a API, será necessário customizar este arquivo ./api/Web.config com estes parâmetros:

<httpProtocol>
   <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="X-Requested-With, Content-Type, Accept, Origin, Authorization" />
      <add name="Access-Control-Allow-Methods" value="GET, POST, PUT, DELETE, PATCH" />
      <add name="Access-Control-Max-Age" value="1000" />
   </customHeaders>
</httpProtocol>

Dando um visão geral, o arquivo /api/Web.config ficará semelhante a este:

Image Removed

Feito este procedimento, a API está preparada para ser consumida por aplicativos de fora do domínio do portal.Problemas de CORS em aplicativos Angular

Mesmo o servidor enviando os cabeçalhos que atendem os requisitos de CORS ainda a requisição está com problema? Se resposta for sim, pode ser configurado um cabeçalho na requisição com header Content-Type. Veja um exemplo de chamada com o cabeçalho:

Image Removed

Seria interessante manter o envio dos headers em um provider de http intercept, que para que toda chamada a API seja incluído o cabeçalho necessário, isso evita repetição de código e centralizada a configuração em um único ponto. O Angular possui este recurso e pode ser consultado por aqui.