Codigos Promocionais e Descontos

Codigos promocionais sao uma ferramenta de marketing poderosa que permite oferecer descontos para atrair novos clientes, recompensar usuarios fieis e executar campanhas promocionais. Este guia aborda tudo o que voce precisa saber sobre criar, gerenciar e otimizar codigos promocionais.

Visao Geral

Codigos promocionais fornecem descontos que os clientes podem aplicar em viagens, recargas de carteira ou compras de assinaturas. Cada codigo pode ser configurado com valores de desconto especificos, limites de uso, periodos de validade e opcoes de segmentacao.

Principais Recursos

• Descontos percentuais ou fixos - Ofereca uma porcentagem de desconto ou um valor fixo em reais
• Multiplos tipos de aplicacao - Aplique em viagens, creditos de carteira ou assinaturas
• Limites de uso - Controle o total de usos e limites por cliente
• Segmentacao por localizacao - Restrinja codigos a subcontas especificas
• Filtragem por tipo de veiculo - Limite codigos a modelos de veiculos especificos
• Requisitos de gasto minimo - Exija um subtotal minimo antes que o desconto seja aplicado
• Limites maximos de desconto - Evite que descontos percentuais excedam um valor definido

Acessando Codigos Promocionais

Configuracao de Codigo Promocional

Codigo

O identificador unico que os clientes inserem para resgatar o desconto.

Tipo de Desconto

Escolha como o desconto e calculado:

Calculo de Valor Fixo:

Desconto = Valor Fixo
Exemplo: Subtotal R$ 60,00, Codigo R$ 25,00 de desconto = Desconto R$ 25,00 = Final R$ 35,00

Calculo Percentual:

Desconto = Subtotal x (Porcentagem / 100)
Exemplo: Subtotal R$ 60,00, Codigo 20% de desconto = Desconto R$ 12,00 = Final R$ 48,00

Valor do Desconto

O valor real do desconto com base no tipo selecionado:

Tipo de Aplicacao

Especifique onde o codigo promocional pode ser usado:

Comportamento de Credito de Carteira:

• Quando resgatado, o valor do desconto e adicionado ao saldo da carteira do cliente
• O credito pode ser usado em qualquer viagem futura
• Funciona como um cartao-presente ou credito bonus

Comportamento de Desconto em Viagem:

• Aplicado durante a cobrança da viagem apos precos dinamicos
• Afeta apenas a viagem especifica onde o codigo e usado
• Aparece no detalhamento de precos da viagem

Comportamento de Desconto em Assinatura:

• Reduz o custo da compra de um plano de assinatura
• Aplicado no momento da compra da assinatura

Limites de Uso

Total de Usos (Global)

Numero maximo de vezes que o codigo pode ser usado por todos os clientes.

Casos de Uso:

• Vendas relampago por tempo limitado (primeiros 50 clientes)
• Promocoes exclusivas de eventos
• Campanhas com orcamento controlado

Usos por Cliente

Maximo de vezes que um unico cliente pode usar o codigo.

Boas Praticas:

• Descontos de primeira viagem: Defina como 1
• Recompensas de fidelidade: Permita multiplos usos
• Codigos de indicacao: Defina como 1 por cliente

Periodo de Validade

Valido A Partir De

Data e hora em que o codigo se torna ativo.

Codigos nao podem ser resgatados antes desta data.

Valido Ate (Opcional)

Data e hora em que o codigo expira.

Cenarios Comuns:

• Venda de fim de semana: Sexta 17h ate Domingo 23:59
• Promocao de natal: 20 de dezembro ate 31 de dezembro
• Campanha de verao: 1 de junho ate 31 de agosto

Opcoes de Segmentacao

Localizacao (Subconta)

Restrinja o codigo a uma localizacao operacional especifica.

Casos de Uso:

• Lancamentos especificos por cidade
• Parcerias baseadas em localizacao
• Promocoes de eventos locais

Tipos de Veiculos (Avancado)

Limite o codigo a modelos de veiculos especificos. Isso e configurado no banco de dados e disponivel para casos de uso avancados.

Exemplo:

• Promocao de veiculo premium: Aplica-se apenas a e-bikes
• Desconto de lancamento de patinete: Aplica-se apenas a patinetes

Requisito de Gasto Minimo

Defina um subtotal minimo que o cliente deve atingir antes que o codigo seja aplicado.

Como Funciona:

Se Subtotal >= Minimo:
  Aplicar desconto
Senao:
  Rejeitar codigo promocional

Casos de Uso:

• "R$ 25 de desconto em viagens acima de R$ 75" - Incentiva viagens mais longas
• "20% de desconto em viagens de R$ 125+" - Protege margens em viagens pequenas

Limite Maximo de Desconto

Limite o desconto maximo para codigos baseados em porcentagem.

Como Funciona:

