Blog

QR Code versão 3 da NFC-e: a mudança silenciosa que aposenta o CSC

Nenhum cliente vai notar diferença no cupom. Mas por trás dele, uma exigência que atormentava emissores desde 2014 está sendo desativada.

This article has not been translated yet: the text below is in Portuguese.

O que ninguém vai perceber

Se você é lojista, o cupom que sai da sua impressora vai continuar exatamente igual. Mesmo tamanho, mesmo QR Code, mesma leitura pelo celular do cliente. Nada muda visualmente.

Mas dentro daquele quadradinho preto e branco, uma peça foi removida — e ela era a origem de uma boa parte das dores de cabeça de quem emite NFC-e no Brasil.

Essa peça se chama CSC.


O que era o CSC e por que ele existia

O Código de Segurança do Contribuinte existe desde 2014. É um token alfanumérico de até 36 caracteres, exclusivo por CNPJ e por ambiente, obtido no portal da SEFAZ.

Sua função era garantir que o QR Code impresso no cupom não pudesse ser falsificado. O sistema emissor pegava alguns dados da nota, concatenava o CSC — que só o contribuinte e o Fisco conheciam — e gerava um hash SHA-1. Esse hash ia dentro do QR Code. Quem tentasse forjar um cupom não conseguiria produzir um hash válido sem conhecer o segredo.

A ideia era boa. O problema era operacional.


Por que o CSC dava tanto trabalho

Comparação entre a rotina de gestão do CSC e o cenário sem ele

Para ter um CSC funcionando, a empresa precisava:

  • Estar credenciada como emissora de NFC-e e possuir certificado digital
  • Acessar o portal da Receita Estadual e gerar o código
  • Gerar dois códigos: um para produção, outro para homologação
  • Repetir tudo isso em cada UF onde opera
  • Manter no máximo dois códigos ativos por vez
  • Guardar o token com segurança — quem o obtém pode forjar cupons
  • Refazer o processo caso o código seja perdido, revogado ou comprometido

E quando algo saía do lugar, o sintoma era péssimo de diagnosticar: a nota simplesmente não autorizava, ou autorizava e o QR Code não validava, sem que a mensagem de erro apontasse claramente para o CSC.

Havia ainda um caso especialmente doloroso. Produtores rurais pessoa física frequentemente compartilham uma mesma Inscrição Estadual entre vários participantes — uma IE pode ter diversos CPFs vinculados. Gerenciar CSC nesse cenário era um pesadelo administrativo.


O que a versão 3 fez

A Nota Técnica 2025.001, publicada em março de 2025, criou o novo leiaute do QR Code da NFC-e. A mudança central é direta: o CSC sai de cena.

Comparação da estrutura do QR Code entre a versão 2 e a versão 3

Na emissão online, o QR Code versão 2 tinha cinco campos:

chave | 2 | tpAmb | cIdToken | cHashQRCode

Os dois últimos existiam exclusivamente por causa do CSC: o identificador do código e o hash calculado com ele.

Na versão 3, sobraram três:

chave | 3 | tpAmb

Chave de acesso, número da versão e identificação do ambiente. Só. Sem CSC, sem hash.

Na emissão em contingência — quando a loja está sem internet e emite offline — a autenticidade continua precisando ser garantida. Mas agora ela vem de uma assinatura digital aplicada a campos específicos do QR Code, usando o certificado digital que a empresa já possui e já usa para assinar a própria nota.

É a mesma proteção, com uma diferença fundamental: não há mais um segredo separado para solicitar, renovar e custodiar. O certificado já estava lá.


Um detalhe técnico que vale registrar

A assinatura digital no QR Code é exclusiva da contingência. Em emissão normal, ela não deve ser informada — e existe rejeição específica para quem errar isso.

Os códigos de rejeição criados ou ajustados pela NT são:

CódigoSituação
444NFC-e com QR Code versão 2 emitida por pessoa física
445Parâmetro de assinatura informado em emissão normal (não deveria)
474Parâmetro de assinatura ausente quando deveria estar presente
583Valor da assinatura difere do calculado
395Endereço do site da UF diverge do previsto
396Parâmetro obrigatório ausente no QR Code
397Divergência entre dados da nota e parâmetros do QR Code

Vale destacar uma mudança recente: a rejeição 407 foi eliminada. Ela disparava quando alguém usava a versão 3 numa UF que ainda não a suportava. A justificativa oficial para removê-la é reveladora — todas as unidades federativas passariam a adotar o leiaute v3, tornando a regra desnecessária.

