Você está na página 1de 145

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Projeto Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte


Padres Tcnicos de Comunicao

Verso 3.0 Maro 2009

Pg. 1 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Controle de Verses
Verso 0.1.0 1.0.0 1.0.1 1.0.2 1.1.0 1.1.1 Data 16/12/2005 SC 06/01/2006 SP 11/01/2006 GO 19/01/2006 SP 26/01/2006 SP 30/05/2006 SP consolidao das seguintes erratas: Errata 13-03-2006 Errata 21-03-2006 Errata 05-05-2006 Errata 08-05-2006 Errata 25-05-2006 27/11/2006 SP/RS 23/04/2007 SP/RS/GO 29/06/2007 - SP/RS 16/06/2008 - SP 16/03/2009 SP/RS

2.0.0 2.0.1 2.0.2 2.0.2a 3.0

Pg. 2 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Identificao e vigncia do Manual


Verso do manual Data de divulgao da verso inicial do manual Atualizao para verso 2.0.2b Pacote de liberao de Schemas XML Data de incio de vigncia no ambiente de homologao Data de incio de vigncia no ambiente de produo Pacote de liberao de Schemas XML em vigncia Data final de vigncia do PL_003b

3.0 29/06/2007 Maro/2009 PL_005c 01/09/2007 01/10/2007 PL_003b 31/12/2007

Verses de leiautes do PL_005c


Leiaute NFe envNFe retEnvNFe consReciNFe retconsReciNFe procNFe cancNFe retCancNFe procCancNFe inutNFe retInutNFe procInutNFe consSitNFe retconsSitNFe consStatServ retConsStatServ consCad retConsCad cadEmiDFe atuCadEmiDFe retAtuCadEmiDFe verso 1.10 1.10 1.10 1.10 1.10 1.10 1.07 1.07 1.07 1.07 1.07 1.07 1.07 1.07 1.07 1.07 1.01 1.01 1.01 1.01 1.01 Observao Leiuate da NF-e. Mensagem de envio de lote de NF-e. Mensagem de retorno do envio de lote de NF-e. Mensagem de consulta processamento do lote de NFe transmitida. Mensagem de retorno da consulta de processamento do lote de NF-e transmitida. Leiaute de compartilhamento da NF-e. Mensagem de solicitao de cancelamento da NF-e. Mensagem de retorno do resultado da solicitao do processamento de cancelamento da NF-e. Leiaute de compartilhamento de Pedido de cancelamento de NF-e Mensagem de solicitao de inutilizao de numerao de NF-e. Mensagem de retorno do resultado do processamento da solicitao de inutilizao de numerao de NF-e. Leiaute de compartilhamento de pedido de inutilizao de numerao de NF-e Mensagem de consulta da situao atual da NF-e. Mensagem de retorno da consulta da situao atual da NF-e. Mensagem da consulta do status do servio de autorizao de NF-e. Mensagem de retorno da consulta do status do servio de autorizao de NF-e. Mensagem de consulta ao cadastro de contribuintes do ICMS. Mensagem de retorno da consulta ao cadastro de contribuintes do ICMS. Leiaute do Cadastro Nacional de Emissores de documentos fiscais eletrnicos. Mensagem de atualizao do Cadastro Nacional de Emissores de documentos fiscais eletrnicos Mensagem de retorno da atualizao do Cadastro Nacional de Emissores de documentos fiscais eletrnicos

Pg. 3 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

ndice
Introduo ......................................................................................................... 8 Consideraes Iniciais ....................................................................................... 9 2.1 Objetivos do Projeto ............................................................................................... 9 2.2 Conceito da NF-e ................................................................................................... 9 2.3 Descrio Simplificada do Modelo Operacional ...................................................... 9 3. Arquitetura de Comunicao com Contribuinte ................................................ 11 3.1 Modelo Conceitual ................................................................................................ 11 3.2 Padres Tcnicos................................................................................................. 12 3.2.1 Padro de documento XML .............................................................................. 12 3.2.2 Padro de Comunicao .................................................................................. 14 3.2.3 Padro de Certificado Digital ............................................................................ 15 3.2.4 Padro de Assinatura Digital ............................................................................ 15 3.2.5 Validao de Assinatura Digital pela Secretaria de Fazenda Estadual ............. 17 3.2.6 Resumo dos Padres Tcnicos ........................................................................ 18 3.3 Modelo operacional .............................................................................................. 19 3.3.1 Servios sncronos ........................................................................................... 19 3.3.2 Servios assncronos........................................................................................ 19 3.3.3 Filas e Mensagens ........................................................................................... 21 3.4 Padro de mensagens dos Web Services ............................................................ 22 3.4.1 rea de Cabealho ........................................................................................... 22 3.4.2 Validao da estrutura XML das Mensagens dos Web Services ...................... 23 3.4.3 Schemas XML das Mensagens dos Web Services ........................................... 23 3.5 Verso dos Schemas ........................................................................................... 24 3.5.1 Liberao das verses dos Schemas para o Projeto da NF Eletrnica ............. 24 3.5.2 Controle de Verso........................................................................................... 25 4. Web Services .................................................................................................. 26 4.1 Web Service NfeRecepcao................................................................................ 27 4.1.1 Leiaute Mensagem de Entrada ......................................................................... 27 4.1.2 Leiaute Mensagem de Retorno......................................................................... 27 4.1.3 Descrio do Processo de Recepo de Lotes de NF-e ................................... 28 4.1.4 Validao do Certificado de Transmisso ......................................................... 28 4.1.5 Validao Inicial da Mensagem no Web Service .............................................. 29 4.1.6 Gerao da Resposta com o Recibo ................................................................ 29 4.1.7 Descrio do Processamento do Lote de NF-e................................................. 30 4.1.8 Validao da rea de cabealho da mensagem ............................................... 30 4.1.9 Validao da rea de Dados............................................................................. 30 4.1.10 Final do Processamento do Lote .................................................................. 34 4.2 Web Service NfeRetRecepcao .......................................................................... 36 4.2.1 Leiaute Mensagem de Entrada ......................................................................... 36 4.2.2 Leiaute Mensagem de Retorno......................................................................... 36 4.2.3 Descrio do Processo de Web Service ........................................................... 38 4.2.4 Validao do Certificado de Transmisso ......................................................... 38 4.2.5 Validao Inicial da Mensagem no Web Service .............................................. 38 4.2.6 Validao da rea de Cabealho ..................................................................... 39 4.2.7 Validao da rea de Dados ............................................................................ 39 4.2.8 Final do Processamento ................................................................................... 40 4.3 Web Service - NfeCancelamento.......................................................................... 41 4.3.1 Leiaute Mensagem de Entrada ......................................................................... 41 4.3.2 Leiaute Mensagem de Retorno......................................................................... 42 4.3.3 Descrio do Processo de Web Service ........................................................... 42 4.3.4 Validao do Certificado de Transmisso ......................................................... 43 4.3.5 Validao Inicial da Mensagem no Web Service .............................................. 43
Pg. 4 / 145

1. 2.

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.3.6 Validao da rea de Cabealho ..................................................................... 44 4.3.7 Validao da rea de Dados ............................................................................ 44 4.3.8 Final do Processamento ................................................................................... 46 4.4 Web Service - NfeInutilizacao............................................................................... 47 4.4.1 Leiaute Mensagem de Entrada ......................................................................... 47 4.4.2 Leiaute Mensagem de Retorno......................................................................... 48 4.4.3 Descrio do Processo de Web Service ........................................................... 48 4.4.4 Validao do Certificado de Transmisso ......................................................... 49 4.4.5 Validao Inicial da Mensagem no Web Service .............................................. 49 4.4.6 Validao da rea de Cabealho ..................................................................... 50 4.4.7 Validao da rea de Dados ............................................................................ 50 4.4.8 Final do Processamento ................................................................................... 52 4.5 Web Service NfeConsulta Protocolo .................................................................. 53 4.5.1 Leiaute Mensagem de Entrada ......................................................................... 53 4.5.2 Leiaute Mensagem de Retorno......................................................................... 53 4.5.3 Descrio do Processo de Web Service ........................................................... 54 4.5.4 Validao do Certificado de Transmisso ......................................................... 54 4.5.5 Validao Inicial da Mensagem no Web Service .............................................. 55 4.5.6 Validao da rea de Cabealho ..................................................................... 56 4.5.7 Validao da rea de Dados ............................................................................ 56 4.5.8 Final do Processamento ................................................................................... 56 4.6 Web Service - NfeStatusServico .......................................................................... 57 4.6.1 Leiaute Mensagem de Entrada ......................................................................... 57 4.6.2 Leiaute Mensagem de Retorno......................................................................... 57 4.6.3 Descrio do Processo de Web Service ........................................................... 58 4.6.4 Validao do Certificado de Transmisso ......................................................... 58 4.6.5 Validao Inicial da Mensagem no Web Service .............................................. 59 4.6.6 Validao da rea de Cabealho ..................................................................... 59 4.6.7 Validao da rea de Dados ............................................................................ 60 4.6.8 Final do Processamento ................................................................................... 60 4.7 Web Service CadConsultaCadastro .................................................................. 61 4.7.1 Leiaute da Mensagem de Entrada .................................................................... 61 4.7.2 Leiaute da Mensagem de Retorno .................................................................... 62 4.7.3 Descrio do Processo de Web Service ........................................................... 63 4.7.4 Verificao do Certificado de Transmisso ....................................................... 64 4.7.5 Verificao Inicial da Mensagem no Web Service ............................................ 64 4.7.6 Validao da rea de Cabealho ..................................................................... 65 4.7.7 Validao da rea de Dados ............................................................................ 65 4.7.8 Final do Processamento ................................................................................... 66 5. Web Services Informaes Adicionais .......................................................... 67 5.1 Regras de validao ............................................................................................. 67 5.1.1 Tabela de cdigos de erros e descries de mensagens de erros ................... 67 5.2 Padro de nomes para os arquivos ...................................................................... 70 5.3 Tratamento de caracteres especiais no texto de XML .......................................... 71 5.4 Chave de Acesso da NF-e ................................................................................... 71 5.5 Nmero do Recibo de Lote ................................................................................... 72 5.6 Nmero do protocolo ............................................................................................ 73 5.7 Tempo mdio de resposta .................................................................................... 73 6. Cdigo de Barra .............................................................................................. 74 6.1 Clculo do dgito verificador do CODE-128C........................................................ 75 6.2 Representao simblica do cdigo ..................................................................... 75 6.3 Representao dos dados adicionais ................................................................... 76 7. DANFE ............................................................................................................ 77 7.1 Campos do DANFE .............................................................................................. 77
Pg. 5 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7.1.1 Chave de Acesso ............................................................................................. 77 7.1.2 Dados da NF-e ................................................................................................. 77 7.1.3 Dados do Emitente ........................................................................................... 77 7.1.4 Quadro Fatura/Duplicatas ................................................................................. 78 7.1.5 Quadro Dados dos Produtos / Servios ............................................................ 78 7.1.6 Informaes Complementares .......................................................................... 79 7.1.7 Reservado ao Fisco .......................................................................................... 79 7.2 Possibilidade de Uso de Uma Mesma Coluna Com Mais de Um Campo no Quadro Dados dos Produtos/Servios........................................................................................ 79 7.3 Supresses e Modificaes Permitidas ................................................................ 80 7.3.1 Bloco de Canhoto ............................................................................................. 80 7.3.2 Quadro Fatura/Duplicatas .............................................................................. 80 7.3.3 Quadro Clculo do ISSQN ............................................................................. 80 7.4 Verso do DANFE .................................................................................................. 80 7.5 Folhas Adicionais ................................................................................................. 81 7.6 Formulrio ............................................................................................................ 81 7.6.1 Tamanho do Papel ........................................................................................... 81 7.6.2 Margem lateral no Formulrio ........................................................................... 82 7.6.3 Modelos de DANFE Permitidos ........................................................................ 82 7.7 Padres de Caracteres (Tipos de Fontes) ............................................................ 82 7.7.1 Descritivo dos Blocos de Campos .................................................................... 82 7.7.2 Descritivo dos campos do Quadro Dados dos Produtos/Servios .................. 82 7.7.3 Descritivo dos demais campos ......................................................................... 82 7.7.4 Contedo do bloco de campos de Identificao do Documento........................ 82 7.7.5 Contedo do campo Chave de Acesso. ............................................................ 83 7.7.6 Contedo do quadro Dados do Emitente .......................................................... 83 7.7.7 Contedo dos campos do Quadro Dados dos Produtos/Servios .................. 83 7.7.8 Contedo do campo Informaes Complementares ......................................... 83 7.7.9 Contedo dos demais campos ......................................................................... 83 7.8 Tamanho dos Campos ......................................................................................... 83 7.8.1 Formulrio A-4 em modo retrato ....................................................................... 83 7.8.2 Formulrio A-4 em modo paisagem .................................................................. 85 7.9 Outros .................................................................................................................. 86 7.9.1 Marca dgua ................................................................................................... 86 7.9.2 Impresso do nmero da folha ......................................................................... 86 7.9.3 Limitaes da impressora ................................................................................. 86 7.9.4 Cdigo de Barras.............................................................................................. 87 8. Contingncia ................................................................................................... 88 9. Ambiente de Homologao / Produo ........................................................... 89 10. Distribuio da NF-e para o Destinatrio ......................................................... 90 10.1 Processo de Distribuio ...................................................................................... 90 10.2 Leiaute da Distribuio: NF-e ............................................................................... 90 Anexo I Leiaute da NF-e ................................................................................................... 91 Anexo II DANFE TAMANHO A-4 EM MODO RETRATO, FOLHAS SOLTAS ................. 134 Anexo III DANFE TAMANHO A-4 EM MODO RETRATO, FORMULRIO CONTNUO .. 135 Anexo IV DANFE TAMANHO A-4 EM MODO PAISAGEM, FOLHAS SOLTAS .............. 136 Anexo V DANFE TAMANHO A-4 EM MODO PAISAGEM, FORMULRIO CONTNUO . 137 Anexo VI WS disponveis ................................................................................................ 138 Anexo VII Conjunto de caracteres Cdigo de Barras CODE-128C ................................. 139 Anexo VIII Projeto Piloto da NF-e ................................................................................... 140 Anexo IX Tabelas de UF, Municpio e Pas ..................................................................... 141 1. Tabela de cdigo de UF do IBGE .................................................................. 141 2. Tabela de cdigo de Municpio do IBGE ........................................................ 141 2.1 Validao do cdigo de Municpio ...................................................................... 142
Pg. 6 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

2.2 3. 3.1 3.2

Exemplo de clculo do dgito de controle do cdigo de Municpio ...................... 142 Tabela de cdigo de Pas do BACEN ............................................................ 143 Validao do cdigo de Pas .............................................................................. 144 Exemplo de clculo do dgito de controle do cdigo de Pas .............................. 144

Pg. 7 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

1. Introduo
Este documento tem por objetivo a definio das especificaes e critrios tcnicos necessrios para a integrao entre os Portais das Secretarias de Fazendas dos Estados e os sistemas de informaes das empresas emissoras de NF-e do Projeto da Nota Fiscal Eletrnica (NF-e). Em vista da complexidade do projeto, esclarecemos aos usurios deste manual (equipes fiscal e de TI das empresas integrantes do projeto), que a legislao aprovada, conceitos e especificaes contidas neste manual podem sofrer ajustes que venham a ser demandados a partir do aprofundamento das discusses e experincias adquiridas durante a fase de implantao do projeto.

Pg. 8 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

2. Consideraes Iniciais
O Projeto Nota Fiscal Eletrnica (NF-e) est sendo desenvolvido, de forma integrada, pelas Secretarias de Fazenda dos Estados e Receita Federal, a partir da assinatura do Protocolo ENAT 03/2005 (27/08/2005), que atribui ao Encontro Nacional de Coordenadores e Administradores Tributrios Estaduais (ENCAT) a coordenao e a responsabilidade pelo desenvolvimento e implantao do Projeto NF-e. Para harmonizar a legislao sobre a NF-e, foi celebrado o Ajuste SINIEF 07/05, pelos Estados, Distrito Federal e Ministrio da Fazenda, juntamente com a legislao complementar contida no Ato COTEPE 72/05, de 22/12/2005. O Ajuste SINIEF 07/05 tem recebido atualizaes, resultado da evoluo ocorrida desde o incio da fase de massificao.

2.1

Objetivos do Projeto

O Projeto NF-e tem como objetivo a implantao de um modelo nacional de documento fiscal eletrnico que venha substituir a sistemtica atual de emisso do documento fiscal em papel, modelos 1 e 1A, com validade jurdica garantida pela assinatura digital do remetente, simplificando as obrigaes acessrias dos contribuintes e permitindo, ao mesmo tempo, o acompanhamento em tempo real das operaes comerciais pelo Fisco.

2.2

Conceito da NF-e

Podemos conceituar a Nota Fiscal Eletrnica (NF-e) como sendo um documento de existncia exclusivamente digital, emitido e armazenado eletronicamente, com o intuito de documentar uma operao de circulao de mercadorias ou prestao de servios, cuja validade jurdica garantida pela assinatura digital do emitente e a Autorizao de Uso fornecida pela administrao tributria do domiclio do contribuinte.

2.3

Descrio Simplificada do Modelo Operacional

De maneira simplificada, a empresa emissora de NF-e gerar um arquivo eletrnico contendo as informaes fiscais da operao comercial, o qual dever ser assinado digitalmente, de maneira a garantir a integridade dos dados e a autoria do emissor. Este arquivo eletrnico, que corresponder Nota Fiscal Eletrnica (NF-e), ser ento transmitido, pela Internet, para a Secretaria de Fazenda Estadual de jurisdio do contribuinte emitente, que far uma pr-validao do arquivo e devolver uma Autorizao de Uso, sem a qual no poder haver o trnsito da mercadoria. Aps o recebimento da NF-e, a Secretaria de Fazenda Estadual disponibilizar consulta, atravs Internet, para o destinatrio e outros legtimos interessados, que detenham a chave de acesso do documento eletrnico. Este mesmo arquivo da NF-e ser ainda transmitido atravs da Secretaria de Fazenda Estadual para: a Receita Federal, que ser repositrio nacional de todas as NF-e emitidas; no caso de uma operao interestadual, a Secretaria de Fazenda Estadual de destino da operao; e,
Pg. 9 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

quando aplicvel, os rgos e Entidades da Administrao Pblica Federal Direta e Indireta que tenham atribuio legal de regulao, normatizao, controle e fiscalizao, tais como a SUFRAMA, por exemplo.

Para acompanhar o trnsito da mercadoria ser impressa uma representao grfica simplificada da Nota Fiscal Eletrnica, intitulada DANFE (Documento Auxiliar da Nota Fiscal Eletrnica), em papel comum, em nica via, que conter impressos, em destaque, a chave de acesso e o cdigo de barras linear tomando-se por referncia o padro CODE-128C, para facilitar e agilizar a consulta da NF-e na Internet e a respectiva confirmao de informaes pelas unidades fiscais e contribuintes destinatrios. O DANFE no uma nota fiscal, nem a substitui, servindo apenas como instrumento auxiliar para consulta da NF-e, pois contm a chave de acesso da NF-e, que permite ao detentor desse documento confirmar a efetiva existncia da NF-e, atravs dos stios das Secretarias de Fazenda Estaduais autorizadoras ou Receita Federal. Apesar disto, no primeiro momento de implantao do projeto, o contribuinte destinatrio, no emissor de NF-e, poder escriturar este documento, sendo que sua validade ficar vinculada efetiva existncia da NF-e com autorizao de uso no Banco de Dados das administraes tributrias envolvidas no processo.

Pg. 10 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

3. Arquitetura de Comunicao com Contribuinte


3.1
Modelo Conceitual

Os Portais das Secretarias de Fazenda Estaduais iro disponibilizar os seguintes servios: a) Recepo de NF-e; 1) Recepo de Lote; 2) Consulta Processamento de Lote; b) Cancelamento de NF-e; c) Inutilizao de numerao de NF-e; d) Consulta da situao atual da NF-e; e) Consulta do status do servio; f) Consulta cadastro. Para cada servio oferecido existir um Web Service especfico. O fluxo de comunicao sempre iniciado pelo aplicativo do contribuinte atravs do envio de uma mensagem ao Web Service com a solicitao do servio desejado. O Web Service sempre devolve uma mensagem de resposta confirmando o recebimento da solicitao de servio ao aplicativo do contribuinte na mesma conexo. A solicitao de servio poder ser atendida na mesma conexo ou ser armazenada em filas de processamento nos servios mais crticos para um melhor aproveitamento dos recursos de comunicao e de processamento das Secretarias de Fazenda Estaduais. Os servios podem ser sncronos ou assncronos em funo da forma de processamento da solicitao de servios: a) Servios sncronos o processamento da solicitao de servio concludo na mesma conexo, com a devoluo de uma mensagem com o resultado do processamento do servio solicitado; b) Servios assncronos o processamento da solicitao de servio no concludo na mesma conexo, havendo a devoluo de uma mensagem de resposta com um recibo que apenas confirma o recebimento da solicitao de servio. O aplicativo do contribuinte dever realizar uma nova conexo para consultar o resultado do processamento do servio solicitado anteriormente. O diagrama a seguir ilustra o fluxo conceitual de comunicao entre o aplicativo do contribuinte e o Portal da Secretaria de Fazenda Estadual:

Pg. 11 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Arquitetura de Comunicao Viso Conceitual


Contribuinte
HTTPS Client NFe ( ERP ou software especfico) Fluxo de Comunicao

Secretaria de Fazenda Estadual


Web Services Servios Sncronos Aplicao NFE Servios Assncronos Filas de Msgs Transaes

Notas Fiscais

Aplicativo de Faturamento ( ERP ou software especfico)

NFEs

3.2

Padres Tcnicos

3.2.1 Padro de documento XML


a) Padro de Codificao A especificao do documento XML adotada a recomendao W3C para XML 1.0, disponvel em www.w3.org/TR/REC-xml e a codificao dos caracteres ser em UTF-8, assim todos os documentos XML sero iniciados com a seguinte declarao: <?xml version="1.0" encoding="UTF-8"?> OBS: Lembrando que cada arquivo XML somente poder ter uma nica declarao <?xml version="1.0" encoding="UTF-8"?>. Nas situaes em que um documento XML pode conter outros documentos XML, como ocorre com o documento XML de lote de envio de NF-e, deve-se tomar o cuidado para que exista uma nica declarao no incio do lote. b) Declarao namespace A declarao de namespace da NF-e dever ser realizada no elemento raiz de cada documento XML como segue: <NFe xmlns=http://www.portalfiscal.inf.br/nfe > (exemplo para o XML da NF-e) No permitida a utilizao de prefixos de namespace. Essa restrio visa otimizar o tamanho do arquivo XML. Assim, ao invs da declarao: <NFe:NFe xmlns:NFe=http://www.portalfiscal.inf.br/nfe > (exemplo para o XML da NF-e e com prefixo NFe) dever ser adotado a declarao: <NFe xmlns =http://www.portalfiscal.inf.br/nfe >

Pg. 12 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A declarao do namespace da assinatura digital dever ser realizada na prpria tag <Signature>, conforme exemplo abaixo. Cada documento XML dever ter o seu namespace individual em seu elemento raiz. No caso especfico da lote de envio da NF-e, cada NF-e dever ter declarado o seu namespace individual. Segue abaixo um exemplo:
<?xml version="1.0" encoding="UTF-8"?> <enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.01"> <idLote>200602220000001</idLote> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe Id="NFe31060243816719000108550000000010001234567890" versao="1.01"> ... <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> </NFe> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe Id="NFe31060243816719000108550000000010011234567900" versao="1.01"> ... <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> </NFe> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe Id="NFe31060243816719000108550000000010021234567916" versao="1.01"> ... <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> </NFe> </enviNFe>

c) Otimizao na montagem do arquivo Na gerao do arquivo XML da NF-e, excetuados os campos identificados como obrigatrios no modelo, no devero ser includas as TAGs de campos com contedo zero (para campos tipo numrico) ou vazio (para campos tipo caractere). A regra constante do pargrafo anterior dever estender-se para os campos onde no h indicao de obrigatoriedade e que, no entanto, seu preenchimento torna-se obrigatrio por estar condicionado legislao especfica ou ao negcio do contribuinte. Neste caso, dever constar a TAG com o valor correspondente e, para os demais campos, devero ser eliminadas as TAGs. (exemplo 1: campo R01 indAdic. Ser preenchido se a legislao especfica o exigir) (exemplo 2: SubGrupo de Informaes de Transportadora. Ser preenchido somente se o negcio do contribuinte for transporte.) Para reduzir o tamanho final do arquivo XML da NF-e alguns cuidados de programao devero ser assumidos: no incluir "zeros no significativos" para campos numricos; no incluir "espaos" no incio ou no final de campos numricos e alfanumricos; no incluir comentrios no arquivo XML;
Pg. 13 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

no incluir anotao e documentao no arquivo XML (TAG annotation e TAG documentation); no incluir caracteres de formatao no arquivo XML ("line-feed", "carriage return", "tab", caractere de "espao" entre as TAGs).

d) Validao de Schema Para garantir minimamente a integridade das informaes prestadas e a correta formao dos arquivos XML, o contribuinte dever submeter o arquivo da NF-e e as demais mensagens XML para validao pelo Schema do XML (XSD XML Schema Definition), disponibilizado pela Secretaria de Fazenda Estadual antes de seu envio.

3.2.2 Padro de Comunicao


A comunicao entre o contribuinte e a Secretaria de Fazenda Estadual ser baseada em Web Services disponibilizados nos Portais das respectivas Secretarias de Fazenda da circunscrio do contribuinte. O meio fsico de comunicao utilizado ser a Internet, com o uso do protocolo SSL, que alm de garantir um duto de comunicao seguro na Internet, permite a identificao do servidor e do cliente atravs de certificados digitais, eliminando a necessidade de identificao do usurio atravs de nome ou cdigo de usurio e senha. O modelo de comunicao segue o padro de Web Services definido pelo WS-I Basic Profile. A troca de mensagens entre os Web Services do Portal da Secretaria de Fazenda Estadual e o aplicativo do contribuinte ser realizada no padro SOAP, com troca de mensagens XML no padro Style/Enconding: Document/Literal, wrapped. A opo wrapped representa a chamada aos mtodos disponveis com a passagem de mais de um parmetro. Segue abaixo um exemplo de uma mensagem dentro do SOAP:
<?xml version="1.0" encoding="UTF-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SOAP:Body> <nfeRecepcaoLote xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NfeRecepcao"> <!----- XML rea de Cabealho -----> <nfeCabecMsg> <?xml version="1.0" encoding="UTF-8"?> <cabecMsg xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.02"> <versaoDados>1.07</versaoDados> </cabecMsg> </nfeCabecMsg> <!----- XML rea de Dados -----> <nfeDadosMsg> <?xml version="1.0" encoding="UTF-8"?> <enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.07"> <idLote>000000000000001</idLote> <NFe xmlns="http://www.portalfiscal.inf.br/nfe" <infNFe Id="NFe43060600000000000191550990000070080007055472" versao="1.07"> ...
Pg. 14 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

</NFe> </enviNFe> </nfeDadosMsg> </nfeRecepcaoLote> </SOAP:Body> </SOAP:Envelope>

3.2.3 Padro de Certificado Digital


O certificado digital utilizado no Projeto Nota Fiscal eletrnica ser emitido por Autoridade Certificadora credenciada pela Infra-estrutura de Chaves Pblicas Brasileira ICP-Brasil, tipo A1 ou A3, devendo conter o CNPJ da pessoa jurdica titular do certificado digital no campo otherName OID =2.16.76.1.3.3. Os certificados digitais sero exigidos em 2 (dois) momentos distintos para o projeto: a) Assinatura de Mensagens: O certificado digital utilizado para essa funo dever conter o CNPJ do estabelecimento emissor da NF-e ou o CNPJ do estabelecimento matriz. Por mensagens, entenda-se: o Pedido de Autorizao de Uso (Arquivo NF-e), o Pedido de Cancelamento de NF-e, o Pedido de Inutilizao de Numerao de NF-e e demais arquivos XML que necessitem de assinatura. O certificado digital dever ter o uso da chave previsto para a funo de assinatura digital, respeitando a Poltica do Certificado. b) Transmisso (durante a transmisso das mensagens entre os servidores do contribuinte e do Portal da Secretaria de Fazenda Estadual): O certificado digital utilizado para identificao do aplicativo do contribuinte dever conter o CNPJ do responsvel pela transmisso das mensagens, mas no necessita ser o mesmo CNPJ do estabelecimento emissor da NF-e, devendo ter a extenso Extended Key Usage com permisso de "Autenticao Cliente".

3.2.4 Padro de Assinatura Digital


As mensagens enviadas ao Portal da Secretaria de Fazenda Estadual so documentos eletrnicos elaborados no padro XML e devem ser assinados digitalmente com um certificado digital que contenha o CNPJ do estabelecimento matriz ou o CNPJ do estabelecimento emissor da NF-e objeto do pedido. Os elementos abaixo esto presentes dentro do Certificado do contribuinte tornando desnecessria a sua representao individualizada no arquivo XML. Portanto, o arquivo XML no deve conter os elementos: <X509SubjectName> <X509IssuerSerial> <X509IssuerName> <X509SerialNumber> <X509SKI> Deve-se evitar o uso das TAGs abaixo, pois as informaes sero obtidas a partir do Certificado do emitente: <KeyValue> <RSAKeyValue> <Modulus> <Exponent>
Pg. 15 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

O Projeto NF-e utiliza um subconjunto do padro de assinatura XML definido pelo http://www.w3.org/TR/xmldsig-core/, que tem o seguinte leiaute:

Schema XML: xmldsig-core-schema_v1.01.xsd


# Campo Ele Raiz G G A Pai XS01 XS02 XS03 Tipo Ocor. Tam. Dec. C 1-1 1-1 1-1 Grupo da Informao da assinatura Grupo do Mtodo de Canonicalizao Atributo Algorithm de CanonicalizationMethod: http://www.w3.org/TR/2001/REC-xml-c14n20010315 Grupo do Mtodo de Assinatura Atributo Algorithm de SignedInfo: http://www.w3.org/2000/09/xmldsig#rsa-sha1 Grupo do Mtodo de Reference Atributo URI da tag Reference Grupo do algorithm de Transform Regra para o atributo Algorithm do Transform ser nico. Grupo de Transform Atributos vlidos Algorithm do Transform: http://www.w3.org/TR/2001/REC-xml-c14n20010315 http://www.w3.org/2000/09/xmldsig#envelopedsignature XPath Grupo do Mtodo de DigestMethod Atributo Algorithm de DigestMethod: http://www.w3.org/2000/09/xmldsig#sha1 Digest Value (Hash SHA-1 Base64) Grupo do Signature Value Grupo do KeyInfo Grupo X509 Certificado Digital x509 em Base64 Descrio/Observao

XS01 Signature XS02 SignedInfo XS03 CanonicalizationM ethod XS04 Algorithm

XS05 SignatureMethod XS06 Algorithm XS07 Reference XS08 URI XS10 Transforms

G A G A G

XS02 XS05 XS02 XS07 XS07

C C C

1-1 1-1 1-1 1-1 1-1 1-1 2-2 1-1

XS11 unique_Transf_Alg RC XS10 XS12 Transform XS13 Algorithm G A XS10 XS12

XS14 XPath XS15 DigestMethod XS16 Algorithm XS17 DigestValue XS18 SignatureValue XS19 KeyInfo XS20 X509Data XS21 X509Certificate

E G A E G G G E

XS12 XS07 XS15 XS07 XS01 XS01 XS19 XS20

C C C C

0-N 1-1 1-1 1 1-1 1-1 1-1 1-1

