Glossario

É a promoção configurada no painel. Nela fica o que vale só para aquela promoção: modalidades e regras, prêmios, posições premiadas, formulário, conteúdos do hotsite, os vínculos com lojas e produtos e as participações. Lojas, redes, produtos, séries e a Blacklist são cadastros do cliente, feitos fora da campanha e aproveitados nela pelo vínculo. Cada campanha tem o seu próprio link no hotsite, e as campanhas ativas e no período também aparecem no Portal de promoções, a menos que sejam escondidas.

É o tipo de premiação habilitado na campanha. O painel oferece Sorteio, Posição premiada, Cupom de participação e Pontos, e uma campanha pode ter mais de uma ao mesmo tempo. A modalidade separa os lados da premiação: cada prêmio pertence a uma modalidade (Sorteio, Posição premiada ou Pontos) e não paga do outro lado, e só Sorteio e Posição premiada geram ganhador. No detalhe da campanha, as abas Posições e Vídeos só aparecem com a Posição premiada marcada. Vale-brinde é o nome comercial da Posição premiada, não outra modalidade.

É a configuração que decide quanto cada evento rende em chance: a nota (por valor, por quantidade, por produto ou em pontos por produto), o story, o cadastro na campanha e a entrada na comunidade. Na regra ficam também o limite de chances, o limite de notas e a opção de saldo acumulado. Uma regra pode ser usada em várias modalidades e campanhas, então alterá-la atinge todas elas, e o aviso de alteração lista as campanhas afetadas. A alteração vale só para frente: nada é recalculado para trás. Com a campanha em andamento, só o Master altera os campos que mexem no cálculo, depois de um aviso e de uma confirmação.

É a aba onde o operador decide quais campos o participante vê e quais ele é obrigado a responder, em duas listas independentes: os campos do cadastro e os da nota fiscal. É a fonte única da obrigatoriedade: o que está marcado ali vale no hotsite, na integração de parceiro, na área logada e na edição feita pelo painel. As exceções são o valor da nota, que passa a ser exigido quando há regra de geração por valor, e o aceite, o CNPJ, a chave e o estado, que ainda seguem as opções da campanha. Campo desativado nunca é obrigatório.

É o cadastro que define o formato do número da sorte: quantos dígitos têm a série e o sequencial (de 1 a 5 cada), a faixa da série e, se houver, um prefixo fixo de um dígito. A série é a primeira parte do número da sorte e é sorteada, assim como o sequencial. Ela é obrigatória na modalidade Sorteio, pode ser reaproveitada entre campanhas e não pode ser trocada depois que a campanha gerou o primeiro número, nem pelo Master.

É o teto de quantas chances uma nota rende e de quantas o participante acumula na campanha, configurado na regra de geração ("Quantidade de chances por nota" e "Quantidade máxima de participação"). Com mais de uma regra vale o menor teto, e campo em branco significa sem limite. Quando ele estoura a nota é aceita normalmente e apenas não rende chance além do teto, podendo render zero. Não confundir com o limite de notas, que recusa o envio.

É o teto de quantas notas o participante consegue cadastrar, um por dia e um na campanha inteira, configurado na regra de geração. No painel os campos se chamam "Quantidade de chances por CPF" e "Quantidade de chances total de notas", mas limitam notas. Diferente do limite de chances, aqui a nota é recusada com mensagem explícita. O limite por dia conta pela data do envio e renova à meia-noite de Brasília, só notas ativas contam, e envios simultâneos do mesmo participante são conferidos um por vez.

É o mecanismo interno que faz operações simultâneas sobre o mesmo limite esperarem uma pela outra, em vez de passarem juntas pelo mesmo teto. Há travas para o teto de chances e o saldo, para o limite de prêmios, para o limite de notas, para a nota repetida e para o estoque do prêmio de resgate, que é o que impede duas pessoas de levarem a mesma última unidade. A maioria é por participante, então pessoas diferentes não se bloqueiam. Para o atendimento ela aparece como uma operação que espera a outra terminar em vez de duplicar o resultado. A palavra também é usada para dizer que a série fica travada depois do primeiro número.

É o vínculo de uma pessoa com uma campanha. O cadastro é único por documento no cliente, mas a participação é por campanha, então a mesma pessoa tem uma participação em cada campanha de que entra. No painel uma linha de Participantes é uma participação e não uma pessoa.

É o comprovante de compra que o participante cadastra para participar. Ela é conferida no envio e gera na hora: não existe fila de análise de nota nem aprovação de rotina. A conferência manual acontece quando a pessoa ganha: a posição premiada passa pela fila de apuração e o ganhador de sorteio é registrado à mão.

