HandyCafe Docs
owner

Pacotes

Pacotes definem a parcela especifica que um membro recebe ao fazer uma compra de uma campanha. Cada pacote especifica o que o membro paga, o que recebe em troca (minutos, credito de carteira ou ambos), em quais dispositivos a parcela se aplica e por quanto tempo permanece valida.

Tipos de Pacote

Todo pacote possui dois campos de tipo que determinam a natureza da parcela:

Tipo do Pacote

O tipo do pacote define a parcela principal:

  • Minutos: O membro recebe um bloco de minutos pre-pagos. O valor base representa o numero de minutos incluidos. Na compra, o sistema cria um credito de tempo com essa quantidade de minutos.
  • Dinheiro: O membro recebe credito de carteira. O valor base representa o valor em unidades menores de moeda (ex.: centavos). Na compra, o sistema cria um credito de carteira com esse saldo.

Tipo de Bonus

O tipo de bonus define uma parcela secundaria opcional concedida alem da base:

  • Minutos: O membro recebe minutos de bonus. O valor do bonus especifica quantos minutos extras sao concedidos. Um credito de tempo separado e criado com o tipo "Bonus".
  • Dinheiro: O membro recebe credito de carteira de bonus. O valor do bonus especifica o valor do bonus em unidades menores. Um credito de carteira separado e criado com o tipo "Bonus".
  • Nenhum: Nenhum bonus esta incluido neste pacote. O membro recebe apenas a parcela base.

Exemplos de Combinacoes

Tipo do Pacote Tipo de Bonus O que o membro recebe
minutos nenhum 120 minutos de tempo pre-pago (sem bonus)
minutos minutos 120 minutos pagos + 30 minutos de bonus
dinheiro nenhum 5000 unidades menores de credito de carteira
dinheiro dinheiro 5000 credito de carteira pago + 1000 credito de bonus
dinheiro minutos 5000 credito de carteira + 60 minutos de bonus
minutos dinheiro 120 minutos + 2000 credito de carteira de bonus

Preco de Compra vs. Parcela

O preco de compra e o valor que o membro paga no caixa (em unidades menores de moeda). Isso e independente do valor base. Os dois valores nao precisam ser iguais.

Por exemplo:

  • Um pacote pode custar 2000 unidades menores (preco de compra) mas conceder 3000 unidades menores de credito de carteira (valor base). O membro efetivamente recebe 50% de bonus embutido no preco base.
  • Um pacote de minutos pode custar 1500 unidades menores e conceder 120 minutos. O "custo por minuto" e implicito e nao precisa corresponder a tarifa padrao por hora.

Essa separacao permite que proprietarios de lan houses criem pacotes com valor agregado onde a parcela excede o pagamento, tornando os pacotes mais atrativos do que o pagamento avulso.

Restricao de Dispositivo

A restricao de dispositivo controla em quais tipos de dispositivos a parcela pode ser utilizada:

Restricao Significado
Cliente Utilizavel em PCs clientes. Tambem utilizavel em consoles.
Console Utilizavel em consoles de jogos. Tambem utilizavel em PCs.
Somente PCs Exclusivamente para PCs clientes. Nao pode ser usado em consoles.
Somente Consoles Exclusivamente para consoles de jogos. Nao pode ser usado em PCs.
Ambos Utilizavel em qualquer dispositivo. Este e o padrao.

A restricao de dispositivo e herdada por todos os creditos de carteira e creditos de tempo criados a partir deste pacote.

Periodo de Validade

Dias Validos

O campo valid_days define o numero de dias que a parcela permanece utilizavel apos a compra. Quando um membro compra o pacote, o sistema calcula a data de expiracao como data_da_compra + valid_days. Apos a expiracao, qualquer saldo restante (minutos ou credito de carteira) nos lotes associados nao e mais utilizavel.

Se valid_days nao estiver definido, a parcela nao expira.

Dias da Semana Validos

A configuracao de dias validos e uma selecao opcional de dias que restringe em quais dias da semana a parcela pode ser consumida. Isso permite pacotes como "somente dias uteis" ou "somente fim de semana". Quando os dias validos sao configurados, o sistema so desconta dos creditos do pacote nos dias qualificados.

Categoria de Carteira e Gasto entre Categorias

Pacotes podem atribuir uma categoria de carteira aos creditos de carteira que criam. Isso marca os fundos com um rotulo de categoria (ex.: "jogos", "geral", "alimentacao") que restringe onde o saldo pode ser gasto.

A opcao de gasto entre categorias no pacote controla se os creditos criados permitem gasto fora da sua categoria:

  • 0 (padrao): Os fundos sao restritos a sua categoria designada.
  • 1: Os fundos tambem podem ser gastos em outras categorias.

Acumulacao de Desconto de Membro

A opcao de acumulacao de desconto de membro controla se o desconto de nivel de um membro se aplica alem dos precos deste pacote quando os minutos ou credito de carteira do pacote sao consumidos:

  • 0 (padrao): O desconto de nivel do membro nao acumula. O pacote e tratado como uma oferta de valor fixo.
  • 1: O desconto de nivel do membro e aplicado alem dos termos do pacote. Isso da a membros de niveis mais altos economia adicional mesmo ao usar pacotes pre-pagos.

Como os Pacotes sao Comprados e Cumpridos

Quando um pacote e comprado:

  1. Cobranca do pagamento: O preco de compra e cobrado do membro (dinheiro, cartao ou deducao de carteira).
  2. Registro de compra: Uma entrada de compra e criada, registrando o membro, pacote, valor pago e timestamps.
  3. Criacao de creditos: Com base na configuracao do pacote:
    • Se o tipo do pacote e dinheiro: um credito de carteira e criado com o valor base e tipo de credito "Pago".
    • Se o tipo do pacote e minutos: um credito de tempo e criado com o valor base como minutos e tipo de credito "Pago".
    • Se o tipo de bonus e dinheiro: um credito de carteira adicional e criado com o valor do bonus e tipo de credito "Bonus".
    • Se o tipo de bonus e minutos: um credito de tempo adicional e criado com o valor do bonus como minutos e tipo de credito "Bonus".
  4. Restricao e validade: Todos os creditos criados herdam a restricao de dispositivo e categoria de carteira do pacote. A expiracao e calculada a partir do periodo de validade se definido.
  5. Rastreamento: O registro de compra mantem totais correntes de consumido vs. concedido para as parcelas paga e bonus, possibilitando calculos precisos de reembolso se necessario.

Criando um Pacote

Para adicionar um pacote a uma campanha existente:

  1. Abra a campanha na lista de campanhas.
  2. Clique em Adicionar Pacote.
  3. Configure o tipo do pacote (minutos ou dinheiro) e defina o valor base.
  4. Opcionalmente configure o tipo de bonus e o valor do bonus.
  5. Defina o preco de compra (o valor que o membro pagara).
  6. Escolha a restricao de dispositivo.
  7. Opcionalmente defina dias validos e dias da semana validos para ofertas por tempo limitado.
  8. Configure categoria de carteira e gasto entre categorias se voce usa separacao de carteira por categoria.
  9. Defina a preferencia de acumulacao de desconto de membro.
  10. Salve o pacote.