A assinatura do Contribuinte na NF-e ser feita na TAG <infNFe> identificada pelo atributo Id, cujo contedo dever ser um identificador nico (chave de acesso) precedido do literal NFe para cada NF-e conforme leiaute descrito no Anexo I. O identificador nico precedido do literal #NFe dever ser informado no atributo URI da TAG <Reference>. Para as demais mensagens a serem assinadas, o processo o mesmo mantendo sempre um identificador nico para o atributo Id na TAG a ser assinada. Segue abaixo um exemplo:
<NFe xmlns="http://www.portalfiscal.inf.br/nfe" > <infNFe Id="NFe31060243816719000108550000000010001234567897" versao="1.01"> ... </infNFe> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#NFe31060243816719000108550000000010001234567897"> <Transforms> <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/> <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> </Transforms> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> Pg. 16 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

<DigestValue>vFL68WETQ+mvj1aJAMDx+oVi928=</DigestValue> </Reference> </SignedInfo> <SignatureValue>IhXNhbdL1F9UGb2ydVc5v/gTB/y6r0KIFaf5evUi1i ...</SignatureValue> <KeyInfo> <X509Data> <X509Certificate>MIIFazCCBFOgAwIBAgIQaHEfNaxSeOEvZGlVDANB ... </X509Certificate> </X509Data> </KeyInfo> </Signature> </NFe>

Para o processo de assinatura, o contribuinte no deve fornecer a Lista de Certificados Revogados, j que a mesma ser montada e validada por cada Portal da Secretaria de Fazenda Estadual no momento da conferncia da assinatura digital. A assinatura digital do documento eletrnico dever atender aos seguintes padres adotados: a) Padro de assinatura: XML Digital Signature, utilizando o formato Enveloped (http://www.w3.org/TR/xmldsig-core/); b) Certificado digital: Emitido por AC credenciada no ICP-Brasil (http://www.w3.org/2000/09/xmldsig#X509Data); c) Cadeia de Certificao: EndCertOnly (Incluir na assinatura apenas o certificado do usurio final); d) Tipo do certificado: A1 ou A3 (o uso de HSM recomendado); e) Tamanho da Chave Criptogrfica: Compatvel com os certificados A1 e A3 (1024 bits); f) Funo criptogrfica assimtrica: RSA (http://www.w3.org/2000/09/xmldsig#rsasha1); g) Funo de message digest: SHA-1 (http://www.w3.org/2000/09/xmldsig#sha1); h) Codificao: Base64 (http://www.w3.org/2000/09/xmldsig#base64); i) Transformaes exigidas: til para realizar a canonicalizao do XML enviado para realizar a validao correta da Assinatura Digital. So elas: (1) Enveloped (http://www.w3.org/2000/09/xmldsig#enveloped-signature) (2) C14N (http://www.w3.org/TR/2001/REC-xml-c14n-20010315)

3.2.5 Validao de Assinatura Digital pela Secretaria de Fazenda Estadual


Para a validao da assinatura digital, seguem as regras que sero adotadas pelas Secretarias de Fazenda Estaduais: (1) Extrair a chave pblica do certificado; (2) Verificar o prazo de validade do certificado utilizado; (3) Montar e validar a cadeia de confiana dos certificados validando tambm a LCR (Lista de Certificados Revogados) de cada certificado da cadeia; (4) Validar o uso da chave utilizada (Assinatura Digital) de tal forma a aceitar certificados somente do tipo A (no sero aceitos certificados do tipo S); (5) Garantir que o certificado utilizado de um usurio final e no de uma Autoridade Certificadora; (6) Adotar as regras definidas pelo RFC 3280 para LCRs e cadeia de confiana; (7) Validar a integridade de todas as LCR utilizadas pelo sistema; (8) Prazo de validade de cada LCR utilizada (verificar data inicial e final).

Pg. 17 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A forma de conferncia da LCR fica a critrio de cada Secretaria de Fazenda Estadual, podendo ser feita de 2 (duas) maneiras: On-line ou Download peridico. As assinaturas digitais das mensagens sero verificadas considerando a lista de certificados revogados disponvel no momento da conferncia da assinatura.

3.2.6 Resumo dos Padres Tcnicos


A tabela a seguir resume os principais padres de tecnologia utilizados:
Caracterstica Web Services Descrio

Meio lgico de comunicao Meio fsico de comunicao Protocolo Internet Padro de troca de mensagens Padro da mensagem Padro de certificado digital

Padro definido pelo WS-I Basic Profile 1.1 (http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-0824.html). Web Services, disponibilizados pelo Portal da Secretaria de Fazenda Estadual. Internet SSL verso 3.0, com autenticao mtua atravs de certificados digitais. SOAP verso 1.2. XML no padro Style/Encoding: Document/Literal, wrapped. X.509 verso 3, emitido por Autoridade Certificadora credenciada pela Infra-estrutura de Chaves Pblicas Brasileira ICP-Brasil, do tipo A1 ou A3, devendo conter o CNPJ do proprietrio do certificado digital. Para assinatura de mensagens, utilizar o certificado digital do estabelecimento matriz ou do estabelecimento emissor da NF-e. Para transmisso, utilizar o certificado digital do responsvel pela transmisso. XML Digital Signature, Enveloped, com certificado digital X.509 verso 3, com chave privada de 1024 bits, com padres de criptografia assimtrica RSA, algoritmo message digest SHA-1 e utilizao das transformaes Enveloped e C14N. Ser validada alm da integridade e autoria, a cadeia de confiana com a validao das LCRs. Campos no obrigatrios do Schema que no possuam contedo tero suas tags suprimidas no arquivo XML. Mscara de nmeros decimais e datas esto definidas no Schema XML. Nos campos numricos inteiro, no incluir a vrgula ou ponto decimal. Nos campos numricos com casas decimais, utilizar o ponto decimal na separao da parte inteira.

Padro de assinatura digital

Validao de assinatura digital Padres de preenchimento XML

Pg. 18 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

3.3

Modelo operacional

A forma de processamento das solicitaes de servios no projeto Nota Fiscal Eletrnica pode ser sncrona, caso o atendimento da solicitao de servio seja realizada na mesma conexo, ou assncrona, quando o processamento do servio solicitado no atendido na mesma conexo, nesta situao torna-se necessria a realizao de mais uma conexo para a obteno do resultado do processamento. As solicitaes de servios que exigem processamento intenso sero executadas de forma assncrona e as demais solicitaes de servios de forma sncrona. Assim, os servios da NF-e sero implementados da seguinte forma: Servio Recepo de NF-e Cancelamento de NF-e Inutilizao de Numerao de NF-e Consulta da situao atual da NF-e Consulta do status do servio Implementao Assncrona Sncrona Sncrona Sncrona Sncrona

3.3.1 Servios sncronos


As solicitaes de servios de implementao sncrona so processadas imediatamente e o resultado do processamento obtido em uma nica conexo. Abaixo, o fluxo simplificado de funcionamento:
Servio de Implementao sncrona Contribuinte
(1) Solicitao de servio

Secretaria de Fazenda Estadual


(2) Solicitao de servio

Aplicativo Cliente

Web Service
(4) Resultado (3) Resultado

Processamento de Servios

Etapas do processo ideal: (1) O aplicativo do contribuinte inicia a conexo enviando uma mensagem de solicitao de servio para o Web Service; (2) O Web Service recebe a mensagem de solicitao de servio e encaminha ao aplicativo da NF-e que ir processar o servio solicitado; (3) O aplicativo da NF-e recebe a mensagem de solicitao de servio e realiza o processamento, devolvendo uma mensagem de resultado do processamento ao Web Service; (4) O Web Service recebe a mensagem de resultado do processamento e o encaminha ao aplicativo do contribuinte; (5) O aplicativo do contribuinte recebe a mensagem de resultado do processamento e, caso no exista outra mensagem, encerra a conexo.

3.3.2 Servios assncronos


Pg. 19 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

As solicitaes de servios de implementao assncrona so processadas de forma distribuda por vrios processos e o resultado do processamento somente obtido na segunda conexo. Abaixo, o fluxo simplificado de funcionamento:

Servio de Implementao assncrona Contribuinte


Envio de Solicitao de Servios
(4) (5) (1) Solicitao de servio (3) Recibo

Secretaria de Fazenda Estadual


Web Service Recebe Solicitao de Servios (2) Solicitao de servio Fila de servios solicitados

Fila de recibos

Processamento de Servios

(7)

(6)

Consulta Recibo

(8) Consulta recibo


(10) Resultado processamento

Web Service
(9) Resultado processamento

Consulta recibo

Fila de servios processados

Etapas do processo ideal: (1) (2) (3) (4) O aplicativo do contribuinte inicia a conexo enviando uma mensagem de solicitao de servio para o Web Service de recepo de solicitao de servios; O Web Service de recepo de solicitao de servios recebe a mensagem de solicitao de servio e a coloca na fila de servios solicitados, acrescentando o CNPJ do transmissor obtido do certificado digital do transmissor; O Web Service de recepo de solicitao de servio retorna o recibo da solicitao de servio e a data e hora de recebimento da mensagem no Web Service; O aplicativo do contribuinte recebe o recibo e o coloca na fila de recibos de servios solicitados e ainda no processados e, caso no exista outra mensagem, encerra a conexo; Na Secretaria de Fazenda Estadual a solicitao de servios retirada da fila de servios solicitados pelo aplicativo da NF-e; O servio solicitado processado pelo aplicativo da NF-e e o resultado do processamento colocado na fila de servios processados; O aplicativo do contribuinte retira um recibo da fila de recibos de servios solicitados; O aplicativo do contribuinte envia uma consulta de recibo, iniciando uma conexo com o Web Service Consulta Recibo (NFeRetRecepcao); O Web Service Consulta Recibo recebe a mensagem de consulta recibo e localiza o resultado de processamento da solicitao de servio;
Pg. 20 / 145

(5) (6) (7) (8) (9)

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

(10) O Web Service Consulta Recibo (NFeRetRecepcao) devolve o resultado do processamento ao aplicativo contribuinte; (11) O aplicativo do contribuinte recebe a mensagem de resultado do processamento e, caso no exista outra mensagem, encerra a conexo.

3.3.3 Filas e Mensagens


As filas de mensagens de solicitao de servios so necessrias para a implementao do processamento assncrono das solicitaes de servios. As mensagens de solicitaes de servios no processamento assncrono so armazenadas em uma fila de entrada. Para ilustrar como as filas armazenam as informaes, observe o diagrama a seguir:

Estrutura de um item da fila:

CNPJ do Transmissor

Nmero do Recibo

data e hora recebimento

XML de Cabealho

XML de Dados

rea de controle

rea de mensagem

A estrutura de um item composta pela rea de controle (identificador) e pela rea de detalhe. As seguintes informaes so adotadas como atributos de controle: CNPJ do transmissor: CNPJ da empresa que enviou a mensagem que no necessita estar vinculado ao CNPJ do estabelecimento emissor da NF-e. Somente o transmissor da mensagem ter acesso ao resultado do processamento das mensagens de solicitao de servios; Recibo de entrega: Nmero seqencial nico atribudo para a mensagem pela Secretaria de Fazenda Estadual. Este atributo identifica a mensagem de solicitao de servios na fila de mensagem; Data e hora de recebimento da mensagem: Data e hora local do instante de recebimento da mensagem atribuda pela Secretaria de Fazenda Estadual. Este atributo importante como parmetro de desempenho do sistema, eliminao de mensagens, adoo do regime de contingncia, etc. O tempo mdio de resposta calculado com base neste atributo.

A rea de mensagem contm uma rea de cabealho e a rea de dados em formato XML. Para processar as mensagens de solicitaes de servios, a aplicao da NF-e ir retirar a mensagem da fila de entrada de acordo com a ordem de chegada, devendo armazenar o resultado do processamento da solicitao de servio em uma fila de sada. A fila de sada ter a mesma estrutura da fila de entrada, a nica diferena ser no contedo do detalhe da mensagem que contm o resultado do processamento da solicitao de servio em formato XML. O tempo mdio de resposta que mede a performance do servio de processamento dos lotes calculado com base no tempo decorrido entre o momento de recebimento da
Pg. 21 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

mensagem e o momento de armazenamento do resultado do processamento da solicitao de servio na fila de sada.


Nota: O termo fila utilizado apenas para designar um repositrio de recibos emitidos. A implementao da fila poder ser feita atravs de Banco de Dados ou qualquer outra forma, sendo transparente ao contribuinte que realizar a consulta do processamento efetuado (processos assncronos).

3.4

Padro de mensagens dos Web Services

As chamadas dos Web Services disponibilizados pelas Secretarias de Fazenda Estaduais ou Secretaria da Receita Federal e os respectivos resultados do processamento so realizadas atravs das mensagens com o seguinte padro:

Padro de Mensagem de chamada/retorno de Web Service


Estrutura XML de cabealho Estrutura XML definida na documentao do Web Service

rea de cabealho

rea de dados

rea de Cabealho estrutura XML padro para todas as mensagens de chamada e retorno de resultado dos Web Services disponibilizados pelas Secretarias de Fazenda Estaduais ou Secretaria da Receita Federal, que contm os dados de controle da mensagem. A rea de cabealho est sendo utilizada para armazenar a verso do leiaute da estrutura XML informado na rea de dados. rea de Dados estrutura XML varivel definida na documentao do Web Service acessado.

3.4.1 rea de Cabealho


Abaixo, o leiaute da rea de Cabealho padro:

Schema XML: cabecMsg_v1.02.xsd


rea de Cabealho
# Campo Descrio Ele Pai Tipo Ocor. Tam. Dec. Observao

cabMsg

versao
# Campo

TAG raiz do cabealho da mensagem Verso do leiaute


Descrio

1-1

TAG raiz do cabealho da mensagem 1-4


Tam.

A
Ele

Pai

N
Tipo

1-1
Ocor.

2
Dec.

Verso do leiaute (1.02)


Observao

A01

versaoDados

Verso do leiaute dos Dados

raiz

1-1

1-4

O contedo deste campo indica a verso do leiaute XML da estrutura XML informada na rea de dados da mensagem.

O campo versaoDados deve conter a informao da verso do leiaute da estrutura XML armazenada na rea de dados da mensagem. A estrutura XML armazenada na rea de dados est definida na documentao do Web Service acessado. Exemplo da rea de cabealho:
Pg. 22 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

<?xml version="1.0" encoding="UTF-8" ?> <cabecMsg xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.02"> <versaoDados>1.07</versaoDados> </cabecMsg>

3.4.2 Validao da estrutura XML das Mensagens dos Web Services


As informaes so enviadas ou recebidas dos Web Services atravs de mensagens no padro XML definido na documentao de cada Web Service. As alteraes de leiaute e da estrutura de dados XML realizadas nas mensagens so controladas atravs da atribuio de um nmero de verso para a mensagem. Um Schema XML uma linguagem que define o contedo do documento XML, descrevendo os seus elementos e a sua organizao, alm de estabelecer regras de preenchimento de contedo e de obrigatoriedade de cada elemento ou grupo de informao. A validao da estrutura XML da mensagem realizada por um analisador sinttico (parser) que verifica se a mensagem atende as definies e regras de seu Schema XML. Qualquer divergncia da estrutura XML da mensagem em relao ao seu Schema XML, provoca um erro de validao do Schema XML. A primeira condio para que a mensagem seja validada com sucesso que ela seja submetida ao Schema XML correto. Assim, os aplicativos do contribuinte devem estar preparados para gerar as mensagens no leiaute em vigor, devendo ainda informar a verso do leiaute da estrutura XML da mensagem no campo versaoDados da rea de cabealho da mensagem.

3.4.3 Schemas XML das Mensagens dos Web Services


Toda mudana de leiaute das mensagens dos Web Sevices implica na atualizao do seu respectivo Schema XML. A identificao da verso dos Schemas ser realizada com o acrscimo do nmero da verso no nome do arquivo precedida da literal _v, como segue: envNFe_v1.03.xsd (Schema XML de Envio de NFe, verso 1.03); retCancNFe_v1.10.xsd (Schema XML do Retorno de Cancelamento de NFe, verso 1.10); leiauteNFe_v10.15.xsd (Schema XML dos tipos bsicos da NFe, verso 10.15). A maioria dos Schemas XML da NF-e utilizam as definies de tipos bsicos ou tipos complexos que esto definidos em outros Schemas XML (ex.: tiposBasico_v1.00.xsd, etc.), nestes casos, a modificao de verso do Schema bsico ser repercutida no Schema principal. Por exemplo, o tipo numrico de 15 posies com 2 decimais definido no Schema tiposBasico_v1.00.xsd, caso ocorra alguma modificao na definio deste tipo, todos os Schemas que utilizam este tipo bsico devem ter a sua verso atualizada e as declaraes import ou include devem ser atualizadas com o nome do Schema bsico atualizado. Exemplo de Schema XML
Pg. 23 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.portalfiscal.inf.br/nfe" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:import namespace="http://www.w3.org/2000/09/xmldsig#" schemaLocation="xmldsig-coreschema_v1.01.xsd"/> <xs:include schemaLocation="tiposBasico_v1.00.xsd"/> <xs:element name="NFe"> <xs:annotation> <xs:documentation>Nota Fiscal Eletrnica</xs:documentation> </xs:annotation>

As modificaes de leiaute das mensagens dos Web Services podem ser causadas por necessidades tcnicas ou em razo da modificao de alguma legislao. As modificaes decorrentes de alterao da legislao devero ser implementadas nos prazos previstos no ato normativo que introduziu a alterao. As modificaes de ordem tcnica sero divulgadas pela Coordenao Tcnica do ENCAT e podero ocorrer sempre que se fizerem necessrias.

3.5

Verso dos Schemas

3.5.1 Liberao das verses dos Schemas para o Projeto da NF Eletrnica


Os schemas vlidos para o Projeto da Nota Fiscal Eletrnica sero disponibilizados no sitio nacional do Projeto (www.nfe.fazenda.gov.br), e sero liberados aps autorizao da equipe de Gesto do Projeto formada pelos Lderes dos Projetos nos Estados e representante das Empresas. A cada nova liberao ser disponibilizado um arquivo compactado contendo o conjunto de schemas a serem utilizados pelas empresas para a gerao dos arquivos XML. Este arquivo ser denominado Pacote de Liberao e ser numerado seqencialmente. Os pacotes de liberao sero identificados pelas letras PL, seguida do nmero do pacote. Exemplificando: O pacote PL_001.zip representa o Pacote de Liberao n 1 de schemas da Nota Fiscal Eletrnica. Os schemas vlidos esto contidos no pacote de liberao e so identificados pelo seu nome, seguido da verso do respectivo schema. Assim, para o schema de Envio de Lotes de Nota Fiscal Eletrnica, corresponder um arquivo com a extenso .XSD, que ter o nome de enviNFe_v9.99.xsd, onde v9.99, corresponde a verso do respectivo schema. Para identificar quais os schemas que sofreram alterao em um determinado pacote liberado, deve-se comparar o nmero da verso do schema deste pacote com o do pacote anterior. Exemplificando: PACOTE DATA LIBERAO SCHEMAS PL_001.ZIP 01/04/2006 enviNFe_v1.00.xsd inutNFe_v1.00.xsd cancNFe_v1.00.xsd tiposNFe_v1.00.xsd PL_002.ZIP 01/06/2006 enviNFe_v1.30.xsd inutNFe_v1.00.xsd cancNFe_v1.00.xsd tiposNFe_v1.01.xsd
Pg. 24 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Para as atualizaes de verses que decorrem de correo de regra de validao, modificao da obrigatoriedade de campo, etc., que no modificam a estrutura do Schema atravs da incluso ou excluso de campos, sero liberados novos pacotes de liberao sem a atualizao do nmero do pacote. Nestas situaes os pacotes mais recentes sero identificados com o acrscimo de letras minscula do alfabeto, como por exemplo: PL_002a.ZIP, indicando que se trata da primeira verso corrigida do PL_002.ZIP

3.5.2 Controle de Verso


O controle de verso de cada um dos schemas vlidos para o Projeto Nota Fiscal Eletrnica compreende uma definio nacional sobre: qual a verso vigente (verso mais atualizada); quais so as verses anteriores ainda suportadas por todas as SEFAZ. Este controle de verses permite a adaptao dos sistemas de informtica das empresas participantes do Projeto em diferentes datas. Ou seja, algumas empresas podero estar com uma verso de leiaute mais atualizada, enquanto outras empresas podero ainda estar operando com mensagens em um leiaute anterior. No esto previstas mudanas freqentes de leiaute de mensagens e as empresas devero ter um prazo razovel para implementar as mudanas necessrias, conforme acordo operacional a ser estabelecido. Mensagens recebidas com uma verso de leiaute no suportada sero rejeitadas com uma mensagem de erro especfica na verso do leiaute de resposta mais antiga em uso.

Pg. 25 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4. Web Services
Os Web Services disponibilizam os servios que sero utilizados pelos aplicativos dos contribuintes. O mecanismo de utilizao dos Web Services segue as seguintes premissas: a) Ser disponibilizado um Web Service por servio, existindo um mtodo para cada tipo de servio; b) Para os servios assncronos, o mtodo de envio retorna uma mensagem de confirmao de recebimento da solicitao de servio com o recibo e a data e hora local de recebimento da solicitao ou retorna uma mensagem de erro. As Secretarias de Fazenda Estaduais se comprometem a processar os lotes de notas fiscais recebidas em at 3 minutos em no mnimo 95% do total do volume recebido no perodo de 24 horas. Este indicador de performance ser constantemente avaliado e aperfeioado pelo Comit Gestor e os contribuintes emissores de NF-e. A qualquer momento as empresas podero verificar a performance do servio de processamento dos lotes, verificando o tempo mdio de resposta do servio nos ltimos 5 minutos. No recibo de recepo do lote, tambm ser informado o tempo mdio de resposta do servio nos ltimos 5 minutos. Cada Portal de Secretaria de Fazenda Estadual disponibilizar o resultado do processamento do lote por um perodo mnimo de 24 horas (nfeRetRecepcao). Aps o trmino do processamento, a informao da situao atual de cada nota ser disponibilizada para consulta individual (nfeConsultaNF). c) Para os servios sncronos, o envio da solicitao e a obteno do retorno sero realizados na mesma conexo atravs de um nico mtodo. d) As URLs dos Web Services encontram-se no Anexo VI deste manual. Acessando a URL pode ser obtido o WSDL (Web Services Description Language) de cada Web Service. e) O processo de utilizao dos Web Services sempre iniciado pelo contribuinte enviando uma mensagem nos padres XML e SOAP, atravs do protocolo SSL com autenticao mtua. f) A ocorrncia de qualquer erro na validao dos dados recebidos interrompe o processo com a disponibilizao de uma mensagem contendo o cdigo e a descrio do erro.

Pg. 26 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.1

Web Service NfeRecepcao

Transmisso de Lote de NF-e


Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeRecepcao Envio do lote de NF-e Client NFe Recibo nfeRecepcaoLote msgs Filas de Entrada. Proc. Processamento Aplicao NF-e

Funo: servio destinado recepo de mensagens de lote de NF-e. Processo: assncrono. Mtodo: nfeRecepcaoLote

4.1.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML com as notas fiscais enviadas. Schema XML: envNFe_v99.99.xsd
# Campo Ele Raiz A E Pai AP01 AP01 Tipo Ocor. Tam. Dec. N N 1-1 1-1 1-4 1-15 2 TAG raiz Verso do leiaute Identificador de controle do envio do lote. Nmero seqencial auto-incremental, de controle correspondente ao identificador nico do lote enviado. A responsabilidade de gerar e controlar esse nmero exclusiva do contribuinte. Conjunto de NF-e transmitidas (mximo de 50 NF-e), seguindo definio do Anexo I - Leiaute da NF-e. Descrio/Observao

AP01 enviNFe AP02 versao AP03 idLote

AP04 NFe

AP01

xml

1-50

4.1.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML com a mensagem do resultado da transmisso. Schema XML: retEnvNFe_v99.99.xsd
# Campo Ele Raiz A E Pai AR01 AR01 Tipo Ocor. Tam. Dec. N N 1-1 1-1 1-4 1 2 Descrio/Observao TAG raiz da Resposta Verso do leiaute Identificao do Ambiente:
Pg. 27 / 145

AR01 retEnviNFe AR02 versao AR03 tpAmb

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

1 Produo / 2 - Homologao AR04 verAplic AR05 cStat AR06 xMotivo AR06a cUF AR07 infRec AR08 nRec E E E E G E AR01 AR01 AR01 AR01 AR01 AR07 C N C N N 1-1 1-1 1-1 1-1 0-1 1-1 1-20 3 1-255 2 15 Verso do Aplicativo que recebeu o Lote. Cdigo do status da resposta (vide item 5.1.1) Descrio literal do status da resposta Cdigo da UF que atendeu a solicitao. Dados do Recibo do Lote (S gerado se o Lote for aceito) Nmero do Recibo gerado pelo Portal da Secretaria de Fazenda Estadual, composto por: duas posies com Cdigo da UF onde foi entregue o lote, codificao de UF do IBGE, e treze posies numricas seqenciais. (vide item 5.5) Data e Hora do Recebimento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora do recebimento do lote. 1-4 Tempo mdio de resposta do servio (em segundos) dos ltimos 5 minutos (vide item 5.7). Nota: Caso o tempo mdio de resposta fique abaixo de 1 (um) segundo, o tempo ser informado como 1 segundo. Arredondar as fraes de segundos para cima.

AR09 dhRecbto

AR07

1-1

AR10 tMed

AR07

1-1

As mensagens recebidas com erro geram uma mensagem de erro. Nas demais hipteses ser retornado um recibo com nmero, data, hora local de recebimento e tempo mdio de resposta do servio nos ltimos 5 minutos. O nmero do recibo gerado pelo Portal da Secretaria de Fazenda Estadual ser a chave de acesso do servio de consulta ao resultado do processamento do lote.

4.1.3 Descrio do Processo de Recepo de Lotes de NF-e


Este mtodo ser responsvel por receber as mensagens de envio de lotes de NF-e e coloc-las na fila de entrada. Devero ser realizadas as validaes e procedimentos que seguem.

4.1.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado

Obrig. Obrig.

281 283

Rej. Rej.

Pg. 28 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-Brasil no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.1.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Msg 214 243 108 109 Efeito Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado

B03 Verifica se o Servidor de Processamento est Paralisado Obrig. Momentaneamente B04 Verifica se o Servidor de Processamento est Paralisado sem Obrig. Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.1.6 Gerao da Resposta com o Recibo


No existindo qualquer problema nas validaes acima referidas, o aplicativo dever gerar um nmero de recibo composto por: duas posies com Cdigo da UF onde foi entregue o lote (codificao de UF do IBGE) e treze posies numricas seqenciais e gravar a mensagem, juntamente com o nmero do recibo e o CNPJ do transmissor.
Pg. 29 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Aps a gravao da mensagem na fila de entrada ser retornada uma mensagem de confirmao de recebimento para o transmissor, com as seguintes informaes: a identificao do ambiente; a verso do aplicativo; o cdigo 103 e o literal Lote recebido com Sucesso; o cdigo da UF que atendeu a solicitao; o nmero do recibo (vide item 5.5), com data, hora local de recebimento da mensagem; tempo mdio de resposta do servio de processamento dos lotes nos ltimos 5 minutos (vide detalhamento da forma de clculo no item 5.7).

Caso ocorra algum problema de validao, o aplicativo dever retornar uma mensagem com as seguintes informaes: a identificao do ambiente; a verso do aplicativo; o cdigo e a respectiva mensagem de erro (vide a tabela do item 5.1.1);

4.1.7 Descrio do Processamento do Lote de NF-e


O processamento de Lote de NF-e recepcionada realizada pelo Servidor de Processamento de NF-e que consome as mensagens armazenadas na fila de entrada pelo mtodo NfeRecepcao e
faz a validao de forma e das regras de negcios e armazena o resultado do processamento na fila de sada.

4.1.8 Validao da rea de cabealho da mensagem


Validao da rea do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que deve ser utilizado pelo Servidor de Processamento da NF-e na validao do Schema XML do lote. Cabe ressaltar que um lote deve conter somente NF-e da mesma verso.

4.1.9 Validao da rea de Dados


a) Validao de forma da rea de dados A validao de forma da rea de dados da mensagem realizada com a aplicao da seguinte regra:

Pg. 30 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Validao da rea de dados da mensagem # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 225 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

Como a validao do Schema XML realizada em toda mensagem de entrada, a existncia de um erro em uma NF-e implica na rejeio de todo o lote. b) Validao do Certificado Digital de Assinatura A seguir so extradas todas NF-e das mensagens de envio de lote e validadas as seguintes regras de negcios para cada NF-e:
Validao do Certificado Digital utilizado na Assinatura Digital da NF-e # Regra de Validao Aplic. Obrig. Msg 290 Efeito Rej. E01 Certificado de Assinatura invlido: - Certificado de Assinatura inexistente na mensagem (*validado tambm pelo Schema) - Verso difere "3" - Basic Constraints = true (no pode ser Certificado de AC) - KeyUsage no define "Assinatura Digital" e No Recusa E02 Validade do Certificado (data incio e data fim) E03 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3) E04 Verifica Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado E05 LCR do Certificado de Assinatura: - Falta o endereo da LCR (CRLDistributionPoint) - Erro no acesso a LCR ou LCR inexistente E06 Certificado de Assinatura revogado E07 Certificado Raiz difere da ICP-Brasil

Obrig. Obrig. Obrig.

291 292 293

Rej. Rej. Rej.

Obrig.

296

Rej.

Obrig. Obrig.

294 295

Rej. Rej.

c) Validao da Assinatura Digital

Validao da Assinatura Digital da NF-e # Regra de Validao Aplic. Msg 298 Efeito Rej. F01 Assinatura difere do padro do Projeto: Obrig. - No assinado o atributo "ID" (falta "Reference URI" na assinatura) (*validado tambm pelo Schema) - Faltam os "Transform Algorithm" previstos na assinatura ("C14N" e "Enveloped") Estas validaes so implementadas pelo Schema XML da Signature F02 Valor da assinatura (SignatureValue) difere do valor calculado Obrig. F03 CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital F04 CNPJ do Certificado Digital difere do CNPJ da Matriz e do CNPJ do Obrig. Facult.

297 213 244

Rej. Rej. Rej.

Pg. 31 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Emitente

d) Validao de regras de negcios da NF-e

Validao da NF-e Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Msg 252 226 247 266 Efeito Rej. Rej. Rej. Rej. G01 Tipo do ambiente da NF-e difere do ambiente do Web Service G02 Cdigo da UF do Emitente difere da UF do Web Service G03 Sigla da UF do Emitente difere da UF do Web Service
G03a Srie utilizada no permitida no Web Service (faixa de 0-899 -

G03b

G04

G05
G05a

emisso normal na UF e faixa de 900-999 - reservado para emisso em contigncia na RFB) Grupo de informao avulsa no deve ser informado para processo de emisso da NF-e (procEmi) = 0 - aplicativo do contribuinte. Campo ID invlido - Falta literal "NFe" - Chave de Acesso do campo ID difere da concatenao dos campos correspondentes Dgito Verificador invlido da Chave de acesso resultante da concatenao dos campos correspondentes Validar DV do cdigo do municpio do Fato Gerador

Obrig. Obrig.

403 227

Rej. Rej.

Obrig. Obrig.

253 270 271 207 407 401 272 273 229 209

Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej.

G05b Verificar se as 2 primeiras posies do cdigo do municpio do Fato Obrig.

Gerador informado correspondem ao cdigo da UF G06 CNPJ informado para o Emitente invlido (dgito controle, zeros ou nulo) G06a CPF s pode ser informado no campo Emitente para NF-e avulsa invlido (dgito controle, zeros ou nulo) G06c Validar DV do cdigo do municpio do Emitente Emitente informado correspondem ao cdigo da UF IE Emitente no informada (zeros ou nulo) para emisso prpria (NF-e avulsa) IE Emitente invlida (erro no dgito de controle, o tamanho da IE deve ser normalizado, na aplicao da SEFAZ, com acrscimo de zeros no significativos se necessrio antes da verificao do dgito de controle) Se Cdigo de Pas do Emitente informado: - Validar DV do Cdigo do Pas do Emitente CNPJ Destinatrio informado: CNPJ invlido (dgito de controle, zeros) CPF Destinatrio informado: CPF invlido (dgito de controle, zeros)

Obrig. Obrig.

G06b CPF informado no campo Emitente como Remetente de NF-e avulsa Obrig.

Obrig.

G06d Verificar se as 2 primeiras posies do cdigo do municpio do Obrig.

G07 G08

Obrig. Obrig.

G08a

Obrig. Obrig. Obrig. Obrig.

405 208 237 274 275 210

Rej. Rej. Rej. Rej. Rej. Rej.

G09 G10

G10a Validar DV do cdigo do municpio do Destinatrio

G10b Verificar se as 2 primeiras posies do cdigo do municpio do Obrig.

Destinatrio informado correspondem ao cdigo da UF G11 IE Destinatrio informada: IE invlida (contedo diferente de Obrig. "ISENTO" ou erro no dgito de controle da IE informada. O tamanho da IE deve ser normalizado, na aplicao da SEFAZ, com acrscimo de zeros no significativos se necessrio antes da verificao do dgito de controle.)

Pg. 32 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

G11a Se Cdigo de Pas do Destinatrio informado:

Obrig. Obrig. Obrig.

406 212 228 478

Rej. Rej. Rej. Rej.

- Validar DV do Cdigo do Pas do Destinatrio G12 Data de Emisso posterior a data de recebimento G13 Data de Emisso ocorrida h mais de 60 dias, ou outro limite conforme critrio definido pela SEFAZ
G13a Faturamento direto:

Se informado o tpOP (campo J02 do grupo VeicProd J01) = 2 - Obrig. Verificar se foi informado a UF (campo G09 do grupo entrega G01) necessria na validao da IE ST, nos casos de operao de faturamento direto de veculos automotores novos para consumidor (Convnio ICMS 51/00). G14 IE ST informada: verificar o DV da IE do Substituto Tributrio Obrig. informada. UF a ser utilizada na validao: UF do Local de Entrega (UF G09 do grupo entrega G01) caso o campo Tipo da operao (tpOP J02 do grupo VeicProd J01) tenha sido informado com 2 - Faturamento direto; UF do destinatrio (UF E12 do grupo enderDest E05) nos demais casos.

211

Rej.

A aplicao deve normalizar a IE ST informada pelo emissor, acrescentando zeros esquerda para atingir o tamanho padro da IE da UF de destino se necessrio. G15 Inscr. SUFRAMA informada: verificar dgito controle G16 Inscr. SUFRAMA informada: verificar UF destinatrio = AC-Acre, ou AM-Amazonas, ou RO-Rondnia, ou RR-Roraima, ou AP-Amap (s para municpios 1600303-Macap e 1600600-Santana) G17 Acessar Cadastro Contribuinte p/ Emitente: - CNPJ emitente no cadastrado G18 - Emitente no autorizado G19 - IE Emitente no cadastrada G20 - IE Emitente no vinculada ao CNPJ G21 - Emitente em situao irregular perante o Fisco G22 Se operao no Estado e informado IE Destinatrio: - Acessar Cadastro Contribuinte p/ Destinatrio: . Se CNPJ Destinatrio informado: CNPJ no cadastrado G23 G24 G25 . IE Destinatrio informada: IE no cadastrada . IE e CNPJ Destinatrio informados: IE no vinculada ao CNPJ . CNPJ ou IE Destinatrio informada: Destinatrio em situao irregular perante o Fisco

Obrig. Obrig.

235 251

Rej. Rej.

Facult. Obrig. Facult. Obrig. Obrig. Facult.

245 203 230 231 301 246

Rej. Rej. Rej. Rej. Den. Rej.

Facult. Facult. Facult.

233 234 302 276 277

Rej. Rej. Den. Rej. Rej.

G25a Se Local de Retirada informado:

Obrig. - Validar DV do Cdigo do Municpio do Local de Retirada G25b Se Local de Retirada informado: Obrig. - verificar se as 2 primeiras posies do cdigo do municpio do Local de Retirada informado correspondem ao cdigo da UF G25c Se Local de Entrega informado: Obrig. - Validar DV do Cdigo Municpio do Local de Entrega G25d Se Local de Entrega informado: Obrig.

278 279

Rej. Rej.
Pg. 33 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

- verificar se as 2 primeiras posies do cdigo do municpio do Local de Entrega informado correspondem ao cdigo da UF G25e Se Cdigo Municpio do FG - ISSQN informado: Obrig. - Validar DV do Cdigo do Municpio do FG - ISSQN G25f Se Cdigo Municpio do FG - Transporte informado: Obrig. - Validar DV do Cdigo do Municpio do FG - Transporte G26 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. - NF-e j cadastrada e no Cancelada/Denegada G27 - Verificar se NF-e j est Cancelada G28 - Verificar se NF-e j est Denegada G29 Acesso BD NFE-Inutilizao - Verificar Nmero da NF-e Inutilizado G30 Se finalidade da NF-e = 2 (NF-e complementar): verificar se foi informado uma NF referenciada G31 Se finalidade da NF-e = 2 (NF-e complementar): verificar se foi informado mais de uma NF-e referenciada (NF normal ou NF-e) G32 Se finalidade da NF-e = 2 (NF-e complementar) e Se foi informado uma NF-e referenciada (TAG refNFe): - Acessar BD NFE com a Chave de Acesso informada na TAG; Rejeitar se NFE Referenciada no existir G33 Se finalidade da NF-e = 2 (NF-e complementar) e Se foi informado uma NF-e referenciada (TAG refNFe): - Acessar BD NFE com a Chave de Acesso informada na TAG; - Rejeitar se NFE Referenciada acessada for uma outra NF-e Complementar G34 Se finalidade da NF-e = 2 (NF-e complementar): - Verificar se o CNPJ emitente da NF Referenciada (vlido se a NF referenciada for uma NF eletrnica ou no) diferente do CNPJ do emitente desta NF-e Obrig. Obrig. Obrig. Obrig. Obrig. Facult.

287 288 204 218 205 206 254 255 267

Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej.

Facult.

268

Rej.

Obrig.

269

Rej.

4.1.10 Final do Processamento do Lote


A validao da NF-e poder resultar em: Rejeio a NF-e ser descartada, no sendo armazenada no Banco de Dados podendo ser corrigida e novamente transmitida; Autorizao de uso a NF-e ser armazenada no Banco de Dados; Denegao de uso a NF-e ser armazenada no Banco de Dados com esse status nos casos de irregularidade fiscal do emitente ou do destinatrio. Cabe ressaltar que a validao da situao fiscal do destinatrio facultativa e deve aguardar um prazo para a sua implementao.

Ou seja: Validao NF-e Invlida Vlida Emitente Irrelevante Irregular Destinatrio (a critrio da UF) Irrelevante Irrelevante Conseqncia Situao da Para o NF-e contribuinte Rejeio Corrigir NF-e A operao Denegao no poder de uso ser realizada

Banco de Dados No gravar Gravar


Pg. 34 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Vlida Vlida

Regular Regular

Irregular Regular

Denegao de uso Autorizao de uso

A operao no poder ser realizada A operao autorizada

Gravar Gravar

Para cada NF-e autorizada ou denegada ser atribudo um nmero de protocolo da Secretaria de Fazenda (vide regra de formao no item 5.6). O resultado do processamento do lote ser disponibilizado na fila de sada e conter o resultado da validao de cada NF-e contida no lote. O resultado do processamento do lote deve ficar disponvel na fila de sada por um perodo mnimo de 24 horas.

Pg. 35 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.2

Web Service NfeRetRecepcao

Consulta Processamento de Lote de NF-e


Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeRetRecepcao Consulta Lote de Nota Fiscal Client NFe Retorno nfeRetRecepcao Proc. Ret Aplicao NF-e

Consulta Processamento

Funo: servio destinado a retornar o resultado do processamento do lote de NF-e. Processo: assncrono. Mtodo: nfeRetRecepcao

4.2.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML contendo o nmero do recibo que identifica a mensagem de envio de lotes de NF-e. Schema XML: consReciNFe_v99.99.xsd
# Campo Ele
Raiz A E E

Pai
BP01 BP01 BP01

Tipo Ocor. Tam. Dec.


N N N 1-1 1-1 1-1 1-4 1 15 2 TAG raiz

Descrio/Observao
Verso do leiaute Identificao do Ambiente: 1 Produo / 2 - Homologao Nmero do Recibo Nmero gerado pelo Portal da Secretaria de Fazenda Estadual, composto por: duas posies com cdigo da UF onde foi entregue o lote, codificao de UF do IBGE, e treze posies numricas seqenciais.

BP01 consReciNFe BP02 versao BP03 tpAmb BP04 nRec

4.2.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML com o resultado do processamento da mensagem de envio de lote de NF-e. Schema XML: retConsReciNFe_v99.99.xsd
# Campo Ele
A

Pai
BR01

Tipo Ocor. Tam. Dec.


N 1-1 1-4 2

Descrio/Observao
TAG raiz da Resposta Verso do leiaute
Pg. 36 / 145

BR01 retConsReciNFe Raiz BR02 versao

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

BR03 tpAmb BR04 verAplic BR04a nRec BR05 cStat BR06 xMotivo BR06a cUF BR07 protNfe*

E E E E E E

BR01 BR01 BR01 BR01 BR01 BR01

N C N N C N -

1-1 1-1 1-1 1-1 1-1 1-1 0-50

1 1-20 15 3 1-255 2 -

Identificao do Ambiente: 1 Produo / 2 - Homologao Verso do Aplicativo que recebeu o Lote. Nmero do Recibo consultado Cdigo do status da resposta para o Lote (vide item 5.1.1) Descrio literal do status da resposta para o Lote. Cdigo da UF que atendeu a solicitao. Conjunto de resultado do processamento de cada NF-e (vide leiaute abaixo). Estas informaes so retornadas apenas para o cdigo do status do lote = 104 (Lote processado)

Os protocolos so retornados para os lotes processados cStat = 104 xml BR01

* Para cada Protocolo de uma NF-e processada teremos o seguinte leiaute:


# Campo Ele
Raiz A G

Pai
PR01 PR01

Tipo Ocor. Tam. Dec.


N C 1-1 1-1 0-1 4 2

Descrio/Observao
TAG raiz do Protocolo de recebimento da NFe Verso do leiaute das informaes de Protocolo. Informaes do Protocolo de resposta. TAG a ser assinada Identificador da TAG a ser assinada, somente precisa ser informado se a UF assinar a resposta. Em caso de assinatura da resposta pela SEFAZ preencher o campo com o Nro do Protocolo, precedido com o literal ID Identificao do Ambiente: 1 Produo / 2 - Homologao Verso do Aplicativo que recebeu o Lote. Chave de Acesso da NF-e composta por Cdigo da UF + AAMM da emisso + CNPJ do Emitente + Modelo, Srie e Nmero da NFe + Cdigo Numrico + DV. Data e hora de processamento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora da gravao da NF-e no Banco de Dados. Em caso de Rejeio, com data e hora do recebimento do Lote de NF-e enviado.

PR01 protNFe PR02 versao PR03 infProt PR04 Id

ID PR03

PR05 tpAmb PR06 verAplic PR07 chNFe

E E E

PR03 PR03 PR03

N C N

1-1 1-1 1-1

1 1-20 44

PR08 dhRecbto

PR03

1-1

PR09 nProt

PR03

0-1

15

Nmero do Protocolo da NF-e 1 posio (1 Secretaria de Fazenda Estadual 2 Receita Federal); 2 posies para cdigo da UF; 2 posies ano; 10 seqencial no ano Digest Value da NF-e processada Utilizado para conferir a integridade da NFe original. Cdigo do status da resposta para a NF-e (vide item 5.1.1). Descrio literal do status da resposta para a NF-e. Assinatura XML do grupo identificado pelo atributo ID A deciso de assinar a mensagem fica a critrio da UF interessada.
Pg. 37 / 145

PR10 digVal

PR03

0-1

28

PR11 cStat PR12 xMotivo PR13 Signature

E E G

PR03 PR03 PR01

N C xml

1-1 1-1 0-1

3 1-255 -

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.2.3 Descrio do Processo de Web Service


Este mtodo oferece a consulta do resultado do processamento de um lote de NF-e. O aplicativo do Contribuinte deve ser construdo de forma a aguardar um tempo mnimo de 15 segundos entre o envio do Lote de NF-e para processamento e a consulta do resultado deste processamento, evitando a obteno desnecessria do status de erro 105 - "Lote em Processamento". Devero ser realizadas as validaes e procedimentos que seguem:

4.2.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.2.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Obrig. Msg 214 243 108 Efeito Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente

Pg. 38 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

B04 Verifica se o Servio est Paralisado sem Previso

Obrig.

109

Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.2.6 Validao da rea de Cabealho

Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

4.2.7 Validao da rea de Dados

a) Validao da Forma da rea de Dados


Validao da Mensagem do Pedido de Consulta de Lote # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao das Regras de Negcio da Consulta Recibo


Pg. 39 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A seguir so realizadas as seguintes validaes:


Validao da Consulta Recibo # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Obrig. Msg 252 248 106 105 223 Efeito Rej. Rej. Rej. Rej. Rej. E01 Tipo do ambiente da NF-e difere do ambiente do Web Service E02 UF do Recibo difere da UF do Web Service E03 - Verifica se o Lote no est na fila de sada, nem na fila de entrada E04 - Verifica se o Lote no est na fila de resposta, mas est na fila de entrada E05 CNPJ do transmissor do lote difere do CNPJ do transmissor da consulta

4.2.8 Final do Processamento


A mensagem de retorno poder ser: Lote processado - cStat=104, com os resultados individuais de processamento das NF-e; Lote em processamento cStat=105, o aplicativo do contribuinte dever fazer uma nova consulta; Lote no localizado - cStat=106, o aplicativo do contribuinte dever providenciar o reenvio da mensagem; Recibo ou CNPJ do requisitante com problemas - cStat= 248 ou 223, o aplicativo do contribuinte dever sanar o problema;

Pg. 40 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.3

Web Service - NfeCancelamento

Cancelamento de NF-e
Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeCancelamento Proc. Cancelamento da NF-e Client NFe Retorno nfeCancelamentoNF Ret Aplicao NF-e Cancelamento

Funo: servio destinado ao atendimento de solicitaes de cancelamento de Notas Fiscais Eletrnicas. Processo: sncrono. Mtodo: nfeCancelamentoNF

4.3.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML contendo a mensagem de solicitao de cancelamento. Schema XML: cancNFe_v99.99.xsd
# Campo Ele
Raiz A G

Pai
CP01 CP01

Tipo Ocor. Tam. Dec.


N C 1-1 1-1 1-1 1-4 46 2 TAG raiz

Descrio/Observao
Verso do leiaute Dados do Pedido - TAG a ser assinada Identificador da TAG a ser assinada Informar a chave de acesso precedida do literal ID Identificao do Ambiente: 1 Produo / 2 - Homologao Servio solicitado CANCELAR Chave de acesso da NF-e composta por Cdigo da UF + AAMM da emisso + CNPJ do Emitente + Modelo, Srie e Nmero da NFe + Cdigo Numrico + DV. Informar o nmero do Protocolo de Autorizao da NF-e a ser Cancelada. 1 posio (1 Secretaria de Fazenda Estadual 2 Receita Federal); 2 posies para cdigo da UF; 2 posies ano; 10 seqencial no ano Informar a justificativa do cancelamento Assinatura XML do grupo identificado pelo atributo ID
Pg. 41 / 145

CP01 cancNFe CP02 versao CP03 infCanc CP04 Id

ID CP03

CP05 tpAmb CP06 xServ CP07 chNFe

E E E

CP03 CP03 CP03

N C N

1-1 1-1 1-1

1 8 44

CP08 nProt

CP03

1-1

15

CP09 xJust CP10 Signature

E E

CP03 CP01

C xml

1-1 1-1

15255 -

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.3.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da solicitao de cancelamento: Schema XML: retCancNFe_v99.99.xsd
# Campo Ele
Raiz A G

Pai
CR01 CR01

Tipo Ocor. Tam. Dec.


N C 1-1 1-1 0-1 1-4 2

Descrio/Observao
TAG raiz da Resposta Verso do leiaute Dados da resposta - TAG a ser assinada Identificador da TAG a ser assinada, somente precisa ser informado se a UF assinar a resposta. Em caso de assinatura da resposta pela SEFAZ preencher o campo com o Nro do Protocolo, precedido com o literal ID Identificao do Ambiente: 1 Produo / 2 Homologao Verso do Aplicativo que recebeu o Lote. Cdigo do status da resposta (vide item 5.1.1). Descrio literal do status da resposta. Cdigo da UF que atendeu a solicitao.

CR01 retCancNFe CR02 versao CR03 infCanc CR04 Id

ID CR03

CR05 tpAmb CR06 verAplic CR07 cStat CR08 xMotivo CR08a cUF

E E E E E

CR03 CR03 CR03 CR03 CR03

N C N C N

1-1 1-1 1-1 1-1 1-1

1 1-20 3 1-255 2

Os campos a seguir so obrigatrios no caso de homologao de cancelamento cStat=101. Os campos de dhRecbto e nProt no sero preenchidos em caso de erro. CR09 chNFe E CR03 N 0-1 44 Chave de Acesso da NF-e composta por Cdigo da UF + AAMM da emisso + CNPJ do Emitente + Modelo, Srie e Nmero da NFe + Cdigo Numrico + DV. Data e hora de processamento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora da homologao do Pedido. Nmero do Protocolo de Cancelamento 1 posio (1 Secretaria de Fazenda Estadual 2 Receita Federal); 2 posies para cdigo da UF; 2 posies ano; 10 seqencial no ano. O controle de numerao de Protocolo ser nico para todos os servios. Assinatura XML do grupo identificado pelo atributo ID A deciso de assinar a mensagem fica a critrio da UF interessada.

CR10 dhRecbto

CR03

0-1

CR11 nProt

CR03

0-1

15

CR12 Signature

CR01 xml

0-1

4.3.3 Descrio do Processo de Web Service


Este mtodo responsvel por receber as solicitaes referentes ao cancelamento de NF-e. Ao receber a solicitao do transmissor, a aplicao do Portal da Secretaria de Fazenda Estadual realiza o processamento da solicitao e devolve o resultado do processamento para o aplicativo do mesmo. A mensagem de solicitao de cancelamento de NF-e um documento eletrnico e deve ser assinado digitalmente pelo emitente da NF-e. Devero ser realizadas as validaes e procedimentos que seguem.
Pg. 42 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.3.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.3.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Obrig. Obrig. Msg 214 243 108 109 Efeito Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados.
Pg. 43 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.3.6 Validao da rea de Cabealho


Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

4.3.7 Validao da rea de Dados

a) Validao da Forma da rea de Dados


Validao da Mensagem do Pedido de Cancelamento da NF-e # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao do Certificado Digital utilizado na Assinatura


Validao do Certificado Digital utilizado na Assinatura Digital # Regra de Validao Aplic. Obrig. Msg 290 Efeito Rej. E01 Certificado de Assinatura invlido: - Certificado de Assinatura inexistente na mensagem (*validado tambm pelo Schema) - Verso difere "3" - Basic Constraints = true (no pode ser Certificado de AC) - KeyUsage no define "Assinatura Digital" e No Recusa E02 Validade do Certificado (data incio e data fim) E03 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

291 292

Rej. Rej.

Pg. 44 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

E04 Verifica Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado E05 LCR do Certificado de Assinatura: - Falta o endereo da LCR (CRLDistributionPoint) - Erro no acesso a LCR E06 Certificado de Assinatura revogado E07 Certificado Raiz difere da ICP-Brasil

Obrig.

293

Rej.

Obrig.

296

Rej.

Obrig. Obrig.

294 295

Rej. Rej.

c) Validao da Assinatura Digital


Validao da Assinatura Digital # Regra de Validao Aplic. Msg 298 Efeito Rej. F01 Assinatura difere do padro do Projeto: Obrig. - No assinado o atributo "ID" (falta "Reference URI" na assinatura) (*validado tambm pelo Schema) - Faltam os "Transform Algorithm" previstos na assinatura ("C14N" e "Enveloped") Estas validaes so implementadas pelo Schema XML da Signature F02 Valor da assinatura (SignatureValue) difere do valor calculado Obrig. F03 CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital F04 CNPJ do Certificado Digital difere do CNPJ da Matriz e do CNPJ do Emitente Obrig. Facult.

297 213 244

Rej. Rej. Rej.

d) Validao das Regras de Negcio do Cancelamento de NF-e

Pedido de cancelamento de NF-e Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Msg 252 249 236 203 240 217 216 205 218 220 222 221 219 Efeito Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. H01 Tipo do ambiente da NF-e difere do ambiente do Web Service H02 UF da Chave de Acesso difere da UF do Web Service H03 Chave de Acesso: Dgito Verificador invlido H04 Acesso Cadastro Contribuinte: - Verificar Emitente no autorizado a emitir NF-e H05 - Verificar Situao Fiscal irregular do Emitente H06 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): - Verificar se NF-e no existe H07 - Cdigo Numrico informado na Chave de Acesso diferente do existente no BD H08 - Verificar se NF-e j est Denegada H09 - Verificar se NF-e j est Cancelada H10 - Verificar NF-e autorizada h mais de 7 dias (168 horas) H11 - Verificar se o nmero Protocolo informado difere do nro. Protocolo da NF-e H12 - Verificar recebimento da NF-e pelo Destinatrio* H13 - Verificar registro de Circulao de Mercadoria*

Pg. 45 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

* Obs. As regras de validao H12 e H13 so de implementao futura. O cancelamento s poder ser realizado nota a nota e para cada cancelamento homologado criado um novo protocolo de status para NF-e, com a atribuio de um nmero de protocolo nico (vide item 5.6).

4.3.8 Final do Processamento


No caso de homologao do Cancelamento retornar o cStat = 101.

Pg. 46 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.4

Web Service - NfeInutilizacao

Inutilizao de numerao de NF-e


Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeInutilizacao Inutilizao de Numerao Client NFe Retorno nfeInutilizacaoNF

Proc. Ret Inutilizacao Inutilizao Aplicao NF-e

Funo: servio destinado ao atendimento de solicitaes de inutilizao de numerao. Processo: sncrono. Mtodo: nfeInutilizacaoNF

4.4.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML contendo a mensagem de solicitao de inutilizao. Schema XML: inutNFe_v99.99.xsd
# Campo Ele
Raiz A G

Pai
DP01 DP01

Tipo Ocor. Tam. Dec.


N C 1-1 1-1 1-1 1-4 39-44 2 TAG raiz

Descrio/Observao
Verso do leiaute Dados do Pedido TAG a ser assinada Identificador da TAG a ser assinada formada com Cdigo da UF + CNPJ + modelo + srie + nro inicial e nro final precedida do literal ID Identificao do Ambiente: 1 Produo / 2 - Homologao Servio solicitado: INUTILIZAR Cdigo da UF do solicitante Ano de inutilizao da numerao CNPJ do emitente Modelo da NF-e Srie da NF-e Nmero da NF-e inicial a ser inutilizada Nmero da NF-e final a ser inutilizada Informar a justificativa do pedido de inutilizao Assinatura XML do grupo identificado pelo atributo ID
Pg. 47 / 145

DP01 inutNFe DP02 versao DP03 infInut DP04 Id

ID DP03

DP05 tpAmb DP06 xServ DP07 cUF DP08 ano DP09 CNPJ DP10 mod DP11 serie DP12 nNFIni DP13 nNFFin DP14 xJust DP15 Signature

E E E E E E E E E E G

DP03 DP03 DP03 DP03 DP03 DP03 DP03 DP03 DP03 DP03 DP01

N C N N C N N N N C xml

1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1

1 10 2 2 14 2 1-3 1-9 1-9 15255 -

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.4.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da solicitao de inutilizao: Schema XML: retInutNFe_v99.99.xsd
# Campo Ele
Raiz A G

Pai
DR01 DR01

Tipo Ocor. Tam. Dec.


N C 1-1 1-1 0-1 1-4 17 2

Descrio/Observao
TAG raiz da Resposta Verso do leiaute Dados da resposta - TAG a ser assinada Identificador da TAG a ser assinada, somente precisa ser informado se a UF assinar a resposta. Em caso de assinatura da resposta pela SEFAZ preencher o campo com o Nro do Protocolo, precedido com o literal ID. Identificao do Ambiente: 1 Produo / 2 Homologao Verso do Aplicativo que processou o pedido de inutilizao. Cdigo do status da resposta (vide item 5.1.1). Descrio literal do status da resposta. Cdigo da UF que atendeu a solicitao

DR01 retInutNFe DR02 versao DR03 infInut DR04 Id

ID DR03

DR05 tpAmb DR06 verAplic DR07 cStat DR08 xMotivo DR09 cUF

E E E E E

DR03 DR03 DR03 DR03 DR03

N C N C N

1-1 1-1 1-1 1-1 1-1

1 1-20 3 1-255 2

Os campos a seguir so obrigatrios no caso de homologao da inutilizao cStat=102. Os campos de dhRecbto e nProt no sero preenchidos em caso de erro DR10 ano DR11 CNPJ DR12 mod DR13 serie DR14 nNFIni DR15 nNFFin DR16 dhRecbto E E E E E E E DR03 DR03 DR03 DR03 DR03 DR03 DR03 N C N N N N D 0-1 0-1 0-1 0-1 0-1 0-1 0-1 2 14 2 1-3 1-9 1-9 Ano de inutilizao da numerao CNPJ do emitente Modelo da NF-e Srie da NF-e Nmero da NF-e inicial a ser inutilizada Nmero da NF-e final a ser inutilizada Data e hora de processamento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora da gravao no Banco de Dados em caso de Confirmao. Em caso de Rejeio, com data e hora do recebimento do Pedido. DR17 nProt E DR03 N 0-1 15 Nmero do Protocolo de Inutilizao 1 posio (1 Secretaria de Fazenda Estadual 2 Receita Federal); 2 posies para cdigo da UF; 2 posies ano; 10 seqencial no ano. O controle de numerao do Protocolo ser nico para todos os servios. Assinatura XML do grupo identificado pelo atributo ID A deciso de assinar a mensagem fica a critrio da UF interessada.

DR18 Signature

DR01 xml

0-1

4.4.3 Descrio do Processo de Web Service


Este mtodo ser responsvel por receber as solicitaes referentes inutilizao de faixas de numerao de notas fiscais eletrnicas. Ao receber a solicitao, a aplicao NFE realiza o processamento da solicitao e devolve o resultado do processamento para o aplicativo do transmissor.
Pg. 48 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A mensagem de pedido de inutilizao de numerao de NF-e um documento eletrnico e deve ser assinado digitalmente pelo emitente da NF-e. Devero ser realizadas as validaes e procedimentos que seguem.

4.4.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.4.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Obrig. Obrig. Msg 214 243 108 109 Efeito Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de
Pg. 49 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.4.6 Validao da rea de Cabealho


Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

4.4.7 Validao da rea de Dados


a) Validao da Forma da rea de Dados
Validao da Mensagem do Pedido de Inutilizao de numerao de NF-e. # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao do Certificado Digital utilizado na Assinatura


Validao do Certificado Digital utilizado na Assinatura Digital # Regra de Validao Aplic. Obrig. Msg 290 Efeito Rej. E01 Certificado de Assinatura invlido: - Certificado de Assinatura inexistente na mensagem (*validado tambm pelo Schema) - Verso difere "3" - Basic Constraints = true (no pode ser Certificado de AC) - KeyUsage no define "Assinatura Digital" e No Recusa E02 Validade do Certificado (data incio e data fim)

Obrig.

291

Rej.

Pg. 50 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

E03 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3) E04 Verifica Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado E05 LCR do Certificado de Assinatura: - Falta o endereo da LCR (CRLDistributionPoint) - Erro no acesso a LCR E06 Certificado de Assinatura revogado E07 Certificado Raiz difere da ICP-Brasil

Obrig. Obrig.

292 293

Rej. Rej.

Obrig.

296

Rej.

Obrig. Obrig.

294 295

Rej. Rej.

c) Validao da Assinatura Digital


Validao da Assinatura Digital # Regra de Validao Aplic. Msg 298 Efeito Rej. F01 Assinatura difere do padro do Projeto: Obrig. - No assinado o atributo "ID" (falta "Reference URI" na assinatura) (*validado tambm pelo Schema) - Faltam os "Transform Algorithm" previstos na assinatura ("C14N" e "Enveloped") Estas validaes so implementadas pelo Schema XML da Signature F02 Valor da assinatura (SignatureValue) difere do valor calculado Obrig. F03 CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital F04 CNPJ do Certificado Digital difere do CNPJ da Matriz e do CNPJ do Emitente Obrig. Facult.

297 213 244

Rej. Rej. Rej.

d) Validao das Regras de Negcio da Inutilizao de numerao de NF-e


Pedido de Inutilizao de numerao de NF-e Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Msg 252 250 453 454 224 201 203 240 256 Efeito Rej. Rej Rej. Rej. Rej Rej Rej Rej Rej I01 Tipo do ambiente da NF-e difere do ambiente do Web Service I02 UF do Pedido de inutilizao difere da UF do Web Service I02b Ano da Inutilizao no pode ser superior ao Ano atual I02c Ano da inutilizao no pode ser inferior a 2006 I03 Nmero da Faixa Inicial maior do que o nmero Final I04 Quantidade mxima de numerao a inutilizar ultrapassa o limite (1.000 nmeros) I05 Acesso Cadastro Contribuinte: - Verificar Emitente no autorizado a emitir NF-e I06 - Verificar Situao Fiscal irregular do Emitente

I07 Acesso BD NFE-Inutilizao: Obrig. - Verificar se algum Nro da Faixa de Inutilizao atual pertence a uma faixa anterior I08 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. - Verificar se existe NF-e utilizada na faixa de inutilizao solicitada

241

Rej

Pg. 51 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Para cada inutilizao de numerao de NF-e homologada criado um novo protocolo de status para NF-e, com a atribuio de um nmero de protocolo nico (vide item 5.6).

4.4.8 Final do Processamento


No caso de homologao da Inutilizao retornar o cStat = 102.

Pg. 52 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.5

Web Service NfeConsulta Protocolo

Consulta situao atual da NF-e


Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeConsulta Consulta NF-e Client NFe Retorno nfeConsultaNF

Proc. Ret Consulta NF-e Aplicao NF-e

Funo: servio destinado ao atendimento de solicitaes de consulta da situao atual da NF-e na Base de Dados do Portal da Secretaria de Fazenda Estadual. Processo: sncrono. Mtodo: nfeConsultaNF

4.5.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML contendo a chave de acesso da NF-e. Schema XML: consSitNFe_v99.99.xsd
# Campo Ele
Raiz A E E E

Pai
EP01 EP01 EP01 EP01

Tipo Ocor. Tam. Dec.


N N C N 1-1 1-1 1-1 1-1 1-4 1 9 44 2 TAG raiz

Descrio/Observao
Verso do leiaute Identificao do Ambiente: 1 Produo / 2 - Homologao Servio solicitado CONSULTAR Chave de Acesso da NF-e composta por Cdigo da UF + AAMM da emisso + CNPJ do Emitente + Modelo, Srie e Nmero da NFe + Cdigo Numrico + DV.

EP01 conSitNFe EP02 versao EP03 tpAmb EP04 xServ EP05 chNFe

4.5.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da consulta de protocolo: Schema XML: retConsSitNFe_v99.99.xsd
# Campo Ele
Raiz

Pai
-

Tipo Ocor. Tam. Dec.


-

