Soluções NBS - Plugins Mercado - Cilia

De Wiki NBS
Ir para navegação Ir para pesquisar
Construcao icon.png Área em Construção

Voltar para à Página principal > Sistema NBS - Plugins > Plugins Mercado - Cilia


Seta-topo.png

Apresentação

O Plugin NBS-Cilia foi desenvolvido com objeto de integrar as plataformas NBS e CILIA.

O principal objeto dessa integração é notificação do estoque atual do cliente, em tempo real, para controle na plataforma da Cilia. Uma carga inicial com todos os itens disponíveis em estoque é realizada no momento da implantação e, a partir disso, os itens são enviados em tempo real conforme demanda.

Sua instalação pode ser realizada tanto em ambiente Windows quanto Linux.


Obtendo os arquivos necessários

Para implantação é necessária atualização de scripts referente à versão disponibilizada do plugin nbs cilia. (Consulte NBS para confirmar a versão).

Além da atualização dos scripts, é necessário obter o executável do serviço para instalação, seja ele Linux ou Windows.

Ambos podem ser obtidos diretamente pelo FTP NBS (ftp.nbsi.com.br)  pelos caminhos:

Linux: ftp://ftp.nbsi.com.br/sistemadelphi/modulos/interfaces/Servicos/NBS/Linux/plugin-nbs-cilia

Windows: ftp://ftp.nbsi.com.br/sistemadelphi/modulos/interfaces/Servicos/NBS/plugin-nbs-cilia.exe


Por último, deve-se obter a ultima versão do executável do NBS Integrações, que se encontra disponível também no FTP, no caminho:

ftp://ftp.nbsi.com.br/sistemadelphi/modulos/interfaces/especificas/NBSIntegracoes.exe


Processo de Instalação

