Entendendo a

consulta NFC-e
Informaes para o desenvolvedor do aplicativo

9 de maro de 2015

INFORMAES INICIAIS

Para que qualquer um que detenha a informao da chave de acesso possa verificar a validade e
autenticidade da NFC-e, a SEFAZ disponibilizou o servio de consulta pblica da NFC-e, que pode
ser efetuada de duas formas: pela digitao, em pgina web, dos 44 caracteres numricos da chave
de acesso, constantes impressos no DANFE NFC-e ou por consulta via leitura do QR Code impresso
ou disponibilizado em meio eletrnico, utilizando aplicativos gratuitos de leitura de QR Code
disponveis para dispositivos mveis como smartphones e tablets.
O DANFE NFC-e quando impresso pelo contribuinte deve atender as orientaes definidas no
Manual de Especificaes Tcnicas do DANFE NFC-e e QR Code (ltima verso), disponvel no
Portal Nacional da NF-e (www.nfe.fazenda.gov.br)
A consulta bem sucedida da NFC-e poder retornar:

NFC-e autorizada de uso;

NFC-e cancelada;
NFC-e denegada de uso.

CONSULTA VIA DIGITAO DE CHAVE DE ACESSO

A consulta via digitao da chave de acesso deve ser realizada, pela internet, no seguinte endereo
de consulta pblica da NFC-e, que deve constar impresso no DANFE NFC-e emitido pelo
contribuinte:
http://nfce.fazenda.rj.gov.br/consultaChave

Entendendo a consulta NFC-e

CONSULTA VIA QR CODE

A aplicao de consulta via QR Code efetuar validaes

dos contedos de informao constantes do QR Code
versus o contedo da respectiva NFC-e, bem como
validao do hash do QR Code.
Em caso de erros ou falhas na recuperao da NFC-e, o
sistema apresentar as mensagens em duas reas: (1)
mensagem resumida para o consumidor final na cor
vermelha, e (2) lista de informaes de interesse do
contribuinte e do fisco. Para visualizar essa lista, deve-se
clicar no link de mesmo nome, e o sistema listar todos os
erros relacionados aos parmetros da URL informada, bem
como os valores dos parmetros, indicando em vermelho os
incorretos.
A URL do Rio de Janeiro para a consulta da NFC-e via QR
Code deve ser formada por:
1. URL inicial: http://www4.fazenda.rj.gov.br/consultaNFCe/QRCode?
2. Lista de parmetros na ordem indicada a seguir:

PARMETRO

DESCRIO DO
PARMETRO

VALOR

BYTES

chNFe

Chave de Acesso da
NFC-e

Sequncia de 44 algarismos sem

separadores.

44*

nVersao

Verso do QR Code

100

3*

tpAmb

Identificao do
Ambiente

(1 Produo, 2 Homologao)

1*

cDest

Documento de
Identificao do
Consumidor
(CNPJ/CPF/ID
Estrangeiro)

Na hiptese do consumidor no se
identificar na NFC-e, no existir o
parmetro cDest no QR Code e
tambm no dever ser includo o
parmetro cDest na sequncia sobre
a qual ser aplicado o hash do QR
Code.

11 20

dhEmi

Data e Hora de
Emisso da NFC-e

O valor dever corresponder

converso para hexadecimal em
caixa baixa do valor no padro UTC
com mscara.

50

vNF

Valor Total da NFC-e

15

vICMS

Valor Total ICMS na

NFC-e

15

digVal

Cdigo do XML
(DigestValue da
NFC-e)

Quando se tratar de um NFC-e

normal (tpEmis = 1): O valor dever
corresponder a converso para
hexadecimal do valor constante para
este campo do arquivo xml da
respectiva NFC-e.

56*

J para o caso da emisso em

contingncia off-line (tpEmis=9): O

Entendendo a consulta NFC-e

valor dever corresponder ao

algoritmo SHA1 sobre o arquivo XML
da NFCe. Ao se efetuar a assinatura
digital da NFCe emitida em
contingncia off-line, o campo
digestvalue constante da
XMlSignature deve obrigatoriamente
ser idntico ao encontrado quando
da gerao do digestvalue para a
montagem QR Code.
9

10

cIdToken