Descrio/Observao
TAG raiz da Resposta
Pg. 53 / 145

ER01 retConsSitNFe

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

ER02 versao ER03 infProt ER04 Id

A G

ER01 ER01

N C

1-1 1-1 0-1

1-4 -

Verso do leiaute Informaes do Protocolo de resposta. TAG a ser assinada Identificador da TAG a ser assinada, somente ser informado se a UF assinar a resposta. Em caso de assinatura da resposta pela SEFAZ preencher o campo com a chave de acesso precedida do literal ID Identificao do Ambiente: 1 Produo / 2 Homologao Verso do Aplicativo que processou a consulta Cdigo do status da resposta. Descrio literal do status da resposta. Cdigo da UF que atendeu a solicitao.

ID ER03

ER05 tpAmb ER06 verAplic ER07 cStat ER08 xMotivo ER08a cUF

E E E E E

ER03 ER03 ER03 ER03 ER03

N C N C N

1-1 1-1 1-1 1-1 1-1

1 1-20 3 1-255 2

Os campos a seguir so obrigatrios no em caso de localizao da NF-e cStat = 100, 101 ou 110 Os campos de dhRecbto e nProt no sero preenchidos em caso de erro. ER09 chNFe E ER03 N 0-1 44 Chave de Acesso da NF-e composta por Cdigo da UF + AAMM da emisso + CNPJ do Emitente + Modelo, Srie e Nmero da NFe + Cdigo Numrico + DV. Data e hora de processamento Formato = AAAA-MM-DDTHH:MM:SS Nmero do Protocolo do Status atual da NF-e 1 posio (1 Secretaria de Fazenda Estadual 2 Receita Federal); 2 posies para cdigo da UF; 2 posies ano; 10 seqencial no ano Digest Value da NF-e processada Utilizado para conferir a integridade da NFe original. Assinatura XML do grupo identificado pelo atributo ID A deciso de assinar a mensagem fica a critrio da UF interessada.

ER10 dhRecbto ER11 nProt

E E

ER03 ER03

D N

0-1 0-1

15

ER12 digVal

ER03

0-1

28

ER13 Signature

ER01

xml

0-1

4.5.3 Descrio do Processo de Web Service


Este mtodo ser responsvel por receber as solicitaes referentes consulta de situao de notas fiscais eletrnicas enviadas para as Secretarias de Fazendas Estaduais. Seu acesso permitido apenas pela chave nica de identificao da nota fiscal. O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda Estadual. Ao receber a solicitao a aplicao do Portal da Secretaria de Fazenda Estadual processar a solicitao de consulta, validando a Chave de Acesso da NF-e, e retornar mensagem contendo a situao atual da NF-e na Base de Dados. Devero ser realizadas as validaes e procedimentos que seguem.

4.5.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Msg Efeito

Pg. 54 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

280

Rej.

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.5.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Obrig. Obrig. Msg 214 243 108 109 Efeito Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.
Pg. 55 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.5.6 Validao da rea de Cabealho


Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

4.5.7 Validao da rea de Dados


a) Validao da Forma da rea de Dados
Validao da Mensagem do Pedido de Consulta de situao de NF-e. # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao das Regras de Negcios da Consulta a NF-e A seguir so realizadas as seguintes validaes:
Validao do Pedido de Consulta de situao de NF-e Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Msg 252 226 217 216 Efeito Rej. Rej. Rej. Rej. J01 Tipo do ambiente da NF-e difere do ambiente do Web Service J02 UF da Chave de Acesso difere da UF do Web Service

J03 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. - Verificar se NF-e no existe J04 - Verificar se campo Cdigo Numrico informado na Chave de Obrig. Acesso diferente do existente no BD

4.5.8 Final do Processamento


O processamento do pedido de consulta de status de NF-e pode resultar em uma mensagem de erro ou retornar a situao atual da NF-e consultada. No caso de localizao da NF-e retornar o cStat com os valores 100, 101 ou 110.

Pg. 56 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.6

Web Service - NfeStatusServico

Consulta Status do Servio


Contribuinte Secretaria de Fazenda Estadual
Web Service: NfeStatusServico Consulta Status Client NFe Retorno nfeStatusServicoNF

Proc. Ret Consulta Status Aplicao NF-e

Funo: servio destinado consulta do status do servio prestado pelo Portal da Secretaria de Fazenda Estadual. Processo: sncrono. Mtodo: nfeStatusServicoNF

4.6.1 Leiaute Mensagem de Entrada


Entrada: Estrutura XML para a consulta do status do servio. Schema XML: consStatServ_v99.99.xsd
# Campo Ele
Raiz A E E E

Pai
FP01 FP01 FP01 FP01

Tipo Ocor. Tam. Dec.


N N N C 1-1 1-1 1-1 1-1 1-4 1 2 6 2 TAG raiz

Descrio/Observao
Verso do leiaute Identificao do Ambiente: 1 Produo / 2 - Homologao Cdigo da UF consultada Servio solicitado STATUS

FP01 consStatServ FP02 versao FP03 tpAmb FP04 cUF FP05 xServ

4.6.2 Leiaute Mensagem de Retorno


Retorno: Estrutura XML contendo a mensagem do resultado da consulta do status do servio: Schema XML: retConsStatServ_v99.99.xsd
# Campo Ele
A E E

Pai
FR01 FR01 FR01

Tipo Ocor. Tam. Dec.


N N C 1-1 1-1 1-1 1-4 1 1-20 2

Descrio/Observao
TAG raiz da Resposta Verso do leiaute Identificao do Ambiente: 1 Produo / 2 - Homologao Verso do Aplicativo que processou a consulta
Pg. 57 / 145

FR01 retConsStatServ Raiz FR02 versao FR03 tpAmb FR04 verAplic

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

FR05 cStat FR06 xMotivo FR07 cUF FR08 dhRecbto

E E E E

FR01 FR01 FR01 FR01

N C N D

1-1 1-1 1-1 1-1

3 1-60 2 -

Cdigo do status da resposta. Descrio literal do status da resposta. Cdigo da UF que atendeu a solicitao Data e hora de recebimento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora do recebimento do Pedido. Tempo mdio de resposta do servio (em segundos) dos ltimos 5 minutos. Preencher com data e hora previstas para o retorno do Web Service, no formato AAA-MMDDTHH:MM:SS Informaes adicionais para o Contribuinte

FR09 tMed FR10 dhRetorno

E E

FR01 FR01

N D

0-1 0-1

1-4 -

FR11 xObs

FR01

0-1

1-255

4.6.3 Descrio do Processo de Web Service


Este mtodo ser responsvel por receber as solicitaes referentes consulta do status do servio do Portal da Secretaria de Fazenda Estadual. O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda Estadual. Ao receber a solicitao a aplicao do Portal da Secretaria de Fazenda Estadual processar a solicitao de consulta, e retornar mensagem contendo a status do servio. As Empresas que construrem um aplicativo que se mantenha em "loop" permanente de consulta a este Web Service, devem aguardar um tempo mnimo de 3 minutos entre cada consulta, evitando sobrecarregar desnecessariamente os servidores da SEFAZ. Devero ser realizadas as validaes e procedimentos que seguem.

4.6.4 Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

Pg. 58 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.6.5 Validao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Obrig. Obrig. Msg 214 243 108 109 Efeito Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214. A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.6.6 Validao da rea de Cabealho


Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

Pg. 59 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.6.7 Validao da rea de Dados


a) Validao da Forma da rea de Dados
Validao da Mensagem da Consulta de Status de Servio # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao das Regras de Negcios da Consulta Status de Servio da NF-e


Validao do Pedido de Consulta de Status de Servio Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Msg 252 289 108 109 Efeito Rej. Rej. K01 Tipo do ambiente da NF-e difere do ambiente do Web Service K02 Cdigo da UF consultada difere da UF do Web Service K03 Verifica se o Servidor de Processamento est Paralisado Momentaneamente K04 Verifica se o Servidor de Processamento est Paralisado sem Previso

4.6.8 Final do Processamento


O processamento do pedido de consulta de status de Servio pode resultar em uma mensagem de erro ou retornar a situao atual do Servidor de Processamento, cdigos de situao 107, 108 e 109. A critrio da UF o campo xObs pode ser utilizado para fornecer maiores informaes ao contribuinte, como por exemplo: manuteno programada, modificao de verso do aplicativo, previso de retorno, etc.

Pg. 60 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.7

Web Service CadConsultaCadastro

Consulta Cadastro
Contribuinte Secretaria de Fazenda Estadual
Web Service : CadConsultaCadastro Proc. Consulta Cadastro Client NFe Retorno consultaCadastro Ret Cadastro de Contribuintes Consulta

Funo: Servio para consultar o cadastro de contribuintes do ICMS da unidade federada. Processo: sncrono. Mtodo: consultaCadastro

4.7.1 Leiaute da Mensagem de Entrada


Entrada: Estrutura XML para consulta ao cadastro de contribuintes ICMS. Schema XML: consCad_v99.99.xsd
#
GP01 GP02 GP03 GP04 GP05

Campo
consCad versao infCons xServ UF

Ele
Raiz A G E E

Pai
GP01 GP01 GP03 GP03

Tipo
N C C

Ocor.
1-1 1-1 1-1 1-1

Tam.
1-4 8 2

Dec.
2 -

Descrio / Observaes
TAG raiz da solicitao Verso do leiaute Dados da consulta Servio solicitado CONS-CAD Sigla da UF consultada, informar 'SU' para SUFRAMA. Inscrio estadual do contribuinte CNPJ do contribuinte CPF do contribuinte

GP06 GP07 GP08

IE CNPJ CPF

CE CE CE

GP03 GP03 GP03

C N N

1-1 1-1 1-1

2-14 3-14 3-11

Pg. 61 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

4.7.2 Leiaute da Mensagem de Retorno


Retorno: Estrutura XML com o retorno da consulta ao cadastro de contribuintes do ICMS. Schema XML: retConsCad_v99.99.xsd
#
GR01 GR02 GR03 GR04 GR05 GR06 GR06a GR06b GR06c GR06d GR06e

Campo
retConsCad versao infCons verAplic cStat xMotivo UF IE CNPJ CPF dhCons

Ele
Raiz A G E E E E CE CE CE E

Pai
GR01 GR01 GR03 GR03 GR03 GP03 GP03 GP03 GP03 GR03

Tipo
N C N C C C N N D

Ocor.
1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1

Tam.
1-4 1-20 3 1-255 2 2-14 3-14 3-11

Dec.
2 -

Descrio / Observaes
TAG raiz da solicitao Verso do leiaute Dados da consulta Verso do Aplicativo que processou a consulta Cdigo do status da resposta. Descrio do Status da resposta. Sigla da UF consultada. Inscrio estadual consultada CNPJ consultado CPF consultado Data e hora de processamento da consulta Formato = AAAA-MMDDTHH:MM:SS Cdigo da UF que atendeu a solicitao. Dados da situao cadastral Esta estrutura existe somente para as consultas realizadas com sucesso cStat=111, com possibilidade de mltiplas ocorrncias (Ex.: consulta por IE de contribuinte com Inscrio nica - retorno de todos os estabelecimentos do contribuinte). Inscrio estadual do contribuinte CNPJ do contribuinte CPF em caso de pessoa fsica com IE O campo deve ser preenchido com a sigla da UF de localizao do contribuinte. Em algumas situaes, a UF de localizao pode ser diferente da UF consultada. Ex. IE de contribuinte inscrito como Substituto Tributrio. Situao do contribuinte: 0 - no habilitado; 1 - habilitado. Razo Social ou nome
Pg. 62 / 145

GR06f GR07

cUF infCad

E G

GR03 GR03

N -

1-1 0-N

2 -

GR08 GR09 GR10 GR11

IE CNPJ CPF UF

E CE CE E

GR07 GR07 GR07 GR07

C N N C

1-1 1-1 1-1 1-1

2-14 3-14 3-11 2

GR12

cSit

GR07

1-1

GR13

xNome

GR07

1-1

1-60

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

GR13a GR14 GR15 GR16 GR17

xFant xRegApur CNAE dIniAtiv dUltSit

E E E E E

GR07 GR07 GR07 GR07 GR07

C C N D D

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

1-60 1-60 6-7

GR18 GR20

dBaixa IEUnica

E E

GR07 GR07

D C

0-1 0-1 2-14

GR21 GR22 GR23 GR24 GR25 GR26 GR27

IEAtual ender xLgr nro xCpl xBairro cMun

E G E E E E E

GR07 GR07 GR22 GR22 GR22 GR22 GR22

0-1 0-1

2-14

C C C C N

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

1-255 1-60 1-60 1-60 7

GR28 GR29

xMun CEP

E E

GR22 GR22

C N

0-1 0-1

1-60 7-8

do Contribuinte Nome Fantasia Regime de Apurao do ICMS do Contribuinte CNAE principal do contribuinte Data de Incio da Atividade do Contribuinte Data da ltima modificao da situao cadastral do contribuinte. Data de ocorrncia da baixa do contribuinte. IE nica, este campo ser informado quando o contribuinte possuir IE nica. IE atual (em caso de IE antiga consultada) Endereo - grupo de informaes opcionais. Nome do Logradouro Nmero Complemento Nome do Bairro Cdigo do Municpio do Contribuinte, conforme Tabela do IBGE Nome do municpio Cdigo do CEP

4.7.3 Descrio do Processo de Web Service


Este Web Service oferece a consulta pblica do cadastro de contribuintes do ICMS de uma unidade federada. O Web Service poder ser oferecido por qualquer UF, sendo de oferecimento obrigatrio para as UFs que autorizam a emisso de qualquer espcie de Documento Fiscal eletrnico DF-e. Apenas as empresas autorizadas a emitir Documentos Fiscais eletrnicos podero utilizar este servio. A UF que oferecer o Web Service dever verificar se o CNPJ da empresa solicitante consta do cadastro nacional de emissores de Documentos Fiscais eletrnicos DF-e. A identificao da empresa solicitante do servio ser realizada atravs do CNPJ contido na extenso otherName OID=2.16.76.1.3.3 do certificado digital utilizado na conexo SSL. Importante ressaltar que este Web Service no tem a mesma disponibilidade dos demais Web Services da NF-e. O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda Estadual. Ao receber a solicitao a aplicao do Portal da Secretaria de Fazenda Estadual processar a solicitao de consulta, validando o argumento de pesquisa informado (CNPJ ou CPF ou IE), e retornar mensagem contendo a situao cadastral atual do contribuinte no cadastro de contribuintes do ICMS.
Pg. 63 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Devero ser realizadas as validaes e procedimentos que seguem.

4.7.4 Verificao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Obrig. Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Basic Constraint = true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) A03 Verifica a Cadeia de Certificao: - Certificado da AC emissora no cadastrado na SEFAZ - Certificado de AC revogado - Certificado no assinado pela AC emissora do Certificado A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-BR no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.7.5 Verificao Inicial da Mensagem no Web Service


Validao Inicial da Mensagem no Web Service # Regra de Validao Aplic. Obrig. Facult. Facult. Obrig. Obrig. Msg 214 243 299 108 109 Efeito Rej. Rej. Rej. Rej. Rej. B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B02a XML utiliza codificao diferente de UTF-8 B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da mensagem de erro 214.
Pg. 64 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A critrio de cada unidade federada poder ser verificado se o XML de dados est bem formado, no momento do recebimento da mensagem no Web Service. Esta verificao til para as UF que desejarem armazenar o XML de dados em estrutura XML de banco de dados. As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.

4.7.6 Validao da rea de Cabealho


Validao do Cabealho da Mensagem # Regra de Validao Aplic. Obrig. Obrig. Msg 242 299 238 239 Efeito Rej. Rej. Rej. Rej. C01 Verificar Schema do XML da rea de Cabealho C01a XML utiliza codificao diferente de UTF-8

C02 Verso dos Dados informada na rea de Cabealho superior Facult. verso vigente C03 Verso dos Dados no suportada Obrig.

O cabealho contm a verso do Schema XML da mensagem contida na rea de dados que ser utilizado pelo Web Service. A ocorrncia de qualquer erro na validao da rea de cabealho da mensagem impossibilita o processamento da mensagem contida na rea de dados.

4.7.7 Validao da rea de Dados


a) Validao da Forma da rea de Dados
Validao da Mensagem do Consulta Cadastro # Regra de Validao Aplic. Obrig. Obrig. Obrig. Msg 215 404 402 Efeito Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

b) Validao das Regras de Negcio da Consulta Cadastro


Validao do Pedido de Consulta Cadastro Regras de Negcios # Regra de Validao Aplic. Obrig. Obrig. Msg 265 257 Efeito Rej. Rej. K01 UF da consulta difere da UF do Web Service K02 Acessar Cadastro Contribuintes: Verificar CNPJ Solicitante emissor de NF-e (Obs. prever a consulta ao cadastro nacional de emissores de NF-e) K03 Se informado CNPJ: Verificar dgito controle, ou zeros K04 Se informado CNPJ: Acessar Cadastro Contribuinte por CNPJ No encontrado Contribuinte

Obrig. Obrig.

258 259

Rej. Rej.

Pg. 65 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

K05 Se informado IE: Verificar dgito controle ou zeros K06 Se informado IE: Acessar Cadastro Contribuinte por IE No encontrado Contribuinte K07 Se informado CPF: Verificar se a UF fornece consulta por CPF K08 Se informado CPF: Verificar dgito controle ou zeros

Obrig. Obrig. Obrig. Obrig.

260 261 262 263 264

Rej. Rej. Rej. Rej. Rej.

K09 Se informado CPF: Acessar Cadastro Contribuinte por CPF Obrig. No encontrado Contribuinte

4.7.8 Final do Processamento


A consulta com sucesso poder resultar: cStat = 111 - consulta cadastro com uma ocorrncia; cStat = 112 - consulta cadastro com mais de uma ocorrncia, existe mais de um estabelecimento para o argumento pesquisado - ex.: consulta por IE de contribuinte com diversos estabelecimentos e inscrio estadual nica.

Pg. 66 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

5. Web Services Informaes Adicionais


5.1
Regras de validao

As regras de validao aplicadas nos Web Services esto agrupadas da seguinte forma: Grupo Validao do Certificado Digital utilizada no protocolo SSL Validao da Mensagem XML no servio assncrono Validao da rea de cabealho da Mensagem XML Validao da rea de dados da Mensagem XML Validao do Certificado Digital utilizada na Assinatura Digital Validao da Assinatura Digital Validao da NF-e Validao do Pedido de Cancelamento de NF-e Validao do Pedido de Inutilizao de numerao de NF-e Validao do Pedido de Consulta de situao de NF-e Validao do Pedido de Consulta de Status de Servio Validao do Pedido de Consulta de Cadastro de Contribuintes Aplicao geral geral geral geral geral geral especfica especfica especfica especfica especfica especfica

A B C D E F G H I J K L

As regras do grupo A, B, C, D, E e F so de aplicao geral e aplicadas em todos os Web Services existentes, as regras do grupo G, H, I, J, K e L so especficos de cada Web Sevice existente.

5.1.1 Tabela de cdigos de erros e descries de mensagens de erros


CDIGO RESULTADO DO PROCESSAMENTO DA SOLICITAO

100 101 102 103 104 105 106 107 108 109 110 111 112
CDIGO

Autorizado o uso da NF-e Cancelamento de NF-e homologado Inutilizao de nmero homologado Lote recebido com sucesso Lote processado Lote em processamento Lote no localizado Servio em Operao Servio Paralisado Momentaneamente (curto prazo) Servio Paralisado sem Previso Uso Denegado Consulta cadastro com uma ocorrncia Consulta cadastro com mais de uma ocorrncia
MOTIVOS DE NO ATENDIMENTO DA SOLICITAO

201 202 203 204 205 206 207 208

Rejeio: O numero mximo de numerao de NF-e a inutilizar ultrapassou o limite Rejeio: Falha no reconhecimento da autoria ou integridade do arquivo digital Rejeio: Emissor no habilitado para emisso da NF-e Rejeio: Duplicidade de NF-e Rejeio: NF-e est denegada na base de dados da SEFAZ Rejeio: NF-e j est inutilizada na Base de dados da SEFAZ Rejeio: CNPJ do emitente invlido Rejeio: CNPJ do destinatrio invlido
Pg. 67 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259

Rejeio: IE do emitente invlida Rejeio: IE do destinatrio invlida Rejeio: IE do substituto invlida Rejeio: Data de emisso NF-e posterior a data de recebimento Rejeio: CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital Rejeio: Tamanho da mensagem excedeu o limite estabelecido Rejeio: Falha no schema XML Rejeio: Chave de Acesso difere da cadastrada Rejeio: NF-e no consta na base de dados da SEFAZ Rejeio: NF-e j esta cancelada na base de dados da SEFAZ Rejeio: Circulao da NF-e verificada Rejeio: NF-e autorizada h mais de 7 dias (168 horas) Rejeio: Confirmado o recebimento da NF-e pelo destinatrio Rejeio: Protocolo de Autorizao de Uso difere do cadastrado Rejeio: CNPJ do transmissor do lote difere do CNPJ do transmissor da consulta Rejeio: A faixa inicial maior que a faixa final Rejeio: Falha no Schema XML da NFe Rejeio: Cdigo da UF do Emitente diverge da UF autorizadora Rejeio: Erro na Chave de Acesso - Campo ID Rejeio: Data de Emisso muito atrasada Rejeio: IE do emitente no informada Rejeio: IE do emitente no cadastrada Rejeio: IE do emitente no vinculada ao CNPJ Rejeio: IE do destinatrio no informada Rejeio: IE do destinatrio no cadastrada Rejeio: IE do destinatrio no vinculada ao CNPJ Rejeio: Inscrio SUFRAMA invlida Rejeio: Chave de Acesso com dgito verificador invlido Rejeio: CPF do destinatrio invlido Rejeio: Cabealho - Verso do arquivo XML superior a Verso vigente Rejeio: Cabealho - Verso do arquivo XML no suportada Rejeio: Cancelamento/Inutilizao - Irregularidade Fiscal do Emitente Rejeio: Um nmero da faixa j foi utilizado Rejeio: Cabealho - Falha no Schema XML Rejeio: XML Mal Formado Rejeio: CNPJ do Certificado Digital difere do CNPJ da Matriz e do CNPJ do Emitente Rejeio: CNPJ Emitente no cadastrado Rejeio: CNPJ Destinatrio no cadastrado Rejeio: Sigla da UF do Emitente diverge da UF autorizadora Rejeio: UF do Recibo diverge da UF autorizadora Rejeio: UF da Chave de Acesso diverge da UF autorizadora Rejeio: UF diverge da UF autorizadora Rejeio: UF/Municpio destinatrio no pertence a SUFRAMA Rejeio: Ambiente informado diverge do Ambiente de recebimento Rejeio: Digito Verificador da chave de acesso composta invlida Rejeio: NF-e complementar no possui NF referenciada Rejeio: NF-e complementar possui mais de uma NF referenciada Rejeio: Uma NF-e da faixa j est inutilizada na Base de dados da SEFAZ Rejeio: Solicitante no habilitado para emisso da NF-e Rejeio: CNPJ da consulta invlido Rejeio: CNPJ da consulta no cadastrado como contribuinte na UF
Pg. 68 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 401 402 403 404 405 406 407 453 454 478

Rejeio: IE da consulta invlida Rejeio: IE da consulta no cadastrada como contribuinte na UF Rejeio: UF no fornece consulta por CPF Rejeio: CPF da consulta invlido Rejeio: CPF da consulta no cadastrado como contribuinte na UF Rejeio: Sigla da UF da consulta difere da UF do Web Service Rejeio: Srie utilizada no permitida no Web Service Rejeio: NF Complementar referencia uma NF-e inexistente Rejeio: NF Complementar referencia uma outra NF-e Complementar Rejeio: CNPJ Emitente da NF Complementar difere do CNPJ da NF Referenciada Rejeio: Cdigo Municpio do Fato Gerador: dgito invlido Rejeio: Cdigo Municpio do Fato Gerador: difere da UF do emitente Rejeio: Cdigo Municpio do Emitente: dgito invlido Rejeio: Cdigo Municpio do Emitente: difere da UF do emitente Rejeio: Cdigo Municpio do Destinatrio: dgito invlido Rejeio: Cdigo Municpio do Destinatrio: difere da UF do Destinatrio Rejeio: Cdigo Municpio do Local de Retirada: dgito invlido Rejeio: Cdigo Municpio do Local de Retirada: difere da UF do Local de Retirada Rejeio: Cdigo Municpio do Local de Entrega: dgito invlido Rejeio: Cdigo Municpio do Local de Entrega: difere da UF do Local de Entrega Rejeio: Certificado Transmissor invlido Rejeio: Certificado Transmissor Data Validade Rejeio: Certificado Transmissor sem CNPJ Rejeio: Certificado Transmissor - erro Cadeia de Certificao Rejeio: Certificado Transmissor revogado Rejeio: Certificado Transmissor difere ICP-Brasil Rejeio: Certificado Transmissor erro no acesso a LCR Rejeio: Cdigo Municpio do FG - ISSQN: dgito invlido Rejeio: Cdigo Municpio do FG - Transporte: dgito invlido Rejeio: Cdigo da UF informada diverge da UF solicitada Rejeio: Certificado Assinatura invlido Rejeio: Certificado Assinatura Data Validade Rejeio: Certificado Assinatura sem CNPJ Rejeio: Certificado Assinatura - erro Cadeia de Certificao Rejeio: Certificado Assinatura revogado Rejeio: Certificado Assinatura difere ICP-Brasil Rejeio: Certificado Assinatura erro no acesso a LCR Rejeio: Assinatura difere do calculado Rejeio: Assinatura difere do padro do Projeto Rejeio: XML da rea de cabealho com codificao diferente de UTF-8 Rejeio: CPF do remetente invlido Rejeio: XML da rea de dados com codificao diferente de UTF-8 Rejeio: O grupo de informaes da NF-e avulsa de uso exclusivo do Fisco Rejeio: Uso de prefixo de namespace no permitido Rejeio: Cdigo do pas do emitente: dgito invlido Rejeio: Cdigo do pas do destinatrio: dgito invlido Rejeio: O CPF s pode ser informado no campo emitente para a NF-e avulsa Rejeio: Ano de inutilizao no pode ser superior ao Ano atual Rejeio: Ano de inutilizao no pode ser inferior a 2006 Rejeio: Local da entrega no informado para faturamento direto de veculos novos
Pg. 69 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

999
CDIGO

Rejeio: Erro no catalogado (informar a mensagem de erro capturado no tratamento da exceo)


MOTIVOS DE DENEGAO DE USO

301 302

Uso Denegado : Irregularidade fiscal do emitente Uso Denegado : Irregularidade fiscal do destinatrio

OBS.: 1. Recomendamos a no utilizao de caracteres especiais ou acentuao nos textos das mensagens de erro. 2. Recomendamos que o campo xMotivo da mensagem de erro para o cdigo 999 seja informado com a mensagem de erro do aplicativo ou do sistema que gerou a exceo no prevista.

5.2

Padro de nomes para os arquivos

Visando facilitar o processo de guarda dos arquivos pelos legtimos interessados, foi criado um padro de nome para os diversos tipos de arquivos utilizados pelo sistema NF-e. So eles: NF-e: O nome do arquivo ser a chave de acesso completa com extenso nfe.xml; Envio de Lote de NF-e: O nome do arquivo ser o nmero do lote com extenso env-lot.xml; Recibo: O nome do arquivo ser o nmero do lote com extenso -rec.xml; Pedido do Resultado do Processamento do Lote de NF-e: O nome do arquivo ser o nmero do recibo com extenso -ped-rec.xml; Resultado do Processamento do Lote de NF-e: O nome do arquivo ser o nmero do recibo com extenso -pro-rec.xml; Denegao de Uso: O nome do arquivo ser a chave de acesso completa com extenso -den.xml; Pedido de Cancelamento de NF-e: O nome do arquivo ser a chave de acesso completa com extenso -ped-can.xml; Cancelamento de NF-e: O nome do arquivo ser a chave de acesso completa com extenso -can.xml; Pedido de Inutilizao de Numerao: O nome do arquivo ser composto por: UF + Ano de inutilizao + CNPJ do emitente + Modelo + Srie + Nmero Inicial + Nmero Final com extenso -ped-inu.xml; Inutilizao de Numerao: O nome do arquivo ser composto por: Ano de inutilizao + CNPJ do emitente + Modelo + Srie + Nmero Inicial + Nmero Final com extenso -inu.xml; Pedido de Consulta Situao Atual da NF-e: O nome do arquivo ser a chave de acesso completa com extenso -ped-sit.xml; Situao Atual da NF-e: O nome do arquivo ser a chave de acesso completa com extenso -sit.xml; Pedido de Consulta do Status do Servio: O nome do arquivo ser: AAAAMMDDTHHMMSS do momento da consulta com extenso -ped-sta.xml; Status do Servio: O nome do arquivo ser: AAAAMMDDTHHMMSS do momento da consulta com extenso -sta.xml;

O padro na nomenclatura tambm facilitar ao aplicativo visualizador da NF-e.


Pg. 70 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

5.3

Tratamento de caracteres especiais no texto de XML

Todos os textos de um documento XML passam por uma anlise do parser especfico da linguagem. Alguns caracteres afetam o funcionamento deste parser, no podendo aparecer no texto de uma forma no controlada. Os caracteres que afetam o parser so: > (sinal de maior), < (sinal de menor), & (e-comercial), (aspas), (sinal de apstrofe).

Alguns destes caracteres podem aparecer especialmente no campo de Razo Social, Endereo e Informao Adicional. Para resolver esses casos, recomendvel o uso de uma seqncia de escape em substituio ao caractere que causa o problema. Ex. a denominao: DIAS & DIAS LTDA deve ser informada como: DIAS &amp; DIAS LTDA no XML para no afetar o funcionamento do "parser". caractere < > & " ' seqncia de escape &lt; &gt; &amp; &quot; &#39;

5.4

Chave de Acesso da NF-e

A Chave de Acesso da Nota Fiscal Eletrnica representada por uma seqncia de 44 caracteres numricos, representados da seguinte forma:
Cdigo da UF
Quantidade de caracteres

AAMM da emisso
04

CNPJ do Emitente
14

Modelo
02

Srie
03

Nmero da NF-e
09

Cdigo Numrico
09

DV
01

02

A Chave de Acesso da Nota Fiscal eletrnica no existe como a seqncia acima descrita no leiaute da NF-e, devendo ser composta pelos seguintes campos que se encontram dispersos no leiaute da NF-e (vide Anexo I):
cUF - Cdigo da UF do emitente do Documento Fiscal AAMM - Ano e Ms de emisso da NF-e CNPJ - CNPJ do emitente mod - Modelo do Documento Fiscal serie - Srie do Documento Fiscal nNF - Nmero do Documento Fiscal cNF - Cdigo Numrico que compe a Chave de Acesso cDV - Dgito Verificador da Chave de Acesso

O Dgito Verificador (DV) ir garantir a integridade da chave de acesso, protegendo-a principalmente contra digitaes erradas.
Pg. 71 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

CLCULO DO DGITO VERIFICADOR DA CHAVE DE ACESSO DA NF-e O dgito verificador da chave de acesso da NF-e baseado em um clculo do mdulo 11. O mdulo 11 de um nmero calculado multiplicando-se cada algarismo pela seqncia de multiplicadores 2,3,4,5,6,7,8,9,2,3, ... posicionados da direita para a esquerda. A somatria dos resultados das ponderaes dos algarismos dividida por 11 e o DV (dgito verificador) ser a diferena entre o divisor (11) e o resto da diviso: DV = 11 - (resto da diviso) Quando o resto da diviso for 0 (zero) ou 1 (um), o DV dever ser igual a 0 (zero). Exemplo: consideremos que a chave de acesso tem a seguinte seqncia de caracteres:
A B C CHAVE DE ACESSO PESOS PONDERAO (A*B)