Desconto Bruto = Subtotal x (Porcentagem / 100)
Desconto Final = MIN(Desconto Bruto, Limite Maximo de Desconto)

Exemplo: 50% de desconto com maximo de R$ 50:

• Viagem de R$ 60: 50% = R$ 30,00, Desconto: R$ 30,00 (abaixo do limite)
• Viagem de R$ 150: 50% = R$ 75,00, Desconto: R$ 50,00 (limitado)

Casos de Uso:

• Descontos percentuais generosos sem responsabilidade ilimitada
• Promocoes estilo "50% de desconto, ate R$ 50"

Criando um Codigo Promocional

Passo 1: Informacoes Basicas

Codigo (Obrigatorio)

• Insira um codigo unico ou clique em Gerar para um codigo aleatorio de 8 caracteres
• Os codigos nao diferenciam maiusculas/minusculas e sao armazenados em maiusculas

Tipo de Aplicacao (Obrigatorio)

• Selecione onde o codigo pode ser usado: Credito de Carteira, Desconto em Viagem ou Desconto em Assinatura

Passo 2: Configure o Desconto

Tipo de Desconto (Obrigatorio)

• Escolha Valor Fixo ou Percentual

Valor do Desconto (Obrigatorio)

• Insira o valor (ex: 25.00 para R$ 25 ou 20 para 20%)

Passo 3: Defina Limites

Total de Usos (Opcional)

• Insira o maximo de usos globais ou deixe em branco para ilimitado

Usos por Cliente (Opcional)

• Insira o limite por cliente (padrao e 1)

Passo 4: Defina Validade

Valido A Partir De (Obrigatorio)

• Selecione quando o codigo se torna ativo (padrao e agora)

Valido Ate (Opcional)

• Selecione data de expiracao ou deixe em branco para sem expiracao

Passo 5: Adicione Detalhes

Descricao (Opcional)

• Descricao interna para referencia (ex: "Promocao novo usuario verao 2025")

Localizacao (Opcional)

• Selecione uma localizacao especifica ou deixe como "Todas as Localizacoes"

Passo 6: Criar

Clique em Criar para salvar o codigo promocional. Ele estara imediatamente ativo se a data valido_a_partir_de ja passou.

Gerenciando Codigos Promocionais

Visualizando Codigos

A tabela de codigos promocionais exibe:

Editando Codigos

1. Clique no icone Editar (lapis)
2. Modifique quaisquer campos
3. Clique em Salvar

Clonando Codigos

Use o botao Clonar para criar um codigo similar:

1. Clique no icone Clonar em um codigo existente
2. Um novo formulario abre com todas as configuracoes copiadas, exceto o codigo em si
3. Insira um novo codigo unico
4. Ajuste quaisquer outras configuracoes
5. Clique em Criar

Casos de Uso:

• Criar variantes especificas por localizacao de uma campanha
• Renovar codigos que estao expirando com novas datas
• Testar A/B diferentes valores de desconto

Desativando Codigos

Alterne o switch Ativo para desabilitar um codigo:

• Codigos inativos nao podem ser resgatados
• O codigo permanece no sistema para referencia historica
• Pode ser reativado a qualquer momento

Use Para:

• Pausar campanhas temporariamente
• Encerrar promocoes antecipadamente
• Preparar codigos para ativacao futura

Excluindo Codigos

1. Clique no icone Excluir (lixeira)
2. Confirme a exclusao

Como os Codigos Promocionais Sao Aplicados

Posicao na Cobranca

Codigos promocionais sao aplicados apos todos os outros calculos de preco:

Cobranças Base -> Beneficios de Nivel -> Assinatura -> Pacotes -> Precos Dinamicos -> CODIGO PROMO -> Final

Isso significa que o desconto do promocional se aplica ao valor restante apos outros descontos e ajustes.

Processo de Validacao

Quando um codigo promocional e submetido, o sistema verifica:

1. Codigo existe - O codigo esta no banco de dados
2. Codigo esta ativo - O flag is_active e verdadeiro
3. Validade temporal - Hora atual esta entre valido_a_partir_de e valido_ate
4. Limite global - Total de usos nao excedeu max_uses
5. Limite do cliente - Usos do cliente nao excederam max_uses_per_customer
6. Correspondencia de localizacao - Se com escopo, a subconta da viagem corresponde
7. Correspondencia de veiculo - Se com escopo, o tipo de veiculo corresponde
8. Minimo atingido - Subtotal atinge o requisito min_ride_amount

Se alguma verificacao falhar, o codigo e rejeitado com uma mensagem de erro apropriada.

Calculo do Desconto

Se discount_type = 'percentage':
  Desconto Bruto = Subtotal x (Porcentagem / 100)
Senao:
  Desconto Bruto = Valor Fixo