cHashQRCode

Identificador do CSC

Identificador do CSC

6*

Cdigo Hash dos

Parmetros

O valor dever corresponder a

aplicao do algoritmo SHA-1 sobre
a concatenao dos parmetros da
URL 1 a 9 (incluir nome do
parmetro e valor) + CSC
correspondente ao identificador
(cIdToken) informado.Se cDest no
for informado, omitir o nome do
parmetro da URL. Em seguida, o
resultado obtido deve ser convertido
para hexadecimal em caixa alta.

40*

* O asterisco (*) na tabela acima indica que o preenchimento deve ser exato com a quantidade de
bytes indicada.
O sistema da SEFAZ validar todos os parmetros da URL e retornar mensagens, conforme
descrito nas sees abaixo.

CSC - Cdigo de Segurana do Contribuinte

O Cdigo de Segurana do ontri uinte - S (token) um cdigo alfanumrico, de conhecimento
exclusivo do contribuinte e da SEFAZ, usado para garantir a autoria e a autenticidade do DANFENFC-e. Ele requisito de va idade do D
-NFC-e, portanto deve ser cadastrado no programa
emissor do contribuinte antes da primeira nota fiscal emitida.
Os cdigos so nicos para a empresa, ou seja, eles no gerados por estabelecimento da empresa.
O CSC fornecido ao contribuinte no momento do deferimento do pedido de acesso aos ambientes
de testes e/ou produo.

Entendendo a consulta NFC-e

Impresso do QR Code no DANFE NFC-e

dimenso m nima para a imagem do

ode ser
mm
5mm, tendo em vista ter sido essa a
menor dimenso em que foi possvel efetuar a leitura por meio de dispositivos mveis que no
possuem zoom (aproximao de imagem).
O QR Code dever ser impresso no DANFE da Nota Fiscal do Consumidor Eletrnica (NFC-e) com
os padr es residentes das impressoras de no impacto (t rmica aser ou desk et) e seguir o padro
internacional ISO/IEC18004.

Padro da imagem do QRCode Fonte: Wikipedia

Para mais informaes, consulte o Manual de Padres Tcnicos do DANFE-NFC-e e QR Code

(ltima verso).

Entendendo a consulta NFC-e

VALIDAO DOS PARMETROS DA URL DO QR CODE

PARMETRO

SITUAO

MENSAGENS

REA

chNFe

Chave de acesso no foi

informada ou nmero de
caracteres diferente de
44.

chNFe

Dgito verificador (DV) da

Chave de acesso
incorreto.

chNFe

Cdigo da UF do
emitente do Documento
Fiscal no do cdigo
do RJ = 33 (posio 1-2
da chave de acesso)

A chave de acesso informada no se

refere a uma NFC-e emitida por
contribuinte do estado do RJ.

chNFe

Cdigo do Modelo do
Documento Fiscal (mod)
diferente de 65=NFC-e
(posio 21-22 da chave
de acesso)

A chave de acesso informada no de

uma NFC-e (modelo 65). Verifique o
modelo do seu documento fiscal
eletrnico (DF-e).

nVersao

O parmetro no foi
informado ou tamanho
diferente de 3
caracteres.

A verso do QR Code (nVersao) deve ter

3 caracteres.

tpAmb

Se o parmetro no for
"1 = Produo" e nem "2
= Homologao e
Testes": sistema define
ambiente = 1.

cDest

Se parmetro informado
e apresentar tamanho
menor que 11 ou maior
que 20.

Documento de Identificao do
Consumidor (cDest) informado est
incorreto.

dhEmi

Data e hora de emisso

no foi informada.

Data e hora de emisso (dhEmi) no

informada.

dhEmi

Data e hora de emisso

foi informada e tamanho
menor que 50 bytes.

Data e hora de emisso (dhEmi) invlida.

O tamanho deve ser menor ou igual a 50
bytes.

dhEmi

A data de emisso foi

informada e no uma
data/hora vlida.

Data e hora de emisso (dhEmi) invlida.

vNF

O parmetro v no
foi informado ou
tamanho maior que 16
bytes.

Valor total da NFC-e (vNF) no

informado ou tamanho invlido (maior
que 16 bytes).

dhEmi

