Saldo acumulado e o extrato do participante

É o mecanismo que guarda o que uma compra trouxe e não fechou o mínimo da regra. Numa regra de "R$ 50 dá uma chance", a compra de R$ 30 não rende nada e não se perde: fica guardada para a próxima. Saldo não é uma modalidade — é uma opção da regra de geração, que pode estar ligada na modalidade Sorteio ou na Posição premiada, e só nas bases Valor e Quantidade. A modalidade Pontos não aceita regra com saldo, e as bases Produto, Pontos por produto, Story, Cadastro e Comunidade também não, porque não têm o que acumular.

O saldo é por regra e por modalidade, não um saldo único do participante. Isso é deliberado: com um saldo só, a modalidade de mínimo maior perderia a sobra. R$ 75 numa regra de R$ 50 rendem uma chance e deixam R$ 25 de sobra em cada modalidade onde essa regra estiver.

No máximo uma regra por modalidade pode acumular saldo. Duas dividiriam o valor da compra, e o resultado passaria a depender da ordem em que os cálculos rodam. A configuração recusa a segunda.

O extrato é a verdade. O saldo é a soma das entradas menos a soma dos consumos, e cada movimento guarda os parâmetros que valiam naquele instante — a base da regra e o mínimo vigente. Isso existe porque a regra pode mudar durante a campanha e nada é recalculado para trás: sem esses dados gravados, um movimento com entrada de R$ 45 e consumo de R$ 50 ficaria inexplicável depois que a regra virasse R$ 100.

Entrada e consumo são sempre valores positivos. O que desfaz não vira entrada negativa: o estorno de uma nota cancelada usa entrada para o que volta e consumo para o que sai, com zero chances geradas. Lido na tela, "saiu do saldo sem gerar chance" é exatamente o que aconteceu.

A alocação é primeiro a entrar, primeiro a sair. Não é só convenção: com essa ordem o dinheiro mais antigo é o primeiro a virar chance, então o cancelamento de uma nota antiga atinge as chances já formadas — que é o que uma investigação de fraude quer encontrar — em vez de deixar o valor suspeito parado no saldo, intocável.

A alocação é decidida na geração e gravada, não recalculada depois: a composição de uma chance é fato histórico. É por isso que a chance sabe de quais notas ela veio, e quanto cada uma pôs. O exemplo, numa regra de R$ 50:

• compra de R$ 30: disponível R$ 30, gera 0, saldo R$ 30;
• compra de R$ 45: disponível R$ 75, gera 1 chance (A), consome R$ 50, saldo R$ 25. A chance A veio de R$ 30 da primeira compra e R$ 20 da segunda;
• compra de R$ 80: disponível R$ 105, gera 2 chances (B e C), consome R$ 100, saldo R$ 5. B veio de R$ 25 da segunda e R$ 25 da terceira; C veio de R$ 50 da terceira.

Quando um limite corta a geração, o corte sai primeiro da regra com saldo. A razão é aritmética: o valor cortado volta ao saldo e ainda pode render depois (se o limite subir, ou se uma nota for cancelada liberando espaço), enquanto o corte na regra sem saldo evapora.

A nota que entra e não rende é o caso normal nessa modalidade — ela gera o movimento que explica para onde o valor foi.

Duas edições da regra são recusadas de forma absoluta quando alguém já acumulou saldo nela, e nem o Master confirmando as atravessa:

• trocar a base: o saldo foi somado na grandeza da base antiga, e a nova conta outra coisa. Nada converte reais em unidades, e o participante com R$ 40 guardados passaria a ter "40 unidades";
• desligar o saldo: o valor para de ser consumido e fica preso — não vira chance, não volta e deixa de aparecer para quem acumulou.

O que o participante vê na área logada é um bloco por regra e modalidade, com o saldo na grandeza da base, o mínimo por chance e quanto falta para a próxima. Essa conta é feita pela API, não pela tela, pela mesma fonte que o motor usa. Há três respostas:

• nulo quando a regra está sem mínimo configurado — o saldo acumula e nunca gera. "Zero" ali seria lido como "falta nada", que é o oposto;
• zero quando o saldo já comporta uma chance. A chance de fato ainda não existe, porque a geração acontece no processamento da próxima compra, e o hotsite troca a frase para dizer isso;
• o complemento do resto nos outros casos.

Lista de saldos vazia é o caso normal, não erro: a maioria das campanhas não acumula, e é dessa lista vazia que o hotsite decide esconder a aba.

