VR Forca Venda Instalacao e Configuracao
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.
Índice
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"
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
- 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"
Criação do Usuário de Controle
- No campo Buscar, digite "usuario"
- Na seção "Administração do Sistema", clique em "Usuários"
Na tela de "Gerenciar usuários do sistema" que abriu:
- Clique no botão "Novo"
- Preencha com as informações do cliente:
| Campo | Valor |
| Nome | ControleFV |
| controleforcavenda@vrsoft.invalid | |
| Tipo | Empresa |
| Grupo de Usuários | 8 - Standard |
- Clique no botão "Salvar"
O pŕoximo passo é entrar em contato com o suporte do Demander e solicitar o token da api para esse usuário criado.
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
- 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.
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.
- Acesse o link no navegador: http://localhost:9027/VRGerenciadorForcaVenda/authentication
- 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.
- Clique em Salvar.
- Na parte superior, clique em "Integração Busca ERP".
- Na tela que abriu, na parte superior, clique em "Configurações".
- 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.
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!.
Sincronização Automática
Na tela inicial do Sincronizador, clique no botão Iniciar.
Você deve ser capaz de observar os contadores diminuindo:
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
