> For the complete documentation index, see [llms.txt](https://docs.vrsoft.com.br/vrmaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-forca-venda/vr-forca-venda-instalacao-e-configuracao.md). # Instalação e Configuração 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**" ![Buscando a empresa](/files/vonDx3ivyQuvXHspjV1d) ![Clicando no botão novo](/files/aAGYkPx09R6BYHg1KDUM) 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 ![Clicando na engrenagem](/files/BSJBJBNlAQW6XOckhkEu) * 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**" ![Criando e configurando o token da empresa](/files/3rkMTjS0dUTuy3BUhsK0) #### **Criação do Usuário de Controle** * No campo Buscar, digite "usuario" * Na seção "**Administração do Sistema**", clique em "**Usuários**" ![](/files/SG8WycpEwPyNKoD6i4OC) 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 | | | 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](https://drive.google.com/file/d/1jXC5wvVXCoLRbkifnTU_LhKwiAMjOjW9/view?usp=drive_link). * [windows](https://drive.google.com/file/d/1HdDbi0Vyqo-3v_bl4zXIaN-aPY7mMzz4/view?usp=drive_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. ![](/files/tdbqb0RVpa453AISHzeI) * Acesse o link no navegador: ![](/files/lLYpfTC3FOJNaKdRJEaP) * **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. ![](/files/jlBgItsEgrJjXdvhRgUn) * Clique em Salvar. * Na parte superior, clique em "Integração Busca ERP". * Na tela que abriu, na parte superior, clique em "Configurações". ![](/files/dQcUcPJPaFQ1CGbMk9Lp) * 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. ![](/files/exDziRCeB85mR27DuTMi) ### **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!`. ![](/files/TGK7xJ1G4hp3i8GHUUNd) #### **Sincronização Automática** Na tela inicial do **Sincronizador**, clique no botão **Iniciar**. Você deve ser capaz de observar os contadores diminuindo: ![](/files/99HJzzEq4zEMIO63vyCa) ### **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 ![](/files/ypCbxOUhHP70wch2p3Nn) * Envie a seguinte mensagem: "Preciso criar um API Token para a empresa para utilizar a API de Integração REST, usando o usuário email ". * Anote o token recebido. * Insira o código da empresa e token recebido no navegador aberto na seção [#Gerenciador](/vrmaster/manual-do-sistema/manual-do-sistema-vr-forca-venda/vr-forca-venda-instalacao-e-configuracao/gerenciador.md) ### **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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-forca-venda/vr-forca-venda-instalacao-e-configuracao.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.