Você está na página 1de 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Projeto Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte


Padres Tcnicos de Comunicao

Verso 2.0.2 Junho 2007

Pg. 1 / 144

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

2.0.0 2.0.1 2.0.2

Pg. 2 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Identificao e vigncia do Manual


Verso do manual Data de divulgao do manual 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

2.0.2 29/06/2007 PL_005a 01/09/2007 01/10/2007 PL_003b 31/12/2007

Verses de leiautes do PL_005a


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 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Distribuio da NF-e para o Destinatrio ......................................................... 77 10. 10.1 Processo de Distribuio...................................................................................... 77 10.2 Leiaute da Distribuio: NF-e ............................................................................... 77 11. Compartilhamento de informaes da NF-e entre rgos Pblicos................. 78 11.1 Processo de Compartilhamento ........................................................................... 78 11.2 Leiaute de compartilhamento: NF-e..................................................................... 79 11.3 Leiaute de compartilhamento: Cancelamento de NF-e ........................................ 79 11.4 Leiaute de compartilhamento: Inutilizao de Numerao de NF-e ..................... 79 11.5 Compartilhamento de documentos com outros rgos pblicos........................... 79 12. Cadastro nacional de emissores de DF-e ........................................................ 81 12.1 Leiaute do Cadastro de Emissor de DF-e............................................................. 82 12.2 Leiaute de Atualizao do Cadastro de Emissor de DF-e..................................... 82 12.3 Leiaute de Retorno de Atualizao de Cadastro de Emissor de DF-e .................. 83 Anexo I Leiaute da NF-e ................................................................................................... 85 Anexo II Modelo de DANFE - retrato............................................................................... 129 Anexo III Modelo de DANFE - paisagem......................................................................... 132 Anexo IV WS disponveis................................................................................................ 135 Anexo V Conjunto de caracteres Cdigo de Barras CODE-128C ................................... 139 Anexo VI Projeto Piloto da NF-e ..................................................................................... 140 Anexo VII 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 2.2 Exemplo de clculo do dgito de controle do cdigo de Municpio ................. 142 3. Tabela de cdigo de Pas do BACEN.................................................................. 143 3.1 Validao do cdigo de Pas ......................................................................... 143 3.2 Exemplo de clculo do dgito de controle do cdigo de Pas ......................... 144

Pg. 6 / 144

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. 7 / 144

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 foi atualizado pelo Ajustes SINIEF 11/05 e SINIEF 04/06.

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, pela Secretaria de Fazenda Estadual, para a Receita Federal, que ser repositrio nacional de todas as NF-e emitidas e, no caso de uma operao interestadual, para a Secretaria de Fazenda Estadual de destino da operao e respectivamente, para a SUFRAMA, quando aplicvel.

Pg. 8 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Para acobertar 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. 9 / 144

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. 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. 10 / 144

Nota Fiscal Eletrnica


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

Manual de Integrao - Contribuinte

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. 11 / 144

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. 12 / 144

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. 13 / 144

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. 14 / 144

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"/> <DigestValue>vFL68WETQ+mvj1aJAMDx+oVi928=</DigestValue> Pg. 15 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

</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). 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
Pg. 16 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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

3.3

Modelo operacional

Pg. 17 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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
(3) Resultado

(4) 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. 18 / 144

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) (1) Solicitao de servio (3) Recibo

Secretaria de Fazenda Estadual


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

(5)

Fila de recibos

Processamento de Servios

(7)

(6)

Consulta Recibo

(8) Consulta recibo


(10) Resultado processamento

Web Service Consulta recibo


(9) Resultado processamento

Fila de servios processados

Etapas do processo ideal: (1) (2) (3) (4) (5) (6) (7) (8) (9) 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. 19 / 144

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. 20 / 144

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

TAG raiz do cabealho da mensagem Verso do leiaute


Descrio

G A
Ele

Pai

1-1 N
Tipo

TAG raiz do cabealho da mensagem 1-4


Tam.

1-1
Ocor.

2
Dec.

Verso do leiaute (1.02)


Observao

Campo

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. 21 / 144

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. 22 / 144

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. 23 / 144

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. 24 / 144

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. A empresa poder optar por entrar em contingncia, ou seja, emitir a Nota Fiscal Modelo 1/1A ou o DANFE em formulrio de segurana, caso julgue que o tempo de resposta no aceitvel. 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 IV 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. 25 / 144

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 nfeRecepcaoLote msgs Filas de Entrada. Proc. Processamento Aplicao NF-e

Recibo

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. 26 / 144

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. 27 / 144

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. 28 / 144

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. 29 / 144

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. 30 / 144

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

Obrig. Obrig. Obrig. Obrig.

invlido (dgito controle, zeros ou nulo) G06c Validar DV do cdigo do municpio do Emitente

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

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

G07 G08

G08a

G09 G10

Emitente informado correspondem ao cdigo da UF IE Emitente no informada (zeros ou nulo) para emisso prpria (NFe 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.

Obrig. Obrig. Obrig. Obrig.

405 208 237 274 275 210

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

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. 31 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

G11a Se Cdigo de Pas do Destinatrio informado:

- 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 G14 IE ST informada: IE 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) 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 - Validar DV do Cdigo do Municpio do Local de Retirada Se Local de Retirada informado: - verificar se as 2 primeiras posies do cdigo do municpio do Local de Retirada informado correspondem ao cdigo da UF Se Local de Entrega informado: - Validar DV do Cdigo Municpio do Local de Entrega Se Local de Entrega informado: - verificar se as 2 primeiras posies do cdigo do municpio do Local de Entrega informado correspondem ao cdigo da UF Se Cdigo Municpio do FG - ISSQN informado: - Validar DV do Cdigo do Municpio do FG - ISSQN Se Cdigo Municpio do FG - Transporte informado: - Validar DV do Cdigo do Municpio do FG - Transporte Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): - NF-e j cadastrada e no Cancelada/Denegada

Obrig. Obrig. Obrig. Obrig.

406 212 228 211

Rej. Rej. Rej. Rej.

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. Obrig. Obrig.

233 234 302 276 277

Rej. Rej. Den. Rej. Rej.

G25a Se Local de Retirada informado: G25b

G25c G25d

Obrig. Obrig.

278 279

Rej. Rej.

G25e G25f

Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig.

287 288 204 218 205 206 254

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

G26

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-e referenciada

Pg. 32 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

G31 Se finalidade da NF-e = 2 (NF-e complementar): verificar se foi informado mais de uma NF-e referenciada 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. Facult.

255 267

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 Vlida Vlida Emitente Irrelevante Irregular Regular Regular Destinatrio (a critrio da UF) Irrelevante Irrelevante Irregular Regular Situao da NF-e Rejeio Conseqncia Para o contribuinte Corrigir NF-e A operao Denegao no poder de uso ser realizada A operao Denegao no poder de uso ser realizada Autorizao A operao de uso autorizada Banco de Dados No gravar Gravar 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. 33 / 144

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 nfeRetRecepcao Proc. Ret Retorno

