manual integracao contribuinte 4.01-nt2009

Nota Fiscal EletrnicaManual de Integrao - Contribuinte

Projeto Nota Fiscal Eletrnica

Manual de Integrao - ContribuintePadres Tcnicos de Comunicao

Verso 4.0.1-NT2009.006 Dezembro 2009

Pg. 1 / 232


Controle de VersesVerso 0.1.0 1.0.0 1.0.1 1.0.2 1.1.0 1.1.1 Data 16/12/2005 SC 06/01/2006 SP 11/01/2006 GO 19/01/2006 SP 26/01/2006 SP 30/05/2006 SP consolidao das seguintes erratas: Errata 13-03-2006 Errata 21-03-2006 Errata 05-05-2006 Errata 08-05-2006 Errata 25-05-2006 27/11/2006 SP/RS 23/04/2007 SP/RS/GO 29/06/2007 - SP/RS 16/06/2008 - SP 16/03/2009 SP/RS 21/09/2009 SP/RS 03/11/2009 SP/RS Errata da verso 4.0 Dez/2009 com atualizaes da NT 2009/006 Ato COTEPEAto COTEPE/ICMS N 72, de 20.12.2005

2.0.0 2.0.1 2.0.2 2.0.2a 3.0 4.0 4.0.1 4.0.1-NT200906

Ato COTEPE/ICMS N 14, de 12.11.2007 Ato COTEPE/ICMS N 22, de 25.06.2008 Ato COTEPE/ICMS n 3, de 19.03.2009 Ato COTEPE/ICMS n 39, de 19.11.2009 Ato COTEPE/ICMS N 49, de 27.11.2009

Pg. 2 / 232


Identificao e vigncia do ManualVerso do manual Data de divulgao da verso inicial do manual Data de divulgao da verso corrigida 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_005d

4.01-NT200906 21/09/2009 dezembro/2009 PL_006c Janeiro/2010 01/04/2010 PL_005d 30/09/2010

Este documento a verso 4.01 do Manual de Integrao do Contribuinte atualizada com as correes e aperfeioamentos divulgados atravs da NT 2009/006, estando sujeito novas atualizaes at a publicao da verso 4.02 definitiva que ser realizada oportunamente.

Verses de leiautes do PL_006cLeiaute NFe enviNFe retEnviNFe consReciNFe retconsReciNFe procNFe cancNFe retCancNFe procCancNFe inutNFe retInutNFe procInutNFe consSitNFe retconsSitNFe consStatServ retConsStatServ consCad retConsCad verso 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 2.00 Observao Leiaute 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. Leiaute de compartilhamento da NF-e. Mensagem de solicitao de cancelamento da NF-e. Mensagem de retorno da solicitao 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 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.

Pg. 3 / 232


ndiceIntroduo ......................................................................................................... 9 Consideraes Iniciais ..................................................................................... 10 2.1 Objetivos do Projeto ............................................................................................. 10 2.2 Conceito da NF-e ................................................................................................. 10 2.3 Descrio Simplificada do Modelo Operacional .................................................... 10 3. Arquitetura de Comunicao com Contribuinte ................................................ 12 3.1 Modelo Conceitual ................................................................................................ 12 3.2 Padres Tcnicos................................................................................................. 13 3.2.1 Padro de Documento XML.............................................................................. 13 3.2.2 Padro de Comunicao .................................................................................. 15 3.2.3 Padro de Certificado Digital ............................................................................ 16 3.2.4 Padro de Assinatura Digital ............................................................................ 16 3.2.5 Validao de Assinatura Digital pela Secretaria de Fazenda Estadual ............. 18 3.2.6 Resumo dos Padres Tcnicos ........................................................................ 19 3.3 Modelo Operacional ............................................................................................. 20 3.3.1 Servios Sncronos ........................................................................................... 20 3.3.2 Servios Assncronos ....................................................................................... 21 3.3.3 Filas e Mensagens ........................................................................................... 22 3.4 Padro de Mensagens dos Web Services ............................................................ 23 3.4.1 Informao de Controle e rea de Dados das Mensagens ............................... 23 3.4.2 Validao da Estrutura XML das Mensagens dos Web Services ...................... 24 3.4.3 Schemas XML das Mensagens dos Web Services ........................................... 24 3.5 Verso dos Schemas ........................................................................................... 25 3.5.1 Liberao das Verses dos Schemas para o Projeto da NF Eletrnica ............ 25 3.5.2 Controle de Verso........................................................................................... 26 3.6 SEFAZ VIRTUAL.................................................................................................. 26 4. Web Services .................................................................................................. 27 4.1 Web Service NfeRecepcao2 .............................................................................. 28 4.1.1 Leiaute Mensagem de Entrada ......................................................................... 28 4.1.2 Leiaute Mensagem de Retorno......................................................................... 28 4.1.3 Descrio do Processo de Recepo de Lotes de NF-e ................................... 29 4.1.4 Validao do Certificado de Transmisso ......................................................... 29 4.1.5 Validao Inicial da Mensagem no Web Service .............................................. 30 4.1.6 Gerao da Resposta com o Recibo ................................................................ 30 4.1.7 Descrio do Processamento do Lote de NF-e................................................. 31 4.1.8 Validao das informaes de controle da chamada ao Web Service .............. 31 4.1.9 Validao da rea de Dados ............................................................................ 32 4.1.10 Final do Processamento do Lote .................................................................. 44 4.2 Web Service NfeRetRecepcao2 ........................................................................ 45 4.2.1 Leiaute Mensagem de Entrada ......................................................................... 45 4.2.2 Leiaute Mensagem de Retorno......................................................................... 45 4.2.3 Descrio do Processo de Web Service ........................................................... 47 4.2.4 Validao do Certificado de Transmisso ......................................................... 47 4.2.5 Validao Inicial da Mensagem no Web Service .............................................. 48 4.2.6 Validao das informaes de controle da chamada ao Web Service .............. 48 4.2.7 Validao da rea de Dados ............................................................................ 48 4.2.8 Final do Processamento ................................................................................... 49 4.2.9 Canal de Comunicao com Contribuinte ......................................................... 50 4.3 Web Service NfeCancelamento2 ....................................................................... 51 4.3.1 Leiaute Mensagem de Entrada ......................................................................... 51 4.3.2 Leiaute Mensagem de Retorno......................................................................... 51 4.3.3 Descrio do Processo de Web Service ........................................................... 52Pg. 4 / 232

