> For the complete documentation index, see [llms.txt](https://docs.vrsoft.com.br/vrmaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vrsoft.com.br/vrmaster/releases/releases-2024/manual-do-sistema-vr-gerenciador-mercafacil/vrgerenciadormercafacil-instalacao.md).

# Instalação e Configuração

## **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`

![](/files/6pVkX60ecdZ84WRkAWYa)

**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**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vrsoft.com.br/vrmaster/releases/releases-2024/manual-do-sistema-vr-gerenciador-mercafacil/vrgerenciadormercafacil-instalacao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.