Consulta Processamento Aplicao NF-e

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. 34 / 144

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 ID

Pai
PR01 PR01 PR03

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

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. 35 / 144

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. 36 / 144

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. 37 / 144

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. 38 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

4.3

Web Service - NfeCancelamento

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

Proc. Ret

Cancelamento Aplicao NF-e

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. 39 / 144

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. 40 / 144

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. 41 / 144

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. 42 / 144

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 60 dias 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. 43 / 144

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. 44 / 144

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 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. 45 / 144

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. 46 / 144

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. 47 / 144

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. 48 / 144

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. Msg 252 250 224 201 203 240 256 Efeito 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 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

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).

Pg. 49 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

4.4.8 Final do Processamento


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

Pg. 50 / 144

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. 51 / 144

ER01 retConsSitNFe

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

ER02 versao ER03 infProt ER04 Id

A G ID

ER01 ER01 ER03

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.

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. 52 / 144

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. 53 / 144

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. 54 / 144

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. 55 / 144

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. 56 / 144

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. 57 / 144

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. 58 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

4.7

Web Service CadConsultaCadastro

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

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 GP06 GP07 GP08

Campo
consCad versao infCons xServ UF IE CNPJ CPF

Ele
Raiz A G E E CE CE CE

Pai
GP01 GP01 GP03 GP03 GP03 GP03 GP03

Tipo
N C C C N N

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

Tam.
1-4 8 2 2-14 3-14 3-11

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

Pg. 59 / 144

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. 60 / 144

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 GR13

cSit xNome

E E

GR07 GR07

N C

1-1 1-1

1 1-60

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

GR13a GR14 GR15 GR16 GR17 GR18 GR20

xFant xRegApur CNAE dIniAtiv dUltSit dBaixa IEUnica

E E E E E E E

GR07 GR07 GR07 GR07 GR07 GR07 GR07

C C N D D D C

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

1-60 1-60 6-7

2-14

GR21 GR22 GR23 GR24 GR25 GR26 GR27 GR28 GR29

IEAtual ender xLgr nro xCpl xBairro cMun xMun CEP

E G E E E E E E E

GR07 GR07 GR22 GR22 GR22 GR22 GR22 GR22 GR22

0-1 0-1

2-14

C C C C N C N

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

1-255 1-60 1-60 1-60 7 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. 61 / 144

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. 62 / 144

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. 63 / 144

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. 64 / 144

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: A B C D E F G H I J K L 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

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. 65 / 144

Nota Fiscal Eletrnica


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

Manual de Integrao - Contribuinte

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 60 dias 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 referenciada no informada para NF-e complementar Rejeio: Informada mais de uma NF-e referenciada para NF-e complementar 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. 66 / 144

Nota Fiscal Eletrnica


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 999
CDIGO

Manual de Integrao - Contribuinte

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: Erro no catalogado (informar a mensagem de erro capturado no tratamento da exceo)
MOTIVOS DE DENEGAO DE USO
Pg. 67 / 144

Nota Fiscal Eletrnica


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

Manual de Integrao - Contribuinte

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.

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
Pg. 68 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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. CLCULO DO DGITO VERIFICADOR DA CHAVE DE ACESSO DA NF-e
Pg. 69 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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

5.6

Nmero do protocolo
Pg. 70 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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); 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. 71 / 144

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. O referido cdigo de barras dever representar apenas a chave nica de acesso do arquivo da nota fiscal eletrnica, com 44 posies. A impresso do cdigo de barras no DANFE tem a finalidade de facilitar e agilizar a captura da chave de acesso da NF-e para consulta da veracidade da mesma nos portais estaduais e da Receita Federal. Com a chave de acesso poder ser realizada a consulta integral ou resumida de uma Nota Fiscal Eletrnica e sua situao, bem como a visualizao da autorizao de uso da mesma. Dentre outras finalidades do cdigo, destacamos tambm o registro do trnsito de mercadorias nos Postos Fiscais e, a critrio de cada unidade federada, a disponibilizao do arquivo da NF-e consultada. O conjunto de caracteres representativos do Cdigo de Barras CODE-128C encontra-se no Anexo V deste manual. O cdigo de barras dever representar apenas a chave de acesso da NF-e de 44 posies. Para a impresso do mesmo ser considerada a seguinte estrutura de simbolizao:

Margem clara

Start C

Chave de acesso da NF- DV e

Stop

Margem clara

Margem Clara: Espao claro, que no contm nenhuma marca legvel por mquina, existente esquerda e direita do cdigo para evitar interferncia na decodificao da simbologia. A margem clara tambm chamada 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. Chave de acesso da NF-e: representa o conjunto de 44 caracteres da chave de acesso da NF-e. DV: dgito verificador da simbologia. Stop: caractere de parada, indica o final do cdigo ao leitor ptico. O cdigo de barras dever ser impresso com resoluo mnima de 300 dpi, devendo ser observada a rea reservada no DANFE de 3 x 9 cm. Altura da barra: no intuito de propiciar melhor rea de leitura, a altura da barra no poder ser inferior a 1,5 cm e nem superior a 2,5 cm. Largura da barra: considerando que para cada smbolo da barra so codificados dois caracteres, ento teremos:
Pg. 72 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Tamanho do campo chave de acesso = 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 mxima de cada mdulo da barra = 9 cm / 297 (posies) = 0,03 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

6.2

START 09 75 83 64 DV = 48 STOP 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 V deste manual. B = barra preta S = espao ou barra branca A numerao acima indica quantas vezes a barra dever ser impressa no smbolo.

Pg. 73 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

7. DANFE
O DANFE um documento fiscal auxiliar impresso em papel com o objetivo de: a) Acompanhar o trnsito de mercadorias; b) Colher a firma do destinatrio/tomador para comprovao de entrega das mercadorias ou prestao de servios; c) Auxiliar a escriturao da NF-e no destinatrio no receptor de NF-e; O DANFE poder ser emitido em mais de uma folha, assim um DANFE poder ter tantas folhas quantas forem necessrias para discriminao das mercadorias, conforme leiaute descrito no Anexo II e III deste manual. O contribuinte poder utilizar at 50% da rea disponvel no verso do DANFE. O DANFE emitido no ambiente de homologao dever conter, em destaque, a frase SEM VALOR FISCAL. A legislao aplicvel para a emisso e preenchimento da nota fiscal modelo 1/1A tambm se aplica para o preenchimento do DANFE. A critrio da empresa, pode ser editado no DANFE o nmero do Protocolo de Autorizao de Uso recebido da SEFAZ.

