Skip to main content

Manual | Como realizar a instalação do Agente Integral

Contextualização.

Além de realizar as funções já presentes no carga relacionadas as nota fiscais (envio, cancelamento, inutilização...), o agente integral é responsável pelo envio das informações do Integral para o Novo Avanço através de arquivos jsons gerados pelo próprio programa COBOL.

Essa comunicação facilita a integração do legado com o Novo Avanço via API, possibilitando a atualização das informações de forma mais rápida e precisa.

      
      Atualmente o Integral realiza o envio das seguintes arquivos para o Portal:

Requisitos obrigatórios para instalação no servidor Integral.

  • Servidor do cliente ser 64 bits.
    Verificação pode ser realizado usando o comando abaixo:

    Exemplo servidor 32bits (Não viável para instalação do Agente Integral):

    image.png

    Exemplo servidor 64bits (Viável para instalação do Agente Integral):

    image.png


  • Utilizar o Novo Tramitador de notas.

  • Os seguintes programas devem ser/estar instalados no servidor: (sqlite3, jq e redis-server).

Caso algum dos programas necessários não esteja instalado no servidor, realizar instalação seguindo o padrão:

ATENÇÃO! Utilizar usuário root para instalação dos programas


Instalação sqlite3:

image.png

Instalação jq:

image.png


Instalação redis-server:

image.png

Após instalar o "redis-server", necessário executar os comandos abaixo:

image.png

image.png

OBS: Caso haja alguma dificuldade na instalação dos programas acima, solicitar auxílio a tecnologia.


ATENÇÃO!
Os processos abaixo deverão ser realizados com o usuário avanco.


1 - Realizar o backup da pasta /u/node_apps/:
image.png


2 - Baixar e executar o script de instalação do Agente Integral.

Executar o seguinte comando no servidor do cliente:

 cd /u/rede/avanco/ && wget https://s3.amazonaws.com/avancoprogramas/outros/Instalador_Agente_Integral.zip && unzip Instalador_Agente_Integral.zip && rm Instalador_Agente_Integral.zip && sh install.sh;

Conforme imagem abaixo:

image.png



Processo de instalação e configuração iniciado:

image.png



3 - Realizar a configuração respondendo as perguntas conforme passos abaixo:
  • Utilizar carga junto com o Agente Integral?
    Pressionar a tecla "Y"

  • Informe a porta que deseja rodar a aplicacao (porta padrão 4000):
    Pressionar a tecla "enter".

  • Selecione o(s) tipo(s) de serviço(s) que deseja utilizar:
    Pressionar a tecla "seta para baixo", pressionar "espaço" e posteriormente a tecla "enter", conforme imagens abaixo:

image.png

image.png

image.png

  • Selecione qual erp você deseja fazer a integração:
    Pressionar a tecla "enter"

  • Selecione o ambiente que deseja configurar para o serviço ERP NOVOAVANCO:
    Pressionar a tecla "enter"

Aós realizar o processo acima, informar e-mail e senha utilizado para acessar o Novo Avanço e pressionar enter na pergunta "Informe o CNPJ":

image.png

image.png

4 - Configurar quais arquivos o Integral enviará para o Novo Avanço:

Agora o Agente Integral está configurado no servidor Integral do cliente, mas ainda é necessário selecionar quais serão os arquivos que o Integral enviará para o Novo Avanço. Para realizar a configuração dos arquivos enviados, acesso o servidor .250 e execute o integ817, conforme imagens abaixo:

Obs: Execução poderá ser realizada no caminho de qualquer base do servidor, não precisará ser necessariamente a base do cliente que a instalação está sendo feita.
Utilizar a senha da Avanço para acessar integ817

image.png

image.png

image.png


Ao acessar a rotina, escreve em maiúsculo o texto "GESTAO NFCE", pressionar enter e informar o número de série do cliente que realizou a instalação do Agente Integral:

image.png


Pressionar a tecla "S" na pergunta abaixo:

image.png

Informar o código referente aos dados que deseja enviar, lembrando que hoje sobre as informações abaixo são enviadas:

  • Convênios
  • Produtos
  • Produtos Compostos
  • Promoções
  • Promoções Diversas
  • Tabela de Preços
  • Vendedores

Obs: É recomendado marcar o envio de todas as informações listadas acima.

Exemplo enviando cadastro de produtos e promoções:
Digitar "08" e pressionar "S":

image.png

image.png

Para navegar entre as páginas de opções, digitar "page up" ou "page down" (Lembrando que para o Agente Integral serão enviadas somente os dados mencionados anteriormente).


Pressionar page down, digitar "20" e pressionar a tecla "S":

image.png

image.png

Ao marcar todas as informações enviadas pelo Agente Integral, tela deve ficar da seguinte maneira:

image.png

image.png

5 - Enviar alterações para o arqp e atualizar arquivo no cliente:

Após configurar os dados enviados, retornar a linha de comando do servidor da avanço e executar seguinte comando:
Obs: Caso não possua permissão para executar o comando abaixo, solicitar auxílio ao squad lider da equipe materiais.image.png

image.png

Após finalizar o envio do arqp, retornar ao servidor do cliente e executar o seguinte comando usando o usuário Avanço:

atu-help manual && pm2 start /u/node_apps/pm2.json

image.png

Deverá ser mostrado o "Agente Integral" na lista de serviços ativos do pm2:

image.png

 

6 - Configurar bat no cron:

Obs: Processo abaixo deverá ser realizado somente se possuir conhecimento na edição do cron linux. Caso necessário, solicitar auxílio para a equipe de tecnologia ou squad líder do materiais.

Usando o usuário Avanço, no servidor do cliente, acessar o cron e incluir a bat "agente-integral.sh":

image.png

image.png

Obs: bat "/u/bats/agente-integral.sh" é criada automaticamente durante a execução do scrip de instalação, garantindo assim sua existência no servidor.

 

 

 

Após realizar os processos acima, o Agente Integral estará instalado e configurado corretamente no servidor do cliente.

No Comments
Back to top