Escolar Documentos
Profissional Documentos
Cultura Documentos
Credenciamento Como Emissor de Nota Fiscal Eletrônica V 3.1
Credenciamento Como Emissor de Nota Fiscal Eletrônica V 3.1
Verso 1 1 1 2 3 3
Reviso 0 1 2 0 0 1
Responsvel Vinicius Pimentel de Freitas Vinicius Pimentel de Freitas Dimitri Munari Domingos Dimitri Munari Domingos Dimitri Munari Domingos Dimitri Munari Domingos
Revisor Geraldo Scheilbler Geraldo Scheilbler Vinicius Pimentel de Freitas Geraldo Scheilbler Vinicius Pimentel de Freitas Vinicius Pimentel de Freitas
3. 4.
Programa Emissor de NF-e Disponibilizado pelo ENCAT _________________________ 5 Desenvolvimento/Adaptao do Sistema de Informaes da Empresa ________________ 5
Padres tcnicos de comunicao ____________________________________________________ 5 Conexo segura SSL: _____________________________________________________________ 5 Assinatura Digital ________________________________________________________________ 6
5.
Fases ___________________________________________________________________ 6
5.1.
5.1.1. 5.1.2.
Testes _____________________________________________________________________ 6
Procedimentos Iniciais Recomendados ________________________________________________ 7 Testes Mnimos Sugeridos _________________________________________________________ 7
5.2. 5.3.
6. 7. 8. 9.
Consulta NF-e na SEFAZ/RS e na Sefaz-Virtual/RS ___________________________ 9 Outras Informaes sobre a NF-e ____________________________________________ 9 Contatos ________________________________________________________________ 9 ANEXOS _______________________________________________________________ 10
9.1.
9.1.1. 9.1.2. 9.1.3.
9.2. ANEXO 2 Consumo dos Web Service do Ambiente NF-e da SEFAZ/RS e da SefazVirtual/RS ______________________________________________________________________ 13
9.2.1. 9.2.2. 9.2.3. 9.2.4. Pr-Requisitos para Consumo Web Service____________________________________________ Passos do Processo ______________________________________________________________ Exemplo de Cdigo em .NET, framework 2 (ou superior), linguagem C# ____________________ Endereos Web Services do RS _____________________________________________________ Pr-Requisitos para a Assinatura ____________________________________________________ Seqncia de Passos para o Processo de Assinatura _____________________________________ Gerando o cdigo hash e calculando a assinatura digital _________________________________ O Elemento Signature __________________________________________________________ Exemplo de Cdigo em .NET, Framework 2 (ou superior), linguagem c# ____________________ 13 13 14 14 16 16 16 17 19
9.3.
9.3.1. 9.3.2. 9.3.3. 9.3.4. 9.3.5.
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica A SEFAZ-RS e a Sefaz-Virtual/RS j possuem instalados em seus equipamentos servidores todos os Certificados das AC comerciais mais comuns identificadas no site do ITI Instituto Nacional de Tecnologia de Informao, em www.iti.gov.br. A empresa dever possuir um certificado digital para ser usado no processo de assinatura da nota fiscal e um certificado digital para ser usado como certificado de transmissor. Nos dois casos, o certificado deve possuir uma extenso com o CNPJ. O mesmo certificado poder ser utilizado para as duas funes, assinatura e transmisso, porm para a assinatura exigido que o certificado contenha o CNPJ da empresa matriz ou do prprio estabelecimento emissor. Outras informaes sobre a conexo segura SSL podero ser obtidas nos anexos deste manual, em tpico especfico sobre Conexo SSL.
5. Fases
O processo de credenciamento de contribuintes como emissor de Nota Fiscal Eletrnica consta de trs fases sugeridas: 1. Testes 2. Emisso Simultnea 3. Produo O cumprimento das mencionadas fases no obrigatrio, sendo possvel ao contribuinte solicitar credenciamento final como emissor de NF-e, e conseqente acesso ao ambiente de produo, independente de ter ou no efetuado testes ou cumprido as fases sugeridas. Contudo aconselhvel que a empresa, para uma implementao mais tranqila e segura, efetue antecipadamente todos os testes que julgar necessrio, de acordo com suas necessidades.
5.1. Testes
No necessrio que a empresa que deseje tornar-se emissora de NF-e efetue testes, embora seja altamente recomendvel. Nos tpicos seguintes h uma relao de procedimentos e testes sugeridos, contudo a forma ou mesmo quantidade de testes necessrios para uma implementao segura depender da realidade de cada empresa.
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica Empresas que no sejam contribuintes no Estado do RS, mas que tenham interesse em desenvolver suas aplicaes para emisso de NF-e, como empresas desenvolvedoras de sistemas, podero obter acesso ao ambiente de testes da NF-e do RS em contato direto com a Equipe NF-e pelo endereo de e-mail nfe@sefaz.rs.gov.br.
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica a. Efetuar pelo menos 5 inutilizaes de numerao b. Variar a faixa de numerao inutilizada, inutilizando tanto um nico nmero como uma faixa de nmeros contida entre nmeros de notas j autorizadas. 6. Consulta status: efetuar pelo menos 20 consulta status. Observaes: 1. Recomenda-se que sejam emitidas notas fiscais eletrnicas correspondendo, dentro do possvel, a todos os tipos de operaes realizadas pelo contribuinte, inclusive notas fiscais de entrada, utilizando dados reais de suas notas fiscais modelo 1 ou 1-A. 2. Recomenda-se executar os testes at que o nmero de erros reduza a zero ou a um volume no significativo para as operaes da empresa, permitindo empresa operar de forma tranqila com a NF-e.
5.3. Produo
A Fase de Produo corresponde ao efetivo credenciamento do contribuinte como emissor de Nota Fiscal Eletrnica. Constatada a regularidade fiscal do contribuinte e no havendo nenhum outro impedimento, ser concedida a autorizao para entrada na Fase de Produo, sendo os dados do contribuinte publicados pelo Estado na relao de empresas credenciadas para emisso de NF-e. No RS, a lista de contribuintes credenciados como emissores de NF-e publicada na pgina da NF-e do site da SEFAZ/RS, pelo endereo anteriormente mencionado. A partir do dia em que o contribuinte tomar cincia da autorizao para entrada na Fase de Produo poder passar a operar com Notas Fiscais Eletrnicas.
8. Contatos
Dvidas ou esclarecimentos adicionais podero ser supridos pelos endereos de contato: Contribuintes da SEFAZ/RS: nfe@sefaz.rs.gov.br; Contribuintes da Sefaz-Virtual/RS: sefazvirtual@sefaz.rs.gov.br;
Nmero da Pgina: 9 de 20 Data da Impresso: 19/03/2008
9. ANEXOS
9.1. ANEXO 1 Estabelecimento da Conexo Segura SSL:
9.1.1. Obteno dos certificados de servidor da SEFAZ-RS
Descreve-se, a seguir, os procedimentos necessrios para obteno dos certificados de AC dos Servidores da SEFAZ-RS e da Sefaz-Virtual/RS: 1. Abrir o browser (navegador da Internet); 2. Digitar o endereo de domnio do ambiente NF-e desejado: https://homologacao.nfe.sefaz.rs.gov.br para o ambiente de testes da SEFAZ/RS; https://homologacao.nfe.sefazvirtual.rs.gov.br para testes Sefaz-Virtual/RS; https://nfe.sefaz.rs.gov.br para o ambiente de produo da SEFAZ/RS, e; https://nfe.sefazvirtual.rs.gov.br para o ambiente de produo da Sefaz-Virtual/RS. 3. Clicar no local indicado para baixar a cadeia de Certificados do site (download dos Certificados); 4. Instalar os 3 certificados das AC, a partir das janelas e dilogos abertos. Como exemplo, segue abaixo uma descrio detalhada da instalao dos certificados de AC dos servidores de testes da SEFAZ-RS para os usurios que utilizam o sistema operacional Windows e o Internet Explorer como navegador de internet: Abrir o Internet Explorer e digitar o endereo de domnio do ambiente de testes na linha de Endereo:
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica Clicar no local indicado para baixar a cadeia de Certificados do site (Download dos Certificados):
. Para cada um dos trs (3) Certificados apresentados, proceder como segue:
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica Efetuar duplo-clique no Certificado desejado:
. No Assistente para importao de Certificados do Windows, clicar em Avanar, Avanar novamente e Concluir; Repetir a operao para cada um dos 3 (trs) Certificados apresentados. Nota: No momento de instalar o Certificado da AC Raiz Brasileira poder ser emitido um Aviso de Segurana. Deve-se clicar no boto Sim, confirmando a confiana no Certificado de AC Raiz Brasileira que est sendo instalado.
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica browser solicitar ao operador que informe o Certificado Digital que ser utilizado nesta comunicao. O sucesso nesta tentativa confirma que o certificado vlido para utilizao no estabelecimento da conexo SSL com os servidores da SEFAZ.
9.2. ANEXO 2 Consumo dos Web Service do Ambiente NF-e da SEFAZ/RS e da Sefaz-Virtual/RS
9.2.1. Pr-Requisitos para Consumo Web Service
Documento XML de Lote de NF-e, sem erro de Schema e com as NF-e devidamente assinadas; Certificado digital que ser utilizado para a transmisso, com chave privada, instalado no repositrio do sistema operacional do Windows, para o usurio do aplicativo da empresa; Certificados digitais da Cadeia de Certificao do Web Service da SEFAZ que ser conectado devero estar instalados no repositrio de Certificados do equipamento da empresa que est sendo usado nesta conexo; Classe proxy de conexo com o Web Service (exemplo: NFeRecepcao). Obs.: No .NET Framework, esta classe pode ser construda automaticamente a partir do WSDL, com uma ferramenta chamada WSDL.exe
Por exigir um cadastro unificado entre as Administraes Tributrias dos contribuintes de todos os Estados participantes, a Sefaz-Virtual/RS no disponibiliza o servio provido pelo Web Service de Consulta Cadastro, que dever ser disponibilizado pelo Estado correspondente. Os endereos para os ambientes de produo so similares aos dos ambientes de testes, bastando retirar a literal homologacao. do endereo do Web Service de teste correspondente.
A chave de acesso, que ir compor as TAG <infNFe> e a TAG <Reference URI>, formando o ID nico, dever ser formada como indicado no item 5.4 do Manual de Integrao-Contribuinte. No mesmo item do Manual de Integrao-Contribuinte poder ser obtido um exemplo de formao de arquivo XML com as respectivas TAG de assinatura. Antes de serem transmitidas, as NF-e (TAG xml <NFe>) devero ser envelopadas em um lote de transmisso (TAG xml <enviNFe>). Mesmo que a empresa necessite transmitir uma nica NF-e, esta dever ser envelopada em um lote. Um exemplo de lote de NF-e pode ser encontrado abaixo:
<?xml version="1.0" encoding="UTF-8" ?> - <enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.10"> <idLote>200802014300001</idLote> - <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> + <infNFe versao="1.10" Id="NFe43080200000000000000550000000000019876543210"> + <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> </NFe> - <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> + <infNFe versao="1.10" Id="NFe43080200000000000000550000000000021234567890"> + <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> </NFe> </enviNFe>
Outras informaes sobre os padres de gerao da assinatura digital da NF-e podem ser obtidos no Manual de Integrao-Contribuinte, especialmente nos itens 3.2.4 e 3.2.6. Tambm outras informaes teis podero ser obtidas na pgina NF-e da SEFAZ/RS, em www.sefaz.rs.gov.br, menu Informaes Gerais, submenu Nota Fiscal Eletrnica, no item Assinatura Digital (AssinadorRS). NOTA: Como a Sefaz necessita desenvelopar os arquivos NF-e, e este processo onera significativamente o tempo de processamento da NF-e, o ideal que a empresa transmita lotes
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica no maior tamanho possvel (observar os limites mximos de 50 NF-e e 500KB por lote). Agindo desta forma a empresa estar otimizando o processamento dos lotes e reduzindo substancialmente o tempo mdio de resposta de autorizao das NF-e.
No bloco de assinatura (TAG <Signature>) da NF-e, existem algumas informaes que, em geral, sero constantes nas NF-e da empresa, como os dados que identificam os mtodos de assinatura utilizados, e outras que sero variveis de acordo com a NF-e. As informaes constantes podero ser obtidas com o uso do aplicativo AssinadorRS, disponvel para download no Portal Nacional da NF-e, e alguns exemplos esto descritos no Manual de IntegraoContribuinte. A seguir descrevemos as principais informaes variveis no bloco de assinatura. No processo de assinatura, o hash-code gerado a partir da aplicao do algoritmo SHA-1 representa um cdigo de resumo do contedo do bloco NF-e. Esse resumo ir compor o contedo da TAG <DigestValue> do bloco de assinatura de cada NF-e. Aps o processo anterior, o sistema da empresa dever aplicar o algoritmo de assinatura RSA no cdigo hash obtido com o uso do certificado digital de assinatura da empresa emitente, criptografando o seu contedo. O resultado do processo de criptografia ir compor a TAG <SignatureValue> do bloco de assinatura de cada NF-e. Tambm no bloco de assinatura, a TAG <Reference URI> composta pela chave de acesso da NF-e, conforme descrito anteriormente. E a TAG <x509Certificate> composta pela chave pblica do certificado digital utilizado na assinatura da NF-e. Maiores detalhes sobre o bloco de assinatura podero ser obtidos no tpico seguinte e no Manual de Integrao-Contribuinte, nos tpicos j mencionados.
Manual de Credenciamento como Emissor de Nota Fiscal Eletrnica SignatureMethod: Indica o algoritmo usado para converter o SignedInfo normalizado para o SignatureValue; A.1 Reference: Identifica o "bloco" dentro do documento que ser assinado (bloco identificado pelo atributo Id no documento XML); A.1.1 Transforms: Indica os algoritmos de transformao aplicados ao documento original antes do clculo do hash; A.1.2 DigestMethod: Indica o algoritmo de hash que ser aplicado no "bloco" referenciado; A.1.3 DigestValue: Contm o valor real do hash calculado sobre o "bloco" a ser assinado; B. SignatureValue: Contm o valor da assinatura digital, calculado pelo algoritmo de assinatura sobre o elemento indicado por SignedInfo; C. KeyInfo: Contm a chave pblica do remetente, que ser utilizada pelo aplicativo de recepo da SEFAZ para validar a assinatura digital.