Pg. 74 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

8. Contingncia
Durante a fase inicial do piloto, exclusivamente em casos de contingncia do Portal da Secretaria de Fazenda Estadual, as empresas emitiro as Notas Fiscais em formulrio contnuo, no sendo necessria a transmisso do arquivo da NF-e aps o trmino da contingncia. Ser utilizado o Web Service nfeStatusServico para identificar o status operacional do Portal da Secretaria de Fazenda Estadual. Para tempo de resposta, informado pela SEFAZ no retorno da consulta de Status, superior a 3 (trs) minutos ou ausncia de retorno, caber Empresa decidir pela utilizao do processo de contingncia definido no pargrafo anterior. Tambm atravs deste mtodo a Empresa dever identificar a sada do estado de contingncia. Antes de entrar em contingncia a Empresa tambm dever verificar o status operacional de sua rede interna.

Pg. 75 / 144

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. 76 / 144

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. 77 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

11. Compartilhamento de informaes da NF-e entre rgos Pblicos


O Protocolo de Cooperao n 03/2005 II ENAT de implantao da Nota Fiscal eletrnica prev o compartilhamento das NF-e entre as administraes tributrias da Unio, dos Estados, do Distrito Federal e dos Municpios. O compartilhamento das informaes ser realizado atravs do intercmbio dos seguintes arquivos digitais: NF-e: Nota Fiscal eletrnica e a respectiva autorizao ou denegao de uso; Cancelamento de NF-e: Pedido de Cancelamento de NF-e e a respectiva homologao do pedido; Inutilizao de numerao de NF-e: Pedido de Inutilizao de numerao de NF-e e a respectiva homologao do pedido.

As Notas Fiscais eletrnicas autorizadas ou denegadas e os pedidos de cancelamento de NF-e sero compartilhados com os seguintes rgos da administrao tributria interessados: 1. NF-e e respectiva autorizao ou denegao de uso 1.1 operao interna 1.2 operao interestadual 1.3 operao com destinatrio localizado na rea de incentivo fiscal administrada pela SUFRAMA 2. Pedido de cancelamento de NF-e e respectiva homologao do pedido 2.1 operao interna 2.2 operao interestadual 2.3 operao com destinatrio localizado na rea de incentivo fiscal administrada pela SUFRAMA Receita Federal
compartilhar compartilhar compartilhar

SEFAZ Destino
compartilhar compartilhar

SUFRAMA
compartilhar

Receita Federal
compartilhar compartilhar compartilhar

SEFAZ Destino
compartilhar compartilhar

SUFRAMA
compartilhar

Os pedidos de inutilizao de numerao de NF-e sero compartilhados somente com a Receita Federal.

11.1 Processo de Compartilhamento


O compartilhamento de informaes aos demais rgos interessados ser realizado atravs da transmisso dos arquivos digitais pela SEFAZ de circunscrio do contribuinte emissor da NF-e. O intercmbio de arquivos digitais ser realizada com o uso da REDE RIS que interliga as SEFAZ, a Receita Federal e a SUFRAMA de forma rpida e segura. A distribuio de documentos entre as SEFAZ e a SRF ser feita utilizando esta rede, atravs do utilitrio TED-DIST, seguindo a padronizao de nomes de arquivos que segue: NF-e: Nmero do Protocolo + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + -procNFe.xml. Exemplo: 143061234567890_v01.00-procNFe.xml.
Pg. 78 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Cancelamento de NF-e: Nmero do Protocolo + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + -procCancNFe.xml. Exemplo: 143061234567890_v01.00-procCancNFe.xml. Inutilizao de numerao de NF-e: Nmero do Protocolo + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + -procInutNFe.xml. Exemplo: 143061234567890_v01.00-procInutNFe.xml. Nota: O Nmero do Protocolo composto por: 1 posio (1 Secretaria de Fazenda Estadual, 2 Receita Federal) + 2 posies para cdigo da UF no IBGE + 2 posies ano + 10 seqencial no ano.

11.2 Leiaute de compartilhamento: NF-e


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 ou Denegao de Uso (item 4.2.2)

11.3 Leiaute de compartilhamento: Cancelamento de NF-e


Schema XML: procCancNFe_v99.99.xsd
# YR01 YR02 YR03 YR04 Campo procCancNFe versao cancNFe (dados) Ele Pai Tipo Ocor. Tam. Dec. Descrio/Observao Raiz TAG raiz A YR01 N 1-1 1-4 2 G YR01 1-1 Dados do Pedido de Cancelamento (item 4.3.1) G YR01 1-1 Dados da homologao do pedido (item 4.3.2)

YR05 retCancNfe YR06 (dados)

11.4 Leiaute de compartilhamento: Inutilizao de Numerao de NF-e


Schema XML: procInutNFe_v99.99.xsd
# ZR01 ZR02 ZR03 ZR04 ZR05 ZR06 Campo procInutNFe versao inutNFe (dados) retInutNfe (dados) Ele Pai Raiz A ZR01 G ZR01 G ZR01 Tipo N Ocor. Tam. 1-1 1-4 1-1 1-1 Dec. 2 Descrio/Observao TAG raiz
Dados do Pedido de Inutilizao (item 4.4.1) Dados da homologao do pedido (item 4.4.2)

11.5 Compartilhamento de documentos com outros rgos pblicos

Pg. 79 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

O compartilhamento da NF-e com as administraes tributrias municipais, nos casos de NF-e conjugada que envolva a prestao de servios ao ISSQN, depende da celebrao de prvio convnio ou protocolo de cooperao. A NF-e tambm poder ser compartilhada com outros rgos da administrao direita, indireta, fundaes e autarquias, que necessitem das informaes para desempenho de suas atividades, mediante prvio convnio ou protocolo de cooperao, respeitado o sigilo fiscal.

Pg. 80 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

12. Cadastro nacional de emissores de DF-e


O Cadastro nacional de emissores de DF-e ser formado com as informaes cadastrais dos contribuintes do ICMS autorizados a emitir Documento Fiscal eletrnico - DF-e. Este cadastro ser administrado pela Receita Federal e a incluso e excluso de emissor ser realizada pela SEFAZ de circunscrio do contribuinte emissor do DF-e. A SEFAZ dever transmitir um arquivo digital com os dados cadastrais do emissor e os modelos de documentos eletrnicos que o mesmo est autorizado a emitir. A mensagem de comunicao ser substitutiva comunicando o credenciamento de novos emissores e os descredenciamentos ocorridos. A atualizao da relao de documentos fiscais eletrnicos autorizados dever ser comandada atravs de uma mensagem de excluso e uma mensagem de incluso com a nova relao de documentos fiscais eletrnicos que o emissor est autorizado a emitir. A atualizao do cadastro dever ser realizada diariamente com base nos arquivos digitais recebidos no dia anterior, com a disponibilizao de um arquivo digital do cadastro nacional de emissores de DF-e atualizado na manh do dia seguinte. A Receita Federal deve gerar um arquivo de retorno para cada arquivo digital de comunicao de credenciamento de novos emissores ou descredenciamento de emissor com o resultado do processamento para a SEFAZ solicitante, devendo ser avaliado os seguintes aspectos: Pedido de Atualizao do Cadastro atende o schema XML; Situao e Validade do certificado digital utilizado na assinatura digital; Validade da assinatura digital; Certificado digital pertence UF solicitante; Validao de forma do CNPJ do emissor e do CNPJ matriz do emissor; Incluso de emissor j existente; Excluso de emissor inexistente.

