GUIA DE MANUTENÇÃO DO CERTIFICADO PÚBLICO NA NFSe Versão 0.1
Sumário Introdução... 3 1. Pré-requisitos... 4 2. Instalação do Java... 5 3. Encontrando o Projeto Servidor NFE... 11 4. Manutenção do arquivo.keystore (Chaveiro)... 13 4.1. Baixar o arquivo da Prefeitura... 13 4.2. Gerando o arquivo KeyStore... 17 4.3. Encontrando o projeto... 19 4.4. Alterando o projeto... 20 5. Glossário... 21 Set -12 Pág. 2 / 21
Introdução Este documento apresenta a forma como deverá ser realizada a manutenção dos Certificados no Projeto Servidor NFE, sendo recomendada a sua utilização nos casos em que houver troca de chave pública da prefeitura. Como exceções se enquadram as prefeituras que não necessitam de certificado digital (dependendo do layout adotado). Set -12 Pág. 3 / 21
1. Pré-requisitos Ter o Projeto Servidor NFE instalado. Set -12 Pág. 4 / 21
2. Instalação do Java Realizar o download do Java (JRE), através do link: http://www.oracle.com/technetwork/java/javase/downloads/index.html. Conforme ilustra a imagem abaixo: 1º Passo Efetuar a instalação do arquivo JRE, não deverão ser realizadas quaisquer alterações das configurações recomendadas; Set -12 Pág. 5 / 21
2º Passo Acessar no Painel de Controle da máquina a opção Sistema ; Set -12 Pág. 6 / 21
3º Passo Nos casos em que o sistema operacional utilizado for o Windows 7, deverá ser acessada a opção Alterar configurações. Conforme ilustração abaixo: Set -12 Pág. 7 / 21
4º Passo Acessar a aba Avançado, em seguida, clicar no botão Variáveis de ambiente ; Set -12 Pág. 8 / 21
5º Passo Acionar o botão Nova, e adicionar as variáveis JAVA (aponta para o caminho de instalação do Java) e JAVA_HOME (aponta para o caminho de instalação do Java+ \bin. Conforme mostra a imagem abaixo: Set -12 Pág. 9 / 21
6º Passo Clicar no botão OK, para finalizar as alterações de configuração. Set -12 Pág. 10 / 21
3. Encontrando o Projeto Servidor NFE 1. Acessar a localização: Global / Configurações / Cadastro Geral de Parâmetros ; 2. Colocar a tela em modo de pesquisa; 3. No bloco Sistemas, pesquisar pelo Módulo FFCV ; 4. No bloco Parâmetros, informar o parâmetro DIRETORIO_SERVIDOR_NFE. MV 2000 Set -12 Pág. 11 / 21
Soul MV Set -12 Pág. 12 / 21
4. Manutenção do arquivo.keystore (Chaveiro) Este processo apenas deverá ser utilizado nos casos em que o endereço de Web Service utilize a porta 443, ou seja, quando existir HTTPS:// em seu endereço; 4.1. Baixar o arquivo da Prefeitura 1º Passo Acessar o endereço de Web Service da prefeitura. A imagem abaixo ilustra uma coleta através do portal ginfes (https://producao.ginfes.com.br/serviceginfesimpl?wsdl); 2º Passo Clicar no cadeado ao lado do endereço, e selecionar a opção Exibir Certificado ; Set -12 Pág. 13 / 21
3º Passo Na janela Certificado, acessar a aba Detalhe e acionar o botão Copiar para o arquivo ; Set -12 Pág. 14 / 21
4º Passo Na janela Assistente para Exportação de Certificados, selecionar a opção X.509 codificado na base 64 (*.cer) e em seguida acionar o botão Avançar ; Set -12 Pág. 15 / 21
5º Passo Informar o caminho do arquivo em uma pasta cujas permissões de acesso estejam liberadas (Ex: c:\cert); 6º Passo Acionar o botão Avançar e, posteriormente, acionar o botão Concluir para finalizar. Set -12 Pág. 16 / 21
4.2. Gerando o arquivo KeyStore 1. Abrir o prompt de comando (Iniciar / Executar / cmd); 2. Informar cd <caminho do java JRE>/Bin e clicar Enter ; 3. Informar: keytool import alias nfe keystore arquivi_keystore_a_gerar.keystore file arquivo_baixado_servidor_prefeitura.cer Observações: Arquivo_keystore_a_gerar.keystore deverá conter todo o caminho até o novo arquivo. Ex: C:\cert\<qualquer nome de arquivo>.keystore (ainda não gerado); Arquivo_baixado_servidor_prefeitura.cer trata-se do caminho para acessar o arquivo da prefeitura, cujo download foi anteriormente efetuado. Ex: C:\cert\<arquivo baixado 4.1>; 4. Acionar a tecla Enter ; 5. Definir uma senha, em seguida, confirmar a senha informada. Após a confirmação, clicar em Enter ; Set -12 Pág. 17 / 21
Set -12 Pág. 18 / 21
6. Digitar Sim ou Yes (dependendo do idioma do sistema operacional utilizado) e clicar em Enter ; 7. Conferir no diretório c:\cert se foi criado o arquivo. 4.3. Encontrando o projeto Basta refazer o processo descrito no item 3 deste documento. Set -12 Pág. 19 / 21
4.4. Alterando o projeto 1. Acessar o diretório encontrado no item 3 deste documento, no caso do exemplo apresentado o diretório será C:\servidorNfe\ ; 2. Acessar a pasta Certificado e colar o arquivo gerado; 3. Acessar a pasta Configuração, dentro do repositório C:\servidorNfe\ ; 4. Com um editor de texto, abrir o arquivo applicationcontext.properties ; 5. Identificar o trecho Certificado.trustStoreFileName, e informar o caminho para o arquivo baixado. Ex: certificado.truststorefilename = c:\servidornfe\certificado\key.keystore; 6. Identificar o trecho certificado.truststorepassword e informar a senha definida no tópico 4.2. Ex: certificado.truststorepassword = 123456; 7. Salvar e fechar o arquivo applicationcontext.properties. Set -12 Pág. 20 / 21
5. Glossário NFSe Nota Fiscal de Serviço Eletrônica; Java Linguagem de programação utilizada para o desenvolvimento de softwares; KeyStore (Chaveiro) Arquivo utilizado para conversão da chave disponibilizada pela prefeitura, e realização da comunicação, via Java, com o link desta; Servidor NFE Aplicação, em Java, responsável pelo gerenciamento das notas fiscais (Gera, assina e armazena em XML; se comunica com o Web Service e manipula o banco de dados da empresa); Web Service Realiza a integração entre sistemas com aplicações diferentes, traduzindo-as para a linguagem universal (XML). Set -12 Pág. 21 / 21