É o código de 44 dígitos que identifica a nota de forma única e já contém CNPJ, série e número. Com ela a nota é identificada sem ambiguidade. Sem ela, a identificação depende da opção "Valida chave da nota" da campanha: ligada, compara CNPJ e número ignorando a série, e uma compra diferente da mesma loja com o mesmo número pode ser recusada como repetida. Cadastrar com a chave é a saída recomendada nos casos de duplicidade.

É o que a regra de geração produz a partir de uma nota, de um story, do cadastro na campanha ou da entrada na comunidade. Dependendo da modalidade a chance se materializa como número da sorte, como posição premiada ou como pontos. Chance invalidada, por exemplo pelo cancelamento da nota, deixa de valer mas não é apagada.

É a chance da modalidade Sorteio, no formato série barra sequencial (por exemplo 042/01987), único na campanha. As duas partes são sorteadas e não contadas em ordem, porque o número premiado, que no sorteio pela Loteria Federal sai dos bilhetes do concurso, pode cair em qualquer ponto da faixa. Um mesmo número pode ter vindo de duas compras quando a campanha acumula saldo.

São a chance da modalidade Pontos: cada nota credita a quantidade definida pela regra de geração, e o total fica guardado por participação. Também podem entrar pontos de boas-vindas de convite e ajustes manuais feitos pelo painel. Os pontos são trocados por prêmios na vitrine de resgate. Pontos não são saldo acumulado: a modalidade Pontos não aceita regra que acumula saldo nem regra sem nota, como story, cadastro e comunidade.

É o valor (ou a quantidade, na regra por quantidade) que a compra trouxe e que não completou o mínimo da regra de geração. Ele fica guardado e entra na conta da próxima compra em vez de se perder. Saldo não é uma modalidade: é uma opção da regra de geração, aceita no Sorteio e na Posição premiada e recusada em Pontos. O participante acompanha o saldo na aba Saldo da área logada.

É o total de pontos que o participante tem disponível para resgatar numa campanha. Como os pontos saem no momento do pedido de resgate, o saldo pode ficar negativo quando uma nota é cancelada depois de um pedido, ou quando a saída da campanha estorna pontos de boas-vindas. O negativo é o registro de que o prêmio saiu sem lastro e é abatido pelos próximos créditos. O participante volta a resgatar quando o saldo cobrir o custo.

É a lista de movimentos de um saldo do participante na campanha. Há dois: o extrato do saldo acumulado (aba Saldo), com uma linha por nota e os estornos e ajustes, e o extrato de pontos, com créditos, estornos, ajustes, resgates e devoluções. No painel o extrato é a verdade e o saldo é a soma dele. O participante vê uma versão reduzida, sem ajustes manuais e sem os detalhes de teto e motivo, então as linhas visíveis podem não fechar com o saldo. No menu do hotsite, o link Extrato abre a lista de notas do participante.

É a modalidade em que a campanha cadastra um pool de posições e cada chance gerada toma o próximo número da fila do dia, global ou por rede. Se esse número é uma posição que paga prêmio, o participante ganha e a posição vai para análise na fila de apuração; se não, ele vê o vídeo de não premiado. Cada posição tem duas marcas distintas: premiável é configuração e distribuída é resultado. Para o participante ela se chama vale-brinde.

É o nome comercial da posição premiada: é como o participante a vê no hotsite, por exemplo na aba Vale Brinde da página de ganhadores. Não é uma modalidade separada e é a mesma mecânica da posição premiada. O conteúdo da campanha tem campos de regulamento separados para sorteio, vale-brinde e pontos.

É a posição do pool que não paga prêmio. Ela ocupa uma vaga da fila e pode ser consumida, e faz o hotsite mostrar o vídeo de não premiado, que também aparece quando a chance cai num número sem posição cadastrada. Não passa pela apuração. Ocupa vaga no limite de chances do participante, mas não conta como prêmio recebido. Se a nota é cancelada, a posição é invalidada e a vaga no pool continua consumida.

É o conjunto de posições que a campanha vai distribuir, montado à mão ou por arquivo. A fila pode ser global ou por rede e recomeça a cada dia. Trocar esse escopo só é possível com o pool vazio, ou seja, sem posições ativas ainda não distribuídas. O cadastro manual e a importação recusam posição no escopo errado; só posições gravadas antes dessa regra podem ter ficado do lado errado.