1. 2.


4.3.4 Validao do Certificado de Transmisso ......................................................... 52 4.3.5 Validao Inicial da Mensagem no Web Service .............................................. 53 4.3.6 Validao das informaes de controle da chamada ao Web Service .............. 54 4.3.7 Validao da rea de Dados ............................................................................ 54 4.3.8 Final do Processamento ................................................................................... 56 4.4 Web Service NfeInutilizacao2 ............................................................................ 57 4.4.1 Leiaute Mensagem de Entrada ......................................................................... 57 4.4.2 Leiaute Mensagem de Retorno......................................................................... 58 4.4.3 Descrio do Processo de Web Service ........................................................... 58 4.4.4 Validao do Certificado de Transmisso ......................................................... 59 4.4.5 Validao Inicial da Mensagem no Web Service .............................................. 59 4.4.6 Validao das informaes de controle da chamada ao Web Service .............. 60 4.4.7 Validao da rea de Dados ............................................................................ 60 4.4.8 Final do Processamento ................................................................................... 62 4.5 Web Service NfeConsulta2 Protocolo ................................................................ 63 4.5.1 Leiaute Mensagem de Entrada ......................................................................... 63 4.5.2 Leiaute Mensagem de Retorno......................................................................... 63 4.5.3 Descrio do Processo de Web Service ........................................................... 64 4.5.4 Validao do Certificado de Transmisso ......................................................... 64 4.5.5 Validao Inicial da Mensagem no Web Service .............................................. 65 4.5.6 Validao das informaes de controle da chamada ao Web Service .............. 65 4.5.7 Validao da rea de Dados ............................................................................ 66 4.5.8 Final do Processamento ................................................................................... 66 4.6 Web Service NfeStatusServico2 ........................................................................ 67 4.6.1 Leiaute Mensagem de Entrada ......................................................................... 67 4.6.2 Leiaute Mensagem de Retorno......................................................................... 67 4.6.3 Descrio do Processo de Web Service ........................................................... 68 4.6.4 Validao do Certificado de Transmisso ......................................................... 68 4.6.5 Validao Inicial da Mensagem no Web Service .............................................. 69 4.6.6 Validao das informaes de controle da chamada ao Web Service .............. 69 4.6.7 Validao da rea de Dados ............................................................................ 70 4.6.8 Final do Processamento ................................................................................... 70 4.7 Web Service CadConsultaCadastro2 ................................................................ 71 4.7.1 Leiaute da Mensagem de Entrada .................................................................... 71 4.7.2 Leiaute da Mensagem de Retorno .................................................................... 72 4.7.3 Descrio do Processo de Web Service ........................................................... 74 4.7.4 Verificao do Certificado de Transmisso ....................................................... 74 4.7.5 Verificao Inicial da Mensagem no Web Service ............................................ 75 4.7.6 Validao das informaes de controle da chamada ao Web Service .............. 75 4.7.7 Validao da rea de Dados ............................................................................ 76 4.7.8 Final do Processamento ................................................................................... 77 5. Web Service Informaes Adicionais ............................................................ 78 5.1 Regras de validao ............................................................................................. 78 5.1.1 Tabela de Cdigos de Erros e Descries de Mensagens de Erros ................. 78 5.2 Padro de Nomes para os Arquivos ..................................................................... 82 5.3 Tratamento de Caracteres Especiais no Texto de XML ........................................ 83 5.4 Chave de Acesso da NF-e ................................................................................... 84 5.5 Nmero do Recibo de Lote ................................................................................... 85 5.6 Nmero do Protocolo............................................................................................ 86 5.7 Tempo Mdio de Resposta................................................................................... 86 6. Cdigo de Barra .............................................................................................. 87 6.1 Clculo do Dgito Verificador do CODE-128C....................................................... 88 6.2 Representao Simblica do Cdigo.................................................................... 89 7. DANFE ............................................................................................................ 90Pg. 5 / 232


