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.

IMPORTANTE: Os passos devem ser seguidos rigorosamente na ordem apresentada. A implantação é incremental e cada etapa depende das anteriores.

Requisitos

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

Preparação do Ambiente

Criação da Empresa

Crie uma nova empresa para o cliente no site do força de vendas. Buscar -> Digite "empresa" -> Clique em "Empresas" -> Novo -> Preencha e salve.

Acesse a tela de "configurações de Empresa".

• Clique no ícone à 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 em "Salvar".

Criação do Usuário de Controle

• Na parte superior, clique em "Buscar", digite "usuário" e selecione "Usuários".
• Clique em "Novo"
• Preencha os campos com os seguintes valores:
  • Nome: ControleFV
  • Email: controleforcavenda@vrsoft.invalid
  • Tipo: Empresa
  • Grupo: 8 - Standard
• Clique em "Salvar"

• Na parte superior, clique em "Buscar", digite "vendedor" e selecione "Vendedores".
• Clique em "Novo"
• Preencha os campos com os seguintes valores:
  • Tipo de Vendedor: Vendedor
  • Código: 0
  • Nome: ControleFV
  • Login: controleforcavenda@vrsoft.invalid
• Na aba "Dados":
  • Faixa de pedido inicial: 1
  • Faixa de pedido final: 9999
  • Pedido atual: 0
• Clique em "Salvar"

Entre em contato com o suporte do Demander, através do ícone de balões no canto superior direito e solicite o token da api do usuário criado.

Anote esse token no bloco de notas para ser usado mais tarde.

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 você precisará ter feito o passo anterior, aqui é onde usaremos os dois tokens e o código da empresa.

Gerenciador

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

• Abra o terminal dentro da pasta 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
• Insira as informações e clique em salvar.
• Feche o navegador.

Sincronizador

• Acesse a pasta vr/gerenciadorforcavenda/sincronizador
• Execute o arquivo Sincronizador-5.2.0.
• Preencha o campo "token empresa" com o token da empresa (o token que fica visível na tela de configuração da empresa, no site do força de vendas).
• 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 (são as mesmas informações de conexão no arquivo .env e a senha é a mesma que o campo DEMANDER_READONLY_PASSWORD).
• Clique em "Testar" e você deve obter uma mensagem de sucesso.
• Clique em salvar.

Primeira Sincronização

• Sincronização Manual
• Sincronização Automática

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