SanNFe

MANUALSANNF-E SANKHYA GESTÃO DE NEGÓCIOS SANKHYA Business Partners Copyright © 2006 SANKHYA Tecnologia em Sistemas Ltda. Todos os direitos reservados. Proibida a reprodução parcial ou total por qualquer meio, seja este eletrônico, mecânico, de fotocópia, de gravação, ou outros, sem prévia autorização, por escrito da SANKHYA Gestão de Negócios. Barras Laterais INSTALAÇÃO DO SANNFE Índice Introdução................................................................................................................................................... 4 Possíveis cenários de instalação do SanNFe: ............................................................................................... 4 Empresas onde se emitem apenas NFe .........................................................................................................4 Empresas onde se emitem apenas NFSe .......................................................................................................4 Empresas onde se emitem tanto NFe quanto NFSe ........................................................................................4 Instalação do SanNFe - Linux ...................................................................................................................... 5 Como Inicializar o Serviço no Linux ............................................................................................................... 11 Instalação SanNFe – Windows .................................................................................................................. 12 Como Inicializar o Serviço no Windows .......................................................................................................... 12 Importação do Certificado da Empresa ...................................................................................................... 16 Console NFe ............................................................................................................................................... 19 Aba Registro de Certificados...................................................................................................................... 19 Aba Status do Serviço .............................................................................................................................. 27 Instalação para Nota Fiscal Eletrônica de Serviços .................................................................................... 28 1. Instalação do aplicativo (Nota Fiscal Eletrônica de Serviço) na pasta do Usuário ............................................ 28 2. Instalação do SankhyaW para utilização do console NFSe ........................................................................... 29 2.1 O Cliente NÃO possui o SankhyaW em contrato ..................................................................................... 29 Configurações ............................................................................................................................................ 29 Conexão com Internet ............................................................................................................................... 30 Configurações de Proxy ............................................................................................................................... 31 Características do painel de testes ................................................................................................................ 33 Schemas no SanNFe .................................................................................................................................. 36 Envio de Eventos ........................................................................................................................................ 38 -3- NFe Entende-se por Nota Fiscal Eletrônica um documento de existência exclusivamente digital. gerado e armazenado eletronicamente em Ambiente Nacional pela RFB. cuja validade jurídica é garantida pela assinatura digital do emitente e recepção. Essa pasta irá variar dependendo da versão do sistema operacional. antes da ocorrência do fato gerador. atendendo o Protocolo de Cooperação ENAT nº 02. para documentar as operações de prestação de serviços.Somente pela linha /W . de 7 de dezembro de 2007. pelo fisco. onde “X” será o drive a ser utilizado. NFSe A Nota Fiscal de Serviços Eletrônica (NFS-e) é um documento de existência digital. etc) . No Linux a pasta é “home/mgeweb”. . POSSÍVEIS CENÁRIOS DE INSTALAÇÃO DO SANNFE: Quando o sistema precisa emitir NF-e ou NFS-e. A Nota Fiscal de Serviços Eletrônica (NFS-e) é habilitada pelo opcional: Nota Fiscal de Serviço Eletrônica (NFS-e). com intuito de documentar uma operação de circulação de mercadoria.Somente pela linha gráfica (Mitra/G1. essa validação é executado pelo SanNFe antes da execução do serviço. O projeto de Nota Fiscal de Serviços Eletrônica (NFS-e) é desenvolvido de forma integrada. que atribuiu a coordenação e a responsabilidade pelo desenvolvimento e implantação do Projeto da NFS-e. na pasta de usuário do sistema operacional que executa a aplicação.Somente pela linha /W . ocorrida entre as partes.Misto (pode-se usar linha /W ou gráfica) O SanNFe deve estar instalado no servidor de aplicações que roda o SankhyaW.Misto (pode-se usar linha /W ou gráfica) EMPRESAS ONDE SE EMITEM TANTO NFE QUANTO NFSE . pela prefeitura ou por outra entidade conveniada. EMPRESAS ONDE SE EMITEM APENAS NFE . no Windows sugerimos utilizar a pasta “X:\SanNFe“.Misto (pode-se usar linha /W ou gráfica) EMPRESAS ONDE SE EMITEM APENAS NFSE . etc) . Todo serviço que é consumido pela aplicação deve antes passar por uma validação. pela Receita Federal do Brasil (RFB) e Associação Brasileira das Secretarias de Finanças das Capitais (Abrasf). emitido e armazenado eletronicamente.Somente pela linha /W . ele precisa obrigatoriamente que o SanNFe seja instalado.INTRODUÇÃO O SanNFe é a aplicação responsável pela comunicação com os serviços disponibilizados pela Receita Estadual e Federal para emissão de ‘Nota Fiscal Eletrônica’ (NFe) e da ‘Nota Fiscal de Serviços Eletrônica (NFS-e)’.Somente pela linha gráfica (Mitra/G1. INSTALAÇÃO DO SANNFE INSTALAÇÃO DO SANNFE . SCP ou qualquer outro aplicativo de transferência de arquivo. -5- .LINUX O arquivo de “Instalação” do SanNFe deve ser transferido para o servidor por algum aplicativo como.FTP. Winscp. INSTALAÇÃO DO SANNFE -6- . como o Putty. No exemplo anterior o programa utilizado para acessar o servidor foi o Putty. veja imagens a seguir: -7- . e a instalação/atualização do SanNFe foi transferido. Caso o servidor não tenha o serviço SSH em execução. a atualização/instalação deve ser realizada na própria máquina. pelo console ou por algum cliente de SSH. para o servidor “serverjava”.INSTALAÇÃO DO SANNFE Para atualizar/instalar o SanNFe será preciso ter acesso ao servidor Linux. Veja: O comando “ls” listará os arquivos (pastas) do diretório corrente. No caso de uma atualização. o SanNFe deve ser finalizado. para isto o usuário deverá acessar a pasta do SanNFe ([daniel@serverjava ~]$ cd SanNFe) e executar o comando comando “. antes de fazer o backup da instalação atual./sannfe-service stop”.INSTALAÇÃO DO SANNFE Backup de uma instalação anterior do SanNFe Arquivo de Instalação/Atualização do SanNFe que foi transferido. como mostra a imagem a seguir: -8- . neste exemplo de atualização. Backup da Versão Atual -9- .INSTALAÇÃO DO SANNFE O Backup da versão atual. pois pode-se visualizar as pastas "SanNFe-ant" e "SanNFe-ant2" de versões anteriores. será o "SanNFe-ant3". gz" será utilizado pra descompactar a Instalação/Atualização. depois de descompactada a instalação. Na atualização.tar.INSTALAÇÃO DO SANNFE O comando "tar -xzvf SanNFe_unix_2_0b38. os arquivos de “Configurações” e “Certificados” da versão anterior deverão ser copiados para a nova versão. . Esse comando criará a pasta "SanNFe" com a nova versão.10 - . 11 - .INSTALAÇÃO DO SANNFE COMO INICIALIZAR O SERVIÇO NO LINUX Após a instalação do SanNFe-Linux. o serviço será inicializado pelo comando: . dentro do diretório do SanNFe./sannfe-service start Como mostra a imagem abaixo: . então.12 - . No Windows sugerimos utilizar a pasta “X:\Users\Nome do Usuário\SanNFe“.INSTALAÇÃO DO SANNFE INSTALAÇÃO SANNFE – WINDOWS Essa instalação deve ser feita no diretório onde foi instalado o SankhyaW (JBoss). onde “X” será o drive a ser utilizado. COMO INICIALIZAR O SERVIÇO NO WINDOWS Após a instalação do SanNFe – Windows. O SanNFe é disponibilizado em arquivo compactado. o serviço poderá ser inicializado de três formas: . Exemplo: “C:\Users\Joao\SanNFe“. bastará descompactá-lo. exe = esta forma de inicialização do serviço poderá ser utilizada quando o cliente fizer a instalação do SanNFe. ao invés de utilizar o arquivo de instalação compactado. 3) SanNFe-service.exe = esta opção é mais utilizada para teste e abrirá uma janela de console no DOS.exe = esta opção de inicialização é semelhante a anterior.13 - . Através desta opção o SanNFe será inicializado como um serviço do Windows. se devidamente configurado como mostram as imagens abaixo: . É a forma de inicialização mais utilizada pelos usuários. nenhum console é apresentado ao usuário e o ícone do SanNFe será exibido diretamente na Barra de Ferramentas. e poderá ser inicializado automaticamente junto com o Windows. O ícone do SanNFe será exibido na Barra de Ferramentas. 2) SanNFe-Win.INSTALAÇÃO DO SANNFE 1) Sannfe-console. contudo. onde o usuário poderá verificar possíveis erros. INSTALAÇÃO DO SANNFE .14 - . 15 - .INSTALAÇÃO DO SANNFE . conforme exemplo: http://IPdoServidorSannfe:porta/NFE. É importante comentar que essa data de validade do registro de certificados exportados não tem relação e não é a mesma da data de expiração do certificado digital. é somente a data de validade de utilização do certificado digital no SanNFe. Para acessar o Console o usuário deverá digitar na barra de endereços do browser o endereço contendo o IP da máquina (servidor SanNFe) e a Porta seguidos de NFE.16 - .htm.htm Importante: Com a finalidade de aumentar a segurança e evitar a utilização de certificados digitais em ambientes de produção. existe no exportador de registro de certificados do SanNFe a opção para definir em qual ambiente (1-Produção. Isto será feito pelo menu “Comercial\Configuração\Console NFe”. Também há uma opção para definir uma data de validade para o registro do certificado exportado. . A configuração de ambiente e data de validade é única para todos os registros exportados.INSTALAÇÃO DO SANNFE IMPORTAÇÃO DO CERTIFICADO DA EMPRESA Atenção: Para a “Instalação” tanto no Linux quanto no Windows. 2-Homologação e 3-Ambos) os certificados exportados poderão ser utilizados. o usuário deverá importar o “Certificado da Empresa”. Na Exportação: Na Exportação superior a “Maior Data de Validade” calculada para o certificado(s) selecionado(s).INSTALAÇÃO DO SANNFE Exemplo: Cliente X no dia 15/03/2012 exporta o certificado para realização de testes no SankhyaW. O mesmo é valido para ambiente que . que o certificado poderá ser usado apenas em ambiente de homologação e no máximo até o dia 18/03/2012. O cliente então configura na Exportação. 2-Certificados com data de expiração e data de validade: Será utilizada a maior data de validade do(s) certificado(s) selecionado(s). ignorando a data de expiração. O cálculo da “Maior Data de Validade” é efetuado da seguinte forma: 1-Certificados com somente data de expiração: Será utilizada a maior data de expiração do(s) certificado(s) selecionado(s). a data a ser verificada no processo de exportação será a data de validade e não a data de expiração do(s) certificado(s).17 - . No caso em que os certificados escolhidos já passaram pelo processo de exportação e importação utilizando uma data de validade e ambiente. A finalidade para esse comportamento é de evitar que certificados sejam repassados aumentando os direitos recebidos (importados). Exemplo de certificados que podem ser encontrados nesta situação: Certificados que foram adicionados no SanNFe e que não passaram pelo processo de importação/exportação. ou somente em homologação. o mesmo conseguirá exportá-lo e importálo normalmente. 2) Consta no SanNFe 5 certificados com data de expirações diversas e as seguintes datas de validade: 01/05/2012. uma data de validade superior a esta. 15/09/2012 e 10/12/2012. que no caso será 10/12/2012. o sistema levará em consideração para validação a data de validade existente. 3) Caso o usuário tente exportar como PRODUÇÃO (por exemplo. isso significa que o mesmo conseguirá utilizá-lo em ambiente de homologação e em ambiente de produção.18 - . HOMOLOGAÇÃO E AMBOS. a data de expiração. OBS: Não é permitido informar uma data de validade superior a já existente. pois a mesma validação também é válida para Homologação) um certificado que já tenha sido importado para uso somente em ambiente de Homologação. por exemplo. 25/05/2012. Se o usuário informar. por isso ele consegue exportá-lo. ou seja. o sistema não permitirá e emitirá a seguinte mensagem: ‘O certificado digital referente ao CNPJ: xxxxxxxxxxx não pode ser utilizado nesse ambiente: 1-Produção. ignorando assim. será alertado com a seguinte mensagem: ‘A data de validade não pode ser inferior a data atual. 3.2: Se o usuário possui um certificado o qual havia sido exportado como AMBOS. mas se exportar somente em produção. será alertado com a seguinte mensagem: A data de validade xx/xx/xxxx 00:00 não pode ser superior a maior data de expiração/validade do(s) certificado(s) selecionados 10/12/2012. o usuário terá a opção de exportá-lo em PRODUÇÃO.3-Ambos). conseguirá utilizá-lo somente no ambiente exportado. Caso seja necessário exportar este certificado novamente. quando o usuário for exportá-lo novamente. . data de validade 20/08/2013 e ambiente = Homologação.2- Validações: 1) Consta no SanNFe um certificado com data de expiração 01/01/2014. mas ao tentar utilizá-lo como PRODUÇÃO. Exemplo: O usuário exportou um certificado com data de validade até 20/03/2012 e tentou importá-lo no dia 25/03/2012. OBS: Na própria tela já é apresentada a maior data limite seguindo as validações dos exemplos 1 e 2. não faz sentido ele conseguir exportar e utilizar este mesmo certificado em ambiente de produção. 4) Caso o usuário tente exportar um certificado (independente do ambiente) com uma data de validade para uso no SanNFe inferior a data atual.’ 3. Ao tentar realizar esta operação o sistema emitirá uma mensagem de erro.O sistema não irá permitir a importação de certificados que já estejam com a sua data de validade expirada. 22/06/2012. se o usuário recebeu um certificado o qual pode utilizá-lo somente em ambiente de Homologação. Neste caso.1: A finalidade para esse comportamento é de evitar que certificados sejam repassados aumentando os direitos recebidos (importados). Quando o usuário selecionar os certificados e solicitar a exportação. a data a ser informada não poderá ser superior a maior data de validade dentre os certificados selecionados. para certificado(s) com ambiente 3 (1-Produção.INSTALAÇÃO DO SANNFE somente poderá ser alterado Homologação. mas não consegue utilizá-lo.’ Na Importação: . O Certificado do tipo A1 é gerado e armazenado em um computador pessoal através do navegador de Internet. recomenda-se que um único computador armazene seu Certificado Digital e que seja criada apenas uma cópia de segurança. no momento da emissão do certificado. .pfx). dispensando o uso de cartões inteligentes ou tokens.Na utilização do certificado importado será feito validação em relação à data de validade de utilização do certificado no SanNFe. possui validade de um ano. Essa cópia de segurança do certificado é que será usada pelo usuário para inseri-lo no SanNFe. O do tipo A3 não é suportado.19 - . deve-se optar por protegê-lo com uma senha de acesso. geralmente. CONSOLE NFE Na tela “Console NFe” o usuário deverá informar: ABA REGISTRO DE CERTIFICADOS Certificado: o SanNFe suporta apenas certificado tipo A1 (PKCS nº 12.INSTALAÇÃO DO SANNFE . *. Para maior segurança. Adicionalmente. Este certificado digital. localizado na parte superior da janela do Internet Explorer. 3 – Na janela “Opções da Internet” (Internet Options) clicar na guia “Conteúdo” (Content). Este botão fica localizado no meio da janela. o usuário deverá seguir os passos abaixo. 4 – Na guia “Conteúdo” (Content) clicar no botão “Certificados” (Certificates). usando. .INSTALAÇÃO DO SANNFE Para realizar essa Exportação do Certificado. 2 – Clicar no menu “Ferramentas” (Tools).20 - . Em seguida clicar no item “Opções da Internet” (Internet Options). por exemplo. Esta guia fica localizada na parte superior da janela. o navegador Internet Explorer: 1 – Abrir o Microsoft Internet Explorer. O usuário deverá verificar se o seu certificado é exibido na guia “Pessoal” (Personal).INSTALAÇÃO DO SANNFE 5 – Será exibido o “Gerenciador de certificados” (Manager Certificates) do Internet Explorer.21 - . . . exportar a chave particular” (Yes. Clique no botão “Avançar” (Next). export the private key) e clicar no botão “Avançar” (Next).INSTALAÇÃO DO SANNFE 6 – Ao clicar no botão “Exportar” (Export) será exibido um assistente conforme a imagem abaixo.22 - . 7 – Na etapa seguinte selecionar a opção “Sim. 23 - . Clicar no botão “Avançar”. Para isto. selecionar a opção “Incluir todos os certificados no caminho de certificação”.INSTALAÇÃO DO SANNFE 8 – Na etapa abaixo. Após digitar as senhas. 9 – Na janela “Senha de proteção para chaves particulares” digitar uma senha para a cópia de segurança. confirmá-las no campo “Confirmar senha” (Confirm Password). é aconselhável que o usuário exporte todos os certificados pertencentes à cadeia de certificação. . Desta forma. .INSTALAÇÃO DO SANNFE 10 – Na janela “Nome do arquivo de exportação” clicar no botão “Procurar” (Browser). será possível escolher o local onde a cópia de segurança será salva assim como digitar um nome para o arquivo.24 - . . clicar no botão “Salvar” (Save).25 - . Após definir ambos.INSTALAÇÃO DO SANNFE 11 – Na janela “Salvar como” (Save as) escolher o local onde será salva a cópia de segurança e também o nome para o arquivo. 12 – A última etapa do “Assistente para exportação de certificados” exibe as configurações selecionadas pelo usuário. Clicar no botão “Concluir” (Finish). Obs: O e-CPF não pode ser utilizado para a NF-e. clicar no botão “Ok” conforme a imagem abaixo. informar: CNPJ/e-CPF: Informa-se o CNPJ da empresa. 14 – Por fim. o e-CPF é utilizado em algumas situações para envio de Nota Fiscal de Serviço Eletrônica. NFS-e. Estado: UF da empresa . O ideal é utilizar um e-CNPJ. a ser emitido especificamente para o processo de assinatura de NF-e. não é o mais indicado. no entanto.26 - . Clicar no botão “Ok”.INSTALAÇÃO DO SANNFE 13 – Será exibido o alerta “Um aplicativo está solicitando o acesso a um item protegido”. Já as demais prefeituras homologadas para emitir NFS-e exigem o e-CNPJ (CNPJ digital). Voltando à tela “Console Nota Fiscal Eletrônica\aba Registro de Certificados”. já o e-CNPJ pode. Exemplo: A prefeitura da cidade de Aparecida exige e-CPF (CPF digital). : Vale ressaltar que esta mensagem é apenas do Servidor de NF-e onde serão cadastradas as Empresas/CNPJ e seus certificados. deverão estar devidamente configurados/cadastrados.27 - . selecionar o CNPJ da Empresa previamente cadastrada conforme as instruções anteriores e clicar no botão “Executar”. como mostra imagem a seguir: . Informações do Certificado Após preencher os campos obrigatórios clicar em “Salvar o Registro”. ABA STATUS DO SERVIÇO Para testar se o serviço esta “OK” para o CNPJ/Certificado cadastrado. Obs. A partir da versão 2. apresentando o seguinte retorno destacado em vermelho na imagem abaixo. sendo que para o perfeito funcionamento da integração entre o Sistema e a SEFAZ. ao acionar o botão “Testar” nesta tela será apresentado o status e descrição do status retornado pela SEFAZ. deve-se acessar esta aba.INSTALAÇÃO DO SANNFE Senha: Fornecida pela certificadora.3b30. além da validação sobre a execução do serviço. caso a operação esteja “Ok” junto a SEFAZ. todas as configurações dos campos citados no manual da Nota Fiscal Eletrônica referente ao Sistema. o sistema efetuará uma consulta sobre a disponibilidade do serviço junto a SEFAZ. Exemplo: A versão para Windows é disponibilizada em formato ‘zip’. Já no Windows seria “c:\Documents and Settings\UsuarioQueAdministraOSankhyaW“. bastará descompactar no diretório do usuário. f = arquivo (próximo parâmetro). O SanNFe é disponibilizado em arquivo compactado. está disponível a partir da versão 2. . No Linux utiliza-se o usuário padrão mgeweb. então. A inclusão do SanNFe deve ser feita no diretório do usuário que manipula o SankhyaW. o diretório no qual seria descompactada a aplicação. bastará utilizar o comando ‘tar’. seria o “/home/mgeweb”. com os devidos parâmetros para descompactação: x = extrair.INSTALAÇÃO DO SANNFE Para teste de ‘Status do Serviço’ para o ‘SCAN’ também será apresentado se este está ou não habilitado para a ‘UF’ selecionada: INSTALAÇÃO PARA NOTA FISCAL ELETRÔNICA DE SERVIÇOS A Nota Fiscal Eletrônica de Serviço. portanto. a instalação do aplicativo responsável pela comunicação com os serviços disponibilizados para emissão de ‘Nota Fiscal Eletrônica de Serviços’ (NFSe) consiste.28 - .gz e para a descompactação. INSTALAÇÃO DO APLICATIVO (NOTA FISCAL ELETRÔNICA DE SERVIÇO) NA PASTA DO USUÁRIO Instalação do SanNFe Instalação do Console para NFSe.0 do SankhyaW. resumidamente. após ter copiado o arquivo para a pasta “/home/mgeweb”. z = gzip. é distribuído no formato tar. v = exibe informações. Bastará ao usuário utilizar o descompactador de sua preferência. e executar a extração diretamente para a pasta onde foi instalado o SankhyaW. em apenas dois passos: 1. O arquivo compactado da versão Linux.3. contendo apenas o necessário para o Console NFSe.execucoes.conf” localizado na pasta ‘conf’ do diretório onde foi instalado o SanNFe: Em um primeiro cenário: tempo. bastará solicitar a atualização do SankhyaW para a versão 2.29 - .webservice=30000 (30 segundos) numero.INSTALAÇÃO DO SANNFE 2. CONFIGURAÇÕES Existem algumas configurações para melhorar o desempenho de envio de Notas Fiscais Eletrônicas.webservice=2 tempo. Vale ressaltar que o pacote de atualização é gerado conforme o contrato(s) do cliente e os produtos contidos no(s) contrato(s). Abaixo. Importante: O Jboss utilizado nessa instalação “mínima” é um JBoss versão 4.tentativas.1 O CLIENTE NÃO POSSUI O SANKHYAW EM CONTRATO Quando o cliente adquire o console NFSe.webservice=500 (não pode ser menor que 500) 1/2 segundo As configurações são: tempo.5.webservice número máximo de tentativas de execuções do webservices valor padrão = 2 .0 ou superior.3. visando otimizar a performance no servidor de aplicações JBoss. Apesar do pacote (arquivo.webservice tempo máximo para execução do webservice padrão = 30000 (30 segundos) numero.pkg) e o JBoss serem específicos para essa instalação. para atender a NFSe.0.max. portanto.execucoes.execucoes. o processo é o mesmo contido no manual de Instalação/Atualização do SankhyaW.execucoes. INSTALAÇÃO DO SANKHYAW PARA UTILIZAÇÃO DO CONSOLE NFSE O console da NFSe está contido dentro do SankhyaW. algumas dessas configurações que devem ser realizadas no arquivo “san-nfe. é feita então uma instalação personalizada do SankhyaW. 2.execucoes.max.tentativas. customizado pela Sankhya. NÃO DEVE SER UTILIZADO OUTRO PARA ESTE TIPO DE INSTALAÇÃO. mas não o SankhyaW. Essa atualização usa um pacote de bibliotecas e recursos minimizados.espera. que está disponível na área restrita do site da Sankhya. espera. CONEXÃO COM INTERNET O SanNFe necessita de conexão com a internet para consumir os serviços da Receita Estadual ou Federal. Jiva ou Sankhyaw. Na segunda execução ocorreu o erro novamente em menos de 5 segundos. Exemplo de caso considerando os valores configurados anteriormente: O SanNFe executou o serviço de envio de lote de uma NFe. o SanNFe tentará executar o mesmo serviço 2 vezes. Nesse caso. Por isso.max. Por esse motivo devem-se realizar testes de conectividade para evitar problemas na execução dos serviços. o SanNFe não executa a validação da conexão.max.execucoes. irá ocorrer falha ao executar o serviço. . ou seja. O SanNFe vai tentar executar o serviço aproximadamente 3 vezes.espera. nesse caso.5 segundos são menores que 30 segundos e esta é a primeira execução. 10 + 1/2. Contudo.30 - .INSTALAÇÃO DO SANNFE tempo.execucoes. quando a máquina não tem conexão com a Internet.tentativas. Dessa forma não será mais executado nenhum serviço Segundo cenário: tempo.execucoes. A lista de URLs informada no ‘Console’ tem por objetivo validar se a máquina a qual o SanNFe está instalado tem conexão com a Internet.execucoes.webservice=2 tempo. e ao executar esse serviço ocorreu um erro qualquer. na emissão da Nota pelo MGE. Entre cada tentativa aguardará 1/2 segundo. já se chegou ao máximo de tentativas que é de 2 (duas). Na instalação do SanNFe essa lista de URLs vem vazia.webservice=40000 numero.webservice=500 No caso acima se a execução de algum serviço falhar. considerando o tempo máximo de 30 segundos. Mitra.webservice=30000 numero.webservice tempo de espera entre execuções do webservice padrão = 500 (metade de um segundo) Essas 3 parametrizações poderão ser utilizadas em conjunto: Como exemplo. o serviço foi executado novamente. considere os seguintes valores: tempo.webservice=500 Levando em consideração que cada execução leva 10 segundos até ocorrer o erro. antes de executar algum serviço.execucoes. esse valor ainda esta abaixo dos 30 segundos que é o máximo.execucoes. O tempo que foi gasto até ocorrer o erro foi de 10 segundos.execucoes.espera.tentativas. Total de espera. Como 10.webservice=5 tempo. ele vai entrar em espera por aproximadamente 1/2 segundo. totalizando 16 segundos (somando com a execução anterior). Não utilizar Proxy para os endereços: informar os endereços que não serão considerados na utilização do ‘Proxy’. não será permitido à execução de nenhum serviço. a aplicação considera o teste bem sucedido para primeira URL acessada. fará com que o SanNFe pare de funcionar.11) Para utilizá-lo é necessário efetuar a configuração do ‘Proxy’ no SanNFe: Comercial>Configuração->Console NFe->Aba Administração Habilitar uso do Proxy: Se marcado. uma configuração incorreta do ‘Proxy’.31 - .porta • sem.br. Porta: A porta utilizada no ‘Servidor Proxy’.0b30 – MGE\Jiva versão 3. Caso exista mais de uma URL na lista. CONFIGURAÇÕES DE PROXY O SanNFe apresenta suporte a utilização do ‘Proxy’ (SankhyaW versão 2.gov. Quando não há conexão.endereco • proxy.para A configuração de ‘Proxy’ tem impacto em toda a parte de comunicação externa do SanNFe. indicará que o parceiro utiliza ‘Proxy’ no acesso a Internet. como ‘porta’ ou ‘endereço’.INSTALAÇÃO DO SANNFE Quando não configurado o teste. por isso.receita. não sendo possível executar nenhum serviço da ‘SEFAZ/Prefeitura’ . será incluso na mensagem de erro. que a possível causa pode ser a falta de conexão.habilitado • proxy. As informações de configuração de ‘Proxy’ são salvas no arquivo de configuração do SanNFe por meio das seguintes propriedades (seguindo a mesma ordem dos campos apresentados na imagem acima): • proxy.3. O teste de conexão consiste num acesso bem sucedido ao site endereçado pela URL. a fim de facilitar a detecção de problemas.proxy. se ocorrer o erro na execução. o SanNFe passa a validar a conexão por meio dessa URL.fazenda. utilizando para isto a URL: http://www. Quando é informada alguma URL da lista. Os campos da configuração do ‘Proxy’ somente serão salvos quando acionado o botão ‘Salvar’. o SanNFe fará o teste de conectividade. Endereço: Deve-se informar o ‘IP’ ou endereço do ‘Servidor Proxy’. Em caso de falha. Para incluir a configuração de rede inclui-se a ACL: acl localnet src 192. incluir a ACL: acl govBr dstdomain . Essa regra fará com que todos os serviços de NFe sejam executados. .56.xml e conf/provedores-nfse. Essa linha vem por padrão no arquivo de instalação do Squid.INSTALAÇÃO DO SANNFE bem como qualquer teste de 'Conexão com a Internet' configurado na aba 'Status do Serviço'.com liberação para acesso por rede. Com o ‘Proxy’ configurado para solicitar a autenticação do usuário. Veja a seguir algumas configurações e análises que são técnicas e devem ser analisadas pelo pessoal da área de ‘TI’ da empresa: Detalhes de Configuração do Proxy 1.br no arquivo de configuração.x Em seguida é necessário atribuir acesso a acl localnet com a seguinte linha: http_access allow localnet *OBS. para que não sejam solicitadas autenticações para as mesmas.168. tenha acesso ao mesmo. é necessário criar uma ACL e atribuir acesso a essa ACL antes da instrução de autenticação do usuário no arquivo de configuração. Essa mesma regra deve ser considerada para as URLs de NFSe que não tem o mesmo padrão das URLs de NFe. Junto com a instalação do squid vem um arquivo padrão de configuração /etc/squid/squid. Para obter a lista completa de URLs que devem ser liberadas para o SanNFe basta editar os arquivos: conf/url-webservices. Para saber se as configurações estão corretas. Antes da linha que libera o acesso para usuários autenticados deve ser incluída a linha: http_access allow govBr. 2. As configurações devem ser realizadas tendo por base esse arquivo. Para isso. Proxy sem autenticação .: Para que sejam permitidas conexões HTTPS pelo ‘Proxy’ é necessário existir a linha: http_access deny CONNECT !SSL_ports. deve-se ir à Aba ‘Status do Serviço’.32 - . Essa configuração permite que seja acessado qualquer URL que tenha como final no seu domínio gov.br . na opção de ‘Configuração e teste de conectividade com a Internet’ e informar endereços para análise.0/24 essa acl permite acesso a qualquer máquina que pertença a rede 192.xml. Proxy com autenticação – quando o ‘Proxy’ é configurado para solicitar a autenticação de usuários é necessário liberar as URLs utilizadas pelo SanNFe. essa configuração permite que qualquer máquina que esteja na mesma rede do servidor ‘Proxy’.56.gov.conf.168. .33 - .INSTALAÇÃO DO SANNFE CARACTERÍSTICAS DO PAINEL DE TESTES Para adicionar uma URL na lista.br Em seguida. exemplo: http://www. selecionar o botão com ícone de “Adicionar” (+) para incluí-la na lista. basta informar o endereço válido.com.sankhya. conf). . esse botão salvará a lista de URLs no arquivo de configuração do SanNFe (conf/san-nfe.INSTALAÇÃO DO SANNFE Depois de adicionado as URLs é necessário acionar o botão “Salvar Lista”. um ícone na cor vermelha é apresentado. um teste bem sucedido marca a URL com o ícone na cor verde.34 - . caso contrário. O botão “Testar” efetua o teste de conexão para todas as URLs incluídas na lista. Para que o usuário não tenha que liberar acesso completo da máquina. onde cada URL é separada por vírgula.http://www. Como exemplo as URLs dos webservices para o estado de MG são: .urls=http://www. basta liberar por meio de NAT (Network Address Translation).INSTALAÇÃO DO SANNFE A lista de URL é armazenada no arquivo de configuração do SanNFe por meio da propriedade: internet.br As URLs para execução de serviços Web (webServices) executados pelo SanNFe diferem de estado para estado. os endereços referentes ao estado (UF) que será emitido a NFe para a porta 443(HTTPS).com.sankhya. Por exemplo: internet.urls=<lista de URLs>.com.br.jiva.test.35 - .test. 1 – é necessário parar o SanNFe e iniciá-lo novamente. Como exemplo.xml ou no site da Receita Federal http://www.gov.mg.1. O SanNFe permite que os schemas disponibilizados pela SEFAZ possam ser configurados sem que haja alterações na aplicação. essa pasta foi copiada para dentro da pasta schemas do sannfe. a tarefa de manter a aplicação com os schemas atualizados fica sob responsabilidade da empresa ou monitores.gov.fazenda.mg.gov.br/portal/Default. Baixar a versão desejada.1.gov.nfe.1 – SankhyaW 4. será seguidos os passos apresentados acima.36 - .zip 2 – depois de descompactado foi criado a pasta PL_005f.mg.gov.br/nfe/services/NfeConsulta https://nfe.fazenda. por meio de definições contidas em arquivos do tipo XSD.2 – MGE/Mitra/Jiva 4.schemas= para o nome do diretório do novo schema.fazenda.gov.aspx SCHEMAS NO SANNFE A troca de mensagens entre o SanNFe e SEFAZ e realizada por meio de arquivos XMLs. o arquivo de configuração esta localizado na pasta conf ([diretório de instalação do SanNFe]\conf).br/nfe/services/NfeRecepcao https://nfe.gov. 2 – descompactar o arquivo baixado no passo 1. 3 – a propriedade no arquivo de configuração ficou da seguinte forma: versão.2.br para a porta 443.gov.gov.schemas=PL_005f .mg. 4.fazenda. 4. 3 – alterar o arquivo de configuração para que seja utilizado o novo schema. A lista dos endereços para os outros estados podem ser encontradas no arquivo de urls conf/url-webservices.2 – selecionar a opção ‘Forçar reinicialização’ 4.fazenda.mg.fazenda. alterar a propriedade: versao.fazenda.1 – selecionar a opção de menu Comercial->Configuração->Console NFe.mg.br/nfe/services/NfeInutilizacao https://nfe. denominados de schemas.fazenda.mg.fazenda. a seguir. A seguir são apresentados os passos para atualizar os schemas para o SanNFe: 1 – fazer download do arquivo compactado referente à versão que se deseja atualizar no site da Receita Federal: http://www.aspx Selecionar a opção do menu: Legislação e Documentos -> Schemas XML Serão apresentadas várias versões. portanto a validação é aplicada a esses arquivos.br/portal/Default. sendo assim. 4 – reinicializar o SanNFe. com exemplos de atualização do schema PL_005f: 1 – acessado o site foi baixado o arquivo: PL_005f.INSTALAÇÃO DO SANNFE https://nfe.br/nfe/services/NfeRetRecepcao https://nfe. Os shemas são disponibilizados e versionados pela Receita Federal. no diretório schemas do SanNFe ([diretório de instalação do SanNFe]\schemas).nfe.br/nfe/services/NfeCancelamento https://nfe.br/nfe/services/NfeStatusServico O endereço a liberar deve ser: nfe. 37 - . . Ao baixar uma nova versão o usuário deve observar se esta não se trata apenas de um release do schema. reiniciar o SanNFe. pois o mesmo os considera incompletos. com o novo schema carregado: Observação Importante: O usuário deve estar atendo ao baixar e configurar uma nova versão dos schemas no SanNFe. ao acessar o console de gerenciamento aba Administração será apresentado a versão do schema utilizada pelo sannfe. mas somente os que tiveram correções. não as funcionalidades da NFS-e não serão afetadas. Os schemas relacionados a NFS-e (Nota Fiscal Eletrônica de Serviço) são definidos por outra forma. em um release. ao atualizar os schemas da NFe descritos neste documento. pois a SEFAZ não inclui todos os arquivos. por isso.INSTALAÇÃO DO SANNFE 4 – depois disto. A imagem abaixo ilustra a aba descrita acima. Arquivos de schemas apenas de release fazem com que ocorram erros no SanNFe. nfe. A versão do schemas de “Carta de Correção Eletrônica” pode ser configurado no arquivo san-nfe. Os endereços para os outros estados também devem ser incluídos pelo cliente/monitor/consultor.6 para permitir o envio de eventos. A versão de desenvolvimento do SanNFe que deverá ser disponibilizada. também pode ser utilizado para os outros estados.asmx" /> Atenção Consultores e Monitores: Por ser um serviço que ainda não entrou em produção até a data dessa implementação (17/08/2011).conf no diretório conf na instalação do SanNFe. a “Carta de Correção Eletrônica”.00a. O envio de ‘Carta de Correção’ foi implementado seguindo os mesmos critérios pela Sefaz para a NFe.br/ws/recepcaoevento/recepca oevento. o valor padrão será setado na inicialização do SanNFe.6 já possui em sua instalação o diretório Cce_v1. O SanNFe 2.sefazvirtual. a mesma implementação efetuada e testada para o ambiente virtual.38 - .schemas.xml.6.gov. não foi disponibilizado o endereço de produção.9. e a inclusão de uma nova entrada no arquivo de configuração de urls-webservices.carta. junto com a versão 2. sendo necessário um novo diretório de schemas. A propriedade é: diretorio. fica na responsabilidade do cliente/monitor/consultor incluir esse endereço de produção quando divulgado pela Receita Estadual. por isso. (Veja detalhes da “Carta de Correção Eletrônica” no manual da NFe SankhyaW) . como por exemplo. O arquivo de configuração de URLs dos webservices também foi alterado para incluir o endereço do serviço de recepção de eventos.INSTALAÇÃO DO SANNFE ENVIO DE EVENTOS O SanNFe foi alterado na versão 2.0 do SankhyaW é a 2. por isso. que é a versão vigente do schemas.rs. As seguintes linhas foram incluídas para os serviços do estado de Santa Catarina: <url webService="NfeRecepcaoEvento" producao="" homologacao="https://homologacao. A implementação desse envio segue o mesmo padrão dos serviços já disponibilizado pela SEFAZ.correcao=<diretório> Quando não informado a opção acima.