Guia de Implantao da NF-eletrnica nacional

Verso preliminar Agosto/2008

Pgina 1 de 41

ndice
Introduo................................................................................................................................................. 3 1. O Projeto NF-e nacional................................................................................................................... 3 1.1 Documentao bsica do Projeto .............................................................................................. 3 1.2 Objetivo do Projeto da NF-e ..................................................................................................... 4 1.3 Conceito da NF-e ...................................................................................................................... 4 1.4 Documento Auxiliar da Nota Fiscal Eletrnica - DANFE........................................................ 4 2. Implantao do Projeto na empresa ................................................................................................. 5 2.1 Adeso NF-e: Emissor voluntrio e Emissor obrigado .......................................................... 5 2.2 Antecipao da emisso de NF-e por emissor obrigado ........................................................... 5 2.3 Requisitos para emisso da NF-e .............................................................................................. 5 2.4 Acesso Internet ....................................................................................................................... 6 2.5 Certificado Digital..................................................................................................................... 6 2.6 Credenciamento......................................................................................................................... 8 2.7 Adaptao do Sistema de Faturamento / ERP........................................................................... 9 3. O leiaute da NF-e ............................................................................................................................. 9 3.1 O padro XML ........................................................................................................................ 10 3.2 Conceitos bsicos de XML ..................................................................................................... 10 3.3 Regras de preenchimento dos campos da NF-e ...................................................................... 14 3.4 Campos unidade de tributao e quantidade de tributao ................................................... 14 3.5 Preenchimento das informaes do ICMS .............................................................................. 16 3.5.1 ICMS CST 00 Tributada integralmente ......................................................................... 16 3.5.2 ICMS CST 10 Tributada e com cobrana do ICMS por substituio tributria ............ 17 3.5.3 ICMS CST 20 com reduo de base de clculo ............................................................. 19 3.5.4 ICMS CST 30 Isenta ou no tributada e com cobrana do ICMS por substituio tributria ......................................................................................................................................... 20 3.5.5 ICMS CST 40 Isenta ...................................................................................................... 22 3.5.6 ICMS CST 41 No tributada.......................................................................................... 23 3.5.7 ICMS CST 50 Suspenso............................................................................................... 24 3.5.8 ICMS CST 51 Diferimento ............................................................................................ 25 3.5.9 ICMS CST 60 ICMS cobrado anteriormente por substituio tributria....................... 26 3.5.10 ICMS CST 70 Com reduo de base de clculo e cobrana de ICMS por substituio tributria ......................................................................................................................................... 27 3.5.11 ICMS CST 90 - Outras...................................................................................................... 29 4. Estabelecendo conexo com os Web Services da NF-e................................................................. 31 4.1 Instalando o Certificado Digital do emissor............................................................................ 32 4.2 Erro no processo de assinatura por falha na instalao do driver do dispositivo do certificado digital tipo A3..................................................................................................................................... 33 4.3 Instalando o Certificado Digital do Web Service.................................................................... 33 4.4 Problemas na conexo ............................................................................................................. 35 4.5 Instalando uma cadeia de certificao em ambiente Windows............................................... 37

Pgina 2 de 41

Introduo
O objetivo deste guia fornecer as informaes mnimas necessrias para as pessoas envolvidas na implantao da NF-e nacional. O documento se encontra em fase de elaborao, sujeito alterao e acrscimo de contedo .

1. O Projeto NF-e nacional

Atualmente existem diversos projetos que utilizam o termo Nota Fiscal eletrnica - NF-e. S na cidade de So Paulo temos: NF-e nacional de mercadorias, NF-Online (Nota Fiscal Paulista - NFP) e 2 via eletrnica, todas de competncia do governo estadual, alm da NF-e de Servios da prefeitura de SP. A NF-e tratada neste guia a Nota Fiscal eletrnica NF-e nacional, instituda atravs do Ajuste SINIEF 07/05, como um novo modelo de documento fiscal em forma eletrnica, mantendo a equivalncia legal com a Nota Fiscal modelo 1 ou 1-A utilizada pelos contribuintes do ICMS e IPI. A NF-e nacional tem validade em todo territrio nacional e deve atender um padro tcnico nico, qualquer que seja a UF de localizao do emissor.

1.1

Documentao bsica do Projeto

A documentao bsica da Nota Fiscal eletrnica NF-e a legislao tributria que instituiu o novo documento fiscal, estabelecendo o padro tcnico e a obrigatoriedade de adoo da NF-e. Ajuste SINIEF 07/05 instituiu a Nota Fiscal Eletrnica NF-e, o Documento Auxiliar da Nota Fiscal eletrnica - DANFE e o modelo funcional; Protocolo ICMS 10/07 trata da obrigatoriedade de adoo da NF-e; Ato COTEPE divulga o Manual de Integrao do Contribuinte com as especificaes tcnicas dos Web Services da NF-eletrnica NF-e e os leiautes da NF-e e do Documento Auxiliar da Nota Fiscal Eletrnica - DANFE.

A especificao do Projeto est contida nos seguintes Manuais: Manual de Integrao do Contribuinte o principal documento do projeto que contem os leiautes da NF-e e do DANFE e as especificaes tcnicas dos Web Services oferecidos; Manual de Contingncia o documento que trata do processo de contingncia.

O Pacote de Liberao um conjunto de Schemas XML com as definies das mensagens dos Web Services e do leiaute da NF-e, a correta compreenso deste material fundamental para solucionar os erros de schema XML e implementar o projeto da NF-e.

Pgina 3 de 41

O documento intitulado Nota Tcnica divulgado sempre que surgem fatos e informaes relevantes de interesse do Projeto, sendo leitura recomendada. Todo o material se encontra disponvel no Portal da NF-e nacional (www.nfe.fazenda.gov.br) ou nos Portais das UF. O blog da NF-eletrnica (nf-eletronica.com/blog) oferece o link para todo material citado, sendo recomendada a assinatura de notcias em RSS para se manter atualizado das novidades.

1.2

Objetivo do Projeto da NF-e

O principal objetivo do projeto oferecer uma alternativa que permita a substituio da Nota Fiscal modelo 1/1A por uma Nota Fiscal em forma eletrnica que atenda os requisitos legais de documento eletrnico.

1.3

Conceito da NF-e

A NF-e conceituada como: o documento emitido e armazenado eletronicamente, de existncia apenas digital, com o intuito de documentar operaes e prestaes, cuja validade jurdica garantida pela assinatura digital do emitente e autorizao de uso pela administrao tributria da unidade federada do contribuinte, antes da ocorrncia do fato gerador ( 1 da clusula 1 do Ajuste SINIEF 07/05) Caractersticas da NF-e: 1.4 documento fiscal em forma eletrnica que substitui a nota fiscal modelo 1 / 1A; arquivo eletrnico em padro XML (eXtended Markup Language); assinatura digital XML do arquivo eletrnico com certificado digital padro ICP Brasil; a autorizao de uso da NF-e obtida atravs do Web Service oferecido da unidade federada do contribuinte; os interessados na operao devem manter o arquivo da NF-e pelo prazo decadencial;

Documento Auxiliar da Nota Fiscal Eletrnica - DANFE

A circulao da mercadoria deve ser acompanhada pelo respectivo Documento Auxiliar da Nota Fiscal Eletrnica - DANFE, que uma simples representao grfica da NF-e e no se confunde com a respectiva NF-e. Os destinatrios que ainda no so emissores da NF-e podem realizar a escriturao da operao com base nas informaes do DANFE e manter o DANFE em substituio ao arquivo da NF-e, contudo, a validade do DANFE condicionada existncia da respectiva NF-e.

Pgina 4 de 41

2. Implantao do Projeto na empresa

Inicialmente a participao no Projeto da Nota Fiscal eletrnica NF-e era voluntria, mas com o tempo a participao passou a ser obrigatria por setor de atividade e tudo indica que em um futuro prximo todos os contribuintes do ICMS sero obrigados a emitir NF-e. O cenrio de futura obrigatoriedade um fator que deve ser avaliado para as empresas e pelos provedores de soluo, pois apesar das maiores dificuldades iniciais importante a empresa emissora estar preparada para a nova realidade e para os provedores de soluo interessante dominar a tecnologia e implementar a soluo para no perder mercado. No nenhum exagero supor que estamos vivendo uma alterao do paradigma importante que para alguns provedores de soluo pode significar uma grande oportunidade de crescimento e conquista de novos mercados e para outros uma srie ameaa para os seus negcios. 2.1

Adeso NF-e: Emissor voluntrio e Emissor obrigado

A empresa que adere a emisso de NF-e sem estar obrigado considerada emissor voluntrio e se encontra em uma situao mais privilegiada, pois no precisa cumprir prazos de implantao e nem vir a adotar a NF-e se no julgar conveniente enquanto a sua atividade econmica no for obrigada a emitir NF-e por previso legal. O emissor obrigado a adotar a NF-e por previso legal tem prazos a cumprir, devendo emitir 100% de suas operaes com NF-e, o que pode causar diversos problemas, pois sempre existem sistemas legados em uso e nem sempre possvel adequar o sistema para a emisso de NF-e com facilidade. 2.2

Antecipao da emisso de NF-e por emissor obrigado

Um contribuinte sujeito obrigatoriedade que decida iniciar a emisso da NF-e antes da data prevista de incio da obrigatoriedade considerado emissor voluntrio enquanto no estiver obrigado a emitir NF-e por previso legal. Este um detalhe importante que deve ser aproveitado pelas empresas obrigadas, pois enquanto no est obrigada a emitir NF-e para 100% das operaes, a empresa pode realizar a implementao gradativa do projeto, elegendo setores, operaes ou clientes que utilizaro NF-e e em caso de problemas tcnicos ou contingncia poder emitir a NF modelo 1/1A, sem comprometer as suas operaes comerciais.

2.3

Requisitos para emisso da NF-e

Os principais requisitos para a emisso da NF-e so:

Pgina 5 de 41

Adaptao do sistema de faturamento para emitir NF-e o principal requisito e fator essencial do sucesso da implementao do projeto NF-e; Acesso Internet acesso de alta velocidade, sendo recomendada a existncia de um link redundante, caso as operaes de emisso da NF-e da empresa sejam crticas ; Certificado Digital, padro X509 v3, emitido por Autoridade Certificadora credenciada ao ICP-Brasi; Credenciamento na SEFAZ de localizao do interessado.

Os requisitos sero discutidos nos prximos itens por ordem de complexidade. 2.4

Acesso Internet

O acesso Internet um requisito essencial para a implementao da NF-e na empresa e a disponibilidade de um link confivel de boa velocidade deve reduzir os problemas tcnicos que a empresa pode enfrentar. O perfil da maioria de uso da Internet das empresas baseado em grande volume de recebimento de informaes e pequeno volume de envio de informaes. Com a emisso da NF-e, as empresas emissoras passaro a transmitir um maior volume de informaes (NF-e) e recebero poucas informaes de retorno, na fase inicial, com tendncia de um certo equilbrio no fluxo quando ocorrer a massificao da NF-e e passar a receber NF-e de seus fornecedores tambm. A performance do envio da NF-e depende de diversos fatores, contudo, a velocidade de transmisso um fator importante, pois quanto mais rpido, menor ser o tempo de envio da NF-e e retorno da autorizao de uso. Assim, as empresas devem considerar a velocidade de transmisso (upload) na contratao do link de acesso, principalmente no caso de acesso ADSL que oferecido pelas companhias telefnicas, que tem velocidades diferentes de download e upload. As empresas atacadistas e distribuidoras, que emitem um grande volume de NF dirias, devem se preocupar com este detalhe, pois em geral, alm do volume existe concentrao da emisso das NF em um pequeno perodo do dia e a performance do sistema fundamental para o seu negcio. A contratao de um link alternativo recomendvel para se precaver para eventuais problemas tcnicos do link principal. Uma boa alternativa a contratao de um plano de acesso de dados oferecidos pelas empresas de telefonia mvel para no interromper as operaes mais crticas, caso a localidade oferea cobertura 3G.

2.5

Certificado Digital

O projeto da NF-e baseado no conceito de documento em forma eletrnica da Medida Provisria n 2.200-2, que instituiu a infra-estrutura de Chaves Pblicas Brasileira ICP-Brasil, exigindo um certificado digital com as seguintes caractersticas: padro X509v3 - o emissor do certificado digital deve ser Autoridade Certificadora credenciada ao ICP-Brasil, a relao de AC pode ser obtida em http://www.iti.gov.br/twiki/bin/view/Certificacao/EstruturaIcp.

Pgina 6 de 41

certificado digital de Pessoa Jurdica o projeto s aceita certificado digital de pessoa jurdica que deve conter o CNPJ da empresa no campo otherName OID = 2.16.76.1.3.3, pelo qual identificado o CNPJ do emissor; uso da chave a chave pblica do certificado digital deve suportar Assinatura Digital e Norecusa estas funes so necessrias para utilizar o certificado digital na assinatura digital; uso avanado da chave o certificado digital deve suportar a Autenticao Cliente da chave pblica do certificado digital, esta funcionalidade exigida na conexo SSL com autenticao mtua; algoritmo de assinatura = esta caracterstica tem relao com o dispositivo de armazenamento do certificado digital, o projeto da NF-e adotou o sha1RSA como algoritmo de criptografia (assinatura), assim, a aquisio de dispositivo porttil inviolvel do tipo token ou smart card (certificado tipo A3) para a NF-e deve verificar se o dispositivo suporta este algoritmo criptogrfico, a maioria das incompatibilidades identificadas no uso de certificado digital devese ao fato do dispositivo no suportar o algoritmo de assinatura sha1RSA (The specified cryptographic service provider (CSP) does not support this key algorithm) ;

A aquisio de um certificado digital vlido o requisito mnimo necessrio para a implementao da NF-e, pois ele a alma do negcio da NF-e, sendo um dos principais obstculos das empresas e provedores de soluo para a realizao de testes. Por outro lado esta dificuldade pode ser encarada como um ponto extremamente positivo do projeto em termos de segurana, dificultando a ocorrncia de fraudes. A princpio, a empresa pode utilizar o certificado digital e-CNPJ caso deseje, contudo a prtica no muito recomendada, pois o e-CNPJ utilizado na empresa para outras finalidades, alm de permitir o acesso aos servios eletrnicos da Receita Federal. Alm da validade do certificado digital, os Web Services da NF-e verificam se o certificado digital pertence a um emissor credenciado a emitir NF-e, atravs do CNPJ existente no campo otherName OID = 2.16.76.1.3.3, assim, os testes de emisso de NF-e s podem ser realizados com o certificado digital da empresa emissora, o que prejudica o uso do certificado digital e-CNPJ da empresa por terceiros. As Autoridades Certificadoras emitem certificados de pessoa jurdica, conhecidos como certificado digital e-PJ mltiplo, como por exemplo o certificado digital da NF-e (Certisign, SERASA, etc.) e a identidade Digital (CEF), que so recomendados por atenderem os requisitos do projeto. O certificado digital e-PJ mltiplo do tipo A1 o mais recomendado para a NF-e pelos seguintes motivos: facilidade de uso a autenticao do usurio a cada acesso/uso do certificado digital opcional no certificado digital tipo A1, facilitando o processo de assinatura digital e autenticao SSL, que pode ficar instalado no equipamento utilizado pelo sistema de emisso de NF-e de forma transparente; compatibilidade o certificado tipo A1 tem uma maior compatibilidade com as aplicaes ao no exigir drivers PKCS11 e outras bibliotecas para acessar o dispositivo porttil do certificado

Pgina 7 de 41

tipo A3, que tem maior possibilidade de gerar incompatibilidade por se tratar de hardware em ltima instncia. O uso de biblioteca desatualizada ou incompatvel com o certificado digital tipo A3 pode gerar erros como a falha na assinatura digital The specified cryptographic service provider (CSP) does not support this key algorithm / O CSP(provedor de servios de criptografia) especificado no oferece suporte a este algoritmo de chave que tem ocorrido com Certificados Digitais tipo A3 em razo do uso do gerenciador de certificados digitais desatualizado (acesse o gerenciador atualizado em http://nf-eletronica.com/blog?dl_id=29); performance diferentemente do certificado digital tipo A3 na qual todas as operaes de uso da chave privada (assinatura digita, autenticao, etc.) so realizadas no dispositivo porttil, o certificado digital tipo A1 utiliza o Cryptographic Service Provider - CSP do equipamento da aplicao de emisso da NF-e que tem uma capacidade de processamento muito superior ao dispositivo porttil, resultando em maior velocidade no processo de assinatura digital; controle e individualizao possibilidade de emisso de quantos certificados digitais forem necessrios, individualizando a pessoa responsvel pela sua guarda e utilizao. Caso a pessoa responsvel pelo certificado digital deixe a empresa, o certificado digital pode ser revogado facilmente, sem impactar no dia a dia da empresa, alm de propiciar um controle efetivo do uso do certificado digital. Esta facilidade importante e desejvel nos casos em que a empresa contrata servios de terceiros para implementao do sistema de faturamento / ERP, que necessitam de um certificado digital na implementao da NF-e;

A aquisio do certificado digital deve considerar outras variveis como custo do certificado digital, facilidade de emisso, capilaridade da Autoridade de Registro AR, etc., que so determinantes para as empresas que no esto localizadas nos grandes centros, bem como os preos praticados que podem variar conforme a Autoridade Certificadora e nem sempre significar uma melhor qualidade ou diferencial do produto. 2.6

Credenciamento

O credenciamento um processo formal, atravs do qual o contribuinte interessado solicita a autorizao para emisso de NF-e. Cada unidade federada tem um modelo de credenciamento, que pode ter maior ou menor acompanhamento e avaliao da capacidade de emisso de NF-e do contribuinte interessado. Em algumas unidades federadas existe um rgido controle de homologao do aplicativo emissor da NF-e do interessado, com etapas, metas e cronogramas que devem ser cumpridos, por outro lado existem UF como SP que no exige qualquer homologao da aplicao ou do processo de emisso, nem tampouco estabelece qualquer meta de emisso de NF-e em teste para a aplicao do contribuinte. Ao solicitar o credenciamento, o interessado passa a ter acesso a um ambiente de testes onde possvel realizar testes de emisso, cancelamento, inutilizao, etc. O ambiente de teste conhecido com ambiente de homologao, sendo utilizado para a realizao de testes por todos os emissores de NF-e, no importando se j emitem em ambiente de produo. A NF-e emitida no ambiente de testes no tem qualquer validade, cabendo ressaltar que no existe qualquer garantia de alta disponibilidade dos Web Services do ambiente de homologao.

Pgina 8 de 41

Maiores detalhes do processo de credenciamento devem ser obtidos no Portal da UF de localizao do contribuinte.

2.7

Adaptao do Sistema de Faturamento / ERP

A adaptao do sistema de faturamento ou do sistema de gesto integrado (ERP) para a emisso da NF-e o principal requisito do projeto de emisso de NF-e, sendo o item mais trabalhoso de ser implementado, pois exige o mapeamento das operaes que a empresa pratica e a verificao da existncia de todas as informaes exigidas na NF-e no sistema de faturamento ou no ERP. Em algumas situaes no basta que a informao exista no sistema de faturamento ou no ERP, como o caso do nome do municpio, pois a NF-e exige a informao do cdigo de municpio no padro adotado pelo IBGE, o que pode significar a necessidade de adaptao na estrutura de dados e modificao do cadastro de clientes. O trabalho de localizar e avaliar se as informaes exigidas pelas NF-e existem na empresa, vai demandar muita energia e esforo da equipe de negcios e de TI da empresa interessada.

3. O leiaute da NF-e
A compreenso do leiaute da NF-e o principal pr-requisito para as pessoas que esto envolvidas com a implantao da NF-e nas empresas. O leiaute da NF-e pode ser encontrado no Anexo I do Manual de Integrao do Contribuinte, contudo a estrutura de apresentao do leiaute em tabela no a mais adequada para representar a definio do documento XML, o que pode provocar alguma confuso ou dificuldade de compreenso do leiaute da NF-e, considerando que muitas pessoas no tem qualquer noo de XML. Exemplo de leiaute no padro do Manual de Integrao do Contribuinte:
# ID
A01

Campo Cliente

Descrio TAG Raiz do registro de cliente Descrio CNPJ do cliente CPF do cliente

Ele G

Pai -

Tipo

Ocorrn cia

tamanho

Dec.

Observao TAG raiz da NF-e

1-1

A Dados da Cliente # ID Campo 1 2

B01 B02

CNPJ CPF

Ele CE CE

Pai A01 A01

Tipo

Ocorrn cia

tamanho

Dec.

C C

1-1 1-1

0, 14 11

Observao Informar o CNPJ ou CPF do cliente, preenchendo os zeros no significativos, no informar o contedo da TAG se o cliente no possuir CNPJ.

3 4 5 6 7 8 9

B03 B04 B05 B06 B07 B08 B09

Nome Endereo Logradouro Complemen to Bairro Cidade UF

Nome do cliente TAG de grupo do endereo do cliente Logradouro Complemento Bairro Cidade Sigla da UF

E G E E E E E

A01 A01 B04 B04 B04 B04 B04

1-1

1-60

C C C C C

1-1 0-1 1-1 1-1 1-1

1-60 1-60 1-60 1-60 2

Pgina 9 de 41

# 10 11

ID
B10 B11

Campo CEP Telefone

Descrio CEP Telefone

Ele E E

Pai B04 A01

Tipo

Ocorrn cia

tamanho

Dec.

Observao

C C

1-1 0-3

8 12

3.1

O padro XML

O padro XML adotado pela NF-e ainda pouco utilizado no cumprimento das obrigaes acessrias tributrias, devendo ser a primeira dificuldade que o desenvolvedor deve enfrentar na compreenso do leiaute da NF-e. O padro XML permite a representao estruturada dos dados com o uso de marcadores que permite a declarao precisa do contedo, facilitando a visualizao e a manipulao das informaes. Exemplo de documento XML: <?xml version="1.0" encoding="UTF-8"?> <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <CNPJ>00000000000191</CNPJ> <Nome>BANCO DO BRASIL S/A</Nome> <Endereco> <Logradouro>RUA SO BENTO, 123</Logradouro> <Complemento></Complemento> <Bairro>CENTRO</Bairro> <Cidade>SO PAULO</Cidade> <UF>SP</UF> <CEP>01010000</CEP> </Endereco> <Telefone>11-3333-1000</Telefone> <Telefone>11-3333-2000</Telefone> </Cliente>

3.2

Conceitos bsicos de XML

Vamos apresentar os conceitos bsicos do padro XML com intuito de facilitar a compreenso do leiaute da NF-e, cabe observar que a leitura da literatura tcnica especializada no tema recomendada. O XML case sensitive ou seja, o parser XML considera as letras minsculas e maisculas nos nomes das tags, assim, a grafia das tags deve ser exatamente igual ao estabelecido no leiaute da NF-e. Representao grfica do documento XML

Pgina 10 de 41

a) Elemento o elemento um campo bsico de informao do documento XML, a informao informada entre a tag de identificao de incio e a tag de identificao de fim do campo. O campo Nome exemplo de elemento XML que pode ser representado como: <Nome>BANCO DO BRASIL S/A</Nome>, no leiaute da NF-e, o Elemento identificado com as letras E ou CE na coluna ele.
# 3 ID
B03

Campo Nome

Descrio Nome do cliente

Ele E

Pai A01

Tipo

Ocorrn cia

tamanho

Dec.

Observao

1-1

1-60

b) Elemento de Grupo o elemento de grupo um Elemento XML que pode conter outros Elementos XML. A sua principal funo facilitar a compreenso do documento XML agrupando elementos que tenham alguma relao entre si. No exemplo em uso a tag Endereco uma tag de grupo que agrupa as informaes do endereo: <Endereco> <Logradouro>RUA SO BENTO, 123</Logradouro> <Complemento></Complemento> <Bairro>CENTRO</Bairro> <Cidade>SO PAULO</Cidade> <UF>SP</UF> <CEP>010100</CEP> </Endereco> No leiaute da NF-e, o Elemento identificado com as letras G ou GC na coluna ele.
# 4 ID
B04

Campo Endereco

Descrio TAG de grupo do endereo do cliente

Ele G

Pai A01

Tipo

Ocorrn cia

tamanho

Dec.

Observao

Pgina 11 de 41

5 6 7 8 9 10

B05 B06 B07 B08 B09 B10

Logradouro Complemento Bairro Cidade UF CEP

Logradouro Complemento Bairro Cidade Sigla da UF CEP

E E E E E E

B04 B04 B04 B04 B04 B04

C C C C C C

1-1 0-1 1-1 1-1 1-1 1-1

1-60 1-60 1-60 1-60 2 8

c) Cardinalidade o padro XML permite que uma informao possa ocorrer nenhuma ou diversas vezes no documento XML. No exemplo em uso a tag telefone pode ter de 0 a 3 ocorrncias. Exemplo com nenhuma ocorrncia da tag telefone: <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Endereco> (...) </Endereco> </Cliente> Exemplo com uma ocorrncia da tag telefone: <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Endereco> (...) </Endereco> <Telefone>11-3333-1000</Telefone> </Cliente> Exemplo com duas ocorrncias da tag telefone: <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Endereco> (...) </Endereco> <Telefone>11-3333-1000</Telefone> <Telefone>11-3333-2000</Telefone> </Cliente> Exemplo com trs ocorrncias da tag telefone: <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Endereco> (...) </Endereco> <Telefone>11-3333-1000</Telefone> <Telefone>11-3333-2000</Telefone> <Telefone>11-3333-3000</Telefone>

Pgina 12 de 41

</Cliente> No leiaute da NF-e, a cardinalidade identificada com a notao n-m na coluna Ocorrcina, onde o n representa a ocorrncia mnima exigida e m a limite mximo de ocorrncias permitidas para a tag.
# 10 11 ID
B10 B11

Campo CEP Telefone

Descrio CEP Telefone

Ele E E

Pai B04 A01

Tipo

Ocorrn cia

tamanho

Dec.

Observao

C C

1-1 0-3

8 12

d) Seqncia uma definio XML que exige que os campos do documento XML devem ter a mesma disposio da definio do documento. A existncia de um campo do documento XML fora de ordem ou a omisso de um Elemento obrigatrio gera um erro de validao do Schema XML. e) Escolha a opo de escolha utilizada para Elementos de informao mutuamente exclusivos, como o caso do CPF/CNPJ dos dados cadastrais, para o qual deve ser informado o CNPJ ou o CPF. Exemplo com a tag CNPJ informada: <?xml version="1.0" encoding="UTF-8"?> <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <CNPJ>00000000000191</CNPJ> <Nome>BANCO DO BRASIL S/A</Nome> <Telefone>11-3333-1000</Telefone> </Cliente> Exemplo com a tag CPF informada: <?xml version="1.0" encoding="UTF-8"?> <Cliente xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <CPF>00000000000191</CPF> <Nome>Fulano de Tal</Nome> <Telefone>11-3333-1000</Telefone> </Cliente> no leiaute da NF-e, o Elemento identificado com as letras CE ou CG na coluna ele:
# 1 2 ID
B01 B02

Campo CNPJ CPF

Descrio CNPJ do cliente CPF do cliente

Ele CE CE

Pai A01 A01

Tipo

Ocorrn cia

tamanho

Dec.

C C

1-1 1-1

0, 14 11

Observao Informar o CNPJ ou CPF do cliente, preenchendo os zeros no significativos, no informar o contedo da TAG se o cliente no possuir CNPJ.

Pgina 13 de 41

3.3

Regras de preenchimento dos campos da NF-e

O correto preenchimento dos campos da NF-e evita a ocorrncia da rejeio da NF-e por falha no Schema XML. O preenchimento dos campos da NF-e depende do caso concreto (hiptese de emisso da NF), mas existem algumas regras gerais de preenchimento que devem ser seguidas: proibio de caracteres de controle no contedo do campo o caractere de Tab (#9), Carriage Return (#13) e Line Feed (#10) no so permitidos em qualquer posio do campo (incio, meio ou fim). A existncia de caracteres de controle como por exemplo a seqncia hexadecimal EF BB BF no incio da string que serve para identificar um arquivo no padro UTF-8 na string enviada ao Web Service causa rejeio por falha de Schema XML. espao em branco - espao em branco consecutivo no permitido no incio e no final de qualquer campo. O espao em branco consecutivo no meio do campo s permitido em alguns campos caracteres como nome, endereo, observao, etc. A existncia de caracteres em branco no final do campo uma das causas mais comum de rejeio por falha de Schema XML e que atormenta o desenvolvedor que custa enxergar este detalhe ao analisar as falhas de validao de Schema XML; campo data as datas devem ser informadas no formato AAAA-MM-DD; campos no obrigatrios sem contedo devem ser omitidos campos de preenchimento no obrigatrio no devem ser informados quando no tiverem contedo ou o seu contedo for zero (campos de valor), para verificar se um campo obrigatrio ou no verifique a coluna de ocorrncia, os campos no obrigatrios tem o primeiro dgito = 0 (0-1) , vide letra c do item anterior (cardinalidade); respeito ao tipo do campo a definio do tipo do campo deve ser respeitada, um campo numrico no aceita caractere em hiptese alguma; respeito ao tamanho do campo os tamanhos mximo e mnimo do campo devem ser respeitados. No caso de campo de valor, a quantidade de casas decimais deve ser respeitada tambm, o ponto decimal do campo no considerado para efeitos de tamanho do campo. Campos de valor devem ser informados com 2 casas decimais e os campos de quantidade com 4 casas decimais. proibio de caracteres de formatao de campos os campos devem ser informados sem qualquer mscara de formatao para o campo, assim campos como o CPF, CNPJ, IE, telefone, etc. devem ser informados sem a mscara de formatao. O separador de milhar tambm no deve ser utilizado nos campos de valor;

3.4

Campos unidade de tributao e quantidade de tributao

Os campos de unidade de tributao (uTrib) e quantidade de tributao (qTrib) foram criados para atender a necessidade do Fisco de identificar as situaes de mercadorias em que a unidade de tributao diferente da unidade de comercializao.

Pgina 14 de 41

A unidade de tributao corresponde unidade de comercializao do varejo da mercadoria. Por exemplo, o refrigerante em lata um produto cuja unidade de comercializao de atacado diferente da unidade de comercializao do varejo. A unidade comercializao do varejo (unidade de tributao) do produto uma lata de 355 ml, contudo a indstria comercializa o produto em pack com 6, 12 ou 24 unidades. Em uma NF esta informao consignada na descrio do produto:
CD.PROD. 0001 0002 0003 DESCRIO DO PRODUTO REFRIGERANTE LATA 6 X 355ML CERVEJA GARRAFA 24 X 600ML REFRIGERANTE PET 8 X 2,5L CST 010 010 010 UNID PCT CX PCT QTDE 2 2 8 VALOR UNITRIO 5,00 18,00 12,00 VALOR TOTAL 10,00 36,00 96,00 ALQUOTA ICMS IPI 18% 18% 18%

Nesta situao, a venda de 2 pack realizada pela indstria equivale a venda de 12 unidades do produto na unidade de varejo (lata de 355ML), que pode ser facilmente identificado visualmente na descrio do produto da NF, mas no pode ser facilmente compreendido pelas aplicaes das Secretarias de Fazenda, motivando a criao dos campos unidade de varejo (unidade de tributao) o e quantidade de varejo (quantidade de tributao). Para efeitos tributrios, a nota fiscal deve ter a informao que seja possvel identificar que a operao equivale a uma venda de 12 latas (unidade de pauta, substituio tributria, etc.), que conseguido pela informao da quantidade tributada e unidade tributada. Assim, temos: qCom = 2 uCom = pack (6 x 355 ml) qTrib = 12 uTrib = lata (355 ml) no final, temos que qCom * uCom = qTrib * uTrib.

Pgina 15 de 41

3.5

Preenchimento das informaes do ICMS

O preenchimento das informaes do ICMS causam dificuldades de entendimento para muitos desenvolvedores, assim vamos dar exemplo para cada caso em particular. 3.5.1 ICMS CST 00 Tributada integralmente Para o CST = 00 deve ser informado o grupo ICMS00, com os seguintes campos:

<ICMS> <ICMS00> <orig>0</orig> <CST>00</CST> <modBC>3</modBC> <vBC>100.00</vBC> <pICMS>18.00</pICMS> <vICMS>18.00</vICMS> </ICMS00> </ICMS>

Pgina 16 de 41

3.5.2 ICMS CST 10 Tributada e com cobrana do ICMS por substituio

tributria
Para o CST = 10 deve ser informado o grupo ICMS10, com os seguintes campos:

Pgina 17 de 41

<ICMS> <ICMS10> <orig>0</orig> <CST>10</CST> <modBC>3</modBC> <vBC>100.00</vBC> <pICMS>18.00</pICMS> <vICMS>18.00</vICMS> <modBCST>4</modBCST> <pMVAST>50.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>135.00</vBCST> <pICMSST>18.00</pICMSST> <vICMSST>6.30</vICMSST> </ICMS10> </ICMS> ** Os campos pMVAST e pRedBCST devem ser omitidos quando o contedo for igual a zero.

Pgina 18 de 41

3.5.3 ICMS CST 20 com reduo de base de clculo Para o CST = 20 deve ser informado o grupo ICMS20, com os seguintes campos:

<ICMS> <ICMS20> <orig>0</orig> <CST>20</CST> <modBC>3</modBC> <pRedBC>10.00</pRedBC> <vBC>90.00</vBC> <pICMS>18.00</pICMS> <vICMS>16.20</vICMS> </ICMS20> </ICMS>

Pgina 19 de 41

3.5.4 ICMS CST 30 Isenta ou no tributada e com cobrana do ICMS por

substituio tributria
Para o CST = 30 deve ser informado o grupo ICMS30, com os seguintes campos:

<ICMS> <ICMS30> <orig>0</orig> <CST>30</CST> <modBCST>4</modBCST> <pMVAST>50.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>135.00</vBCST> <pICMSST>18.00</pICMSST>

Pgina 20 de 41

<vICMSST>24.30</vICMSST> </ICMS30> </ICMS> ** Os campos pMVAST e pRedBCST devem ser omitidos quando o contedo for igual a zero.

Pgina 21 de 41

3.5.5 ICMS CST 40 Isenta Para o CST = 40 deve ser informado o grupo ICMS40, com os seguintes campos:

<ICMS> <ICMS40> <orig>0</orig> <CST>40</CST> </ICMS40> </ICMS>

Pgina 22 de 41

3.5.6 ICMS CST 41 No tributada Para o CST = 41 deve ser informado o grupo de ICMS40, com os seguintes campos:

<ICMS> <ICMS40> <orig>0</orig> <CST>41</CST> </ICMS40> </ICMS>

Pgina 23 de 41

3.5.7 ICMS CST 50 Suspenso Para o CST = 50 deve ser informado o grupo ICMS40, com os seguintes campos:

<ICMS> <ICMS40> <orig>0</orig> <CST>50</CST> </ICMS40> </ICMS>

Pgina 24 de 41

3.5.8 ICMS CST 51 Diferimento Para o CST = 51 deve ser informado o grupo ICMS51, com os seguintes campos:

<ICMS> <ICMS51> <orig>0</orig> <CST>51</CST> <modBC>3</modBC> <pRedBC>20.00</pRedBC>** <vBC>80.00</vBC>** <pICMS>12.00</pICMS>** <vICMS>9.60</vICMS>** </ICMS51> </ICMS> ** Os campos modBC, pRedBC, vBC, pICMS e vICMS podem ser omitidos quando no exigidos pela legislao ou o seu contedo for igual a zero.

Pgina 25 de 41

3.5.9 ICMS CST 60 ICMS cobrado anteriormente por substituio tributria Para o CST = 60 deve ser informado o grupo ICMS60, com os seguintes campos:

<ICMS> <ICMS60> <orig>0</orig> <CST>60</CST> <vBCST>135.00</vBCST> <vICMSST>24.30</vICMSST> </ICMS60> </ICMS>

Pgina 26 de 41

3.5.10 ICMS CST 70 Com reduo de base de clculo e cobrana de ICMS por

substituio tributria
Para o CST = 70 deve ser informado o grupo ICMS70, com os seguintes campos:

Pgina 27 de 41

<ICMS> <ICMS70> <orig>0</orig> <CST>70</CST> <modBC>3</modBC> <pRedBC>10.00</pRedBC> <vBC>90.00</vBC> <pICMS>18.00</pICMS> <vICMS>16.20</vICMS> <modBCST>4</modBCST> <pMVAST>100.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>162.00</vBCST> <pICMSST>18.00</pICMSST> <vICMSST>12.96</vICMSST> </ICMS70> </ICMS>

** Os campos pMVAST e pRedBCST devem ser omitidos quando o contedo for igual a zero.

Pgina 28 de 41

3.5.11 ICMS CST 90 - Outras Para o CST = 90 deve ser informado o grupo ICMS90, com os seguintes campos:

Pgina 29 de 41

<ICMS> <ICMS90> <orig>0</orig> <CST>90</CST> <modBC>3</modBC> <pRedBC>10.00</pRedBC> ** <vBC>90.00</vBC> <pICMS>18.00</pICMS> <vICMS>16.20</vICMS> <modBCST>4</modBCST> <pMVAST>100.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>162.00</vBCST> <pICMSST>18.00</pICMSST> <vICMSST>12.96</vICMSST> </ICMS90> </ICMS>

** Os campos pRedBC, pMVAST e pRedBCST devem ser omitidos quando o contedo for igual a zero. Possibilidades de preenchimento das informaes do grupo ICMS90: Com todas as informaes Somente ICMS
<ICMS> <ICMS90> <orig>0</orig> <CST>90</CST> <modBC>3</modBC> <pRedBC>10.00</pRedBC> ** <vBC>90.00</vBC> <pICMS>18.00</pICMS> <vICMS>16.20</vICMS> <modBCST>4</modBCST> <pMVAST>100.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>162.00</vBCST> <pICMSST>18.00</pICMSST> <vICMSST>12.96</vICMSST> </ICMS90> </ICMS> <ICMS> <ICMS90> <orig>0</orig> <CST>90</CST> <modBC>3</modBC> <pRedBC>10.00</pRedBC> ** <vBC>90.00</vBC> <pICMS>18.00</pICMS> <vICMS>16.20</vICMS> </ICMS>

Somente ICMSST
<ICMS> <ICMS90> <orig>0</orig> <CST>90</CST> <modBCST>4</modBCST> <pMVAST>100.00</pMVAST>** <pRedBCST>10.00<pRedBCST>** <vBCST>162.00</vBCST> <pICMSST>18.00</pICMSST> <vICMSST>12.96</vICMSST> </ICMS90> </ICMS>

Sem ICMS e ICMSST

<ICMS> <ICMS90> <orig>0</orig> <CST>90</CST> </ICMS>

** Os campos pRedBC, pMVAST e pRedBCST devem ser omitidos quando o contedo for igual a zero.

Pgina 30 de 41

4. Estabelecendo conexo com os Web Services da NF-e

A identificao das partes envolvidas na transao e o sigilo da comunicao so os principais requisitos para que as pessoas possam realizar transaes eletrnicas seguras em redes abertas como a Internet. A infra-estrutura de chave pblica uma arquitetura de confiabilidade baseada em certificados digitais que permite a realizao de transaes eletrnicas em redes abertas com segurana e privacidade. O projeto da Nota Fiscal eletrnica NF-e utiliza o Protocolo de Comunicao Secure Socket Layer SSL, verso 3.0, com autenticao mtua atravs de certificados digitais X509 verso 3 emitidos por Autoridade Certificadora AC credenciada Infra-Estrutura de Chaves Pblicas Brasileira ICPBrasil, o que garante a identificao das partes envolvidas na comunicao, alm do estabelecimento de um canal seguro de comunicao atravs da criptografia de dados. O processo de estabelecimento da conexo realizado com a troca de certificados digitais entre cliente e servidor, que verificam a validao do certificado digital recebido. Uma vez estabelecida a relao de confiana, o servidor envia uma chave pblica ao cliente que ser utilizado para a criptografia da comunicao. A validao do certificado digital envolve no mnimo as seguintes verificaes: se atende o padro X509 - verso 3; se foi emitido por uma Autoridade Certificadora AC credenciada ao ICP-Brasil; se o certificado digital da AC emissora um certificado digital vlido; se o certificado digital est sendo utilizado dentro do prazo de validade (incio e fim); se no se encontra revogado; se certificado digital de pessoa jurdica e contem o CNPJ no campo otherName OID = 2.16.76.1.3.3, pelo qual identificado o CNPJ do titular do certificado digital;

O uso de certificados digitais autnticos e vlidos (no expirada ou revogado) emitidos por AC credenciada ao ICP Brasil o principal requisito para estabelecimento da conexo com os Web Services da NF-e. Valendo ressaltar que os certificados digitais genricos, como o caso do certificado digital da Associacao.pfx que existe no pacote demo da dll NFe_Util no so aceitos pelos Web Services da NF-e por no ter sido emitido por uma AC autntica. Assim, o primeiro passo para estabelecer a conexo com o WS da NF-e possuir um certificado digital autntico, no caso das empresas, os testes iniciais podem ser realizados com o e-CNPJ da empresa, caso a empresa possua este tipo de certificado digital. No caso dos prestadores de servios, o ideal adquirir ou solicitar que o cliente permita a emisso de um certificado e-PJ mltiplo, do tipo A1, para a realizao dos testes e implantao da NF-e, vale ressaltar que sem o certificado digital vlido a empresa tem mnimas chances de implantar a NF-e, pois o certificado digital exigido para consumir todos os Web Services da NF-e.

Pgina 31 de 41

O desenvolvedor que possui CNPJ deve avaliar a possibilidade de solicitar a inscrio no cadastro de contribuintes do ICMS para se tornar emissor voluntrio da NF-e e ter acesso a todos os Web Services em nome prprio, sem ter que se preocupar com a possibilidade de praticar algum ato prejudicial para o cliente durante o desenvolvimento da aplicao de emisso da NF-e.

4.1

Instalando o Certificado Digital do emissor

Possuir um certificado digital autntico no basta, necessrio que o mesmo esteja corretamente instalado no equipamento que vai ser utilizado para conexo com o Web Service da NF-e. Siga os passos de instalao fornecidos pela AC emissora de seu certificado digital. A verificao da correta instalao do certificado digital pode ser realizado pelo browser IE (Ferramentas/opes da Internet/contedo/certificados/exibir/caminho de certificao) ou at pelo aplicativo demo na opo certificado digital/exibir. Exemplo de Certificado Digital com problemas:

O Certificado Digital da AC emissora no pode ser verificado, falta o certificado digital do nvel superior. Exemplo de Certificado Digital corretamente instalado:

Pgina 32 de 41

4.2

Erro no processo de assinatura por falha na instalao do driver do dispositivo do certificado digital tipo A3

Os certificados digitais do tipo A3 que so armazenados em dispositivos portteis (smartcard/token USB) podem apresentar alguma falha no funcionamento, caso o gerenciador de certificados digitais utilizado no seja compatvel com o dispositivo. Existem relatos de emissores que enfrentaram problemas de falha na assinatura em ambiente Windows com a mensagem: The specified cryptographic service provider (CSP) does not support this key algorithm ou O CSP (provedor de servios de criptografia) especificado no oferece suporte a este algoritmo de chave com alguns certificados digitais do tipo A3. A atualizao do gerenciador de dispositivos pode resolver o problema (http://nfeletronica.com/blog?dl_id=29).

4.3

Instalando o Certificado Digital do Web Service

Os Web Services da NF-e utilizam certificados digitais e o equipamento do cliente deve estar preparado para ter instalado em seu equipamento os certificados digitais das AC do certificado digital utilizado no Web Services:

Pgina 33 de 41

UF AC AL AM AP BA CE DF ES GO MA MG MS MT PA PB PE PI PR RJ RN RO RR RS SC SE SP TO

Web Service SEFAZ Virtual RS SEFAZ Virtual RS SEFAZ Virtual RS SEFAZ Virtual RS prprio SVAN prprio prprio prprio SVAN prprio prprio prprio SVAN SEFAZ Virtual RS prprio SVAN SVAN SEFAZ Virtual RS SVAN prprio SEFAZ Virtual RS prprio SEFAZ Virtual RS SEFAZ Virtual RS prprio SEFAZ Virtual RS

Ambiente de Homologao AC emissora Vecto AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SEF-DF AC PRODEMGE AC SERPRO SRF v1 AC SERPRO SRF v1 AC PRODEMGE AC SERPRO v1 AC CertiSign Multipla V3 AC SERPRO SRF v1 AC SERPRO SRF v1 Verisign.com AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERASA SRF AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC CertiSign Multipla V3 AC SERPRO SRF v1

Ambiente de Produo AC emissora Vecto 18/07/09 18/07/09 18/07/09 18/07/09 09/06/09 11/12/08 22/01/09 04/10/08 19/08/08 11/12/08 15/07/09 11/06/09 09/10/08 11/12/08 18/07/09 12/03/09 11/12/08 11/12/08 18/07/09 11/12/08 06/03/09 18/07/09 18/07/09 18/07/09 18/07/09 11/09/08 18/07/09

18/07/09 AC SERPRO SRF v1 18/07/09 AC SERPRO SRF v1 18/07/09 AC SERPRO SRF v1 18/07/09 10/06/09 13/11/08 09/09/10 04/10/08 19/08/08 13/11/08 03/01/09 11/06/09 18/10/08 13/11/08 18/07/09 18/12/08 13/11/08 13/11/08 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO SRF v1 AC CertiSign Multipla V3 AC PRODEMGE AC SERPRO SRF v1 AC SERPRO SRF v1 AC PRODEMGE AC SERPRO v1 AC CertiSign Multipla V3 AC SERPRO SRF v1 AC SERPRO SRF v1 AC SERPRO v1 AC SERPRO SRF v1 AC SERPRO SRF v1

18/07/09 AC SERPRO SRF v1 13/11/08 AC SERPRO SRF v1 06/03/09 AC SERASA SRF 18/07/09 AC SERPRO SRF v1 18/07/09 AC SERPRO SRF v1 18/07/09 AC SERPRO SRF v1 18/07/09 AC SERPRO SRF v1 12/06/09 AC CertiSign Multipla V3 18/07/09 AC SERPRO SRF v1

Os certificados do ambiente de homologao do DF e de PE no so padro ICP/BR.

A principal preocupao que deve existir com o certificado digital do Web Service a instalao da cadeia de certificao da AC emissora do certificado digital utilizado pelo Web Service. O caminho mais curto a instalao de toda a cadeia de certificao das Autoridades Certificadoras da Infra-Estrutura de Chaves Pblicas Brasileira - ICP-Brasil que pode ser obtida no Repositrio da AC Raiz. Atualmente so 53 certificados digitais, o emissor tem a opo de instalar somente a cadeia de certificao necessria para acessar o Web Service da sua UF.

Pgina 34 de 41

Apesar de existirem 28 unidades federadas, somente 11 unidades federas mantm aplicao prpria (BA, DF, ES, GO, MG, MS, MT, PE, RO, RS e SP), as demais unidades federadas utilizam a SEFAZ Virtual do RS (AC, AL, AM, AP, PB, RJ, RR, SC, SE e TO) ou a SEFAZ Virtual do Ambiente Nacional - SVAN (CE, MA, PA, PI, PR e RN), vale observar que a situao est em constante alterao, pois muitas UF esto concluindo o desenvolvimento dos sistemas prprios. Os Web Services utilizam certificados digitais das seguintes cadeias de certificao da hierarquia ICPBrasil (em ordem alfabtica):

AC CertiSign Mltipla V3 (MT, SP e DF-ambiente de produo); AC PRODEMGE (ES e MG); AC SERASA SRF (RO); AC SERPRO Final v1 (GO, MS e SVAN (CE, MA, PA, PI, PR e RN)); AC SERPRO SRF v1 (BA, RS e SEFAZ Virtual RS (AC, AL, AM, AP, PB, RJ, RR, SC, SE e TO));

As seguintes UF que no utilizam certificados digitais da hierarquia ICP-Brasil no ambiente de homologao:

DF - utiliza certificado prprio - AC SEF-DF; PE - utiliza certificado verisign.

Assim, o emissor que desejar pode instalar somente a cadeia de certificao necessria para a sua UF. Importante ressaltar que os emissores do DF devem instalar a cadeia de certificado proprietrio do DF, pois se trata de certificado digital no autntico. 4.4

Problemas na conexo

No incio do projeto muito comum a ocorrncia de erros na conexo que dificulta o processo de implementao da NF-e, principalmente se o interessado optar por desenvolver todas as funcionalidades necessrias para consumir os Web Services. A seguir relacionamos os erros mais comuns que podem ocorrer no estabelecimento da conexo com o Web Service:

The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel. - a causa provvel do erro a inexistncia da cadeia de certificao do Web Service acessado no equipamento do emissor, a instalao da cadeia de certificao correspondente deve resolver o problema. The request was aborted: Could not create SSL/TLS secure channel. o certificado cliente no um certificado aceito pelo Web Service que est configurado para no estabelecer a conexo, quando a servidor aceita o envio do certificado digital invlido, resulta em erro :The request failed with HTTP status 403: Forbidden. O emissor deve conseguir um certificado digital autntico para prosseguir.

Pgina 35 de 41

The remote name could not be resolved: nfe.sefaz.rsvirtual.gov.br - domnio inexistente, verificar a sintaxe do domnio na url; The request failed with HTTP status 404: Not Found. - o servio solicitado no existe, verificar a sintaxe do servio na url; Unable to connect to the remote server - impossibilidade de conexo com o servidor, contatar a UF do Web Service para obter maiores informaes da disponbilidade do WS. The request failed with HTTP status 503: Service Temporarily Unavailable. - o Web Service est temporariamente indisponvel, o emissor deve tentar a conexo mais tarde. The operation has timed out - a aplicao cliente abortou a requisio por time-out, o Web Service pode estar sobrecarregado ou existe algum problema no link. The request failed with HTTP status 403: Forbidden. - o Web Service no estabeleceu a conexo por algum problema no certificado digital da aplicao cliente. Existem diversas causas para a falha, recomendamos que o emissor tente a conexo ao Web Service pelo browser, o uso do IE recomendado por utilizar o mesmo repositrio de certificados digitais no caso de aplicaes .NET, como por exemplo a biblioteca NFe_Util.dll. A conexo pelo browser mostra o cdigo de erro HTTP com detalhes que permite identificar a real causa da falha, a seguir listamos os HTTP error da famlia 403 mais comuns (a lista completa est disponvel em: http://www.wats.ca/show.php?contentid=36): o HTTP Error 403.7 - certificado digital do cliente no enviado para o servidor atachado na mensagem SOAP. Forbidden: Client certificate required. This error occurs when the resource you are attempting to access requires your browser to have a client Secure Sockets Layer (SSL) certificate that the server recognizes. This is used for authenticating you as a valid user of the resource. Please contact the Web servers administrator to obtain a valid client certificate. o HTTP Error 403.9 - Muitos usurios conectado - erro raro. Access Forbidden: Too many users are connected. This error can be caused if the Web server is busy and cannot process your request due to heavy traffic. Please try to connect again later. Please contact the Web servers administrator if the problem persists. o HTTP Error 403.13 - O certificado do cliente se encontra revogado. Client certificate revoked: The page you are trying to view requires the use of a valid client certificate. Your client certificate was revoked, or the revocation status could not be determined. The certificate is used for authenticating you as a valid user of the resource. o HTTP Error 403.16 - O certificado do cliente no confivel ou invlido. Client certificate untrusted or invalid: The page you are trying to view requires the use of a valid client certificate. Your client certificate is untrusted or invalid. The client certificate is used for authenticating you as a valid user of the resource. o HTTP Error 403.17 - O certificado do cliente no se encontra no perodo de validade. Client certificate has expired or is not yet valid: The page you are trying to view requires the use of a valid client certificate. Your client certificate has expired or is not yet valid. The client certificate is used for identifying you as a valid user of the resource.

Pgina 36 de 41

4.5

Instalando uma cadeia de certificao em ambiente Windows

Vamos fazer um exemplo de instalao da cadeia de certificao do AC emissora do certificado digital utilizados em MT, SP e ambiente de produo do DF. Obtenha o arquivo com a cadeia de certificao em http://nf-eletronica.com/blog?dl_id=31. Selecione o arquivo obtido com Explorer e clique com o boto direito e selecione a o item Instalar certificado:

Pgina 37 de 41

Confirme a importao do certificado clicando em avanar:

Confirme o local de armazenamento padro e clique em avanar:

Pgina 38 de 41

Confirme a concluso da importao:

Se tudo correr bem a importao de ser realizada com sucesso:

Pgina 39 de 41

Para verificar se o certificado foi instalado corretamente, abra o browser (Ex. Internet Explorer) e selecione Ferramentas/Opes da Internet/Contedo/Certificados/Autoridades de Certificao intermedirias/certificado instalado e clique em exibir:

Sero exibidas as informaes bsicas do certificado digital:

Pgina 40 de 41

Selecione a aba Caminho de certificao e verifique se o caminho de certificao est correta:

Pgina 41 de 41