5 2 0 6 0 4 3 3 0 0 9 9 1 1 0 0 2 5 0 6 5 5 0 1 2 0 0 0 0 0 0 7 8 0 0 2 6 7 3 0 1 6 1 4 3 2 9 8 7 6 5 4 3 2 9 8 7 6 5 4 3 2 9 8 7 6 5 4 3 2 9 8 7 6 5 4 3 2 9 8 7 6 5 4 3 2 20 6 0 54 0 28 18 15 0 0 18 81 8 7 0 0 8 15 0 54 40 35 0 5 8 0 0 0 0 0 0 35 32 0 0 18 48 49 18 0 4 18 2

Somatria das ponderaes = 644 Dividindo a somatria das ponderaes por 11 teremos, 644 /11 = 58 restando 6. Como o dgito verificador DV = 11 - (resto da diviso), portando 11 - 6 = 5 Neste caso o DV da chave de acesso da NF-e igual a "5", valor este que dever compor a chave de acesso totalizando a uma seqncia de 44 caracteres.

5.5

Nmero do Recibo de Lote

O nmero do Recibo do Lote deve ser gerado pelo Portal da Secretaria de Fazenda Estadual, com a seguinte regra de formao: duas posies com Cdigo da UF onde foi entregue o lote e treze posies numricas seqenciais: 9 9 cdigo da UF 9 9 9 9 9 9 9 9 9 9 seqencial de 13 posies 9 9 9

O projeto utiliza a codificao da UF definida pelo IBGE:


Regio Norte 11-Rondnia 12-Acre 13-Amazonas 14-Roraima 15-Par 16-Amap 17-Tocantins Regio Nordeste 21-Maranho 22-Piau 23-Cear 24-Rio Grande do Norte 25-Paraba 26-Pernambuco 27-Alagoas 28-Sergipe 29-Bahia Regio Sudeste 31-Minas Gerais 32-Esprito Santo 33-Rio de Janeiro 35-So Paulo Regio Sul 41-Paran 42-Santa Catarina 43-Rio Grande do Sul Regio CentroOeste 50-Mato Grosso do Sul 51-Mato Grosso 52-Gois 53-Distrito Federal

Pg. 72 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

5.6

Nmero do protocolo

O nmero do protocolo gerado pelo Portal da Secretaria da Fazenda Estadual ou da Secretaria da Receita Federal para identificar univocamente as transaes realizadas de autorizao de uso, denegao de uso, cancelamento de NF-e e inutilizao de numerao de NF-e. A regra de formao do nmero do protocolo : 9 9 9 rgo cdigo gerador da UF 9 ano 9 9 9 9 9 9 9 9 9 seqencial de 10 posies 9 9

1 posio para indicar o rgo (1 Secretaria de Fazenda Estadual, 2 Receita Federal, 3 SEFAZ Virtual RS e 4 SEFAZ Virtual RFB); 2 posies para o cdigo da UF do IBGE; 2 posies para ano; 10 posies para o seqencial no ano.

A gerao do nmero de protocolo dever ser nica, sendo utilizada por todos os Web Service que precisam atribuir um nmero de protocolo para o resultado do processamento.

5.7

Tempo mdio de resposta

O tempo mdio de resposta um indicador que mede a performance do servio de processamento dos lotes dos ltimos 5 minutos. O tempo mdio de processamento de uma NF-e obtido pela diviso do tempo decorrido entre o recebimento da mensagem e o momento de armazenamento da mensagem de processamento do lote pela quantidade de NF-e existentes no lote. O tempo mdio de resposta a mdia dos tempos mdios de processamento de uma NF-e dos ltimos 5 minutos. Caso o tempo mdio de resposta fique abaixo de 1 (um) segundo, o tempo ser informado como 1 segundo. Arredondar as fraes de segundos para cima.

Pg. 73 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

6. Cdigo de Barra
O padro de cdigo de barras a ser impresso no DANFE o CODE-128C. Utilize o cdigo de barras: a) No caso de DANFE impresso para representar uma NF-e emitida em operao normal: apenas um cdigo de barras com a chave nica de acesso do arquivo da nota fiscal eletrnica, descrita no item 5.4; e b) No caso de DANFE impresso para representar uma NF-e emitida em contingncia: dois cdigos de barras; um para representar a chave de acesso do arquivo da nota fiscal eletrnica, descrita no item 5.4, e outro para representar dados da NF-e emitida em contingncia, conforme o item 6.3 A impresso dos cdigos de barras no DANFE tem a finalidade de facilitar e agilizar a captura de dados para consulta nos portais estaduais e da Receita Federal. Com a chave de acesso possvel realizar a consulta integral ou resumida de uma Nota Fiscal Eletrnica e sua situao, bem como visualizar a autorizao de uso da mesma. Dentre outras finalidades do cdigo, destacam-se o registro do trnsito de mercadorias nos Postos Fiscais e, a critrio de cada unidade federada, a disponibilizao do arquivo da NF-e consultada. Os dados adicionais contidos no segundo cdigo de barras sero utilizados para auxiliar o registro do trnsito de mercadorias acobertadas por notas fiscais eletrnicas emitidas em contingncia. O conjunto de caracteres representativos do Cdigo de Barras CODE-128C encontra-se no Anexo VII deste manual. Para a sua impresso ser considerada a seguinte estrutura de simbolizao:

Margem clara

Start C

Dados representados

DV

Stop

Margem clara

Margem Clara: espao claro que no contm nenhuma marca legvel por mquina, localizado esquerda e direita do cdigo, a fim de evitar interferncia na decodificao da simbologia. A margem clara chamada tambm de "rea livre", "zona de silncio" ou "margem de silncio". Start C: inicia a codificao dos dados CODE-128C de acordo com o conjunto de caracteres. O Start C no representa nenhum caractere. Dados representados: caracteres representados no cdigo de barras. DV: dgito verificador da simbologia. Stop: caractere de parada que indica o final do cdigo ao leitor ptico. O cdigo de barras dever ser impresso com os padres prprios residentes das impressoras de no impacto (laser ou deskjet) e de impacto (matriciais ou de linhas) a fim de respeitarem os padres dos referidos cdigos:
Pg. 74 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A rea reservada no DANFE; Largura mnima total do cdigo de barras (considerando o cdigo de barras da chave de acesso, com 44 posies): 6 cm para impressoras de No Impacto (Laser de Jato de Tinta); 11,5 cm para impressora de impacto (Matricial e de linha)

Altura mnima da barra: 0,8 cm; Largura mnima da barra: 0,02 cm, conforme explicado a seguir: Considerando que para cada smbolo da barra so codificados dois caracteres, ento teremos: Tamanho do campo = 44 (caracteres) / 2 = 22 (smbolos) Considerando que cada smbolo possui 11 (mdulos) * 22 (smbolos) = 242 posies Margem clara = deve ter no mnimo a dimenso de 10 (mdulos) * 2 = 20 posies Start C = 11 (mdulos) = 11 posies DV = 11 (mdulos) = 11 posies Stop = 13 (mdulos) = 13 posies Tamanho total da simbologia = 242 + 20 + 11 + 11 + 13 = 297 (posies) Largura mnima de cada mdulo da barra = 6 cm / 297 (posies) = 0,02 cm

6.1

Clculo do dgito verificador do CODE-128C

O dgito verificador baseado em um clculo do mdulo 103 considerando a soma ponderada dos valores de cada um dos dgitos na mensagem que est sendo codificada, incluindo o valor do caractere de incio (start). Exemplo: consideremos que a chave de acesso fosse apenas de oito caracteres e contivesse o seguinte nmero: 09758364
Chave de acesso Seqncia Valor do caractere Valor Ponderado (A X B) START A B C 105 105 09 1 9 9 75 2 75 150 83 3 83 249 64 4 64 256

Na linha valor do caractere foi incluso o valor 105 que corresponde ao valor do caractere de incio (start) para o padro Code C. Excetuando o caractere de start, os demais valores dos caracteres coincidem com os valores da chave de acesso, isto porque estamos utilizando o padro Code C de codificao que exclusivamente numrico. O dgito verificador do cdigo ser o resto da diviso da somatria dos valores ponderados dividido por 103 (mdulo 103). Assim o dgito verificador ser: Valor da soma ponderada = (1x105)+(1x9)+(2x75)+(3x83)+(4x64) = 769 769/103 = 7 resta 48, assim o DV 48 Representao simblica do cdigo
09 75 83 64 DV = 48 STOP Pg. 75 / 145

6.2
START

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B S B 2 1 1 2 3 2 2 2 1 2 1 3 2 4 1 2 1 1 1 1 4 2 1 2 1 1 1 4 2 2 3 1 3 1 2 1 2 3 3 1 1 1 2

A seqncia de barras est descrita na tabela do Anexo VII deste manual. B = barra preta S = espao ou barra branca A numerao acima indica quantas vezes a barra dever ser impressa no smbolo.

6.3

Representao dos dados adicionais

O DANFE impresso em contingncia dever conter um cdigo de barras adicional, os Dados da NF-e, alm da representao de seu significado em caracteres numricos. Esse cdigo de barras ser impresso no quadro imediatamente abaixo do quadro da chave de acesso da NF-e, substituindo a descrio Consulta de autenticidade no portal nacional da NF-e www.nfe.fazenda.gov.br/portal ou no site da Sefaz Autorizadora. No quadro que segue, substituindo a descrio Protocolo de Autorizao de Uso, dever constar a descrio Dados da NF-e, devendo ser impressa neste quadro a representao numrica do Cdigo de Barras dos Dados da NF-e. O Cdigo de Barras Adicional dos Dados da NF-e ser formado pelo seguinte contedo, em um total de 36 caracteres: cUF tpEmis CNPJ vNF ICMSp ICMSs DD DV Quantidade de caracteres 02 01 14 14 01 01 02 01 - cUF = Cdigo da UF do destinatrio do Documento Fiscal; - tpEmis = Forma de Emisso da NF-e, conforme o Anexo I. - CNPJ = CNPJ do destinatrio; - vNF = Valor Total da NF-e (sem ponto decimal, informar sempre os centavos); - ICMSp = Destaque de ICMS prprio na NF-e no seguinte formato: 1 = h destaque de ICMS prprio; 2 = no h destaque de ICMS prprio. - ICMSs = Destaque de ICMS por substituio tributria na NF-e, no seguinte formato: 1 = h destaque de ICMS por substituio tributria; 2 = no h destaque de ICMS por substituio tributria. - DD = Dia da emisso da NF-e; - DV = Dgito Verificador, calculado nos termos do item 5.4.

Pg. 76 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7. DANFE
O DANFE um documento auxiliar impresso em papel com os objetivos de: a) Acompanhar o trnsito de mercadorias; b) Colher a firma do destinatrio/tomador para comprovao de entrega das mercadorias ou prestao de servios; e c) Auxiliar a escriturao da NF-e pelo destinatrio no credenciado como emissor de NF-e. O DANFE emitido para representar NF-e cujo uso foi autorizado em ambiente de homologao sempre dever conter, em destaque, a frase SEM VALOR FISCAL. O DANFE emitido para representar NF-e emitida em contingncia com utilizao de formulrio de segurana sempre dever conter, em destaque, a frase DANFE em Contingncia - impresso em decorrncia de problemas tcnicos, seguindo as demais orientaes do Manual de Contingncia.

7.1

Campos do DANFE

O contedo dos campos do DANFE dever refletir o contedo das respectivas TAG XML da NF-e. O contedo dos campos poder ser impresso em mais de uma linha desde que a leitura possa ser feita de forma clara. O item 7.8 deste manual traz a sugesto de tamanhos a serem seguidos para cada campo, que garantem a legibilidade prevista na legislao. Embora os tamanhos descritos no item 7.8 no sejam obrigatrios, o DANFE dever ser impresso conforme um dos modelos permitido, conforme o item 7.6.3. O DANFE dever conter todos os campos previstos no modelo adotado, com exceo dos campos no obrigatrios do quadro Dados dos Produtos/Servios, conforme disposto no item 7.1.3. As regras estabelecidas para a impresso dos campos aplicam-se tambm para a impresso das folhas adicionais do DANFE.

7.1.1 Chave de Acesso


A chave de acesso ser impressa em onze blocos de quatro dgitos cada, com a seguinte mscara: 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999

7.1.2 Dados da NF-e


Em caso de contingncia, os dados adicionais da NF-e sero impressos em nove blocos de quatro dgitos cada, com a seguinte mscara: 9999 9999 9999 9999 9999 9999 9999 9999 9999

7.1.3 Dados do Emitente


Pg. 77 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Dever conter a identificao do emitente, composta no mnimo por: o o o nome ou razo social; endereo completo (logradouro, nmero, complemento, bairro, municpio, UF, CEP); e telefone.

Opcionalmente poder conter logotipo, desde que sua incluso no prejudique a exibio das informaes obrigatrias.

7.1.4 Quadro Fatura/Duplicatas


Poder conter linhas divisrias internas separando as informaes. Podero ser acrescidas ao quadro outras informaes relativas ao assunto, alm das informaes contidas no grupo de Dados de Cobrana da NF-e, desde que estas informaes adicionais tambm estejam contidas no arquivo da NF-e.

7.1.5 Quadro Dados dos Produtos / Servios


As informaes adicionais de produto (TAG <infAdProd>) devero constar impressas no DANFE logo abaixo do item ao qual se referirem. Sempre que o contedo de um mesmo item for impresso utilizando-se mais de uma linha do quadro de Dados dos Produtos/Servios, dever ser aplicado um destaque divisrio que identifique quais linhas foram utilizadas para cada item, a fim de distinguir com clareza um item do outro. Pode-se, para tanto, utilizar uma linha tracejada ou pontilhada. Essa exigncia tambm se aplica no caso da utilizao de uma mesma coluna para aposio de outro campo, conforme o item 7.5. Deve-se utilizar o quadro Dados dos Produtos/Servios para detalhar as operaes que no caracterizem circulao de mercadorias ou prestaes de servios, e que exijam emisso de documentos fiscais (como transferncia de crditos ou apropriao de incentivos fiscais, por exemplo). Nas situaes em que o valor unitrio comercial for diferente do valor unitrio tributvel, ambas as informaes devero estar expressas e identificadas no DANFE, podendo ser utilizada uma das linhas adicionais previstas, ou o campo de informaes adicionais. Independente do descrito no item 7.3, o contribuinte poder suprimir colunas do quadro Dados dos Produtos/Servios que no se apliquem a suas atividades e acrescentar outras do seu interesse. A insero destas colunas ser realizada direita da coluna Descrio dos Produtos/Servios. A ordem das colunas remanescentes devero ser respeitados. As seguintes colunas no podero ser suprimidas: o Cdigo dos Produtos/Servios; o Descrio dos Produtos/Servios; o NCM; o CST; o CFOP; o Unidade; o Quantidade;
Pg. 78 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

o Valor Unitrio; o Valor Total; o Base de Clculo do ICMS prprio; o Valor do ICMS prprio; e o Alquota do ICMS.

7.1.6 Informaes Complementares


Dever conter todas as Informaes Adicionais da NF-e includas nas TAGs <infAdFisco> e <infCpl>, ficando facultada a impresso das informaes adicionais contidas nas TAGs <obsCont>. Na hiptese de insuficincia de espao no quadro de informaes complementares, a impresso destas dever ser continuada no verso ou na folha seguinte, neste mesmo quadro ou no quadro Dados dos Produtos/Servios.

7.1.7 Reservado ao Fisco


O contribuinte no dever preencher este quadro, sendo seu preenchimento de uso exclusivo do fisco. Em caso de utilizao de formulrio de segurana provido de estampa fiscal, esse quadro no estar presente.

7.2

Possibilidade de Uso de Uma Mesma Coluna Com Mais de Um Campo no Quadro Dados dos Produtos/Servios

permitida a utilizao de uma mesma coluna para aposio de outro campo no quadro Dados dos Produtos/Servios do DANFE. A utilizao de uma mesma coluna para mais de um campo implicar na ocupao de duas linhas do Dados dos Produtos/Servios para cada item da NF-e, alm das linhas adicionais previstas para descrever as informaes adicionais de produto/servio (TAG <infAdProd>). Dever ser observada a necessidade de aposio de destaque divisrio dos diferentes itens do quadro Dados dos Produtos/Servios, conforme descrito no item 7.1.3. Os campos que podem ser colocados na mesma coluna so: o Cdigo do Produto/Servio com NCM/SH; o CST com CFOP; o Quantidade com Unidade; o Valor Unitrio com Desconto; o Valor Total com Base de Clculo do ICMS; o Base de Clculo do ICMS por Substituio Tributria com Valor do ICMS por Substituio Tributria; o Valor do ICMS Prprio com Valor do IPI; o Alquota do ICMS com Alquota do IPI. A utilizao de uma mesma coluna para mais de um campo no se aplicar para a aposio do campo Descrio dos Produtos e/ou Servios, podendo-se, neste caso, utilizar mais linhas para aposio de seu contedo.
Pg. 79 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7.3

Supresses e Modificaes Permitidas

Alm das supresses e incluses de colunas tratadas no item 7.1.5, podero ser feitas ainda as seguintes alteraes:

7.3.1 Bloco de Canhoto


Caso o emitente no utilize o bloco de Canhoto, poder aumentar o quadro Dados dos Produtos/Servios suprimindo os campos do referido bloco e deslocando para cima os campos seguintes. Estes ajustes devero ser feitos no mesmo valor da reduo obtida com a eliminao do quadro Fatura e de sua descrio. Para a impresso de DANFE que no utilizar formulrio de segurana, o bloco de canhoto poder ser deslocado para a extremidade inferior do formulrio, sem alteraes nas demais dimenses e disposies de campos e quadros. Essas alteraes sero admitidas somente no formato retrato.

7.3.2 Quadro Fatura/Duplicatas


O quadro fatura/duplicatas poder ser suprimido, caso o contribuinte no utilize esses documentos; ou reduzido, desde que contenha todos os dados das respectivas TAGs. O valor obtido com a eliminao ou reduo do quadro fatura/duplicatas dever ser acrescido na altura do quadro Dados dos Produtos/Servios, deslocando para cima os campos seguintes ao quadro Fatura e anteriores ao quadro a ser aumentado. Essas alteraes podero ser feitas tanto nos formatos retrato quanto paisagem.

7.3.3 Quadro Clculo do ISSQN


Caso no se aplique s suas operaes, o emitente poder suprimir os campos do bloco Clculo do ISSQN e efetuar os seguintes ajustes: o o Aumentar a altura do quadro Dados dos Produtos/Servios no mesmo valor da reduo obtida com a eliminao dos campos do referido bloco. Aumentar a altura do campo Informaes Complementares e do quadro Reservado ao Fisco no mesmo valor da reduo obtida com a eliminao dos campos do bloco Clculo do ISSQN.

7.4

Verso do DANFE

At 50% do verso de qualquer folha do DANFE poder ser utilizado para continuao dos dados do quadro Dados dos Produtos/Servios, do campo Informaes Complementares ou para uma combinao de ambos. O restante do verso dever ser deixado sem nenhum tipo de impresso. Sempre que o verso do DANFE for utilizado, a informao CONTINUA NO VERSO dever constar no anverso, ao final dos quadros Dados dos Produtos/Servios e Informaes Complementares, conforme a utilizao.

Pg. 80 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7.5

Folhas Adicionais

O DANFE poder ser emitido em mais de uma folha. Cada uma das folhas adicionais dever conter, na parte superior, no mnimo as seguintes informaes, impressas na mesma disposio e tamanho definidos para a primeira folha: o o o o o o Dados de Identificao do Emitente; As descries DANFE em destaque, e Documento Auxiliar da Nota Fiscal Eletrnica; O nmero e a srie da NF-e, o tipo de operao, se Entrada ou Sada, alm do nmero total de folhas e o nmero de ordem de cada folha; Cdigo(s) de Barras; Campos Natureza da Operao e Chave de Acesso; e Demais campos de identificao do Emitente: Inscrio Estadual, Inscrio Estadual do Substituto Tributrio e CNPJ.

A rea restante das folhas adicionais poder ser utilizada exclusivamente para apor: o Os demais itens da NF-e que no couberem na primeira folha do DANFE, mantendo-se as mesmas colunas com a mesma disposio e largura utilizadas na primeira folha; e/ou As demais informaes complementares da NF-e que no couberem no campo prprio da primeira folha do DANFE.

7.6

Formulrio

Para a impresso do DANFE poder ser utilizado qualquer tipo de papel, com exceo de papel jornal, desde que seja garantido o contraste necessrio para assegurar leitura dos cdigos de barras sem problemas.

7.6.1 Tamanho do Papel


A impresso do DANFE poder ser efetuada tanto em modo retrato quanto em modo paisagem, utilizando-se formulrios de tamanho mnimo A-4 e mximo Ofcio II (230 x 330 mm). Em caso de uso de folha de tamanho superior ao tamanho A-4 o espao excedente dever ser alocado da seguinte maneira: o o Na horizontal, para aumentar a largura dos campos; e Na vertical, somente para aumentar a altura: do quadro Dados dos Produtos/Servios; ou simultaneamente dos campo Informaes Complementares e Reservado ao Fisco; ou, ainda, de uma combinao destas duas opes. Regime especial poder regrar a impresso de DANFE em outros tamanhos.
Pg. 81 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7.6.2 Margem lateral no Formulrio


As Margens entre o corpo impresso do DANFE e o final do formulrio (ou a linha de picote) devero ter, no mnimo, 0,2 cm e, no mximo, 0,8 cm em cada lateral (inclusive nas margens superior e inferior).

7.6.3 Modelos de DANFE Permitidos


opo do contribuinte a utilizao em folhas soltas ou formulrio contnuo, pr-impresso ou em branco. Podero ser utilizados os formatos a seguir, devendo a disposio de campos obrigatoriamente obedecer o disposto no respectivo anexo: o Tamanho A-4 em modo retrato: Folhas Soltas Anexo II Formulrio Contnuo Anexo III o Tamanho A-4 em modo paisagem: Folhas Soltas Anexo IV Formulrio Contnuo Anexo V

7.7

Padres de Caracteres (Tipos de Fontes)

Todos os caracteres devero estar impressos na fonte Times New Roman ou na fonte Courier New. A impresso dos dados variveis feitas por Impressoras de Impacto (Matricial e de Linha) dever estar entre 10 e 17 CPP (Caracteres por Polegada).

7.7.1 Descritivo dos Blocos de Campos


Dever ter tamanho mnimo de cinco (5) pontos, impresso em negrito em caixa alta (maisculas).

7.7.2 Descritivo dos campos do Quadro Dados dos Produtos/Servios


Dever ser impresso em caixa alta (maisculas), com tamanho mnimo de cinco (5) pontos.

7.7.3 Descritivo dos demais campos


Dever ser impresso em caixa alta (maisculas) e ter tamanho mnimo de seis (6) pontos.

7.7.4 Contedo do bloco de campos de Identificao do Documento


O contedo dos campos DANFE, entrada ou sada, nmero, srie e folhas do documento dever ser impresso em caixa alta (maisculas). Alm disto: a descrio DANFE dever estar impressa em negrito e ter tamanho mnimo de doze (12) pontos, ou 10 CPP; a srie e nmero da NF-e, o nmero de ordem da folha, o total de folhas do DANFE e o nmero identificador do tipo de operao (se ENTRADA ou SADA, conforme tag tpNF) devero estar impressos em negrito e ter tamanho mnimo de dez (10) pontos, ou 10 CPP;
Pg. 82 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

a identificao DOCUMENTO AUXILIAR DA NOTA FISCAL ELETRNICA e as descries do tipo de operao, ENTRADA ou SADA devero ter tamanho mnimo de oito (8) pontos, ou 17 CPP.

7.7.5 Contedo do campo Chave de Acesso.


Dever ser impresso em formato negrito.

7.7.6 Contedo do quadro Dados do Emitente


Dever estar impresso em negrito. A razo social e/ou nome fantasia dever ter tamanho mnimo de doze (12) pontos, ou 17 CPP e os demais dados do emitente, endereo, municpio, CEP, fone/fax devero ter tamanho mnimo de oito (8) pontos, ou 17 CPP.

7.7.7 Contedo dos campos do Quadro Dados dos Produtos/Servios


Dever ter tamanho mnimo de seis (6) pontos, ou 17 CPP.

7.7.8 Contedo do campo Informaes Complementares


Dever ter tamanho mnimo de seis (6) pontos, ou 17 CPP.

7.7.9 Contedo dos demais campos


Dever ter tamanho mnimo de dez (10) pontos, ou 17 CPP.

7.8

Tamanho dos Campos

Esta seo apresenta a sugesto de tamanho e posio de cada campo. Todas as medidas esto em centmetros.

7.8.1 Formulrio A-4 em modo retrato


O eixo 0 (zero) no incio da folha no canto superior esquerdo.
NOME BLOCO CAMPO CANHOTO RECEBEMOS DE... NF-e / N 000.000.000 / SRIE 000 DATA DE RECEBIMENTO IDENTIFICAO E ASSINATURA... DADOS DA NF-e QUADRO IDENTIFICAO DO EMITENTE QUADRO DA DESCRIO "DANFE..." QUADRO CDIGO DE BARRAS DA CHAVE CDIGO DE BARRAS DA CHAVE CHAVE DE ACESSO QUADRO TIPO DE OPERAO QUADRO NMERO/SRIE DA NF-e QUADRO CDIGO DE BARRAS DOS DADOS CDIGO DE BARRAS DOS DADOS NATUREZA DA OPERAO DADOS DA NF-e INSCRIO ESTADUAL DO EMITENTE INSCRIO ESTADUAL DE ST DO EMITENTE CNPJ DO EMITENTE
Mat. Laser

Id da TAG

Tamanhos Mnimos Altura Largura 0,85 1,70 0,85 0,85 16,10 4,50 4,10 12,10 5,33 10.00 2,54 2.54 12,70 8.00 11,50 12,70

Posio c/ relao margem Esquerda Superior 0,25 16,35 0,25 4,35 0,25 0.25 5,58 10.25 8,12 12.79 8,62 8,12 0,42 0,42 1,27 1,27 2,54 2.54 2,54 2.54 2,54 2.54 2,78 4,02

Linha

Outras TAG/ Obs

Tam. das TAG

Mat. Laser

3,92 3.92 3,92 3.92 1,48 1.48 1,00 0,85

Obs 5

44 Invisvel Invisvel Obs 6 Obs 7 Obs 9 Obs 9 60 Obs 9 44 14 14 14

Mat. Laser

B04
Mat. Laser

C17 C18 C02

1,48 1.48 1,00 0,85 0,85 0.85 0,85 0,85 0,85

12,70 8.00 7,00 7,87 12,70 8.00 6,86 6,86 6,86

8,12 12.79 Ver 0,25 8,12 12.79 0,25 7,11 13,97

4,98 4.98 Ver 6,46 6,46 6.46 7,31 7,31 7,31

Pg. 83 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
NOME BLOCO CAMPO DESTINATRIO/REMETENTE RAZO SOCIAL CNPJ DATA DA EMISSO ENDEREO BAIRRO/DISTRITO CEP DATA DA ENTRADA/SADA MUNICPIO FONE/FAX UF INSCRIO ESTADUAL HORA DA ENTRADA/SADA FATURA/DUPLICATAS FATURA CLCULO DO IMPOSTO BASE DE CLCULO DO ICMS VALOR DO ICMS BASE DE CLCULO DO ICMS ST VALOR DO ICMS ST VALOR TOTAL DOS PRODUTOS VALOR DO FRETE VALOR DO SEGURO DESCONTO OUTRAS DESPESAS ACESSRIAS VALOR DO IPI VALOR TOTAL DA NOTA TRANSPORTADOR/VOLUMES TRANSPORTADOS RAZO SOCIAL FRETE POR CONTA DE CDIGO ANTT PLACA DO VECULO UF CNPJ/CPF ENDEREO MUNICPIO UF INSCRIO ESTADUAL QUANTIDADE DE VOLUMES ESPCIE MARCA NUMERAO PESO BRUTO PESO LQUIDO DADOS DOS PRODUTOS/SERVIOS QUADRO DADOS DOS PRODUTOS/SERVIOS CDIGO DESCRIO DOS PRODUTOS/SERVIOS "COLUNAS ESPECFICAS DA EMPRESA" NCM/SH CST CFOP UNIDADE QUANTIDADE VALOR UNITRIO DESCONTO VALOR TOTAL B.CLC.ICMS B.CLC.ICMS ST VALOR ICMS VALOR ICMS ST VALOR IPI ALQUOTA ICMS ALQUOTA IPI CLCULO DO ISSQN INSCRIO MUNICIPAL VALOR TOTAL DOS SERVIOS BASE DE CLCULO DO ISSQN VALOR DO ISSQN DADOS ADICIONAIS INFORMAES COMPLEMENTARES RESERVADO AO FISCO RESERVADO AO FISCO

Id da TAG E04 E02 B09 E06 E09 E13 B10 E11 E16 E12 E03

Tamanhos Mnimos Altura Largura 0,42 3,30 0,85 12,32 0,85 5,33 0,85 2,92 0,85 10,16 0,85 4,83 0,85 2,67 0,85 2,92 0,85 7,11 0,85 4,06 0,85 1,14 0,85 5,33 0,85 2,92 0,42 0,85 0,42 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,42 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,85 0,42 6,77 1,00 20,57 5,60 4,06 4,06 4,06 4,06 4,32 3,30 3,30 3,30 3,30 3,30 4,06 5,20 9,02 2,79 1,78 2,29 0,76 3,94 9,02 6,86 0,76 3,94 2,92 3,05 3,05 4,83 3,43 3,30 4,00 20,57

Posio c/ relao margem Esquerda Superior 0,25 8,16 0,25 8,58 12,57 8,58 17,90 8,58 0,25 9,43 10,41 9,43 15,24 9,43 17,91 9,43 0,25 10,28 7,36 10,28 11,42 10,28 12,56 10,28 17,89 10,28 0,25 0,25 0,25 0,25 4,31 8,37 12,43 16,49 0,25 3,55 6,85 10,15 13,45 16,75 0,25 0,25 9,27 12,06 13,84 16,13 16,89 0,25 9,27 16,13 16,89 0,25 3,17 6,22 9,27 14,10 17,53 0,25 0,25 11,09 11,51 12,36 12,78 12,78 12,78 12,78 12,78 13,63 13,63 13,63 13,63 13,63 13,63 14,48 14,90 14,90 14,90 14,90 14,90 14,90 15,75 15,75 15,75 15,75 16,60 16,60 16,60 16,60 16,60 16,60 17,45 17,87

Linha Invisvel Negrito

Outras TAG/ Obs

Tam. das TAG 60 14 10 120 60 8 10 60 10 2 14

E07

Negrito

Negrito Invisvel Obs 1 Invisvel 15 15 15 15 15 15 15 15 15 15 15 60 Obs 8 X25 X23 20 8 2 14 60 60 2 14 15 60 60 60 15 15

Y02 W03 W04 W05 W06 W07 W08 W09 W10 W15 W12 W16 X06 X21 X19 X10 X04 X08 X09 X10 X07 X27 X28 X29 X30 X32 X31

Negrito Invisvel

Invisvel Obs 4 60 120 Obs 2 8 N12 I13 I14 I14a Obs 3 4 6 12 16 15 15 15 15 15 15 15 5 5 15 15 15 15 5256

I02 I04 I05 N11 I08 I09 I10 I10a I17 I11 N15 N21 N17 N23 O14 N16 O13 C19 W18 W19 W20 Z02 0,42 0,85 0,85 0,85 0,85 0,42 3,07 3,07 2,29 5,08 5,08 5,08 5,33 2,29 12,95 7,62 0,25 0,25 5,33 10,41 15,49 0,25 0,25 13,17 24,64 25,06 25,06 25,06 25,06 25,91 26,33 26,33 Invisvel

U02 U04 Invisvel Z03 Invisvel

