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.

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
Email	controleforcavenda@vrsoft.invalid
Tipo	Empresa
Grupo de Usuários	8 - Standard

• Clique no botão "Salvar"

Download e Extração de Arquivos

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

• linux.
• windows.

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:

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

• 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