Histórico da Página
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 |
|---|
...
| id | PVI - Manual do Usuário |
|---|
...
| label | PVI em Geral |
|---|
...
| id | PVI - Manuel do Usuário |
|---|
...
| label | Frontend |
|---|
Processos PVI - Frontend
...
.
...
| label | Simular reserva - Tabela de Preço RM / PVI | |
|---|
Cadastro de Empreendimento no RM - visualizado no PVI
Cadastado Empreendimento dentro do RM e após Sincronizmo , visualizado no PVI como mostra a imagem acima em : Empreendimentos
Mapa de Disponibilidade
...
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.
| Informações | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Cadastro de Blocos no PVi - Mostra os Blocos cadastrados no RM com sua quantidade
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 :
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.
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.
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 .  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.
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 )
Primeiro buscar em Empreendimento = Neste exemplo 0% e ai irá buscar no cadastro de usuário a % de comissão que será pago .
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.
Após conferência , validar valores - Validar.
Por fim , Salvar Proposta.
Comissão - Para que serve esse campo na Proposta ao editar ?
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 )
Para imprimir a Proposta : Basta clicar no Botão da Imagem .
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.
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.
Card | | ||||||||||
|
| Informações | ||
|---|---|---|
| ||
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. |
É 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.
Clicar em Iniciar o processo de 7 etapas.
.
Contrato enviado para o RM.
Sistema passa por 7 passos.
Contrato enviado para o RM.
PVI lhe dá opção de Excluir a Proposta depois que encontra-se Assinada.
| label | Comissão paga pelo Cliente | |
|---|
Uma nova Proposta feita com Cliente pagando a Comissão.
Imprimir Proposta para verficar o valor antes de enviar para TCGI.
Mostra a Comissão sendo paga pelo Cliente neste momento.
Enviar para o TCGI o contrato para verificar o valor.
Id da Venda = 978
Venda enviada para o RM.
Venda chegou no TCGI com valor de 92 Mil Reais.
| Card | ||
|---|---|---|
| ||
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.
Dados importantes para cadastro de Usuario no PVI :
Verificar se usuario tem permissão no TCGI.
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.
Efetuar uma nova reserva
Na proposta o Corretor tem que estar preenchido com o Usuário PVI vinculado ao usuário RM.
Quem paga Comissão : Empresa Por fim , validar proposta e Salvar em seguida. Enviando Contrato para o TCGI>>>>>
Contrato : 980 envaido para o TCGI.
Contrato enviado para TCGI. Localizar contrato 980 em seguida : Anexos | Vendedores
Vendedor incluído no contrato de Venda/Aluguel
Valor total no contrato , diferente do contrato que comissão é paga pelo cliente que já vem descontando os 8%.
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 ).
Processo executado.
Movimento gerado para TOTVS Getão de Estoque, compras e Faturamento. |
| label | Comissão paga por AMBOS | |
|---|
Comissão paga por Ambos ( Empresa e Cliente ) Dividem o valor de Comissão conforme parametrização.
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 ).
Proposta no PVI = Valor de 100.000 Reais
E neste exemplo a comissão esta marcada como ( AMBOS ) e 50% para Cliente e Empresa .
Proposta criada.
Visão de Comissão no PVI.
PVI mostrando o valor que Cliente e Empresa irão pagar para Gerente e Corretor.
Proposta impressa ( valores ).
Contrato assinado - Enviar para TCGI.
Proposta enviada para o RM ( Venda = 986 ).
Contrato enviado para o TCGI
Vendedor - Corretor incluído no Contrato de Venda do TCGI para inserir a Comissão.
| Card | ||
|---|---|---|
| ||
Tela de Empreendimento do Frontend ,pega toda configuração do Empreendimento no BacKend , Informações cadastradas, efetuar a simulão de proposta. |
| label | Corretores | |
|---|
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.
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.
| 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.
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>
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:
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas