# Novo Agente

Manual, procedimentos e configurações do Novo Agente. Aplicação em node responsável por integrar dispositivos offline com a plataforme a plataforma em nuvem Novo Avanço

# Manual de Preparação e Adaptação do NovoAgente no PDV Debian ( 64 bits )

Este manual descreve o passo a passo necessário para preparar o ambiente do PDV Debian e garantir o correto funcionamento do **novoagente ( para versão 64 bits )**

---

## 🧩 **1. Verificação dos arquivos de execução**

### **1.1. Arquivo `forcarvendas.sh`**

- **Diretório esperado:** `/u/bats`
- **Permissão necessária:**
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-bg-elevated-secondary text-token-text-secondary flex items-center gap-4 rounded-sm px-2 font-sans text-xs">  
    </div></div></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-built_in">chmod</span> 777 forcarvendas.sh`</div></div>
- **Caso o arquivo não exista:**  
    [Faça o download da BAT - Clique aqui](https://novo-app.s3.us-east-1.amazonaws.com/production/download/arquivos_novoagente/forcarvendas.sh)

---

### **1.2. Arquivo `checa-novoagente-executando.sh`**

- **Diretório esperado:** `/u/pdv/novoAvanco/`
- **Permissão necessária:**
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-bg-elevated-secondary text-token-text-secondary flex items-center gap-4 rounded-sm px-2 font-sans text-xs">  
    </div></div></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-built_in">chmod</span> 777 checa-novoagente-executando.sh`</div></div>
- **Caso o arquivo não exista:**  
    [Faça o download da BAT - Clique aqui](https://novo-app.s3.us-east-1.amazonaws.com/production/download/arquivos_novoagente/checa-novoagente-executando.sh)

---

## ⏱️ **2. Configuração do CRON**

O cron é responsável por manter o **novoagente** ativo e garantir o envio regular das vendas.  
As execuções devem ser configuradas da seguinte forma:

### **2.1. Sentenças de execução**

- **Executar o checador a cada 1 minuto:**
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-bg-elevated-secondary text-token-text-secondary flex items-center gap-4 rounded-sm px-2 font-sans text-xs">  
    </div></div></div><div class="overflow-y-auto p-4" dir="ltr">`*/1 * * * * /u/pdv/novoAvanco/checa-novoagente-executando.sh`</div></div>
- **Executar o forçador de vendas a cada 5 minutos:**
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-bg-elevated-secondary text-token-text-secondary flex items-center gap-4 rounded-sm px-2 font-sans text-xs">  
    </div></div></div><div class="overflow-y-auto p-4" dir="ltr">`*/5 * * * * /u/bats/forcarvendas.sh`</div></div>

Como deve estar:

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/scaled-1680-/WOpimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/WOpimage.png)

- Para salvar a alteração do cron, depende do editor que esta sendo usando. Geralmente no Debian usa o "nano". Com isso, bsta dar **CTRL + O** pra salvar, e depois **ENTER**. Para sair: **CTRL + X**

### **2.2. Reinício do cron**

Após adicionar as linhas acima e salvar, reinicie o serviço:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-systemctl-resta"><div class="overflow-y-auto p-4" dir="ltr">`sudo systemctl restart cron`</div></div>---

## ⚙️ **3. Verificação do `db.json`**

O arquivo **`db.json`** contém as informações de conexão e configuração do agente.  
Certifique-se de que:

- Para configurar o db.json, use o comando **./novoagente --servico** ( no diretorio /u/pdv/novoAvanco )
- Verificar se os dados de conexão estão corretos **(cnpj, token, número do PDV, diretório padrão)**;
- O arquivo está localizado no diretório correto do **novoagente ( /u/pdv/novoAvanco )**;
- As permissões permitem leitura e escrita pelo serviço ( chmod 777 \* no diretorio )

**Exemplo de um Json preenchido:**

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/scaled-1680-/VdXimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/VdXimage.png)

---

## 🧠 **4. Versão do NovoAgente**

