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 ) é um software desenvolvido com o propósito de apoiar auxiliar as equipes de vendas das construtoras e imobiliárias no processo de
gestão de vendas. Foi desenvolvido pela empresa Protos Sistemas e Projetos, parceira da TOTVS, que agora adquiriu adiquiriu 100% o sistema PVI .
Ao desenvolver o PVI, a principal finalidade foi dar visibilidade, transparência e controle durante todo o ciclo da venda, sempre integrando as informações do Totvs Construção Gestão de Imóveis com o PVI.

Deck of Cards
idPVI - Manual do Usuário
Card
labelInstalação e Configuração |
Card
labelInstalação e Configuração |
Deck of Cards
idInstalação e Configuração
  • O que é?
  • Requisitos Técnicos
  • Instalação
  • Manual de Instalação
  • Homologação do Portal
  • Atualização do Portal
  • Manual de Operação
  • Perguntas Frequentes
  • Erros e Mensagens
  • Servidor de Atualização
  • Changelog
  • Dataserver de consumo de licenças

    Card
    labelInstalação

    Instalão do PVi 

    * Instalação de Extensão PHP Manager ( Aconselhavel criar um diretório PROTOS )

     

    Informações
    titleInformações Complementares
    Card
    labelConfiguração PVI


    Configuração para uso do PVI.

    Abrir o IIS do Windows


    Porta Padrão do PVI : 8000

    Configurações Básicas


    Em caminho físico: Selecionar onde foi Instalado o PVI e localizar a pasta Bin.

    Em Conectar como : Informar seu usuario e senha.


     

    No exemplo , o site foi criado com nome : PVI32TESTE

    Configurando Banco de Dados para utlização do PVI ..


    Selecionar o Site criado e em seguida : Explorar

    Entrar dentro da Pasta : API e localizar o Arquivo : config_db.php e Abrir o arquivo com Bloco de Notas ou Notepad ++

    Neste arquivo , informar o Servidor e base de dados do PVI.

    Entrando no PVI - Exemplo do Site criado ( Nomeclatura )

    Servidor - Porta - Nome do Site 

    Neste exemplo : http://localhost:8000/PVI32TESTE/#/login

    Configurar o PVI ao banco RM ( Totvs Construção Gestão de Imóveis )


    Canto direito superior do PVI - Clicar na e em seguida : Backend

    Parâmetros 

    Clicar em TOTVS | Em valor , informar o WebService RM , a base RM que será utilizada conforme parametrizada WS.

    Como  configurar WS : Clique Aqui !

    Card
    labelPVI em Geral
    Deck of Cards
    idPVI - Manuel do Usuário
    Card
    labelBackend |

    Sobre parâmetros do Backend

    No Backend são feitos os cadastros de Usuários , Empreendimentos - Comunicação com RM.

    Deck of Cards
    idBackend
    Card
    labelUsuário |

    Cadastro de Usuário:

    Campos importantes dentro do Cadastro de Usuário:

    • Grupo :  ( Qual grupo o usuário encontra-se associado ) Definir série de parâmetros para determinado usuário.
    • Imobiliaria : ( Infomativo para dizer que o Usuario esta em uma determinada imobiliária. )
    • Reservas  ( Reseva é para poder reservar uma unidade )
    • Comissão  
    • Superior : ( Pessoa é um corretor , faz venda e deu desconto 5% , ele não consegue mas ai o superior além de ver as vendas deste usuário pode dar o desconto. )

    Cadastro de Grupo é responsável por Permissões do Usuario vinculado ao mesmo.

    Cadastro de Imobiliária : Cadastro básico para informar a imobilária em relatórios e uma parte importante é o cadastro de Comissão.

    Card
    labelParâmetro de Comunicação com RM |

    Parâmetros

    Caminho onde é informado o WebService do RM com seu usuario e senha , sem isso a comunicação não é possivel ser realizada do Banco PVI com Banco RM.


    Código do Tipo de Componentes de Valor :  PVI não puxa do RM os componentes de correção ( Antes e após ) Por exemplo. Exceto em alguns casos que trabalha com Price e ai só vai informar parte das informações gravas no Paramtro do PVI. 


    Em sistemas : Nome da Empresa : Informar o Nome que será mostrado no PVI como mostra a imagem acima.

    Sistema | Campos obrigatórios : Campos que se tornam obrigatórios :

    Se definido como SIM, haverá validação dos campos obrigatórios customizados. A parametrização para mapear quais campos são obrigatórios pode ser definida em Backend > Sistema > Campos Obrigatórios.
    Se definido como NÃO será utilizado a validação padrão do sistema


    Card
    labelSincronização |

    Sincronização

    Sincronização : Tem um programa que faz isso a cada 30 minutos e esse processo vai no RM buscar todas informacoes do RM.

    Essa sincronização é algo não muito utilizado , a não ser que , cliente cadastrou uma nova unidade neste momento e não pode esperar meia hora para a sincronização , ai ele roda manualmente a sincronização.

    Card
    labelCadastros Globais |

    Cadastros Globais

    Principais cadastros Globais ( Envolvem integração com RM ) São :

    • Componentes de Venda
    • Situação da Unidade
    • Situação da Proposta


    Componentes de Venda

    Exemplo SINAL


    Como é feito o vínculo do Cadastro de Componente do PVI com o RM ?

    Pelo ID ERP do PVI , é informado o Código do Componente do TCGI, Neste exemplo  o componente SINAL do PVI é ínformado código 1 em ID do ERP que é 1 no TCGI.



    Configuração do Componente : 

    Ordem: deseja que o mesmo apareca.

    Periodiciedade : Smpre meses 

    Meses a adicinoar a data Iniclal: Quando se monta a composição de uma Proposta para sair as datas corretas , coloca-se o omponente com ordem 1 de sinal e coloca outro componente com ordem 2 mensal. Isso permite mostrar a data na simulação da Proposta.

    Percentual miníno e máximo : Sobre o valor da Unidade 

    Percentual máximo retido de comissão : Exemplo : Sinal é onde tem o desconto da Comissão. Existe uma venda de R$100.000,00 e uma comissão de R$10.000,00.

    Se neste campo estiver informado 50% por exemplo, os R$10.000,00 de comissão passam a ser de R$5.000,00 ( 50% sobre os R$10.000 )


    Contrato : 

    Existe algumas tags especificas para sair no contrato  de venda impresso.

    Existe um texto padrão do PVi . mas o usuário pode alterar o texto padrão acrescentando as tags disponíveis ; ( Contrato Singular ou Plural )

    Por que Singular ou Plural ?

    Se for uma parcela por exemplo : Usar Singular ou se for mais de uma Parcela , usar o Plural.


    Situação da Unidade:

    Uma outra forma de se contrar situação de UNIDADE no PVI.

    Situação de unidade do PVI é ligada com a situação da Unidade no TCGI

    Título : Como fica o título da situação no PVI

    Atualiza situação no Backoffice :  A unidade esta disponível , o usuario foi e marcou em Proposta , o PVI precisa ir no TOCGI e mudar a situação desta unidade , e isso é via WebService.

    Como é feito o vínculo da situção da Unidade do PVI com TCGI.


    Situação da Proposta:

    Situação da Proposta existe um vínculo com a situação da Unidade.

    Título da Situação da Proposta 

    Alterar situação da unidade para: Muda a situação da unidade conforme paremetrizado anteriormente em ( Situação da Unidade ).

    Um exemplo da situação de Proposta : Situação de Proposta foi cancelada - Neste momento , a situação da Unidade ficaria ( Disponível ) passando a deixar a unidade disponível para o mercado.

    Esse parametro serve para a proposta ficar visível na página de proposta e página de contrato do PVI.

    Card
    labelComissão |

    Mais | Visão de Comissão

    Cadastro de Comissão no PVI é feito nestes 4 pontos acima , essas são as ordens em sequência que o PVI verifica a % de comissão . Se achar em Empreendimento % , para a busca imediatamente , mas caso exista apenas % em Imobiliária , a busca será realizada em Empreendimento primeiro , segundo irá passar por Usuários  até chegar em Imobiliária.

    Onde o PVI achar % ( valor primeiro ) será utilizada a comissão.

    Card
    labelEmpreendimento |

    Cadastro de Empreendimento no PVI é importado pelo TCGI no processo de Sincronização.

    ,

    Pode-se tiver os empreendimentos pelo PVI até o limite de Licença permitida , neste exemplo , o limite é de 5 Empreendimentos Ativo.

    Esses 3 cadastros acima pertencem aos Cadastros Globais

     T

    TMA : Taxa de Desconto - Cadastro Global 

    Uma taxa de desconto , Exemplo da Utilização do TMA : A unidade custa R$100.000,00 , para entregar em 2025 ( Estamos em 2021 )  consegue trazer este valor para o presente com uma taxa de desconto  seja por fórmula de matemática financeira, e é mostrado ao usuário um exemplo que se pode vender determinada unidade até X com desconto que vai mostrar se pode ou não ser viável.

    Percentual VPL :  Neste exemplo está marcado com 100% , se a unidade custa 100 Mil Reais , não pode ser vendida por menos que este valor , caso esteja marcado 90% , a unidade pode ser vendida por 90.000 Reais.


    Percentual de Comissão : Conforme explicado sobre % de Comissão ( Busca % por ordem de prioridade de Comissão ).

    Comissão Adicional :

    Esses parametros são utilizados na hora da Proposta , se comissão será pago pelo cliente ou Empresa por exemplo.

    Visão da vaga de garagem: Se quer mostrar ou não.

    URL para video de Youtube : Para informação do Empreendimento , mostra imagem , planta e videos. ( Fica em Informação do Empreendimento ).

    Ordem de disposição do mapa de disponibilidade: Imagem , planta do loteamento ( Ordem que deseja ser visto primeiro, Tabela de preço ou Mapa de Disponibilidade ).

    Gerente :  Definido um gerente e seu %, quando tiver uma venda , o gerente vai ganhar também este valor de comissão da venda que tiver definido no parâmetro.

    Este parametro marcado , cliente tem um SInal em Janeiro de 2021 e a primeira parcela Mensal será em Julho de 2021, com este parametro marcado , cliente será notificado todo mês até chegar Julho , mas só informativo , pois ele será informado mensalmente.

    Unidades: Unidaes do Empreendimento

    Imagens : Imagens que podem ser colocadas para serem visualizadas no PVI.

    Minutas: É um contrato impresso ,PVI existe um exemplo de documento para baixar como mostra a figura acima.

    Pode se adicionar Tags  , edtiar a Minuta , que as Tags serão substituidas por valores e assim a minuta será apresentada. 

    Documentos da Proposta : Cadastrao em Globais | Documento da Proposta

    Pode-se criar documento de proposta e este mesmo estando criado , vai mostrar no cadastro do Empreendimento , marcado o documento , será visualizado na Proposta com a regra criada no Documento.

    Card
    labelLogs |

    Pode ser visualizado Logs de : Propostas - Reservas e Unidades 


    Exemplo de Log de Proposta 

    Card
    labelDataserver ImbSatusLicensasTodosAppsData |

    PVI - Backend - Dataserver ImbStatusLicencasTodosAppsData

    A partir da versão 12.1.29, o Dataserver ImbStatusLicencasTodosAppsData passou a ficar disponível para ser executado utilizando uma ferramenta de terceiros, como o Soapui. Sua função é a de retornar dados atuais das licenças dos sistemas PVI e PDC, identificando possíveis problemas de consumo.

    Segue o exemplo do Dataserver que pode ser utilizado dentro do SoapUI ou outra ferramenta que possibilite a execução de webservices:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
    <soapenv:Header/>
    <soapenv:Body>
    <tot:ReadView>
    <tot:DataServerName>ImbStatusLicencasTodosAppsData</tot:DataServerName>
    <tot:Filtro>1=1</tot:Filtro>
    <tot:Contexto>CODCOLIGADA=1;CODSISTEMA=X;CODUSUARIO=mestre</tot:Contexto>
    </tot:ReadView>
    </soapenv:Body>
    </soapenv:Envelope>

    Card
    labelImagem em Empreendimento |

    Inserindo Imagem no cadastro de Empreendimento - Backend e visualizando no Frontend ao simular proposta.

    Backend | Empreendimentos

    Selecionar o Empreendimento - Em seguida ( Editar ).

    Clicar em : Imagens Disponibilidade.

    Obs: Lembrar que a resolução recomendada é de 1.250 Pixeis - Horizontal.

    Clicar em : Adicionar Imagem e em seguida : Nova Imagem.

    Salvar Imagem no Empreendimento.

    Pode ser feito o posicionamento das Unidades na Imagem.

    Basta selecionar a Unidade e arrastar até o local desejado.

    Ao entrar em Frontend e em seguida em Empreendimentos , a imagem fica visível e com as unidades posicionadas.

    Card
    labelFrontend

    Processos PVI - Frontend

    Deck of Cards
    idProcessos do PVI.
    Card
    labelSimular 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 

    ,

    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.

    Informações
    titleObservação sobre Restringe e Não Restringe Modalidade no PVI !!

     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.

    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

    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
    labelAvançar Etapa - Assinar Proposta |

    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.

    Card
    labelEnviar contrato para o RM |

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


    É carregado os dados da Proposta.

    Se o Comprador já tiver cadastro no RM , o CPF for localizado , será atualizado os dados no RM e será habilitado botão no PVI para atualizar dados cadastrais, caso não exista no RM , os dados no comprador novo serão enviados juntamente com o Contrato.

    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.

    Card
    labelComissã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
    labelComissão paga pela Empresa ( Vendedor no Contrato de venda do TCGI ) |

    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 :

    • CPF 
    • E-mail

    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.

    Card
    labelPessoas |

    Pré-Venda | Pessoas

    Cadastro de Pessoas no PVI


    Ao inserir CPF , cliente caso exista no TCGI , os dados podem ser importados para o PVI.

    Corretor : Ao informar corretor no cadastro dao Cliente , ao puxar o CPF do cliente já será informado o Corretor.

    Interesses : Marcar todo interesse do cliente.

    Documentos : No mebsmo lugar que se cria Documento de Proposta em Backend , Ao criar o documento , marcar vinculado com a Pessoa.

    No canto superior direito do cadastro ,é informado os contratos e propostas vinculada com a pessoa/cliente.

    Card
    labelEmpreendimento |

    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.

    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

    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.