Escolar Documentos
Profissional Documentos
Cultura Documentos
Verso 4.0.1-NT2009.006
Dezembro 2009
Pg. 1 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Controle de Verses
Verso Data Ato COTEPE
0.1.0 16/12/2005 SC
1.0.0 06/01/2006 SP Ato COTEPE/ICMS N 72, de
20.12.2005
1.0.1 11/01/2006 GO
1.0.2 19/01/2006 SP
1.1.0 26/01/2006 SP
1.1.1 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
2.0.0 27/11/2006 SP/RS
2.0.1 23/04/2007 SP/RS/GO
2.0.2 29/06/2007 - SP/RS Ato COTEPE/ICMS N 14, de
12.11.2007
2.0.2a 16/06/2008 - SP Ato COTEPE/ICMS N 22, de
25.06.2008
3.0 16/03/2009 SP/RS Ato COTEPE/ICMS n 3, de
19.03.2009
4.0 21/09/2009 SP/RS Ato COTEPE/ICMS n 39, de
19.11.2009
4.0.1 03/11/2009 SP/RS Errata da verso 4.0 Ato COTEPE/ICMS N 49, de
27.11.2009
4.0.1-NT200906 Dez/2009 com atualizaes da NT
2009/006
Pg. 2 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 3 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
ndice
1. Introduo ......................................................................................................... 9
2. 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 ........................................................... 52
Pg. 4 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 5 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 6 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 7 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 8 / 232
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 - Nota Fiscal Eletrnica.
Pg. 9 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
2. Consideraes Iniciais
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.
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
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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.
Pg. 12 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Aplicativo de Faturamento
( ERP ou software especfico) NFEs
a) Padro de Codificao
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
Pg. 13 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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:
<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
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
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
d) Validao de Schema
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 chamada de diferentes Web Services realizada com o envio de uma mensagem XML
atravs do parmetro nfeDadosMsg.
Pg. 15 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
O 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.
<X509IssuerSerial>
<X509IssuerName>
<X509SerialNumber>
<X509SKI>
Deve-se evitar o uso das TAG abaixo, pois as informaes sero obtidas a partir do
Certificado do emitente:
<KeyValue>
<RSAKeyValue>
<Modulus>
<Exponent>
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
Pg. 17 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Para a validao da assinatura digital, seguem as regras que sero adotadas pelas
Secretarias de Fazenda Estaduais:
Pg. 18 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Caracterstica Descrio
Web Services Padro definido pelo WS-I Basic Profile 1.1
(http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-
24.html).
Meio lgico de comunicao Web Services, disponibilizados pelo Portal da Secretaria
de Fazenda Estadual.
Meio fsico de comunicao Internet
Protocolo Internet SSL verso 3.0, com autenticao mtua atravs de
certificados digitais.
Padro de troca de mensagens SOAP verso 1.2.
Padro da mensagem XML no padro Style/Encoding: Document/Literal.
Padro de certificado digital 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.
Servio Implementao
Recepo de NF-e Assncrona
Cancelamento de NF-e Sncrona
Inutilizao de Numerao de NF-e Sncrona
Consulta da situao atual da NF-e Sncrona
Consulta do status do servio Sncrona
Consulta cadastro Sncrona
(4)
(5)
Fila de
recibos Processamento
de Servios
(6)
(7)
Pg. 21 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A rea de mensagem contm uma rea de cabealho e a rea de dados em formato XML.
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.
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).
<soap12:Header>
<nfeCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NFeRecepcao">
<versaoDados>string</versaoDados>
<cUF>string<cUF>
</nfeCabecMsg>
</soap12:Header>
<soap12:Body>
<nfeRecepcaoResponse
xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NFeRecepcao">
<nfeRetornoMsg>xml</nfeRetornoMsg>
</nfeRecepcaoResponse>
Pg. 23 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
As informaes so enviadas ou recebidas dos Web Services atravs de mensagens no padro XML
definido na documentao de cada Web Service.
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.
Toda mudana de leiaute das mensagens dos Web Services implica na atualizao do seu
respectivo Schema XML.
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.
Pg. 24 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
schema_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.
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.
Exemplificando:
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
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.
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.
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
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) disponibilizado um Web Service por servio, existindo um mtodo para cada tipo
de servio;
Pg. 27 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Web Service:
NfeRecepcao Filas de Entrada.
Envio do lote de NF-e nfeRecepcaoLote msgs Proc. Processamento
Processo: assncrono.
Mtodo: nfeRecepcaoLote2
Pg. 28 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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.
AR05 cStat E AR01 N 1-1 3 Cdigo do status da resposta (vide item 5.1.1)
AR06 xMotivo E AR01 C 1-1 1-255 Descrio literal do status da resposta
AR06a cUF E AR01 N 1-1 2 Cdigo da UF que atendeu a solicitao.
AR09 dhRecbto E AR01 D 1-1 - Data e Hora do Recebimento
Formato = AAAA-MM-DDTHH:MM:SS
Preenchido com data e hora do recebimento
do lote.
AR07 infRec G AR01 - 0-1 - Dados do Recibo do Lote (S gerado se o
Lote for aceito)
AR08 nRec E AR07 N 1-1 15 Nmero do Recibo gerado pelo Portal da
Secretaria de Fazenda Estadual (vide item
5.5).
AR10 tMed E AR07 N 1-1 N 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.
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.
Este mtodo ser responsvel por receber as mensagens de envio de lotes de NF-e e
coloc-las na fila de entrada.
Pg. 29 / 232
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-Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
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.
No 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.
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);
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 31 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A seguir so extradas todas NF-e das mensagens de envio de lote e validadas as seguintes
regras de negcios para cada NF-e:
Pg. 32 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 33 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 38 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
I - Produtos e Servios
GI08 I08 CFOP de Entrada (inicia por 1, 2, 3) para NF-e de Sada Facult. 518 Rej. Rejeio: CFOP de entrada para NF-e de sada
(tpNF=1)
GI08.1 I08 CFOP de Sada (inicia por 5, 6, 7) para NF-e de Entrada Facult. 519 Rej. Rejeio: CFOP de sada para NF-e de entrada
(tpNF=0)
GI08.2 I08 CFOP de Operao com Exterior (inicia por 3 ou 7) e UF Facult. 520 Rej. Rejeio: CFOP de Operao com Exterior e UF
destinatrio <> EX destinatrio difere de EX
GI08.3 I08 CFOP no de Operao com Exterior (no inicia por 3 e 7) Facult. 521 Rej. Rejeio: CFOP no de Operao com Exterior
e UF destinatrio = EX e UF destinatrio EX
GI08.4 I08 CFOP de Operao no Estado (inicia por 1 ou 5) e UF Facult. 522 Rej. Rejeio: CFOP de Operao Estadual e UF
emitente difere da UF destinatrio emitente difere UF destinatrio.
GI08.5 I08 CFOP no de Operao no Estado (no inicia por 1 e 5) e Facult. 523 Rej. Rejeio: CFOP no de Operao Estadual e
UF emitente = UF destinatrio UF emitente igual a UF destinatrio.
GI08.6 I08 CFOP de Operao com Exterior (inicia por 3 ou 7) e no Facult. 524 Rej. Rejeio: CFOP de Operao com Exterior e no
informada TAG NCM (id:I05) completo (8 posies) informado NCM completa
GI08.7 I08 CFOP de Importao (inicia por 3) e no informado a tag DI Facult. 525 Rej. Rejeio: CFOP de Importao e no informado
dados da DI
GI08.8 I08 CFOP de Exportao (inicia por 7) e no informado Local de Facult. 526 Rej. Rejeio: CFOP de Exportao e no informado
Embarque (id:ZA01) Local de Embarque
J - Item / Veculos Novos
K - Item / Medicamentos
L - Item / Armamentos
L1 - Item / Combustvel
Pg. 39 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
W - Total da NF-e
Pg. 40 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
GX05 X05 Validar CPF do transportador.se informado. Obrig. 543 Rej. Rejeio: CPF do Transportador invlido
GX07 X07 Se informada a IE do Transportador: Obrig. 559 Rej. Rejeio: UF do Transportador no informada
- UF do Transportador (id:X10) no informada
GX07.1 X07 Validar IE do transportador.se informado. Obrig. 544 Rej. Rejeio: IE do Transportador invlida
Utilizar a UF informada para escolha do algoritmo.
GX17 X17 Se informado Cdigo Municpio do FG - Transporte (id:X17): Obrig. 288 Rej. Rejeio: Cdigo Municpio do FG - Transporte:
- Cdigo do Municpio do FG - Transporte com dgito dgito invlido
Pg. 41 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
ZA - Comrcio Exterior
ZB - Informao de Compra
Pg. 42 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
(*1) No validar o dgito de controle para os Cdigos de Municpio que seguem: 2201919 - Bom Princpio do Piau/PI; 2202251 - Canavieira
/PI; 2201988 - Brejo do Piau/PI; 2611533 Quixaba/PE; 3117836 - Cnego Marinho/MG; 3152131 - Ponto Chique/MG; 4305871 - Coronel
Barros/RS; 5203939 - Buriti de Gois/GO; 5203962 Buritinpolis/GO.
(*2) 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.
(*3) Considerar uma tolerncia de R$ 1,00 para mais ou para menos.
Pg. 43 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Ou seja:
Validao Conseqncia
Banco
NF-e Emitente Situao da NF-e Para o contribuinte
de Dados
Invlida Irrelevante Rejeio Corrigir NF-e No gravar
A operao no poder
Vlida Irregular Denegao de uso Gravar
ser realizada
Vlida Regular Autorizao de uso A operao autorizada Gravar
O resultado do processamento do lote deve ficar disponvel na fila de sada por um perodo
mnimo de 24 horas.
Pg. 44 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Web Service:
NfeRetRecepcao
Consulta
Consulta Lote de Nota Fiscal nfeRetRecepcao Proc.
Processamento
Ret
Client NFe Aplicao NF-e
Retorno
A mensagem de retorno poder ser utilizada pela SEFAZ para enviar mensagens de
interesse da SEFAZ para o emissor.
Processo: assncrono.
Mtodo: nfeRetRecepcao2
Entrada: Estrutura XML contendo o nmero do recibo que identifica a mensagem de envio
de lotes de NF-e.
Pg. 46 / 232
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- Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
Pg. 47 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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.
Pg. 48 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
E04 - Verifica se o Lote no est na fila de resposta, mas est na fila de Obrig. 105 Rej.
entrada
E05 CNPJ do transmissor do lote difere do CNPJ do transmissor da Obrig. 223 Rej.
consulta
Pg. 49 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A SEFAZ poder utilizar este servio como canal de comunicao com o emissor da NF-e.
Pg. 50 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Cancelamento de NF-e
Contribuinte Secretaria de Fazenda Estadual
Web Service:
NfeCancelamento
Proc.
Cancelamento da NF-e nfeCancelamentoNF Cancelamento
Ret
Client NFe Retorno Aplicao NF-e
Processo: sncrono.
Mtodo: nfeCancelamentoNF2
Pg. 51 / 232
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-Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
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.
Pg. 53 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 54 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 55 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
H06 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. 217 Rej.
- Verificar se NF-e no existe
H07 - Cdigo Numrico informado na Chave de Acesso diferente do Obrig. 216 Rej.
existente no BD
H07a Ms de Emisso informado na Chave de Acesso difere do Ms de Obrig. 561 Rej.
Emisso da NF-e
H08 - Verificar se NF-e j est Denegada Obrig. 205 Rej.
H09 - Verificar se NF-e j est Cancelada Obrig. 420 Rej.
H10 - Verificar NF-e autorizada h mais de 7 dias (168 horas) Obrig. 220 Rej.
H11 - Verificar se o nmero Protocolo informado difere do nro. Protocolo Obrig. 222 Rej.
da NF-e
H12 - Verificar recebimento da NF-e pelo Destinatrio* Obrig. 221 Rej.
H13 - Verificar registro de Circulao de Mercadoria Obrig. 219 Rej.
* Obs. A regra de validao H12 ser implementada oportunamente.
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).
Pg. 56 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Web Service:
NfeInutilizacao
Proc.
Inutilizao de Numerao nfeInutilizacaoNF Inutilizacao
Inutilizao
Ret
Processo: sncrono.
Mtodo: nfeInutilizacaoNF2
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. 58 / 232
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-Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
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. 59 / 232
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.
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 61 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
I02b Ano da Inutilizao no pode ser superior ao Ano atual Obrig. 453 Rej.
I02c Ano da inutilizao no pode ser inferior a 2006 Obrig. 454 Rej.
I03 Nmero da Faixa Inicial maior do que o nmero Final Obrig. 224 Rej
I04 Quantidade mxima de numerao a inutilizar ultrapassa o limite Obrig. 201 Rej
(1.000 nmeros)
I04.a Campo Id invlido: contedo informado difere da concatenao dos Obrig. 502 Rej.
campos correspondentes
I05 Acesso Cadastro Contribuinte: Obrig. 203 Rej
- Verificar Emitente no autorizado a emitir NF-e
I06 - Verificar Situao Fiscal irregular do Emitente Obrig. 240 Rej
I07 Acesso BD NFE-Inutilizao (Chave: Ano, CNPJ Emit, Modelo, Srie, Obrig. 563 Rej
nNFIni, nNFFin):
- Verificar se j existe um Pedido de inutilizao igual
I07a - Verificar se algum Nro da Faixa de Inutilizao atual pertence a uma Obrig. 256 Rej
faixa anterior
I08 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. 241 Rej
- Verificar se existe NF-e utilizada na faixa de inutilizao solicitada
Pg. 62 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Web Service:
NfeConsulta
Proc.
Consulta NF-e nfeConsultaNF Consulta NF-e
Ret
Processo: sncrono.
Mtodo: nfeConsultaNF2
Pg. 63 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
1 Produo / 2 Homologao
ER04 verAplic E ER01 C 1-1 1-20 Verso do Aplicativo que processou a consulta.
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.
ER05 cStat E ER01 N 1-1 3 Cdigo do status da resposta.
ER06 xMotivo E ER01 C 1-1 1-255 Descrio literal do status da resposta.
ER07 cUF E ER01 N 1-1 2 Cdigo da UF que atendeu a solicitao.
EP07a chNFe E ER01 N 1-1 44 Chave de Acesso da NF-e consultada.
ER08 protNFe CG ER01 xml 0-1 - Protocolo de autorizao ou denegao de uso
do NF-e (vide item 4.2.2).
Informar se localizado uma NF-e com cStat =
100 (uso autorizado) ou 110 (uso denegado).
ER09 retCancNFe CG ER01 xml 0-1 - Protocolo de homologao de cancelamento
de NF-e (vide item 4.3.2).
Informar se localizado uma NF-e com cStat =
101 (cancelado).
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.
Pg. 64 / 232
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-Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
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.
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 65 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 66 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Web Service:
NfeStatusServico
Proc.
Consulta Status nfeStatusServicoNF Consulta Status
Ret
Processo: sncrono.
Mtodo: nfeStatusServicoNF2
FR04 verAplic E FR01 C 1-1 1-20 Verso do Aplicativo que processou a consulta.
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.
FR05 cStat E FR01 N 1-1 3 Cdigo do status da resposta.
FR06 xMotivo E FR01 C 1-1 1-60 Descrio literal do status da resposta.
FR07 cUF E FR01 N 1-1 2 Cdigo da UF que atendeu a solicitao
FR08 dhRecbto E FR01 D 1-1 - Data e hora de recebimento
Formato = AAAA-MM-DDTHH:MM:SS
Preenchido com data e hora do recebimento
do Pedido.
FR09 tMed E FR01 N 0-1 1-4 Tempo mdio de resposta do servio (em
segundos) dos ltimos 5 minutos (item 5.7).
FR10 dhRetorno E FR01 D 0-1 - Preencher com data e hora previstas para o
retorno do Web Service, no formato AAA-MM-
DDTHH:MM:SS
FR11 xObs E FR01 C 0-1 1-255 Informaes adicionais para o Contribuinte
Este mtodo ser responsvel por receber as solicitaes referentes consulta do status do
servio do Portal da Secretaria de Fazenda Estadual.
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.
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.
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 69 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 70 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Consulta Cadastro
Contribuinte Secretaria de Fazenda Estadual
Web Service :
CadConsultaCadastro
Proc.
Consulta Cadastro consultaCadastro Consulta
Ret
Processo: sncrono.
Mtodo: consultaCadastro2
Pg. 71 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
como Substituto
Tributrio.
GR12 cSit E GR07 N 1-1 1 Situao do contribuinte:
0 - no habilitado;
1 - habilitado.
GR12a indCredNFe E GR07 N 1-1 1 Indicador de contribuinte
credenciado a emitir NF-
e.
0 - No credenciado para
emisso da NF-e;
1 - Credenciado;
2 - Credenciado com
obrigatoriedade para
todas operaes;
3 - Credenciado com
obrigatoriedade parcial;
4 a SEFAZ no fornece
a informao.
Este indicador significa
apenas que o
contribuinte
credenciado para emitir
NF-e na SEFAZ
consultada.
GR12b indCredCTe E GR07 N 1-1 1 Indicador de contribuinte
credenciado a emitir CT-
e.
0 - No credenciado para
emisso da CT-e;
1 - Credenciado;
2 - Credenciado com
obrigatoriedade para
todas operaes;
3 - Credenciado com
obrigatoriedade parcial;
4 a SEFAZ no fornece
a informao.
Este indicador significa
apenas que o
contribuinte
credenciado para emitir
CT-e na SEFAZ
consultada.
GR13 xNome E GR07 C 1-1 1-60 Razo Social ou nome
do Contribuinte
GR13a xFant E GR07 C 0-1 1-60 Nome Fantasia
GR14 xRegApur E GR07 C 0-1 1-60 Regime de Apurao do
ICMS do Contribuinte
GR15 CNAE E GR07 N 0-1 6-7 CNAE principal do
contribuinte
GR16 dIniAtiv E GR07 D 0-1 Data de Incio da
Atividade do Contribuinte
GR17 dUltSit E GR07 D 0-1 Data da ltima
modificao da situao
cadastral do contribuinte.
GR18 dBaixa E GR07 D 0-1 Data de ocorrncia da
baixa do contribuinte.
GR20 IEUnica E GR07 C 0-1 2-14 IE nica, este campo
ser informado quando o
contribuinte possuir IE
nica.
GR21 IEAtual E GR07 C 0-1 2-14 IE atual (em caso de IE
antiga consultada)
GR22 ender G GR07 0-1 Endereo - grupo de
informaes opcionais.
GR23 xLgr E GR22 C 0-1 1-255 Nome do Logradouro
Pg. 73 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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 UF que autorizam a emisso de qualquer espcie de Documento Fiscal eletrnico -
DF-e.
Importante ressaltar que este Web Service no tem a mesma disponibilidade dos demais
Web Services da NF-e.
Pg. 74 / 232
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-Brasil no repositrio de certificados digitais do servidor de Web
Service da SEFAZ.
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.
C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Obrig. 411 Rej.
Header
C05 Verso dos Dados informada superior verso vigente Facult. 238 Rej.
C06 Verso dos Dados no suportada Obrig. 239 Rej.
A aplicao dever validar os campos cUF e versaoDados, rejeitando o lote recebido em caso de
informaes inexistentes ou invlidas.
Pg. 76 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
K06 Se informado IE: Acessar Cadastro Contribuinte por IE Obrig. 261 Rej.
No encontrado Contribuinte
K07 Se informado CPF: Verificar se a UF fornece consulta por CPF Obrig. 262 Rej.
K08 Se informado CPF: Verificar dgito controle ou zeros Obrig. 263 Rej.
K09 Se informado CPF: Acessar Cadastro Contribuinte por CPF Obrig. 264 Rej.
No encontrado Contribuinte
Pg. 77 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
As regras de validao aplicadas nos Web Service esto agrupadas da seguinte forma:
Grupo Aplicao
A Validao do Certificado Digital utilizada no protocolo SSL geral
B Validao da Mensagem XML no servio assncrono geral
C Validao da rea de cabealho da Mensagem XML geral
D Validao da rea de dados da Mensagem XML geral
E Validao do Certificado Digital utilizada na Assinatura Digital geral
F Validao da Assinatura Digital geral
G Validao da NF-e especfica
H Validao do Pedido de Cancelamento de NF-e especfica
I Validao do Pedido de Inutilizao de numerao de NF-e especfica
J Validao do Pedido de Consulta de situao de NF-e especfica
K Validao do Pedido de Consulta de Status de Servio especfica
L Validao do Pedido de Consulta de Cadastro de Contribuintes especfica
OBS.:
Pg. 82 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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:
Todos os textos de um documento XML passam por uma anlise do parser especfico da
linguagem. Alguns caracteres afetam o funcionamento deste parser, no podendo
aparecer no texto de uma forma no controlada.
Ex. a denominao: DIAS & DIAS LTDA deve ser informada como: DIAS & DIAS LTDA
no XML para no afetar o funcionamento do "parser".
Nota: A sequncia de escape conta como um nico caractere para a validao do tamanho
do campo pelo Schema.
A partir da verso 2.00 do leiaute da NF-e, o campo tpEmis (forma de emisso da NF-
e) passou a compor a chave de acesso da seguinte forma:
O tamanho do campo cNF - cdigo numrico da NF-e foi reduzido para oito posies
para no alterar o tamanho da chave de acesso da NF-e de 44 posies que passa ser
composta pelos seguintes campos que se encontram dispersos na NF-e :
DV = 11 - (resto da diviso)
Quando o resto da diviso for 0 (zero) ou 1 (um), o DV dever ser igual a 0 (zero).
A CHAVE DE ACESSO 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
B PESOS 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
C PONDERAO (A*B) 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
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.
O nmero do Recibo do Lote deve ser gerado pelo Portal da Secretaria de Fazenda
Estadual, com a seguinte regra de formao:
9 9 9 9 9 9 9 9 9 9 9 9 9 9 9
rgo cdigo ano seqencial de 10 posies
gerador da UF
A gerao do nmero de protocolo dever ser nica, sendo utilizada por todos os Web
Services que precisam atribuir um nmero de protocolo para o resultado do processamento.
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. 86 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
6. Cdigo de Barra
Com a chave de acesso possvel realizar a consulta integral ou resumida de uma Nota
Fiscal Eletrnica e sua situao, bem como visualizar a autorizao de uso da mesma.
Dentre outras finalidades do cdigo, destacam-se o registro do trnsito de mercadorias nos
Postos Fiscais e, a critrio de cada unidade federada, a disponibilizao do arquivo da NF-e
consultada.
Os dados adicionais contidos no segundo cdigo de barras sero utilizados para auxiliar o
registro do trnsito de mercadorias acobertadas por notas fiscais eletrnicas emitidas em
contingncia.
Margem Margem
Start C Dados representados DV Stop
clara clara
Margem Clara: espao claro que no contm nenhuma marca legvel por mquina,
localizado esquerda e direita do cdigo, a fim de evitar interferncia na decodificao
da simbologia. A margem clara chamada tambm de "rea livre", "zona de silncio" ou
"margem de silncio".
O cdigo de barras dever ser impresso com os padres prprios residentes das
impressoras de no impacto (laser ou deskjet) e de impacto (matriciais ou de linhas) a fim de
respeitarem os padres dos referidos cdigos:
Pg. 87 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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
Pg. 88 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
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
Pg. 89 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
7. DANFE
O DANFE emitido para representar NF-e cujo uso foi autorizado em ambiente de
homologao sempre dever conter a frase SEM VALOR FISCAL no quadro Informaes
Complementares ou em marca dgua destacada.
O DANFE emitido para representar NF-e emitida em contingncia dever conter esta
informao em destaque, conforme disposto no Captulo 8.
O contedo dos campos do DANFE dever conter o contedo das respectivas TAG XML da
NF-e, quando conhecidos no momento da solicitao de autorizao de uso. No podero
ser impressas informaes que no constem do arquivo da NF-e.
O contedo dos campos poder ser impresso em mais de uma linha desde que a leitura
possa ser feita de forma clara.
O item 7.8 deste manual traz a sugesto de tamanhos a serem seguidos para cada campo,
que garantem a legibilidade prevista na legislao. Embora os tamanhos descritos no item
7.8 no sejam obrigatrios, o DANFE dever ser impresso conforme um dos modelos
permitido (conforme o item 7.6.3) e utilizando-se os tamanhos mnimos de fonte descritos no
item 7.7.
O DANFE dever conter todos os campos previstos no modelo adotado, com exceo dos
campos no obrigatrios do quadro Dados dos Produtos/Servios, conforme disposto no
item 7.1.3.
Pg. 90 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A chave de acesso ser impressa em onze blocos de quatro dgitos cada, com a seguinte
mscara:
9999 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999
Poder conter linhas divisrias internas separando as informaes. Podero ser acrescidas
ao quadro outras informaes relativas ao assunto, alm das informaes contidas no grupo
de Dados de Cobrana da NF-e, desde que estas informaes adicionais tambm estejam
contidas no arquivo da NF-e.
Sempre que o contedo de um mesmo item for impresso utilizando-se mais de uma linha do
quadro de Dados dos Produtos/Servios, dever ser aplicado um destaque divisrio que
identifique quais linhas foram utilizadas para cada item, a fim de distinguir com clareza um
item do outro. Pode-se, para tanto, utilizar uma linha tracejada ou pontilhada. Essa exigncia
tambm se aplica no caso da utilizao de uma mesma coluna para aposio de outro
campo, conforme o item 7.5.
Deve-se utilizar o quadro Dados dos Produtos/Servios para detalhar as operaes que
no caracterizem circulao de mercadorias ou prestaes de servios, e que exijam
emisso de documentos fiscais (como transferncia de crditos ou apropriao de
incentivos fiscais, por exemplo).
Nas situaes em que o valor unitrio comercial for diferente do valor unitrio tributvel,
ambas as informaes devero estar expressas e identificadas no DANFE, podendo ser
utilizada uma das linhas adicionais previstas, ou o campo de informaes adicionais.
Independente do descrito no item 7.3, o contribuinte poder suprimir colunas do quadro
Dados dos Produtos/Servios que no se apliquem a suas atividades e acrescentar outras
Pg. 91 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
do seu interesse. A insero destas colunas ser realizada direita da coluna Descrio
dos Produtos/Servios. A ordem das colunas remanescentes devero ser respeitados.
Dever conter todas as Informaes Adicionais da NF-e includas nas TAGs <infAdFisco> e
<infCpl>, ficando facultada a impresso das informaes adicionais contidas nas TAGs
<obsCont>. Na hiptese de insuficincia de espao no quadro de informaes
complementares, a impresso destas dever ser continuada no verso ou na folha seguinte,
neste mesmo quadro ou no quadro Dados dos Produtos/Servios.
permitida a utilizao de uma mesma coluna para aposio de outro campo no quadro
Dados dos Produtos/Servios do DANFE.
A utilizao de uma mesma coluna para mais de um campo implicar na ocupao de duas
linhas do Dados dos Produtos/Servios para cada item da NF-e, alm das linhas adicionais
previstas para descrever as informaes adicionais de produto/servio (TAG <infAdProd>).
Dever ser observada a necessidade de aposio de destaque divisrio dos diferentes itens
do quadro Dados dos Produtos/Servios, conforme descrito no item 7.1.3.
Pg. 92 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A utilizao de uma mesma coluna para mais de um campo no se aplicar para a aposio
do campo Descrio dos Produtos e/ou Servios, podendo-se, neste caso, utilizar mais
linhas para aposio de seu contedo.
Alm das supresses e incluses de colunas tratadas no item 7.1.5, podero ser feitas ainda
as seguintes alteraes:
Caso o emitente no utilize o bloco de Canhoto, poder aumentar o quadro Dados dos
Produtos/Servios suprimindo os campos do referido bloco e deslocando para cima os
campos seguintes. Estes ajustes devero ser feitos no mesmo valor da reduo obtida com
a eliminao do quadro Fatura e de sua descrio.
Essas alteraes podero ser feitas tanto nos formatos retrato quanto paisagem.
Pg. 93 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
At 50% do verso de qualquer folha do DANFE poder ser utilizado para continuao dos
dados do quadro Dados dos Produtos/Servios, do campo Informaes Complementares
ou para uma combinao de ambos. O restante do verso dever ser deixado sem nenhum
tipo de impresso.
Sempre que o verso do DANFE for utilizado, a informao CONTINUA NO VERSO dever
constar no anverso, ao final dos quadros Dados dos Produtos/Servios e Informaes
Complementares, conforme a utilizao.
Cada uma das folhas adicionais dever conter, na parte superior, no mnimo as seguintes
informaes, impressas na mesma disposio e tamanho definidos para a primeira folha:
A rea restante das folhas adicionais poder ser utilizada exclusivamente para apor:
7.6 Formulrio
Para a impresso do DANFE poder ser utilizado qualquer tipo de papel, com exceo de
papel jornal, desde que seja garantido o contraste necessrio para assegurar leitura dos
cdigos de barras sem problemas.
Pg. 94 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
A impresso do DANFE poder ser efetuada tanto em modo retrato quanto em modo
paisagem, utilizando-se formulrios de tamanho mnimo A-4 e mximo Ofcio II (230 x 330
mm).
Em caso de uso de folha de tamanho superior ao tamanho A-4 o espao excedente dever
ser alocado da seguinte maneira:
As Margens entre o corpo impresso do DANFE e o final do formulrio (ou a linha de picote)
devero ter, no mnimo, 0,2 cm e, no mximo, 0,8 cm em cada lateral (inclusive nas
margens superior e inferior).
Todos os caracteres devero estar impressos na fonte Times New Roman ou na fonte
Courier New. A impresso dos dados variveis feitas por Impressoras de Impacto (Matricial
e de Linha) dever estar entre 10 e 17 CPP (Caracteres por Polegada).
Dever ter tamanho mnimo de cinco (5) pontos, impresso em negrito em caixa alta
(maisculas).
Dever ser impresso em caixa alta (maisculas), com tamanho mnimo de cinco (5) pontos.
Pg. 95 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Dever ser impresso em caixa alta (maisculas) e ter tamanho mnimo de seis (6) pontos.
Dever estar impresso em negrito. A razo social e/ou nome fantasia dever ter tamanho
mnimo de doze (12) pontos, ou 17 CPP e os demais dados do emitente, endereo,
municpio, CEP, fone/fax devero ter tamanho mnimo de oito (8) pontos, ou 17 CPP.
Esta seo apresenta a sugesto de tamanho e posio de cada campo. Todas as medidas
esto em centmetros.
Obs 1 Permite-se a incluso dos dados de duplicatas das TAG do grupo Y07
Obs 2 Detalhamento especficos de produtos/servios (outras TAG do grupo H)
Obs 3 Total Bruto (TAG) ou Lquido (Mod.1/1-A)?
Obs 4 Colunas apresentadas na ordem descrita
Obs 5 TAG: C03, C04, C06, C07, C08, C09, C11, C12, C13, C16
Obs 6 TAG: B11
Obs 7 TAG: B07, B08
Obs 8 TAG: X02
Obs 9 Campo utilizado exclusivamente no Modelo de Contingncia
Pg. 98 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Pg. 99 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
O leiaute de impresso DANFE prev dois campos de contedo varivel logo abaixo do
local onde impressa a chave de acesso, de acordo com a seguinte disposio:
DANFE
DOCUMENTO AUXILIAR DA
NOTA FISCAL ELETRNICA 99999999999999999999999999999999999999999999
0- ENTRADA 1
1- SADA CHAVE DE ACESSO
9999 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999
N 999.999.999
SRIE 999
FOLHA 01/01 Campo 1 de contedo varivel
Nestes casos, aps a obteno da autorizao de uso da NF-e o emissor poder imprimir o
DANFE em papel comum, informando o nmero do protocolo de autorizao de uso e a data
e a hora de autorizao no Campo 2, de acordo com a seguinte disposio:
DANFE
DOCUMENTO AUXILIAR DA
NOTA FISCAL ELETRNICA 99999999999999999999999999999999999999999999
0- ENTRADA 1
1-SADA CHAVE DE ACESSO
9999 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999
N 999.999.999
SRIE 999 Consulta de autenticidade no portal nacional da NF-e
FOLHA 01/01 www.nfe.fazenda.gov.br/portal ou no site da Sefaz Autorizadora
PROTOCOLO DE AUTORIZAO DE USO
11090123456789 12/03/2009 10:00:00
Neste caso, o emissor dever gerar o Cdigo de Barras Adicional Dados da NF-e no
Campo 1 e a representao numrica deste Cdigo de Barras Adicional no Campo 2:
DANFE
DOCUMENTO AUXILIAR DA
NOTA FISCAL ELETRNICA 99999999999999999999999999999999999999999999
0-ENTRADA 1
1-SADA CHAVE DE ACESSO
9999 9999 9999 9999 9999 9999 9999 9999 9999 9999 9999
N 999.999.999
SRIE 999
FOLHA 01/01
999999999999999999999999999999999999
DADOS DA NF-E
O Cdigo de Barras Adicional dos Dados da NF-e ser formado pelo seguinte contedo, em
um total de 36 caracteres:
Obs. Todos os campos que formam o cdigo de barras devem ser preenchidos com
alinhamento direita, sem formatao e com os zeros no significativos necessrios para
alcanar o tamanho do campo.
Aps o registro da DPEC o emissor poder imprimir o DANFE em papel comum devendo
consignar o nmero e data e hora do registro do DPEC no campo 2:
DANFE
DOCUMENTO AUXILIAR DA
NOTA FISCAL ELETRNICA 99999999999999999999999999999999999999999999
0-ENTRADA 1
1-SADA CHAVE
9999DE 9999
ACESSO
9999 9999 9999 9999 9999 9999 9999 9999 9999
N 999.999.999
SRIE 999 Consulta de autenticidade no portal da NF-e
www.nfe.fazenda.gov.br/portal
FOLHA 01/01
NMERO DE REGISTRO DPEC
11090123456789 12/03/2009 10:00:00
7.10 Outros
O formulrio poder conter marca dgua desde que no prejudique a legibilidade dos dados
impressos.
O nmero de ordem e o nmero total de folhas devero ser impressos na parte superior de
cada uma das folhas do DANFE, inclusive na primeira, mesmo que se utilize uma nica
folha.
Se, no formato retrato, for necessria a utilizao de uma margem superior ou inferior maior,
devido a limitaes da impressora, a reduo necessria poder ser feita somente na altura
do quadro de Dados dos Produtos/Servios deslocando os campos seguintes para cima
pelo valor desta reduo. Essa reduo no permitida no formato paisagem.
8. Contingncia
A autorizao de uso de NF-e no ambiente de produo, nos termos das clusulas quarta e
quinta do Ajuste Sinief 07/05, de 30 de setembro de 2005, tem o efeito de permitir que o
arquivo da NF-e seja utilizado como documento fiscal.
A utilizao pelo contribuinte de qualquer um dos dois ambientes fica condicionada a prvia
autorizao da Secretaria de Fazenda, Finanas ou Tributao de sua UF, atravs do
respectivo processo de credenciamento.
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 e, ainda que hbil para
acompanhar o trnsito de mercadorias, no substitui o arquivo da 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 neste caso dever ser mantido
pelo prazo decadencial para apresentao Administrao Tributria quando solicitado.
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.
Dever ser disponibilizado para o destinatrio o mesmo contedo da NF-e enviada para a
SEFAZ, complementada com os dados da homologao do pedido de cancelamento,
na forma que segue.
17 B13 refNFe Chave de acesso da NF-e CE B12a N 1-1 44 Utilizar esta TAG para
referenciada referenciar uma Nota Fiscal
Eletrnica emitida
anteriormente, vinculada a NF-e
atual.
18 B14 refNF Grupo de informao da NF C B12a 1-1
modelo 1/1A referenciada G
19 B15 cUF Cdigo da UF do emitente do E B14 N 1-1 2 Utilizar a Tabela do IBGE
Documento Fiscal (Anexo VII - Tabela de UF,
Municpio e Pas)
20 B16 AAMM Ano e Ms de emisso da NF- E B14 N 1-1 4 AAMM da emisso da NF
e
21 B17 CNPJ CNPJ do emitente E B14 C 1-1 14 Informar o CNPJ do emitente da
NF
22 B18 mod Modelo do Documento Fiscal E B14 N 1-1 2 Informar o cdigo do modelo do
Documento fiscal: 01 modelo
01
23 B19 serie Srie do Documento Fiscal E B14 N 1-1 1-3 Informar a srie do documento
fiscal (informar zero se
inexistente).
24 B20 nNF Nmero do Documento Fiscal E B14 N 1-1 1-9 1 999999999
24a B20a refNFP Grupo de informaes da NF C B12a 1-1
N - ICMS Normal e ST
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec Observao
164 N01 ICMS Grupo do ICMS da Operao CG M01 1-1 Informar apenas um dos grupos
prpria e ST N02, N03, N04, N05, N06, N07,
N08, N09, N10, N10a, N10b ou
N10c com base no contedo
informado na TAG Tributao
do ICMS. (v2.0)
Pgina 128 de 232
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec. Observao
253 O09 CST Cdigo da situao tributria E O07 C 1-1 2 00-Entrada com recuperao de
do IPI crdito
49-Outras entradas
50-Sada tributada
99-Outras sadas
254 O10 vBC Valor da BC do IPI CE O07 N 1-1 15 2 Informar os campos O10 e O13
257 O13 pIPI Alquota do IPI CE O07 N 1-1 5 2 caso o clculo do IPI seja por
255 O11 qUnid Quantidade total na unidade CE O07 N 1-1 16 4 alquota ou os campos O11 e
padro para tributao O12 caso o clculo do IPI seja
(somente para os produtos valor por unidade.
tributados por unidade)
Q PIS
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec Observao
267 Q01 PIS Grupo do PIS G M01 1-1 Informar apenas um dos grupos
Q02, Q03, Q04 ou Q05 com
base valor atribudo ao campo
Q06 CST do PIS
268 Q02 PISAliq Grupo de PIS tributado pela C Q01 1-1 CST = 01 e 02
alquota G
269 Q06 CST Cdigo de Situao Tributria E Q02 N 1-1 2 01 Operao Tributvel (base
do PIS de clculo = valor da operao
alquota normal
(cumulativo/no cumulativo));
408 ZB04 xCont Contrato E ZB01 C 0-1 1-60 Informar o contrato de compra
ZC - Informaes do Registro de Aquisio de Cana
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec Observao
409 ZC01 cana Grupo de cana G A01 0-1 Informaes de registro
aquisies de cana v2.0
410 ZC02 safra Identificao da safra E ZC01 C 1-1 4-9 Informar a safra, AAAA ou
AAAA/AAAA. v2.0
411 ZC03 ref Ms e ano de referncia E ZC01 C 1-1 6 Informar o ms e ano de
referncia, MM/AAAA. v2.0
412 ZC04 forDia Grupo de Fornecimento dirio G ZC01 1-31 Informar os fornecimentos
de cana dirios de cana v2.0
427 ZC05 dia Dia A ZC04 N 1-1 1-2 v2.0
414 ZC06 qtde Quantidade E ZC04 N 1-1 1-11 10 Quantidade em KG v2.0
415 ZC07 qTotMes Quantidade Total do Ms E ZC01 N 1-1 1-11 10 v2.0
416 ZC08 qTotAnt Quantidade Total Anterior E ZC01 N 1-1 1-11 10 v2.0
417 ZC09 qTotGer Quantidade Total Geral E ZC01 N 1-1 1-11 10 v2.0
418 ZC10 deduc Grupo de Dedues Taxas e G ZC01 0-10 Informar as Dedues Taxas
Contribuies e Contribuies v2.0
419 ZC11 xDed Descrio da Deduo E ZC10 C 1-1 1-60 Informar a Descrio da
Deduo e v2.0
420 ZC12 vDed Valor da Deduo E ZC10 N 1-1 15 2 v2.0
421 ZC13 vFor Valor dos Fornecimentos E ZC01 N 1-1 15 2 Valor dos Fornecimentos v2.0
422 ZC14 vTotDed Valor Total da Deduo E ZC01 N 1-1 15 2 Valor das dedues v2.0
Pgina 157 de 232
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec. Observao
423 ZC15 vLiqFor Valor Lquido dos E ZC01 N 1-1 15 2 Valor Lquido dos
Fornecimentos Fornecimentos v2.0
ZZ - Informaes da Assinatura Digital
# ID Campo Descrio Ele Pai Tipo Ocorrncia tamanho Dec Observao
999 ZZ01 Signature Assinatura XML da NF-e G A01 1-1
Segundo o Padro XML Digital
Signature
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 Tributao do ICMS.
Exemplo:
O preenchimento dos campos de tributos relacionados com o ICMS Normal e ST depende do contedo informado no cdigo de Tributao do ICMS (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 cdigo de Tributao do ICMS aplicvel para a situao, o grupo de tributo ICMS Normal e ST dever ter os campos assinalados com S ou ? da
seguinte tabela:
Tributao do ICMS
ID Campo Descrio
00 10 20 30 40 41 50 51 60 70 90
N11 Orig Origem da mercadoria S S S S S S S S S S ?
N12 CST Tributao do ICMS S S S S S S S S S S ?
N13 modBC Modalidade de determinao da S S S N N N N ? N S ?
BC do ICMS
Pgina 159 de 232
N14 pRedBC Percentual da Reduo de BC N N S N N N N ? N S ?
N15 vBC Valor da BC do ICMS S S S N N N N ? N S ?
N16 pICMS Alquota do imposto S S S N N N N ? N S ?
N17 vICMS Valor do ICMS S S S N N N N ? N S ?
N18 modBCST Modalidade de determinao da N S N S N N N N N S ?
BC do ICMS ST
N19 pMVAST Percentual da margem de valor N S N S N N N N N S ?
Adicionado do ICMS ST
N20 pRedBCST Percentual da Reduo de BC do N ? N ? N N N N N ? ?
ICMS ST
N21 vBCST Valor da BC do ICMS ST N S N S N N N N S S ?
N22 pICMSST Alquota do imposto do ICMS ST N S N S N N N N N S ?
N23 vICMSST Valor do ICMS ST N S N S N N N N S S ?
N24 UFST UF para qual devido o ICMS N N N N N N N N N N ?
ST
N25 pBCop Percentual da BC operao N N N N N N N N N N ?
prpria
N26 vBCSTRet Valor da BC do ICMS Retido N N N N N S N N S N ?
Anteriormente
N27 vICMSSTRet Valor do ICMS Retido N N N N N S N N S N ?
Anteriormente
N28 motDesICMS Motivo da desonerao do ICMS N N N N N N N N N N ?
N31 vBCSTDest Valor da BC do ICMS ST da UF N N N N N S N N N N N
destino
N32 vICMSSTDest Valor do ICMS ST da UF destino N N N N N S N N N N N
* 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:
f) coluna Tipo:
N campo numrico;
C campo alfanumrico;
D campo data;
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;
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) :
3. A informao do cdigo de selo, quando aplicvel, deve ser informada utilizando a codificao prevista nos Atos Normativos editados pela Receita
Federal.
WS de Homologao: http://hom.nfe.fazenda.gov.br/PORTAL/WebServices.aspx
WS de Produo: http://www.nfe.fazenda.gov.br/portal/WebServices.aspx
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, Secretaria da Receita Federal do Brasil, Superintendncia da Zona
Franca de Manaus (SUFRAMA), Encontro Nacional de Coordenadores e Administradores
Tributrios Estaduais (ENCAT) e as seguintes empresas:
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:
ftp://geoftp.ibge.gov.br/Organizacao/Divisao_Territorial/2008/DTB_2008.zip
Quando a operao envolver regies administrativas (Ex. Cidades-satlites do DF), deve ser
considerado o municpio sede como localidade da operao.
Composio: UUNNNND
Onde:
UU = Cdigo da UF do IBGE
NNNN = Nmero de ordem dentro da UF;
D = Dgito de Controle mdulo 10
Validao possvel:
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.
Exemplo 1:
A. CDIGO MUN 3 5 5 0 3 0
B. PESOS 1 2 1 2 1 2
C. PONDERAO (A * B) 3 10 5 0 3 0
D. SOMA ALGARISMOS 3 1 5 0 3 0
Exemplo 2:
A. CDIGO MUN 2 1 1 1 3 0
B. PESOS 1 2 1 2 1 2
C. PONDERAO (A * B) 2 2 1 2 3 0
D. SOMA ALGARISMOS 2 2 1 2 3 0
As aplicaes dos Estados e dos emissores devem utilizar os cdigos de municpio do IBGE
sem validao do DV dgito verificador, da mesma forma como consta da tabela de cdigo
de municpio do IBGE.
http://www.bcb.gov.br/Rex/TabPaises/Ftp/paises.txt
Exemplo de codificao:
NNND
Onde:
NNN = Nmero de ordem do Cdigo do Pas;
D = Dgito de Controle mdulo 11.
Validao possvel:
Obs.: Se o resto da diviso for zero ou 1, considerar o dgito verificador igual a zero.
A. CDIGO PAS 1 0 5
B. PESOS 4 3 2
C. PRODUTOS (A * B) 4 0 10
A. CDIGO PAS 5 8 6
B. PESOS 4 3 2
C. PRODUTOS (A * B) 20 24 12
O cdigo de Pas do BACEN dos seguintes pases tem o DV - dgito verificador invlido:
As aplicaes dos Estados e dos emissores devem utilizar os cdigos de Pas do BACEN
sem validao do DV dgito verificador, da mesma forma que consta da tabela de cdigo
de pas do BACEN.
Verso 1.01
Maro 2009
Pg. 177 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Controle de Verses
Verso Data
1.00 03/03/2009 SP
1. Introduo
A validade de uma NF-e e do respectivo DANFE est condicionada existncia de uma autorizao
de uso da Nota Fiscal Eletrnica NF-e concedida pela Secretaria de Fazenda de localizao do
emissor ou pelo rgo por ela designado para autorizar a NF-e em seu nome, como so os casos da
SEFAZ Virtual do Ambiente Nacional, da SEFAZ Virtual do Rio Grande do Sul e do Sistema de
Contingncia do Ambiente Nacional - SCAN.
A obteno da autorizao de uso da NF-e um processo que envolve diversos recursos de infra-
estrutura, hardware e software. O mau funcionamento ou a indisponibilidade de qualquer um destes
recursos pode prejudicar o processo de autorizao da NF-e, com reflexos nos negcios do emissor
da NF-e que fica impossibilitado de obter a prvia autorizao de uso da NF-e exigida na legislao
para a emisso do DANFE para acompanhar a circulao da mercadoria.
A alta disponibilidade uma das premissas bsicas do sistema da NF-e e os sistemas de recepo
de NF-e das UF foram construdos para funcionar em regime de 24x7, contudo, existem diversos
outros componentes do sistema que podem apresentar falhas e comprometer a disponibilidade dos
servios, exigindo alternativas de emisso da NF-e em contingncia.
Em um cenrio de falha que impossibilite a emisso da NF-e na modalidade normal, o emissor deve
escolher a modalidade de emisso de contingncia que lhe for mais conveniente, ou at mesmo
aguardar a normalizao da situao para voltar a emitir a NF-e na modalidade normal, caso a
emisso da NF-e no seja premente.
O processo de emisso normal a situao desejada e mais adequada para o emissor, pois a
situao em que todos os recursos necessrios para a emisso da NF-e esto operacionais e a
autorizao de uso da NF-e concedida normalmente pela SEFAZ.
Nesta situao a emisso das NF-e realizada normalmente com a impresso do DANFE em papel
comum, aps o recebimento da autorizao de uso da NF-e.
Nota: Esta alternativa de contingncia poder ser utilizada at o trmino do estoque de Formulrios
de Segurana FS autorizados, mediante PAFS, at 31/07/09,, desde que o Formulrio de
Segurana FS tenha tamanho A4 e seja lavrado termo no livro RUDFTO, conforme dispe a
clusula dcima segunda do Convnio ICMS 110/08, a seguir transcrito:
Pg. 184 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
2.1.3
O SCAN somente tratar NF-e emitidas com numerao nas sries 900 a 999, inclusive. Esta regra
aplica-se a todos os servios (autorizao, cancelamento, inutilizao e consulta situao da NF-e).
Com esta restrio elimina-se a possibilidade de que, aps a recuperao de uma falha, uma mesma
NF-e tenha sido autorizada pelo SCAN e pela SEFAZ origem. Da mesma forma, a SEFAZ origem
no autorizar, cancelar ou inutilizar numerao de NF-e nestas sries reservadas ao SCAN. A
exceo a esta regra o servio de consulta situao da NF-e, uma vez que a SEFAZ origem
poder responder consulta de situao das NF-e das sries 900-999 que estejam em sua base de
dados.
A recepo das NF-e pelo SCAN ativado pela UF interessada e uma vez acionada passa a
recepcionar as NF-e de srie 900 a 999 dos emissores credenciados para emitir NF-e na UF.
Eventualmente um emissor credenciado recentemente pode no estar autorizado a emitir NF-e no
SCAN caso o Cadastro Nacional de Emissores no tenha sido atualizado pela UF interessada.
Ocorrendo a indisponibilidade, a SEFAZ origem acionar o SCAN para que ative o servio de
recepo e autorizao de NF-e em seu lugar. Finda a indisponibilidade, a SEFAZ origem acionar
novamente o SCAN, agora para desativar o servio. A desativao do servio de recepo e
autorizao de NF-e pelo SCAN ser precedida por um perodo de 15 minutos, em que ambos os
ambientes estaro simultaneamente disponveis, de forma a minimizar o impacto da mudana para o
Contribuinte.
Aps a recuperao da falha pela SEFAZ origem, as NF-e recebidas pelo SCAN (sries 900 a 999)
sero transmitidas pelo Ambiente Nacional para a SEFAZ origem, de forma que, como as demais
NF-e, elas ficaro disponveis para consulta nos dois ambientes.
A contingncia SCAN dever ser ativada com maior freqncia nas situaes em que a
indisponibilidade da recepo de NF-e pela SEFAZ de origem seja previsvel e de longa durao
como o caso das interrupes programadas para manuteno preventiva da infra-estrutura de
recepo da SEFAZ de origem.
A identificao de que o SCAN foi ativado pela SEFAZ ser atravs do servio Consulta ao Status do
SCAN que poder retornar os seguintes cdigos de situao:
A empresa pode acionar o SCAN somente quando obtiver o status 107 - Servio em Operao,
devendo adotar os seguintes procedimentos:
https://hom.nfe.fazenda.gov.br/SCAN/NfeCancelamento2/NfeCancelamento2.asmx
https://hom.nfe.fazenda.gov.br/SCAN/NfeConsulta2/NfeConsulta2.asmx
https://hom.nfe.fazenda.gov.br/SCAN/NfeInutilizacao2/NfeInutilizacao2.asmx
https://hom.nfe.fazenda.gov.br/SCAN/NfeRecepcao2/NfeRecepcao2.asmx
https://hom.nfe.fazenda.gov.br/SCAN/NfeRetRecepcao2/NfeRetRecepcao2.asmx
https://hom.nfe.fazenda.gov.br/SCAN/NfeStatusServico2/NfeStatusServico2.asmx
Pg. 187 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
https://www.scan.fazenda.gov.br/NfeCancelamento2/NfeCancelamento2.asmx
https://www.scan.fazenda.gov.br/NfeConsulta2/NfeConsulta2.asmx
https://www.scan.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx
https://www.scan.fazenda.gov.br/NfeRecepcao2/NfeRecepcao2.asmx
https://www.scan.fazenda.gov.br/NfeRetRecepcao2/NfeRetRecepcao2.asmx
https://www.scan.fazenda.gov.br/NfeStatusServico2/NfeStatusServico2.asmx
O modelo de Contingncia Eletrnica foi idealizado como alternativa que permita a dispensa do uso
do formulrio de segurana para impresso do DANFE e a no alterao da srie e numerao da
NF-e emitida em contingncia.
NF-e
Impossibilidade de transmisso
SEFAZ Sistema de Recepo de
Emissor de NF-e
NF-e da SEFAZ
Gerar DPEC
DPEC
A Contingncia Eletrnica poder ser adotada por qualquer emissor que esteja impossibilitado de
transmisso e/ou recepo das autorizaes de uso de suas NF-e, adotando os seguintes passos:
https://hom.nfe.fazenda.gov.br/SCERecepcaoRFB/SCERecepcaoRFB.asmx
https://hom.nfe.fazenda.gov.br/SCEConsultaRFB/SCEConsultaRFB.asmx
https://hom.nfe.fazenda.gov.br/PORTAL/DPEC/ConsultaDPEC.aspx
https://hom.nfe.fazenda.gov.br/PORTAL/DPEC/UploadDPEC.aspx
https://www.nfe.fazenda.gov.br/SCERecepcaoRFB/SCERecepcaoRFB.asmx
https://www.nfe.fazenda.gov.br/SCEConsultaRFB/SCEConsultaRFB.asmx
Pgina Web da DPEC do ambiente de produo:
https://www.nfe.fazenda.gov.br/portal/DPEC/ConsultaDPEC.aspx
https://www.nfe.fazenda.gov.br/portal/DPEC/UploadDPEC.aspx
Este procedimento de contingncia ser adotado pelos emissores que adquirirem o Formulrio de
Segurana para impresso de Documento Auxiliar de Documento Fiscal FS-DA, e substitui a
contingncia com o uso do formulrio de segurana.
Sendo identificada a existncia de qualquer fator que prejudique ou impossibilite a transmisso das
NF-e e/ou obteno da autorizao de uso da SEFAZ, a empresa pode acionar a Contingncia com
FS-DA, adotando os seguintes passos:
O DANFE dever ser impresso em papel, exceto papel jornal, no tamanho mnimo A4 (210 x 297
mm) e mximo ofcio 2 (230 x 330 mm), podendo ser utilizadas folhas soltas, formulrio de
segurana, Formulrio de Segurana para Impresso de Documento Auxiliar de Documento Fiscal
Eletrnico (FS-DA), formulrio contnuo ou formulrio pr-impresso.
O uso do formulrio de segurana - FS ser permitido apenas para consumir os estoques existentes,
pois sua aquisio para impresso de DANFE no ser mais autorizada a partir de 01/08/2009.
FS com Estampa Fiscal impresso com calcografia com microtexto e imagem latente na
rea reservado ao fisco, o impresso dever ter fundo numismtico com tinta reagente a
produtos qumicos combinado com as Armas da Repblica;
FS em Papel de Segurana - com filigrana (marca dgua) produzida pelo processo "mould
made", fibras coloridas e luminescentes, papel no fluorescente, microcpsulas de reagente
qumico e microporos que aumentem a aderncia do toner ao papel.
A distino deste papel de segurana deve ser feito pela filigrana (marca dgua) existente no seu
corpo; pela seriao composta por duas letras e numerao seqencial de nove nmeros aposta no
espao normalmente reservado ao fisco; pela impresso da identificao do adquirente e pelo
cdigos de barras impressos no rodap inferior.
Ex. FS com os detalhes da filigrana que s visvel contra luz. No FS-DA teremos o logotipo do Documento
Auxiliar de Documentos Fiscais Eletrnicos no lugar da expresso NOTA FISCAL.
Modelo das dimenses e posicionamento das filigranas no papel de segurana para FS-DA
A estampa fiscal impressa na rea reservado ao fisco que est localizada no canto inferior direito
do formulrio de segurana.
Nesta mesma rea tambm impresso a srie e o nmero de controle do impresso, assim, o
emissor deve tomar os cuidados necessrios para que o recibo do canhoto de entrega no utilize o
Pg. 195 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Importante destacar que o FS-DA tem um cdigo de barras com a identificao da sua origem e seu
usurio pr-impresso no rodap inferior, que deve ser preservado, pois ser utilizado na fiscalizao
de trnsito.
Nos casos de contingncia com uso de formulrio de segurana, a impresso do DANFE em papel
comum contraria a legislao e ocasiona graves conseqncias ao emitente, pelo descumprimento
de obrigao acessria, caracterizando ainda a inidoneidade do DANFE para efeito de circulao da
mercadoria e de escriturao e aproveitamento do crdito pelo seu destinatrio.
O formulrio de segurana pode ser utilizado para impresso do DANFE em qualquer modalidade de
emisso, contudo, o emissor dever formalizar a opo pelo uso do formulrio de segurana em
todas as operaes no livro Registro de Documentos Fiscais e Termos de Ocorrncia RUDFTO,
modelo 6.
em papel comum
em FS (Convnio ICMS 58/57)
em FS-DA (Convnio ICMS 110/08)
DANFE regular / DANFE irregular / DANFE regular, mas requer opo do emissor
Qualquer que seja a hiptese de contingncia, necessrio lavrar termo circunstanciado no livro
Registro de Documentos Fiscais e Termos de Ocorrncia RUDFTO, modelo 6, para registro da
contingncia, informando:
As notas fiscais emitidas em contingncia FS, FS-DA e DPEC devem ser transmitidas imediatamente
aps a cessao dos problemas tcnicos que impediam a transmisso da NF-e, observando o prazo
limite de transmisso estabelecido na legislao.
I - gerar novamente o arquivo com a mesma numerao e srie, sanando a irregularidade desde que
no se altere:
a) as variveis que determinam o valor do imposto tais como: base de clculo, alquota,
diferena de preo, quantidade, valor da operao ou da prestao;
b) a correo de dados cadastrais que implique mudana do remetente ou do destinatrio;
c) a data de emisso ou de sada;
II - solicitar Autorizao de Uso da NF-e;
III - imprimir o DANFE correspondente NF-e autorizada, no mesmo tipo de papel utilizado para
imprimir o DANFE original;
IV - providenciar, junto ao destinatrio, a entrega da NF-e autorizada bem como do novo DANFE
impresso nos termos do item III, caso a gerao saneadora da irregularidade da NF-e tenha
promovido alguma alterao no DANFE.
Quando ocorrer uma falha, seja ela no ambiente do Contribuinte, no ambiente da SEFAZ origem ou no
ambiente do SCAN, h a probabilidade de existirem NF-e transmitidas pelo contribuinte e para as quais ele
ainda no obteve o resultado do processamento. Estas NF-e so denominadas de NF-e Pendentes de
Retorno.
As NF-e Pendentes de Retorno podem no ter sido recebidas pela SEFAZ origem, estar na fila aguardando
processamento, estar em processamento ou o processamento pode j ter sido concludo.
Caso a falha tenha ocorrido na SEFAZ origem, ao retornar operao normal, possvel que as NF-e que
estavam em processamento sejam perdidas, e que as que estavam na fila tenham o seu processamento
concludo normalmente.
Cabe aplicao do contribuinte tratar adequadamente a situao das NF-e Pendentes de Retorno e executar,
imediatamente aps o retorno operao normal, as aes necessrias regularizao da situao destas
NF-e, a saber:
a) Cancelar as NF-e Pendentes de Retorno que tenham sido autorizadas pela SEFAZ origem, mas que
tiveram as operaes comerciais correspondentes registradas em NF-e emitidas em contingncia.
b) Inutilizar a numerao das NF-e Pendentes de Retorno que no foram autorizadas ou denegadas.
Como a DPEC um resumo das NF-e, o seu tamanho bastante reduzido em comparao com a
NF-e, sendo vivel a transmisso para o Web Service do SCE por acesso discado ou atravs de
upload em pgina WEB do Portal Nacional da NF-e (Ambiente Nacional). A opo de upload de
arquivo interessante por dispensar a exigncia de uma aplicao cliente para consumir o Web
Service, permitindo a transmisso da DPEC de qualquer equipamento que tenha acesso a Internet
via browser.
A consulta da DPEC existente no Sistema de Contingncia Eletrnica SCE poder ser feita atravs
de Web Service pelo emissor.
A consulta pela chave de acesso da NF-e dever disponibilizar as informaes bsicas da NF-e
dando uma maior segurana para todos os envolvidos no processo de emisso da NF-e.
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 o 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 <?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 retorno da DPEC, deve-se
tomar o cuidado para que exista uma nica declarao no incio do arquivo.
b) Declarao namespace
O documento XML dever ter uma nica declarao de namespace no elemento raiz do
documento com o seguinte padro:
Cada documento XML dever ter o seu namespace individual em seu elemento raiz. No caso
especfico do arquivo de retorno da DPEC, a DPEC enviada e o arquivo de retorno tero seu
namespace individual, para possibilitar que a extrao da DPEC enviada da mensagem de
retorno se necessrio.
c) Prefixo de namespace
d) Validao de Schema
Para garantir minimamente a integridade das informaes prestadas e a correta formao dos
arquivos XML, as mensagens XML devero ser submetidas ao respectivo Schema XML (XSD
XML Schema Definition).
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
O modelo de comunicao segue o padro de Web Services definido pelo WS-I Basic Profile.
O certificado digital utilizado no estabelecimento da conexo segura com autenticao mtua 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 e ter a extenso Extended Key Usage com permisso de
"Autenticao Cliente".
Pg. 201 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
As chamadas dos Web Services disponibilizados pelo Ambiente Nacional e os respectivos resultados
do processamento so realizadas atravs das mensagens com o seguinte padro:
A identificao da verso da mensagem XML submetida ao Web Service ser realizada atravs do
campo versaoDados informado no elemento sceCabecMsg do SOAP Header:
<soap12:Header>
<sceCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/SCERecepcaoRFB">
<versaoDados>string</versaoDados>
</sceCabecMsg>
</soap12:Header>
A informao armazenada na rea de dados um documento XML que deve atender o leiaute
definido na documentao do Web Service acessado:
<soap12:Body>
<sceRecepcaoDPECResponse xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/SCERecepcaoRFB">
<nfeRetornoMsg>xml</nfeRetornoMsg>
</sceRecepcaoDPECResponse>
</soap12:Body>
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 clientes 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 do elemento
sceCabecMsg do SOAP Header.
<soap12:Header>
<sceCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/SCERecepcaoRFB">
<versaoDados>1.00</versaoDados>
</sceCabecMsg>
</soap12:Header>
Qualquer alterao 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 da literal _v, como segue:
A maioria dos Schemas XML do Sistema de Contingncia Eletrnica utiliza as definies de tipos
bsicos ou tipos complexos que esto definidos em outros Schemas XML (ex.:
leiauteDPEC_v1.00.xsd, etc.), nestes casos, a modificao de verso do Schema bsico ser
repercutida no Schema principal.
schema_v1.01.xsd"/>
<xs:include schemaLocation="leiauteDPEC_v1.00.xsd"/>
<xs:element name="envDPEC">
<xs:annotation>
<xs:documentation>mensagem de envio de DPEC</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.4.1 Liberao das verses dos Schemas para o WS do Sistema de Contingncia Eletrnico
A cada nova liberao ser disponibilizado um arquivo compactado contendo o conjunto de schemas
a serem utilizados pelos emissores de NF-e para a gerao dos arquivos XML. Este arquivo ser
denominado Pacote de Liberao e ter a mesma numerao da verso do Manual que lhe
compatvel. Os pacotes de liberao sero identificados pelas letras PL_SCE, seguida do nmero
da verso do Manual do Sistema de Contingncia Eletrnica correspondente. Exemplificando: O
pacote PL_SCE_1.00.zip representa o Pacote de Liberao de schemas do WS do Sistema de
Contingncia Eletrnica compatveis com o Manual de Sistema de Contingncia Eletrnica verso
1.00.
Os schemas XML das mensagens XML do projeto so identificados pelo seu nome, seguido da
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:
Aps a divulgao de uma nova verso do Manual de Sistema de Contingncia Eletrnica, ser
divulgado um pacote de liberao preliminar com vigncia limitada at o incio da fase de
disponibilizao do ambiente de homologao.
Durante este perodo, os novos Schemas XML sero avaliados e testados para a identificao de
eventuais falhas de implementao das alteraes realizadas na nova verso do Manual de Sistema
de Contingncia Eletrnica.
O PL preliminar ser identificado com o acrscimo do literal pre na identificao do pacote, como
por exemplo: PL_SCE_1.00pre.zip.
O pacote de liberao definitivo ser divulgado na vspera da data de incio da vigncia do ambiente
de produo.
Em algumas situaes pode surgir a necessidade de correo de um Schema XML por um erro de
implementao de regra de validao, obrigatoriedade de campo, nome de tag divergente do definido
no leiaute da mensagem, que no modifica a estrutura do Schema XML e nem exige a alterao dos
aplicativos da SEFAZ.
Nesta situao, divulgaremos um novo pacote de liberao com o Schema XML corrigido, sem
modificar o nmero da verso do PL para manter a compatibilidade com o Manual de Sistema de
Contingncia Eletrnica vigente.
A identificao dos pacotes mais recentes se dar com o acrscimo de letra minscula do alfabeto,
como por exemplo: PL_SCE_1.00a.ZIP, indicando que se trata da primeira verso corrigida do
PL_SCE_1.00.ZIP
Este controle de verses permite a adaptao dos sistemas de informtica dos emissores em
diferentes datas. Ou seja, alguns emissores podero estar com uma verso de leiaute mais
atualizada, enquanto outros podero ainda estar operando com mensagens em um leiaute anterior.
Mensagens recebidas com uma verso de leiaute no suportada sero rejeitadas com uma
mensagem de erro especfica na verso do leiaute de resposta mais recente em uso.
4. Web Services
Os Web Services disponibilizam os servios que sero utilizados pelos aplicativos dos emissores de
NF-e que desejam emitir a NF-e em contingncia pelo Sistema de Contingncia Eletrnica. 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) O envio da solicitao e a obteno do retorno sero realizados na mesma conexo atravs de
um nico mtodo.
c) As URL dos Web Services sero publicadas no portal do Ambiente Nacional. Acessando a
URL pode ser obtido o WSDL (Web Services Description Language) de cada Web Service.
d) O processo de utilizao dos Web Services sempre iniciado pelo emissor da NF-e enviando
uma mensagem nos padres XML e SOAP, atravs do protocolo SSL com autenticao mtua.
e) 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.
O Servio de Recepo de DPEC o servio oferecido pelo WS do Sistema de Contingncia Eletrnica para atualizao do
repositrio de Declarao Prvia de Emisso em Contingncia - DPEC emitidos por emissores de NF-e que emitam NF-e
pelo Sistema de Contingncia Eletrnica.
Web Service :
SCERecepcaoRFB
Envio de Declarao Prvia Proc.
de Emisso em Contingncia sceRecepcaoDPEC Recepo
Ret
Cliente
Aplicao SCE
Retorno
Processo: sncrono.
Mtodo: sceRecepcaoDPEC
Ao optar por adotar o uso do Sistema de Contingncia Eletrnica, o emissor de NF-e deve executar
os seguintes procedimentos:
a) Gerao da DPEC
alterar o tpEmis das NF-e que deseja emitir em Sistema de Contingncia Eletrnica para 4;
regerar as notas fiscais e os lotes de NF-e;
gerar o arquivo XML de Declarao Prvia de Emisso em Contingncia DPEC, com as
seguintes informaes das NF-e que compe um lote de NF-e:
o chave de acesso;
o CNPJ ou CPF do destinatrio;
o UF de localizao do destinatrio;
o Valor Total da NF-e;
o Valor Total do ICMS;
o Valor Total do ICMS ST;
o o arquivo gerado deve ser complementado com outras informaes de controle como
o CNPJ, a IE e a UF de localizao do contribuinte e assinado digitalmente com o
certificado digital do emissor dos documentos contidos no arquivo;
A adoo do mesmo critrio de formao de lotes para formar a Declarao Prvia de Emisso em
Contingncia recomendada para facilitar a posterior transmisso da NF-e.
O contribuinte deve manter um rgido controle de transmisso das NF-e emitidas no Sistema de
Contingncia Eletrnica, para evitar que venha a ser penalizado pela no transmisso das NF-e
emitidas em contingncia.
b) Informaes de controle
A informao da verso do leiaute dos dados ser informada no elemento sceCabecMsg do SOAP
Header (para maiores detalhes vide item 3.4).
https://hom.nfe.fazenda.gov.br/SCERecepcaoRFB/SCERecepcaoRFB.asmx
https://www.nfe.fazenda.gov.br/SCERecepcaoRFB/SCERecepcaoRFB.asmx
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 do Ambiente Nacional.
A mensagem ser descartada se o tamanho exceder o limite previsto (50 KB). A aplicao do
Emissor no poder permitir a gerao de mensagem com tamanho superior a 50 KB. Caso isto
ocorra, a conexo poder ser interrompida sem retorno da mensagem de erro se o controle do
tamanho da mensagem for implementado por configuraes do ambiente de rede do Sistema de
Contingncia Eletrnica (ex.: controle no firewall). No caso do controle de tamanho ser implementado
por aplicativo teremos a devoluo da mensagem de erro 214.
Pg. 214 / 232
Nota Fiscal Eletrnica
Manual de Integrao - Contribuinte
Caso o Web Service fique 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.
A validao de forma da rea de dados da mensagem realizada com a aplicao da seguinte regra:
E02 Validade do Certificado (data incio e data fim) Obrig. 291 Rej.
E03 Falta a extenso de CNPJ no Certificado (OtherName - Obrig. 292 Rej.
OID=2.16.76.1.3.3)
E04 Verifica Cadeia de Certificao: Obrig. 293 Rej.
- 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: Obrig. 296 Rej.
- Falta o endereo da LCR (CRLDistributionPoint)
- Erro no acesso a LCR ou LCR inexistente
E06 Certificado de Assinatura revogado Obrig. 294 Rej.
E07 Certificado Raiz difere da ICP-Brasil Obrig. 295 Rej.
F04 CNPJ do Certificado Digital difere do CNPJ da Matriz e do CNPJ do Emitente Facult. 244 Rej.
Rejeio a DPEC ser descartada, com retorno do cdigo do status do motivo da rejeio -
o motivo da rejeio poder ser de forma (validaes dos blocos A, B, C, D, E, F e G01 a
G06) ou violao das regras de negcios dos resumos da NF-e (validaes G07 a G13);
Recebido pelo Sistema de Contingncia Eletrnica a DPEC ser armazenada no
repositrio do Sistema de Contingncia Eletrnica (cStat=124);
9 9 9 9 9 9 9 9 9 9 9 9 9 9 9
Tipo de ano seqencial de 12 posies
Autorizador
Importante ressaltar que o servio de consulta das DPEC poder ser feito pelo nmero de Registro
da DPEC ou pela chave de acesso das NF-e vinculadas DPEC.
O Servio de Consulta de DPEC o servio oferecido pelo Sistema de Contingncia Eletrnica que permite a consulta das
DPEC existentes no Sistema de Contingncia Eletrnica.
A DPEC poder ser consultada pelo um nmero de Registro de DPEC (nRegDPEC) ou pela chave de Acesso da NF-e.
Retorno (DPEC)
Processo: sncrono.
Este servio pode ser consumido por qualquer UF que desejar acessar as DPEC existentes no
Sistema de Contingncia Eletrnico e pelo emissor de NF-e que gerou a DPEC.
A aplicao cliente do WS deve gerar uma mensagem informando o nmero de registro da DPEC ou
a chave de acesso da NF-e.
b) Informaes de controle
A verso do leiaute dos dados ser informada no elemento nfeCabecMsg do SOAP Header (para
maiores detalhes vide item 3.4).
O pedido de consulta ser transmitido atravs de requisio SOAP, com autenticao mtua, sendo
necessrio que o CNPJ utilizado na transmisso pela SEFAZ interessada esteja previamente
cadastrada no Sistema de Contingncia Eletrnica caso o CNPJ seja divergente do emissor da
DPEC.
https://hom.nfe.fazenda.gov.br/SCEConsultaRFB/SCEConsultaRFB.asmx
https://www.nfe.fazenda.gov.br/SCEConsultaRFB/SCEConsultaRFB.asmx
O WS do Ambiente Nacional acionado pelo interessado na consulta que deve enviar uma consulta
DPEC por Nmero de Registro da DPEC ou chave de acesso da NF-e que atenda os padres
estabelecidos neste manual.
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 do Ambiente Nacional.
A mensagem ser descartada se o tamanho exceder o limite previsto (10 KB). A aplicao da
Secretaria de Fazenda no poder permitir a gerao de mensagem com tamanho superior a 10 KB.
Caso isto ocorra, a conexo poder ser interrompida sem retorno da mensagem de erro se o controle
do tamanho da mensagem for implementado por configuraes do ambiente de rede do Ambiente
Nacional (ex.: controle no firewall). No caso do controle de tamanho ser implementado por aplicativo
teremos a devoluo da mensagem de erro 214.
Caso o Web Service fique 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.
A aplicao deve localizar a DPEC pela chave de acesso da NF-e ou pelo nmero de registro da
DPEC.
Aps a localizao da DPEC, verificar se o CNPJ do solicitante tem o mesmo CNPJ do emissor da
DPEC, em caso negativo, verificar se o CNPJ pertence a um rgo conveniado (vide Anexo I -
Tabela de rgos conveniados).
Grupo Aplicao
A Validao do Certificado Digital utilizada no protocolo SSL geral
B Validao da Mensagem geral
C Validao das informaes de controle da chamada ao Web geral
Service
D Validao da rea de dados da Mensagem XML geral
E Validao do Certificado Digital utilizada na Assinatura Digital geral
F Validao da Assinatura Digital geral
G Validao do Lote de DF-e especfica
H Validao do Pedido de Distribuio de DF-e especfica
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.
O envio de DPEC por pgina WEB ser viabilizado com o oferecimento de uma pgina WEB que
permitir realizar o envio da DPEC elaborado nos padres descritos neste manual.
A aplicao deve permitir a indicao de um dispositivo para leitura do arquivo DPEC e realizar o
envio deste arquivo para o Web Service de recepo de DPEC, mostrando a mensagem de resultado
do processamento da DPEC.
O resultado do processamento ser apresentado na tela e haver uma opo para gravar o resultado
do processamento no padro XML definido no projeto no dispositivo de gravao que o usurio
indicar.
No ser necessrio realizar a autenticao do usurio, pois a autoria do documento ser verificada
pela assinatura digital da DPEC, sendo requerido apenas o uso de Cdigo de Verificao (CAPCHA )
para restringir a consulta por robs.
https://hom.nfe.fazenda.gov.br/PORTAL/DPEC/UploadDPEC.aspx
https://www.nfe.fazenda.gov.br/portal/DPEC/UploadDPEC.aspx
O controle de acesso consulta de DPEC por pgina WEB ser realizado atravs da exigncia do
certificado digital do usurio. A verificao da legitimidade da consulta ser realizada atravs da
comparao do CNPJ base do certificado digital utilizado com o CNPJ base do emissor da DPEC
consultado.
A consulta poder ser realizada por nmero de registro da DPEC ou pela chave de acesso da NF-e.
No caso de consulta por chave de acesso da NF-e, a aplicao WEB dever verificar se o CNPJ
base da chave de acesso da NF-e consultada e o CNPJ base do titular do certificado digital utilizado
na autenticao do usurio so iguais.
https://hom.nfe.fazenda.gov.br/PORTAL/DPEC/ConsultaDPEC.aspx
https://www.nfe.fazenda.gov.br/portal/DPEC/ConsultaDPEC.aspx