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