É o teto de quantos prêmios um participante recebe e de quantos uma nota paga, somando Sorteio e Posição premiada; campo em branco ou zero significa sem limite. Diferente do limite de chances, aqui a posição de quem atingiu o teto fica parada e a aprovação é barrada: o sistema não reprova sozinho, e quem decide qual posição será reprovada é a operação. O limite também vale ao registrar ganhador de sorteio.

Na posição premiada, é a etapa em que o time do cliente confere o prêmio antes de ele ser pago, na fila de Gerenciar e Posições. Cada linha da fila é uma posição e não uma nota. Aprovar, reprovar e reabrir exigem a permissão global Aprovar notas. Reprovar devolve o prêmio ao pool na mesma hora e não tem volta. A palavra também aparece no sorteio pela Loteria Federal, em que apurar calcula o número premiado e os candidatos sem gravar nada.

É o registro de quem fica com um prêmio e vem de uma de duas vias: o sorteio, em que o operador registra o número escolhido, digitado ou apurado pela Loteria Federal; ou a posição premiada já aprovada na apuração. Todo ganhador nasce como rascunho. O nome exibido vem do cadastro do participante e é lido em tempo real.

É o segundo ato depois do registro: decidir que aquele ganhador aparece na página pública do hotsite. A separação é deliberada, porque publicar o nome de uma pessoa é uma decisão e não uma consequência automática. Publicar e ocultar são reversíveis; excluir só funciona antes da primeira publicação. Posição já publicada como ganhadora não pode ser reaberta na apuração sem antes ocultar ou excluir o ganhador.

É a troca de pontos por prêmio na modalidade Pontos. O débito é imediato: no momento do pedido os pontos saem do saldo e a unidade sai do estoque. O custo e o nome do prêmio ficam congelados no pedido mesmo que a vitrine mude depois. Pedido reprovado, ou cancelado pelo participante enquanto pendente, devolve os pontos e o estoque.

É a tela onde o participante escolhe o prêmio a trocar pelos pontos, em Trocar pontos. Ela fica aberta enquanto a campanha está ativa, até a data de fim mais os dias de prazo de resgate configurados; sem prazo configurado fecha junto com a campanha. Esse prazo é o primeiro ponto a conferir quando alguém reclama que não conseguiu trocar.

É a ação do operador que invalida uma nota já cadastrada, com motivo obrigatório e interno, que o participante não vê. Ela derruba o que a nota gerou, e a nota deixa de contar para limites, teto e saldo, mas não bloqueia ninguém: a mesma nota pode ser cadastrada de novo. Ganhador já publicado e posição premiada ficam de pé e vão para análise manual.

É a lista de documentos que o cliente não quer que participem, conferida na inscrição e em cada nota enviada. Tem dois tipos, Funcionário e Blacklist geral, para o cliente separar funcionários do bloqueio geral. O documento é cadastrado em Cadastros e Blacklist e só barra a pessoa na campanha à qual está vinculado; esse vínculo ainda não tem tela no painel. É o caminho correto quando o cliente pede para impedir alguém de participar.

É a carga por arquivo de cadastros (lojas, produtos, redes e Blacklist) ou de posições premiadas, com modelo para download em cada tela. Ela é parcial: as linhas válidas entram e as recusadas voltam com o motivo e o número da linha. Registro que já existe é ignorado e não atualizado, então reenviar planilha corrigida não corrige o que já está lá.

É a ação que remove de uma vez tudo o que um lote de importação gravou, inclusive registros editados depois da importação. É sempre tudo ou nada e é recusada se algum item do lote já estiver sendo usado. Alcança só o que aquele arquivo gravou: o que foi ignorado na importação nunca sai no desfazer.

É a operação que liga uma loja ou um produto já cadastrado a uma campanha, nas abas Lojas e Produtos dela. Cadastrar não é vincular: o catálogo é do cliente e só passa a valer na campanha depois do vínculo. É no vínculo que vivem as configurações que valem só ali, como a chance extra da loja e os pontos por unidade do produto.

É o conjunto de permissões atribuído a um usuário do painel, no menu Roles. Cada pessoa tem um papel só, nunca vários, então dar um acesso diferente a alguém exige um papel novo e não uma exceção na conta. Quem cria papéis e usuários é o Master do cliente.

É cada autorização marcada no papel. Há a matriz de permissões por recurso e as permissões globais, que valem por cima das telas: ver dados sensíveis, aprovar notas, aprovar financeiro e exportar dados. Aprovar na fila de apuração vem da permissão global de aprovar notas e não da de editar posições premiadas, e sem exportar dados o menu Relatórios não aparece.

