Mudanças entre as edições de "VR Forca Venda Instalacao e Configuracao"

De VRWiki
(→‎Download e Extração de Arquivos)
 
(5 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
Este manual fornece as instruções detalhadas e passo a passo para implantação do sistema VR Gerenciador de Força de Venda em servidores do cliente.
 
Este manual fornece as instruções detalhadas e passo a passo para implantação do sistema VR Gerenciador de Força de Venda em servidores do cliente.
  
−
====<b>Requisitos</b>====
+
===<b>Requisitos Mínimos</b>===
  
 
* Conexão com internet
 
* Conexão com internet
Linha 9: Linha 9:
 
* Código da empresa Demander
 
* Código da empresa Demander
 
* Token da API Demander
 
* Token da API Demander
 +
 +
====<b>Versões Mínimas</b>====
 +
 +
* <b>VRMaster</b>: 4.4.57
 +
* <b>VRAutorizador</b>: 4.5.5 (lançamento em jul/2026)
 +
* <b>VRPdv</b>: 4.4.0
  
 
===<b>Preparação do Ambiente</b>===
 
===<b>Preparação do Ambiente</b>===
Linha 39: Linha 45:
  
 
====<b>Criação do Usuário de Controle</b>====
 
====<b>Criação do Usuário de Controle</b>====
−
<b>O usuário controle é criado automaticamente pelo gerenciador.</b>
 
  
−
Caso seja necessário realizar a criação manualmente, seguem os passos:
+
* No campo Buscar, digite "usuario"
−
* No campo Buscar, digite "vendedor"
+
* Na seção "<b>Administração do Sistema</b>", clique em "<b>Usuários</b>"
−
* Na seção "<b>Cadastro</b>", clique em "<b>Vendedores</b>"
+
[[Arquivo:Forcavenda-buscar-usuario-w.png|800px|center]]
−
[[Arquivo:Forcavenda-buscar2-w.png|800px|center]]
 
  
−
Na tela de "<b>Gerenciamento de Vendedores</b>" que abriu:
+
Na tela de "<b>Gerenciar usuários do sistema</b>" que abriu:
 
* Clique no botão "<b>Novo</b>"
 
* Clique no botão "<b>Novo</b>"
−
[[Arquivo:Forcavenda-add-vend-w.png|800px|center]]
 
−
<br>
 
 
* Preencha com as informações do cliente:
 
* Preencha com as informações do cliente:
  
Linha 55: Linha 57:
 
<table style="width: 50%">
 
<table style="width: 50%">
 
<tr><td><b>Campo</b></td><td><b>Valor</b></td></tr>
 
<tr><td><b>Campo</b></td><td><b>Valor</b></td></tr>
−
<tr><td>Tipo Vendedor</td><td>Vendedor</td></tr>
 
−
<tr><td>Código</td><td>0</td></tr>
 
 
<tr><td>Nome</td><td>ControleFV</td></tr>
 
<tr><td>Nome</td><td>ControleFV</td></tr>
−
<tr><td>Login</td><td>controleforcavenda@vrsoft.invalid</td></tr>
+
<tr><td>Email</td><td>controleforcavenda@vrsoft.invalid</td></tr>
 +
<tr><td>Tipo</td><td>Empresa</td></tr>
 +
<tr><td>Grupo de Usuários</td><td>8 - Standard</td></tr>
 
</table>
 
</table>
 
</div>
 
</div>
  
 
* Clique no botão "<b>Salvar</b>"
 
* Clique no botão "<b>Salvar</b>"
−
 
−
O pŕoximo passo é entrar em contato com o suporte do Demander e solicitar o token da api para esse usuário criado:
 
−
* Clique no ícone de balões no canto superior direito e inicie o atendimento
 
−
[[Arquivo:Forcavenda-suporte-w.png|600px|frame|center]]
 
−
 
−
* Envie a seguinte mensagem: "Preciso criar um API Token para a empresa XXXX para utilizar a API de Integração REST, usando o usuário XX email XYZ".
 
−
* Anote o token recebido.
 
  
 
====<b>Download e Extração de Arquivos</b>====
 
====<b>Download e Extração de Arquivos</b>====
Linha 90: Linha 85:
  
 
===<b>Configuração do Ambiente</b>===
 
===<b>Configuração do Ambiente</b>===
−
Nesse passo você precisará ter feito o passo anterior, aqui é onde usaremos os dois tokens e o código da empresa.
+
Nesse passo vamos inserir as configurações no Gerenciador e Sincronizador.
  
 
====<b>Gerenciador</b>====
 
====<b>Gerenciador</b>====
Linha 102: Linha 97:
 
* Acesse o link no navegador: http://localhost:9027/VRGerenciadorForcaVenda/authentication
 
* Acesse o link no navegador: http://localhost:9027/VRGerenciadorForcaVenda/authentication
 
[[Arquivo:Forcavenda-auth-g.png|400px|center]]<br>
 
[[Arquivo:Forcavenda-auth-g.png|400px|center]]<br>
−
* Insira as informações e clique em <b>Confirmar</b>.
+
* <b>Mantenha a página aberta, vamos inserir o token após a sincronização manual</b>
−
* Feche o navegador.
 
  
 
====<b>Sincronizador</b>====
 
====<b>Sincronizador</b>====
Linha 136: Linha 130:
  
 
[[Arquivo:Forcavenda-contador-sinc.png]]
 
[[Arquivo:Forcavenda-contador-sinc.png]]
 +
 +
===<b>Finalizando a configuração</b>===
 +
 +
Entre em contato com o suporte do Demander para solicitar o token da api para o usuário de controle criado anteriormente.
 +
 +
<b>Acione o suporte apenas depois de finalizar a sincronização manual.</b>
 +
 +
* Clique no ícone de balões no canto superior direito e inicie o atendimento
 +
[[Arquivo:Forcavenda-suporte-w.png|600px|frame|center]]
 +
 +
* Envie a seguinte mensagem: "Preciso criar um API Token para a empresa ''<INSIRA O CODIGO DA EMPRESA>'' para utilizar a API de Integração REST, usando o usuário ''<INSIRA O CODIGO DO USUARIO CONTROLE>'' email ''<INSIRA O EMAIL DO USUARIO DE CONTROLE>''".
 +
* Anote o token recebido.
 +
* Insira o código da empresa e token recebido no navegador aberto na seção [[#Gerenciador]]
  
 
===<b>Tempo Estimado</b>===
 
===<b>Tempo Estimado</b>===

Edição atual tal como às 12h22min de 26 de junho de 2026

Este manual fornece as instruções detalhadas e passo a passo para implantação do sistema VR Gerenciador de Força de Venda em servidores do cliente.

Requisitos Mínimos

  • Conexão com internet
  • Docker instalado
  • Windows ou Linux
  • Token da empresa Demander
  • Código da empresa Demander
  • Token da API Demander

Versões Mínimas

  • VRMaster: 4.4.57
  • VRAutorizador: 4.5.5 (lançamento em jul/2026)
  • VRPdv: 4.4.0

Preparação do Ambiente

Criação da Empresa

Crie uma nova empresa para o cliente no site do força de vendas:

  • No campo Buscar, digite "empresa"
  • Na seção "Administração do Sistema", clique em "Empresas",

Na tela de "Gerenciamento de Empresas" que abriu:

  • Clique no botão "Novo"
  • Preencha com as informações do cliente
  • Clique no botão "Salvar"
Buscando a empresa
Clicando no botão novo


Acesse a tela de "Configurações de Empresa"

  • Clique no ícone de "Engrenagem", à esquerda da empresa que acabou de criar, para editar as configurações
Clicando na engrenagem
  • Clique na aba "Integração"
  • No campo "Token", clique no botão "Gerar"
  • Copie o token gerado e cole num bloco de notas para ser usado mais tarde
  • Copie o código da empresa e cole num bloco de notas para ser usado mais tarde
  • Clique no botão "Salvar"
Criando e configurando o token da empresa

Criação do Usuário de Controle

  • No campo Buscar, digite "usuario"
  • Na seção "Administração do Sistema", clique em "Usuários"
Forcavenda-buscar-usuario-w.png

Na tela de "Gerenciar usuários do sistema" que abriu:

  • Clique no botão "Novo"
  • Preencha com as informações do cliente:
CampoValor
NomeControleFV
Emailcontroleforcavenda@vrsoft.invalid
TipoEmpresa
Grupo de Usuários8 - Standard
  • Clique no botão "Salvar"

Download e Extração de Arquivos

Faça download dos arquivos compactados através do link:


Extraia os arquivos para dentro da pasta /vr. Você deve obter o seguinte resultado: 

vr/
└── gerenciadorforcavenda/
    ├── logs/
    ├── sincronizador/
    ├── .env
    └── docker-compose.yml

Configuração do Ambiente

Nesse passo vamos inserir as configurações no Gerenciador e Sincronizador.

Gerenciador

Abra o arquivo .env, preencha as informações e salve.
A senha usada no campo DEMANDER_READONLY_PASSWORD também será usada no passo seguinte.

  • Abra o terminal dentro da pasta vr/gerenciadorforcavenda, onde está o arquivo "docker-compose".
  • Execute o comando: docker compose up
  • Aguarde a execução da aplicação, são alguns segundos até que apareça o link para inserção do token da api e código da empresa.
Forcavenda-url-g.png


Forcavenda-auth-g.png


  • Mantenha a página aberta, vamos inserir o token após a sincronização manual

Sincronizador

  • Acesse a pasta vr/gerenciadorforcavenda/sincronizador
  • Execute o arquivo Sincronizador-5.2.0.
  • Preencha o campo "token empresa" com o token da empresa, gerado na configuração da empresa no passo anterior.
Forcavenda-token-s.png
  • Clique em Salvar.
  • Na parte superior, clique em "Integração Busca ERP".
  • Na tela que abriu, na parte superior, clique em "Configurações".
Forcavenda-busca-config-s.png
  • Preencha os campos do banco de dados (utilize a senha do passo anterior, DEMANDER_READONLY_PASSWORD).
  • Clique em "Testar" e você deve obter uma mensagem de sucesso.
  • Clique em salvar.
Forcavenda-db-sucesso-s.png

Primeira Sincronização

Sincronização Manual

Na tela inicial do Sincronizador, clique no botão Enviar.

Aguarde a finalização do processo que pode ser identificada através da mensagem: Processo de envio finalizado!.

Forcavenda-envio-sinc.png

Sincronização Automática

Na tela inicial do Sincronizador, clique no botão Iniciar.

Você deve ser capaz de observar os contadores diminuindo:

Forcavenda-contador-sinc.png

Finalizando a configuração

Entre em contato com o suporte do Demander para solicitar o token da api para o usuário de controle criado anteriormente.

Acione o suporte apenas depois de finalizar a sincronização manual.

  • Clique no ícone de balões no canto superior direito e inicie o atendimento
Forcavenda-suporte-w.png
  • Envie a seguinte mensagem: "Preciso criar um API Token para a empresa <INSIRA O CODIGO DA EMPRESA> para utilizar a API de Integração REST, usando o usuário <INSIRA O CODIGO DO USUARIO CONTROLE> email <INSIRA O EMAIL DO USUARIO DE CONTROLE>".
  • Anote o token recebido.
  • Insira o código da empresa e token recebido no navegador aberto na seção #Gerenciador

Tempo Estimado

  • Total: 15 a 40 minutos (depende da velocidade de sincronização inicial)
  • Preparação: 2 ~ 5 minutos
  • Configuração: 10 ~ 15 minutos
  • Sincronização: 5 ~ 20 minutos
Disponível em "http://wiki.vrsoft.com.br//wiki/index.php?title=VR_Forca_Venda_Instalacao_e_Configuracao&oldid=51492"