A ocorrncia de qualquer erro ou inconstncia nas validaes acima implica na rejeio da do atendimento da atualizao solicitada pela UF, que dever sanar o problema e reenviar uma nova comunicao. As unidades federadas podero solicitar o cadastramento de rgo pblicos no Cadastro Nacional de Emissores com o objetivo exclusivo de acesso ao WS CadConsultaCadastro de consulta do cadastro de contribuintes, informando o campo mod com o valor '99'. O intercmbio de arquivos digitais ser realizada com o uso da REDE RIS que interliga as SEFAZ, a Receita Federal e a SUFRAMA. A distribuio de documentos entre as SEFAZ e a SRF ser feita utilizando esta rede, atravs do utilitrio TED-DIST, seguindo a padronizao de nomes de arquivos que segue: Atualiza Cadastro de Emissor de DF-e: Nmero do Comando + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + -atuCadEmiDFe.xml. Exemplo: 143061234567890_v01.00- atuCadEmiDFe.xml.
Pg. 81 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Retorno Atualiza Cadastro de Emissor de DF-e: Nmero do Comando + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + retAtuCadEmiNDe.xml. Exemplo: 143061234567890_v01.00- retAtuCadEmiDFe.xml. Cadastro Nacional de Emissor de DF-e: Nmero do Comando + _v + [Verso do arquivo de schema com 5 posies (ex: 99.99)] + -cadEmiDFe.xml. Exemplo: 143061234567890_v01.00- cadEmiDFe.xml. Nota: O Nmero do Comando composto por: 1 posio (1 Secretaria de Fazenda Estadual, 2 Receita Federal) + 2 posies para cdigo da UF no IBGE + 2 posies ano + 10 seqencial no ano.

12.1 Leiaute do Cadastro de Emissor de DF-e


Schema XML: cadEmiDFe_v1.01xsd
# Campo Ele
Raiz A G ID

Pai
O01 O01 O03

Tipo Ocor. Tam. Dec. Descrio/Observao


N C 1-1 1-1 1-1 1-4 2 TAG raiz Verso do leiaute Dados do cadastro de emissor - TAG a ser assinada Identificador da TAG a ser assinada, preencher o campo com o Nmero do Comando, precedido com o literal ID. Data de publicao do cadastro de emissores da DF-e Dados do emissor 2 14 14 2-14 2 Sigla da UF onde o emissor est autorizado a emitir os DF-e CNPJ do emissor CNPJ do estabelecimento matriz do emissor IE do emissor Documento Fiscal eletrnico autorizado Modelo do documento fiscal autorizado: 55 - Nota Fiscal eletrnica, 57 - Conhecimento de Transporte eletrnico. 99 - uso exclusivo do Fisco para incluso de qualquer rgo pblico no cadastro de emissores de DFe com objetivo de permitir o acesso ao WS - CadConsultaCadastro de Consulta Cadastro de Contribuintes do ICMS de qualquer unidade federada. Siutao do emissor: 0 - em homologao; 1 - em produo; Assinatura XML do grupo identificado pelo atributo ID

O01 cadEmiDFe O02 versao O03 infCadEmiDFe O04 Id

O05 dPubCad O06 emissor O07 UF O08 CNPJ O09 CNPJMatriz O10 IE O11 DFe O11a mod

E G E E E E G E

O03 O03 O06 O06 O06 O06 O06 O11

D C C C C N

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

O11b sit

O11

1-1

O12 Signature

O01

xml

1-1

12.2 Leiaute de Atualizao do Cadastro de Emissor de DF-e


Schema XML: atuCadEmiDFe_v99.99.xsd
# Campo Ele Pai Tipo Ocor. Tam. Dec. Descrio/Observao
Pg. 82 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

M01 atuCadEmiDFe M02 versao M03 infCadAtuEmiDFe M04 Id

Raiz A G ID

M01 M01 M03

N C

1-1 1-1 1-1

1-4 -

TAG raiz Verso do leiaute Dados da Atualizao de emissor - TAG a ser assinada Identificador da TAG a ser assinada, preencher o campo com o Nmero do Comando, precedido com o literal ID. Sigla da UF solicitante Incluso de novo Emissor Sigla da UF onde o emissor est autorizado a emitir NF-e CNPJ do emissor CNPJ do estabelecimento matriz do emissor IE do emissor Documento Fiscal eletrnico autorizado Modelo do documento fiscal autorizado: 55 - Nota Fiscal eletrnica, 99 - uso exclusivo do Fisco para incluso de qualquer rgo pblico no cadastro de emissores de DFe com objetivo de permitir o acesso ao WS - CadConsultaCadastro de Consulta Cadastro de Contribuintes do ICMS de qualquer unidade federada. Siutao do emissor: 0 - em homologao; 1 - em produo; Exclui dados do Emissor Sigla da UF onde o emissor est autorizado a emitir DF-e CNPJ do emissor Assinatura XML do grupo identificado pelo atributo ID

M05 UF M06 inclui M07 UF M08 CNPJ M09 CNPJMatriz M10 IE M11 DFe M11a mod

E CG E E E E G E

M03 M03 M06 M06 M06 M06 M06 M11

C C C C C N

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

2 2 14 14 2-14 2

M11b sit

M11

1-1

M12 exclui M13 UF M14 CNPJ M15 Signature

CG E E E

M03 M12 M12 M01

C C xml

1-1 1-1 1-1 1-1 2 14 -

12.3 Leiaute de Retorno de Atualizao de Cadastro de Emissor de DF-e


Schema XML: retAtuCadEmiDFe_v99.99.xsd
# Campo Ele
A G ID

Pai
N01 N01 N03

Tipo Ocor. Tam. Dec. Descrio/Observao


