Módulo Nota Fiscal Eletrônica Sispetro Roteiro de Instalação Módulo Autenticador NFE Pré-Requisitos O sistema operacional recomendado deve ser o Windows 2003, Windows 2000 ou Windows XP (nessa ordem de recomendação). Verificar que o Sistema Operacional esteja estável e que você tenha permissão de administrador. Verificar que o IIS (na versão 5.0 ou 6.0) esteja instalado no computador. Caso a versão do SO seja Windows 2003, deve-se instalar explicitamente o IIS, pois ele não vem configurado para tal instalação por padrão. Caso seja o Windows 2000 ou XP, normalmente o IIS (versão 5.0) já está instalada. Verificar se o DOT NET Framework 2.0 está instalado na máquina. Caso seja o IIS 6.0, verificar se a extensão do aspnet está configurada em Extensões de serviços da Web. Caso não esteja, adicioná-la usando o arquivo aspnet_isapi.dll. constante em c:\windows\microsoft.net\framework\v2.0.50727\ (ver item específico, no final do documento, Verificação extensão de Serviços da Web ) Verificar o compartilhamento/segurança em C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files, indo na aba Segurança e dando acesso ao usuário do IIS. (ver item específico, no final do documento, Verificação compartilhamento/segurança do ASPNET ) Verificar se possui um certificado digital padrão A1 ou A3 com a respectiva senha privada. Recomendamos ter o certificado em formato de arquivo para facilitar o manuseio. ATUALIZAÇÃO: SOMENTE DEVE SER ADQUIRIDO O CERTIFICADO DIGITAL EM MIDIA DE ARQUIVO (CD OU DISQUETE). NÃO COMPRAR CERTIFICADO EM OUTRA MIDIA. Passos para instalação I. Criar diretório virtual para abrigar serviço autenticador da nota fiscal eletrônica. a. Executar Gerenciador IIS Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 1/21
b. Clique com o botão da direita no nó Site da WEB Padrão, clique em Novo, clique em Diretório Virtual. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 2/21
c. Preencha as opções do Wizard, deixando tudo como padrão e informando: Alias: Nome que será acessado por usuários externos (no caso o servidor Sispetro). Sugerimos preencher com NFe. Caminho: Diretório físico no servidor onde o serviço será instalado. Sugerimos criar um diretório dentro do diretório <Windows Drive>/InetPub/wwwRoot com o nome Futura e, em seguida, um subdiretório com o nome NFe. A estrutura ficaria <Windows Drive>/InetPub/wwwRoot/Futura/NFe. Observação: Pode-se utilizar qualquer diretório ou estrutura. A vantagem de se criar um diretório abaixo da INetPub/wwwroot é que os serviços da WEB já tem permissão padrão para acesso a estes diretórios. O diretório Futura é uma sugestão pois iremos lançar outros serviços em WEB e com isso estes serviços ficariam em outros subdiretórios do diretório Futura. Permissões de Acesso: Além da configuração padrão (somente leitura), devemos permitir também Execução de Scripts (ASP, por exemplo). d. Para se certificar que tudo está correto até agora, copie o arquivo teste.html da pasta de instalação do módulo NFE-Sispetro para a pasta criada acima (no nosso exemplo, NFe). e. Tente acessá-la com o seu browser, digitando: HTTP://localhost/Futura/NFe/teste.html (ou substitua pelo alias que você criou nos passos anteriores). Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 3/21
II. Configuração do Certificado a. Importar certificado no repositório da máquina (LOCAL_MACHINE) Para tanto, iremos utilizar o gerenciador de certificados da sua máquina para importar o certificado original e mover a cadeia de certificação para o local correto. i. Digite na barra de tarefas do Windows: mmc <enter> ii. Clique no menu Arquivo/Adicionar remover Snap-In Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 4/21
iii. Clique no botão Adicionar e escolha a opção Certificados clicando no botão Adicionar. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 5/21
iv. Escolha a opção Conta de Computador e avance até o final com as opções padrão fechando a tela em seguida até que apareça a tela abaixo. IMPORTANTE: VOCE DEVE ALTERAR A OPÇÃO PARA CONTA DE COMPUTADOR SENÃO O WEBSERVICE DO AUTENTICADOR NÃO IRÁ FUNCIONAR. v. Escolha o nó Pessoal dos certificados e clique com o botão da direita em cima dele, escolhendo a opção Todas as Tarefas/Importar. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 6/21
vi. Escolha o certificado original (mude o filtro da caixa de dialogo para aparecer o certificado original). vii. Digite a senha e deixe o restante das opções nas suas configurações originais indo até o final do processo. O certificado original e os certificados da cadeia certificadora (da empresa que gerou o certificado e das acima dela) deverão aparecer na tela instalados. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 7/21
viii. Marque todos os certificados que apareceram na pasta Pessoal EXCETO o certificado da sua empresa e mova-os (arrastando e soltando) para a pasta Certificados dentro da Pasta Autoridades de Certificação Raiz de Terceiros. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 8/21
b. Dar permissão para a conta que irá executar o WebService para acessar o certificado. i. Instalar ferramenta para configuração do certificado digital. Existe um instalador chamado WinHttpCErtCfg.msi que deve ser executado na máquina. Aceite o local padrão de instalação e certifique-se que a mesma foi concluída com êxito. ii. Anote o nome do diretório onde está localizado o certificado digital. Tenha também a senha privada do certificado. iii. Abra uma janela de comando digitando CMD.EXE <enter> na barra de execução do Windows. iv. Vá até o local onde o gerenciador de certificados foi instalado digitando cd \ <Local da Pasta Arquivos de Programas> \ WINDOWS RESOURCE KITS \ TOOLS <enter> ou o local onde você instalou a ferramenta. v. Dê permissão ao certificado no repositório da máquina (LOCAL_MACHINE) digitando: Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 9/21
WinHttpCertCfg g s <nome do certificado> -c LOCAL_MACHINE\MY a <nome do usuário ou conta> <enter> Exemplo: WinHttpCertCfg g s FUTURA c LOCAL_MACHINE\MY a SERVIÇO DE REDE Observações: Para saber o nome da conta, ver tópico Para saber o nome da Conta de Execução do WebService. Caso o caminho do arquivo de certificado ou conta tenha espaços, deve-se colocar aspas antes e depois dos mesmos. O nome do certificado pode ser visto na tela de gerenciamento de certificados (após o mesmo ter sido importado) e não precisa ser completo, bastando informar as primeiras letras corretamente. Caso o comando seja bem sucedido, ele irá retornar algo como na tela ACIMA. c. Exportar o certificado público para que ele esteja disponível para o WebService. i. Vamos agora aproveitar que estamos com o gerenciador de certificados aberto para exportar a chave publica do nosso certificado importado anteriormente. ii. Navegue até a pasta Pessoal / Certificados e clique com o botão da direita em cima do certificado escolhendo a opção Todas as Tarefas/Exportar. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 10/21
iii. Deixe todas as opções como padrão (particularmente, a opção de não exportar a chave particular do certificado) escolhendo o local para o certificado como sendo o local onde você criou o diretório virtual anteriormente. O nome do certificado pode ser o nome da empresa, ou como desejar. Importante: você deve informar o local correto pois senão o WebService não conseguirá acessar o certificado, repetindo: deve ser o diretório virtual criado anteriormente (por exemplo, c:\inetpub\wwwroot\futura\nfe). III. Cópia dos Arquivos a. Vamos copiar agora o pacote de binários NFe-Futura (binários para o WebService Autenticador NFE) para o diretório criado no passo Criação do diretório Virtual. b. Copie todos os arquivos exatamente como estão inclusive a pasta Bin - para dentro do diretório criado anteriormente. O jeito mais fácil é selecionar todos os arquivos com CRTL-C colando-os na pasta escolhida com CTRL-V. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 11/21
Atenção: Deve-se navegar até o conteúdo da pasta NFE-Futura (pacote de instalação da versão do Sispetro) copiando seu conteúdo para dentro do diretório anteriormente criado. IV. Configuração Final Pasta Virtual Devemos alterar a versão ASP.NET desta pasta virtual para que seja correspondente à versão 2.0 e garantir acesso anônimo a esta pasta. a. Execute o gerenciador IIS correspondente à sua versão (II5 ou II6). Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 12/21
b. Clique com o botão da direita do mouse em cima da pasta virtual criada anteriormente escolhendo a opção Propriedades. c. Clique na Aba ASP.NET e mude a versão para a versão 2.0. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 13/21
d. Clique na Aba Segurança de Diretório e clique no botão Editar do grupo Autenticação e Controle de Acesso. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 14/21
e. Verifique que o acesso anônimo esteja habilitado e aceite as alterações fechando o gerenciador. Clique em OK para salvar a configuração. V. Teste para verificação de acesso ao WebService da Futura Para verificar se os passos, pelo menos de copia dos arquivos e configuração do IIS, estão corretos, aponte o browser na mesma máquina ou da máquina onde o servidor sispetro está sendo executado digitando: HTTP://localhost/Futura/NFE/AutenticacaoNfe.asmx Observações: Substitua o localhost pelo IP da máquina onde está sendo executado o WebService caso esta não seja a mesma máquina. Substitua o /Futura/NFE pelo alias criado no passo inicial deste roteiro. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 15/21
Caso a tela não seja essa, volte e revise passo a passo o roteiro pois não está sendo possível acessar o WebService. VI. Configuração Servidor Sispetro O servidor Sispetro não precisa necessariamente estar sendo executado no mesmo computador do WebService. A única configuração necessária nele visa indicar onde está sendo executado o WebService. Para tanto, devemos fazer o seguinte: 1. Acessar a tela de configuração do servidor Sispetro. 2. Parar o serviço clicando no botão Parar Servidor. 3. Preencha o campo Endereço Autenticador NFe com o endereço publicado do Web Service autenticador. Importante: este é o endereço publicado e não o endereço físico da máquina. No exemplo acima, o endereço publicado seria HTTP://localhost/Futura/NFe 4. Reinicie o servidor Sispetro. VII. Configuração do Certificado Digital no Internet Explorer No menu Ferramentas->Opções da Internet Acesse a aba Conteúdo Clique no Botão Certificados. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 16/21
Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 17/21
Clique em Importar e siga o assistente de importação do certificado digital seguindo as configurações padrões. ATENÇÃO: Ao selecionar o arquivo do Certificado Digital informe o arquivo com extensão.pfx VIII. Verificação da URL da sua Secretaria da Fazenda É necessário verificar se o acesso da sua empresa está liberado realmente na Secretaria da Fazenda do seu estado. Para isso, consulte no SisPetro, no menu Tabelas Auxiliares / Faturamento / UF s a URL para Homologação: Utilize uma das URL s no Internet Explorer, acrescentando a extensão.wsdl: HTTPS://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/Services/NFeRecepcaoSoap.wsdl Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 18/21
Verifique na figura acima que está dando erro do Certificado. Neste caso é porque o Certificado da Secretaria da Fazenda do seu Estado não possui uma cadeia de certificação válida. Perceba que este certificado deve ser oriundo de uma certificadora registrada e oficial ou a secretaria deve fornecer os outros certificados que correspondem aos certificados da credenciadora que emitiu o certificado para ela, secretaria. Por exemplo, da mesma forma que a sua empresa tem um certificado emitido pela SERASA, para que o seu certificado funcione, o certificado da SERASA deve estar instalado na sua máquina para que se possa verificar a autenticidade do seu certificado e da credenciadora que o emitiu. Para resolver isso é necessário: a) Entrar em contato com a Secretaria da Fazenda para obter mais informações e eventualmente um link para onde obter a cadeia de certificados da empresa que criou o certificado deles. b) Importar esta cadeia de certificados (similar ao que foi feito na importação do Certificado da sua empresa no item II Configuração do Certificado), no ramo Autoridades de Certificação raiz de terceiros, clicando com botão direito Todas as tarefas Importar Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 19/21
IMPORTANTE: Repita o teste no Internet Explorer até ser apresentada a estrutura do WebService, num só passo, sem erro de Certificado ou mensagens adicionais. IX. Para saber o nome da Conta de Execução do WebService O nome desta conta é fundamental para o esquema de trocas de certificados funcionar. Assim, vamos exemplificar com as duas versões do IIS. IIS 5.0 (Sistema Operacional Windows 2000 ou Windows XP) A conta que deve ser dada permissão é a conta chamada ASPNET. IIS 6.0 (Sistema Operacional Windows 2003) I. Abra o gerenciador do IIS. II. Clique com o botão da direita em cima do diretório virtual criado, escolhendo a opção de menu Propriedades. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 20/21
III. Anote o conteúdo do campo Pool de Aplicativos (normalmente DefaultAppPool). Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 21/21
IV. Feche a janela e navegue no gerenciador do IIS na pasta Pool de Aplicativos clicando com o botão da direita do mouse em cima do nome do pool encontrado no item anterior (normalmente DefaultAppPool), escolhendo a opção Propriedades. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 22/21
V. Clique na Aba Identidade e anote o nome que aparece da identidade (normalmente Serviço de Rede). Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 23/21
Este é o nome da conta a qual deve ser dada acesso (não esqueça de digitar entre aspas e com o ç, exatamente como se lê: SERVIÇO DE REDE, caso seja esta a conta). X. Verificação extensão de Serviços da Web No IIS, veja o ramo Extensões de serviços da Web. Do lado direito deve ter Aspnet 2.0. Caso não tenha, utilize a opção, na parte central da tela, Adicionar uma nova extensão de serviço da Web... escolhendo o arquivo aspnet_isapi.dll. constante em c:\windows\microsoft.net\framework\v2.0.50727 XI. Verificação compartilhamento/segurança do ASPNET No Explorer, localize a pasta do Microsoft.NET. Na pasta Temporary ASP.NET Files, com botão direito, escolha Compartilhamento e Segurança e depois na aba Segurança verifique se o usuário do IIS está presente (conforme Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 24/21
figura). Caso não esteja, clique em Adicionar. Roteiro de Instalação Nota Fiscal Eletrônica versão 1.0 de 16/01/2008 25/21