QR Code da NFC-e

Para que serve o QR Code da NFC-e?

O QR Code da NFC-e serve para que qualquer pessoa confira, de forma rápida, se a nota fiscal recebida em uma compra no varejo foi de fato registrada na Secretaria da Fazenda (SEFAZ). Basta apontar a câmera do celular para o código impresso no cupom e abrir o link: a consulta mostra os dados da nota no portal oficial do estado.

Para o consumidor, é uma forma de confirmar que a compra foi documentada. Para o fisco, é um mecanismo de controle que incentiva a emissão correta. Para a loja, é um item obrigatório do DANFCE, sem o qual o documento impresso fica incompleto.

Como o QR Code da NFC-e é gerado?

O conteúdo do QR Code é uma URL de consulta da SEFAZ do estado do emitente, acompanhada de parâmetros como a chave de acesso da nota, a versão do QR Code, o ambiente (produção ou homologação) e o identificador do CSC. No final, entra um hash, uma espécie de assinatura calculada a partir desses dados e do CSC, o Código de Segurança do Contribuinte.

O CSC é um código secreto que a empresa obtém junto à SEFAZ. Como só o emitente e a SEFAZ conhecem esse código, o hash permite verificar que o QR Code foi criado por quem tinha autorização, dificultando falsificações.

Na emissão em contingência offline, quando a nota é emitida sem comunicação imediata com a SEFAZ, o QR Code costuma incluir informações adicionais, como data, valor total e um resumo da assinatura digital do XML, já que a nota ainda não foi autorizada no momento da impressão.

Onde o QR Code aparece no XML e no DANFCE?

No arquivo XML da NFC-e, o conteúdo do QR Code fica em um grupo de informações suplementares (infNFeSupl), junto com o endereço para consulta pela chave de acesso. Isso significa que o QR Code não é só uma imagem: ele é um dado que faz parte do documento fiscal.

No DANFCE, o código aparece impresso, normalmente perto da chave de acesso e do protocolo de autorização. O sistema que imprime o cupom lê o conteúdo do XML e converte em imagem.

Como funciona o QR Code da NFC-e em uma emissão por API?

Em uma emissão fiscal por API, o sistema de vendas envia os dados da compra e a plataforma emissora monta o XML, calcula o hash com o CSC cadastrado, assina o documento e o envia para autorização. Ao final, devolve o XML autorizado e o PDF do DANFCE já com o QR Code pronto para impressão.

Assim, o ERP ou o PDV não precisa implementar o cálculo do hash nem acompanhar as regras específicas de cada estado. Basta manter o CSC e o certificado digital da empresa corretamente configurados.

Qual a diferença entre o QR Code da NFC-e e a chave de acesso?

A chave de acesso é a sequência de 44 dígitos que identifica unicamente a nota fiscal. O QR Code contém essa chave, mas vai além: inclui o endereço de consulta e o hash de segurança. Na prática, a chave identifica a nota e o QR Code facilita e protege a consulta feita pelo consumidor.

Exemplos de QR Code da NFC-e

• Um cliente compra em uma farmácia, recebe o DANFCE, lê o QR Code com o celular e confirma no portal da SEFAZ que os itens e o valor batem com o que pagou.
• Um PDV integrado por API envia a venda, recebe de volta o PDF do DANFCE com o QR Code e imprime o cupom na impressora térmica do caixa.
• Uma loja tem NFC-e rejeitadas porque o CSC cadastrado no emissor expirou ou foi revogado; após atualizar o código, as novas notas voltam a ser autorizadas com QR Code válido.
• Em contingência offline, um supermercado imprime o DANFCE com QR Code contendo os dados adicionais exigidos e transmite as notas à SEFAZ quando a conexão volta.