Participantes da campanha

É a tela Participantes do grupo Gerenciar: quem está inscrito na campanha, com os números da sorte, as notas fiscais e os stories que cada um gerou. É por aqui que o suporte encontra uma pessoa, lê o que ela tem na campanha, corrige o cadastro dela e ativa ou inativa a participação.

Uma linha é uma participação, não uma pessoa. O cadastro é único por documento e participa de várias campanhas, e por isso a campanha é um seletor da tela, não uma coluna.

A tela tem uma busca por nome ou CPF/CNPJ completo e filtros por nome, e-mail, CPF/CNPJ, origem (WhatsApp, Site, App ou Integração), período de inscrição e a opção de incluir participações inativas. O período filtra pela inscrição na campanha, não pelo cadastro. Há ordenação, paginação e exportação em CSV, que segue a permissão global de exportar dados.

A busca por documento exige o valor completo e só com números. Documento incompleto devolve página vazia, e não a lista inteira: ignorar o filtro em silêncio faria o operador ler a lista completa como se fosse o resultado da busca. Nome e e-mail funcionam por trecho do texto.

A listagem mostra, por participante, a origem, a data de inscrição, as quantidades de números, notas, posições e stories, os dados extras do formulário e a situação (ativa ou inativa).

O detalhe do participante

O detalhe abre em abas: Números da sorte, Notas fiscais, Posições, Saldo e Pontos. A linha da nota é expansível, e há um modal com os dados extras do formulário.

Os totais do detalhe são os reais; as listas vêm limitadas às mais recentes. A tela compara os dois e avisa, por exemplo, que está mostrando os cem mais recentes de trezentos e vinte — em vez de deixar achar que se viu tudo.

Onde a nota aparece, o anexo segue o tipo do arquivo: imagem vira miniatura que amplia, PDF abre em nova aba e outros endereços aparecem como o link "Abrir nota". Quando a nota tem o endereço de consulta do cupom, aparece também o link "Consultar na SEFAZ".

A aba Saldo traz um bloco por regra e por modalidade, mais o extrato paginado agrupado por nota. O saldo é por participação, regra e modalidade, não um número por participante: a mesma campanha pode ter uma conta no sorteio e outra na posição premiada. Lista vazia é o caso normal — quer dizer que nenhuma regra da campanha acumula saldo para aquele participante.

Duas leituras do extrato do saldo que evitam erro de diagnóstico. Os parâmetros gravados em cada linha são os de quando a linha nasceu, não os de agora — a regra pode ser alterada durante a campanha e nada é recalculado para trás. E quando o extrato informa chances que não foram geradas porque o teto do participante foi atingido, o valor dessas chances ficou no saldo.

A aba Pontos traz o saldo de pontos e o extrato, com o mais novo primeiro e o saldo depois de cada linha. Embaixo do nome de cada movimento aparece a origem: a nota, o motivo e o autor, o convite (no crédito e no estorno de boas-vindas) ou o prêmio (no resgate e na devolução de resgate). Quem também pode ler notas consegue clicar em "Nota nº" e ver o detalhe da nota ali mesmo. O saldo de pontos pode ficar negativo: é o caso de nota cancelada depois de os pontos terem sido usados.

O botão Ajustar pontos credita ou debita pontos com motivo obrigatório, e débito além do saldo é recusado. Ele é do operador do cliente com a permissão de editar participações e só vale em campanha com a modalidade Pontos.

O ajuste manual de saldo em reais é diferente: ele é só da equipe Premify e não está disponível para nenhum papel do cliente, nem para o Master.

Editar o cadastro

O botão Editar cadastro abre a edição em tela própria. O cadastro é global: a alteração vale para todas as campanhas do participante, e o topo da tela avisa em quantas ele está, inativas incluídas.

O que não se edita: o documento (é a identidade da pessoa e a chave da Blacklist, e aparece desabilitado), os aceites de privacidade, o saldo e a origem.

Participante com CNPJ tem o campo Razão social, mesmo quando ela ainda está vazia — é o jeito de completar cadastros antigos. Deixar o campo em branco mantém a razão social atual, não apaga. Participante com CPF não vê o campo.

O nome é editável mesmo com ganhador ou posição aprovada: as listas de ganhadores e de apuração leem o nome em tempo real e passam a exibir o novo.

Os campos personalizados do formulário são gravados no cadastro global, e a edição altera só os campos que o operador mexeu. Só valem os campos personalizados ativos do formulário daquela campanha; apagar o conteúdo remove a resposta. Campo personalizado inativo com resposta gravada aparece só para leitura. As respostas de outras campanhas não aparecem na tela — só a contagem — e ficam intactas.

Dois comportamentos propositais da edição pelo painel: os campos obrigatórios do formulário valem aqui também, inclusive quando o operador está mexendo em outro campo (a mensagem lista todos os pendentes de uma vez pelo rótulo da tela); mas a idade mínima da campanha não é aplicada aqui, de propósito, para o operador conseguir corrigir um cadastro antigo.

E-mail que já pertence a outro participante ativo é recusado. Manter o próprio e-mail passa, mesmo que ele já esteja repetido em outro cadastro.

