Este artigo tem como objetivo apresentar a forma de realizar a Instalação e a Configuração do InterfaceNFe no Linx ITEC.


Pré-Requisitos da Máquina

Sistema OperacionalWindows 10 Pro ou Sever 2012+
CPU8 vcpu
RAM16 GB
Disco512 GB


Para ter um bom funcionamento, segue as condições:

• Servidor Windows Habilitado com TLS 1.2;
• Possuir certificado Digital no padrão ICP-Brasil;
• Possuir acesso à internet;
• Credenciamento ativo junto à SEFAZ;
• Possuir licença e liberação de Licença NFe para as filiais junto ao comercial;
• Usuário administrador local para configuração dos serviços e instalação do certificado 
digital.
• Certificados digitais A1 de cada CNPJ que emitirá qualquer tipo de documento fiscal, 
esses certificados devem ser instalados no usuário administrador local definido para as 
aplicações ITEC em que os serviços a serem instalados serão logados. Além disso tem 
a duração de um ano e devem ser disponibilizados pela sua equipe de contabilidade. 
Em caso de dúvidas, utilize o utilitário de instalação do fornecedor do certificado. 

Instalação do InterfaceNFe 

Devidamente conectado no servidor de NFe, execute o instalador do InterfaceNFe o arquivo pode ser localizado no pacote desses manuais, siga os passos abaixo:

  • Nesse passo é definido o diretório de instalação e cópia de arquivos da aplicação, a definição desse diretório deve ser realizada com base na infraestrutura e topologia de cada ambiente, por padrão utilizamos o caminho C:\InterfaceNFE\4.0, como demonstrado no exemplo abaixo, entretanto direcione para o disco e diretório que for mais adequado para seu ambiente e após defini-lo clique sobre o botão "Avançar".


Figura 01 - Selecione o Local de Destino


A seguir abrirá a tela "Pronto para Instalar", clique sobre o botão "Instalar".

Figura 02 - Pronto para Instalar


Uma vez iniciado o processo de Instalação, os arquivos serão copiados para o diretório definido (na tela "Selecione o Local de Destino"), além disso serão copiadas e instaladas as DLL's Capicom, elas são importantes para o uso dos certificados digitais e requisitos para o funcionamento, para seus registros é executado os scripts pela tela de Prompt de Comando (cmd), conforme o abaixo:

Figura 03 - Prompt de Comando e/ou CMD


Dessa forma, serão instalados os serviços de Emissão, Recebimento e do Extrator de E-mails conforme o abaixo, caso apresente algum erro não tem problema por agora, visto que realizamos a reinstalação e atualização deles posteriormente.


Figura 04 - Processo de Instalação


A seguir, abrirá a tela de conclusão da instalação, clique sobre o botão "Concluir".


Figura 05 - Concluir Instalação


Em algumas versões do sistema operacional Windows, pode ser apresentado o erro abaixo, neste caso, siga o passo a passo abaixo:

  • Execute o CMD como administrador e rode o comando abaixo:
    C:\Windows\System32\cmd.exe /k %windir%\System32\reg.exe ADD HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v EnableLUA /t REG_DWORD /d 0 /f-



Figura 06 - 

  • Após rodar o comando acima reinicie a máquina e será possível abrir o InterfaceNFe normalmente, logo após ter realizado a configuração abaixo.



Para casos que não ocorrerem o erro acima citado, será possível dar continuidade na instalação, segue abaixo:

No InterfaceNFe os parâmetros iniciais para a execução da sua interface gráfica são configurados em um arquivo de configuração ".INI", que é localizado sempre na pasta Windows, no caminho:  C:\Windows, a primeira configuração deve ser realizada mandatoriamente neste arquivo, posteriormente os parâmetros, exceto de comunicação com os bancos, pode ser alterada na interface gráfica do aplicativo.

Importante: Nos casos de migração de servidor, esse arquivo pode ser apenas copiado, respeitando o caminho padrão.

Figura 08 - Interface Gráfica

