# Manual | Como realizar a instalação do Agente Integral
#### Contextualização.
O agente integral é responsável pelo envio das informações do Integral para o Novo Avanço através de arquivos jsons. Essa comunicação facilita a integração com outros sistemas e também a correção de notas fiscais através da interface gráfica do portal, além de realizar as funções ja presentes no carga relacionadas as nota fiscais (envio, cancelamento, inutilização...)
#####
##### Atualmente os arquivos enviados na integração JSON são:
- ##### Convênios:
[https://api.novoqas.avancoinfo.net/docs/public/#/Convenio](https://api.novoqas.avancoinfo.net/docs/public/#/Convenio)
- ##### Produtos:
[https://api.novoqas.avancoinfo.net/docs/public/#/Produto/ProdutoPublicoController\_cadastraOuAtualizaProduto](https://api.novoqas.avancoinfo.net/docs/public/#/Produto/ProdutoPublicoController_cadastraOuAtualizaProduto)
- ##### Produto Composto(Produção):
[https://api.novoqas.avancoinfo.net/docs/public/#/ProdutoComposto](https://api.novoqas.avancoinfo.net/docs/public/#/ProdutoComposto)
- ##### Promoções:
[https://api.novoqas.avancoinfo.net/docs/public/#/Promocao](https://api.novoqas.avancoinfo.net/docs/public/#/Promocao)
- ##### Promoções Diversas:
[https://api.novoqas.avancoinfo.net/docs/public/#/PromocaoDiversa](https://api.novoqas.avancoinfo.net/docs/public/#/PromocaoDiversa)
- ##### Tabela de Preços:
[https://api.novoqas.avancoinfo.net/docs/public/#/AtacadoProduto](https://api.novoqas.avancoinfo.net/docs/public/#/AtacadoProduto)
- ##### Vendedores:
[https://api.novoqas.avancoinfo.net/docs/public/#/Pessoa/PessoaController\_upsertDadosVendedores](https://api.novoqas.avancoinfo.net/docs/public/#/Pessoa/PessoaController_upsertDadosVendedores)
#### Requisitos para instalação.
- **Servidor do cliente ser 64 bits.**
- **Cliente utiizar novo tramitador.**
- Servidor possuir sqlite3 instalado.
- Servidor possuir jq instalado.
- Servidor possuir redis-server instalado.
##### **Obs:** Comando para verificar versão do servidor:
"uname -m".
##### Comando para verificar se programas estão instalados:
sqlite3 --version
jq --version
redis-server --version
##### Caso algum dos programas necessários não esteja instalado, realizar instalação seguindo o padrão:
sudo apt install nome\_programa
Exemplo sqlite3: sudo apt install sqlite3
Após instalar o redis-server, caso necessário instalação, é essencial executar os seguintes comandos utilizando o usuário root para inicializar as filas:
redis-cli
FLUSHALL
Executando a instalação e configuração do Agente Integral no servidor.
##### **ATENÇÃO!**
##### **Os processos abaixo deverão ser realizados com o usuário avanco.**
#####
1 - Realizar download do script de instalação
link para download direto:
[https://s3.amazonaws.com/avancoprogramas/outros/install.sh](https://s3.amazonaws.com/avancoprogramas/outros/install.sh)
**Obs:** Para baixar o arquivo diretamente no servidor, basta usar o seguinte comando:
wget [https://s3.amazonaws.com/avancoprogramas/outros/install.sh](https://s3.amazonaws.com/avancoprogramas/outros/install.sh)
##### 2 - Copiar arquivo baixado para alguma pasta **(Qualquer pasta com permissão)** do servidor do cliente **(Caso não baixado diretamente no servidor)** :
[](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-05/lr0image.png)
#####
##### 3 - Executar script de instalação:
[](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-05/dOsimage.png)
Caso solicitar, informar a senha do root do servidor:
[](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-05/Yeaimage.png)
Configurar conforme opções abaixo:
\* Utilizar o carga junto com o Agente Integral?
R = Informar Y ou pressionar entre
\*
Pressionar enter para prosseguir para a próxima opção.
Na tela abaixo, pressionar enter novamente:
Manter o ambiente production selecionado e pressionar a tecla enter:
informar e-mail e senha utilizados no portal do Novo Avanço e pressionar enter no campo cnpj.
#####
Após realizar o processo acima, o agente-integral já estará instalado e configurado no cliente.