Obs 1 Permite-se a incluso dos dados de duplicatas das TAG do grupo Y07

Pg. 84 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
Obs 2 Detalhamento especficos de produtos/servios (outras TAG do grupo H) Obs 3 Total Bruto (TAG) ou Lquido (Mod.1/1-A)? Obs 4 Colunas apresentadas na ordem descrita Obs 5 TAG: C03, C04, C06, C07, C08, C09, C11, C12, C13, C16 Obs 6 TAG: B11 Obs 7 TAG: B07, B08 Obs 8 TAG: X02 Obs 9 Campo utilizado exclusivamente no Modelo de Contingncia

7.8.2 Formulrio A-4 em modo paisagem


O eixo 0 (zero) no incio da folha no canto superior esquerdo.
NOME BLOCO CAMPO CANHOTO NF-e / N 000.000.000 / SRIE 000 RECEBEMOS DE... IDENTIFICAO E ASSINATURA... DATA DE RECEBIMENTO DADOS DA NF-e QUADRO IDENTIFICAO DO EMITENTE QUADRO DA DESCRIO "DANFE..." QUADRO CDIGO DE BARRAS DA CHAVE CDIGO DE BARRAS DA CHAVE CHAVE DE ACESSO QUADRO TIPO DE OPERAO QUADRO CDIGO DE BARRAS DOS DADOS CDIGO DE BARRAS DOS DADOS QUADRO NMERO/FL./SRIE DA NF-e DADOS DA NF-e NATUREZA DA OPERAO INSCRIO ESTADUAL DO EMITENTE INSCRIO ESTADUAL DE ST DO EMITENTE CNPJ DO EMITENTE DESTINATRIO/REMETENTE RAZO SOCIAL CNPJ DATA DA EMISSO ENDEREO BAIRRO/DISTRITO CEP DATA DA ENTRADA/SADA MUNICPIO FONE/FAX UF INSCRIO ESTADUAL HORA DA ENTRADA/SADA FATURA/DUPLICATAS FATURA CLCULO DO IMPOSTO BASE DE CLCULO DO ICMS VALOR DO ICMS BASE DE CLCULO DO ICMS ST VALOR DO ICMS ST VALOR TOTAL DOS PRODUTOS VALOR DO FRETE VALOR DO SEGURO DESCONTO OUTRAS DESPESAS ACESSRIAS VALOR DO IPI VALOR TOTAL DA NOTA TRANSPORTADOR/VOLUMES TRANSPORTADOS RAZO SOCIAL FRETE POR CONTA DE CDIGO ANTT PLACA DO VECULO UF CNPJ/CPF ENDEREO MUNICPIO UF INSCRIO ESTADUAL QUANTIDADE DE VOLUMES ESPCIE MARCA NUMERAO Id da TAG Tamanho Mnimo Altura Largura 4,53 16,95 9,21 6,75 3,10 3,10 1,19 0,64 1,19 2,03 1,02 1,02 1,05 11,43 3,05 12,57 12,57 12,57 Posio c/ relao margem Esquerda Superior 0,13 0,13 1,15 1,15 2,41 13,84 16,89 16,89 16,89 0,47 5,00 5,00 14,21 0,47 0,47 0,47 1,66 Invisvel 2,38 Invisvel B04 C17 C18 C02 E04 E02 B09 E06 E09 E13 B10 E11 E16 E12 E03 0,64 0,64 0,64 0,64 0,64 1,92 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 1,28 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 1,92 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 0,64 12,57 13,97 8,89 8,89 8,76 0,51 16,38 5,84 4,32 12,45 5,84 3,94 4,32 10,03 5,08 1,27 5,84 4,32 0,51 26,54 0,51 5,33 5,33 5,33 5,33 5,21 4,32 4,32 4,32 4,32 4,32 4,95 0,51 11,56 2,79 2,54 3,81 1,02 4,83 11,56 9,14 1,02 4,83 3,56 3,81 4,19 5,08 16,89 2,92 2,92 11,81 20,70 2,41 2,92 19,30 25,14 2,92 15,37 21,21 25,14 2,92 12,95 18,03 19,30 25,14 2,41 2,92 2,41 2,92 8,25 13,58 18,91 24,24 2,92 7,24 11,56 15,88 20,20 24,52 2,41 2,92 14,48 17,27 19,81 23,62 24,64 2,92 14,48 23,62 24,64 2,92 6,48 10,29 14,48 3,57 3,57 4,21 4,21 4,21 4,85 4,85 4,85 4,85 5,49 5,49 5,49 5,49 6,13 6,13 6,13 6,13 6,13 6,77 6,77 7,41 7,41 7,41 7,41 7,41 7,41 8,05 8,05 8,05 8,05 8,05 8,05 8,69 8,69 8,69 8,69 8,69 8,69 8,69 9,33 9,33 9,33 9,33 9,97 9,97 9,97 9,97 Obs 6 Obs 9 Obs 9 Obs 7 Obs 9 Obs 5 Outras tag/ obs Tama das TAG

Linha

44

44 60 14 14 14 60 14 10 120 60 8 10 60 10 2 14

Negrito E07

Negrito

Negrito Invisvel Obs 1 Invisvel 15 15 15 15 15 15 15 15 15 15 15 60 Obs 8 X25 X23 X24 20 8 2 14 60 60 2 14 15 60 60 60

Y02 W03 W04 W05 W06 W07 W08 W09 W10 W15 W12 W16 X06 X21 X19 X20 X04 X08 X09 X10 X07 X27 X28 X29 X30

Negrito

Pg. 85 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
NOME BLOCO CAMPO PESO BRUTO PESO LQUIDO

Id da TAG X32 X31

Tamanho Mnimo Altura Largura 0,64 5,08 0,64 4,83 0,51 26,54

Posio c/ relao margem Esquerda Superior 19,56 9,97 24,64 9,97 2,41 2,92 10,61 10,61

Linha

Outras tag/ obs

Tama das TAG 15 15

DADOS DOS PRODUTOS/SERVIOS 6,67 QUADRO DADOS DOS PRODUTOS/SERVIOS 6,67 CDIGO I02 DESCRIO DOS PRODUTOS/SERVIOS I04 "COLUNAS ESPECFICAS DA EMPRESA" NCM/SH I05 CST N11 CFOP I08 UNIDADE I09 QUANTIDADE I10 VALOR UNITRIO I10a DESCONTO I17 VALOR TOTAL I11 B.CLC.ICMS N15 B.CLC.ICMS ST N21 VALOR ICMS N17 VALOR ICMS ST N23 VALOR IPI O14 ALQUOTA ICMS N16 ALQUOTA IPI O13 CLCULO DO ISSQN 0,67 INSCRIO MUNICIPAL C19 0,67 VALOR TOTAL DOS SERVIOS W18 0,67 BASE DE CLCULO DO ISSQN W19 0,67 VALOR DO ISSQN W20 0,67 DADOS ADICIONAIS 2,94 INFORMAES COMPLEMENTARES Z02 2,94 RESERVADO AO FISCO RESERVADO AO FISCO 2,94 Obs 1 Permite-se a incluso dos dados de duplicatas das TAG do grupo Y07 Obs 2 Detalhamento especficos de produtos/servios (outras TAG do grupo H) Obs 3 Total Bruto (TAG) ou Lquido (Mod.1/1-A)? Obs 4 Colunas apresentadas na ordem descrita Obs 5 TAG: C03, C04, C06, C07, C08, C09, C11, C12, C13, C16 Obs 6 TAG: B11 Obs 7 TAG: B07, B08 Obs 8 TAG: X02 Obs 9 Campo utilizado exclusivamente no Modelo de Contingncia

Obs 4 60 120 Obs 2 8 N12 I13 I14 I14a Obs 3 4 6 12 16 15 15 15 15 15 15 15 5 5 15 15 15 15 5256

0,51 6,60 6,60 6,60 6,73 0,51 19,05 7,49

2,41 2,92 9,52 16,12 22,72 2,41 2,92 21,97

17,28 17,28 17,28 17,28 17,28 17,95 17,95 17,95

U02 U04 Z03

7.9

Outros

7.9.1 Marca dgua


O formulrio poder conter marca dgua desde que no prejudique a legibilidade dos dados impressos.

7.9.2 Impresso do nmero da folha


O nmero de ordem e o nmero total de folhas devero ser impressos na parte superior de cada uma das folhas do DANFE, inclusive na primeira, mesmo que se utilize uma nica folha.

7.9.3 Limitaes da impressora


Se, no formato retrato, for necessria a utilizao de uma margem superior ou inferior maior, devido a limitaes da impressora, a reduo necessria poder ser feita somente na altura do quadro de Dados dos Produtos/Servios deslocando os campos seguintes para cima pelo valor desta reduo. Essa reduo no permitida no formato paisagem.

Pg. 86 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

7.9.4 Cdigo de Barras


permitida a impresso de cdigo de barras de informaes existentes na NF-e de interesse do emissor no quadro de informaes complementares, no rodap ou no verso do DANFE.

Pg. 87 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

8. Contingncia
As situaes de contingncia esto regradas em documento prprio, o Manual de Contingncia, devendo o contribuinte seguir as disposies do referido manual.

Pg. 88 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

9. Ambiente de Homologao / Produo


As Secretarias de Fazenda Estaduais devero manter dois ambientes para recepo de NFe. O ambinte de homologao especfico para a realizao de testes e integrao das aplicaes do contribuinte durante a fase de implementao e adequao do sistema de emisso de NF-e do contribuinte. A autorizao para emisso de NF-e no ambiente de produo fica condicionada prvia aprovao das equipes de TI e de negcios da Secretaria de Fazenda, que dever avaliar a adequao, comportamento e performance do sistema de emisso de NF-e do contribuinte interessado no ambiente de homologao.

Pg. 89 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

10. Distribuio da NF-e para o Destinatrio


Conforme previsto na clusula dcima do AJUSTE SINIEF 07/05, o emitente e o destinatrio devero manter em arquivo digital as Notas Fiscais eletrnicas pelo prazo estabelecido na legislao tributria para a guarda dos documentos fiscais, devendo ser apresentada administrao tributria, quando solicitados. O emissor da Nota Fiscal Eletrnica deve enviar o arquivo digital da NF-e para o destinatrio, seja de forma eletrnica ou por qualquer outro meio que possibilite o destinatrio ter acesso ao arquivo digital. O DANFE um Documento Auxiliar da Nota Fiscal eletrnica hbil para acobertar o trnsito de mercadorias e no substitui a Nota Fiscal eletrnica em nenhuma hiptese. Os destinatrios que no sejam credenciados para operar com a NF-e podero escriturar a NF-e com base nas informaes contidas no DANFE, que dever ser mantido para apresentao administrao tributria quando solicitado.

10.1 Processo de Distribuio


A modalidade tecnolgica de intercmbio do documento eletrnico entre o emissor e receptor deve ser acordada entre ambos, respeitando o sigilo fiscal e o padro de contedo de dados definido neste item. As formas mais comuns de troca de informaes entre as empresas no comrcio eletrnico (B2B) so: troca de mensagens em sistema especfico, baseado em WEB ou rede privativa; troca de arquivos; troca de mensagens via e-mail; disponibilizao de informaes em portais, com acesso sob demanda e autenticao de acesso.

10.2 Leiaute da Distribuio: NF-e


Dever ser disponibilizado para o destinatrio o mesmo contedo da NF-e enviada para a SEFAZ, complementada com a informao da Autorizao de Uso, na forma que segue. Schema XML: procNFe_v99.99.xsd
# XR01 XR02 XR03 XR04 Campo nfeProc versao NFe (dados) Ele Raiz A G G -

Pai XR01 XR01 XR01 -

Tipo N -

Ocor. Tam. 1-1 1-4 1-1 1-1 -

XR05 protNfe XR06 (dados)

Dec. Descrio/Observao TAG raiz 2 Dados da NF-e, inclusive com os dados da assinatura (Anexo I) Dados do Protocolo de Autorizao de Uso (item 4.2.2)

Nota: Atualmente, no credenciamento das empresas como emissor de NF-e, a SEFAZ no est
verificando a capacidade das empresas para recepo de documentos de forma eletrnica, nem a distribuio das NF-e para o destinatrio. Com a ampliao do processo de emisso de documentos eletrnicos estas implementaes previstas no Projeto sero exigidas.
Pg. 90 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo I Leiaute da NF-e


Diagrama simplificado dos grupos de informaes da NF-e

Pg. 91 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Schema XML: nfe_v99.99.xsd


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

NFe TAG raiz da NF-e A - Dados da Nota Fiscal eletrnica


# ID Campo Descrio

G
Ele

Pai Tipo

1-1
Ocorrncia tamanho Dec.

Observao TAG raiz da NF-e Observao TAG de grupo que contm as informaes da NF-e Verso do leiaute informar a chave de acesso da NFe precedida do literal NFe Regra de validao do item de detalhe da NF-e, campo de controle do Schema XML, o contribuinte no deve se preocupar com o preenchimento deste campo. Observao

1 2 3 4

A01 A02 A03 A04

infNFe versao Id pk_nitem

TAG de grupo das informaes da NF-e Verso do leiaute Identificador da TAG a ser assinada regra para que a numerao do item de detalhe da NF-e seja nica.

G A ID RC

Raiz -

N C -

1-1 1-1 1-1 1-1

1-4 2

B - Identificao da Nota Fiscal eletrnica


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

5 6

B01 B02

ide cUF

TAG de grupo das informaes de identificao da NF-e Cdigo da UF do emitente do Documento Fiscal

G E

A01 B01 N

1-1 1-1 2 Cdigo da UF do emitente do Documento Fiscal. Utilizar a Tabela do IBGE de cdigo de unidades da federao (Anexo IV - Tabela de UF, Municpio e Pas). Cdigo numrico que compe a Chave de Acesso. Nmero aleatrio gerado pelo emitente para cada NF-e para evitar acessos indevidos da NF-e. Informar a natureza da operao de que decorrer a sada ou a entrada, tais como: venda, compra, transferncia, devoluo, importao, consignao, remessa (para fins de demonstrao, de industrializao ou outra), conforme
Pg. 92 / 145

B03

cNF

Cdigo Numrico que compe a Chave de Acesso

B01

1-1

B04

natOp

Descrio da Natureza da Operao

B01

1-1

1-60

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

B05

indPag

Indicador da forma de pagamento

B01

1-1

10

B06

mod

Cdigo do Modelo do Documento Fiscal Srie do Documento Fiscal Nmero do Documento Fiscal Data de emisso do Documento Fiscal Data de Sada ou da Entrada da Mercadoria/Produto Tipo do Documento Fiscal Cdigo do Municpio de Ocorrncia do Fato Gerador

B01

1-1

11 12 13 14 15 16

B07 B08 B09 B10 B11 B12

serie nNF dEmi dSaiEnt tpNF cMunFG

E E E E E E

B01 B01 B01 B01 B01 B01

N N D D N N

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

1-3 1-9

Observao previsto na alnea 'i', inciso I, art. 19 do CONVNIO S/N, de 15 de dezembro de 1970. 0 pagamento vista; 1 pagamento prazo; 2 - outros. Utilizar o cdigo 55 para identificao da NF-e, emitida em substituio ao modelo 1 ou 1A. Srie do Documento Fiscal, informar 0 (zero) para srie nica. Nmero do Documento Fiscal. Formato AAAA-MM-DD Formato AAAA-MM-DD

1 7

16a

B12a

NFref

Informao das NF/NF-e referenciadas

B01

0-N

0-entrada / 1-sada Informar o municpio de ocorrncia do fato gerador do ICMS. Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas) Grupo com as informaes das NF/NF-e referenciadas.

Pg. 93 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao

17

B13

refNFe

Chave de acesso das NF-e referenciadas

CE

B12a

1-1

44 Utilizar esta TAG para referenciar uma Nota Fiscal Eletrnica emitida anteriormente, vinculada a NF-e atual. Esta informao ser utilizada nas hipteses previstas na legislao. (Ex.: Devoluo de Mercadorias, Substituio de NF cancelada, Complementao de NF, etc.).

18

B14

refNF

Informao das NF referenciadas

CG

B12a

1-1

Grupo com as informaes das NF referenciadas Idem a informao da TAG anterior, referenciando uma Nota Fiscal modelo 1/1A normal (a NF
Pg. 94 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

19 20 21 22 23 24 25 26

B15 B16 B17 B18 B19 B20 B21 B22

cUF AAMM CNPJ mod serie nNF tpImp tpEmis

Cdigo da UF do emitente do Documento Fiscal Ano e Ms de emisso da NF-e CNPJ do emitente Modelo do Documento Fiscal Srie do Documento Fiscal Nmero do Documento Fiscal Formato de Impresso do DANFE Forma de Emisso da NF-e

E E E E E E E E

B14 B14 B14 B14 B14 B14 B01 B01

N N C N N N N N

1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1

2 4 14 2 1-3 1-9 1 1

27

B23

cDV

Dgito Verificador da Chave de Acesso da NF-e

B01

1-1

Observao referenciada no uma NF-e). Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas) AAMM da emisso da NF Informar o CNPJ do emitente da NF Informar o cdigo do modelo do Documento fiscal: 01 modelo 01 Informar a srie do documento fiscal (informar zero se inexistente). 1 999999999 1-Retrato/ 2-Paisagem 1 Normal emisso normal; 2 Contingncia FS emisso em contingncia com impresso do DANFE em Formulrio de Segurana; 3 Contingncia SCAN emisso em contingncia no Sistema de Contingncia do Ambiente Nacional SCAN; 4 Contingncia DPEC - emisso em contingncia com envio da Declarao Prvia de Emisso em Contingncia DPEC; 5 Contingncia FS-DA - emisso em contingncia com impresso do DANFE em Formulrio de Segurana para Impresso de Documento Auxiliar de Documento Fiscal Eletrnico (FS-DA). Informar o DV da Chave de Acesso da NF-e, o DV ser calculado com a aplicao do algoritmo mdulo 11 (base 2,9) da Chave de Acesso. (vide item 5 do Manual de Integrao)
Pg. 95 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

28 29 29a

B24 B25 B26

tpAmb finNFe procEmi

Identificao do Ambiente Finalidade de emisso da NF-e Processo de emisso da NF-e

E E E

B01 B01 B01

N N N

1-1 1-1 1-1

1 1 1

29b

B27

verProc

Verso do Processo de emisso da NF-e

B01

1-1

1-20

Observao 1-Produo/ 2-Homologao 1- NF-e normal/ 2-NF-e complementar / 3 NF-e de ajuste Identificador do processo de emisso da NF-e: 0 - emisso de NF-e com aplicativo do contribuinte; 1 - emisso de NF-e avulsa pelo Fisco; 2 - emisso de NF-e avulsa, pelo contribuinte com seu certificado digital, atravs do site do Fisco; 3- emisso NF-e pelo contribuinte com aplicativo fornecido pelo Fisco. Identificador da verso do processo de emisso (informar a verso do aplicativo emissor de NF-e). Observao Grupo com as informaes do emitente da NF-e Informar o CNPJ do emitente. Em se tratando de emisso de NF-e avulsa pelo Fisco, as informaes do remente sero informadas neste grupo. O CNPJ ou CPF devero ser informados com os zeros no significativos.

C - Identificao do Emitente da Nota Fiscal eletrnica


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

30 31 31a

C01 C02 C02a

emit CNPJ CPF

TAG de grupo de identificao do emitente da NF-e CNPJ do emitente CPF do remetente

G CE CE

A01 C01 C01 C C

1-1 1-1 1-1 14 11

32

C03

xNome

Razo Social ou Nome do

C01

1-1

2-60

Pg. 96 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao

33 34 35 36 37 38 39

C04 C05 C06 C07 C08 C09 C10

xFant enderEmit xLgr nro xCpl xBairro cMun

emitente Nome fantasia TAG de grupo do Endereo do emitente Logradouro Nmero Complemento Bairro Cdigo do municpio

E G E E E E E

C01 C01 C05 C05 C05 C05 C05

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

1-60

C C C C N

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

40 41 42 43 44 45 46

C11 C12 C13 C14 C15 C16 C17

xMun UF CEP cPais xPais fone IE

Nome do municpio Sigla da UF Cdigo do CEP Cdigo do Pas Nome do Pas Telefone IE

E E E E E E E

C05 C05 C05 C05 C05 C05 C01

C C N N C N C

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

2-60 2 8 4 1-60 1-10 0-14

Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas). Informar 9999999 para operaes com o exterior. Informar EXTERIOR para operaes com o exterior. Informar EX para operaes com o exterior. Informar os zeros no significativos. 1058 - Brasil Brasil ou BRASIL

Preencher com Cdigo DDD + nmero do telefone.


Campo de informao obrigatria nos casos de emisso prpria (procEmi = 0, 2 ou 3). A IE deve ser informada apenas com algarismos para destinatrios contribuintes do ICMS, sem caracteres de formatao (ponto, barra, hfen, etc.); O literal ISENTO deve ser informado apenas para contribuintes do ICMS que so isentos de inscrio no cadastro de contribuintes do ICMS e estejam emitindo NF-e avulsa;

Pg. 97 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

47

C18

IEST

IE do Substituto Tributrio

C01

0-1

2-14

48

C19

IM

Inscrio Municipal

C01

0-1

1-15

49

C20

CNAE

CNAE fiscal

C01

0-1

Observao Informar a IE do ST da UF de destino da mercadoria, quando houver a reteno do ICMS ST para a UF de destino. Este campo deve ser informado, quando ocorrer a emisso de NF-e conjugada, com prestao de servios sujeitos ao ISSQN e fornecimento de peas sujeitos ao ICMS. Este campo deve ser informado quando o campo IM (C19) for informado. Observao Informaes do fisco emitente, grupo de uso exclusivo do fisco. Informar os zeros no significativos.

D - Identificao do Fisco Emitente da NF-e


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

50 51 52 53 54 55 56 57

D01 D02 D03 D04 D05 D06 D07 D08

avulsa CNPJ xOrgao matr xAgente fone UF nDAR CNPJ do rgo emitente rgo emitente Matrcula do agente Nome do agente Telefone E E E E E E E E E

A01 D01 D01 D01 D01 D01 D01 D01 D01 D01 C C C C N C C D N

0-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 14 1-60 1-60 1-60 1-10 2 1-60 1-15 2

Preencher com Cdigo DDD + nmero do telefone

Sigla da UF Nmero do Documento de Arrecadao de Receita 58 D09 dEmi Data de emisso do Documento de Arrecadao 59 D10 vDAR Valor Total constante no Documento de arrecadao de Receita 60 D11 repEmi Repartio Fiscal emitente 61 D12 dPag Data de pagamento do Documento de Arrecadao E - Identificao do Destinatrio da Nota Fiscal eletrnica

Formato AAAA-MM-DD

E E

D01 D01

C D

1-1 0-1

1-60 -

Formato AAAA-MM-DD

Pg. 98 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
# #

ID ID

Campo Campo

Descrio Descrio

Ele Ele

Pai Pai

Tipo Tipo

Ocorrncia Ocorrncia

tamanho tamanho

Dec. Dec

62 63

E01 E02

dest CNPJ

TAG de grupo de identificao do Destinatrio da NF-e CNPJ do destinatrio

G CE

A01 E01 C

1-1 1-1 0 ou14

64

E03

CPF

CPF do destinatrio

CE

E01

1-1

11

Observao Observao Grupo com as informaes do destinatrio da NF-e. Informar o CNPJ ou o CPF do destinatrio, preenchendo os zeros no significativos. No informar o contedo da TAG se a operao for realizada com o exterior.

65 66 67 68 69 70 71

E04 E05 E06 E07 E08 E09 E10

xNome enderDest xLgr nro xCpl xBairro cMun

Razo Social ou nome do destinatrio TAG de grupo de endereo do Destinatrio da NF-e Logradouro Nmero Complemento Bairro Cdigo do municpio

E G E E E E E

E01 E01 E05 E05 E05 E05 E05

1-1 1-1

2-60

C C C C N

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

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

72 73 74 75

E11 E12 E13 E14

xMun UF CEP cPais

Nome do municpio Sigla da UF Cdigo do CEP Cdigo do Pas

E E E E

E05 E05 E05 E05

C C N N

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

2-60 2 8 1-4

Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas). Informar 9999999 para operaes com o exterior. Informar EXTERIOR para operaes com o exterior. Informar EX para operaes com o exterior. Informar os zeros no significativos. Utilizar a Tabela do BACEN (Anexo IV - Tabela de UF, Municpio e Pas).
Pg. 99 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao

76 77 78

E15 E16 E17

xPais fone IE

Nome do Pas Telefone IE

E E E

E05 E05 E01

C N C

0-1 0-1 1-1

2-60 1-10 0,2-14

Preencher com Cdigo DDD + nmero do telefone


Informar a IE quando o destinatrio for contribuinto do ICMS. Informar ISENTO quando o destinatrio for contribuinto do ICMS, mas no estiver obrigado inscrio no cadastro de contribuintes do ICMS. No informar o contedo da TAG se o destinatrio no for contribuinte do ICMS. Esta tag aceita apenas: . ausncia de contedo (<IE></IE> ou <IE/>) para destinatrios no contribuintes do ICMS; . algarismos para destinatrios contribuintes do ICMS, sem caracteres de formatao (ponto, barra, hfen, etc.); . literal ISENTO para destinatrios contribuintes do ICMS que so isentos de inscrio no cadastro de contribuintes do ICMS; Obrigatrio, nas operaes que se beneficiam de incentivos fiscais existentes nas reas sob controle da SUFRAMA. A omisso da Inscrio SUFRAMA impede o processamento da operao pelo Sistema de Mercadoria Nacional da SUFRAMA e a liberao da Declarao de Ingresso, prejudicando a
Pg. 100 / 145

79

E18

ISUF

Inscrio na SUFRAMA

E01

0-1

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao comprovao do ingresso/internamento da mercadoria nas reas sob controle da SUFRAMA. Observao Informar apenas quando for diferente do endereo do remetente. Informar os zeros no significativos.

F - Identificao do Local de Retirada


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

80

F01

retirada

TAG de grupo de identificao do Local de retirada CNPJ Logradouro Nmero Complemento Bairro Cdigo do municpio

A01

0-1

81 82 83 84 85 86

F02 F03 F04 F05 F06 F07

CNPJ xLgr nro xCpl xBairro cMun

E E E E E E

F01 F01 F01 F01 F01 F01

C C C C C N

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

14 2-60 1-60 1-60 1-60 1-7

87 88

F08 F09

xMun UF

Nome do municpio Sigla da UF

E E

F01 F01

C C

1-1 1-1

2-60 2

Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas). Informar 9999999 para operaes com o exterior. Informar EXTERIOR para operaes com o exterior. Informar EX para operaes com o exterior.
Dec

G - Identificao do Local de Entrega


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho

89

G01

entrega

TAG de grupo de identificao do Local de entrega CNPJ Logradouro Nmero Complemento Bairro Cdigo do municpio

A01

0-1

90 91 92 93 94 95

G02 G03 G04 G05 G06 G07

CNPJ xLgr nro xCpl xBairro cMun

E E E E E E

G01 G01 G01 G01 G01 G01

C C C C C N

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

14 2-60 1-60 1-60 1-60 1-7

Observao Informar apenas quando for diferente do endereo do destinatrio. Informar os zeros no significativos.

Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas). Informar 9999999 para operaes

Pg. 101 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

96 97

G08 G09

xMun UF

Nome do municpio Sigla da UF

E E

G01 G01

C C

1-1 1-1

2-60 2

Observao com o exterior. Informar EXTERIOR para operaes com o exterior. Informar EX para operaes com o exterior. Observao Mltiplas ocorrncias (mximo = 990) Nmero do item (1-990) Observao

H - Detalhamento de Produtos e Servios da NF-e


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

98

H01

det

99 H02 nItem I - Produtos e Servios da NF-e


# ID Campo

TAG de grupo do detalhamento de Produtos e Servios da NF-e Nmero do item


Descrio

G A
Ele

A01 N
Pai Tipo

1-990 1-1
Ocorrncia

1-3
tamanho Dec

100 101

I01 I02

prod cProd

TAG de grupo do detalhamento de Produtos e Servios da NF-e Cdigo do produto ou servio

G E

H01 I01 C

1-1 1-1 1-60 Preencher com CFOP, caso se trate de itens no relacionados com mercadorias/produto e que o contribuinte no possua codificao prpria. Formato CFOP9999 Preencher com o cdigo GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 (antigos cdigos EAN, UPC e DUN14), no informar o contedo da TAG em caso de o produto no possuir este cdigo. Preencher de acordo com a Tabela de Captulos da NCM. Em caso de servio, no incluir a TAG. Preencher de acordo com o cdigo EX da TIPI. Em caso de servio, no incluir a TAG. Gnero do produto ou servio. Preencher de acordo com a Tabela de Captulos da NCM. Em caso de
Pg. 102 / 145

102

I03

cEAN

GTIN (Global Trade Item Number) do produto, antigo cdigo EAN ou cdigo de barras

I01

1-1

0,8,12 ,13,14

103 104

I04 I05

xProd NCM

Descrio do produto ou servio Cdigo NCM

E E

I01 I01

C C

1-1 0-1

1-120 8

105

I06

EXTIPI

EX_TIPI

I01

0-1

2-3

106

I07

genero

Gnero do Produto ou Servio

I01

0-1

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

107 108 109 109a 110 111

I08 I09 I10 I10a I11 I12

CFOP uCom qCom vUnCom vProd cEANTrib

Cdigo Fiscal de Operaes e Prestaes Unidade Comercial Quantidade Comercial Valor Unitrio de comercializao Valor Total Bruto dos Produtos ou Servios GTIN (Global Trade Item Number) da unidade tributvel, antigo cdigo EAN ou cdigo de barras

E E E E E E

I01 I01 I01 I01 I01 I01

N C N N N C

1-1 1-1 1-1 1-1 1-1 1-1

4 1-6 12 16 15 0,8,12 ,13,14 4 4 2

Observao servio, no incluir a TAG. Utilizar Tabela de CFOP. Informar a unidade de comercializao do produto. Informar a quantidade de comercializao do produto. Informar o valor unitrio de comercializao do produto

Preencher com o cdigo GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 (antigos cdigos EAN, UPC e DUN14) da unidade tributvel do produto, no informar o contedo da TAG em caso de o produto no possuir este cdigo. 4 4 2 2 2 Informar dados da importao

112 113 113a 114 115 116 117 118

I13 I14 I14a I15 I16 I17 I18 I19

uTrib qTrib vUnTrib vFrete vSeg vDesc DI nDI

Unidade Tributvel Quantidade Tributvel Valor Unitrio de tributao Valor Total do Frete Valor Total do Seguro Valor do Desconto Tag da Declarao de Importao Nmero do Documento de Importao DI/DSI/DA (DI/DSI/DA) Data de Registro da DI/DSI/DA Local de desembarao Sigla da UF onde ocorreu o Desembarao Aduaneiro Data do Desembarao Aduaneiro Cdigo do exportador

E E E E E E G E

I01 I01 I01 I01 I01 I01 I01 I18

C N N N N N C

1-1 1-1 1-1 0-1 0-1 0-1 0-N 1-1

1-6 12 16 15 15 15 1-10

Informar o valor unitrio de tributao do produto

119 120 121 122 123

I20 I21 I22 I23 I24

dDi xLocDesemb UFDesemb dDesemb cExportador

E E E E E

I18 I18 I18 I18 I18

D C C D C

1-1 1-1 1-1 1-1 1-1

Formato AAAA-MM-DD 1-60 2 Formato AAAA-MM-DD Cdigo do exportador, usado nos

1-60

Pg. 103 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao sistemas internos de informao do emitente da NF-e

124 125 126 127

I25 I26 I27 I28

adi nAdicao nSeqAdic cFabricante

Adies Numero da adio Numero seqencial do item dentro da adio Cdigo do fabricante estrangeiro

