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_notaativa 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_notaligada 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