Na imagem acima temos um exemplo do arquivo de configuração, temos cinco blocos de parâmetros que temos de ter atenção nesse primeiro momento, explicaremos um a um abaixo:

  • AMBIENTE: Define o tipo de ambiente para Produção e Homologação, respectivamente com os valores 1 e 2;
  • PROTOCOLO: Define o protocolo para emissão de NFe, deve ser 4.0;
  • DIRETORIO_RECEBIMENTO: Aqui aponta-se a pasta onde os arquivos XML extraídos das caixas de Email pelo Extrator de Emails serão lidos e processados pelo serviço de Recebimento. Aqui deve ser registrado o mesmo diretório configurado como o Diretório de Output XML no Extrator de E-mails.
  • No Bloco [DATABASE] são definidos os dados de acesso ao SQLServer e especificamente o banco de NFE, temos então:
    • DB: deve ser 1 par SQLServer;
    • SERVIDOR: Deve ser apontado o IP ou DNS do servidor do SQLServer;
    • PORTA: Deve ser apontada a porta da Instância do SQLServer, se a porta for a padrão pode ser em branco;
    • DatabaseName: Deve ser apontado nome do banco de NFe, por padrão é NFE, em alguns casos temos nomes personalizados que devem ser devidamente parametrizados;
    • Username: Deve ser apontado o Usuário definido dentro do servidor do SQLServer;
    • Passowrd: Deve ser apontada a senha do Usuário definido dentro do servidor do SQLServer.
  • No Bloco [PERSISTENCIA] são definidos os dados de acesso ao SQLServer e especificamente o banco de Produção, temos então:
    • DB: deve ser 1 par SQLServer;
    • SERVIDOR: Deve ser apontado o IP ou DNS do servidor do SQLServer;
    • PORTA: Deve ser apontada a porta da Instância do SQLServer, se a porta for a padrão pode ser em branco;
    • DatabaseName: Deve ser apontado nome do banco de Produção;
    • Username: Deve ser apontado o Usuário definido dentro do servidor do SQLServer;
    • Passowrd: Deve ser apontada a senha do Usuário definido dentro do servidor do SQLServer.

  • PORTA_WEBSEVER: Define a porta para habilitação de WEBServer InterfaceNFe para impressão de DANFE no ITEC-Suite, a porta é a 7799 por padrão;

Atualização e Configuração de Arquivos e Serviços 

Para realizar a atualização e configuração dos arquivos e serviços, será necessário realizar a remoção de serviços anteriores:

  • Para realizar a atualização e configuração pare e desative os serviços de Emissão, Recebimento e Extrator de E-mails caso estejam instalados na máquina;
  • Rode os comandos no CMD abaixo com acesso administrador para desinstalar quaisquer serviços já instalados:
    • SC DELETE nfe_module_service_emissao
    • SC DELETE nfe_module_service_recebimento
    • SC DELETE nfe_module_service_extratoremail 


Baixe as versões compatíveis com o seu ambiente.

Para ter acesso às últimas versões, acesse o site releases.itecdomain.com.br, nele estará disponível os serviços listados abaixo, eles devem ser renomeados conforme cada evidência e alocados no diretório do InterfaceNFe definido no primeiro passo da instalação, nesse exemplo usaremos o padrão que é C:\InterfaceNFE\4.0:

  • Interface NF-e - Emissão: nfe_module_emissao.exe
  • Interface NF-e - Recebimento: nfe_module_recebimento.exe
  • Envio de e-mail (ExtractMailService): nfe.module.extractmailservice.exe e nfe.module.extractmailservice.view.exe 


Será necessário instalar alguns serviços para o bom funcionamento dos serviços:

Para realizar a instalação rode os comandos no Windows PowerShell abaixo com acesso administrador:


New-Service -Name "nfe_module_service_emissao" -DisplayName "Linx/Itec InterfaceNFE Emissão" -BinaryPathName "C:\InterfaceNFE\4.0\nfe_module_emissao.exe"