G E E E

I18 I25 I25 I25

N N C

1-N 1-1 1-1 1-1

1-3 1-3 1-60 Cdigo do fabricante estrangeiro, usado nos sistemas internos de informao do emitente da NF-e 2

Valor do desconto do item da DI adio J - Detalhamento Especfico de Veculos novos


# ID Campo Descrio

128

I29

vDescDI

I25

0-1

15

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec

129 130

J01 J02

veicProd tpOp

TAG de grupo do detalhamento de Veculos novos Tipo da operao

CG E

I01 J01 N

0-1 1-1 1

Observao Informar apenas quando se tratar de veculos novos 1 Venda concessionria, 2 Faturamento direto 3 Venda direta 0 Outros Cdigo de cada montadora

131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146

J03 J04 J05 J06 J07 J08 J09 J10 J11 J12 J13 J14 J15 J16 J17 J18

chassi cCor xCor pot CM3 pesoL pesoB nSerie tpComb nMotor CMKG dist RENAVAM anoMod anoFab tpPint

Chassi do veculo Cor Descrio da Cor Potncia Motor CM3 (Potncia) Peso Lquido Peso Bruto Serial (srie) Tipo de combustvel Nmero de Motor CMKG Distncia entre eixos RENAVAM Ano Modelo de Fabricao Ano de Fabricao Tipo de Pintura

E E E E E E E E E E E E E E E E

J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01 J01

C C C C C C C C C C C C C N N C

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

17 4 40 4 4 9 9 9 8 21 9 4 9 4 4 1

No informar a TAG na exportao.

Pg. 104 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

147 148 149 150

I19 J20 J21 J22

tpVeic espVeic VIN condVeic

Tipo de Veculo Espcie de Veculo Condio do VIN Condio do Veculo

E E E E

J01 J01 J01 J01

N
C N

1-1 1-1 1-1 1-1

2 1 1 1

151 J23 cMod Cdigo Marca Modelo K - Detalhamento Especfico de Medicamento


# ID Campo Descrio

E
Ele

J01
Pai

N
Tipo

1-1
Ocorrncia

6
tamanho Dec

Observao Utilizar Tabela RENAVAM Utilizar Tabela RENAVAM VIN (Vehicle Identification Number) 1-Acabado; 2-Inacabado; 3-Semi-acabado Utilizar Tabela RENAVAM Observao Informar apenas quando se tratar de medicamentos, permite mltiplas ocorrncias (ilimitado)

152

K01

med

TAG de grupo do detalhamento de Medicamentos

CG

I01

0-N

Nmero do Lote do medicamento Quantidade de produto no Lote do medicamento 155 K04 dFab Data de fabricao 156 K05 dVal Data de validade 157 K06 vPMC Preo mximo consumidor L - Detalhamento Especfico de Armamentos
# ID Campo Descrio

153 154

K02 K03

nLote qLote

E E E E E
Ele

K01 K01 K01 K01 K01


Pai

C N D D N
Tipo

1-1 1-1 1-1 1-1 1-1


Ocorrncia

20 11

3 Formato AAAA-MM-DD Formato AAAA-MM-DD

15
tamanho

2
Dec

158

L01

arma

TAG de grupo do detalhamento de Armamento Indicador do tipo de arma de fogo

CG

I01

0-N

159 160 161 162

L02 L03 L04 L05

tpArma nSerie nCano descr

E E E E

L01 L01 L01 L01

N N N C

1-1 1-1 1-1 1-1

1 1-9 1-9

Observao Informar apenas quando se tratar de armamento, permite mltiplas ocorrncias (ilimitado) 0 - Uso permitido; 1 - Uso restrito;

Nmero de srie da arma Nmero de srie do cano Descrio completa da arma, compreendendo: calibre, marca, capacidade, tipo de funcionamento, comprimento e demais elementos que permitam a sua perfeita identificao. L1 - Detalhamento Especfico de Combustveis
# ID Campo Descrio

1-256

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec

Observao
Pg. 105 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

162a

L101

comb

162b

L102

cProdANP

TAG de grupo de informaes especficas para combustveis lquidos Cdigo de produto da ANP

I01

0-1

Observao Informar apenas para operaes com combustveis lquidos. Informar apenas quando se tratar de produtos regulados pela ANP Agncia Nacional do Petrleo. Utilizar a codificao de produtos do Sistema de Informaes de Movimentao de produtos - SIMP (http://www.anp.gov.br/simp/index.h tm) Informar apenas quando a UF utilizar o CODIF (Sistema de Controle do Diferimento do Imposto nas Operaes com AEAC - lcool Etlico Anidro Combustvel). Informar quando a quantidade faturada informada no campo qCom (I10) tiver sido ajustada para uma temperatura diferente da ambiente. Grupo de informaes da CIDE Informar a BC da CIDE em quantidade Informar o valor da alquota em reais da CIDE Informar o valor da CIDE Grupo de informaes do ICMS prprio e ST retido para o produto, informar em todas as operaes com combustveis lquidos. Informar a BC do ICMS da operao prpria Informar o valor do ICMS da operao prpria Informar a BC do ICMS ST retido
Pg. 106 / 145

CE

L101

1-1

162c

L103

CODIF

Cdigo de autorizao / registro do CODIF

L101

0-1

0-21

162d

L104

qTemp

Quantidade de combustvel faturada temperatura ambiente.

L101

0-1

16

162e 162f 162g


162h

L105 L106 L107 L108 L109

CIDE qBCprod vAliqProd vCIDE ICMSComb

TAG de grupo da CIDE BC da CIDE Valor da alquota da CIDE Valor da CIDE TAG de grupo do ICMSComb

G E E E G

L101 L105 L105 L105 L101

N N N N N

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

16 15 15

4 4 2

162i

162j 162k 162l

L110 L111 L112

vBCICMS vICMS vBCICMSST

BC do ICMS Valor do ICMS BC do ICMS ST retido

E E E

L109 L109 L109

N N N

1-1 1-1 1-1

15 15 15

2 2 2

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

162m

162n

L113 L114

vICMSST ICMSInter

Valor do ICMS ST retido TAG de grupo do ICMSST operao interestadual

de

E G

L109 L101

N N

1-1 0-1

15

162o 162p 162q

L115 L116 L117

vBCICMSSTD est vICMSSTDest ICMSCons

BC do ICMS ST da UF de destino Valor do ICMS ST da UF de destino TAG de ICMS para consumo em UF diversa da UF de localizao do destinatrio do produto

E E G

L114 L114 L101

N N N

1-1 1-1 0-1

15 15

2 2

BC do ICMS ST da UF de consumo 162s L119 Valor do ICMS ST da UF de consumo 162t L120 UFcons Sigla da UF de consumo M - Tributos incidentes no Produto ou Servio
# ID Campo Descrio

162r

L118

vBCICMSSTC ons vICMSSTCons

E E E
Ele

L117 L117 L117


Pai

N N N
Tipo

1-1 1-1 1-1


Ocorrncia

15 15 2
tamanho

2 2

Observao Informar o valor do ICMS ST retido Grupo de informao do ICMSST devido para a UF de destino, nas operaes interestaduais de produtos que tiveram reteno antecipada de ICMS por ST para a UF do remetente Informar a BC do ICMS ST da UF de destino. Informar o valor do ICMS da UF de destino. Grupo para informar quando o produto for adquirido para consumo em UF diversa da UF de localizao do estabelecimento do destinatrio da nota fiscal Informar a BC do ICMS ST da UF de consumo Informar o valor do ICMS da UF de consumo Informar a UF de consumo Observao

Dec

163

M01

imposto

TAG de grupo de Tributos incidentes no Produto ou Servio


Descrio

H01

1-1

N - ICMS Normal e ST
# ID Campo Ele Pai Tipo Ocorrncia tamanho Dec

164

N01

ICMS

TAG de grupo do ICMS da Operao prpria e ST

M01

1-1

Observao Informar apenas um dos grupos N02, N03, N04, N05, N06, N07, N08, N09 ou N10, com base no contedo informado na TAG CST

Pg. 107 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao

165 166

N02 N11

ICMS00 orig

TAG de grupo do CST = 00 Origem da mercadoria

CG E

N01 N02

1-1 1-1

167 168

N12 N13

CST modBC

Tributao do ICMS Modalidade de determinao da BC do ICMS

E E

N02 N02

N N

1-1 1-1

2 1

CST 00 Tributada integralmente Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao do ICMS: 00 Tributada integralmente. 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao. 2 2 2 CST - 10 - Tributada e com
Pg. 108 / 145

169 170 171 172

N15 N16 N17 N03

vBC pICMS vICMS ICMS10

Valor da BC do ICMS Alquota do imposto Valor do ICMS TAG de grupo do CST = 10

E E E CG

N02 N02 N02 N01

N N N

1-1 1-1 1-1 1-1

15 5 15

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

173

N11

orig

Origem da mercadoria

N03

1-1

174

N12

CST

Tributao do ICMS

N03

1-1

175

N13

modBC

Modalidade de determinao da BC do ICMS

N03

1-1

Observao cobrana do ICMS por substituio tributria Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 10 - Tributada e com cobrana do ICMS por substituio tributria 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao.

176 177 178 179

N15 N16 N17 N18

vBC pICMS vICMS modBCST

Valor da BC do ICMS Alquota do imposto Valor do ICMS Modalidade de determinao da BC do ICMS ST

E E E E

N03 N03 N03 N03

N N N N

1-1 1-1 1-1 1-1

15 5 15 1

2 2 2 0 Preo tabelado ou mximo sugerido; 1 - Lista Negativa (valor); 2 - Lista Positiva (valor); 3 - Lista Neutra (valor); 4 - Margem Valor Agregado (%); 5 - Pauta (valor); 2 2 2 2 2

180 181 182 183 184 185 186

N19 N20 N21 N22 N23 N04 N11

pMVAST pRedBCST vBCST pICMSST vICMSST ICMS20 orig

Percentual da margem de valor Adicionado do ICMS ST Percentual da Reduo de BC do ICMS ST Valor da BC do ICMS ST Alquota do imposto do ICMS ST Valor do ICMS ST TAG de grupo do CST = 20 Origem da mercadoria

E E E E E CG E

N03 N03 N03 N03 N03 N01 N04

N N N N N

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

5 5 15 5 15

Valor do ICMS ST retido CST 20 - Com reduo de base de clculo Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta;
Pg. 109 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

187

N12

CST

Tributao do ICMS

N04

1-1

188

N13

modBC

Modalidade de determinao da BC do ICMS

N04

1-1

Observao 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 20 - Com reduo de base de clculo 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao.

189 190 191 192 193

N14 N15 N16 N17 N05

pRedBC vBC pICMS vICMS ICMS30

Percentual da Reduo de BC Valor da BC do ICMS Alquota do imposto Valor do ICMS TAG de grupo do CST = 30

E E E E CG

N04 N04 N04 N04 N01

N N N N

1-1 1-1 1-1 1-1 1-1

5 15 5 15

2 2 2 2 CST 30 - Isenta ou no tributada e com cobrana do ICMS por substituio tributria Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 30 - Isenta ou no tributada e com cobrana do ICMS por substituio tributria 0 Preo tabelado ou mximo sugerido; 1 - Lista Negativa (valor); 2 - Lista Positiva (valor); 3 - Lista Neutra (valor); 4 - Margem Valor Agregado (%); 5 - Pauta (valor); 2 2

194

N11

orig

Origem da mercadoria

N05

1-1

195

N12

CST

Tributao do ICMS

N05

1-1

196

N18

modBCST

Modalidade de determinao da BC do ICMS ST

N05

1-1

197 198

N19 N20

pMVAST pRedBCST

Percentual da margem de valor Adicionado do ICMS ST Percentual da Reduo de BC do ICMS ST

E E

N05 N05

N N

0-1 0-1

5 5

Pg. 110 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao

199 200 201 202

N21 N22 N23 N06

vBCST pICMSST vICMSST ICMS40

Valor da BC do ICMS ST Alquota do imposto do ICMS ST Valor do ICMS ST TAG de grupo do CST = 40, 41 ou 50 Origem da mercadoria

E E E CG

N05 N05 N05 N01

N N N

1-1 1-1 1-1 1-1

15 5 15

2 2 2

203

N11

orig

N06

1-1

204

N12

CST

Tributao do ICMS

N06

1-1

205

N07

ICMS51

TAG de grupo do CST = 51

CG

N01

1-1

206

N11

orig

Origem da mercadoria

N07

1-1

207 208

N12 N13

CST modBC

Tributao do ICMS Modalidade de determinao da BC do ICMS

E E

N07 N07

N N

1-1 0-1

2 1

Valor do ICMS ST retido CST 40 - Isenta 41 - No tributada 50 - Suspenso Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 40 - Isenta 41 - No tributada 50 - Suspenso CST 51 - Diferimento A exigncia do preenchimento das informaes do ICMS diferido fica critrio de cada UF. Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 51 - Diferimento 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao.

209 210 211 212 213

N14 N15 N16 N17 N08

pRedBC vBC pICMS vICMS ICMS60

Percentual da Reduo de BC Valor da BC do ICMS Alquota do imposto Valor do ICMS TAG de grupo do CST = 60

E E E E CG

N07 N07 N07 N07 N01

N N N N

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

5 15 5 15

2 2 2 2 CST 60 - ICMS cobrado anteriormente por substituio


Pg. 111 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

214

N11

orig

Origem da mercadoria

N08

1-1

215

N12

CST

Tributao do ICMS

N08

1-1

216 217 218

N21 N23 N09

vBCST vICMSST ICMS70

Valor da BC do ICMS ST Valor do ICMS ST TAG de grupo do CST = 70

E E CG

N08 N08 N01

N N

1-1 1-1 1-1

15 15

2 2

219

N11

orig

Origem da mercadoria

N09

1-1

220

N12

CST

Tributao do ICMS

N09

1-1

221

N13

modBC

Modalidade de determinao da BC do ICMS

N09

1-1

Observao tributria Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 60 - ICMS cobrado anteriormente por substituio tributria Valor da BC do ICMS ST cobrado anteriormente por ST Valor do ICMS ST cobrado anteriormente por ST CST - 70 - Com reduo de base de clculo e cobrana do ICMS por substituio tributria Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 70 - Com reduo de base de clculo e cobrana do ICMS por substituio tributria ICMS por substituio tributria 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao.

222 223 224 225 226

N14 N15 N16 N17 N18

pRedBC vBC pICMS vICMS modBCST

Percentual da Reduo de BC Valor da BC do ICMS Alquota do imposto Valor do ICMS Modalidade de determinao da BC do ICMS ST

E E E E E

N09 N09 N09 N09 N09

N N N N N

1-1 1-1 1-1 1-1 1-1

5 15 5 15 1

2 2 2 2 0 Preo tabelado ou mximo sugerido;


Pg. 112 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec.

Observao 1 - Lista Negativa (valor); 2 - Lista Positiva (valor); 3 - Lista Neutra (valor); 4 - Margem Valor Agregado (%); 5 - Pauta (valor);

227 228 229 230 231 232 233

N19 N20 N21 N22 N23 N10 N11

pMVAST pRedBCST vBCST pICMSST vICMSST ICMS90 orig

Percentual da margem de valor Adicionado do ICMS ST Percentual da Reduo de BC do ICMS ST Valor da BC do ICMS ST Alquota do imposto do ICMS ST Valor do ICMS ST TAG de grupo do CST = 90 Origem da mercadoria

E E E E E CG E

N09 N09 N09 N09 N09 N01 N10

N N N N N N

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

5 5 15 5 15 1

2 2 2 2 2

234 235

N12 N13

CST modBC

Tributao do ICMS Modalidade de determinao da BC do ICMS

E E

N10 N10

N N

1-1 1-1

2 1

Valor do ICMS ST retido CST - 90 Outros Origem da mercadoria: 0 Nacional; 1 Estrangeira Importao direta; 2 Estrangeira Adquirida no mercado interno. Tributao pelo ICMS 90 - Outros 0 - Margem Valor Agregado (%); 1 - Pauta (Valor); 2 - Preo Tabelado Mx. (valor); 3 - valor da operao.

236 237 238 239 240

N15 N14 N16 N17 N18

vBC pRedBC pICMS vICMS modBCST

Valor da BC do ICMS Percentual da Reduo de BC Alquota do imposto Valor do ICMS Modalidade de determinao da BC do ICMS ST

E E E E E

N10 N10 N10 N10 N10

N N N N N

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

15 5 5 15 1

2 2 2 2 0 Preo tabelado ou mximo sugerido; 1 - Lista Negativa (valor); 2 - Lista Positiva (valor); 3 - Lista Neutra (valor); 4 - Margem Valor Agregado (%); 5 - Pauta (valor);

Pg. 113 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Percentual da margem de valor Adicionado do ICMS ST 242 N20 pRedBCST Percentual da Reduo de BC do ICMS ST 243 N21 vBCST Valor da BC do ICMS ST 244 N22 pICMSST Alquota do imposto do ICMS ST 245 N23 vICMSST Valor do ICMS ST O - Imposto sobre Produtos Industrializados
# ID Campo Descrio

241

N19

pMVAST

E E E E E
Ele

N10 N10 N10 N10 N10


Pai

N N N N N
Tipo

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


Ocorrncia

5 5 15 5 15
tamanho

2 2 2 2 2
Dec

Valor do ICMS ST retido Observao Informar apenas quando o item for sujeito ao IPI Preenchimento conforme Atos Normativos editados pela Receita Federal (Observao 4) Informar os zeros no significativos

246 247

O01 O02

IPI clEnq

TAG de grupo do IPI Classe de enquadramento do IPI para Cigarros e Bebidas CNPJ do produtor da mercadoria, quando diferente do emitente. Somente para os casos de exportao direta ou indireta. Cdigo do selo de controle IPI

G E

M01 O01 C

0-1 0-1 5

248

O03

CNPJProd

O01

0-1

14

249

O04

cSelo

O01

0-1

1-60
1-12 3

Preenchimento conforme Atos Normativos editados pela Receita Federal (Observao 3) Tabela a ser criada pela RFB, informar 999 enquanto a tabela no for criada Informar apenas um dos grupos O07 ou O08 com base valor atribudo ao campo O09 CST do IPI

250 251

O05 O06

qSelo cEnq

Quantidade de selo de controle Cdigo de Enquadramento Legal do IPI TAG de grupo do CST 00, 49, 50 e 99

E E

O01 O01

N C

0-1 1-1

252

O07

IPITrib

CG

O01

1-1

Pg. 114 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

253

O09

CST

Cdigo da situao tributria do IPI

O07

1-1

254 255

O10 O11

vBC qUnid

256 257

O12 O13

vUnid pIPI

Valor da BC do IPI Quantidade total na unidade padro para tributao (somente para os produtos tributados por unidade) Valor por Unidade Tributvel Alquota do IPI

CE CE

O07 O07

N N

1-1 1-1

15 16

2 4

00-Entrada com recuperao de crdito 49-Outras entradas 50-Sada tributada 99-Outras sadas Informar os campos O10 e O14 caso o clculo do IPI seja por alquota ou os campos O11 e O12 caso o clculo do IPI seja valor por unidade.

CE CE

O07 O07

N N

1-1 1-1

15 5

4 2

Pg. 115 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

259 260 261

O14 O08 O09

vIPI IPINT CST

Valor do IPI TAG de grupo do CST 01, 02, 03, 04, 51, 52, 53, 54 e 55 Cdigo da situao tributria do IPI

E CG E

O07 O01 O08

1-1 1-1 1-1

15

01-Entrada tributada com alquota zero 02-Entrada isenta 03-Entrada no-tributada 04-Entrada imune 05-Entrada com suspenso 51-Sada tributada com alquota zero 52-Sada isenta 53-Sada no-tributada 54-Sada imune 55-Sada com suspenso
Dec

P - Imposto de Importao
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho

262 263 264

P01 P02 P03

II vBC vDespAdu

TAG de grupo do Imposto de Importao Valor da BC do Imposto de Importao Valor das despesas aduaneiras

G E E

M01 P01 P01 N N

0-1 1-1 1-1 15 15 2 2

Observao Informar apenas quando o item for sujeito ao II

Pg. 116 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

265 266

P04 P05

vII vIOF

Valor do Imposto de Importao Valor do Imposto sobre Operaes Financeiras

E E

P01 P01

N N

1-1 1-1

15 15

2 2

Q PIS
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

267

Q01

PIS

TAG de grupo do PIS

M01

1-1

Observao Informar apenas um dos grupos Q02, Q03, Q04 ou Q05 com base valor atribudo ao campo Q06 CST do PIS

268

Q02

PISAliq

TAG do grupo de PIS tributado

CG

Q01

1-1

CST = 01 e 02

Pg. 117 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

269

Q06

CST

pela alquota Cdigo de Situao Tributria do PIS

Q02

1-1

01 Operao Tributvel (base de clculo = valor da operao alquota normal (cumulativo/no cumulativo)); 02 - Operao Tributvel (base de clculo = valor da operao (alquota diferenciada)); 2 2 2 CST = 03

270 271 272 273 274

Q07 Q08 Q09 Q03 Q06

vBC pPIS vPIS PISQtde CST

Valor da Base de Clculo do PIS Alquota do PIS (em percentual) Valor do PIS TAG do grupo de PIS tributado por Qtde Cdigo de Situao Tributria do PIS Quantidade Vendida Alquota do PIS (em reais) Valor do PIS TAG do grupo de PIS no tributado Cdigo de Situao Tributria do PIS

E E E CG E

Q02 Q02 Q02 Q01 Q03

N N N

1-1 1-1 1-1 1-1 1-1

15 5 15

03 - Operao Tributvel (base de clculo = quantidade vendida x alquota por unidade de produto); 4 4 2 CST = 04, 06, 07, 08 ou 09

275 276 277 278 279

Q10 Q11 Q09 Q04 Q02

qBCProd vAliqProd vPIS PISNT CST

E E E CG E

Q03 Q03 Q03 Q01 Q04

N N N

1-1 1-1 1-1 1-1 1-1

16 15 15

280 281 282

Q05 Q06 Q07

PISOutr CST vBC

TAG do grupo de PIS Outras Operaes Cdigo de Situao Tributria do PIS Valor da Base de Clculo do PIS

CG E CE

Q01 Q05 Q05 N N

1-1 1-1 1-1 2 15 2

04 - Operao Tributvel (tributao monofsica (alquota zero)); 06 - Operao Tributvel (alquota zero); 07 - Operao Isenta da Contribuio; 08 - Operao Sem Incidncia da Contribuio; 09 - Operao com Suspenso da Contribuio; CST = 99 99 - Outras Operaes; Informar campos para clculo do
Pg. 118 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

283 284 285

Q08 Q10 Q11

pPIS qBCProd vAliqProd

Alquota do PIS (em percentual) Quantidade Vendida Alquota do PIS (em reais)

CE CE CE

Q05 Q05 Q05

N N N

1-1 1-1 1-1

5 16 15

2 4 4

PIS em percentual (P07 e P08) ou campos para PIS em valor (P10 e P11).

286 Q09 R PIS ST


# ID

vPIS
Campo

Valor do PIS
Descrio

E
Ele

Q05
Pai

N
Tipo

1-1
Ocorrncia

15
tamanho

2
Dec

Observao

287 288 289 290 291

R01 R02 R03 R04 R05

PISST vBC pPIS qBCProd vAliqProd

TAG do grupo de PIS Substituio Tributria Valor da Base de Clculo do PIS Alquota do PIS (em percentual) Quantidade Vendida Alquota do PIS (em reais)

G CE CE CE CE

M01 R01 R01 R01 R01 N N N N

0-1 1-1 1-1 1-1 1-1 15 5 16 15 2 2 4 4 Informar campos para clculo do PIS em percentual (R02 e R03) ou campos para PIS em valor (R04 e R05).

292 R06 S COFINS

vPIS

Valor do PIS

R01

1-1

15

Pg. 119 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec

293

S01

COFINS

TAG de grupo do COFINS

M01

1-1

Observao Informar apenas um dos grupos S02, S03, S04 ou S04 com base valor atribudo ao campo S06 CST do COFINS

294 295

S02 S06

COFINSAliq CST

TAG do grupo de COFINS tributado pela alquota Cdigo de Situao Tributria do COFINS

CG E

S01 S02 N

1-1 1-1 2

CST = 01 ou 02 01 Operao Tributvel (base de clculo = valor da operao alquota normal (cumulativo/no cumulativo)); 02 - Operao Tributvel (base de
Pg. 120 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

clculo = valor da operao (alquota diferenciada)); 296 297 298 299 300 S07 S08 S11 S03 S06 vBC pCOFINS vCOFINS COFINSQtde CST Valor da Base de Clculo da COFINS Alquota da COFINS (em percentual) Valor do COFINS TAG do grupo de COFINS tributado por Qtde Cdigo de Situao Tributria do COFINS Quantidade Vendida Alquota do COFINS (em reais) Valor do COFINS TAG do grupo de COFINS no tributado Cdigo de Situao Tributria do COFINS E E E CG E S02 S02 S02 S01 S03 N N N 1-1 1-1 1-1 1-1 1-1 15 5 15 2 2 2 CST = 03 2 03 - Operao Tributvel (base de clculo = quantidade vendida x alquota por unidade de produto); 4 4 2 CST = 04, 06, 07, 08 ou 09 2 04 - Operao Tributvel (tributao monofsica (alquota zero)); 06 - Operao Tributvel (alquota zero); 07 - Operao Isenta da Contribuio; 08 - Operao Sem Incidncia da Contribuio; 09 - Operao com Suspenso da Contribuio; CST = 99 99 - Outras Operaes; 2 2 4
Pg. 121 / 145

301 302 303 304 305

S09 S10 S11 S04 S06

qBCProd vAliqProd vCOFINS COFINSNT CST

E E E CG E

S03 S03 S03 S01 S04

N N N

1-1 1-1 1-1 1-1 1-1

16 15 15

306 307 308 309 310

S05 S06 S07 S08 S09

COFINSOutr CST vBC pCOFINS qBCProd

TAG do grupo de COFINS Outras Operaes Cdigo de Situao Tributria do COFINS Valor da Base de Clculo da COFINS Alquota da COFINS (em percentual) Quantidade Vendida

CG E CE CE CE

S01 S05 S05 S05 S05 N N N N

1-1 1-1 1-1 1-1 1-1 2 15 5 16

Informar campos para clculo do COFINS em percentual (S07 e S08) ou campos para COFINS em valor (S09 e S10).

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

311 S10 vAliqProd 312 S11 vCOFINS T - COFINS ST


# ID Campo

Alquota do COFINS (em reais) Valor do COFINS


Descrio

CE E
Ele

S05 S05
Pai

N N
Tipo

1-1 1-1
Ocorrncia

15 15
tamanho

4 2
Dec

Observao

313 314 315

T01 T02 T03

COFINSST vBC pCOFINS qBCProd vAliqProd vCOFINS


Campo

316 T04 317 T05 318 T06 U - ISSQN


# ID

TAG do grupo de COFINS Substituio Tributria Valor da Base de Clculo da COFINS Alquota da COFINS (em percentual) Quantidade Vendida Alquota do COFINS (em reais) Valor do COFINS
Descrio

G CE CE CE CE E
Ele

M01 T01 T01 T01 T01 T01


Pai

0-1 N N N N N
Tipo

1-1 1-1 1-1 1-1 1-1


Ocorrncia

15 5 16 15 15
tamanho

2 2 4 4 2
Dec

Informar campos para clculo do COFINS Substituio Tributria em percentual (T02 e T03) ou campos para COFINS em valor (T04 e T05).

319

U01

ISSQN

TAG do grupo do ISSQN

M01

0-1

Observao Informar os campos para clculo do ISSQN nas NFe conjugadas, onde h a prestao de servios sujeitos ao ISSQN e fornecimento de peas sujeitas ao ICMS

320 321 322 323

U02 U03 U04 U05

vBC vAliq vISSQN cMunFG

Valor da Base de Clculo do ISSQN Alquota do ISSQN Valor do ISSQN Cdigo do municpio de ocorrncia do fato gerador do ISSQN Cdigo da Lista de Servios

E E E E

U01 U01 U01 U01

N N N N

1-1 1-1 1-1 1-1

15 5 15 7

2 2 2

324

U06

cListServ

U01

1-1

3-4

Informar o municpio de ocorrncia do fato gerador do ISSQN. Utilizar a Tabela do IBGE (Anexo IV Tabela de UF, Municpio e Pas) Informar o cdigo da lista de servios da LC 116/03 em que se classifica o servio.
Dec

V - Informaes adicionais
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho

325

V01

infAdProd

Informaes Adicionais do Produto

H01

0-1

500

Observao Norma referenciada, informaes complementares, etc.

W - Valores Totais da NF-e

Pg. 122 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte
#

ID

Campo

Descrio

Ele

Pai

Tipo

Ocorrncia

tamanho

Dec

Observao

326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343

W01 W02 W03 W04 W05 W06 W07 W08 W09 W10 W11 W12 W13 W14 W15 W16 W17 W18

total ICMSTot vBC vICMS vBCST vST vProd vFrete vSeg vDesc vII vIPI vPIS vCOFINS vOutro vNF ISSQNtot vServ

344 345 346 347 348 349 350 351 352 353

W19 W20 W21 W22 W23 W24 W25 W26 W27 W28

vBC vISS vPIS vCOFINS retTrib vRetPIS vRetCOFINS vRetCSLL vBCIRRF vIRRF

TAG de grupo de Valores Totais da NF-e TAG de grupo de Valores Totais referentes ao ICMS Base de Clculo do ICMS Valor Total do ICMS Base de Clculo do ICMS ST Valor Total do ICMS ST Valor Total dos produtos e servios Valor Total do Frete Valor Total do Seguro Valor Total do Desconto Valor Total do II Valor Total do IPI Valor do PIS Valor do COFINS Outras Despesas acessrias Valor Total da NF-e TAG de grupo de Valores Totais referentes ao ISSQN Valor Total dos Servios sob noincidncia ou no tributados pelo ICMS Base de Clculo do ISS Valor Total do ISS Valor do PIS sobre servios Valor do COFINS sobre servios TAG de grupo de Retenes de Tributos Valor Retido de PIS Valor Retido de COFINS Valor Retido de CSLL Base de Clculo do IRRF Valor Retido do IRRF

G G E E E E E E E E E E E E E E G E

A01 W01 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W01 W17 N N N N N N N N N N N N N N

1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 1-1 0-1 0-1 15 15 15 15 15 15 15 15 15 15 15 15 15 15 2 2 2 2 2 2 2 2 2 2 2 2 2 2

15

E E E E G E E E E E

W17 W17 W17 W17 W01 W23 W23 W23 W23 W23

N N N N

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

15 15 15 15

2 2 2 2

N N N N N

15 15 15 15 15

2 2 2 2 2

Exemplos de atos normativos que definem obrigatoriedade da reteno de contribuies: a) IRPJ/CSLL/PIS/COFINS - Fonte - Recebimentos de rgos

Pg. 123 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

354 355

W29 W30

vBCRetPrev vRetPrev

Base de Clculo da Reteno da Previdncia Social Valor da Reteno da Previdncia Social

E E

W23 W23

N N

0-1 0-1

15 15

2 2

Pblicos Federais Lei n 9.430, de 27 de dezembro de 1996, art. 64 Lei n 10.833/2003, art. 34 como normas infra-legais, temos como exemplo: Instruo Normativa SRF n 480/2004 e Instruo Normativa n 539, de 25/04/2005. b) Reteno do Imposto de Renda pelas Fontes Pagadoras REMUNERAO DE SERVIOS PROFISSIONAIS PRESTADOS POR PESSOA JURDICA LEI N 7.450/85, ART. 52 c) IRPJ, CSLL, COFINS e PIS Servios Prestados por Pessoas Jurdicas - Reteno na Fonte Lei n 10.833 de 29.12.2003, arts. 30, 31, 32, 35 e 36 Observao