O extrato público esconde três coisas, por decisão de produto:

• o ajuste manual de saldo, nem a linha, nem o motivo, nem o autor. É correção da operação, e o motivo é texto escrito por um operador para outro;
• as chances que algum limite cortou. É a conta que explica ao operador por que a nota rendeu menos; para quem cadastrou, seria a notícia de um limite que a campanha não prometeu em lugar nenhum;
• saldo anterior e posterior por linha. Isso é consequência: sem os ajustes no extrato, a coluna não fecharia com a soma dos movimentos visíveis.

Do estorno sai o fato, não o motivo. A nota cancelada precisa aparecer — é ela que explica o saldo mudando sem compra nova.

O ajuste manual de saldo em reais é restrito à equipe Premify; nem o Master do cliente consegue fazê-lo. O ajuste de pontos é do operador do cliente, e está no artigo de pontos de fidelidade.

Saldo é o que a compra trouxe e não completou uma chance. Ele fica guardado e entra na conta da próxima compra — o cliente não precisa explicar nada além disso ao participante, porque a área logada já mostra o saldo e quanto falta para a próxima chance.

Dois pontos para o cliente que quer mudar a regra com a campanha no ar: trocar a base da regra (de valor para quantidade, por exemplo) e desligar o acúmulo são recusados quando alguém já tem saldo. Não é falta de permissão, e não há confirmação que libere: o que está guardado não teria como ser convertido nem devolvido. O caminho é criar uma regra nova.

E, se o cliente perguntar por que uma compra apareceu no extrato sem gerar chance: é o funcionamento correto. A linha existe justamente para mostrar que o valor entrou e ficou guardado.

• Falha: o participante diz que a compra dele não gerou chance nenhuma.
• Possivel causa: o valor da compra não fechou o mínimo da regra e ficou guardado no saldo.
• Como orientar: abra o saldo do participante e mostre o valor guardado e quanto falta para a próxima chance. A linha da compra está no extrato dele, com entrada e zero chances.
• Quando escalar: se o saldo não tiver registrado a entrada daquela compra, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o saldo acumula e nunca gera chance nenhuma.
• Possivel causa: a regra está sem o mínimo por chance configurado. Nesse caso o cálculo rende zero e o saldo só acumula.
• Como orientar: confira o mínimo na regra de geração e preencha. O extrato é onde isso fica visível antes de alguém reclamar.
• Quando escalar: se o mínimo estiver preenchido e o saldo continuar sem gerar, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o operador não consegue trocar a base da regra ou desligar o saldo dela.
• Possivel causa: algum participante já acumulou saldo naquela regra. As duas recusas são absolutas e nem o Master as atravessa.
• Como orientar: explique que o valor guardado não teria como ser convertido nem devolvido. O caminho é cadastrar uma regra nova com a configuração desejada.
• Quando escalar: não é falha. Só escalar se a recusa aparecer numa regra em que ninguém tem saldo.

• Falha: o operador não consegue ligar o saldo numa regra.
• Possivel causa: a regra está na modalidade Pontos, usa uma base que não acumula (Produto, Pontos por produto, Story, Cadastro ou Comunidade), ou a modalidade já tem outra regra com saldo.
• Como orientar: leia a mensagem, que diz qual é o caso. O saldo vale só nas bases Valor e Quantidade, no Sorteio e na Posição premiada, e em uma regra por modalidade.
• Quando escalar: não é falha.

• Falha: o participante reenviou a mesma compra e nada aconteceu.
• Possivel causa: na modalidade com saldo, a nota já creditada não credita nem gera de novo, nem pelas regras sem saldo que dividem a modalidade com ela. O valor dela já está no saldo.
• Como orientar: explique que o valor daquela compra já está guardado e entra na conta da próxima. Contar de novo seria somar o mesmo dinheiro duas vezes.
• Quando escalar: não é falha. Só escalar se a mesma nota aparecer com duas entradas no extrato.

• Falha: o participante diz que o saldo dele mudou e ele não comprou nada.
• Possivel causa: alguma nota dele foi cancelada e o estorno devolveu ou retirou valor do saldo.
• Como orientar: a linha de estorno aparece no extrato do participante, sem o motivo. O motivo está registrado no painel para a operação.
• Quando escalar: se o saldo mudar sem nenhuma linha correspondente no extrato, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.