Leitura do QR Code do Cupom Fiscal

É um recurso em versão BETA do "Cadastrar Compra": o participante aponta a câmera para o QR Code do cupom fiscal (NFC-e) e o site preenche parte dos dados da nota. É comodidade, não antifraude: a nota chega à API como qualquer outra, e tanto a leitura do cupom quanto a identificação dos produtos podem errar.

Quando aparece. O botão "Ler QR Code", com a etiqueta BETA, só aparece quando:

• a campanha ligou "Leitura de QR Code do cupom fiscal" no painel (vem desligada em toda campanha);
• a campanha também valida o estado da nota ("Validar estado"), porque a leitura depende da UF do cupom;
• o estado escolhido é atendido pelo serviço de consulta. Hoje são 20 estados: AL, AM, AP, BA, CE, DF, ES, GO, MG, MS, MT, PE, PR, RJ, RO, RS, SC, SE, SP e TO;
• o participante está logado naquela campanha.

Passo a passo.

1. Etapa 1 de 3, "Estado da nota": o participante escolhe a UF de emissão. O site verifica se a leitura existe para aquele estado.
2. Ele escolhe "Ler QR Code" ou "Preencher manualmente". Na leitura, o navegador pede permissão para usar a câmera.
3. Lido o código, o site consulta a nota e preenche estado, chave, CNPJ ou loja, número e data. Aparece o aviso "Leitura automática em versão BETA: confira os dados antes de enviar."
4. Se a campanha tem produtos participantes, o site tenta identificá-los nos itens do cupom e preenche os que reconheceu com segurança. Quando sobra dúvida, aparece "Verifique se todos os produtos participantes da promoção foram adicionados corretamente...".
5. O participante revisa, ajusta o que for preciso e envia normalmente.

O link da consulta lido no QR Code é enviado junto com a nota e substitui a foto: o anexo vira opcional.

Mensagens possíveis:

• "A leitura automática ainda não está disponível para UF. Continue preenchendo manualmente."
• "Este QR Code não é de uma nota fiscal válida. Preencha os dados manualmente."
• "Não foi possível ler os dados da nota. Preencha os dados manualmente."
• "O CNPJ da nota não está cadastrado nas lojas da campanha. Selecione a loja manualmente."
• "A identificação automática dos produtos está indisponível. Adicione os produtos participantes manualmente."
• "Muitas leituras em pouco tempo. Tente novamente em instantes."
• "Entre na campanha para usar a leitura do QR Code."
• Câmera: permissão negada, aparelho sem câmera, câmera que não iniciou ou navegador sem acesso. Todas oferecem o preenchimento manual.

A leitura do QR Code é um atalho opcional, em versão BETA, ligado por campanha no painel. Ela economiza digitação, mas não valida a nota: as regras continuam sendo da API. Para funcionar, a campanha precisa também validar o estado da nota, e o estado do cupom precisa estar entre os atendidos. O participante sempre pode preencher à mão, e o cadastro nunca depende da câmera.

• Falha: o botão "Ler QR Code" não aparece.
• Possivel causa: recurso desligado na campanha, campanha sem "Validar estado" ligado ou estado do cupom fora dos 20 atendidos.
• Como orientar: oriente usar "Preencher manualmente". Para o cliente, confira as duas chaves no painel.
• Quando escalar: se as duas chaves estiverem ligadas e o estado for atendido e o botão não aparecer, abrir issue no Jira (projeto DEV).

• Falha: "Este QR Code não é de uma nota fiscal válida."
• Possivel causa: o código lido não é o QR Code da consulta da NFC-e (por exemplo um QR de pagamento ou de propaganda) ou o endereço do fisco daquele estado não é reconhecido.
• Como orientar: oriente ler o QR Code do rodapé do cupom ou preencher manualmente.
• Quando escalar: se acontecer com cupons legítimos de um mesmo estado, abrir issue no Jira (projeto DEV) informando a UF, sem enviar o link do cupom em canal aberto.

• Falha: "Não foi possível ler os dados da nota."
• Possivel causa: o serviço de consulta não respondeu, o cupom é muito recente ou o site do fisco está fora.
• Como orientar: oriente tentar de novo em alguns minutos ou preencher manualmente.
• Quando escalar: se falhar para todos os participantes por mais de uma hora, abrir issue no Jira (projeto DEV).

• Falha: produtos não foram preenchidos ou vieram incompletos.
• Possivel causa: a identificação só aplica o que reconhece com segurança, ou está indisponível.
• Como orientar: oriente adicionar os produtos que faltam em "Adicionar produto" antes de enviar.
• Quando escalar: não é falha quando o ajuste manual funciona.

• Falha: a câmera não abre.
• Possivel causa: permissão negada, aparelho sem câmera ou navegador sem suporte.
• Como orientar: oriente liberar a câmera nas configurações do navegador ou preencher manualmente.
• Quando escalar: não é falha do site.