Voltar para releases
Hotsitehotsite-v2ReleaseImpacto medio

Leitura de QR Code NFC-e agora identifica estado automaticamente

A leitura de QR Code de notas fiscais não depende mais da seleção manual do estado pelo participante.

Data
03 de nov. de 2026
Origem
hotsite-v2
PR
#91
Commit
ab5674b7

Resumo

A partir desta atualização, o participante não precisa mais selecionar o estado (UF) manualmente antes de ler o QR Code da nota fiscal. O sistema agora identifica o estado automaticamente a partir do próprio cupom lido.

O que mudou?

  • Fim da seleção manual de UF: O campo de estado na etapa inicial do cadastro de nota foi removido para campanhas que utilizam leitura de QR Code.
  • Identificação automática: O sistema extrai a UF diretamente da chave de acesso ou do domínio da Sefaz contido no QR Code.
  • Validação inteligente:
  • Se o QR Code for de um estado que a Premify ainda não atende, o sistema avisa o participante e oferece o preenchimento manual.
  • - Se o QR Code for inválido ou apresentar dados inconsistentes (ex: chave de um estado em domínio de outro), o sistema bloqueia a leitura e orienta o preenchimento manual.
  • Fluxo simplificado: O botão "Ler QR Code" aparece diretamente na tela de cadastro, desde que a campanha tenha o recurso habilitado e o serviço de NFC-e esteja operacional.

Impacto para o time

  • Suporte e CS: O fluxo de atendimento para dúvidas sobre "onde selecionar o estado" deixa de existir. Se o participante relatar que o botão de leitura não aparece, verifique se a campanha está com a flag qrcode_nota ativa no painel e se o serviço de NFC-e está saudável.
  • Comercial: Campanhas que utilizam QR Code agora possuem uma fricção menor no cadastro, pois o participante pula uma etapa de seleção.

Como explicar ao cliente?

Não é necessário realizar nenhuma alteração nas configurações das campanhas vigentes. O comportamento de "Validar estado" (se a nota deve ser do mesmo estado de residência do participante) continua funcionando normalmente, mas agora o sistema preenche esse campo automaticamente após a leitura do QR Code, sem exigir que o participante o faça manualmente.

Pontos de atencao

  • O recurso de leitura de QR Code continua sendo BETA.
  • Se o participante tentar ler um cupom de um estado não suportado, ele receberá uma mensagem clara e poderá seguir com o cadastro manual.
  • O botão de leitura só aparecerá se o serviço de NFC-e estiver ativo e configurado para pelo menos um estado.

Quando escalar?

  • Se o botão de leitura não aparecer mesmo com a flag qrcode_nota ligada no painel.
  • Se o sistema recusar cupons de estados que deveriam estar sendo aceitos (verificar se a UF consta na lista de estados suportados do serviço).
  • Se houver erro persistente na leitura de QR Codes válidos (validar com o time de desenvolvimento).

Origem da alteracao

  • Repositorio: Premify-Gelt/HotsitePremify-V2
  • PR: 91
  • Commit: ab5674b716d303733c63d554adc7255f04dbe954