QR Code Versão 3 para NFC-e

A Nota Técnica 2025.001, traz uma mudança significativa nas emissões de NFCe ao implementar a versão 3 do QR Code. A seguir detalhamos as alterações constantes nesta NT.

O que a Nota Técnica 2025.001 traz de novidades?

Em resumo, a NT 2025.001 estabelece um novo layout e novas regras para a geração do QR Code presente no Documento Auxiliar da NFC-e (DANFE NFC-e). Com o objetivo de aumentar a segurança, simplificar processos e modernizar a tecnologia fiscal.

As 2 grandes mudanças são:

1. Descontinuação do CSC (Código de Segurança do Contribuinte)

Essa é, sem dúvida, a mudança de maior impacto para os gestores. Até hoje, para gerar o QR Code de uma NFC-e, era obrigatório o uso do CSC, um código alfanumérico fornecido pela SEFAZ de cada estado. Ele funcionava como uma “senha” para autenticar o emissor, a partir de agora, o CSC não será mais utilizado.

2. QR Code com Assinatura Digital – para Contingência

Com a remoção do CSC, a segurança agora passa a ser garantida por uma assinatura digital gerada a partir do certificado digital da empresa. Essa assinatura “carimba” digitalmente as informações da NFC-e no momento da sua geração. Quando um consumidor escaneia o código com seu celular, o aplicativo da SEFAZ pode verificar essa assinatura e confirmar instantaneamente a autenticidade e a integridade do documento.

Prazos de adequação conforme a NT

● Ambiente de Homologação (Testes): Já disponível desde 02 de junho de 2025.
● Ambiente de Produção (Obrigatório): A partir de 01 de setembro de 2025.
Isso significa que, a partir de setembro de 2025, todos os sistemas emissores de NFC-e deverão estar gerando o novo QR Code v3. Caso contrário, suas notas poderão ser rejeitadas.

O que a Sua Empresa Precisa Fazer?

Para os clientes que geram a URL do QR Code em seus sistemas e enviam para o InvoiCy em cada documento, será preciso rever o processo de geração do link internamente para estar em conformidade com a NT.
Para os clientes que não enviam essa informação nos documentos, o InvoiCy fará a geração automática do QR Code já com a versão 3 (no ambiente de homologação) para atender a todas as exigências da Nota Técnica 2025.001.

Geração da URL do QR Code da NFC-e na Versão 3

A seguir, detalhamos como gerar a URL do QR Code na versão 3, tanto para emissão em modo normal quanto em contingência, de acordo com as diretrizes da nova nota técnica.

Emissão Normal (Online)

Na emissão online, ou seja, com comunicação em tempo real com os servidores da Sefaz, a estrutura da URL do QR Code na versão 3 foi significativamente simplificada. A principal mudança é a remoção do hash gerado a partir do CSC.

Estrutura da URL para Emissão Normal:
https://<URL_DA_SEFAZ>?p=<chave_acesso>|<versao_qr_code>|<tipo_ambiente>

Detalhamento dos Parâmetros:
● https://<URL_DA_SEFAZ>: Endereço eletrônico de consulta da NFC-e via QR Code,
específico de cada Unidade Federativa. Este endereço é disponibilizado pela Sefaz de
origem do emissor.
● p=: Parâmetro fixo que precede os dados da NFC-e.
● <chave_acesso>: A chave de acesso da NFC-e, composta por 44 dígitos.
● <versao_qr_code>: A versão do leiaute do QR Code, que neste caso será sempre “3”.
● <tipo_ambiente>: Identifica o ambiente de processamento da NFC-e:
● 1: Produção (documento com validade jurídica).
● 2: Homologação (ambiente de testes).

Exemplo de URL para Emissão Normal:
https://nfce.fazenda.sp.gov.br/qrcode?p=35250712345678000191650010000000011234567890|3|1

Emissão em Contingência (Offline)

A grande inovação da versão 3 do QR Code reside na emissão em contingência offline (tpEmis=9). Nesta modalidade, a autenticidade do documento impresso é garantida por uma assinatura digital dos parâmetros do próprio QR Code, eliminando a necessidade de utilização do CSC.

Estrutura da URL para Emissão em Contingência:
https://<URL_DA_SEFAZ>?p=<chave_acesso>|<versao_qr_code>|<tipo_ambiente>|<dia_emissao>|<valor_total>|<digest_value>|<identificador_destinatario>|<assinatura_qr_code>

Detalhamento dos Parâmetros:
● https://<URL_DA_SEFAZ>, p=, <chave_acesso>, <versao_qr_code> e
<tipo_ambiente>: Seguem a mesma lógica da emissão normal.
● <dia_emissao>: Dia da data de emissão da NFC-e (formato “dd”).
● <valor_total>: Valor total da NFC-e.
● <digest_value>: O Digest Value da NFC-e, que é o resumo criptográfico do corpo do XML do documento (tag <DigestValue> do grupo <Signature>).
● <identificador_destinatario>: O CPF ou CNPJ do destinatário, caso seja informado na NFC-e. Se não houver identificação do destinatário, este campo não deve ser incluído.
● <assinatura_qr_code>: A assinatura digital dos parâmetros do QR Code. Para gerá-la, deve-se concatenar todos os campos anteriores (da chave de acesso até o identificador do destinatário, quando houver), separados pelo caractere |, e assinar o resultado com o certificado digital do emissor.

Processo para Geração da Assinatura do QR Code em Contingência: Concatenar os campos: Junte, na ordem especificada, os valores dos seguintes campos, utilizando | como separador:
● Chave de Acesso
● Versão do QR Code (“3”)
● Tipo de Ambiente
● Dia da Emissão
● Valor Total da NFC-e
● Digest Value da NFC-e
● Identificador do Destinatário (se houver)

Assinar a string: Utilize o certificado digital do emitente (o mesmo usado para assinar
a NFC-e) para assinar a string resultante do passo anterior.

Incluir na URL: O resultado da assinatura deve ser adicionado como o último
parâmetro da URL.

Exemplo de URL para Emissão em Contingência:
https://nfce.fazenda.sp.gov.br/qrcodep=35250712345678000191650010000000021234567890|3|1|09|150.75|a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0|12345678901|<assinatura_digital_dos_parametros>

Orientamos os Parceiros da Migrate a revisarem seus sistemas para garantir que a emissão de documentos NFCe continue operacional. Para isso, o InvoiCy está atualizado, permitindo os devidos testes no ambiente de Homologação.

Concatenar os campos: Junte, na ordem especificada, os valores dos seguintes campos, utilizando | como separador:
● Chave de Acesso
● Versão do QR Code (“3”)
● Tipo de Ambiente
● Dia da Emissão
● Valor Total da NFC-e
● Digest Value da NFC-e
● Identificador do Destinatário (se houver)

Assinar a string: Utilize o certificado digital do emitente (o mesmo usado para assinar a NFC-e) para assinar a string resultante do passo anterior.