Mudanças entre as edições de "VR Forca Venda Instalacao e Configuracao"
De VRWiki
(→Download e Extração de Arquivos) |
|||
| (17 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>IMPORTANTE:</b> Os passos devem ser seguidos <b>rigorosamente na ordem apresentada</b>. A implantação é incremental e cada etapa depende das anteriores. | <b>IMPORTANTE:</b> Os passos devem ser seguidos <b>rigorosamente na ordem apresentada</b>. A implantação é incremental e cada etapa depende das anteriores. | ||
| − | ==<b>Requisitos</b>== | + | ====<b>Requisitos</b>==== |
* Conexão com internet | * Conexão com internet | ||
| Linha 14: | Linha 12: | ||
* Token da API Demander | * Token da API Demander | ||
| − | ==<b> | + | ===<b>Preparação do Ambiente</b>=== |
| + | ====<b>Criação da Empresa</b>==== | ||
| + | Crie uma nova empresa para o cliente no site do força de vendas: | ||
| + | * No campo <b>Buscar</b>, digite "<b>empresa</b>" | ||
| + | * Na seção "<b>Administração do Sistema</b>", clique em "<b>Empresas</b>", | ||
| + | |||
| + | Na tela de "<b>Gerenciamento de Empresas</b>" que abriu: | ||
| + | * Clique no botão "<b>Novo</b>" | ||
| + | * Preencha com as informações do cliente | ||
| + | * Clique no botão "<b>Salvar</b>" | ||
| + | |||
| + | [[Arquivo:Forcavenda-buscar-empresa-w.png|800px|center|Buscando a empresa]] | ||
| + | [[Arquivo:Forcavenda-buscar-empresa2-w.png|800px|center|Clicando no botão novo]] | ||
| + | <br/> | ||
| + | |||
| + | Acesse a tela de "<b>Configurações de Empresa</b>" | ||
| + | * Clique no ícone de "<b>Engrenagem</b>", à esquerda da empresa que acabou de criar, para editar as configurações | ||
| + | |||
| + | [[Arquivo:Forcavenda-config-empresa-w.png|800px|center|Clicando na engrenagem]] | ||
| + | |||
| + | * Clique na aba "<b>Integração</b>" | ||
| + | * No campo "<b>Token</b>", clique no botão "<b>Gerar</b>" | ||
| + | * 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 "<b>Salvar</b>" | ||
| + | |||
| + | [[Arquivo:Forcavenda-config-empresa2-w.png|800px|center|Criando e configurando o token da empresa]] | ||
| + | |||
| + | ====<b>Criação do Usuário de Controle</b>==== | ||
| + | Em Construção. | ||
| + | |||
| + | ====<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 link]. | ||
| + | |||
| + | Extraia os arquivos para dentro da pasta /vr. Você deve obter o seguinte resultado: | ||
| + | <pre> | ||
| + | vr/ | ||
| + | └── gerenciadorforcavenda/ | ||
| + | ├── logs/ | ||
| + | ├── sincronizador/ | ||
| + | ├── .env | ||
| + | └── docker-compose.yml | ||
| + | </pre> | ||
| + | |||
| + | ===<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. | ||
| + | |||
| + | ====<b>Gerenciador</b>==== | ||
| + | Abra o arquivo .env, preencha as informações e salve.<br> | ||
| + | A senha usada no campo <b>DEMANDER_READONLY_PASSWORD</b> também será usada no passo seguinte. | ||
| + | |||
| + | * Abra o terminal dentro da pasta <code>vr/gerenciadorforcavenda</code>, onde está o arquivo "docker-compose". | ||
| + | * Execute o comando: <code>docker compose up</code> | ||
| + | * 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. | ||
| + | [[Arquivo:Forcavenda-url-g.png|800px|center]]<br> | ||
| + | * Acesse o link no navegador: http://localhost:9027/VRGerenciadorForcaVenda/authentication | ||
| + | [[Arquivo:Forcavenda-auth-g.png|400px|center]]<br> | ||
| + | * Insira as informações e clique em <b>Confirmar</b>. | ||
| + | * Feche o navegador. | ||
| + | |||
| + | ====<b>Sincronizador</b>==== | ||
| + | |||
| + | * Acesse a pasta <code>vr/gerenciadorforcavenda/sincronizador</code> | ||
| + | * Execute o arquivo <b>Sincronizador-5.2.0</b>. | ||
| + | * Preencha o campo "token empresa" com o token da empresa, gerado na configuração da empresa no passo anterior. | ||
| + | [[Arquivo:Forcavenda-token-s.png|600px|frame|center]] | ||
| + | |||
| + | * Clique em Salvar. | ||
| + | * Na parte superior, clique em "Integração Busca ERP". | ||
| + | * Na tela que abriu, na parte superior, clique em "Configurações". | ||
| + | [[Arquivo:Forcavenda-busca-config-s.png|600px|frame|center]] | ||
| + | |||
| + | * 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. | ||
| + | [[Arquivo:Forcavenda-db-sucesso-s.png|600px|frame|center]] | ||
| + | |||
| + | ===<b>Primeira Sincronização</b>=== | ||
| + | ====<b>Sincronização Manual</b>==== | ||
| + | Na tela inicial do <b>Sincronizador</b>, clique no botão <b>Enviar</b>. | ||
| + | |||
| + | Aguarde a finalização do processo que pode ser identificada através da mensagem: <code>Processo de envio finalizado!</code>. | ||
| + | |||
| + | [[Arquivo:Forcavenda-envio-sinc.png]] | ||
| − | === | + | ====<b>Sincronização Automática</b>==== |
| − | + | Na tela inicial do <b>Sincronizador</b>, clique no botão <b>Iniciar</b>. | |
| − | |||
| − | + | Você deve ser capaz de observar os contadores diminuindo: | |
| − | |||
| − | |||
| − | + | [[Arquivo:Forcavenda-contador-sinc.png]] | |
| − | |||
| − | |||
| − | ==<b>Tempo Estimado</b>== | + | ===<b>Tempo Estimado</b>=== |
* Total: <b>15 a 40 minutos</b> (depende da velocidade de sincronização inicial) | * Total: <b>15 a 40 minutos</b> (depende da velocidade de sincronização inicial) | ||
Edição atual tal como às 12h31min de 18 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.
IMPORTANTE: Os passos devem ser seguidos rigorosamente na ordem apresentada. A implantação é incremental e cada etapa depende das anteriores.
Índice
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:
- 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
Em Construção.
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 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
- Insira as informações e clique em Confirmar.
- 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, 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