N C 1-1 1-1 1-1 1-4 2 TAG raiz Verso do leiaute Dados do Retorno da Atualizao de emissor TAG a ser assinada Identificador da TAG a ser assinada, preencher O campo com o Nmero do Comando, precedido com o literal ID. Sigla da UF onde o emissor est autorizado a emitir NF-e CNPJ do emissor Operao solicitada: 0 - incluso; 1 - excluso. Resultado da operao solicitada 0 - operao realizada com sucesso; 1 - Rejeio -mensagem invlida (erro de Schema); 21- Rejeio - certificado digital no atende o padro estabelecido pelo projeto;
Pg. 83 / 144

N01 retAtuCadEmiDFe Raiz N02 versao N03 infRetAtuCadEmi DFe N04 Id

N05 UF N06 CNPJ N07 ope

E E E

N03 N03 N03

C C N

1-1 1-1 1-1

2 14 1

N08 resOpe

N03

1-1

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

22 - Rejeio - certificado digital utilizado na assinatura revogado; 23 - Rejeio - certificado digital utilizado na assinatura expirado; 24 - Rejeio - certificado digital utilizado no pertence a UF solicitante; 25 - Rejeio - assinatura digital invlida; 31 - Rejeio -CNPJ emissor invlido; 32 - Rejeio-CNPJ matriz invlido; 41 - Incluso no atendida - J existe um emissor com o CNPJ informado; 42 - excluso no atendida - no existe emissor com CNPJ informado; N09 Signature E N01 xml 1-1 Assinatura XML do grupo identificado pelo atributo ID

Pg. 84 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo I Leiaute da NF-e


Diagrama simplificado dos grupos de informaes da NF-e

Pg. 85 / 144

Nota Fiscal Eletrnica Schema XML: nfe_v99.99.xsd


# ID Campo Descrio

Manual de Integrao - Contribuinte

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 Cdigo da UF do emitente do Documento Fiscal. Utilizar a Tabela do IBGE de cdigo de unidades da federao (Anexo VII - 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. 86 / 144

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

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


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

9 10 11 12 13 14 15 16

B05 B06 B07 B08 B09 B10 B11 B12

indPag mod serie nNF dEmi dSaiEnt tpNF cMunFG

Indicador da forma de pagamento 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 Informao das NF/NF-e referenciadas

E E E E E E E E

B01 B01 B01 B01 B01 B01 B01 B01

N C N N D D N N

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

1 2 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

B01

0-N

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

Pg. 87 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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. 88 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

19 20 21 22 23 24 25 26 27

B15 B16 B17 B18 B19 B20 B21 B22 B23

cUF AAMM CNPJ mod serie nNF tpImp tpEmis cDV

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 Dgito Verificador da Chave de Acesso da NF-e

E E E E E E E E E

B14 B14 B14 B14 B14 B14 B01 B01 B01

N N C N N N N N N

1-1 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 1

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 referenciada no uma NF-e). Utilizar a Tabela do IBGE (Anexo VII - Tabela de UF, Municpio e Pas) AAMM da emisso da NF-e 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/ 2-Contingncia 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) 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).
Pg. 89 / 144

Nota Fiscal Eletrnica


# #

Manual de Integrao - Contribuinte


Descrio Descrio Ele Ele Pai Pai Tipo Tipo Ocorrncia Ocorrncia tamanho tamanho Dec. Dec

ID ID

Campo Campo

Observao 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 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 33 34 35 36 37 38 39

C03 C04 C05 C06 C07 C08 C09 C10

xNome xFant enderEmit xLgr nro xCpl xBairro cMun

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

E E G E E E E E

C01 C01 C01 C05 C05 C05 C05 C05

C C C C C C N

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

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

40 41

C11 C12

xMun UF

Nome do municpio Sigla da UF

E E

C05 C05

C C

1-1 1-1

1-60 2