Ou seja: a versão 3 deixou de ser uma possibilidade regional para virar o padrão nacional.


E o Paraná?

Aqui entra a exceção que interessa a quem opera no estado.

O Paraná manteve exigências próprias quanto ao CSC. A obrigatoriedade do QR Code v3 para produtores rurais pessoa física, prevista nacionalmente, traz explicitamente a ressalva do PR. Na prática, isso significa que o estado seguiu um caminho ligeiramente diferente do resto do país.

Há também uma armadilha bem conhecida de quem desenvolve para o PR: o portal público de consulta de QR Code da SEFA-PR não valida notas de homologação. Ele retorna erro de URL mal formatada mesmo quando a URL está perfeitamente correta.

Isso já custou dias de trabalho a muita gente — inclusive a nós. A conclusão prática, para quem estiver depurando: em ambiente de teste, a validação do QR Code termina na aceitação do schema e na autorização com cStat 100. O teste visual no portal é inconclusivo e deve ser ignorado.


Como está a obrigatoriedade hoje

Este é o ponto em que convém ser preciso, porque circula muita informação confusa.

PerfilSituação
Produtor rural pessoa físicaVersão 3 obrigatória — exceto no Paraná
Empresa com CNPJAdoção opcional, conforme a UF
Versão 2Continua válida; não há data oficial de desativação publicada

As datas de junho e setembro de 2025 que aparecem na Nota Técnica eram prazos para as SEFAZ suportarem o novo leiaute — não para o contribuinte adotá-lo. É uma distinção que confunde muita gente.

Dito isso, a direção é inequívoca. A eliminação da rejeição 407, sob a justificativa de que todas as UFs adotariam o v3, sinaliza que a migração completa é questão de tempo. E o Manual de Orientação ao Contribuinte deve ser republicado sem CSC em algum momento.

A leitura honesta: quem já migrou não está atrasado nem correndo risco — está adiantado, e já colhendo o benefício. Quem ainda não migrou não está em situação irregular, mas está mantendo uma rotina que vai desaparecer.


A Expert Informática já está aplicando

Nós já implementamos o QR Code versão 3 e estamos aplicando a atualização na base de clientes.

A decisão de arquitetura que tomamos vale ser explicada, porque ela responde a um problema recorrente: a versão do QR Code é configuração, não código.

No cadastro de unidades operacionais existe um parâmetro que define se aquela unidade emite com v2 ou v3. O sistema monta a URL conforme a escolha. Isso significa que:

  • A atualização foi entregue uma única vez, com os dois caminhos funcionando
  • Migrar uma unidade de v2 para v3 é mudar um parâmetro, não reinstalar sistema
  • Se uma UF exigir comportamento diferente, resolve-se na configuração
  • Se for preciso voltar atrás, volta-se em segundos

Mantivemos deliberadamente os campos de CSC no cadastro. Não os removemos, e não vamos remover tão cedo — a versão 2 segue válida, o Paraná tem regra própria, e apagar configuração que ainda pode ser necessária é o tipo de simplificação que cobra caro depois.

Para o cliente, o efeito é simples: nada muda na operação diária, o cupom continua idêntico, e uma tarefa administrativa some da lista.


O que isso significa para a sua empresa

  • Se você emite NFC-e em mais de um estado, o ganho é imediato — some a matriz de CSC por UF
  • Se você abriu ou vai abrir filial, deixa de existir a etapa de gerar CSC no portal daquele estado
  • Se você é produtor rural pessoa física, a migração provavelmente já é obrigatória para você
  • Se seu sistema emissor ainda não suporta v3, pergunte ao fornecedor qual é o plano
  • Se seu sistema suporta, mas a migração exige reinstalação em cada ponto de venda, isso é um sinal de arquitetura frágil — vale conversar

Conclusão

O QR Code versão 3 é o tipo de mudança que ninguém vai comemorar, porque não produz nada visível. O cupom é o mesmo. A venda é a mesma. O cliente não percebe.

O que ela faz é remover uma engrenagem que nunca deveria ter sido necessária: um segredo compartilhado, gerenciado manualmente em portal web, replicado por estado e por ambiente, cuja falha se manifestava como erro obscuro no meio de um dia de vendas.

A segurança não diminuiu — ela migrou para o certificado digital, que a empresa já tinha. Trocou-se uma exigência a mais por uma exigência que já existia.

Boas mudanças fiscais costumam ser assim: silenciosas, invisíveis para quem usa, e percebidas apenas pela ausência de um problema que antes aparecia.

  • fiscal
  • nfc-e

Blog