7.1 Campos do DANFE .............................................................................................. 90 7.1.1 Chave de Acesso ............................................................................................. 90 7.1.2 Dados da NF-e ................................................................................................. 91 7.1.3 Dados do Emitente ........................................................................................... 91 7.1.4 Quadro Fatura/Duplicatas ................................................................................. 91 7.1.5 Quadro Dados dos Produtos / Servios ............................................................ 91 7.1.6 Informaes Complementares .......................................................................... 92 7.1.7 Reservado ao Fisco .......................................................................................... 92 7.2 Possibilidade de Uso de Uma Mesma Coluna Com Mais de Um Campo no Quadro Dados dos Produtos/Servios........................................................................................ 92 7.3 Supresses e Modificaes Permitidas ................................................................ 93 7.3.1 Bloco de Canhoto ............................................................................................. 93 7.3.2 Quadro Fatura/Duplicatas .............................................................................. 93 7.3.3 Quadro Clculo do ISSQN ............................................................................. 93 7.4 Verso do DANFE .................................................................................................. 94 7.5 Folhas Adicionais ................................................................................................. 94 7.6 Formulrio ............................................................................................................ 94 7.6.1 Tamanho do Papel ........................................................................................... 94 7.6.2 Margem Lateral no Formulrio.......................................................................... 95 7.6.3 Modelos de DANFE Permitidos ........................................................................ 95 7.7 Padres de Caracteres (Tipos de Fontes) ............................................................ 95 7.7.1 Descritivo dos Blocos de Campos .................................................................... 95 7.7.2 Descritivo dos Campos do Quadro Dados dos Produtos/Servios ................. 95 7.7.3 Descritivo dos Demais Campos ........................................................................ 96 7.7.4 Contedo do Bloco de Campos de Identificao do Documento ...................... 96 7.7.5 Contedo do Campo Chave de Acesso. ........................................................... 96 7.7.6 Contedo do Quadro Dados do Emitente ......................................................... 96 7.7.7 Contedo dos Campos do Quadro Dados dos Produtos/Servios.................. 96 7.7.8 Contedo do Campo Informaes Complementares ........................................ 96 7.7.9 Contedo dos Demais Campos ........................................................................ 96 7.8 Tamanho dos Campos ......................................................................................... 96 7.8.1 Formulrio A-4 em Modo Retrato ..................................................................... 96 7.8.2 Formulrio A-4 em Modo Paisagem ................................................................. 98 7.9 Campos de Contedo Varivel ........................................................................... 100 7.9.1 Emisso Normal da NF-e e SCAN .................................................................. 100 7.9.2 Emisso da NF-e em Contingncia com Impresso do DANFE em Formulrio de Segurana............................................................................................................. 100 7.9.3 Emisso da NF-e com Prvio Registro da DPEC no Ambiente Nacional ........ 101 7.10 Outros ................................................................................................................ 102 7.10.1 Marca dgua ............................................................................................. 102 7.10.2 Impresso do Nmero da Folha.................................................................. 102 7.10.3 Limitaes da Impressora ........................................................................... 102 7.10.4 Cdigo de Barras ........................................................................................ 102 8. Contingncia ................................................................................................. 103 9. Ambientes de Homologao e de Produo .................................................. 104 10. Distribuio da NF-e para o Destinatrio ....................................................... 105 10.1 Processo de Distribuio .................................................................................... 105 10.2 Leiaute da Distribuio: NF-e ............................................................................. 105 10.3 Leiaute de Distribuio: Cancelamento de NF-e................................................. 106 Anexo I Leiaute da NF-e ................................................................................................. 107 Anexo II DANFE Tamanho A-4 em Modo Retrato, Folhas Soltas.................................... 164 Anexo III DANFE Tamanho A-4 em Modo Retrato, Formulrio Contnuo ........................ 165 Anexo IV DANFE Tamanho A-4 em Modo Paisagem, Folhas Soltas .............................. 165 Anexo V DANFE Tamanho A-4 em Modo Paisagem, Formulrio Contnuo .................... 167Pg. 6 / 232


Anexo VI WS Disponveis ............................................................................................... 168 Anexo VII Conjunto de Caracteres Cdigo de Barras CODE-128C................................. 169 Anexo VIII Projeto Piloto da NF-e ................................................................................... 170 Anexo IX Tabelas de UF, Municpio e Pas ..................................................................... 171 1. Tabela de Cdigo de UF do IBGE ................................................................. 171 2. Tabela de Cdigo de Municpio do IBGE ....................................................... 171 2.1 Validao do Cdigo de Municpio................................................................. 172 2.2 Exemplo de Clculo do Dgito de Controle do Cdigo de Municpio .............. 172 3. Tabela de Cdigo de Pas do BACEN ........................................................... 173 3.1 Validao do Cdigo de Pas......................................................................... 174 3.2 Exemplo de Clculo do Dgito de Controle do Cdigo de Pas ...................... 174 Anexo X Manual de Contingncia ................................................................................... 177 1. Introduo ..................................................................................................... 180 2. Modelo Operacional de emisso da Nota Fiscal Eletrnica - NF-e ................ 181 2.1 Modalidades de Emisso de NF-e ...................................................................... 183 2.1.1 Emisso Normal ............................................................................................. 183 2.1.2 Contingncia em Formulrio de Segurana - FS ............................................ 184 2.1.4 Contingncia SCAN........................................................................................ 186 2.1.5 Contingncia Eletrnica com o uso da Declarao Prvia de Emisso em Contingncia SCE/DPEC ........................................................................................ 188 2.1.6 Contingncia em Formulrio de Segurana para impresso de Documento Auxiliar de Documento Fiscal Eletrnico FS-DA ...................................................... 190 2.1.7 Quadro Resumo das modalidades de emisso da NF-e ................................. 192 2.2 Documento Auxiliar da Nota Fiscal Eletrnica - DANFE ..................................... 192 2.3 Aes que devem ser tomadas aps a recuperao da falha............................. 197 2.3.1 Registro da Contingncia no RUDFTO ........................................................... 197 2.3.2 Transmisso das NF-e emitidas em Contingncia .......................................... 197 2.3.3 Rejeio de NF-e emitidas em Contingncia .................................................. 197 2.3.4 NF-e Pendentes de Retorno ........................................................................... 198 3. Arquitetura do Sistema Eletrnico de Contingncia ....................................... 199 3.1 Modelo Conceitual do SCE................................................................................. 199 3.2 Padres Tcnicos............................................................................................... 199 3.2.1 Padro de documento XML ............................................................................ 199 3.2.2 Padro de Comunicao ................................................................................ 200 3.2.3 Padro de Certificado Digital .......................................................................... 201 3.2.4 Resumo dos Padres Tcnicos ...................................................................... 202 3.3 Padro de mensagens dos Web Services .......................................................... 202 3.3.1 Informao de controle e rea de dados das mensagens............................... 202 3.3.2 Validao da estrutura XML das Mensagens dos Web Services .................... 202 3.3.3 Schemas XML das Mensagens dos Web Services ......................................... 203 3.4 Verso dos Schemas ......................................................................................... 204 3.4.1 Liberao das verses dos Schemas para o WS do Sistema de Contingncia Eletrnico ................................................................................................................... 204 3.4.2 Pacote de Liberao Preliminar ...................................................................... 204 3.4.3 Pacote de Liberao de Homologao e Pacote de Liberao definitivo ........ 205 3.4.4 Correo de Pacote de Liberao .................................................................. 205 3.4.5 Divulgao de novos Pacotes de Liberao ................................................... 205 3.4.6 Controle de Verso......................................................................................... 205 4. Web Services ................................................................................................ 207 4.1 Servio de Recepo de DPEC .......................................................................... 208 4.1.1 Web Service SCERecepcaoRFB ................................................................. 208 4.1.2 Leiaute Mensagem de Entrada ....................................................................... 208 4.1.3 Leiaute Mensagem de Retorno....................................................................... 211

Pg. 7 / 232