Se max_discount definido:
  Desconto = MIN(Desconto Bruto, Limite Maximo de Desconto)

Desconto Final = MIN(Desconto, Subtotal)  // Nao pode exceder subtotal

Cenarios Comuns

Cenario 1: Desconto para Novo Usuario

Objetivo: Dar R$ 25,00 de desconto aos novos clientes na primeira viagem

Configuracao:

• Codigo: BEMVINDO25
• Tipo: Desconto em Viagem
• Desconto: Fixo R$ 25,00
• Usos por cliente: 1
• Localizacao: Todas as Localizacoes
• Validade: Sem expiracao

Cenario 2: Venda Relampago de Verao

Objetivo: 25% de desconto em todas as viagens neste fim de semana, limitado a R$ 50

Configuracao:

• Codigo: VERAO25
• Tipo: Desconto em Viagem
• Desconto: 25%
• Desconto Maximo: R$ 50,00
• Total de Usos: 500 (primeiros 500 apenas)
• Valido A Partir De: Sexta 17h
• Valido Ate: Domingo 23:59

Cenario 3: Bonus de Carteira

Objetivo: Adicionar R$ 50 de credito a carteira do cliente

Configuracao:

• Codigo: BONUS50
• Tipo: Credito de Carteira
• Desconto: Fixo R$ 50,00
• Usos por cliente: 1
• Localizacao: Todas as Localizacoes

Cenario 4: Promocao de E-Bike Premium

Objetivo: 15% de desconto apenas em viagens de e-bike premium

Configuracao:

• Codigo: EBIKE15
• Tipo: Desconto em Viagem
• Desconto: 15%
• Tipos de Veiculos: ID do modelo E-Bike Premium
• Usos por cliente: Ilimitado
• Validade: 30 dias

Cenario 5: Promocao de Gasto Minimo

Objetivo: R$ 15 de desconto em viagens acima de R$ 60

Configuracao:

• Codigo: ECONOMIZE15
• Tipo: Desconto em Viagem
• Desconto: Fixo R$ 15,00
• Valor Minimo da Viagem: R$ 60,00
• Usos por cliente: Ilimitado

Boas Praticas

Design de Codigo

1. Mantenha codigos simples - Faceis de lembrar e digitar
2. Use prefixos significativos - VERAO_, LANC_, IND_ para organizacao
3. Evite confusao - Pule caracteres O/0, I/1/l
4. Teste antes de lancar - Verifique se os codigos funcionam no ambiente de teste

Estrategia de Desconto

1. Comece conservador - Inicie com descontos menores e aumente se necessario
2. Defina limites maximos - Proteja-se contra descontos inesperadamente grandes
3. Use gastos minimos - Incentive viagens maiores enquanto oferece valor
4. Acompanhe o desempenho - Monitore o uso para medir a eficacia da campanha

Limites de Uso

1. Sempre defina limites por cliente - Previna abusos
2. Considere limites totais - Campanhas com orcamento controlado
3. Planeje para fraudes - Observe padroes incomuns

Tempo

1. Agende com antecedencia - Defina valid_from para campanhas futuras
2. Use datas de expiracao - Crie urgencia e previna codigos desatualizados
3. Permita margem - Inicie codigos um pouco antes para testes

Referencia Tecnica

Tabela do Banco de Dados: promo_codes

Tabela do Banco de Dados: customer_promo_uses

Rastreia o uso individual do cliente de codigos promocionais.

Resolucao de Problemas

Codigo Nao Esta Funcionando

1. Verifique o status ativo - Certifique-se de que is_active e verdadeiro
2. Verifique as datas - A hora atual deve estar entre valid_from e valid_until
3. Verifique os limites - Confirme que os limites global e por cliente nao foram atingidos
4. Verifique a localizacao - Se com escopo, certifique-se de que a viagem esta na subconta correta
5. Verifique o minimo - Certifique-se de que o subtotal atinge o valor minimo da viagem
6. Verifique o tipo de aplicacao - Certifique-se de que o tipo de codigo corresponde ao contexto de uso

Valor do Desconto Incorreto

1. Verifique o tipo de desconto - Calculo percentual vs fixo difere
2. Verifique o limite maximo - Descontos percentuais podem estar limitados
3. Verifique o subtotal - Desconto nao pode exceder o valor do subtotal
4. Revise a ordem de cobrança - Promocional aplica-se apos outros descontos

Cliente Diz que Codigo Ja Foi Usado

1. Verifique customer_promo_uses para seus registros de uso
2. Verifique a configuracao max_uses_per_customer
3. Procure por multiplos registros de viagem com o mesmo promocional

Contagem de Uso Parece Errada

1. uses_count e incrementado cada vez que o codigo e aplicado
2. Verifique customer_promo_uses para os registros de uso reais
3. A contagem pode diferir se houve transacoes com falha