Cadastro de Nota Fiscal no Hotsite

É a tela "Cadastrar nova compra" (menu "Cadastrar Compra"), em que o participante logado informa os dados da nota fiscal, anexa a foto ou o PDF quando a campanha pede, escolhe os produtos e envia.

Campos. Saem do formulário da nota configurado no painel: podem aparecer número da nota, chave da nota fiscal (44 dígitos), CNPJ ou seleção da loja, data da compra, valor, quantidade, "Produtos da compra" (produto e quantidade por linha, opcional) e campos extras do cliente. Campo obrigatório em branco mostra "Campo obrigatório.".

Regras que a tela confere antes de enviar (as mesmas frases da API):

• CNPJ: "Informe o CNPJ da nota." quando a campanha exige CNPJ, e "CNPJ inválido." sempre que ele for digitado errado.
• Chave: "Informe a chave ou o número da nota fiscal." quando a campanha exige identificar a nota, e avisos de chave com tamanho ou dígito errado ("Chave da nota fiscal deve ter 44 dígitos.").
• Quando a campanha usa seleção de loja, o CNPJ vem do cadastro da loja escolhida.

Anexo. Aceita JPG, PNG ou PDF até 10 MB. Mensagens possíveis:

• "Arquivo muito grande. Máximo permitido: 10MB."
• "Arquivo inválido. Envie a foto da nota em JPG ou PNG, ou o arquivo em PDF." (também para arquivo com extensão trocada)
• "Anexe a foto da nota fiscal." quando o anexo é obrigatório e está vazio.

Quando o participante lê o QR Code do cupom, o anexo deixa de ser obrigatório: o link da consulta da nota substitui a foto. O campo continua disponível para quem quiser anexar.

Envio. O botão "Cadastrar" abre "Confirme os dados", com "Editar" e "Confirmo". A API decide na hora e o resultado aparece numa janela:

• "Participação registrada!" com os números da sorte gerados e o botão "Ver extrato";
• "Compra registrada!" quando o valor entrou no saldo ou quando a compra não gerou números;
• "Nota não cadastrada" com o motivo vindo da API e o botão "Tentar novamente".

Mensagens de erro do envio que não vêm da regra da campanha:

• "Sessão expirada. Faça login novamente."
• "Não foi possível falar com o servidor. Tente novamente."
• "Não foi possível cadastrar a nota. Tente novamente."

Campanha 20anosweldvision. A tela vira "Registro de Comprovante do Test Drive": pede a foto do teste prático (só JPG ou PNG), a loja e uma pesquisa rápida de três perguntas, todas obrigatórias.

A tela pede exatamente os campos configurados no formulário da nota da campanha. Ela confere formato de CNPJ, chave e anexo antes do envio, mas quem decide se a nota vale é a API, na hora, com as regras da campanha. Por isso a mensagem de recusa é a da própria regra, e o participante sabe o que corrigir.

• Falha: o anexo é recusado.
• Possivel causa: arquivo acima de 10 MB, formato fora de JPG, PNG ou PDF (HEIC, WEBP, GIF) ou extensão renomeada.
• Como orientar: oriente salvar a foto em JPG ou tirar um print da nota e anexar de novo.
• Quando escalar: se um JPG, PNG ou PDF válido abaixo de 10 MB for recusado, abrir issue no Jira (projeto DEV) com o arquivo.

• Falha: "CNPJ inválido." ou aviso de chave inválida.
• Possivel causa: dígito digitado errado.
• Como orientar: oriente copiar o CNPJ e a chave do cupom com atenção. A chave tem 44 dígitos.
• Quando escalar: se os dados batem com o cupom e a tela recusa, abrir issue no Jira (projeto DEV) com a foto da nota.

• Falha: "Nota não cadastrada" informando que a nota já foi cadastrada.
• Possivel causa: a mesma nota já foi registrada antes, pelo próprio participante ou por outra pessoa.
• Como orientar: confira em Minhas notas. Se não for dele, oriente conforme o regulamento.
• Quando escalar: se houver indício de uso indevido da nota, abrir issue no Jira (projeto DEV) com a chave ou o número da nota.

• Falha: o campo de loja não traz a loja onde a compra foi feita.
• Possivel causa: a loja não está cadastrada como participante na campanha.
• Como orientar: confira a lista de lojas da campanha no painel e o regulamento.
• Quando escalar: se a loja estiver cadastrada e não aparecer, abrir issue no Jira (projeto DEV).

• Falha: o comprovante anexado não abre depois.
• Possivel causa: problema no local onde os arquivos ficam publicados.
• Como orientar: registre o caso; o participante não precisa reenviar se a nota já foi aceita.
• Quando escalar: acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV), porque o comprovante é usado na auditoria do sorteio.