Utilize **sempre a versão mais recente** do `novoagente.exe` (**64 bits)**.  
[Faça o download da versão do NovoAgente - Clique aqui ( versão 64 bits para Debian )](https://novo-app.s3.us-east-1.amazonaws.com/production/download/arquivos_novoagente/novoagente)

---

## ✅ **5. Resumo Final**

<div class="_tableContainer_1rjym_1" id="bkmrk-etapa-a%C3%A7%C3%A3o-caminho-f"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2549" data-start="2095"><thead data-end="2134" data-start="2095"><tr data-end="2134" data-start="2095"><th data-col-size="sm" data-end="2103" data-start="2095">Etapa</th><th data-col-size="sm" data-end="2110" data-start="2103">Ação</th><th data-col-size="sm" data-end="2120" data-start="2110">Caminho</th><th data-col-size="sm" data-end="2134" data-start="2120">Frequência</th></tr></thead><tbody data-end="2549" data-start="2177"><tr data-end="2228" data-start="2177"><td data-col-size="sm" data-end="2181" data-start="2177">1</td><td data-col-size="sm" data-end="2211" data-start="2181">Verificar `forcarvendas.sh`</td><td data-col-size="sm" data-end="2223" data-start="2211">`/u/bats`</td><td data-col-size="sm" data-end="2228" data-start="2223">-</td></tr><tr data-end="2306" data-start="2229"><td data-col-size="sm" data-end="2233" data-start="2229">2</td><td data-col-size="sm" data-end="2278" data-start="2233">Verificar `checa-novoagente-executando.sh`</td><td data-col-size="sm" data-end="2301" data-start="2278">`/u/pdv/novoAvanco/`</td><td data-col-size="sm" data-end="2306" data-start="2301">-</td></tr><tr data-end="2361" data-start="2307"><td data-col-size="sm" data-end="2311" data-start="2307">3</td><td data-col-size="sm" data-end="2329" data-start="2311">Configurar CRON</td><td data-col-size="sm" data-end="2346" data-start="2329">`/etc/crontab`</td><td data-col-size="sm" data-end="2361" data-start="2346">1min / 5min</td></tr><tr data-end="2428" data-start="2362"><td data-col-size="sm" data-end="2366" data-start="2362">4</td><td data-col-size="sm" data-end="2391" data-start="2366">Reiniciar serviço CRON</td><td data-col-size="sm" data-end="2423" data-start="2391">`sudo systemctl restart cron`</td><td data-col-size="sm" data-end="2428" data-start="2423">-</td></tr><tr data-end="2481" data-start="2429"><td data-col-size="sm" data-end="2433" data-start="2429">5</td><td data-col-size="sm" data-end="2453" data-start="2433">Validar `db.json`</td><td data-col-size="sm" data-end="2476" data-start="2453">`/u/pdv/novoAvanco/`</td><td data-col-size="sm" data-end="2481" data-start="2476">-</td></tr><tr data-end="2549" data-start="2482"><td data-col-size="sm" data-end="2486" data-start="2482">6</td><td data-col-size="sm" data-end="2515" data-start="2486">Garantir versão atualizada</td><td data-col-size="sm" data-end="2544" data-start="2515">`novoagente.exe (64 bits)`</td><td data-col-size="sm" data-end="2549" data-start="2544">-</td></tr></tbody></table>

</div></div>---

<span style="color: rgb(3, 0, 76);">**[![avanco-logo.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/scaled-1680-/avanco-logo.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-10/avanco-logo.png)**</span>

# Como instalar e configurar Novo Agente

<p class="callout warning">Remova quaisquer outros scripts, agendamentos cron/agendador de tarefas ou "gambiarras" que não estiverem listadas nesse documento para evitar problemas.</p>

### 1. Baixar executável

*Downloads -&gt; Novo Agente*

Obtenha o arquivo mais atual através da rotina de Downloads, em seguida, extraia o conteúdo na seguinte pasta:

<table border="1" id="bkmrk-%F0%9F%9F%A6-windows-%C2%A0c%3A%5Cpdvw%5Cn" style="border-collapse: collapse; width: 32.5%;"><colgroup><col style="width: 38.2434%;"></col><col style="width: 61.7566%;"></col></colgroup><tbody><tr><td class="align-left">🟦 **Windows**</td><td class="align-left"> *C:\\pdvw\\NovoAvanco*  
</td></tr><tr><td class="align-left">🐧 **Linux**</td><td class="align-left"> */u/pdv/NovoAvanco*</td></tr></tbody></table>

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/BaGimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/BaGimage.png)

### 2. Instalação

*(Co) Configurações &gt; Frente de Loja &gt; Cadastro PDV*

Na rotina "Cadastro do PDV", (1) clique no botão "Gerar código de configuração do Novo Agente", (2) selecione o número do PDV, (3) clique no botão "Gerar Cod. Configuração", (4) copie o código de configuração.

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/4fAimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/4fAimage.png)

  
No CMD/Terminal, digite o comando abaixo para iniciar a instalação e siga as instruções do script.

