Pular para o conteúdo

Para equipe ilarika

Produtos, preços e cupons: o catálogo do que a iLarika vende

  • Super AdminProdutos, preços e cupons
  • Super AdminPlanos e recursos (atalho "Definir preço"/"Trocar preço" em cada plano)

Um produto é o que aparece na vitrine e na fatura; um preço é quanto custa e com que frequência; um cupom é um desconto no checkout. Os recursos de cada plano continuam em Planos e recursos: aqui fica só o lado comercial.

Antes de começar

  • Criar ou alterar pede a área Assinaturas e cobrança com ver e mudar; quem só vê a área consulta (Time iLarika).
  • Um produto do tipo plano precisa apontar para um plano da plataforma (um para um). Crie o plano em Planos e recursos primeiro.

Os três tipos

Tipo O que é Preço
Plano O que a loja assina. Os recursos vêm do plano da plataforma. Mensal e/ou anual, com dias de teste opcionais (0 a 90).
Add-on Soma um recurso ao plano: mais mesas, um recurso ligado. Hoje não há add-on à venda (só o interno de excedente de IA). Recorrente (mês ou ano).
Pacote de créditos Atendimentos de IA avulsos. Compra única.

Add-on só concede chaves do catálogo de capacidades: booleano só liga (true), número soma ao limite do plano. Chave essencial (toda loja já tem) é recusada.

Onde fica o preço

O quadro Preços, no topo de Super Admin › Produtos, preços e cupons, tem uma linha por produto: mensal e anual de cada plano e add-on (o anual mostra o equivalente por mês e o desconto sobre 12× o mensal) e a compra única de cada pacote. Produto sem preço ativo aparece com a marca Sem preço — ele não aparece para assinar nem comprar.

Em Planos e recursos, embaixo do preço de cada plano, o atalho Definir preço / Trocar preço abre a mesma folha já no produto daquele plano.

Passo a passo

  1. Novo produto: tipo, nome, slug (vai no link de assinar), descrição, e o plano da plataforma (plano), as concessões (add-on) ou a quantidade de atendimentos (pacote). “Na vitrine” decide se aparece na landing e no checkout. Em plano, Sob consulta (sem checkout) mostra o plano na página de parceiros sem preço e com “Fale com a gente” (WhatsApp do suporte da plataforma), e o checkout o recusa — é o caso da Rede. Fica em metadata.sobConsulta; o resto do metadata não é mexido.
  2. Definir preço (no quadro Preços ou no cartão do produto): mensal e anual lado a lado, em reais, e os dias de teste (0 a 90, valem nos dois ciclos). Pacote tem só “Compra única”. Campo vazio não oferece aquele ciclo.
  3. Trocar preço: a mesma folha, já com os valores atuais. Só o ciclo que mudou é trocado: o servidor cria o preço novo e desativa o antigo numa transação só, e grava na auditoria quem trocou, quando, o valor antigo, o novo e quantas assinaturas estavam no antigo (billing.price.replaced).
  4. Editar um preço da lista muda dias de teste; Desativar/Ativar tira ou devolve o preço à venda.
  5. Novo cupom: código (vira maiúsculo), Percentual ou Valor fixo, Duração (Só na primeira fatura, Por algumas faturas ou Para sempre), Limite de usos e Válido até. Salvar cupom.

Regras que a tela faz valer

  • Preço com assinatura viva não muda de valor nem de intervalo. Quem já paga continua pagando o que combinou. “Trocar preço” faz o certo sozinho: cria o novo e desativa o antigo; novas assinaturas, a vitrine (GET /public/planos) e o checkout pegam o novo na hora.
  • Produto com assinatura ativa não é arquivado; arquivar tira da vitrine e mantém o histórico.
  • Slug de produto é único; só pode haver um produto por plano da plataforma.

O que acontece depois

  • A landing e o checkout leem os produtos públicos com preço ativo.
  • A fatura usa o nome do produto e o valor do preço no momento da emissão.
  • O preço que aparece em Planos e recursos é o do produto; o campo antigo do plano é só legado.

O catálogo de 27/10/2026

A migração 20261027180000_planos_starter_essencial_pro_rede deixou assim (reaproveitando os produtos pelo slug, preço novo ativo e o antigo inativo, como o “Trocar preço”):

Produto (slug) Mensal Anual Teste
Starter (starter) R$ 119,90 R$ 1.188,00 (R$ 99/mês) 7 dias
Essencial (essential) — destaque R$ 179,90 R$ 1.798,80 (R$ 149,90/mês) 7 dias
Pro (pro) R$ 299,90 R$ 2.998,80 (R$ 249,90/mês) 7 dias
Rede (enterprise) sob consulta sob consulta —
100 atendimentos de IA (ia-100) R$ 49,90 (compra única)
300 atendimentos de IA (ia-300) R$ 129,90 (compra única)

free e complete saíram da vitrine (arquivados só se ninguém assina). O teste de 7 dias só vale com cartão e com a cobrança ligada (assinar.md).

Perguntas comuns

Quero subir o preço do Pro. Quadro Preços › linha Pro › Trocar preço, mude o mensal (e/ou o anual) e salve. Assinaturas existentes continuam no valor antigo até trocarem de plano ou de ciclo.

Quanto de desconto o anual dá? A folha mostra ao digitar: “Anual equivale a R$ X/mês · Y% de desconto sobre 12× o mensal”. O ciclo anual cobra uma vez por ano (período de 12 meses).

Cupom para um afiliado? Não precisa criar: todo afiliado ganha o cupom dele sozinho (o código em maiúsculas, sem desconto: só registra a indicação), e ele aparece na lista de Cupons. Veja afiliados.

O cupom dá desconto na fatura? Não: o cupom chega ao checkout pelo endereço (?cupom=) e serve para registrar quem indicou. Nenhuma fatura aplica desconto de cupom, e a coluna Usos fica em zero. O cupom do afiliado nasce com valor zero de propósito.