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
- 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. - 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.
- 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). - Editar um preço da lista muda dias de teste; Desativar/Ativar tira ou devolve o preço à venda.
- 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.
