Mudanças entre as edições de "VR Forca Venda Instalacao e Configuracao"
De VRWiki
(→Criação do Usuário de Controle) |
|||
| (9 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 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>==== | ||
| − | |||
| − | + | * No campo Buscar, digite "usuario" | |
| − | * No campo Buscar, digite " | + | * Na seção "<b>Administração do Sistema</b>", clique em "<b>Usuários</b>" |
| − | * Na seção "<b> | + | [[Arquivo:Forcavenda-buscar-usuario-w.png|800px|center]] |
| − | Na tela de "<b> | + | |
| + | 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>" | ||
* Preencha com as informações do cliente: | * Preencha com as informações do cliente: | ||
| Linha 50: | Linha 56: | ||
<div> | <div> | ||
<table style="width: 50%"> | <table style="width: 50%"> | ||
| − | <tr><td> | + | <tr><td><b>Campo</b></td><td><b>Valor</b></td></tr> |
| − | |||
| − | |||
<tr><td>Nome</td><td>ControleFV</td></tr> | <tr><td>Nome</td><td>ControleFV</td></tr> | ||
| − | <tr><td> | + | <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> | ||
| Linha 62: | Linha 68: | ||
====<b>Download e Extração de Arquivos</b>==== | ====<b>Download e Extração de Arquivos</b>==== | ||
| − | Faça download dos arquivos compactados através do [https://drive.google.com/file/d/1jXC5wvVXCoLRbkifnTU_LhKwiAMjOjW9/view?usp=drive_link | + | Faça download dos arquivos compactados através do link: |
| + | |||
| + | * [https://drive.google.com/file/d/1jXC5wvVXCoLRbkifnTU_LhKwiAMjOjW9/view?usp=drive_link linux]. | ||
| + | * [https://drive.google.com/file/d/1HdDbi0Vyqo-3v_bl4zXIaN-aPY7mMzz4/view?usp=drive_link windows]. | ||
| + | |||
Extraia os arquivos para dentro da pasta /vr. Você deve obter o seguinte resultado: | Extraia os arquivos para dentro da pasta /vr. Você deve obter o seguinte resultado: | ||
| Linha 75: | Linha 85: | ||
===<b>Configuração do Ambiente</b>=== | ===<b>Configuração do Ambiente</b>=== | ||
| − | Nesse passo | + | Nesse passo vamos inserir as configurações no Gerenciador e Sincronizador. |
====<b>Gerenciador</b>==== | ====<b>Gerenciador</b>==== | ||
| Linha 87: | 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> | ||
| − | * | + | * <b>Mantenha a página aberta, vamos inserir o token após a sincronização manual</b> |
| − | |||
====<b>Sincronizador</b>==== | ====<b>Sincronizador</b>==== | ||
| Linha 121: | 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.
Í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"
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:
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