New-Service -Name "nfe_module_service_recebimento" -DisplayName "Linx/Itec InterfaceNFE Recebimento" -BinaryPathName "C:\InterfaceNFE\4.0\nfe_module_recebimento.exe"

New-Service -Name "nfe_module_service_extratoremail" -DisplayName "Linx/Itec InterfaceNFE ExtratorEmail" -BinaryPathName "C:\InterfaceNFE\4.0\nfe.module.extractmailservice.exe"


Observação: Nos comandos acima o parâmetro "-BinaryPathName", define o caminho para o arquivo executável do serviço, atualize o caminho com o diretório definido no primeiro passo da instalação, nesse exemplo usaremos o padrão que é C:\InterfaceNFE\4.0


Em seguida, Logar os serviços de Emissão e Recebimento e instalação dos certificados digitais:


Para o pleno funcionamento dos serviços de Emissão e Recebimento os serviços devem estar logados com um usuário administrador local da máquina, crie conforme sua preferência, entretanto esse  deve ser o mesmo que estão instalados os certificados digitais de todos os CNPJ`s que emitiram qualquer tipo de documento fiscal, caso contrário os serviços apresentaram erro. Instale-os no mesmo usuário que logar os serviços o certificado digital devidamente emito e valido.


Uma vez o certificado digital instalado, no InterfaceNFe.exe presente no diretório definido no primeiro passo da instalação, execute-o no menu superior esquerdo clique no botão “Configurações” e em seguida na aba “Operacional”, selecione o CNPJ ou filial e nessa mesma aba, na parte inferior esquerda, clique no botão “Auto definir certificado” e por fim confirme no botão “Yes”, com isso o certificado será atualizado no banco de dados.


Figura 09 - Configuração dos Serviços


O próximo passo é atualizar o arquivo InterfaceNFe.exe presente no diretório C:\InterfaceNFE\4.0\:

  • O arquivo pode ser localizado no pacote desses manuais, com isso você terá a versão mais atual da interface de gráfica de usuário do InterfaceNFe da Linx. Atualize o arquivo no diretório definido no primeiro passo da instalação, nesse exemplo usaremos o padrão que é C:\InterfaceNFE\4.0.


Será necessário copiar os arquivos de Schemas da pasta ve310 para a pasta de Schemas:

  • Em alguns casos pode-se apresentar erros na leitura dos Schemas, para evitar esse tipo de erro é necessário copiar todos os arquivos da pasta C:\InterfaceNFE\4.0\Schemas\ve310 para as pastas C:\InterfaceNFE\4.0\Schemas e C:\InterfaceNFE\4.0\Schemas\ve400. Faça a cópia dos arquivos no diretório definido no primeiro passo da instalação, no exemplo acima foi apontado o padrão que é C:\InterfaceNFE\4.0.


Em seguida configure o Extrator de E-mails:

  • A configuração do Extrator de E-mails é realizada pelo executável nfe.module.extractmailservice.view.exe presente no diretório C:\InterfaceNFE\4.0 que gravada no arquivo XML CaixasPostais.xml presente também nessa pasta, exceto para as caixas de Email que não utilizam o protocolo OAuth 2.0, nesses casos é necessário solicitar apoio do time de RC. As caixas de Email para leitura devem estar devidamente cadastradas, permitindo assim o funcionamento correto desse serviço. Nos casos de migração de servidor, esse arquivo pode ser apenas copiado, respeitando o caminho padrão.
    A configuração da Leitura de E-mails tem o intuito de com base em uma ou mais caixas de entrada de e-mails analisar os arquivos anexos e nesses que são arquivos do tipo XML baixá-los e gravá-los em determinado diretório, preferencialmente no diretório configurado no Interface NFe para a importação de notas pelo serviço de Recebimento. 
    Uma vez configurado o aplicativo realizara a leitura dos email em busca dos anexos, por padrão ele lê o email e altera do status de não lido para lido e segue para o próximo. Exceto nos casos em que é marcado o parâmetro “Apagar Mensagens após donwload” onde os email serão lidos e apagados. Durante a definição dos parâmetros no passo abaixo, parametrize conforme o mais adequado para seu ambiente.
    Com isso temos os parâmetros abaixo para configuração:

Figura 10 - Parâmetro de Leitura


  • Diretório de Output XML: Aqui aponta-se a pasta onde os arquivos XML localizados serão gravados, para que seja processado pelo Recebimento aqui deve ser registrado o mesmo diretório configurado como o Diretório de Arquivos recebidos no InterfaceNFe.
  • Apagar Mensagens após download: Por padrão o extrator lerá os e-mails não lidos da caixa de entrada do Email cadastrado e os marcará como lidos, assim ativando esse parâmetro a dinâmica mudará, com isso ele lerá e processará todos os e-mails recebidos, mas apagará todos eles, então não é recomendado para a o Email de produção, visto que uma vez apagado o dado será perdido.
    Ative esse parâmetro apenas se os emails e anexos são descartáveis, pois após ler os emails, eles serão apagados da caixa de email.
  • Caixas postais: Aqui são configuradas as contas de e-mails a serem acessadas pelo Extrator de E-mails, abaixo cada um dos campos detalhados:
    • Seq.: Inicia-se a partir do número um e define a ordem de leitura, ao 
      cadastrar mais de uma caixa por padrão acrescente sempre incremente 
      um a um.
    • Email: Esse é o login/usuário da sua conta, atente-se para um Email
      válido (Ex: [email protected]).
    • Host: Aqui aponta-se o servidor do provedor de e-mails, pode ser um 
      DNS ou mesmo IP, o fornecimento desse dado é responsabilidade do 
      provedor.
    • SSL: Habilite caso o servidor tenha essa validação de segurança, o 
      fornecimento desse dado é responsabilidade do provedor.
    • Senha: Senha do Email, de uso do cliente, o fornecimento desse dado é 
      responsabilidade do provedor.
    • Porta: Aqui aponta-se a porta do serviço de Email no servidor do 
      provedor, o fornecimento desse dado é responsabilidade do provedor.
  • Ativo: É o Gatilho para processamento ou não das caixas cadastradas, "S" para processar e "N" para não processar.
    Obs.: Para adicionar uma caixa postal clique no mais (+), após a inserção dos dados grave com o sinal de visto (✔), o mesmo procedimento pode ser realizado para exclusão, selecione a caixa postal e clique no menos (-) e grave com o sinal de visto (✔).
  • A configuração do Envio de E-mails tem como objetivo o envio via Email dos XML's emitidos para os devidos destinatários (Clientes). Com isso temos os parâmetros abaixo para configuração:

Figura 11 - Parâmetro de Envio


  • Servidor/Host: Aqui aponta-se o servidor do provedor de e-mails, pode ser um DNS ou mesmo IP, o fornecimento desse dado é responsabilidade do provedor.
  • Usuário: Esse é o login/usuário da sua conta, atente-se para um E-mail válido (Ex: [email protected]).
  • Senha: Senha do E-mail, de uso do cliente.
  • Porta: Aqui aponta-se a porta do serviço de Email no servidor do provedor, o fornecimento desse dado é responsabilidade do provedor.
  • Diretório importação arquivos NEN (Envio de Email): Diretório de arquivos temporários para processamento e envio, deve ser apontado para a pasta "TMP" dentro do diretório do InterfaceNFe.
  • Usa SSL: Habilite caso o servidor tenha essa validação de segurança, o fornecimento desse dado é responsabilidade do provedor.
    • Caso habilite o SSL atente-se ao opções de SSL, o fornecimento desses dados é responsabilidade do provedor.


Por fim inicie os serviços e valide o funcionamento, os logs podem ser consultados no diretório definido no primeiro passo dessa instalação, nesse exemplo, C:\InterfaceNFe\LOG.


Dúvidas?

Em caso de dúvidas, favor entrar em contato com o time de relacionamento com o cliente, estamos à disposição