Notas fiscais no painel

É o que o painel oferece sobre nota fiscal: ver a nota de um participante, ver o que ela rendeu e cancelá-la com motivo. Duas coisas importantes de entrada, porque mudam a conversa com o cliente:

Não existe fila de notas nem aprovação de rotina de nota. O painel não tem tela de notas fiscais por campanha e não há ação de aprovar nota. O que passa por análise é a posição premiada, na fila de apuração. Nota que só gerou número da sorte não aparece em lugar nenhum do painel como item de análise.

A nota é alcançada pelo participante: em Gerenciar e Participantes, no detalhe, na aba Notas fiscais. Para ver e baixar o conjunto, existe a aba Notas fiscais em Relatórios.

No detalhe do participante, a aba Notas fiscais lista as notas daquela participação. Cada linha abre um painel com a origem, a loja e a rede, os produtos, os números e as posições gerados por aquela nota e, no fim, o botão de cancelar.

O anexo e a consulta na Sefaz

O anexo da nota é mostrado conforme o tipo do arquivo:

• Imagem: miniatura que amplia ao clicar.
• PDF: ícone de documento que abre o arquivo em nova aba.
• Outro endereço, como uma foto guardada no sistema anterior: o link "Abrir nota", em nova aba.
• Sem anexo: um marcador de nota sem imagem.

Quando a nota veio por leitura de QR Code, ela tem também o endereço de consulta do cupom, e a tela mostra o link "Consultar na SEFAZ" ao lado do anexo. Esse link é um campo separado do anexo: a nota pode ter a consulta, a foto, as duas ou nenhuma. O mesmo tratamento vale onde a nota aparece em Ganhadores e na fila de Posições.

Cancelar uma nota

O botão "Cancelar a nota" fica no fim do painel expandido da nota, depois do que ela rendeu — é esse conteúdo que o cancelamento derruba, e o operador decide depois de ver. O botão desaparece para quem não tem a permissão de editar notas, mas quem de fato recusa é o servidor.

O modal explica antes o que vai acontecer: a nota deixa de contar na duplicidade, no teto de chances, no limite de notas e no saldo acumulado. O motivo é obrigatório e tem limite de 300 caracteres. Ele aparece no detalhe da nota, na linha de cada chance que caiu e no extrato do saldo. Fechar o modal com o motivo digitado pede confirmação antes de descartar.

Depois do cancelamento, a tela mostra no topo das abas o que caiu:

• As chances invalidadas: os números da sorte e as posições não premiadas formados pela nota. Elas continuam nas listas, marcadas, porque esta é a tela de auditoria. Não são apagadas — o número ocupou o espaço do sorteio e pode ter saído num resultado.
• As chances que vão para análise manual: número já publicado como ganhador e posição premiada, em qualquer situação. Continuam valendo, o prêmio não volta ao pool, e a decisão é do analista, fora deste fluxo.
• Os estornos de saldo, um por conta de saldo, que aparecem na aba Saldo. Lista vazia é o caso normal: quer dizer que nenhuma regra da campanha acumula saldo.

O saldo que passa a sobrar não gera chance na hora: espera a próxima nota. Na modalidade Pontos, os pontos da nota são estornados e o saldo de pontos pode ficar negativo, se eles já tinham sido usados.

Cancelar duas vezes é inofensivo. A segunda tentativa não grava nada e devolve o mesmo resultado, com a data e o motivo do primeiro cancelamento.

Não existe desfazer. Recadastrar a mesma nota vale como nota nova e gera de novo — e esse é o fluxo normal: nota ilegível que o participante reenvia legível. Para impedir que a pessoa continue participando, o caminho é bloquear o documento dela na Blacklist. O modal e o bloco da nota cancelada dizem isso.

O cancelamento mexe em várias abas de uma vez — a nota fica inativa, as chances saem marcadas e o saldo muda — então a tela recarrega o detalhe inteiro.

As duas marcas nas abas de números e posições

São coisas diferentes e não devem ser confundidas:

• Invalidada: a chance deixou de valer. O motivo aparece ao passar o mouse.
• Formada por nota cancelada: a chance sobreviveu, mas uma nota que a formou caiu. Na coluna Notas de origem, a nota cancelada aparece riscada.

A segunda existe porque, com saldo acumulado, a chance pende de várias notas: cancelar uma delas não a derruba quando ela foi para análise manual ou quando sobrou outra nota legítima.

Nos relatórios