É uma das seis faixas fixas em que a base do cliente é dividida, somando todas as campanhas: Só cadastro, Adormecidos, Campeões, Em risco, Fiéis e Novos promissores. Cada pessoa está em exatamente um segmento e a soma fecha a base inteira. A maioria dos cortes é fixa (número de campanhas e meses sem atividade), mas o corte de valor dos Campeões é relativo à base, então alguém pode trocar de segmento sem ter feito nada, também pela passagem do tempo ou pelo encerramento de uma campanha.

É a ação de escolher um público da base do cliente e chamar essas pessoas para uma próxima campanha, com benefício opcional para quem vier. A entrada é o botão "Convidar este público" no segmento aberto em Base e Segmentos, e não um item de menu. Cancelar um convite para o envio, mas não tira o benefício de quem já recebeu o e-mail.

É a interface pública onde o participante conhece a promoção, se cadastra, envia notas e consulta números, pontos e ganhadores. O domínio sozinho não abre conteúdo: cada campanha carrega pelo link completo dela, e toda divulgação precisa apontar para esse link. A lista das promoções no ar fica no Portal de promoções, em /portal.

É a empresa do cliente que cadastra participantes e envia notas direto na campanha, por integração, sem passar pelo hotsite. O canal não muda as regras da campanha: idade, razão social, estado, campos obrigatórios, bloqueio, duplicidade e limites valem igual. Cadastro criado pelo parceiro não tem senha, não entra pelo hotsite e não usa recuperação de senha nem Mudei de estado. Não confundir com as plataformas parceiras de comunidade, como a Kaply.

É a credencial de curta duração que o parceiro obtém com o seu identificador e segredo para autenticar as chamadas da integração. Cada token fica amarrado ao cliente e a uma campanha, mas a mesma credencial pode pedir token para outra campanha do mesmo cliente. Como a credencial é o token, a inscrição de um documento que já existe é aberta sem conferir senha.

É o grupo do cliente no WhatsApp, ligado por uma plataforma parceira como a Kaply, cuja entrada pode render chance ao participante, só na modalidade Sorteio e uma única vez por participação. Ela é do cliente e não de uma campanha, então quem já é membro recebe a chance ao entrar numa campanha nova configurada com a mesma comunidade. Sem o identificador da integração configurado o botão aparece, mas nada é creditado.

É o fluxo da tela de Ganhadores que apura o número premiado de um prêmio de sorteio a partir do resultado de um concurso da Loteria Federal. O operador busca o resultado na Caixa ou digita os cinco bilhetes, apura e escolhe o candidato; a série sai das dezenas e o sequencial das unidades dos bilhetes, do 1º prêmio para baixo. Apurar não grava nada: o ganhador só é criado em Registrar ganhador, como rascunho, e a apuração é feita prêmio a prêmio.

É a regra que define o ganhador no sorteio pela Loteria Federal quando o número premiado não foi distribuído: vale o número distribuído da mesma série com o sequencial mais perto, para cima ou para baixo, e no empate o de cima. Sem números na série, a busca passa às séries seguintes, dando a volta no fim. O primeiro da lista é o ganhador e os seguintes são suplentes, escolhidos pelo operador quando o ganhador é desclassificado.

É a apresentação em tela cheia do resultado do sorteio pela Loteria Federal, pensada para transmissão: roletas que param no número sorteado, o número contemplado quando não é o exato, o nome e o documento mascarados e efeitos de som que podem ser desligados. Mostra só a pessoa escolhida e não registra nada: o ganhador continua dependendo de Registrar ganhador.

É a vitrine pública em /portal que lista as campanhas ativas e no período, com busca, filtros e o link para o hotsite de cada uma. A presença é automática: a campanha aparece por padrão e o cliente pode escondê-la ou caprichar no cartão na aba Portal da campanha no painel. Só aparecem campanhas do sistema novo, e o valor dos prêmios não é exibido.

É a tela do hotsite em que quem já tem cadastro corrige o endereço, com CPF e senha, quando uma campanha restrita por estado recusa a participação pelo estado do cadastro. Ela não inscreve na campanha, não abre sessão e muda o endereço do cadastro inteiro, em todas as campanhas do cliente; depois a pessoa volta ao login e clica em Participar desta campanha.

É a senha que o participante importado do sistema anterior usava lá e que continua valendo no sistema novo. No primeiro acesso com a senha certa ela é convertida para o formato novo, sem aviso na tela e sem prazo, e segue sendo a senha da pessoa. Vale no login, na inscrição em outra campanha, ao completar o cadastro para participar e em Mudei de estado.