Cada edição fica registrada, com quem fez e só os campos que mudaram. Salvar sem mudar nada não gera registro. A edição exige a permissão de editar participações; o Master passa sem ela.

Nos modais com formulário desta tela, como ajustar pontos e cancelar nota, fechar com algo preenchido pede confirmação ("Sair sem salvar?"), para o operador não perder o que digitou.

Ativar e inativar a participação

O ativar e o inativar do painel só ligam e desligam a participação. O inativar não cancela nota, não invalida número e não estorna ponto: os números e notas continuam registrados, e a participação pode ser reativada depois. O ativar não traz nada de volta. É diferente da saída pelo hotsite, em que o próprio participante desiste: ali as notas são canceladas, os números invalidados e os pontos estornados.

Por isso o modal de ativar diz que notas, números e pontos que foram cancelados continuam cancelados — frase que vale nos dois casos.

O que o painel faz fica registrado, com quem fez, e só grava quando o estado muda de fato.

Essa é a tela do dia a dia do suporte do cliente. Quatro orientações que resolvem a maioria das dúvidas:

Para achar alguém pelo CPF ou CNPJ, o documento precisa estar completo e sem pontos nem barras. Documento parcial devolve lista vazia, e isso não é defeito.

A edição do cadastro vale para todas as campanhas daquela pessoa, porque o cadastro é um só. A tela avisa em quantas campanhas ela está antes de salvar.

Inativar a participação pelo painel não desfaz nada: as notas, os números e os pontos ficam como estão. Se o cliente quer derrubar o que uma nota rendeu, o caminho é cancelar a nota. Se quer barrar a pessoa, o caminho é bloquear o documento na Blacklist.

O ajuste de pontos é do time do cliente. O ajuste de saldo em reais não é: ele é só da equipe Premify.

• Falha: a busca por CPF ou CNPJ não retorna o participante.
• Possivel causa: o documento foi digitado incompleto ou com máscara. A busca por documento exige o valor completo e só com dígitos.
• Como orientar: digite o documento inteiro, sem pontos, barra ou traço. Se não tiver o documento completo, busque por nome ou e-mail.
• Quando escalar: se o documento completo estiver correto e a busca continuar vazia, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para salvar a edição do cadastro.
• Possivel causa: algum campo marcado como obrigatório no formulário desta campanha está sem resposta ou com valor que não serve ao tipo do campo.
• Como orientar: a mensagem lista todos os pendentes pelo rótulo da tela. Preencha todos na mesma edição e salve de novo.
• Quando escalar: se a mensagem apontar campo que não existe mais no formulário, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o campo de documento aparece desabilitado na edição.
• Possivel causa: o documento é a identidade do participante e a chave da Blacklist, e por isso não é editável.
• Como orientar: explique que documento não se edita. Cadastro com documento errado precisa de tratamento caso a caso com o time de desenvolvimento.
• Quando escalar: se o cliente precisar corrigir um documento, abrir issue no Jira (projeto DEV) com as evidências e o caso descrito.

• Falha: o cliente apagou a razão social e ela continua no cadastro.
• Possivel causa: o campo em branco mantém a razão social atual. Ele serve para completar ou corrigir, não para apagar.
• Como orientar: explique o comportamento. Para corrigir, digite a razão social certa no lugar da antiga.
• Quando escalar: não é falha.

• Falha: a participação foi inativada e o participante continua com números válidos.
• Possivel causa: o inativar do painel só desliga a participação. Ele não cancela nota, não invalida número e não estorna ponto.
• Como orientar: explique que esse é o comportamento esperado. Para derrubar o que uma nota rendeu, cancele a nota. Para barrar a pessoa, bloqueie o documento dela na Blacklist.
• Quando escalar: não é falha.

• Falha: o botão de editar cadastro não aparece.
• Possivel causa: o papel do usuário não tem a permissão de editar participações.
• Como orientar: confira com o Master do cliente a permissão de editar participações no papel do usuário. O Master passa sem ela.
• 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: o ajuste de pontos é recusado.
• Possivel causa: o motivo está em branco, o débito passa do saldo atual ou a campanha não tem a modalidade Pontos.
• Como orientar: preencha o motivo, confira o saldo mostrado no próprio modal e confirme que a campanha tem a modalidade Pontos.
• Quando escalar: se tudo estiver correto e o ajuste continuar recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a aba de saldo do participante aparece vazia.
• Possivel causa: nenhuma regra da campanha acumula saldo para aquele participante. Lista vazia é o caso normal.
• Como orientar: confira nas regras da modalidade se alguma usa saldo. Se nenhuma usa, a aba vazia está correta.
• Quando escalar: se alguma regra da campanha acumular saldo e a aba continuar vazia, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o botão de ajustar o saldo em reais não aparece para o operador.
• Possivel causa: o ajuste de saldo em reais é exclusivo da equipe Premify, e nenhum papel do cliente tem acesso, nem o Master.
• Como orientar: explique a divisão. O ajuste de pontos de fidelidade continua disponível para o operador com permissão de editar participações.
• Quando escalar: se o cliente precisar de um ajuste de saldo em reais, abrir issue no Jira (projeto DEV) com as evidências e o caso.