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
...
id | Processos do PVI. |
---|
...
label | Pré-Venda | |
---|
O menu Pré-Venda possui informações importantes que podem ser utilizadas antes de realizar a proposta.
...
id | Pré-Venda |
---|
...
label | Brinde 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.
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. Nesta opção você deverá associar o brinde da proposta ao empreendimento desejado, basta clicar no botão Adicionar. Então será exibido a tela de cadastro do brinde, no campo empreendimento deverá ser informado o empreendimento no qual o brinde será associado 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. Marcando o checkbox Participa, você estará habilitando essa opção para ser visível no documento de impressão. Card | | |
|
Informações | ||
---|---|---|
| ||
O PVI lê as modalidades do TCGI, as modalidades podem ser RESTRINGE NO PVI ou NÃO RESTRINGE NO PVI. Comportamento de cada tipo: 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 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. Exemplo: Proposta cuja modalidade = NÂO restringe e saparar componentes por grupo ( NÃO ).
Ao enviar a venda o PVI agrupará os componentes. Grupo 1
Grupo 2
|
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 | ||
---|---|---|
| ||
Para avançar a Etapa da Proposta : Selecionar a Proposta e em Seguida o Botão da imagem acima. Selecionar opção : Avançar Etapa da Proposta Selecionar a etapa que a proposta será avançada e em Seguida ( Salvar ). Proposta passando para Status : CONTRATO ASSINADO 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. |
label | Enviar contrato para o RM | |
---|
Contrato assinado - Agora voltar a clicar no botão ao lado da Proposta e : Enviar Contrato para o Backoffice.
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>
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:
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.