Cadastro e Acompanhamento de Notas Fiscais

É o fluxo em que o participante logado registra uma compra (nota fiscal ou comprovante) na tela "Cadastrar Compra" e depois acompanha o que ela gerou em "Minha participação". Os detalhes do formulário estão no artigo "Cadastro de nota fiscal no hotsite" e a leitura do QR Code no artigo "Leitura do QR Code do cupom fiscal".

1. O participante entra na campanha e abre "Cadastrar Compra". Sem login, o site leva para o login.
2. O formulário mostra os campos que a campanha configurou no painel (por exemplo número da nota, CNPJ, data, valor, loja, produtos e anexo).
3. Nas campanhas com a leitura do QR Code ligada, dá para preencher parte dos dados lendo o cupom. O preenchimento manual está sempre disponível.
4. Antes de enviar, o site mostra "Confirme os dados" para revisão.
5. A API aplica as regras da promoção e aceita ou recusa a nota na hora.

O resultado aparece em uma janela:

• "Participação registrada!": a compra gerou números da sorte, listados na janela.
• "Compra registrada!" com "o valor entrou no seu saldo": a compra não fechou uma chance sozinha, mas o valor ficou guardado no saldo da campanha.
• "Compra registrada!" com "ainda não gerou números": a compra foi aceita e não gerou chance desta vez.
• "Nota não cadastrada": a API recusou e a janela mostra o motivo, como veio da API (por exemplo nota já cadastrada, limite de notas atingido ou "Preencha: ...").

Não existe mais nota "em análise" no hotsite novo. A nota é aceita ou recusada no envio. Uma nota só fica inativa quando a operação a cancela no painel.

Depois, em Minha participação:

• Minhas notas lista as notas cadastradas. Nota cancelada aparece com "Esta nota foi cancelada e não gera números da sorte."
• Por nota mostra os números embaixo da nota que os gerou.
• Saldo, Meus pontos e Posições aparecem só quando a campanha tem esses recursos.

O cadastro de compra é feito pelo participante logado, com os campos definidos pelo cliente no painel. A decisão de aceitar a nota é da API, na hora, com as regras da campanha (período, duplicidade, limite de notas, produtos e lojas). A tela antecipa alguns erros (CNPJ e chave inválidos, campos obrigatórios) para o participante corrigir antes de enviar.

• Falha: a janela mostra "Nota não cadastrada" com uma mensagem.
• Possivel causa: a nota não atende a uma regra da campanha. A mensagem exibida é o motivo.
• Como orientar: leia a mensagem com o participante e oriente corrigir o dado ou explique a regra do regulamento.
• Quando escalar: se a nota cumprir o regulamento e a recusa continuar, abrir issue no Jira (projeto DEV) com o print, o CPF e os dados da nota.

• Falha: a compra foi registrada mas não gerou números.
• Possivel causa: o valor ou a quantidade não fechou uma chance pela regra da campanha. Em campanhas com saldo, o valor ficou guardado.
• Como orientar: oriente olhar a aba Saldo, quando existir, que mostra quanto falta para a próxima chance.
• Quando escalar: se a compra atingir o mínimo da regra e não gerar chance, abrir issue no Jira (projeto DEV) com CPF e número da nota.

• Falha: o participante diz que a nota está "em análise" há dias.
• Possivel causa: no hotsite novo não há análise de nota. Ou ela gerou o que tinha de gerar no envio, ou foi recusada, ou foi cancelada pela operação.
• Como orientar: confira em Minhas notas e no painel. Se o participante usa o hotsite legado, confirme o endereço.
• Quando escalar: se a nota não aparecer em lugar nenhum e o participante tiver o print do envio aceito, abrir issue no Jira (projeto DEV).

• Falha: aparece "Sessão expirada. Faça login novamente." ao enviar.
• Possivel causa: a sessão venceu durante o preenchimento.
• Como orientar: oriente entrar de novo e refazer o envio.
• Quando escalar: se acontecer logo após o login, abrir issue no Jira (projeto DEV).