4.1.4 Descrio do Processo de Gerao da Declarao Prvia de Emisso em Contingncia - DPEC ................................................................................................. 213 4.1.5 Descrio do Processo de Recepo da Declarao Prvia de Emisso em Contingncia .............................................................................................................. 213 4.1.6 Validao do Certificado de Transmisso ....................................................... 214 4.1.7 Validao Inicial da Mensagem no Web Service ............................................ 214 4.1.8 Validao das informaes de controle da chamada ao Web Service ............ 215 4.1.9 Validao da rea de Dados........................................................................... 215 4.1.10 Final do Processamento do Lote ................................................................ 217 4.2 Servio de Consulta de DPEC ............................................................................ 221 4.2.1 Web Service SCEConsultaRFB ................................................................... 221 4.2.2 Leiaute Mensagem de Entrada ....................................................................... 221 4.2.3 Leiaute Mensagem de Retorno....................................................................... 222 4.2.4 Descrio do Processo de Consulta de DPEC ............................................... 224 4.2.5 Descrio do Processo de Consulta DPEC .................................................... 224 4.2.6 Validao do Certificado de Transmisso ....................................................... 224 4.2.7 Validao Inicial da Mensagem no Web Service ............................................ 225 4.2.8 Validao das informaes de controle da chamada ao Web Service ............ 225 4.2.9 Validao da rea de Dados........................................................................... 226 4.2.10 Processamento da consulta ........................................................................ 226 5. Web Services Informaes Adicionais ........................................................ 228 5.1 Regras de validao ........................................................................................... 228 5.1.1 Tabela de cdigos de erros e descries de mensagens de erros ................. 228 6. Consumo dos Web Services atravs de pginas WEB .................................. 230 6.1 Envio de DPEC via pgina WEB ........................................................................ 230 6.2 Consulta de DPEC por pgina WEB................................................................... 231

Pg. 8 / 232


1. IntroduoEste 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 - Nota Fiscal Eletrnica.

Pg. 9 / 232


2. Consideraes IniciaisA Nota Fiscal Eletrnica (NF-e) desenvolvida de forma integrada, pelas Secretarias de Fazenda dos Estados e Secretaria da Receita Federal do Brasil, 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. Ambas legislaes sofreram modificaes e atualizaes, resultado da evoluo ocorrida desde o incio da fase de massificao.

2.1

Objetivos do Projeto

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

2.2

Conceito da NF-e

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

2.3

Descrio Simplificada do Modelo Operacional

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


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

Para acompanhar o trnsito da mercadoria ser impressa uma representao grfica simplificada da Nota Fiscal Eletrnica, intitulada DANFE (Documento Auxiliar da Nota Fiscal Eletrnica), geralmente em papel comum, em nica via. O DANFE 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. A legislao poder prever casos em que seja permitida a impresso de mais de uma via do DANFE, como a contingncia utilizando formulrios de segurana, por exemplo. O DANFE no 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, atravs da pgina da Secretaria de Fazenda Estadual, ou da Receita Federal do Brasil, a efetiva existncia de uma NF-e que tenha tido seu uso regularmente autorizado.

Pg. 11 / 232


3. Arquitetura de Comunicao com Contribuinte3.1Modelo Conceitual

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

Pg. 12 / 232


Arquitetura de Comunicao Viso ConceitualContribuinteHTTPS Client NFe ( ERP ou software especfico) Fluxo de Comunicao