Nota cancelada não entra em nenhum relatório pronto, e chance invalidada também não. A única exceção é o relatório de Apuração, que mostra a posição de participação cancelada porque o arquivo dele é o de hoje e tirar linha seria mudá-lo.

A nota do participante é vista pelo cadastro dele, em Gerenciar e Participantes. Se o cliente procura uma lista de notas da campanha para conferir, o lugar é a aba Notas fiscais em Relatórios.

Se o cliente pergunta onde aprova notas, a resposta é que a nota não passa por aprovação de rotina. O sistema valida a nota no momento do envio e responde ao participante com a participação gerada ou com o motivo da recusa. O que o time do cliente analisa é a posição premiada, na fila de apuração.

Nota enviada em PDF abre em nova aba, e a nota lida por QR Code tem o link "Consultar na SEFAZ" para conferir o cupom direto na fonte.

Três avisos sobre o cancelamento:

Cancelar não bloqueia a pessoa. A mesma nota pode ser cadastrada de novo e vai gerar de novo. Para barrar alguém, o caminho é bloquear o documento na Blacklist.

O cancelamento não devolve prêmio ao pool. Posição premiada e número já publicado como ganhador continuam valendo e vão para análise manual.

O motivo é obrigatório e fica visível: aparece no detalhe da nota, em cada chance derrubada e no extrato do saldo. Vale escrever um motivo que o próprio time entenda meses depois.

• Falha: o cliente não encontra a tela de notas fiscais no painel.
• Possivel causa: não existe tela de notas fiscais por campanha. A nota é alcançada pelo cadastro do participante, e o conjunto sai pela aba Notas fiscais de Relatórios.
• Como orientar: oriente a abrir Gerenciar e Participantes, localizar o participante e usar a aba Notas fiscais do detalhe. Para o conjunto, use Relatórios.
• Quando escalar: não é falha. Só escalar se a aba Notas fiscais não aparecer em Relatórios para quem pode exportar dados.

• Falha: o cliente pede para aprovar uma nota e não encontra o botão.
• Possivel causa: a nota não passa por aprovação de rotina. O que se aprova é a posição premiada, na fila de apuração.
• Como orientar: explique que a validação da nota acontece no envio. Leve o cliente a Gerenciar e Posições se o que ele quer é decidir uma premiação.
• Quando escalar: não é falha.

• Falha: a imagem da nota não aparece e no lugar há um link.
• Possivel causa: o anexo é um PDF ou um endereço que não é imagem, como a foto guardada no sistema anterior. Nesses casos a tela abre o arquivo em nova aba em vez de desenhar a miniatura.
• Como orientar: clique no ícone do PDF ou no link "Abrir nota". Se houver o link "Consultar na SEFAZ", ele abre o cupom na Sefaz.
• Quando escalar: se o link não abrir a nota, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o botão de cancelar a nota não aparece.
• Possivel causa: o papel do usuário não tem a permissão de editar notas.
• Como orientar: confira com o Master do cliente a permissão de editar notas no papel do usuário.
• Quando escalar: se o papel tiver a permissão e o botão continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a nota foi cancelada e o participante continuou participando com a mesma nota.
• Possivel causa: cancelar não bloqueia o participante e não existe desfazer. Recadastrar a mesma nota vale como nota nova.
• Como orientar: explique que esse é o comportamento esperado. Para impedir a participação, bloqueie o documento do participante na Blacklist.
• Quando escalar: não é falha. Só escalar se o documento estiver bloqueado e a nota ainda entrar.

• Falha: a nota foi cancelada mas o número da sorte continua na lista do participante.
• Possivel causa: a chance aparece marcada como invalidada e não é apagada, de propósito, ou ela sobreviveu porque foi formada também por outra nota ainda ativa.
• Como orientar: confira a marca na linha. Invalidada quer dizer que a chance deixou de valer. Formada por nota cancelada quer dizer que a chance sobreviveu, e a nota que caiu aparece riscada na coluna de origem.
• Quando escalar: se uma chance sem marca nenhuma continuar valendo depois do cancelamento, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para cancelar a nota e o botão fica desabilitado.
• Possivel causa: o motivo está em branco ou passou de 300 caracteres.
• Como orientar: escreva um motivo curto e objetivo. O campo é obrigatório e tem limite de tamanho.
• Quando escalar: se o motivo estiver preenchido dentro do limite e o botão continuar desabilitado, abrir issue no Jira (projeto DEV) com as evidências.