Mudanças entre as edições de "VRGerenciadorMercaFacil Instalacao"

De VRWiki
(INSTALAÇÃO)
 
(11 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 
==<b>INSTALAÇÃO</b>==
 
==<b>INSTALAÇÃO</b>==
 
Para que a execução do VRGerenciadorMercaFacil possa ser executada de forma automática, é necessário que seja configurado um arquivo de execução <code>.bat</code>. Abaixo há um exemplo de criação do arquivo, onde a aplicação será executada a cada 6 horas e em cada execução, após a concluir as atividades a aplicação será encerrada automaticamente:
 
Para que a execução do VRGerenciadorMercaFacil possa ser executada de forma automática, é necessário que seja configurado um arquivo de execução <code>.bat</code>. Abaixo há um exemplo de criação do arquivo, onde a aplicação será executada a cada 6 horas e em cada execução, após a concluir as atividades a aplicação será encerrada automaticamente:
 +
 +
'''Observação:''' No VRGerenciadorMercafacil versão '''4.1''', o envio das '''vendas''' não será mais feito pelo PDV. O VRGerenciadorMercafacil que enviará as vendas efetuadas, portanto o ideal é configurar com '''60''' segundos de execução o <code>.bat</code>, para que possa ser enviado constantemente as vendas.
  
 
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " "  -->
 
<!-- Espaços em branco não funcionam no trecho abaixo, copiar e colar este carácter -> " "  -->
Linha 17: Linha 19:
 
==<b>CONFIGURAÇÃO</b>==
 
==<b>CONFIGURAÇÃO</b>==
 
Para que o VRGerenciadorMercaFacil seja configurado com um '''Token''' previamente adquirido, será necessário que ele seja adicionado na primeira execução da aplicação, a adição do '''Token''' será realizada através do comando <code>java -jar VRGerenciadorMercaFacil.jar -config</code>, aonde será solicitado a senha <code>ADMLOJA[id da loja]</code>.
 
Para que o VRGerenciadorMercaFacil seja configurado com um '''Token''' previamente adquirido, será necessário que ele seja adicionado na primeira execução da aplicação, a adição do '''Token''' será realizada através do comando <code>java -jar VRGerenciadorMercaFacil.jar -config</code>, aonde será solicitado a senha <code>ADMLOJA[id da loja]</code>.
 +
 +
'''Token''': Deverá ser informado o Token de autenticação fornecido pela Mercafacil. Ex.: <code>siel9dad4rrn4i903qwdfcsvw4ezarug72zcq74g</code>
  
 
   [[Arquivo:Token_config.PNG]]
 
   [[Arquivo:Token_config.PNG]]
 +
 +
 +
'''Parametros de inicialização'''
 +
 +
'''-cargainicial''' comando que ativa o envio da carga inicial. Essa carga compreende, Produto, Operador e Vendas dos últimos 2 anos.
 +
'''Observação:'''Na versão '''4.1''' é somente os últimos '''6''' meses.
 +
 +
'''-produto''' comando que ativa o envio apenas da carga inicial de produtos.
 +
 +
'''-operador''' comando que ativa o envio apenas da carga inicial de operador.
 +
 +
'''-venda''' comando que ativa o envio apenas da carga inicial de vendas (Não leva em consideração o '''gerenciadormercafacil.limiteregistrosvenda''', leva em consideração a mesma regra do '''-cargainicial''', mas apenas para vendas, procurando na tabela '''pdv.venda''').
 +
 +
'''-vendapdv''' comando que ativa o envio das vendas para a Mercafacil (Leva em consideração as vendas da tabela '''pdv.venda''' e não da tabela '''mercafacil.vendaefetuada'''. Esse parâmetro também considera a linha '''gerenciadormercafacil.limiteregistrosvenda''' do '''vr.properties'''). Esse parâmetro só será utilizado em casos muito específicos, quando o cliente quiser enviar vendas dos últimos X dias para a Mercafacil mesmo que elas não tenham desconto Mercafacil.
 +
 +
'''-log''' comando que ativa a gravação de log's dos JSON's enviados a Mercafacil em '''\vr\log\vrgerenciadormercafacil\'''.
 +
 +
'''ATENÇÃO:''' Todos os comandos acima devem ser executados fora do arquivo '''.bat'''.
 +
 +
'''Parametros Configuráveis'''
 +
'''Dias Retroativos ->''' Quantidade de dias retroativos ao realizar o processo de contingencia. Por padrão esse valor é 5 e pode ser alterado atraves do vr.properties com a linha '''gerenciadormercafacil.diasretroativos''', vale lembrar que serão consideradas as vendas da tabela '''mercafacil.vendaefetuada'''.
 +
 +
'''Limite de Registros Exportacao Venda ->''' Quantidade de registros de venda que serão enviados por vez a MercaFacil a fim de nao causar travamentos na base. Por padrão esse valor é 1000 e pode ser alterado atraves do vr.properties com a linha '''gerenciadormercafacil.limiteregistrosvenda'''.
 +
 +
'''Limite de Registros Exportacao ->''' Quantidade de registros que serão enviados por vez a MercaFacil a fim de nao causar travamentos na base. Por padrão esse valor é 10000 e pode ser alterado atraves do vr.properties com a linha '''gerenciadormercafacil.limiteregistros'''.
  
 
+
'''Homologação ->''' Define o ambiente em que o gerenciador irá trabalhar Homologação ou Produção. Por padrão o ambiente é Produção e pode ser alterado atraves do vr.properties com a linha '''gerenciadormercafacil.homologacao''' = '''TRUE''' ou '''FALSE'''.
  - '''Token''': Deverá ser informado o Token de autenticação fornecido pela Mercafacil. Ex.: <code>siel9dad4rrn4i903qwdfcsvw4ezarug72zcq74g</code>
 
 
 
   
 
  [[Arquivo:VRGerenciadorMercafacil_configuracao_parametros.png]]
 

Edição atual tal como às 19h34min de 11 de abril de 2022

INSTALAÇÃO

Para que a execução do VRGerenciadorMercaFacil possa ser executada de forma automática, é necessário que seja configurado um arquivo de execução .bat. Abaixo há um exemplo de criação do arquivo, onde a aplicação será executada a cada 6 horas e em cada execução, após a concluir as atividades a aplicação será encerrada automaticamente:

Observação: No VRGerenciadorMercafacil versão 4.1, o envio das vendas não será mais feito pelo PDV. O VRGerenciadorMercafacil que enviará as vendas efetuadas, portanto o ideal é configurar com 60 segundos de execução o .bat, para que possa ser enviado constantemente as vendas.

    cd /d C:\vr\

    :loop
    %JAVA_HOME% -jar -Dfile.encoding=UTF-8 C:\vr\exec\VRGerenciadorMercaFacil.jar
    timeout /t 21600
    goto loop

    pause
    END

CONFIGURAÇÃO

Para que o VRGerenciadorMercaFacil seja configurado com um Token previamente adquirido, será necessário que ele seja adicionado na primeira execução da aplicação, a adição do Token será realizada através do comando java -jar VRGerenciadorMercaFacil.jar -config, aonde será solicitado a senha ADMLOJA[id da loja].

Token: Deverá ser informado o Token de autenticação fornecido pela Mercafacil. Ex.: siel9dad4rrn4i903qwdfcsvw4ezarug72zcq74g

 Token config.PNG

Parametros de inicialização

-cargainicial comando que ativa o envio da carga inicial. Essa carga compreende, Produto, Operador e Vendas dos últimos 2 anos. Observação:Na versão 4.1 é somente os últimos 6 meses.

-produto comando que ativa o envio apenas da carga inicial de produtos.

-operador comando que ativa o envio apenas da carga inicial de operador.

-venda comando que ativa o envio apenas da carga inicial de vendas (Não leva em consideração o gerenciadormercafacil.limiteregistrosvenda, leva em consideração a mesma regra do -cargainicial, mas apenas para vendas, procurando na tabela pdv.venda).

-vendapdv comando que ativa o envio das vendas para a Mercafacil (Leva em consideração as vendas da tabela pdv.venda e não da tabela mercafacil.vendaefetuada. Esse parâmetro também considera a linha gerenciadormercafacil.limiteregistrosvenda do vr.properties). Esse parâmetro só será utilizado em casos muito específicos, quando o cliente quiser enviar vendas dos últimos X dias para a Mercafacil mesmo que elas não tenham desconto Mercafacil.

-log comando que ativa a gravação de log's dos JSON's enviados a Mercafacil em \vr\log\vrgerenciadormercafacil\.

ATENÇÃO: Todos os comandos acima devem ser executados fora do arquivo .bat.

Parametros Configuráveis Dias Retroativos -> Quantidade de dias retroativos ao realizar o processo de contingencia. Por padrão esse valor é 5 e pode ser alterado atraves do vr.properties com a linha gerenciadormercafacil.diasretroativos, vale lembrar que serão consideradas as vendas da tabela mercafacil.vendaefetuada.

Limite de Registros Exportacao Venda -> Quantidade de registros de venda que serão enviados por vez a MercaFacil a fim de nao causar travamentos na base. Por padrão esse valor é 1000 e pode ser alterado atraves do vr.properties com a linha gerenciadormercafacil.limiteregistrosvenda.

Limite de Registros Exportacao -> Quantidade de registros que serão enviados por vez a MercaFacil a fim de nao causar travamentos na base. Por padrão esse valor é 10000 e pode ser alterado atraves do vr.properties com a linha gerenciadormercafacil.limiteregistros.

Homologação -> Define o ambiente em que o gerenciador irá trabalhar Homologação ou Produção. Por padrão o ambiente é Produção e pode ser alterado atraves do vr.properties com a linha gerenciadormercafacil.homologacao = TRUE ou FALSE.