Utilizar a Tabela do IBGE (Anexo VII - 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.
Pg. 90 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

42 43 44 45 46 47

C13 C14 C15 C16 C17 C18

CEP cPais xPais fone IE IEST

Cdigo do CEP Cdigo do Pas Nome do Pas Telefone IE IE do Substituto Tributrio

E E E E E E

C05 C05 C05 C05 C01 C01

N N C N C C

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

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

Observao Informar os zeros no significativos. Utilizar a Tabela do BACEN (Anexo VII - Tabela de UF, Municpio e Pas).

Preencher com Cdigo DDD + nmero do telefone.


Campo de informao obrigatria nos casos de emisso prpria (procEmi = 0, 2 ou 3). 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.
Dec

48

C19

IM

Inscrio Municipal

C01

0-1

1-15

49

C20

CNAE

CNAE fiscal

C01

0-1

D - Identificao do Fisco Emitente da NF-e


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho

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 Sigla da UF Nmero do Documento de E E E E E E E

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

0-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

Observao Informaes do fisco emitente, grupo de uso exclusivo do fisco. Informar os zeros no significativos.

Preencher com Cdigo DDD + nmero do telefone

Pg. 91 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao Formato AAAA-MM-DD

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
# ID Campo Descrio

E E E E

D01 D01 D01 D01

D N C D

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

1-15 1-60 2

Formato AAAA-MM-DD 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.

Ele

Pai

Tipo

Ocorrncia

tamanho

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

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

1-60

C C C C N

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

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

Utilizar a Tabela do IBGE (Anexo VII - Tabela de UF, Municpio e


Pg. 92 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

72 73 74 75 76 77 78

E11 E12 E13 E14 E15 E16 E17

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

E05 E05 E05 E05 E05 E05 E01

C C N N C N C

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

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

Observao 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 VII - Tabela de UF, Municpio e Pas).

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. 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 comprovao do ingresso/internamento da
Pg. 93 / 144

79

E18

ISUF

Inscrio na SUFRAMA

E01

0-1

1-9

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao 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 81 82 83 84 85 86

F01 F02 F03 F04 F05 F06 F07

retirada CNPJ xLgr nro xCpl xBairro cMun

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

G E E E E E E

A01 F01 F01 F01 F01 F01 F01 C C C C C N

0-1 1-1 1-1 1-1 0-1 1-1 1-1 14 1-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

1-60 2

Utilizar a Tabela do IBGE (Anexo VII - 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 90 91 92 93 94 95

G01 G02 G03 G04 G05 G06 G07

entrega CNPJ xLgr nro xCpl xBairro cMun

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

G E E E E E E

A01 G01 G01 G01 G01 G01 G01 C C C C C N

0-1 1-1 1-1 1-1 0-1 1-1 1-1 14 1-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 VII - Tabela de UF, Municpio e Pas). Informar 9999999 para operaes
Pg. 94 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

96 97
#

G08 G09

xMun UF

Nome do municpio Sigla da UF

E E

G01 G01

C C

1-1 1-1

1-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 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. 95 / 144

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

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 105 106

I04 I05 I06 I07

xProd NCM EXTIPI genero

Descrio do produto ou servio Cdigo NCM EX_TIPI Gnero do Produto ou Servio

E E E E

I01 I01 I01 I01

C C C N

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

1-120 8 2-3 2

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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.

112 113 113a 114 115 116 117 118 119 120 121 122 123

I13 I14 I14a I15 I16 I17 I18 I19 I20 I21 I22 I23 I24

uTrib qTrib vUnTrib vFrete vSeg vDesc DI nDI dDi xLocDesemb UFDesemb dDesemb cExportador

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 E E E E E

I01 I01 I01 I01 I01 I01 I01 I18 I18 I18 I18 I18 I18

C N N N N N C D C C D C

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

1-6 12 16 15 15 15 1-10

4 4 2 2 2

Informar o valor unitrio de tributao do produto

Informar dados da importao

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

Pg. 96 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao sistemas internos de informao do emitente da NF-e

124 125 126 127 128


#

I25 I26 I27 I28 I29

adi nAdicao nSeqAdic cFabricante vDescDI

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

G E E E E

I18 I25 I25 I25 I25

N N C N

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

1-3 1-3 1-60 15 2 Observao Informar apenas quando se tratar de veculos novos 1 Venda concessionria, 2 Faturamento direto 3 Venda direta 0 Outros Cdigo de cada montadora Cdigo do fabricante estrangeiro, usado nos sistemas internos de informao do emitente da NF-e

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


ID Campo Descrio

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

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 N 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. 97 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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 E
Ele

J01 J01 J01 J01 J01


Pai

N
C N

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


Ocorrncia

2 1 1 1 6
tamanho Dec

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


# ID Campo Descrio

N
Tipo

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 153 154

K01 K02 K03

med nLote qLote

TAG de grupo do detalhamento de Medicamentos

CG E E E E E
Ele

I01 K01 K01 K01 K01 K01


Pai

0-N C N D D N
Tipo

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

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 159 160 161 162

L01 L02 L03 L04 L05

arma tpArma nSerie nCano descr

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

CG E E E E

I01 L01 L01 L01 L01 N N N C

0-N 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. 98 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

162a 162b

L101 L102

comb cProdANP

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

G CE

I01 L101

N N

0-1 0-1

1 9

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. 99 / 144

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 ICMS

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

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


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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 Observao Informar apenas um dos grupos N02, N03, N04, N05, N06, N07, N08, N09 ou N10, com base no contedo informado na TAG CST

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

Pg. 100 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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 Valor da BC do ICMS Alquota do imposto Valor do ICMS TAG de grupo do CST = 10

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. 101 / 144

169 170 171 172

N15 N16 N17 N03

vBC pICMS vICMS ICMS10

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


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

173

N11

orig

Origem da mercadoria

N03

1-1

174 175

N12 N13

CST modBC

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

E E

N03 N03

N N

1-1 1-1

2 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

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 N

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

5 5 15 5 15 1

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

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

187 188

N12 N13

CST modBC

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 TAG de grupo do CST = 30 Origem da mercadoria

E E

N04 N04

N N

1-1 1-1

2 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 194

N14 N15 N16 N17 N05 N11

pRedBC vBC pICMS vICMS ICMS30 orig

E E E E CG E

N04 N04 N04 N04 N01 N05

N N N N

1-1 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

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. 103 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao 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.

199 200 201 202 203

N21 N22 N23 N06 N11

vBCST pICMSST vICMSST ICMS40 orig

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 E

N05 N05 N05 N01 N06

N N N

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

15 5 15

2 2 2

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 Percentual da Reduo de BC Valor da BC do ICMS Alquota do imposto Valor do ICMS TAG de grupo do CST = 60

E E

N07 N07

N N

1-1 0-1

2 1

209 210 211 212 213

N14 N15 N16 N17 N08

pRedBC vBC pICMS vICMS ICMS60

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. 104 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

214

N11

orig

Origem da mercadoria

N08

1-1

215 216 217 218 219

N12 N21 N23 N09 N11

CST vBCST vICMSST ICMS70 orig

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

E E E CG E

N08 N08 N08 N01 N09

N N N

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

2 15 15 2 2

1-1

220

N12

CST

Tributao do ICMS

N09

1-1

221

N13

modBC

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

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

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. 105 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

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 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

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

N14 N15 N16 N17 N18

pRedBC vBC pICMS vICMS modBCST

E E E E E

N10 N10 N10 N10 N10

N N N N N

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

5 15 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); 2
Pg. 106 / 144

241

N19

pMVAST

Percentual da margem de valor

N10

0-1

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

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

E E E E
Ele

N10 N10 N10 N10


Pai

N N N N
Tipo

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


Ocorrncia

5 15 5 15
tamanho

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 248

O01 O02 O03

IPI clEnq CNPJProd

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 Quantidade de selo de controle Cdigo de Enquadramento Legal do IPI TAG de grupo do CST 00, 49, 50 e 99

G E E

M01 O01 O01 C C

0-1 0-1 0-1 5 14

249 250 251 252

O04 O05 O06 O07

cSelo qSelo cEnq IPITrib

E E E CG

O01 O01 O01 O01

C N C

0-1 0-1 1-1 1-1 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

Pg. 107 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

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 O13 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. 108 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

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

N C

1-1 1-1 1-1

15 2

2 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

P01 P02

II vBC

TAG de grupo do Imposto de Importao Valor da BC do Imposto de Importao

G E

M01 P01 N

0-1 1-1 15 2

Observao Informar apenas quando o item for sujeito ao II

Pg. 109 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

264 265 266 Q PIS


#

P03 P04 P05

vDespAdu vII vIOF

Valor das despesas aduaneiras Valor do Imposto de Importao Valor do Imposto sobre Operaes Financeiras

E E E

P01 P01 P01

N N N

1-1 1-1 1-1

15 15 15

2 2 2

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

Pg. 110 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

268 269

Q02 Q06

PISAliq CST

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

CG E

Q01 Q02 N

1-1 1-1 2

CST = 01 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
Pg. 111 / 144

270 271

Q07 Q08

vBC pPIS

Valor da Base de Clculo do PIS Alquota do PIS (em percentual)

E E

Q02 Q02

N N

1-1 1-1

15 5

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao CST = 03

272 273 274 275 276 277 278 279

Q09 Q03 Q06 Q10 Q11 Q09 Q04 Q02

vPIS PISQtde CST qBCProd vAliqProd vPIS PISNT CST

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 CG E E E E G E

Q02 Q01 Q03 Q03 Q03 Q03 Q01 Q04

N N N N N N

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

15 2 16 15 15 2

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 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 4 Informar campos para clculo do PIS em percentual (P07 e P08) ou campos para PIS em valor (P10 e P11).

280 281 282 283 284 285

Q05 Q06 Q07 Q08 Q10 Q11

PISOutr CST vBC pPIS qBCProd vAliqProd

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

