http://wiki.vrsoft.com.br//wiki/api.php?action=feedcontributions&feedformat=atom&user=Pedro.camargoVRWiki - Contribuições do(a) usuário(a) [pt-br]2026-07-07T22:06:28ZContribuições do(a) usuário(a)MediaWiki 1.32.1http://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51486INSTALACAO VRFICHA API2026-06-25T17:57:20Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação grava os arquivos no diretório configurado para o tipo de catraca utilizada no VRMaster<br />
<br />
<b>Configuração do diretório</b><br />
<br />
Para configurar o diretório onde os arquivos serão gerados, basta ir em:<br />
<b><i><pre>VRMaster -> PDV -> Parâmetro -> Periféricos -> Catraca</pre></i></b><br />
<br />
Então selecionar o tipo de catraca utilizado, ir até a aba da catraca selecionada, especificar o diretório e salvar.<br />
<br />
<b>PONTOS IMPORTANTES</b><br />
<br />
<b><i>Configuração correta do caminho no VRMaster</i></b><br />
<br />
O diretório configurado deve ser o caminho de uma pasta compartilhada na rede, sempre informando IP e o diretório. Não utilizar caminhos locais ou referenciar outras máquinas por nome, pois essa abordagem não funcionará. Obrigatoriamente deve ser no seguinte formato:<br />
<pre>\\192.168.0.1\catraca</pre><br />
<br />
Referenciando o IP da máquina com a pasta compartilhada, e o nome da pasta. A barra pode ser tanto a invertida (\) quanto a comum (/), funcionará da mesma forma no app, se atentar se funcionará no desktop, pois ambos compartilham a mesma configuração feita no VRMaster.<br />
<br />
<b><i>Configuração correta do compartilhamento</i></b><br />
<br />
O diretório precisa ser compartilhado com permissão para acesso Guest, ou seja, sem informar usuário e senha.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51485INSTALACAO VRFICHA API2026-06-25T17:53:44Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação grava os arquivos no diretório configurado para o tipo de catraca utilizada no VRMaster<br />
<br />
<b>Configuração do diretório</b><br />
<br />
Para configurar o diretório onde os arquivos serão gerados, basta ir em:<br />
<b><i><pre>VRMaster -> PDV -> Parâmetro -> Periféricos -> Catraca</pre></i></b><br />
<br />
Então selecionar o tipo de catraca utilizado, ir até a aba da catraca selecionada, especificar o diretório e salvar.<br />
<br />
<b>IMPORTANTE</b><br />
<br />
O diretório configurado deve ser o caminho de uma pasta compartilhada na rede, sempre informando IP e o diretório. Não utilizar caminhos locais ou referenciar outras máquinas por nome, pois essa abordagem não funcionará. Obrigatoriamente deve ser no seguinte formato:<br />
<pre>\\192.168.0.1\catraca</pre><br />
<br />
Referenciando o IP da máquina com a pasta compartilhada, e o nome da pasta. A barra pode ser tanto a invertida (\) quanto a comum (/), funcionará da mesma forma no app, se atentar se funcionará no desktop, pois ambos compartilham a mesma configuração feita no VRMaster.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51484INSTALACAO VRFICHA API2026-06-25T17:52:50Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação grava os arquivos no diretório configurado para o tipo de catraca utilizada no VRMaster<br />
<br />
<b>Configuração do diretório</b><br />
<br />
Para configurar o diretório onde os arquivos serão gerados, basta ir em:<br />
<b><i><pre>VRMaster -> PDV -> Parâmetro -> Periféricos -> Catraca</pre></i></b><br />
<br />
Então selecionar o tipo de catraca utilizado, ir até a aba da catraca selecionada, especificar o diretório e salvar.<br />
<br />
<b>IMPORTANTE</b><br />
<br />
O diretório configurado deve ser o caminho de uma pasta compartilhada na rede, sempre informando IP e o diretório. Não utilizar caminhos locais ou referenciar outras máquinas por nome, pois essa abordagem não funcionará. Obrigatoriamente deve ser no seguinte formato:<br />
<pre>\\192.168.0.1\catraca</pre><br />
<br />
Referenciando o IP da máquina com a pasta compartilhada, e o nome da pasta. A barra pode ser tanto a invertida (\) quanto a comum (/), funcionará da mesma forma no app, se atentar se funcionará no desktop que usa a mesma configuração.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51483INSTALACAO VRFICHA API2026-06-25T17:52:29Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação grava os arquivos no diretório configurado para o tipo de catraca utilizada no VRMaster<br />
<br />
<b>Configuração do diretório</b><br />
<br />
Para configurar o diretório onde os arquivos serão gerados, basta ir em:<br />
<pre><b><i>VRMaster -> PDV -> Parâmetro -> Periféricos -> Catraca</i></b></pre><br />
<br />
Então selecionar o tipo de catraca utilizado, ir até a aba da catraca selecionada, especificar o diretório e salvar.<br />
<br />
<b>IMPORTANTE</b><br />
<br />
O diretório configurado deve ser o caminho de uma pasta compartilhada na rede, sempre informando IP e o diretório. Não utilizar caminhos locais ou referenciar outras máquinas por nome, pois essa abordagem não funcionará. Obrigatoriamente deve ser no seguinte formato:<br />
<pre>\\192.168.0.1\catraca</pre><br />
<br />
Referenciando o IP da máquina com a pasta compartilhada, e o nome da pasta. A barra pode ser tanto a invertida (\) quanto a comum (/), funcionará da mesma forma no app, se atentar se funcionará no desktop que usa a mesma configuração.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51480INSTALACAO VRFICHA API2026-06-23T17:16:41Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos seguintes diretórios que se encontram dentro do Container:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<h3><b>PONTO DE ATENÇÃO</b></h3><br />
<br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
<br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- "C:/Catraca/Acesso:/VRFichaAPI/acesso"<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51479INSTALACAO VRFICHA API2026-06-23T17:15:23Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos seguintes diretórios que se encontram dentro do Container:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<h3><b>PONTO DE ATENÇÃO</b></h3><br />
<br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
<br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
- /home/usuario/catraca/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- C:\Catraca\Acesso:/VRFichaAPI/acesso<br />
- C:\Catraca\Blantech:/VRFichaAPI/blantech<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51478INSTALACAO VRFICHA API2026-06-23T17:12:29Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos seguintes diretórios que se encontram dentro do Container:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<h3><b>PONTO DE ATENÇÃO</b></h3><br />
<br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
<br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
- /home/usuario/catraca/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- C:\Catraca\Acesso:/VRFichaAPI/acesso<br />
- C:\Catraca\Blantech:/VRFichaAPI/blantech<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51477INSTALACAO VRFICHA API2026-06-23T17:11:56Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos seguintes diretórios que se encontram dentro do Container:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<h3><b>PONTO DE ATENÇÃO</b></h3><br />
<br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
- /home/usuario/catraca/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- C:\Catraca\Acesso:/VRFichaAPI/acesso<br />
- C:\Catraca\Blantech:/VRFichaAPI/blantech<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51476INSTALACAO VRFICHA API2026-06-23T17:11:21Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos seguintes diretórios que se encontram dentro do Container:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<b>PONTO DE ATENÇÃO</b><br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
- /home/usuario/catraca/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- C:\Catraca\Acesso:/VRFichaAPI/acesso<br />
- C:\Catraca\Blantech:/VRFichaAPI/blantech<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51475INSTALACAO VRFICHA API2026-06-23T17:10:46Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
<b>PONTO DE ATENÇÃO</b><br />
Caso a pasta onde serão gerados os arquivos seja uma pasta local no host, ou seja, fique no mesmo computador onde o VRFichaAPI está rodando, não é necessário montar o compartilhamento SMB/Samba, basta configurar o volume do Docker para mapear o diretório local para dentro do container.<br />
<br />
<b>Cenário</b><br />
Considere que o cliente usa catraca Acesso, e o diretório onde os arquivos da catraca serão gerados seja /home/usuario/catraca/acesso, no mesmo computador onde o VRFichaAPI está rodando. Neste caso, basta configurar o volume da seguinte forma:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /home/usuario/catraca/acesso:/VRFichaAPI/acesso<br />
- /home/usuario/catraca/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
Em um caso no Windows, o diretório local poderia ser C:\Catraca\Acesso, e a configuração do volume seria:<br />
<pre style="color: silver; background: black;"><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
volumes:<br />
- C:\Catraca\Acesso:/VRFichaAPI/acesso<br />
- C:\Catraca\Blantech:/VRFichaAPI/blantech<br />
...<br />
</pre><br />
<br />
<b>CASO O DIRETÓRIO SEJA LOCAL, IGNORAR TODO O RESTANTE DESTE DOCUMENTO</b><br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51474INSTALACAO VRFICHA API2026-06-23T14:49:39Z<p>Pedro.camargo: /* CATRACAS */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, deve-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
O processo envolve basicamente as duas etapas acima, montando no computador host do VRFichaAPI o diretório que é compartilhado onde o VRFicha gera os arquivos, e então configurando o volume para que o container do VRFichaAPI possa gerar arquivos dentro deste diretório.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51472INSTALACAO VRFICHA API2026-06-23T12:14:01Z<p>Pedro.camargo: /* 2.2 Configuração para catraca Blantech */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/blantech:/VRFichaAPI/blantech"<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51471INSTALACAO VRFICHA API2026-06-23T12:13:34Z<p>Pedro.camargo: /* 2.1 Configuração para catraca Acesso */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- "Z:/xml/acesso:/VRFichaAPI/acesso"<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51468INSTALACAO VRFICHA API2026-06-22T20:00:46Z<p>Pedro.camargo: /* 2. Configurando o Docker Compose */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container através dos volumes declarados no arquivo usado pelo Docker Compose para subir o container. Abaixo a explicação de como realizar este mapeamento.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51467INSTALACAO VRFICHA API2026-06-22T19:59:43Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
...<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
...<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51466INSTALACAO VRFICHA API2026-06-22T19:58:06Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
====<b>1.1 Montando em um host Windows</b>====<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
<b>Testando o acesso</b><br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
====<b>1.2 Montando em um host Linux</b>====<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
====<b>2.1 Configuração para catraca Acesso</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51465INSTALACAO VRFICHA API2026-06-22T19:57:04Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
====<b>2.2 Configuração para catraca Blantech</b>====<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>Validação Final</b>===<br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51464INSTALACAO VRFICHA API2026-06-22T19:56:22Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51463INSTALACAO VRFICHA API2026-06-22T19:54:17Z<p>Pedro.camargo: /* 1.1 Montando em um host Windows */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.3 Ambiente que utiliza ambos os tipos de catraca</b>===<br />
<br />
Caso a loja possa utilizar tanto Acesso quanto Blantech, recomenda-se mapear ambos os diretórios.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51462INSTALACAO VRFICHA API2026-06-22T19:53:37Z<p>Pedro.camargo: /* 1.1 Montando em um host Windows */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
<br />
1. Abra o Explorador de Arquivos. <br /><br />
2. Clique em "Este Computador". <br /><br />
3. Clique em "Mapear unidade de rede". <br /> <br />
4. Escolha uma letra de unidade, por exemplo: <br /><br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br /><br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque: <br /><br />
Reconectar ao entrar <br /><br />
7. Clique em Concluir. <br /><br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.3 Ambiente que utiliza ambos os tipos de catraca</b>===<br />
<br />
Caso a loja possa utilizar tanto Acesso quanto Blantech, recomenda-se mapear ambos os diretórios.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51461INSTALACAO VRFICHA API2026-06-22T19:52:19Z<p>Pedro.camargo: /* 1. Montando um compartilhamento de rede no host */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
1. Abra o Explorador de Arquivos. <br />
2. Clique em "Este Computador". <br />
3. Clique em "Mapear unidade de rede". <br />
4. Escolha uma letra de unidade, por exemplo:<br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque:<br />
Reconectar ao entrar<br />
7. Clique em Concluir.<br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.3 Ambiente que utiliza ambos os tipos de catraca</b>===<br />
<br />
Caso a loja possa utilizar tanto Acesso quanto Blantech, recomenda-se mapear ambos os diretórios.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51460INSTALACAO VRFICHA API2026-06-22T19:51:47Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.</br><br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
1. Abra o Explorador de Arquivos. <br />
2. Clique em "Este Computador". <br />
3. Clique em "Mapear unidade de rede". <br />
4. Escolha uma letra de unidade, por exemplo:<br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque:<br />
Reconectar ao entrar<br />
7. Clique em Concluir.<br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.3 Ambiente que utiliza ambos os tipos de catraca</b>===<br />
<br />
Caso a loja possa utilizar tanto Acesso quanto Blantech, recomenda-se mapear ambos os diretórios.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51459INSTALACAO VRFICHA API2026-06-22T19:50:17Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* A aplicação é executada em container Docker, e grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host. <br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
<b>Cenário</b><br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.<br />
<br />
===<b>1.1 Montando em um host Windows</b>===<br />
<b>Utilizando o Explorador de Arquivos</b><br />
1. Abra o Explorador de Arquivos. <br />
2. Clique em "Este Computador". <br />
3. Clique em "Mapear unidade de rede". <br />
4. Escolha uma letra de unidade, por exemplo:<br />
<pre>Z:</pre><br />
5. Informe o caminho do compartilhamento: <br />
<pre>\\192.168.1.100\ficha_entrada</pre> <br />
6. Marque:<br />
Reconectar ao entrar<br />
7. Clique em Concluir.<br />
<br />
Caso necessário, informe usuário e senha do compartilhamento.<br />
<br />
Após a montagem, o compartilhamento estará disponível como:<br />
<pre>Z:\</pre><br />
<br />
===<b>Testando o acesso</b>===<br />
<br />
Crie manualmente um arquivo:<br />
<br />
<pre>Z:\xml\acesso\teste.xml</pre><br />
ou<br />
<pre>Z:\xml\blantech\teste.xml</pre><br />
<br />
Se o arquivo for criado corretamente, a montagem está funcionando.<br />
<br />
===<b>1.2 Montando em um host Linux</b>===<br />
<br />
Instale o suporte CIFS caso ainda não esteja instalado.<br />
<br />
Ubuntu/Debian:<br />
<pre style="color: silver; background: black;"><br />
sudo apt update<br />
sudo apt install cifs-utils<br />
</pre><br />
<br />
CentOS/RHEL:<br />
<pre style="color: silver; background: black;"><br />
sudo yum install cifs-utils<br />
</pre><br />
<br />
<b>Criando o ponto de montagem</b><br />
<pre style="color: silver; background: black;"><br />
sudo mkdir -p /mnt/ficha_entrada<br />
</pre><br />
<br />
<b>Montando o compartilhamento</b><br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=USUARIO,password=SENHA<br />
</pre><br />
<br />
Exemplo:<br />
<br />
<pre style="color: silver; background: black;"><br />
sudo mount -t cifs \<br />
//192.168.1.100/ficha_entrada \<br />
/mnt/ficha_entrada \<br />
-o username=vr,password=123456<br />
</pre><br />
<br />
<b>Validando a montagem</b><br />
<br />
Execute:<br />
<pre style="color: silver; background: black;"><br />
ls /mnt/ficha_entrada<br />
</pre><br />
<br />
Os arquivos e diretórios do compartilhamento deverão ser exibidos.<br />
<br />
Também é possível verificar:<br />
<br />
<pre style="color: silver; background: black;"><br />
mount | grep cifs<br />
</pre><br />
<br />
<b>Montagem automática na inicialização (opcional)</b><br />
<br />
Adicionar ao arquivo:<br />
<pre>/etc/fstab</pre><br />
<br />
Exemplo:<br />
<pre>//192.168.1.100/ficha_entrada /mnt/ficha_entrada cifs username=vr,password=123456,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0</pre><br />
<br />
Após salvar:<br />
<pre style="color: silver; background: black;"><br />
sudo mount -a<br />
</pre><br />
<br />
===<b>2. Configurando o Docker Compose</b>===<br />
<br />
Após a montagem do compartilhamento no host, basta mapear o diretório para dentro do container.<br />
<br />
===<b>2.1 Configuração para catraca Acesso</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<pre>./acesso/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/acesso</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<br />
Supondo que o compartilhamento esteja montado em:<br />
<pre><br />
/mnt/ficha_entrada/xml/acesso<br />
</pre><br />
<br />
Configure:<br />
<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<br />
Supondo que o compartilhamento esteja mapeado na unidade:<br />
<pre>Z:</pre><br />
<br />
e que os XMLs devam ser gravados em:<br />
<br />
<pre>Z:\xml\acesso</pre><br />
<br />
Configure:<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.2 Configuração para catraca Blantech</b>===<br />
<br />
A aplicação grava os XMLs em:<br />
<br />
<pre>./blantech/</pre><br />
<br />
que corresponde a:<br />
<pre>/VRFichaAPI/blantech</pre><br />
<br />
dentro do container.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
===<b>2.3 Ambiente que utiliza ambos os tipos de catraca</b>===<br />
<br />
Caso a loja possa utilizar tanto Acesso quanto Blantech, recomenda-se mapear ambos os diretórios.<br />
<br />
<b>Host Linux</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- /mnt/ficha_entrada/xml/acesso:/VRFichaAPI/acesso<br />
- /mnt/ficha_entrada/xml/blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Host Windows</b><br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.9<br />
<br />
volumes:<br />
- Z:\xml\acesso:/VRFichaAPI/acesso<br />
- Z:\xml\blantech:/VRFichaAPI/blantech<br />
<br />
ports:<br />
- "9015:9015"<br />
</pre><br />
<br />
<b>Validação Final</b><br />
<br />
Após iniciar o container:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker compose up -d<br />
</pre><br />
<br />
Verifique se os diretórios estão montados corretamente:<br />
<br />
<pre style="color: silver; background: black;"><br />
docker exec -it vrficha-api sh<br />
</pre><br />
<br />
Para catraca Acesso:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/acesso<br />
</pre><br />
<br />
Para catraca Blantech:<br />
<pre style="color: silver; background: black;"><br />
ls -la /VRFichaAPI/blantech<br />
</pre><br />
<br />
Os arquivos XML gerados pela aplicação deverão aparecer nesses diretórios e, consequentemente, no compartilhamento de rede configurado no host.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=51458INSTALACAO VRFICHA API2026-06-22T19:36:13Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=5672<br />
- RABBITMQ_USUARIO=vr<br />
- RABBITMQ_SENHA=vr!RbtMQ<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]<br />
<br />
==<b>CATRACAS</b>==<br />
* A aplicação VRFicha API gera arquivos XML para integração com catracas dos tipos Acesso e Blantech<br />
* Quando executada em container Docker, a aplicação grava os arquivos nos diretórios:<br />
<b>Catraca Acesso</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/acesso<br />
</pre><br />
<b>Catraca Blantech</b><br />
<pre style="color: silver; background: black;"><br />
/VRFichaAPI/blantech<br />
</pre><br />
<br />
Para que os arquivos sejam disponibilizados em uma pasta compartilhada da rede, recomenda-se:<br />
<br />
1. Montar o compartilhamento SMB/Samba no sistema operacional host.<br />
2. Configurar um volume no Docker para mapear o diretório compartilhado para dentro do container.<br />
<br />
===<b>1. Montando um compartilhamento de rede no host</b>===<br />
* Cenário<br />
Considere um compartilhamento disponível na rede:<br />
<pre>\\192.168.1.100\ficha_entrada</pre><br />
ou<br />
<pre>\\SERVIDOR\ficha_entrada</pre><br />
<br />
O servidor pode ser:<br />
* Um computador Windows;<br />
* Um servidor Linux utilizando Samba;<br />
* Qualquer dispositivo que disponibilize compartilhamentos SMB.</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=Manual_do_Sistema_VR_Portal_Ferramentas&diff=49956Manual do Sistema VR Portal Ferramentas2026-03-10T13:28:05Z<p>Pedro.camargo: /* NOVIDADES DA VERSÃO */</p>
<hr />
<div>==<b>LOGIN E ALTERAÇÃO DE SENHA</b>==<br />
<br />
Ao logar com a senha antiga, o cliente sera obrigado a atualizar sua senha em "Esqueci minha senha"<br />
<br />
[[Arquivo:Login atualizacao termos.png|960px]]<br />
<br />
Em "Esqueci minha senha" o cliente precisará informar um CPF/CNPJ cadastrado.<br />
Fica obrigatório o cliente ter um e-mail cadastrado para receber o link de alteração de senha, caso contrário um mensagem será exibida para que o mesmo vá a uma loja mais próxima para atualizar seu cadastro.<br />
<br />
[[Arquivo:Esqueci senha.png|960px]]<br />
<br />
O cliente precisará entrar com o e-mail correspondente ao seu cadastro para receber o link de atualização de senha.<br />
<br />
[[Arquivo:Esqueci senha email.png|960px]]<br />
<br />
O link de alteração de senha o direcionará para esta tela.<br />
<br />
[[Arquivo:Token nova senha.png|960px]]<br />
<br />
==<b>CADASTRO ONLINE DE CLIENTES</b>==<br />
<br />
Para que um novo cliente cadastre-se em sua loja é necessário disponibilizar a página de cadastro online, para isso basta informar o endereço de seu VRPortal seguido do endereço /clientepreferencial.jsp.<br />
O cliente precisa aceitar o campo "Eu li e aceito os termos e condições de uso", para conseguir se cadastrar, este campo foi adicionado para atender a Lei Geral de Proteção de Dados Pessoais (LGPD). <br />
<br />
- Acesse o link de seu VRPortal, exemplo: http://"IP DO SERVIDOR":9090/clientepreferencial.jsp, ou clique no botão cadastrar na tela de login.<br />
<br />
[[Arquivo:Cliente preferencial.png|960px]]<br />
<br />
<br />
- Após o cliente realizar o cadastro, seu dados serão enviados para a [[Manual do sistema VR Master Cadastro CRM Cliente Preferencial Validação Web|ferramenta de validação de cadastro do VRMaster. Clique aqui para visualizar a ferramenta.]]<br />
<br />
==<b>CONSULTA DE SALDOS - CLIENTE PREFERENCIAL</b>==<br />
<br />
- Acesse o endereço configurado de seu portal.<br />
- Faça o login no sistema.<br />
- Clique no botão Crédito Rotativo.<br />
<br />
[[Arquivo:Tela inicial.png|960px]]<br />
<br />
<br />
- Nesta tela o cliente pode verificar online todas suas transações de seu Crédito Rotativo.<br />
<br />
[[Arquivo:Credito rotativo.png|960px]]<br />
<br />
==<b>CONSULTA DE SALDOS - CONVÊNIO</b>==<br />
<br />
- Acesse o endereço configurado de seu portal.<br />
- Faça o login no sistema.<br />
- Clique no botão Convênio.<br />
<br />
[[Arquivo:Tela inicial.png|960px]]<br />
<br />
<br />
- Nesta tela o cliente pode verificar online todas suas transações de seu Convênio.<br />
<br />
[[Arquivo:Convenio.png|960px]]<br />
<br />
==<b>ALTERAÇÃO DE SENHA</b>==<br />
<br />
- No menu canto superior direito, terá uma opção de alterar a senha.<br />
<br />
[[Arquivo:Logado alterar senha.png|960px]]<br />
<br />
[[Arquivo:Logado tela alterar senha.png|960px]]<br />
<br />
<br />
==<b>ALTERAR CADASTRO e LGPD</b>==<br />
<br />
- Para os clientes já cadastrados, para alterar seus dados é obrigatório o aceite em "EU li e aceito os termos e condições de uso".<br />
<br />
[[Arquivo:Logado cliente preferencial.png|960px]]<br />
<br />
- Após o aceite e salvar, estará disponível o link em "Lei Geral da Proteção dos Dados: Para solicitar alterações em seu cadastro" para atender a Lei Geral de Proteção de Dados Pessoais (LGPD), como descrito nas telas abaixo.<br />
- Com exceção do "REVOGAR ACEITE DO TERMO DE CONSENTIMENTO", todos os outros pedidos para atender a Lei Geral de Proteção de Dados Pessoais (LGPD) irá para validação antes de serem efeitvados. <br />
<br />
- REVOGAR ACEITE DO TERMO DE CONSENTIMENTO.<br />
<br />
[[Arquivo:Revogar termo aceite.png|960px]]<br />
<br />
[[Arquivo:Aceitar revogar termo aceite.png|960px]]<br />
<br />
- CONFIRMAÇÃO DA EXISTÊNCIA DE TRATAMENTO DE DADOS.<br />
<br />
[[Arquivo:Existencia tratamento dados.png|960px]]<br />
<br />
[[Arquivo:Aceite existencia tratamento dados.png|960px]]<br />
<br />
- SOLICITAR INFORMAÇÕES SOBRE O COMPARTILHAMENTO DE DADOS.<br />
<br />
[[Arquivo:Informacoes compartilhamento.png|960px]]<br />
<br />
[[Arquivo:Aceite informacoes compartilhamento.png|960px]]<br />
<br />
- SOLICITAR ANONIMIZAÇÃO DOS DADOS.<br />
<br />
[[Arquivo:Solicitar anonimizacao dados.png|960px]]<br />
<br />
[[Arquivo:Aceitar solicitar anonimizacao dados.png|960px]]<br />
<br />
- SOLICITAR EXCLUSÃO DOS DADOS.<br />
<br />
[[Arquivo:Exclusao dados.png|960px]]<br />
<br />
[[Arquivo:Aceite exclusao dados.png|960px]]<br />
<br />
- SOLICITAR BLOQUEIO DO TRATAMENTO DOS DADOS.<br />
<br />
[[Arquivo:Bloqueio.png|960px]]<br />
<br />
[[Arquivo:Aceite bloqueio.png|960px]]<br />
<br />
==<b>NOVIDADES DA VERSÃO</b>==<br />
<br />
<b>Campo Clube de Vantagens</b> <br />
<br />
Dentro do VRPortal, no cadastro de clientes, foi inserido o campo Clube de Vantagens, com a opção de marcar/desmarcar “PARTICIPA CLUBE DE VANTAGENS” e se sim, selecionar quais tipos de clube. Essa informação será inserida no cadastro do cliente preferencial, alimentando esse novo campo. <br />
[[Arquivo:ClubeVantagensVRPortal.png]]<br />
<br />
<b>Cadastro de Sexo</b> <br />
<br />
Dentro do VRPortal, no cadastro de clientes, foi inserido o campo "Sexo", onde é possível selecionar o gênero do cliente.<br />
<br />
[[Arquivo:SexoVRPortal.png]]</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=Manual_do_Sistema_VR_Portal_Ferramentas&diff=49955Manual do Sistema VR Portal Ferramentas2026-03-10T13:27:07Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>LOGIN E ALTERAÇÃO DE SENHA</b>==<br />
<br />
Ao logar com a senha antiga, o cliente sera obrigado a atualizar sua senha em "Esqueci minha senha"<br />
<br />
[[Arquivo:Login atualizacao termos.png|960px]]<br />
<br />
Em "Esqueci minha senha" o cliente precisará informar um CPF/CNPJ cadastrado.<br />
Fica obrigatório o cliente ter um e-mail cadastrado para receber o link de alteração de senha, caso contrário um mensagem será exibida para que o mesmo vá a uma loja mais próxima para atualizar seu cadastro.<br />
<br />
[[Arquivo:Esqueci senha.png|960px]]<br />
<br />
O cliente precisará entrar com o e-mail correspondente ao seu cadastro para receber o link de atualização de senha.<br />
<br />
[[Arquivo:Esqueci senha email.png|960px]]<br />
<br />
O link de alteração de senha o direcionará para esta tela.<br />
<br />
[[Arquivo:Token nova senha.png|960px]]<br />
<br />
==<b>CADASTRO ONLINE DE CLIENTES</b>==<br />
<br />
Para que um novo cliente cadastre-se em sua loja é necessário disponibilizar a página de cadastro online, para isso basta informar o endereço de seu VRPortal seguido do endereço /clientepreferencial.jsp.<br />
O cliente precisa aceitar o campo "Eu li e aceito os termos e condições de uso", para conseguir se cadastrar, este campo foi adicionado para atender a Lei Geral de Proteção de Dados Pessoais (LGPD). <br />
<br />
- Acesse o link de seu VRPortal, exemplo: http://"IP DO SERVIDOR":9090/clientepreferencial.jsp, ou clique no botão cadastrar na tela de login.<br />
<br />
[[Arquivo:Cliente preferencial.png|960px]]<br />
<br />
<br />
- Após o cliente realizar o cadastro, seu dados serão enviados para a [[Manual do sistema VR Master Cadastro CRM Cliente Preferencial Validação Web|ferramenta de validação de cadastro do VRMaster. Clique aqui para visualizar a ferramenta.]]<br />
<br />
==<b>CONSULTA DE SALDOS - CLIENTE PREFERENCIAL</b>==<br />
<br />
- Acesse o endereço configurado de seu portal.<br />
- Faça o login no sistema.<br />
- Clique no botão Crédito Rotativo.<br />
<br />
[[Arquivo:Tela inicial.png|960px]]<br />
<br />
<br />
- Nesta tela o cliente pode verificar online todas suas transações de seu Crédito Rotativo.<br />
<br />
[[Arquivo:Credito rotativo.png|960px]]<br />
<br />
==<b>CONSULTA DE SALDOS - CONVÊNIO</b>==<br />
<br />
- Acesse o endereço configurado de seu portal.<br />
- Faça o login no sistema.<br />
- Clique no botão Convênio.<br />
<br />
[[Arquivo:Tela inicial.png|960px]]<br />
<br />
<br />
- Nesta tela o cliente pode verificar online todas suas transações de seu Convênio.<br />
<br />
[[Arquivo:Convenio.png|960px]]<br />
<br />
==<b>ALTERAÇÃO DE SENHA</b>==<br />
<br />
- No menu canto superior direito, terá uma opção de alterar a senha.<br />
<br />
[[Arquivo:Logado alterar senha.png|960px]]<br />
<br />
[[Arquivo:Logado tela alterar senha.png|960px]]<br />
<br />
<br />
==<b>ALTERAR CADASTRO e LGPD</b>==<br />
<br />
- Para os clientes já cadastrados, para alterar seus dados é obrigatório o aceite em "EU li e aceito os termos e condições de uso".<br />
<br />
[[Arquivo:Logado cliente preferencial.png|960px]]<br />
<br />
- Após o aceite e salvar, estará disponível o link em "Lei Geral da Proteção dos Dados: Para solicitar alterações em seu cadastro" para atender a Lei Geral de Proteção de Dados Pessoais (LGPD), como descrito nas telas abaixo.<br />
- Com exceção do "REVOGAR ACEITE DO TERMO DE CONSENTIMENTO", todos os outros pedidos para atender a Lei Geral de Proteção de Dados Pessoais (LGPD) irá para validação antes de serem efeitvados. <br />
<br />
- REVOGAR ACEITE DO TERMO DE CONSENTIMENTO.<br />
<br />
[[Arquivo:Revogar termo aceite.png|960px]]<br />
<br />
[[Arquivo:Aceitar revogar termo aceite.png|960px]]<br />
<br />
- CONFIRMAÇÃO DA EXISTÊNCIA DE TRATAMENTO DE DADOS.<br />
<br />
[[Arquivo:Existencia tratamento dados.png|960px]]<br />
<br />
[[Arquivo:Aceite existencia tratamento dados.png|960px]]<br />
<br />
- SOLICITAR INFORMAÇÕES SOBRE O COMPARTILHAMENTO DE DADOS.<br />
<br />
[[Arquivo:Informacoes compartilhamento.png|960px]]<br />
<br />
[[Arquivo:Aceite informacoes compartilhamento.png|960px]]<br />
<br />
- SOLICITAR ANONIMIZAÇÃO DOS DADOS.<br />
<br />
[[Arquivo:Solicitar anonimizacao dados.png|960px]]<br />
<br />
[[Arquivo:Aceitar solicitar anonimizacao dados.png|960px]]<br />
<br />
- SOLICITAR EXCLUSÃO DOS DADOS.<br />
<br />
[[Arquivo:Exclusao dados.png|960px]]<br />
<br />
[[Arquivo:Aceite exclusao dados.png|960px]]<br />
<br />
- SOLICITAR BLOQUEIO DO TRATAMENTO DOS DADOS.<br />
<br />
[[Arquivo:Bloqueio.png|960px]]<br />
<br />
[[Arquivo:Aceite bloqueio.png|960px]]<br />
<br />
==<b>NOVIDADES DA VERSÃO</b>==<br />
<br />
<b>Campo Clube de Vantagens</b> <br />
<br />
Dentro do VRPortal, no cadastro de clientes, foi inserido o campo Clube de Vantagens, com a opção de marcar/desmarcar “PARTICIPA CLUBE DE VANTAGENS” e se sim, selecionar quais tipos de clube. Essa informação será inserida no cadastro do cliente preferencial, alimentando esse novo campo. <br />
[[Arquivo:ClubeVantagensVRPortal.png]]<br />
<br />
<b>Cadastro de Sexo</b><br />
<br />
Dentro do VRPortal, no cadastro de clientes, foi inserido o campo "Sexo", onde é possível selecionar o gênero do cliente.<br />
<br />
[[Arquivo:SexoVRPortal.png]]</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49647INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-15T13:38:32Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1IveDipmX6nCQTxPtefcDwGVtdfSlr-ea/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo <b>vr.properties</b> está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>C:\vr</b> ou <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em um local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
<br />
<b>Windows</b><br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor.<br />
* No atalho da área de trabalho, clique com o botão direito e selecione “Propriedades”.<br />
* No campo “Destino”, informe o comando -jar apontando para o Java 11:<br />
"C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
* Clique em OK.<br />
* O serviço será executado localmente utilizando o JDK Java versão 11.<br />
<br />
<b>Linux (VRUbuntu)</b><br />
* Crie o script que será chamado pelo atalho:<br />
nano /vr/exec/VRFichaMobileImpressao.sh<br />
* Conteúdo do arquivo:<br />
<pre><br />
#!/bin/bash<br />
/vr/jdk-11.0.7/bin/java -jar /vr/exec/VRFichaMobileImpressao.war<br />
</pre><br />
* Salve o arquivo e torne-o executável:<br />
chmod +x /vr/exec/VRFichaMobileImpressao.sh<br />
* Crie o atalho gráfico na área de trabalho do usuário:<br />
nano ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Insira o conteúdo abaixo:<br />
<pre><br />
[Desktop Entry]<br />
Type=Application<br />
Name=VRFicha Mobile Impressão<br />
Comment=Serviço de impressão VRFicha Mobile<br />
Exec=/vr/exec/VRFichaMobileImpressao.sh<br />
Icon=utilities-terminal<br />
Terminal=true<br />
Categories=Utility;<br />
</pre><br />
<br />
* Torne o arquivo .desktop executável:<br />
chmod +x ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Permitir execução no Ubuntu: Na primeira execução, clique com o botão direito no atalho e selecione “Permitir execução” (ou “Allow Launching”)<br />
* Dê duplo clique no atalho VRFicha Mobile Impressão<br />
* O serviço será iniciado em um terminal, utilizando o Java 11<br />
<h4>Observações importantes</h4><br />
* O caminho do Java (/vr/jdk-11.0.7/bin/java) deve existir e apontar para o Java 11<br />
* Caso utilize o Java instalado via sistema (/usr/bin/java), o script pode ser ajustado<br />
* O serviço será encerrado ao fechar o terminal</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49645INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-15T13:37:16Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1IveDipmX6nCQTxPtefcDwGVtdfSlr-ea/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em um local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
<br />
<b>Windows</b><br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor.<br />
* No atalho da área de trabalho, clique com o botão direito e selecione “Propriedades”.<br />
* No campo “Destino”, informe o comando -jar apontando para o Java 11:<br />
"C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
* Clique em OK.<br />
* O serviço será executado localmente utilizando o JDK Java versão 11.<br />
<br />
<b>Linux (VRUbuntu)</b><br />
* Crie o script que será chamado pelo atalho:<br />
nano /vr/exec/VRFichaMobileImpressao.sh<br />
* Conteúdo do arquivo:<br />
<pre><br />
#!/bin/bash<br />
/vr/jdk-11.0.7/bin/java -jar /vr/exec/VRFichaMobileImpressao.war<br />
</pre><br />
* Salve o arquivo e torne-o executável:<br />
chmod +x /vr/exec/VRFichaMobileImpressao.sh<br />
* Crie o atalho gráfico na área de trabalho do usuário:<br />
nano ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Insira o conteúdo abaixo:<br />
<pre><br />
[Desktop Entry]<br />
Type=Application<br />
Name=VRFicha Mobile Impressão<br />
Comment=Serviço de impressão VRFicha Mobile<br />
Exec=/vr/exec/VRFichaMobileImpressao.sh<br />
Icon=utilities-terminal<br />
Terminal=true<br />
Categories=Utility;<br />
</pre><br />
<br />
* Torne o arquivo .desktop executável:<br />
chmod +x ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Permitir execução no Ubuntu: Na primeira execução, clique com o botão direito no atalho e selecione “Permitir execução” (ou “Allow Launching”)<br />
* Dê duplo clique no atalho VRFicha Mobile Impressão<br />
* O serviço será iniciado em um terminal, utilizando o Java 11<br />
<h4>Observações importantes</h4><br />
* O caminho do Java (/vr/jdk-11.0.7/bin/java) deve existir e apontar para o Java 11<br />
* Caso utilize o Java instalado via sistema (/usr/bin/java), o script pode ser ajustado<br />
* O serviço será encerrado ao fechar o terminal</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49575INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:12:22Z<p>Pedro.camargo: /* INICIALIZAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em um local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
<br />
<b>Windows</b><br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor.<br />
* No atalho da área de trabalho, clique com o botão direito e selecione “Propriedades”.<br />
* No campo “Destino”, informe o comando -jar apontando para o Java 11:<br />
"C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
* Clique em OK.<br />
* O serviço será executado localmente utilizando o JDK Java versão 11.<br />
<br />
<b>Linux (VRUbuntu)</b><br />
* Crie o script que será chamado pelo atalho:<br />
nano /vr/exec/VRFichaMobileImpressao.sh<br />
* Conteúdo do arquivo:<br />
<pre><br />
#!/bin/bash<br />
/vr/jdk-11.0.7/bin/java -jar /vr/exec/VRFichaMobileImpressao.war<br />
</pre><br />
* Salve o arquivo e torne-o executável:<br />
chmod +x /vr/exec/VRFichaMobileImpressao.sh<br />
* Crie o atalho gráfico na área de trabalho do usuário:<br />
nano ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Insira o conteúdo abaixo:<br />
<pre><br />
[Desktop Entry]<br />
Type=Application<br />
Name=VRFicha Mobile Impressão<br />
Comment=Serviço de impressão VRFicha Mobile<br />
Exec=/vr/exec/VRFichaMobileImpressao.sh<br />
Icon=utilities-terminal<br />
Terminal=true<br />
Categories=Utility;<br />
</pre><br />
<br />
* Torne o arquivo .desktop executável:<br />
chmod +x ~/Desktop/VRFichaMobileImpressao.desktop<br />
* Permitir execução no Ubuntu: Na primeira execução, clique com o botão direito no atalho e selecione “Permitir execução” (ou “Allow Launching”)<br />
* Dê duplo clique no atalho VRFicha Mobile Impressão<br />
* O serviço será iniciado em um terminal, utilizando o Java 11<br />
<h4>Observações importantes</h4><br />
* O caminho do Java (/vr/jdk-11.0.7/bin/java) deve existir e apontar para o Java 11<br />
* Caso utilize o Java instalado via sistema (/usr/bin/java), o script pode ser ajustado<br />
* O serviço será encerrado ao fechar o terminal</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49574INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:04:07Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49573INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:03:32Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui]. Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49572INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:03:19Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49571INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:03:03Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49570INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:02:50Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<br />
<pre><br />
<b>vr.properties</b><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49569INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T15:01:34Z<p>Pedro.camargo: /* TIPOS DE IMPRESSÃO */</p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
<h4>Lógica de Impressão</h4><br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso esteja configurado um caminho UNC <i>(\\servidor\impressora)</i> a aplicação fará a impressão via caminho de rede. <b>ATENÇÃO:</b> impressão via caminho de rede <i>(\\servidor\impressora)</i> só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49568INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T14:57:16Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o <b>VRFicha Mobile Impressão</b> funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso o caminho configurado seja um cainho de rede no formato \\servidor\impressora a aplicação fará a impressão utilizando este caminho. <b>ATENÇÃO:</b> impressão via caminho UNC só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_MOBILE_IMPRESSAO&diff=49567INSTALACAO VRFICHA MOBILE IMPRESSAO2026-01-14T14:57:01Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS</b>==<br />
Para que o VRFicha Mobile Impressão funcione corretamente, é necessário que:<br />
* Haja o ambiente do VRFicha Mobile instalado e configurado corretamente.<br />
* Haja um sistema de mensageria (RabbitMQ) instalado e configurado corretamente.<br />
* A API do VR Ficha Mobile esteja conectado ao banco de dados e a fila do RabbitMQ corretamente.<br />
* A API do VR Ficha Mobile e o serviço <b>VRFicha Mobile Impressão</b> estejam conectados ao mesmo RabbitMQ.<br />
<br />
O servidor onde o serviço irá rodar deve possuir os seguintes requisitos mínimos:<br />
* Sistema Operacional: Windows ou VR Ubuntu 22.04 LTS<br />
* Processador: 2 vCPU<br />
* Memória RAM: 4 GB<br />
* Disco: 40 GB<br />
<br />
==<b>TIPOS DE IMPRESSÃO</b>==<br />
O serviço <b>VRFicha Mobile Impressão</b> tem suporte a 3 tipos de impressão:<br />
* Impressão via caminho UNC Windows<br />
Utiliza um caminho de rede no formato \\servidor\impressora, delegando ao sistema operacional Windows o envio do trabalho para o spooler da impressora compartilhada. Esse modelo é exclusivo do Windows e depende do compartilhamento da impressora estar corretamente configurado e acessível na rede.<br />
<br />
* Impressão via nome de impressora instalada Windows<br />
Realiza a impressão utilizando o nome lógico de uma impressora previamente instalada no sistema operacional Windows. A aplicação envia o trabalho diretamente para o spooler local, permitindo maior controle, melhor tratamento de erros e compatibilidade com drivers específicos.<br />
<br />
* Impressão via CUPS (Linux e MacOS)<br />
Efetua a impressão através do serviço CUPS (Common UNIX Printing System), utilizando o nome da fila da impressora configurada no sistema. A aplicação interage com o spooler local do sistema operacional, garantindo compatibilidade multiplataforma e suporte a diversos protocolos de impressão.<br />
<br />
A aplicação irá capturar o caminho da impressora configurado no VRFicha e irá selecionar automaticamente o modo de impressão. Caso esteja configurado o nome da impressora, a aplicação utilizará o spooler local (Windows) ou CUPS (Linux). Caso o caminho configurado seja um cainho de rede no formato \\servidor\impressora a aplicação fará a impressão utilizando este caminho. <b>ATENÇÃO:</b> impressão via caminho UNC só funciona com o serviço de impressão rodando em Windows.<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
* Faça o download do arquivo WAR do serviço de impressão [https://drive.google.com/file/d/1421CTyW_YAAjYRZ_l4lt7weeSawFEQDN/view?usp=sharing clicando aqui].<br />
* Certifique-se de que o arquivo vr.properties está no diretório correto e com as informações corretas de conexão com o RabbitMQ (Diretório: <b>/vr</b>)<br />
<b>vr.properties</b><br />
<pre><br />
[FILA-IMPRESSAO-FICHA]<br />
fichaimpressao.fila.ip=[IP_DO_RABBITMQ]<br />
fichaimpressao.fila.porta=5672<br />
fichaimpressao.fila.usuario=vr<br />
fichaimpressao.fila.senha=vr!RbtMQ<br />
fichaimpressao.diagnostico.habilitado=false<br />
</pre><br />
<br />
* <b>fichaimpressao.fila.ip:</b> IP da máquina onde o RabbitMQ está rodando<br />
* <b>fichaimpressao.fila.porta:</b> Porta do serviço RabbitMQ<br />
* <b>fichaimpressao.fila.usuario:</b> Usuário do RabbitMQ<br />
* <b>fichaimpressao.fila.senha:</b> Senha do RabbitMQ<br />
* <b>fichaimpressao.diagnostico.habilitado:</b> Caso tenha os valores true/yes/1, irá exibir um diagnóstico do ambiente em cada impressão, caso contrário, não exibirá. Útil para verificar erros ao configurar o serviço e a impressão não funcionar.<br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Coloque o arquivo VRFichaMobileImpressao.war em algum local apropriado no servidor (recomendado: <b>C:\VR\EXEC</b> ou <b>/vr/exec</b>)<br />
* Crie um atalho do VRFichaMobileImpressao.war na área de trabalho do servidor<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRFichaMobileImpressao.war<br />
Clique em OK.<br />
<br />
* O serviço é executado localmente diretamente pelo JDK do Java na versão 11</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48461VR Coletor Mobile Instalacao2025-12-08T13:23:57Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é necessário verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrmobileserver.yml clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco de dados e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, o IP é o mesmo do servidor onde está rodando o VRMobileServer, e a porta é a configurada acima em <i>PORT</i>.<br />
* Clique em <b>Testar Conexão</b> e o aplicativo irá testar a conexão. Caso esteja ok, um ícone verde será exibido.<br />
* Clique em <b>Salvar Configuração</b> e então em <b>Sincronizar Informações</b> onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48460VR Coletor Mobile Instalacao2025-12-08T13:22:01Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é necessário verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco de dados e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, o IP é o mesmo do servidor onde está rodando o VRMobileServer, e a porta é a configurada acima em <i>PORT</i>.<br />
* Clique em <b>Testar Conexão</b> e o aplicativo irá testar a conexão. Caso esteja ok, um ícone verde será exibido.<br />
* Clique em <b>Salvar Configuração</b> e então em <b>Sincronizar Informações</b> onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48456VR Coletor Mobile Instalacao2025-12-08T13:11:03Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é necessário verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco de dados e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, o IP é o mesmo do servidor onde está rodando o VRMobileServer, e a porta é a configurada acima em <i>PORT</i>.<br />
* Clique em <b>Testar Conexão</b> e o aplicativo irá testar a conexão. Caso esteja ok, um ícone verde será exibido.<br />
* Clique em <b>Salvar Configuração</b> e então em <b>Sincronizar Informações</b> onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48455VR Coletor Mobile Instalacao2025-12-08T13:09:52Z<p>Pedro.camargo: /* INSTALAÇÃO 2: APLICAÇÃO VR MOBILE */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco de dados e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, o IP é o mesmo do servidor onde está rodando o VRMobileServer, e a porta é a configurada acima em <i>PORT</i>.<br />
* Clique em <b>Testar Conexão</b> e o aplicativo irá testar a conexão. Caso esteja ok, um ícone verde será exibido.<br />
* Clique em <b>Salvar Configuração</b> e então em <b>Sincronizar Informações</b> onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48454VR Coletor Mobile Instalacao2025-12-08T13:07:23Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco de dados e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48453VR Coletor Mobile Instalacao2025-12-08T13:07:01Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco e com o RabbitMQ<br />
* O parmâmetro <i>SYSTEM_NUMEROLOJA</i> serve para especificar o número da loja a se conectar<br />
* O parâmetro <i>COLETOR_KILO</i> serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=INSTALACAO_VRFICHA_API&diff=48452INSTALACAO VRFICHA API2025-12-08T13:05:36Z<p>Pedro.camargo: /* INSTALAÇÃO */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
Para que o VR Ficha API funcione corretamente de maneira consistente é necessário ter um computador com esta configuração ou superior:<br />
<br />
* VRUbuntu 20.04.0-1 (No Windows, utilizar o WSL)<br />
* Processador: i3 (5ª geração +) ou equivalente <br />
* Memória RAM: 8 GB<br />
* Disco: 80 GB<br />
* Docker instalado<br />
<br />
==<b>INSTALAÇÃO</b>==<br />
* '''<span style="color:red;">Certifique-se de que as configurações do VR Ubuntu foram todas executadas</span> [[VRUbuntu_Ferramentas|neste link]]'''<br />
* Certifique-se de que o Docker está instalando no sistema operacional na versão mais recente.<br />
* Faça o download do arquivo <b>docker-compose-vrfichaapi.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-vrfichaapi.yml clicando aqui]<br />
* Se o cliente já possuir o VR Service Manager rodando, o RabbitMQ do Service Manager pode ser utilizado, caso contrário, baixe o arquivo <b>docker-compose-rabbitmq.yml</b> [https://storage.googleapis.com/docker-compose-yml/docker-compose-rabbitmq.yml clicando aqui] para subir o sistema de mensageria no servidor onde ficará o VR Ficha API.<br />
* No arquivo <b>docker-compose-vrfichaapi.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. (Obs.: A conexão com o RabbitMQ configurada tem que ser a mesma no serviço de impressão dos pedidos, para que este funcione corretamente)<br />
<pre><br />
services:<br />
vrficha-api:<br />
image: vrsoftbr/vrfichaapi:4.1.10<br />
ports:<br />
- "9015:9015"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9015<br />
- DATABASE_IP=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja e os dados de conexão com o RabbitMQ. <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INICIALIZAÇÃO</b>==<br />
* Para iniciar a API, basta executar este comando, passando na flag <b>-f</b> o nome do arquivo yml (Executar comando no mesmo diretório onde o arquivo está)<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-vrfichaapi.yml up -d<br />
</pre><br />
<b><i>Obs: Será necessário estar autenticado no docker, pois a imagem é privada. Caso não esteja, executar o comando docker login e informar as credenciais</i></b><br />
* Caso seja necessário subir o RabbitMQ, executar o <b>docker compose</b> no arquivo do RabbitMQ também<br />
<pre style="color: silver; background: black;"><br />
docker compose -f docker-compose-rabbitmq.yml up -d<br />
</pre><br />
<br />
==<b>IMPRESSÃO DAS FICHAS</b>==<br />
* Para realizar a impressão das fichas, é necessário que o <b>VRFichaMobileImpressao</b> esteja sendo executado no servidor e conectado ao mesmo serviço do RabbitMQ em que a API do VRFicha Mobile está, pois ele irá consumir a fila do RabbitMQ e imprimir as fichas na impressora configurada no VRFicha. Você pode encontrar como configura-lo [[Manual do Sistema VR Ficha Mobile Impressao|clicando aqui]]</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48451VR Coletor Mobile Instalacao2025-12-08T13:02:28Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja em <i>SYSTEM_NUMEROLOJA</i>, a propriedade <i>COLETOR_KILO</i> que serve para que o aplicativo leia produtos kilo (Etiquetas), e os dados de conexão com o RabbitMQ. <br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48450VR Coletor Mobile Instalacao2025-12-08T13:00:07Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja em <i>SYSTEM_NUMEROLOJA</i>, a propriedade <i>COLETOR_KILO</i> que serve para que o aplicativo leia produtos kilo (Etiquetas), e os dados de conexão com o RabbitMQ. <br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48449VR Coletor Mobile Instalacao2025-12-08T12:59:33Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o <b>VR Mobile Server</b> funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja em <i>SYSTEM_NUMEROLOJA</i>, a propriedade <i>COLETOR_KILO</i> que serve para que o aplicativo leia produtos kilo (Etiquetas), e os dados de conexão com o RabbitMQ. <br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48448VR Coletor Mobile Instalacao2025-12-08T12:56:32Z<p>Pedro.camargo: /* INSTALAÇÃO 1: VR MOBILE SERVER - DESCONTINUADO */</p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o VR Mobile Server funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Acesse o servidor de aplicação do cliente. Dentro do servidor, escolher um diretório para colocar os arquivos de configuração (caso o cliente utilize Service Manager, colocar na mesma pasta). OBS: Faça o download do arquivo para subir o VRMobileServer [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* Caso o cliente não possua o Service Manager rodando, será necessário subir também um serviço do RabbitMQ ao qual o VRMobileServer irá se conectar. Faça o download do arquivo para subir o RabbitMQ [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
<br />
* No arquivo <b>docker-compose-vrmobileserver.yml</b> é configurado a <b>porta de comunicação</b> com a API, a <b>conexão com o banco de dados</b> e a <b>conexão com o RabbitMQ</b>. A <b>porta de comunicação</b> configurada será informada no aplicativo para se conectar ao servidor, junto ao IP do computador onde está rodando o servidor.<br />
<pre><br />
services:<br />
vrmobileserver:<br />
image: vrsoftbr/vrmobileserver:4.3.34<br />
ports:<br />
- "9016:9016"<br />
environment:<br />
- TZ=GMT-3<br />
- PORT=9016<br />
- DATABASE_IP=<br />
- DATABASE_IP_SEC=<br />
- DATABASE_PORTA=<br />
- DATABASE_NOME=<br />
- DATABASE_USUARIO=<br />
- DATABASE_SENHA=<br />
- SYSTEM_NUMEROLOJA=<br />
- COLETOR_KILO=true<br />
- RABBITMQ_IP=<br />
- RABBITMQ_PORTA=<br />
- RABBITMQ_USUARIO=<br />
- RABBITMQ_SENHA=<br />
volumes:<br />
- ./VRMobileServer:/VRMobileServer/VRMobileServer<br />
networks:<br />
- vr-network<br />
<br />
networks:<br />
vr-network:<br />
external: true<br />
</pre><br />
* Você deve preencher corretamente os dados de conexão com o banco, o numero da loja em <i>SYSTEM_NUMEROLOJA</i>, a propriedade <i>COLETOR_KILO</i> que serve para que o aplicativo leia produtos kilo (Etiquetas), e os dados de conexão com o RabbitMQ. <br />
* <b>Não é mais utilizado vr.properties</b>. A configuração é feita diretamente no arquivo de compose do docker.<br />
* Caso seja necessário alterar a porta, alterar em environment o valor de <i>PORT</i>, e também alterar as portas em <i>ports</i><br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=VR_Coletor_Mobile_Instalacao&diff=48447VR Coletor Mobile Instalacao2025-12-08T12:45:38Z<p>Pedro.camargo: </p>
<hr />
<div>==<b>REQUISITOS MÍNIMOS</b>==<br />
O aplicativo VR Mobile está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.1. Recomendamos que o aparelho tenha no mínimo 2GB de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300MB).<br />
<br />
Para que o VR Mobile Server funcione corretamente é necessário ter um computador com esta configuração mínima ou superior:<br />
<br />
* Sistemas Operacionais Compatíveis: Windows Server 2008 ou acima, Windows 7, Windows 10 ou VRUbuntu 20.04.0-1.<br />
* Ambiente: é necessário que o sistema operacional permita virtualização e tenha Docker instalado e pronto para uso<br />
* Processador: 2 GHz Dual Core ou acima<br />
* Memória RAM: 4 GB<br />
* Espaço mínimo em disco para instalação: 1 GB<br />
<br />
==<b>INSTALAÇÃO 1: VR MOBILE SERVER - DESCONTINUADO</b>==<br />
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " " --><br />
* Primeiro é verificar junto ao comercial (Executivo de vendas do cliente) se o mesmo possui a licença para utilização da ferramenta. Caso tenha poderá acessar o VRGestor para confirmar a licença para uso.<br />
<br />
* Acesse o servidor de aplicação do cliente. Dentro da pasta C:\VR do servidor descompacte (botão direito no arquivo e "Extrair Aqui") o arquivo java 11. OBS: Faça o download do arquivo JAVA 11 [https://drive.google.com/drive/folders/1-xc9e-CtA6sl8vkq9MB4VX7qLHXwlOYl clicando aqui].<br />
Obs: Verifique antes se o servidor é 32 ou 64 Bits.<br />
<br />
* Acessando a pasta "C:\VR\EXEC" ou "C:\USER\VR\EXEC" do servidor de aplicação, crie um atalho do "VRMobileServer" na área de trabalho do servidor de aplicação.<br />
* No atalho da área de trabalho clique com o botão direito depois clique em "Propriedades".<br />
* No campo "Destino" colocar o comando -jar com o caminho do java 11, ficando dessa forma a linha:<br />
Destino: "C:\vr\jdk-11.0.7\bin\java.exe" -jar C:\vr\exec\VRMobileServer.jar<br />
Clique em OK.<br />
<br />
* Dentro do vrproperties do <b>"C:\VR ou "C:\USER\VR"</b> do servidor de aplicação, insira as linhas abaixo e salve:<br />
coletormobile.portaservidor = 7002<br />
coletorserver.kilo = TRUE<br />
<br />
* <b>OBSERVAÇÃO:</b><br />
coletormobile.portaservidor = 7002 - Serve para configurar a porta do VRColetorMobileServer.<br />
coletorserver.kilo = TRUE - Serve para que o aplicativo leia produtos kilo (Etiquetas).<br />
<br />
* Abra a aplicação do VRMobileServer que você colocou o atalho. Se ele não estiver aberto, o aplicativo do celular não comunicará.<br />
<br />
* Ao abrir, aparecerá uma tela do DOS e no final dela aparecerá o IP e porta como no exemplo abaixo:<br />
<br />
[[Arquivo:VRColetorMobileServer.png|700px]]<br />
<br />
==<b>INSTALAÇÃO 2: APLICAÇÃO VR MOBILE </b>==<br />
O VR Mobile está disponível para sistemas Android e iOS.<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a PlayStore ou [https://play.google.com/store/apps/details?id=br.com.vrsoftware.vrcoletormobile clicando aqui].<br />
<br />
* Baixe o aplicativo do VR Mobile, acessando a AppleStore ou [https://apps.apple.com/ge/app/vr-mobile/id1575274668 clicando aqui].<br />
<br />
<b>OBS:</b> Caso o aparelho não tenha Playstore, solicite ao suporte [https://vrsoftware.movidesk.com/Account/Login clicando aqui].<br />
<br />
* Instale o VR Mobile e abra o aplicativo. O mesmo solicitará IP e Porta, que é o mesmo informado acima ao abrir o VRMobileServer.<br />
* Clique em <b>CONECTAR AO SERVIDOR</b>, onde o aparelho sincronizará as informações.<br />
<br />
* O aplicativo está instalado e configurado. O VR Mobile usa o mesmo usuário do VRMaster, sendo uma permissão necessária para utilização.<br />
<br />
Liberar em "VRMaster -> Cadastro -> Operacional -> Usuário"<br />
<br />
<br />
<b>Caso tenha alguma dúvida, estamos a disposição pelo chat</b> [https://vrsoftware.movidesk.com/Account/Login clicando aqui].</div>Pedro.camargohttp://wiki.vrsoft.com.br//wiki/index.php?title=Manual_do_Sistema_VR_Coletor_Mobile&diff=48446Manual do Sistema VR Coletor Mobile2025-12-08T12:44:19Z<p>Pedro.camargo: </p>
<hr />
<div>[[Arquivo:VR-Coletor.png|left|120px]]<br />
<br />
O VR Mobile é um aplicativo Mobile, criado para otimizar os processos operacionais do supermercado. Por meio deste aplicativo, é possível realizar a coleta de produtos para balanço, perda, quebra, troca, recebimento de mercadoria, entre outras rotinas e transmiti-las para o VR Master, pois trata-se de um aplicativo totalmente integrado com o ERP VR. Também é possível consultar relatórios administrativos, financeiros, administrar preço, consultar produtos, tudo de forma prática direto pelo aplicativo.<br />
<br />
<br />
REQUISITOS MÍNIMOS:<br />
O aplicativo está disponível para instalação em aparelhos móveis com sistemas operacionais Android, a partir da versão 8.0. Recomendamos que o aparelho tenha no mínimo 2Gb de RAM e espaço de armazenamento suficiente para instalação do aplicativo (Por volta de 300Mb).<br />
<br />
<br><br />
<br><br />
<br />
<div><br />
<ul> <br />
<li style="display: inline-block;"><table style="line-heigth: 130%; font-size: 80%; border: 1px; padding: 3px; width: 120px; height: 120px;"><tr style="background: none;"><th style="border: none; background: #f6f6f6; border-radius: 10px;">Instalação e Configuração<br> [[Arquivo:Instalacao_e_Configuracao.png|120px|link=VR Coletor Mobile Instalacao]]</th></tr></table></li><br />
<li style="display: inline-block;"><table style="line-heigth: 130%; font-size: 80%; border: 1px; padding: 3px; width: 120px; height: 120px;"><tr style="background: none;"><th style="border: none; background: #f6f6f6; border-radius: 10px;">Ferramentas<br><br> [[Arquivo:Ferramenta.png|120px|link= Manual do Aplicativo VRColetor Mobile Versoes]]</th></tr></table></li><br />
</ul><br />
</div></div>Pedro.camargo