X - Informaes do Transporte da NF-e


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

356 357 358 359 360

X01 X02 X03 X04 X05

transp modFrete transporta CNPJ CPF

TAG de grupo de Informaes do Transporte da NF-e Modalidade do frete TAG de grupo Transportador CNPJ CPF

G E G CE CE

A01 X01 X01 X03 X03 N

1-1 1-1 0-1 0-1 0-1 1 0 por conta do emitente; 1 por conta do destinatrio; Informar o CNPJ ou o CPF do Transportador, preenchendo os zeros no significativos.

C C

14 11

361

X06

xNome

Razo Social ou nome

X03

0-1

1-60
Pg. 124 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

362 363 364 365 366 367 368 369 370 371 372

X07 X08 X09 X10 X11 X12 X13 X14 X15 X16 X17

IE xEnder xMun UF retTransp vServ vBCRet pICMSRet vICMSRet CFOP cMunFG

Inscrio Estadual Endereo Completo Nome do municpio Sigla da UF TAG de grupo de Reteno do ICMS do transporte Valor do Servio BC da Reteno do ICMS Alquota da Reteno Valor do ICMS Retido CFOP Cdigo do municpio de ocorrncia do fato gerador do ICMS do transporte

E E E E G E E E E E E

X03 X03 X03 X03 X01 X11 X11 X11 X11 X11 X11

C C C C

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

2-14 1-60 1-60 2 Informar o valor do ICMS do servio de transporte retido. 15 15 5 15 4


7

C C C C C
C

2 2 2 2 Utilizar Tabela de CFOP. Informar o municpio de ocorrncia do fato gerador do ICMS do transporte. Utilizar a Tabela do IBGE (Anexo IV - Tabela de UF, Municpio e Pas)

373 374 375 376 377 378 379 380 381 382 383 384 385 386 387

X18 X19 X20 X21 X22 X23 X24 X25 X26 X27 X28 X29 X30 X31 X32

veicTransp placa UF RNTC reboque placa UF RNTC vol qVol esp marca nVol pesoL pesoB

TAG de grupo Veculo Placa do Veculo Sigla da UF Registro Nacional de Transportador de Carga (ANTT) TAG de grupo Reboque Placa do Veculo Sigla da UF Registro Nacional de Transportador de Carga (ANTT) TAG de grupo Volumes Quantidade de volumes transportados Espcie dos volumes transportados Marca dos volumes transportados Numerao dos volumes transportados Peso Lquido (em kg) Peso Bruto (em kg)

G E E E G E E E G E E E E E E

X01 X18 X18 X18 X01 X22 X22 X22 X01 X26 X26 X26 X26 X26 X26

C C C

0-1 1-1 1-1 0-1 0-2 1-1 1-1 0-1 0-N 0-1 0-1 0-1 0-1 0-1 0-1

1-8 2 1-20

C C C

1-8 2 1-20

N C C C N N

15 1-60 1-60 1-60 15 15 3 3

Pg. 125 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

387a X33 lacres 388 X34 nLacre Y Dados da Cobrana


# ID Campo

TAG de grupo de Lacres Nmero dos Lacres


Descrio

G E
Ele

X26 X33
Pai

C
Tipo

0-N 1-1
Ocorrncia

1-60
tamanho Dec

Observao

389 Y01 cobr TAG de grupo de Cobrana 390 Y02 fat TAG de grupo da Fatura 391 Y03 nFat Nmero da Fatura 392 Y04 vOrig Valor Original da Fatura 393 Y05 vDesc Valor do desconto 394 Y06 vLiq Valor Lquido da Fatura 395 Y07 dup TAG de grupo da Duplicata 396 Y08 nDup Nmero da Duplicata 397 Y09 dVenc Data de vencimento 398 Y10 vDup Valor da duplicata Z - Informaes Adicionais da NF-e
# ID Campo Descrio

G G E E E E G E E E
Ele

A01 Y01 Y02 Y02 Y02 Y02 Y01 Y07 Y07 Y07
Pai

C N N N C D N
Tipo

0-1 0-1 0-1 0-1 0-1 0-1 0-N 0-1 0-1 0-1
Ocorrncia

1-60 15 15 15 1-60

2 2 2

Formato AAAA-MM-DD 15
tamanho

2
Dec

Observao

399 400 401 401a

Z01 Z02 Z03 Z04

infAdic infAdFisco infCpl obsCont

TAG de grupo de Informaes Adicionais Informaes Adicionais de Interesse do Fisco Informaes Complementares de interesse do Contribuinte TAG de grupo do campo de uso livre do contribuinte

G E E G

A01 Z01 Z01 Z01 C C

0-1 0-1 0-1 0-10 1-256 15000 Campo de uso livre do contribuinte, informar o nome do campo no atributo xCampo e o contedo do campo no xTexto Identificao do campo Contedo do campo Campo de uso livre do Fisco Informar o nome do campo no atributo xCampo e o contedo do campo no xTexto Identificao do campo Contedo do campo Campo de uso livre do Fisco Informar o nome do campo no

401b 401c 401d

Z05 Z06 Z07

xCampo xTexto obsFisco

Identificao do campo Contedo do campo TAG de grupo do campo de uso livre do Fisco

A E G

Z04 Z04 Z01

C C

1-1 1-1 0-10

1-20 1-60

401e 401f 401g

Z08 Z09 Z10

xCampo xTexto procRef

Identificao do campo Contedo do campo Tag de grupo do processo

A E G

Z07 Z07 Z01

C C

1-1 1-1 0-N

1-20 1-60

Pg. 126 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

referenciado 401h 401i Z11 Z12 nProc indProc Indentificador do processo ou ato concessrio Indicador da origem do processo E E Z10 Z10 C N 1-1 1-1 1-60 1

atributo xCampo e o contedo do campo no xTexto Indentificador do processo ou ato concessrio Origem do processo, informar com: 0 - SEFAZ; 1 - Justia Federal; 2 - Justia Estadual; 3 - Secex/RFB; 9 - Outros
Dec

ZA - Informaes de Comrcio Exterior


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho

402 403

ZA01 ZA02

exporta UFEmbarq

TAG do Grupo de Exportao Sigla da UF onde ocorrer o Embarque dos produtos Local onde ocorrer o Embarque dos produtos
Descrio

G E

A01 ZA01

0-1 1-1

Observao Informar apenas na exportao.

404

ZA03

xLocEmbarq

ZA01

1-1

1-60

ZB - Informaes de Compras
# ID Campo Ele Pai Tipo Ocorrncia tamanho Dec

405 406

ZB01 ZB02

compra xNEmp

TAG do Grupo de Compra Nota de Empenho

G E

A01 ZB01

0-1 0-1

1-17

407

ZB03

xPed

Pedido

E E
Descrio Ele

ZB01 ZB01
Pai

C C
Tipo

0-1 0-1
Ocorrncia

1-60 1-60
tamanho Dec

Observao Informar adicionais de compra Informar a identificao da Nota de Empenho, quando se tratar de compras pblicas Informar o pedido. Informar o contrato de compra Observao

408 ZB04 xCont Contrato ZC - Informaes da Assinatura Digital


# ID Campo

409

ZC01

Signature

Assinatura XML da NF-e Segundo o Padro XML Digital Signature

A01

1-1

Pg. 127 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

OBSERVAES:

1. Abreviaes utilizadas nas colunas de cabealho do leiaute:


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec Observao

389

Y01

cobr

TAG de grupo de Cobrana

A01

0-1

a) coluna # : identificador da linha da tabela; b) coluna ID : identificao do campo, alguns campos relacionados com tributos podem aparecer mais de uma vez no leiaute em funo da estrutura de grupos de choice baseados no CST Cdigo de Situao Tributria do tributo. Exemplo: O preenchimento dos campos de tributos relacionados com o ICMS Normal e ST depende do contedo informado no CST - Cdigo da Situao Tributria (campo N12), que pode assumir um dos seguintes valores: 00 Tributada integralmente; 10 - Tributada e com cobrana do ICMS por substituio tributria; 20 - Com reduo de base de clculo; 30 - Isenta ou no tributada e com cobrana do ICMS por substituio tributria; 40 - Isenta; 41 - No tributada; 50 Suspenso; 51 - Diferimento; 60 - ICMS cobrado anteriormente por substituio tributria; 70 - Com reduo de base de clculo e cobrana do ICMS por substituio tributria; 90 Outros. Assim, conforme o CST aplicvel para a situao, o grupo de tributo ICMS Normal e ST dever ter os campos assinalados com S ou ? da seguinte tabela:

ID

Campo

Descrio 00 10 20

CST Cdigo da Situao Tributria 30 40 41 50 51 60 70 90

Pg. 128 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

N11 N12 N13 N14 N15 N16 N17 N18 N19 N20 N21 N22 N23

orig CST modBC pRedBC vBC pICMS vICMS modBCST pMVAST pRedBCST vBCST pICMSST vICMSST

Origem da mercadoria Tributao do ICMS Modalidade de determinao da BC do ICMS Percentual da Reduo de BC Valor da BC do ICMS Alquota do imposto Valor do ICMS Modalidade de determinao da BC do ICMS ST Percentual da margem de valor Adicionado do ICMS ST Percentual da Reduo de BC do ICMS ST Valor da BC do ICMS ST Alquota do imposto do ICMS ST Valor do ICMS ST

S S S N S S S N N N N N N

S S S N S S S S S ? S S S

S S S S S S S N N N N N N

S S N N N N N S S ? S S S

S S N N N N N N N N N N N

S S N N N N N N N N N N N

S S N N N N N N N N N N N

S S ? ? ? ? ? N N N N N N

S S N N N N N N N N S N S

S S S S S S S S S ? S S S

S S S ? S S S S ? ? S S S

* S o campo deve ser informado, N o campo no deve ser informado e ? a exigncia do campo depende da situao ftica. c) coluna campo: identificador do nome do campo, como a nomenclatura dos nomes dos campos foi padronizada, um nome de campo utilizado para identificar campos diferentes, como por exemplo, a IE, que pode ser do emitente ou do destinatrio. A diferenciao dos campos realizada considerando as tags de grupo. d) coluna Ele:

Pg. 129 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A - indica que o campo um atributo do Elemento anterior; E - indica que o campo um Elemento; CE indica que o campo um Elemento que deriva de uma Escolha (Choice); G indica que o campo um Elemento de Grupo; CG - indica que o campo um Elemento de Grupo que deriva de uma Escolha (Choice); ID indica que o campo um ID da XML 1.0; RC indica que o campo uma key constraint (Restrio de Chave) para garantir a unicidade e presena do valor;

e) coluna Pai: indica qual o elemento pai; f) coluna Tipo: N campo numrico; C campo alfanumrico; D campo data; g) Coluna Ocorrncia: x-y, onde x indica a ocorrncia mnima e y a ocorrncia mxima;

Pg. 130 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

h) Coluna tamanho: x-y, onde x indica o tamanho mnimo e y o tamanho mximo; a existncia de um nico valor indica que o campo tem tamanho fixo, devendo-se informar a quantidade de caracteres exigidos, preenchendo-se os zeros no significativos; tamanhos separados por vrgula indicam que o campo deve ter um dos tamanhos fixos da lista; i) coluna dec: indica a quantidade mxima de casas decimais do campo; j) O tamanho mximo dos campos Tipo C, quando no especificado, 60 posies;

2. A informao da Classe de enquadramento do IPI para Cigarros e Bebidas, quando aplicvel, deve ser informada utilizando a codificao prevista nos Atos Normativos editados pela Receita Federal. Exemplo: tabela do artigo 149 do RIPI/2002 (Decreto n 4.544 de 26.12.2002 D.O.U: 27.12.2002) :
CDIGO NCM 2204.10.10 2204.10.90 2204.2 CLASSE POR CAPACIDADE (ml) DO RECIPIENTE At De 181 De 376 De 671 180 a 375 a 670 a 1000 EaH JaM KaP LaQ CaG HaL IaO KaQ

DESCRIO Tipo Champanha ("Champagne") Outros Espumantes - Outros vinhos; mostos de uvas cuja fermentao tenha sido impedida ou interrompida por adio de lcool 1. Vinhos da madeira, do porto e de xerez, de mlaga e outros licorosos 2. Mostos de uvas cuja fermentao tenha sido impedida ou interrompida por adio de lcool, compreendendo as mistelas 3. Vinhos de mesa comum ou de consumo corrente produzidos com uvas de variedades americanas ou hbridas, includos os frisantes com gaseificao mxima de 2 atmosferas e mnima de meia atmosfera e graduao alcolica no superior a 13 G.L. 4. Vinhos de mesa finos ou nobres e especiais produzidos com uvas vinferas, includos os frisantes com gaseificao mxima de 2 atmosferas e mnima de meia atmosfera e graduao alcolica no superior a 13 G.L. 5. Outros vinhos

EaF AaC

JaK AaF

KaL BaI

LaO CaJ

AaB

AaD

BaG

CaJ

CaE CaI

EaF EaM

GaI GaP

HaJ HaQ

3. A informao do cdigo de selo, quando aplicvel, deve ser informada utilizando a codificao prevista nos Atos Normativos editados pela Receita Federal. Exemplo: Codificao utilizada no ATO DECLARATRIO EXECUTIVO COFIS N 8, DE 31 DE MARO DE 2005:
Pg. 131 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Tipo/cor do selo Usque Verde Usque Azul Usque Vermelho Usque Amarelo Usque Miniatura Verde Usque Miniatura Azul Usque Miniatura Vermelho Usque Miniatura Amarelo Bebida Alcolica Laranja Bebida Alcolica Cinza Bebida Alcolica Marrom Bebida Alcolica Verde Bebida Alcolica Vermelho Bebida Alcolica Azul Marinho Bebida Alcolica Miniatura Verde Bebida Alcolica Miniatura Vermelho Bebida Alcolica Miniatura Azul Marinho Aguardente Laranja Aguardente Azul Aguardente Violeta

Cdigo 9729-11 9729-12 9729-13 9729-14 9729-21 9729-22 9729-23 9729-24 9737-11 9737-12 9737-13 9737-14 9737-15 9737-16 9737-21 9737-22 9737-23 9745-11 9745-12 9745-13

4. Regras de preenchimento dos campos da Nota Fiscal Eletrnica:

Campos que representam cdigos (CNPJ, CPF, CEP, CST, NCM, EAN, etc.) devem ser informados com o tamanho fixo previsto, sem formatao e com o preenchimento dos zeros no significativos; Campos numricos que representam valores e quantidades so de tamanho varivel, respeitando o tamanho mximo previsto para o campo e a quantidade de casas decimais. O preenchimento de zeros no significativos causa erro de validao do Schema XML. Os campos numricos devem ser informados sem o separador de milhar, com uso do ponto decimal para indicar a parte fracionria se existente respeitando-se a quantidade de dgitos prevista no leiaute; O uso de caracteres acentuados e smbolos especiais para o preenchimento dos campos alfanumricos devem ser evitados. Os espaos informados no incio e no final do campo alfanumrico tambm devem ser evitados; As datas devem ser informadas no formato AAAA-MM-DD;

Pg. 132 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

A forma e a obrigatoriedade de preenchimento dos campos da Nota Fiscal Eletrnica esto previstas na legislao aplicvel para a operao que se pretende realizar; Inexistindo contedo (valor zero ou vazio) para um campo no obrigatrio, a TAG deste campo no dever ser informada no arquivo da NF-e; Tratando-se de operaes com o exterior, uma vez que o campo CNPJ obrigatrio no informar o contedo deste campo; No caso das pessoas desobrigadas de inscrio no CNPJ/MF, dever ser informado o CPF da pessoa, exceto nas operaes com o exterior;

5. A Chave de acesso da NF-e tem o seguinte leiaute: # 1 2 3 4 5 6 7 8 Campo cUF AAMM CNPJ mod serie nNF cNF cDV Tam Tipo Observao Max Cdigo da UF do emitente do Documento Fiscal 2 N Utilizar a Tabela de cdigo de UF do IBGE (Anexo IV Tabela de UF, Municpio e Pas) Ano e Ms de emisso da NF-e 4 N AAMM da emisso da NF-e CNPJ do emitente 14 C Informar somente nmeros considerando os zeros no significativos. Modelo do Documento Fiscal 2 C Utilizar o cdigo 55 para identificao da NF-e, emitida em substituio ao modelo 1 ou 1A. Srie do Documento Fiscal 3 N Informar zero para srie inexistente Nmero do Documento Fiscal 9 N 1 999999999 Cdigo Numrico que compe a Chave de Acesso 9 N Nmero Aleatrio gerado pelo Emitente para cada NFe Dgito Verificador da Chave de Acesso 1 N Calculado com a aplicao do algoritmo mdulo 11 base (2,9), vide item 5.4 do Manual de Integrao do Contribuinte. Descrio

Pg. 133 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo II DANFE TAMANHO A-4 EM MODO RETRATO, FOLHAS SOLTAS

Pg. 134 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo III DANFE TAMANHO FORMULRIO CONTNUO

A-4

EM

MODO

RETRATO,

Pg. 135 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo IV DANFE TAMANHO A-4 EM MODO PAISAGEM, FOLHAS SOLTAS

Pg. 136 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo V DANFE TAMANHO A-4 EM MODO PAISAGEM, FORMULRIO CONTNUO

Pg. 137 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo VI WS disponveis
A relao dos Web Services em operao est disponvel no Portal Nacional: WS de Homologao: http://hom.nfe.fazenda.gov.br/PORTAL/WebServices.aspx WS de Produo: http://www.nfe.fazenda.gov.br/portal/WebServices.aspx

A documentao do WSDL pode ser obtida na internet acessando o endereo do Web Service desejado. Exemplificando, para obter o WSDL de cada um dos Web Service acione o navegador Web (Internet Explorer, por exemplo) e digite o endereo desejado seguido do literal ?WSDL.

Pg. 138 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo VII Conjunto de caracteres Cdigo de Barras CODE-128C


Conjunto de caracteres representativos do Cdigo de Barras CODE-128C Combinao de barras: B = barra preta e S = espao (barra branca) Valor Valor Combinao de Barras Combinao de Barras CODE C B S B S B S CODE C B S B S B S 00 50 2 1 2 2 2 2 2 3 1 1 3 1 01 51 2 2 2 1 2 2 2 1 3 1 1 3 02 52 2 2 2 2 2 1 2 1 3 3 1 1 03 53 1 2 1 2 2 3 2 1 3 1 3 1 04 54 1 2 1 3 2 2 3 1 1 1 2 3 05 55 1 3 1 2 2 2 3 1 1 3 2 1 06 56 1 2 2 2 1 3 3 3 1 1 2 1 07 57 1 2 2 3 1 2 3 1 2 1 1 3 08 58 1 3 2 2 1 2 3 1 2 3 1 1 09 59 2 2 1 2 1 3 3 3 2 1 1 1 10 60 2 2 1 3 1 2 3 1 4 1 1 1 11 61 2 3 1 2 1 2 2 2 1 4 1 1 12 62 1 1 2 2 3 2 4 3 1 1 1 1 13 63 1 2 2 1 3 2 1 1 1 2 2 4 14 64 1 2 2 2 3 1 1 1 1 4 2 2 15 65 1 1 3 2 2 2 1 2 1 1 2 4 16 66 1 2 3 1 2 2 1 2 1 4 2 1 17 67 1 2 3 2 2 1 1 4 1 1 2 2 18 68 2 2 3 2 1 1 1 4 1 2 2 1 19 69 2 2 1 1 3 2 1 1 2 2 1 4 20 70 2 2 1 2 3 1 1 1 2 4 1 2 21 61 2 1 3 2 1 2 1 2 2 1 1 4 22 72 2 2 3 1 1 2 1 2 2 4 1 1 23 73 3 1 2 1 3 1 1 4 2 1 1 2 24 74 3 1 1 2 2 2 1 4 2 2 1 1 25 75 3 2 1 1 2 2 2 4 1 2 1 1 26 76 3 2 1 2 2 1 2 2 1 1 1 4 27 77 3 1 2 2 1 2 4 1 3 1 1 1 28 78 3 2 2 1 1 2 2 4 1 1 1 2 29 79 3 2 2 2 1 1 1 3 4 1 1 1 30 80 2 1 2 1 2 3 1 1 1 2 4 2 31 81 2 1 2 3 2 1 1 2 1 1 4 2 32 82 2 3 2 1 2 1 1 2 1 2 4 1 33 83 1 1 1 3 2 3 1 1 4 2 1 2 34 84 1 3 1 1 2 3 1 2 4 1 1 2 35 85 1 3 1 3 2 1 1 2 4 2 1 1 36 86 1 1 2 3 1 3 4 1 1 2 1 2 37 87 1 3 2 1 1 3 4 2 1 1 1 2 38 88 1 3 2 3 1 1 4 2 1 2 1 1 39 89 2 1 1 3 1 3 2 1 2 1 4 1 40 90 2 3 1 1 1 3 2 1 4 1 2 1 41 91 2 3 1 3 1 1 4 1 2 1 2 1 42 92 1 1 2 1 3 3 1 1 1 1 4 3 43 93 1 1 2 3 3 1 1 1 1 3 4 1 44 94 1 3 2 1 3 1 1 3 1 1 4 1 45 95 1 1 3 1 2 3 1 1 4 1 1 3 46 96 1 1 3 3 2 1 1 1 4 3 1 1 47 97 1 3 3 1 2 1 4 1 1 1 1 3 48 98 3 1 3 1 2 1 4 1 1 3 1 1 49 99 2 1 1 3 3 1 1 1 3 1 4 1 Valor 105 Caractere de Incio (START) B S B S B S 2 1 1 2 3 2 Caractere de Fim (STOP) B S B S B S B 2 3 3 1 1 1 2

Valor CODE C 100 101 102 103 104

Combinao de Barras B S B S B S 1 1 4 1 3 1 3 1 1 1 4 1 4 1 1 1 3 1 2 1 1 4 1 2 2 1 1 2 1 4

Pg. 139 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo VIII Projeto Piloto da NF-e


O Projeto Piloto da Nota Fiscal Eletrnica foi desenvolvido, de forma integrada, pelas Secretarias de Fazenda dos Estados da Bahia, Gois, Maranho, Rio Grande do Sul, Santa Catarina e So Paulo, Receita Federal, Superintendncia da Zona Franca de Manuas (SUFRAMA), Encontro Nacional de Coordenadores e Administradores Tributrios Estaduais (ENCAT) e as seguintes empresas: Cervejarias Kaiser S.A. Companhia Ultragaz S.A. Dimed Distribuidora de Medicamentos S.A. Eletropaulo Metropolitana Eletricidade de So Paulo S.A. Eurofarma Laboratrios Ltda. Ford Motor Company Brasil Ltda. General Motors do Brasil Ltda. Gerdau Aos Longos S.A. Office Net do Brasil S.A. Petrobrs - Distribuidora de Petrleo Petrobrs - Petrleo Brasileiro S.A. Robert Bosch Limitada Sadia S.A. Siemens VDO Automotive Ltda. Souza Cruz S.A. Telefnica - Telesp Telecomunicaes de So Paulo S.A. Toyota do Brasil Volkswagen do Brasil Indstria de Veculos Automotores Ltda. Wickbold & Nosso Po Indstrias Alimentcias Ltda.

Pg. 140 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Anexo IX Tabelas de UF, Municpio e Pas 1. Tabela de cdigo de UF do IBGE


A tabela de UF do IBGE est disponvel em: ftp://geoftp.ibge.gov.br/Organizacao/Divisao_Territorial/2006/DTB_2006.zip A seguinte codificao adotada pelo IBGE dever ser utilizada para representar o cdigo da UF:
Regio Norte 11-Rondnia 12-Acre 13-Amazonas 14-Roraima 15-Par 16-Amap 17-Tocantins Regio Nordeste 21-Maranho 22-Piau 23-Cear 24-Rio Grande do Norte 25-Paraba 26-Pernambuco 27-Alagoas 28-Sergipe 29-Bahia Regio Sudeste 31-Minas Gerais 32-Esprito Santo 33-Rio de Janeiro 35-So Paulo Regio Sul 41-Paran 42-Santa Catarina 43-Rio Grande do Sul Regio CentroOeste 50-Mato Grosso do Sul 51-Mato Grosso 52-Gois 53-Distrito Federal

2. Tabela de cdigo de Municpio do IBGE


Os campos de cdigos de municpios devem ser informados com a utilizao da Tabela de cdigo de Municpio mantida pelo IBGE disponvel em: ftp://geoftp.ibge.gov.br/Organizacao/Divisao_Territorial/2008/DTB_2008.zip O cdigo de municpio composto de 7 dgitos numricos, com as duas primeiras representando a UF. Os cdigos de municpio das capitais dos estados so:
Municpio Aracaju Belm Belo Horizonte Boa Vista Braslia Campo Grande Cuiab Curitiba Florianpolis Fortaleza Goinia Joo Pessoa Macap Macei Manaus Natal cdigo 2800308 1501402 3106200 1400100 5300108 5002704 5103403 4106902 4205407 2304400 5208707 2507507 1600303 2704302 1302603 2408102 Estado Sergipe Par Minas Gerais Roraima Distrito Federal Mato Grosso do Sul Mato Grosso Paran Santa Catarina Cear Gois Paraba Amap Alagoas Amazonas Rio Grande do Norte cdigo 28 15 31 14 53 50 51 41 42 23 52 25 16 27 13 24
Pg. 141 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

Municpio Palmas Porto Alegre Porto Velho Recife Rio Branco Rio de Janeiro Salvador So Lus So Paulo Teresina Vitria

cdigo 1721000 4314902 1100205 2611606 1200401 3304557 2927408 2111300 3550308 2211001 3205309

Estado Tocantins Rio Grande do Sul Rondnia Pernambuco Acre Rio de Janeiro Bahia Maranho So Paulo Piau Esprito Santo

cdigo 17 43 11 26 12 33 29 21 35 22 32

Informar o cdigo 9999999 e o nome do municpio EXTERIOR para as operaes que envolvam localidades do exterior. Quando a operao envolver regies administrativas (Ex. Cidades-satlites do DF), deve ser considerado o municpio sede como localidade da operao.

2.1

Validao do cdigo de Municpio

O Cdigo de Municpio do IBGE tem a composio que segue: Composio: UUNNNND Onde: UU = Cdigo da UF do IBGE NNNN = Nmero de ordem dentro da UF; D = Dgito de Controle mdulo 10

Validao possvel: Extenso mxima: 7 dgitos; Extenso mnima: 7 dgitos; Cdigo da UF: deve ser vlido, conforme Tabela de UF do IBGE; Nmero de ordem dentro da UF: no pode ser zero; Dgito de Controle: mdulo 10 (pesos 2 e 1)

Obs 1: Considerar a soma dos algarismos no somatrio dos produtos dos pesos. Ou seja, se o produto for superior a 9 os dois algarismos devem ser somados. Obs 2: Se o resto da diviso for zero, considerar o dgito verificador igual a zero.

2.2

Exemplo de clculo do dgito de controle do cdigo de Municpio

Exemplo 1: Cdigo Municpio IBGE = 355030 D (Municpio de So Paulo)


A. CDIGO MUN B. PESOS C. PONDERAO (A * B) D. SOMA ALGARISMOS 3 5 5 1 2 1 3 10 5 3 1 5 0 2 0 0 3 1 3 3 0 2 0 0
Pg. 142 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

O somatrio da soma dos algarismos : 3 + 1 + 5 + 0 + 3 + 0 = 12 Dividindo o somatrio por 10 teremos: 12 / 10 = 1, com um resto valendo 2 O dgito verificador : DV = 10 (resto da diviso), portanto 10 2 = 8 Neste caso, o Dgito Verificador = 8 Exemplo 2: Cdigo Municpio IBGE = 211130 D (Municpio de So Lus)
A. CDIGO MUN B. PESOS C. PONDERAO (A * B) D. SOMA ALGARISMOS 2 1 2 2 1 2 2 2 1 1 1 1 1 2 2 2 3 1 3 3 0 2 0 0

O somatrio da soma dos algarismos : 2 + 2 + 1 + 2 + 3 + 0 = 10 Dividindo o somatrio por 10 teremos: 10 / 10 = 1, com um resto valendo 0 O dgito verificador : DV = 10 (resto da diviso), portanto 10 0 = 10 Neste caso, o Dgito Verificador = 0 O cdigo de Municpio do IBGE dos seguintes Municpios tem o DV - dgito verificador invlido: 4305871 - Coronel Barros/RS; 2201919 - Bom Princpio do Piau/PI; 2202251 - Canavieira /PI; 2201988 - Brejo do Piau/PI; 2611533 Quixaba/PE; 3117836 - Cnego Marinho/MG; 3152131 - Ponto Chique/MG; 5203939 - Buriti de Gois/GO; 5203962 Buritinpolis/GO;

As aplicaes dos Estados e dos emissores devem utilizar os cdigos de municpio do IBGE sem validao do DV dgito verificador, da mesma forma como consta da tabela de cdigo de municpio do IBGE.

3. Tabela de cdigo de Pas do BACEN


Para o preenchimento dos campos de cdigos de pases deve ser utilizada a Tabela de Pas do Banco Central do Brasil, disponvel em: www.bcb.gov.br/rex/ftp/tabela_de_paises.txt Exemplo de codificao:
Pas Brasil Argentina Chile Paraguai Uruguai cdigo 1058 0639 1589 5860 8451 Pas Espanha Frana Itlia Portugal Reino Unido cdigo Pas 2453 Estados Unidos 2755 China, Repblica Popular, 3867 Coria, Repblica da, 6076 Formosa 6289 Japo cdigo 2496 1600 1902 1619 3999
Pg. 143 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

3.1

Validao do cdigo de Pas

Composio do Cdigo de Pas: NNND Onde: NNN = Nmero de ordem do Cdigo do Pas; D = Dgito de Controle mdulo 11.

Validao possvel: Extenso mxima: 4 dgitos; Extenso mnima: 2 dgitos; Dgito de Controle: mdulo 11, pesos 2 a 9

Obs.: Se o resto da diviso for zero ou 1, considerar o dgito verificador igual a zero.

3.2

Exemplo de clculo do dgito de controle do cdigo de Pas

Exemplo 1 Cdigo Pas = 105 D (Brasil): A. CDIGO PAS B. PESOS C. PRODUTOS (A * B) 1 4 4 0 3 0 5 2 10

O somatrio dos produtos : 4 + 0 + 10 = 14 Dividindo o somatrio por 11 teremos: 14 / 11 = 1, com resto valendo 3 Considerar: 11 (resto da diviso), portanto: 11 3 = 8 Neste caso, o Dgito Verificador = 8 Exemplo 2 Cdigo Pas = 586 D (Paraguai): A. CDIGO PAS B. PESOS C. PRODUTOS (A * B) 5 4 20 8 3 24 6 2 12

O somatrio dos produtos : 20 + 24 + 12 = 56 Dividindo o somatrio por 11 teremos: 56 / 11 = 5, com resto valendo 1 Considerar: 11 (resto da diviso), portanto: 11 1 = 10 Neste caso, o Dgito Verificador = 0 O cdigo de Pas do BACEN dos seguintes pases tem o DV - dgito verificador invlido: 1504 -GUERNSEY, ILHA DO CANAL (INCLUI ALDERNEY E SARK); 1508 -JERSEY, ILHA DO CANAL; 4525 -MADEIRA, ILHA DA; 3595 -MAN, ILHA DE; 4985 MONTENEGRO; 6781 -SAINT KITTS E NEVIS; 7370 SERVIA;

Pg. 144 / 145

Nota Fiscal Eletrnica


Manual de Integrao - Contribuinte

As aplicaes dos Estados e dos emissores devem utilizar os cdigos de Pas do BACEN sem validao do DV dgito verificador, da mesma forma que consta da tabela de cdigo de pas do BACEN.

Pg. 145 / 145