Secretaria de Fazenda EstadualWeb 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 XMLa) 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: OBS: Lembrando que cada arquivo XML somente poder ter uma nica declarao . 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: (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: (exemplo para o XML da NF-e e com prefixo nf) dever ser adotado a declarao:

Pg. 13 / 232


A declarao do namespace da assinatura digital dever ser realizada na prpria tag , conforme exemplo abaixo. Cada documento XML dever ter o seu namespace individual em seu elemento raiz. No caso especfico do lote de envio da NF-e, cada NF-e dever ter declarado o seu namespace individual. Segue abaixo um exemplo: 200602220000001 ... ... ...

c) Otimizao na montagem do arquivo Na gerao do arquivo XML da NF-e, excetuados os campos identificados como obrigatrios no modelo, no dever ser includa a TAG de campo 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 TAG. (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. 14 / 232


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 ComunicaoA comunicao ser baseada em Web Services disponibilizados pelo Sistema de Recepo de Nota Fiscal eletrnica. O meio fsico de comunicao utilizado ser a Internet, com o uso do protocolo SSL verso 3.0, com autenticao mtua, 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 ambiente do Sistema de Recepo da NFe e o aplicativo da empresa ser realizada no padro SOAP verso 1.2, com troca de mensagens XML no padro Style/Enconding: Document/Literal. A chamada de diferentes Web Services realizada com o envio de uma mensagem XML atravs do parmetro nfeDadosMsg. A verso do leiaute da mensagem XML contida no parmetro nfeDadosMsg ser informada no elemento versaoDados do tipo string localizado no elemento nfeCabecMsg do SOAP Header. Exemplo de uma mensagem requisio padro SOAP: string xml Pg. 15 / 232


Exemplo de uma mensagem de retorno padro SOAP: string xml

3.2.3 Padro de Certificado DigitalO certificado digital utilizado no Projeto Nota Fiscal eletrnica ser emitido por Autoridade Certificadora credenciada pela Infraestrutura 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 de um dos estabelecimentos da empresa emissora da NF-e. 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 o servidor do contribuinte e o 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, que no ser necessariamente o CNPJ da empresa emissora da NF-e, devendo ter a extenso Extended Key Usage com permisso de "Autenticao Cliente".

3.2.4 Padro de Assinatura DigitalAs 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 de um dos estabelecimentos da empresa emissora 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: Pg. 16 / 232


Deve-se evitar o uso das TAG abaixo, pois as informaes sero obtidas a partir do Certificado do emitente: 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 SignatureMethod: http://www.w3.org/2000/09/xmldsig#rsa-sha1 Grupo 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 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 . Para as demaisPg. 17 / 232


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: ... vFL68WETQ+mvj1aJAMDx+oVi928= IhXNhbdL1F9UGb2ydVc5v/gTB/y6r0KIFaf5evUi1i ... MIIFazCCBFOgAwIBAgIQaHEfNaxSeOEvZGlVDANB ...

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; 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 EstadualPara a validao da assinatura digital, seguem as regras que sero adotadas pelas Secretarias de Fazenda Estaduais:Pg. 18 / 232


(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 as LCR 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 digitais das mensagens sero verificadas considerando a lista de certificados revogados disponvel no momento da conferncia da assinatura.

3.2.6 Resumo dos Padres TcnicosA 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. 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 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 LCR. 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.Pg. 19 / 232

Padro de assinatura digital

Validao de assinatura digital Padres de preenchimento XML


Nos campos numricos com casas decimais, utilizar o ponto decimal na separao da parte inteira.

3.3

Modelo Operacional

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

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

Secretaria de Fazenda Estadual(2) Solicitao de servio

Aplicativo Cliente

Web Service(4) Resultado (3) Resultado

Processamento de Servios

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


(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 AssncronosAs 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 ContribuinteEnvio de Solicitao de Servios(4) (5) (1) Solicitao de servio (3) Recibo

Secretaria de Fazenda EstadualWeb Service Recebe Solicitao de Servios (2) Solicitao de servio Fila de servios solicitados

Fila de recibos

Processamento de Servios

(7)

(6)

Consulta Recibo

(8) Consulta recibo(10) Resultado processamento

Web Service(9) Resultado processamento

Consulta recibo

Fila de servios processados

Etapas do processo ideal: (1) (2) 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;Pg. 21 / 232

(3)

(4)

(5)


O servio solicitado processado pelo aplicativo da NF-e e o resultado do processamento colocado na fila de servios processados; (7) O aplicativo do contribuinte retira um recibo da fila de recibos de servios solicitados; (8) O aplicativo do contribuinte envia uma consulta de recibo, iniciando uma conexo com o Web Service Consulta Recibo (NFeRetRecepcao); (9) O Web Service Consulta Recibo recebe a mensagem de consulta recibo e localiza o resultado de processamento da solicitao de servio; (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.

(6)

3.3.3 Filas e MensagensAs 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.Pg. 22 / 232


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 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 pelos Web Service da NF-e e os respectivos resultados do processamento so realizadas atravs das mensagens com o seguinte padro:

Padro de Mensagem de chamada/retorno de Web ServiceversaoDados

Estrutura XML definida na documentao do Web Servicerea de dados (SOAP Body)

Elemento nfeCabecMsg (SOAP Header)

versaoDados - 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 Informao de Controle e rea de Dados das MensagensA identificao da verso da mensagem XML submetida ao Web Service ser realizada atravs do campo versaoDados informado no elemento nfeCabecMsg do SOAP Header:

string string

A informao armazenada na rea de dados um documento XML que deve atender o leiaute definido na documentao do Web Service acessado: xml

Pg. 23 / 232


3.4.2 Validao da Estrutura XML das Mensagens dos Web ServicesAs 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 ServicesToda mudana de leiaute das mensagens dos Web Services 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 do literal _v, como segue: enviNFe_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 Nota Fiscal Eletrnica

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 EletrnicaOs 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 tiposBasico_v1.00.xsd PL_002.ZIP 01/06/2006 enviNFe_v1.30.xsd inutNFe_v1.00.xsd cancNFe_v1.00.xsd tiposBasico_v1.01.xsd

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 liberaoPg. 25 / 232


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 VersoO 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 existem mudanas freqentes de leiaute de mensagens e as empresas dispem de um prazo razovel para implementar as mudanas necessrias, conforme acordo operacional 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.

3.6

SEFAZ VIRTUAL

As Secretarias da Fazenda Estadual podem optar por no desenvolver sistemas prprios de autorizao da emisso da Nota Fiscal Eletrnica para os Contribuintes da sua jurisdio. Neste caso, os servios da autorizao de emisso da NF-e sero supridos por uma SEFAZ VIRTUAL, atravs de um Protocolo de cooperao assinado entre as SEFAZ e/ou entre a SEFAZ e a RFB. Os servios da SEFAZ VIRTUAL compreendem os Web Services descritos no Modelo Conceitual da Arquitetura de Comunicao, conforme consta no item 3.1 deste Manual. Atualmente esto previstas as operaes das SEFAZ VIRTUAL de: SEFAZ VIRTUAL RS; SEFAZ VIRTUAL RFB.

Em qualquer um dos casos, a responsabilidade sobre o credenciamento e sobre a autorizao para o contribuinte usar os servios de uma determinada SEFAZ VIRTUAL, da SEFAZ de circunscrio do contribuinte. Para os sistemas das Empresas, deve ser totalmente transparente se os servios esto sendo disponibilizados pela SEFAZ VIRTUAL ou por um sistema de autorizao da prpria SEFAZ de circunscrio do contribuinte. A nica mudana visvel no endereo dos Web Services onde ficam disponibilizados os servios.

Pg. 26 / 232


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

Pg. 27 / 232


4.1

Web Service NfeRecepcao2

Transmisso de Lote de NF-eContribuinte Secretaria de Fazenda EstadualWeb Service: NfeRecepcao Envio do lote de NF-e Client NFe Recibo nfeRecepcaoLote msgs Filas de Entrada. Proc. Processamento Aplicao NF-e

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

4.1.1 Leiaute Mensagem de EntradaEntrada: Estrutura XML com as notas fiscais enviadas. Schema XML: enviNFe_v2.00.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

G

AP01

xml

1-50

-

4.1.2 Leiaute Mensagem de RetornoRetorno: Estrutura XML com a mensagem do resultado da transmisso. Schema XML: retEnviNFe_v2.00.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. 28 / 232

AR01 retEnviNFe AR02 versao AR03 tpAmb


1 Produo / 2 - Homologao AR04 verAplic E AR01 C 1-1 1-20 Verso do Aplicativo que recebeu o Lote. A verso deve ser iniciada com a sigla da UF nos casos de WS prprio ou a sigla SCAN, SVAN ou SVRS nos demais casos. Cdigo do status da resposta (vide item 5.1.1) Descrio literal do status da resposta Cdigo da UF que atendeu a solicitao. Data e Hora do Recebimento Formato = AAAA-MM-DDTHH:MM:SS Preenchido com data e hora do recebimento do lote. Dados do Recibo do Lote (S gerado se o Lote for aceito) Nmero do Recibo gerado pelo Portal da Secretaria de Fazenda Estadual (vide item 5.5). 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.

AR05 cStat AR06 xMotivo AR06a cUF AR09 dhRecbto

E E E E

AR01 AR01 AR01 AR01

N C N D

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

3 1-255 2 -

AR07 infRec AR08 nRec

G E

AR01 AR07

N

0-1 1-1

15

AR10 tMed

E

AR07

N

1-1

N

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-eEste 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 TransmissoValidao do Certificado Digital do Transmissor (protocolo SSL) # Regra de Validao Crtica Msg 280 Efeito Rej. A01 Certificado de Transmissor Invlido: Obrig. - Certificado de Transmissor inexistente na mensagem - Verso difere "3" - Se informado, Basic Constraint de ser true (no pode ser Certificado de AC) - KeyUsage no define "Autenticao Cliente" A02 Validade do Certificado (data incio e data fim) Obrig.

281

Rej.

Pg. 29 / 232


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.

283

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-Brasil no repositrio de certificados digitais do servidor de Web Service da SEFAZ.

4.1.5 Validao Inicial da Mensagem no Web ServiceValidao 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. 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 ReciboNo existindo qualquer problema nas validaes acima referidas, o aplicativo dever gerar um nmero de recibo (vide item 5.5) e gravar a mensagem, juntamente com o nmero do recibo e o CNPJ do transmissor. Aps a gravao da mensagem na fila de entrada ser retornada uma mensagem de confirmao de recebimento para o transmissor, com as seguintes informaes:Pg. 30 / 232


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-eO 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 NfeRecepcao2 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 das informaes de controle da chamada ao Web Service

Validao das informaes de controle da chamada ao Web Service# Regra de Validao Aplic. Facult. Obrig. Obrig. Msg 242 409 410 411 238 239 Efeito Rej. Rej. Rej. Rej. Rej. Rej. C01 Elemento nfeCabecMsg inexistente no SOAP Header C02 Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header C03 Verificar se a UF informada no campo cUF atendida pelo Web Service

C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Obrig. Header C05 Verso dos Dados informada superior verso vigente C06 Verso dos Dados no suportada Facult. Obrig.

A informao da verso do leiaute do lote e a UF de origem do emissor das NF-e constam no elemento nfeCabecMsg do SOAP Header (para maiores detalhes vide item 3.4.1). A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de informaes inexistentes ou invlidas.

O campo versaoDados 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.Pg. 31 / 232


4.1.9 Validao da rea de Dadosa) Validao de forma da rea de dados A validao de forma da rea de dados da mensagem realizada com a aplicao da seguinte regra:Validao da rea de dados da mensagem # Regra de Validao Aplic. Obrig. Facul. Facul. Facul. Msg 225 565 568 567 Efeito Rej. Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados D01d Em caso de Falha de Schema, verificar se existe a tag raiz esperada para o lote D01e Em caso de Falha de Schema, verificar se existe o atributo versao para a tag raiz da mensagem D01f Em caso de Falha de Schema, verificar se o contedo do atributo versao difere do contedo da versaoDados informado no SOAPHeader D02 Verifica o uso de prefixo no namespace D03 XML utiliza codificao diferente de UTF-8

Obrig. Obrig.

404 402

Rej. Rej.

As validaes D01d, D01e e D01f so de aplicao facultativa e podem ser aplicadas sucessivamente quando ocorrer falha na validao D01 e a SEFAZ entender oportuno informar a divergncia entre a verso informada no SOAP Header e a verso da mensagem XML. 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" - Se informado, Basic Constraint deve ser 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

Obrig. Obrig. Obrig.

291 292 293

Rej. Rej. Rej.

Pg. 32 / 232


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.

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

297 213

Rej. Rej.

Pg. 33 / 232


d) Validao de regras de negcios da NF-e# GA03Campo

Regra de Validao

Aplic.

Msg 502

Efeito Rej.

Descrio Erro Rejeio: Erro na Chave de Acesso - Campo Id no corresponde concatenao dos campos correspondentes Rejeio: Cdigo da UF do Emitente diverge da UF autorizadora Rejeio: Srie utilizada fora da faixa permitida no Web Service (0-889)

A03

GB02 GB07

B02 B07

A - Dados da NF-e Campo Id invlido: Obrig. Chave de Acesso do campo Id difere da concatenao dos campos correspondentes B - Identificao da NF-e Cdigo da UF do Emitente difere da UF do Web Service Obrig. Na autorizao pela SEFAZ (ou SEFAZ VIRTUAL): Srie da NF-e difere da faixa de 0-889 A faixa 890-899 reservada para a emisso de NF-e avulsa quando permitida pela SEFAZ. Na autorizao pelo SCAN - Sistema de Contingncia Nacional: Srie da NF-e difere da faixa de 900-999 Data de Emisso posterior data de recebimento da NF-e na SEFAZ Data de Emisso ocorrida h mais de 30 dias (ou outro limite definido pela SEFAZ) Se informado Data de Entrada / Sada (dSaiEnt): Data Entrada / Sada posterior a 30 dias da Data de Autorizao Se informado Data de Entrada / Sada (dSaiEnt): Data Entrada / Sada anterior a 30 dias da Data de Autorizao Se informado Data de Entrada / Sada (dSaiEnt) para NF-e de Sada (tpNF=1): Data de Sada (dSaiEnt) menor que a Data de Emisso (dEmis) Cdigo do Municpio do Fato Gerador de ICMS com dgito verificador (DV) invlido (*1) Obrig.

226 266

Rej. Rej.

GB07.1

B07

Obrig.

503

Rej.

Rejeio: Srie utilizada fora da faixa permitida no SCAN (900-999) Rejeio: Data de emisso NF-e posterior a data de recebimento Rejeio: Data de Emisso muito atrasada Rejeio: Data de Entrada/Sada posterior ao permitido Rejeio: Data de Entrada/Sada anterior ao permitido Rejeio: Data de Sada menor que a Data de Emisso

GB09 GB09.1 GB10

B09 B09 B10

Obrig. Obrig. Facult.

212 228 504

Rej. Rej. Rej.

GB10.1

B10

Facult.

505

Rej.

GB10.2

B10

Facult.

506

Rej.

GB12

B12

Obrig.

270

Rej.

Rejeio: Cdigo Municpio do Fato Gerador: dgito invlidoPg. 34 / 232


Campo # Regra de Validao GB12.1 B12 Cdigo do Municpio do Fato Gerador (2 primeiras posies) difere do Cdigo da UF do emitente GB13 B13 Se informada a TAG de NF-e Referenciada: - Dgito Verificador da Chave de Acesso invlido GB17 B17 Se informada a TAG de NF Referenciada: CNPJ com zeros, nulo ou DV invlido GB20d B20d Se informada a TAG de NF Referenciada de produtor: CNPJ com zeros, nulo ou DV invlido GB20e B20e Se informada a TAG de NF Referenciada de produtor: CPF com zeros, nulo ou DV invlido GB20f B20f Se informada a TAG de NF Referenciada de produtor: IE com zeros, nulo ou DV invlido para a UF. GB20i B20i Se informada a TAG de CT-e Referenciado: - Dgito Verificador da Chave de Acesso invlido GB22 B22 Se informada a TAG de tpEmis = 1: dhCont e xJust no devem ser informados

Aplic. Obrig. Facult. Facult. Facult. Facult. Facult. Facult. Obrig.

Msg 271 547 548 549 550 551 552 556

Efeito Descrio Erro Rej. Rejeio: Cdigo Municpio do Fato Gerador: difere da UF do emitente Rej. Rejeio: Dgito Verificador da Chave de Acesso da NF-e Referenciada invlido Rej. Rejeio: CNPJ da NF referenciada invlido. Rej. Rej. Rej. Rej. Rej. Rejeio: CNPJ da NF referenciada de produtor invlido. Rejeio: CPF da NF referenciada de produtor invlido. Rejeio: IE da NF referenciada de produtor invlido. Rejeio: Dgito Verificador da Chave de Acesso do CT-e Referenciado invlido Rejeio: Justificativa de entrada em contingncia no deve ser informada para tipo de emisso normal Rejeio: A Justificativa de entrada em contingncia deve ser informada Rejeio: Digito Verificador da chave de acesso composta invlida Rejeio: Ambiente informado diverge do Ambiente de recebimento Rejeio: NF-e complementar no possui NF referenciada Rejeio: NF-e complementar possui mais de uma NF referenciada Rejeio: CNPJ Emitente da NF Complementar difere do CNPJ da NF Referenciada Rejeio: Processo de emisso informado invlidoPg. 35 / 232

GB22.1 GB23 GB24 GB25 GB25.1 GB25.2 GB26

B22 B23 B24 B25 B25 B25 B26

Se informada a TAG de tpEmis diferente de 1: dhCont e xJust devem ser informados Chave de Acesso obtida pela concatenao dos campos correspondentes com dgito verificador (DV) invlido Tipo do ambiente da NF-e difere do ambiente do Web Service Se NF-e complementar (finNFe=2): No informado NF referenciada (NF modelo 1 ou NF-e) NF referenciada com mais de uma ocorrncia (NF modelo 1 ou NF-e) CNPJ emitente da NF Referenciada difere do CNPJ emitente desta NF-e (NF modelo 1 ou NF-e) Processo de Emisso difere de emisso pelo contribuinte (procEmi 0 e 3) C- Identificao do Emitente

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

557 253 252 254 255 269 451

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


Regra de Validao Aplic. Data de entrada em contingncia deve ser menor ou igual Facult. data de emisso GC02 C02 Se informada a TAG de CNPJ do emitente: Obrig. CNPJ com zeros, nulo ou DV invlido GC02.1 C02 CNPJ Base do Emitente difere do CNPJ Base da primeira Facult. NF-e do Lote recebido GC02a C02a Se informada a TAG CPF do emitente: Obrig. CPF s pode ser informado no campo Emitente para NFe avulsa GC02a.1 C02a - CPF do Remetente de NF-e Avulsa com zeros, nulo ou Obrig. DV invlido GC10 C10 Cdigo do Municpio do Emitente com DV invlido (*1) Obrig. B28 GC10.1 GC12 GC17 GC17.1 GC18 C10 C12 C17 C17 C18 Cdigo do Municpio do Emitente (2 primeiras posies) Obrig. difere do Cdigo da UF do emitente Sigla da UF do Emitente difere da UF do Web Service Obrig. IE Emitente com zeros ou nulo IE Emitente invlida para a UF: erro no tamanho, na composio da IE, ou no dgito verificador (*2) Se informada operao de Faturamento Direto para veculos novos (tpOp, campo J02 = 2): UF do Local de Entrega (campo G09) no informada (A UF necessria na validao da IE ST nestas operaes. Vide Convnio ICMS 51/00). Se informada a IE do Substituto Tributrio: - IEST invlida para a UF: erro no tamanho, na composio da IE, ou no dgito verificador (*2) UF a ser utilizada na validao: UF do Local de Entrega para operao de Faturamento Direto de veculos novos (campo G09, caso tpOP, campo J02 = 2); Obrig. Obrig. Obrig.

# GB28

Campo

Msg 558 207 560 407

Efeito Descrio Erro Rej. Rejeio: Data de entrada em contingncia posterior a data de emisso Rej. Rejeio: CNPJ do emitente invlido Rej. Rej. Rejeio: CNPJ base do emitente difere do CNPJ base da primeira NF-e do lote recebido Rejeio: O CPF s pode ser informado no campo emitente para a NF-e avulsa Rejeio: CPF do remetente invlido Rejeio: Cdigo Municpio do Emitente: dgito invlido Rejeio: Cdigo Municpio do Emitente: difere da UF do emitente Rejeio: Sigla da UF do Emitente diverge da UF autorizadora Rejeio: IE do emitente no informada Rejeio: IE do emitente invlida Rejeio: Local da entrega no informado para faturamento direto de veculos novos

401 272 273 247 229 209 478

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

GC18.1

C18

Obrig.

211

Rej.

Rejeio: IE do substituto invlida

Pg. 36 / 232


#

Campo

Regra de Validao UF do destinatrio (UF, campo E12) nos demais casos. D - Identificao do Fisco Emitente (NF-e Avulsa) Informado o grupo avulsa pela empresa E - Identificao do Destinatrio Se Operao com Exterior (UF Destinatrio = EX) - no informada TAG CNPJ ou CNPJ nulo Se no Operao com Exterior (UF destinatrio EX): - CNPJ destinatrio nulo e CPF destinatrio nulo Se informada TAG CNPJ: - CNPJ com zeros ou dgito de controle invlido Se informada a TAG CPF: - CPF com zeros ou dgito de controle invlido Se no Operao com Exterior (UF Destinatrio EX): - Cdigo Municpio do destinatrio com dgito verificador invlido - Cdigo Municpio do destinatrio (2 primeiras posies) difere do Cdigo da UF do destinatrio Se Operao com Exterior (UF Destinatrio = EX): - Cdigo Municpio do destinatrio difere de 9999999 Se Operao com Exterior (UF Destinatrio = EX): - Cdigo Pas do destinatrio = 1058 (Brasil), ou no informado Se informado Cdigo Pas do destinatrio e no uma Operao com Exterior (UF Destinatrio EX): - Cdigo Pas do destinatrio difere de 1058 (Brasil) Se Operao com Exterior (UF Destinatrio = EX): - IE Destinatrio difere de nulo ou ISENTO IE Destinatrio informada e difere de ISENTO: - IE invlida para a UF: erro no tamanho, na composio da IE, ou no dgito verificador (*2) Inscr. SUFRAMA informada:

Aplic.

Msg

Efeito

Descrio Erro

GD01

D01

Obrig.

403

Rej.

Rejeio: O grupo de informaes da NF-e avulsa de uso exclusivo do Fisco Rejeio: O CNPJ do destinatrio/remetente no deve ser informado em operao com o exterior Rejeio: O CNPJ com contedo nulo s vlido em operao com exterior. Rejeio: CNPJ do destinatrio invlido Rejeio: CPF do destinatrio invlido Rejeio: Cdigo Municpio do Destinatrio: dgito invlido Rejeio: Cdigo Municpio do Destinatrio: difere da UF do Destinatrio Rejeio: Informado cdigo de municpio diferente de 9999999 para operao com o exterior Rejeio: Operao com Exterior e Cdigo Pas destinatrio 1058 (Brasil) ou no informado Rejeio: No de Operao com Exterior e Cdigo Pas destinatrio difere de 1058 (Brasil) Rejeio: IE do destinatrio invlida Rejeio: IE do destinatrio invlida

GE02 GE02.1 GE02.2 GE03 GE10

E02 E02 E02 E03 E10

Obrig. Obrig.. Obrig. Obrig. Obrig.

507 508 208 237 274

Rej. Rej. Rej. Rej. Rej.

GE10.1 GE10.2 GE14

E10 E10 E14

Obrig. Obrig. Facult.

275 509 510

Rej. Rej. Rej.

GE14.1

E14

Facult.

511

Rej.

GE17 GE17.1

E17 E17

Obrig. Obrig.

210 210

Rej. Rej.

GE18

E18

Obrig.

235

Rej.

Rejeio: Inscrio SUFRAMA invlidaPg. 37 / 232


# GE18.1

Campo

E18

GF02

F02

GF02a GF07

F02a F07

GF07.1

F07

GF07.2

F07

GG02

G02

GG02a GG07

G02a G07

GG07.1

G07

GG07.2

G07

Regra de Validao - Inscrio com dgito verificador invlido Inscr. SUFRAMA informada: - UF destinatrio difere de AC-Acre, ou AM-Amazonas, ou RO-Rondnia, ou RR-Roraima, ou AP-Amap (s para municpios 1600303-Macap e 1600600-Santana) F - Local da Retirada Se informado Local de Retirada e CNPJ Retirada difere de nulo: - CNPJ com zeros ou dgito invlido Se informada a TAG CPF: - CPF com zeros ou dgito de controle invlido Se informado Local de Retirada e UF Retirada = EX: - Cdigo do Municpio do Local de Retirada difere de 9999999 Se informado Local de Retirada e UF Retirada EX: - Cdigo do Municpio do Local de Retirada com dgito verificador invlido - Cdigo Municpio do Local de Retirada (2 primeiras posies) difere do Cdigo da UF do Local de Retirada G - Local da Entrega Se informado o Local de Entrega e CNPJ Entrega difere de nulo: - CNPJ com zeros ou dgito invlido Se informada a TAG CPF: - CPF com zeros ou dgito de controle invlido Se informado Local de Entrega e UF Entrega = EX: - Cdigo do Municpio do Local de Entrega difere de 9999999 Se informado Local de Entrega e UF Entrega EX: - Cdigo Municpio do Local de Entrega com dgito verificador invlido - Cdigo Municpio do Local de Entrega (2 primeiras

Aplic. Obrig.

Msg 251

Efeito Rej.

Descrio Erro Rejeio: UF/Municpio destinatrio no pertence a SUFRAMA

Facult.

512

Rej.

Rejeio: CNPJ do Local de Retirada invlido

Facult. Obrig.

540 513

Rej. Rej.

Rejeio: CPF do Local de Retirada invlido Rejeio: Cdigo Municpio do Local de Retirada deve ser 9999999 para UF retirada = EX. Rejeio: Cdigo Municpio do Local de Retirada: dgito invlido Rejeio: Cdigo Municpio do Local de Retirada: difere da UF do Local de Retirada Rejeio: CNPJ do Local de Entrega invlido

Obrig.

276

Rej.

Obrig.

277

Rej.

Facult.

514

Rej.

Facult. Obrig.

541 515

Rej. Rej,

Rejeio: CPF do Local de Entrega invlido Rejeio: Cdigo Municpio do Local de Entrega deve ser 9999999 para UF entrega = EX. Rejeio: Cdigo Municpio do Local de Entrega: dgito invlido Rejeio: Cdigo Municpio do Local de Entre

manual integracao contribuinte 4.01-nt2009

Documents