G E CE CE CE CE

Q01 Q05 Q05 Q05 Q05 Q05 N N N N N

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

Pg. 112 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

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 Informar campos para clculo do PIS em percentual (R02 e R03) ou campos para PIS em valor (R04 e R05).

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

292 R06 S COFINS


# ID

vPIS
Campo

Valor do PIS
Descrio

E
Ele

R01
Pai

N
Tipo

1-1
Ocorrncia

15
tamanho

2
Dec

293

S01

COFINS

TAG de grupo do COFINS

M01

1-1

Observao Informar apenas um dos grupos


Pg. 113 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao 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

G 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 clculo = valor da operao
Pg. 114 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao (alquota diferenciada));

296 297 298 299 300 301 302 303 304 305

S07 S08 S11 S03 S06 S09 S10 S11 S04 S06

vBC pCOFINS vCOFINS COFINSQtde CST qBCProd vAliqProd vCOFINS COFINSNT 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 G E E E E G E

S02 S02 S02 S01 S03 S03 S03 S03 S01 S04

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

15 5 15 2 16 15 15 2

2 2 2 CST = 03 03 - Operao Tributvel (base de clculo = quantidade vendida x alquota por unidade de produto); 4 4 2 CST = 04, 06, 07, 08 ou 09 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. 115 / 144

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

G 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


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

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 Informar campos para clculo do COFINS Substituio Tributria em percentual (T02 e T03) ou campos para COFINS em valor (T04 e T05).

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

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 VII 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.

Pg. 116 / 144

Nota Fiscal Eletrnica


# #

Manual de Integrao - Contribuinte


Descrio Descrio Ele Ele Pai Pai Tipo Tipo Ocorrncia Ocorrncia tamanho tamanho Dec. Dec

ID ID

Campo Campo

Observao Observao

W - Valores Totais da NF-e 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 W01 W02 W03 W04 W05 W06 W07 W08 W09 W10 W11 W12 W13 W14 W15 W16 W17 W18 W19 W20 W21 W22 W23 W24 W25 W26 total ICMSTot vBC vICMS vBCST vST vProd vFrete vSeg vDesc vII vIPI vPIS vCOFINS vOutro vNF ISSQNtot vServ vBC vISS vPIS vCOFINS retTrib vRetPIS vRetCOFINS vRetCSLL 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 G G E E E E E E E E E E E E E E G E E E E E G E E E A01 W01 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W02 W01 W17 W17 W17 W17 W17 W01 W23 W23 W23 N N N N N N N N 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 0-1 0-1 0-1 0-1 0-1 0-1 0-1 0-1 15 15 15 15 15 15 15 15 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 2 2 2 2 2 2 2 2 Exemplos de atos normativos que definem obrigatoriedade da reteno de contribuies:
Pg. 117 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

352 353 354 355

W27 W28 W29 W30

vBCIRRF vIRRF vBCRetPrev vRetPrev

Base de Clculo do IRRF Valor Retido do IRRF Base de Clculo da Reteno da Previdncia Social Valor da Reteno da Previdncia Social

E E E E

W23 W23 W23 W23

N N N N

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

15 15 15 15

2 2 2 2

Observao a) IRPJ/CSLL/PIS/COFINS - Fonte - Recebimentos de rgos 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 0 por conta do emitente; 1 por conta do destinatrio; Informar o CNPJ ou o CPF do Transportador, preenchendo os zeros no significativos.

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 C C

1-1 1-1 0-1 0-1 0-1 1 14 11

Pg. 118 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

361 362 363 364 365 366 367 368 369 370 371 372

X06 X07 X08 X09 X10 X11 X12 X13 X14 X15 X16 X17

xNome IE xEnder xMun UF retTransp vServ vBCRet pICMSRet vICMSRet CFOP cMunFG

Razo Social ou nome 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 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

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

X03 X03 X03 X03 X03 X01 X11 X11 X11 X11 X11 X11

C C C C C C C C C C
C

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

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

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 VII - Tabela de UF, Municpio e Pas)

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

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

veicTransp placa UF RNTC reboque placa UF RNTC vol qVol esp marca

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

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

C C C C C C N 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

1-8 2 1-20 1-8 2 1-20 15 1-60 1-60


Pg. 119 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

385

X30

nVol

386 X31 pesoL 387 X32 pesoB 387a X33 lacres 388 X34 nLacre Y Dados da Cobrana
# ID Campo

Numerao dos volumes transportados Peso Lquido (em kg) Peso Bruto (em kg) TAG de grupo de Lacres Nmero dos Lacres
Descrio

E E E G E
Ele

X26 X26 X26 X26 X33


Pai

C N N C
Tipo

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


Ocorrncia

1-60 15 15 1-60
tamanho Dec

3 3

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 Identificao do campo Contedo do campo TAG de grupo do campo de uso livre do Fisco

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
Pg. 120 / 144

401b 401c 401d

Z05 Z06 Z07

xCampo xTexto obsFisco

A E G

Z04 Z04 Z01

C C

1-1 1-1 0-10

1-20 1-60

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

401e 401f 401g

Z08 Z09 Z10

xCampo xTexto procRef

Identificao do campo Contedo do campo Tag de grupo do processo referenciado Indentificador do processo ou ato concessrio Indicador da origem do processo

A E G

Z07 Z07 Z01

C C

1-1 1-1 0-N

1-20 1-60

401h 401i

Z11 Z12

nProc indProc

E E

Z10 Z10

C N

1-1 1-1

1-60 1

Observao 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 Indentificador do processo ou ato concessrio Origem do processo, informar com: 0 - SEFAZ; 1 - Justia Federal; 2 - Justia Estadual; 3 - Secex/RFB; 9 - Outros Observao Informar apenas na exportao.

ZA - Informaes de Comrcio Exterior


# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec

402 403 404


#

ZA01 ZA02 ZA03

exporta UFEmbarq xLocEmbarq

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

G E E

A01 ZA01 ZA01

C C

0-1 1-1 1-1

2 1-60 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
Dec

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

405 406 407

ZB01 ZB02 ZB03

compra xNEmp xPed

TAG do Grupo de Compra Nota de Empenho Pedido

G E E E

A01 ZB01 ZB01 ZB01


Pai

C C C
Tipo

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


Ocorrncia

1-17 1-60 1-60


tamanho

408 ZB04 xCont Contrato ZC - Informaes da Assinatura Digital


# ID Campo Descrio

Ele

Observao

409

ZC01

Signature

Assinatura XML da NF-e

A01

1-1
Pg. 121 / 144

Nota Fiscal Eletrnica


#

Manual de Integrao - Contribuinte


Descrio Ele Pai Tipo Ocorrncia tamanho Dec.

ID

Campo

Observao

Segundo o Padro XML Digital Signature