A primeira parte do processo de instalação do plugin nbs cilia, consiste em fazer login no módulo NBS Integrações, o executável do mesmo, que pode ser obtido no FTP NBS (em [./Ftp://ftp.nbsi.com.br/sistemadelphi/modulos/interfaces/especificas/ ftp://ftp.nbsi.com.br/sistemadelphi/modulos/interfaces/especificas/]).

NBSIntegrações - Login

Utilize as credenciais de banco (usuário, senha e schema). É importante que o usuário mantenha sempre o módulo NBS Integrações sempre atualizado na última versão.

Importante

Mantenha o módulo NBS Integrações sempre atualizado na última versão.

É obrigatório que a execução do módulo seja feita como administrador.

NBS Integrações - Tela de Login.png Ao acessar a tela de login do usuário, é necessário que seja informado:
  • O nome do usuário cadastrado (ID);
  • A senha registrada e;
  • O servidor vinculado/Schema;
NBS Integrações - Plugins Mercado - Integração Cilia.png Selecione a montadora, ou ‘Parceiro/Mercado’ no caso de uma integração específica, e o processo "NBS - Integração Cilia".

Instalação de Serviço Windows/Linux

Para instalação de um serviço via NBS Integrações, é necessário a garantia de estar utilizando a versão mais recente da ferramenta, e que a mesma foi executada como administrador.

Acesse a aba Serviços, que será uma das utilizadas para este processo de instalação.

Atenção: Devido o processo de instalação ser o mesmo, na demonstração abaixo será exibido a Instalação do Serviço Windows e, será inclusa, quando houver, as particularidades da Instalação do Serviço Linux.

NBS Integrações - Integração Cilia - Aba Serviços.png Na aba serviços, clique no botão Botão Incluir +.png para ter acesso ao assistente de instalação e adicionar um novo serviço (conforme imagem abaixo).
NBS Integrações - Integração Cilia - Aba Serviços - Botão Incluir - Tela Informativa.png O serviço só poderá ser instalado com o privilégio de Administrador, para o usuário logado que não possuir este privilégio será exibido a Tela Informativa ao lado.
NBSIntegrações - Menu Principal - Coluna Serviços - Botão Incluir - Form Assist de Inst de Serviço.png
  1. Nessa tela selecione o grupo de concessionária e, confirme o tipo de Sistema Operacional;
  2. Clique no botão Próximo.
NBS Integrações - Integração Cilia - Aba Serviços - Botão Incluir - Linux.png
  1. Selecione o grupo de concessionária e, confirme o tipo de Sistema Operacional (Linux) e o tipo de instalação.
  2. Configure a comunicação:
    • Host: IP do server Linux.
    • Porta: Porta para acesso do server Linux
    • Usuário: Normalmente pede-se o acesso root.
    • Senha: Senha de acesso referente ao usuário informado.
    • É necessário testar a conexão, clique no botão “Testar Conexão”.
  3. Clique no botão Próximo
NBSIntegrações - Menu Principal - Coluna Serviços - Botão Incluir - Form Assist de Inst de Serviço - Fonte de Instalação.png
  1. Nesta tela, defina a fonte de Instalação para EXECUTÁVEL LOCAL;
  2. Informe o diretório em que se encontra o serviço (clique no botão Botão Pesquisa NF.png para localizar o diretório).
  3. Clique no botão Próximo.
NBSIntegrações - Menu Principal - Coluna Serviços - Botão Incluir - Form Assist de Inst de Serviço - Fonte de Instalação - Configuração.png
  1. Nesta tela, confirme as credenciais de banco de dados, selecione a flag de referencia e clique no botão para salvar o banco a ser utilizado.
  2. Confirme o caminho em Instalação. Por padrão, o serviço deve ser instalado em c:\integrador\service.  
  3. Após confirmação, clique no botão: Próximo para avançar para próxima tela.
NBSIntegrações - Menu Principal - Coluna Serviços - Botão Incluir - Form Assist de Inst de Serviço - Instalação.png Confirme os dados exibidos em tela e clique em INSTALAR.

Finalizado o processo de instalação do plugin Cilia (Serviço Windows-Delphi).


Caso enfrente algum erro ou dificuldade no momento da instalação, entre em contato com a NBS para que seja solucionado o mais breve possível.
NBSIntegrações - Menu Principal - Coluna Serviços.png Nessa aba é possível confirmar que o serviço foi instalado e o seu status. Caso se encontre ‘parado’ pode-se realizar a inicialização do mesmo, ou acessar diretamente os serviços do Windows.
Caso enfrente algum erro ou dificuldade no momento da instalação, entre em contato com a NBS para que seja solucionado o mais breve possível.

CONFIGURAÇÃO DO INTEGRAÇÕES

CONFIGURAÇÃO DA OPERAÇÃO

Após completar o processo de instalação do plugin como serviço, é necessária configuração da operação via NBS Integrações para possibilitar o inicio da integração.

Acesse:

  1. NBS Integrações > Cadastro > Configuração
  2. Efetue o cadastro da Operação para o inicio da integração
NBS Integrações - Integração Cilia - Cadastro - Configuração.png Ao acessar a opção, será exibido o formulário abaixo.
NBS Integrações - Integração Cilia - Cadastro - Configuração - Botão Incluir.png Ao acessar a tela de configuração, clique no botão Botão Incluir Registro.png para habilitar o modo inclusão, para iniciar a parametrização da Operação.
NBS Integrações - Integração Cilia - Cadastro - Configuração - Botão Incluir - Cadastro - Operação.png
  1. Nessa tela, selecione a Empresa para qual será feita a configuração, a Operação de Notificação de Estoque. A opção Dealer não será utilizada, e o grupo de Email é opcional.
  2. Os parâmetros devem ser obrigatoriamente preenchidos, são eles:
    • auth_token: Token do cliente para utilização da API Cilia
    • cod_fornecedor: Código(s) do(s) fornecedor(es) a serem integrados. (No caso da utilização de mais de um, separar por vírgula – ex: 1,23,45.)
    • delivery_time: Necessário para envio à Cilia, referente ao tempo de entrega.
  3. Em seguida clique na aba: Tarefa.
NBS Integrações - Integração Cilia - Cadastro - Configuração - Botão Incluir - Cadastro - Operação - Tarefa - Cadastro - Autorização1.png Nessa tela, acesse as configurações de requisição através do botão Botão Configuração 1.png.
  1. Insira a URL de comunicação com API da Cilia. Pode-se usar a mesma em ambos os campos.
  2. Em seguida clique na aba: Frequência.
NBS Integrações - Integração Cilia - Cadastro - Configuração - Botão Incluir - Cadastro - Operação - Tarefa - Cadastro - Autorização - Cadastro Frequência.png Na aba frequência o usuário deve incluir uma referencia para inicio e funcionamento da integração.
  1. A frequência deve ser definida como diário.
  2. A hora pode ser definida como 00:00 para que tenha funcionamento em tempo integral, para isso, insira o valor e clique em Botão Incluir Registro.png para adicionar.
  3. Clique no botão Botão Salvar Registro.png. para salvar as alterações.

Assim é possível observar que a configuração foi concluída para empresa referente, e seu status na flag ‘Ativo’.
NBS Integrações - Integração Cilia - Cadastro - Operação - Cadastro - Botão Salvar.png
  1. Por fim, confirme no botão Salvar Botão Salvar Registro.png.
  2. Assim é possível observar que a configuração foi concluída para empresa referente, e seu status na flag ‘Ativo’.
NBS Integrações - Integração Cilia - Log Atividade.png Após a conclusão desse processo, a integração já se encontra instalada e configurada, e já deve ter iniciado os envios, caso exista fila.

Na aba Home, é possível verificar o log de atividades. Esse quadro mostra em tempo real os movimento executados pelo serviço.


Para outras dúvidas referentes ao Módulo Nbs Integrações é possível consultar seu manual de utilização disponível na Wiki NBS.

Em caso de problema ou dificuldade, entrar em contato para que seja resolvido o mais breve possível.


Voltar para à Página principal > Sistema NBS - Plugins > Plugins Mercado - Cilia