<table border="1" id="bkmrk-%F0%9F%9F%A6-windows-novoagente" style="border-collapse: collapse; width: 34.0476%; height: 59.5938px;"><colgroup><col style="width: 38.2468%;"></col><col style="width: 61.7532%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🟦 **Windows**</td><td style="height: 29.7969px;">*novoagente.exe --config*  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🐧 **Linux**</td><td style="height: 29.7969px;">*./novoagente --config*</td></tr></tbody></table>

[![agenteConfig.gif](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/agenteconfig.gif)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/agenteconfig.gif)

### 3. Configuração como serviço

#### **Sistema Operacional - Linux**

##### **Opção 1: Configuração automática**

Conceda permissão de execução.

```shell
cd /u/pdv/novoAvanco && chmod +x -R *
```

Execute o comando abaixo no terminal, na pasta do Novo Agente

```shell
cd /u/pdv/novoAvanco && ./novoagente --instalar
```

##### **Opção 2: Configuração manual (Em caso de erro da opção automática)**

Execute o comando abaixo no terminal, para configurar o script "checa-novo-agente" para executar a cada 5 minutos.

```shell
crontab -l 2>/dev/null | grep -q "checa-novoagente-executando.sh" || (crontab -l 2>/dev/null; echo "*/5 * * * * /u/pdv/novoAvanco/checa-novoagente-executando.sh") | crontab -
```

Confirme se o comando foi configurado corretamente executando:

```shell
crontab -l | grep novoagente
```

Execute o comando abaixo no terminal, para configurar a permissão correta dos arquivos.

```shell
cd /u/pdv/novoAvanco && chmod +x -R *
```

#### **Sistema Operacional - Windows**

Na pasta do Novo Agente, execute o comando abaixo no CMD

```
# C:/pdvw/novoAvanco
novoagente.exe --instalar
```

Pressione o atalho CTRL + R, e digite "taskschd.msc" e confirme com a tecla ENTER.

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/lKKimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/lKKimage.png)

  
Clique com botão direito na pasta "Biblioteca de Agendador de Tarefas", e selecione a opção "Criar Tarefa..."

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/RGtimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/RGtimage.png)

##### GERAL

1. Preencha o nome: Checa-novo-agente
2. Marque a opção "Executar estando o usuário conectado ou não"
3. Marque o checkbox "Não armazenar a senha. A tarefa terá acesso somente aos recursos do computador local."
4. Marque o checkbox "Executar com privilégios mais altos"
5. Marque o checkbox "Oculto"

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/3phimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/3phimage.png)

##### DISPARADORES

1. Clique no botão "Novo...", e selecione "Ao fazer logon"
2. Clique no disparador recém criado, e em seguida inicie a edição
3. Selecione a opção "Usuário especifico"
4. Marque o checkbox "Repetir a tarefa a cada", em selecione 5 minutos
5. Selecione a opção "Indefinidamente" posicionada afrente do texto "por um período de tempo de"
6. Certifique-se que o checkbox "Habilitado" esteja selecionado

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/2rVimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/2rVimage.png)

##### AÇÕES

1. Clique no botão "Novo...", e
2. Selecione "Iniciar um programa"
3. Em Programa/script, busque o arquivo checa-novo-agente.vbs no botão "Procurar..."
4. Em "Iniciar em (opcional)", informe o caminho aonde está o arquivo anterior

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/e8wimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/e8wimage.png)

##### CONDIÇÕES

1. Certifique-se que o checkbox "Iniciar a tarefa somente se o computador estiver ligado na rede elétrica" esteja desmarcado.

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/1cdimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/1cdimage.png)

##### CONFIGURAÇÕES

1. Desmarque o checkbox "Interromper a tarefa se ela for executada por mais de"
2. Na opção "Se a tarefa já estiver sendo executada...", selecione "Interromper a instância existente

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/il8image.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/il8image.png)