Pg. 122 / 144

Nota Fiscal Eletrnica


OBSERVAES:

Manual de Integrao - Contribuinte

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. 123 / 144

Nota Fiscal Eletrnica


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

Manual de Integrao - Contribuinte

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 S N N N N N N

S S N N N N N S 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

* 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. 124 / 144

Nota Fiscal Eletrnica


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;

Manual de Integrao - Contribuinte

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. 125 / 144

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 EaF AaC AaB JaK AaF AaD KaL BaI BaG LaO CaJ CaJ

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

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. 126 / 144

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 4. Regras de preenchimento dos campos da Nota Fiscal Eletrnica:

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

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. 127 / 144

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 VII 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. 128 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo II Modelo de DANFE - retrato

Pg. 129 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Pg. 130 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Pg. 131 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo III Modelo de DANFE - paisagem

Pg. 132 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Pg. 133 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Pg. 134 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo IV WS disponveis Bahia:


Ambiente de homologao:

NfeRecepcao - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeRecepcao.asmx NfeRetRecepcao - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeRetRecepcao.asmx NfeCancelamento - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeCancelamento.asmx NfeInutilizacao - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeInutilizacao.asmx NfeStatusServico - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeStatusServico.asmx NfeConsultaNfe - https://hnfe.sefaz.ba.gov.br/webservices/nfe/NfeConsulta.asmx

Ambiente de produo:

NfeRecepcao - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeRecepcao.asmx NfeRetRecepcao - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeRetRecepcao.asmx NfeCancelamento - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeCancelamento.asmx NfeInutilizacao - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeInutilizacao.asmx NfeStatusServico - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeStatusServico.asmx NfeConsultaNfe - https://nfe.sefaz.ba.gov.br/webservices/nfe/NfeConsulta.asmx

Gois:
Ambiente de homologao:

NfeRecepcao - https://homolog.sefaz.go.gov.br/nfe/services/NfeRecepcao NfeRetRecepcao - https://homolog.sefaz.go.gov.br/nfe/services/NfeRetRecepcao NfeCancelamento - https://homolog.sefaz.go.gov.br/nfe/services/NfeCancelamento NfeInutilizacao - https://homolog.sefaz.go.gov.br/nfe/services/NfeInutilizacao NfeConsultaNF - https://homolog.sefaz.go.gov.br/nfe/services/NfeConsulta NfeStatusServico - https://homolog.sefaz.go.gov.br/nfe/services/NfeStatusServico
Pg. 135 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Ambiente de produo:

NfeRecepcao - https://nfe.sefaz.go.gov.br/nfe/services/NfeRecepcao NfeRetRecepcao - https://nfe.sefaz.go.gov.br/nfe/services/NfeRetRecepcao NfeCancelamento - https://nfe.sefaz.go.gov.br/nfe/services/NfeCancelamento NfeInutilizacao - https://nfe.sefaz.go.gov.br/nfe/services/NfeInutilizacao NfeConsultaNF - https://nfe.sefaz.go.gov.br/nfe/services/NfeConsulta NfeStatusServico - https://nfe.sefaz.go.gov.br/nfe/services/NfeStatusServico

Maranho:
Ambiente de produo:

NfeRecepcao - https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeRecepcao NfeRetRecepcao https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeRetRecepcao NfeCancelamento https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeCancelamento NfeInutilizacao - https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeInutilizacao NfeConsultaNF - https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeConsultaNF NfeStatusServico - https://nfe.sefaz.ma.gov.br/wsnfe/services/GerenciadorWebService/NfeStatusServico

Rio Grande do Sul:


Ambiente de homologao:

NfeRecepcao - https://homologacao.nfe.sefaz.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx NfeRetRecepcao - https://homologacao.nfe.sefaz.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx NfeCancelamento - https://homologacao.nfe.sefaz.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx NfeInutilizacao - https://homologacao.nfe.sefaz.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx NfeConsultaNF - https://homologacao.nfe.sefaz.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx NfeStatusServico - https://homologacao.nfe.sefaz.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx
Pg. 136 / 144

Ambiente de produo:

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

NfeRecepcao - https://nfe.sefaz.rs.gov.br/ws/nferecepcao/NfeRecepcao.asmx NfeRetRecepcao - https://nfe.sefaz.rs.gov.br/ws/nferetrecepcao/NfeRetRecepcao.asmx NfeCancelamento- https://nfe.sefaz.rs.gov.br/ws/nfecancelamento/NfeCancelamento.asmx NfeInutilizacao - https://nfe.sefaz.rs.gov.br/ws/nfeinutilizacao/NfeInutilizacao.asmx NfeConsultaNF - https://nfe.sefaz.rs.gov.br/ws/nfeconsulta/NfeConsulta.asmx NfeStatusServico - https://nfe.sefaz.rs.gov.br/ws/nfestatusservico/NfeStatusServico.asmx

Santa Catarina:
Ambiente de homologao:

NfeRecepcao - https://nfe.sef.sc.gov.br/nferecepcao/NfeRecepcao.asmx NfeRetRecepcao - https://nfe.sef.sc.gov.br/NFeRetRecepcao/NfeRetRecepcao.asmx NfeCancelamento - https://nfe.sef.sc.gov.br/NFecancelamento/NfeCancelamento.asmx NfeInutilizacao - https://nfe.sef.sc.gov.br/NFeInutilizacao/NfeInutilizacao.asmx NfeConsultaNF - https://nfe.sef.sc.gov.br/NFeConsulta/NfeConsulta.asmx NfeStatusServico - https://nfe.sef.sc.gov.br/NFeStatusServico/NfeStatusServico.asmx

So Paulo:
Ambiente de homologao:

NfeRecepcao - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeRecepcaoSoap NfeRetRecepcao - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeRetRecepcaoSoap NfeCancelamento - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeCancelamentoSoap NfeInutilizacao - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeInutilizacaoSoap NfeConsultaNF - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeConsultaSoap NfeStatusServico - https://homologacao.nfe.fazenda.sp.gov.br/nfeWEB/services/NfeStatusServicoSoap

Ambiente de produo:
Pg. 137 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

NfeRecepcao - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeRecepcaoSoap NfeRetRecepcao - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeRetRecepcaoSoap NfeCancelamento - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeCancelamentoSoap NfeInutilizacao - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeInutilizacaoSoap NfeConsultaNF - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeConsultaSoap NfeStatusServico - https://nfe.fazenda.sp.gov.br/nfeWEB/services/NfeStatusServicoSoap

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 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo V 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 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo VI 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 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

Anexo VII 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/2006/DTB_2006.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 / 144

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 / 144

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

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

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.
Pg. 143 / 144

Nota Fiscal Eletrnica

Manual de Integrao - Contribuinte

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

Pg. 144 / 144

Você também pode gostar