O parmetro no
numrico.

Valor total da NFC-e (vNF) deve ser um

nmero.

Chave de acesso invlida. Ela deve

conter 44 dgitos.

Chave de acesso invlida.

Entendendo a consulta NFC-e

vICMS

O parmetro no foi
informado ou tamanho
maior que 16 bytes.

Valor total do ICMS (vICMS) no

informado ou tamanho invlido (maior
que 16 bytes).

cICMS

O parmetro no
numrico.

Valor total do ICMS (vICMS) deve ser um

nmero.

digVAL

O parmetro no foi
informado ou tamanho
diferente de 56
caracteres.

O cdigo do XML (digVal) deve ter 56

caracteres.

cIdToken

O parmetro cIdToken
no foi informado ou
tamanho diferente de 6
caracteres.

O identificador do CSC (cIdToken) deve

ter 6 caraceres.

cHashQRCode

O parmetro no foi
informado ou tamanho
diferente de 40
caracteres.

O Cdigo do Hash do QR Code

(cHashQRCode) deve ter 40 caracteres.

cHashQRCode

Se houver erro na
recuperao do CSC na
base de dados da
SEFAZ-RJ.

No foi possvel recuperar o CSC para

validao do Cdigo do Hash do QR
Code. Por favor, tente novamente mais
tarde.

cHashQRCode

No recuperou o CSC
para o cIdToken e tpAmb
informados.

No h CSC cadastrado para o

identificador (cldToken) e o Ambiente
(tpAmb) informados.

cHashQRCode

O CSC correspondente
ao cIdToken e tpAmb
informados est expirado
(data de fim do CSC
menor que a data de
emisso da NFC-e).

CSC expirado em DD/MM/AAAA

cHashQRCode

O CSC correspondente
ao cIdToken ainda no
est ativo (data incio do
CSC maior que a data
de emisso da NFC-e).

CSC ainda no est ativo. Data de incio:

DD/MM/AAAA

cHashQRCode

Cdigo do Hash do QR
Code informado no foi
gerado corretamente
para os parmetros da
URL informada.

Cdigo do Hash do QR Code invlido.

Entendendo a consulta NFC-e

OUTRAS SITUAES: NFC-E NO RECUPERADA

SITUAO

MENSAGENS PARA O CONSUMIDOR

(REA 1)

NFC-e no encontrada e tipo de emisso*

normal (valor = 1)

NFC-e no encontrada.

NFC-e no encontrada e tipo de emisso*

Contingncia FS-DA, com impresso do
DANFE em formulrio de segurana (valor = 5)

NFC-e no encontrada. Documento emitido em

contingncia na modalidade formulrio de
segurana. O contribuinte tem at 168 horas da
data da emisso para transmiti-lo.

NFC-e no encontrada e tipo de emisso*

Contingncia off-line da NFC-e (valor= 9)

NFC-e no encontrada. Documento emitido em

contingncia na modalidade offline. O
contribuinte tem at 24 horas da data da
emisso para transmiti-lo.

NFC-e no encontrada e tipo de emisso*

diferente de 1,5 e 9.

NFC-e inexistente.

Chave de acesso difere da cadastrada (h

outra NFC-e com o mesmo cdigo de UF,
CNPJ e Srie/Nmero de Documento Fiscal)

NFC-e no encontrada.

Ambiente informado diverge do ambiente de

recebimento da NFC-e.

NFC-e no encontrada.

Emissor no habilitado para emisso de NFC-e.

Emitente no autorizado pelo fisco.

Servio de consulta indisponvel

Servio indisponvel. Por favor, tente

novamente mais tarde.

Falha na recuperao da NFC-e (XML no

disponvel).

NFC-e existente, porm no foi possvel

recuper-la. Por favor, tente novamente mais
tarde.

Erros gerais na consulta

No foi possvel recuperar a NFC-e. Por favor,

tente novamente mais tarde.

* O Tipo de emisso corresponde posio 35 da Chave de acesso informada.

Entendendo a consulta NFC-e

CONTROLE DE VERSES

Data

Alteraes

09/03/2015

1 Publicao

Entendendo a consulta NFC-e

SEFAZ/RJ
Grupo Gestor da NFC-e