Modelo de Preços
O sistema de preços da Labanana é baseado em três níveis: custo de produção, taxa da plataforma e margem do artista.
Estrutura
| Nível | Quem define | Campo |
|---|---|---|
| ProductType | Admin | platformFeePercent, artistRoyaltyPercent |
| ProductVariant | Admin | baseCostCents (custo de produção) |
| SellerProductVariant | Seller | priceCents (preço final de venda) |
:::info Percentuais são configuráveis por ProductType
platformFeePercent e artistRoyaltyPercent não são valores globais — cada ProductType tem os seus. Nos exemplos abaixo usamos 15% / 30% (valores típicos hoje), mas canecas, camisetas e posters podem ter percentuais diferentes conforme a estratégia comercial.
:::
Exemplo prático — Caneca a R$ 49,90 (fee 15%, royalty 30%)
Fórmulas
platform_fee = price_cents × platform_fee_percent ÷ 100
margem = price_cents − base_cost_cents − platform_fee
artist_royalty = margem × artist_royalty_percent ÷ 100
labanana_profit = margem − artist_royalty
| Etapa | Cálculo | Valor | Para quem |
|---|---|---|---|
| Preço de venda | — | R$ 49,90 | — |
| Custo de produção | fixo por variante | - R$ 15,00 | Fornecedor |
| Taxa plataforma | 4990 × 15% | - R$ 7,49 | Operacional |
| Margem | 4990 - 1500 - 749 | R$ 27,41 | — |
| Royalty artista | 2741 × 30% | R$ 8,22 | Artista |
| Lucro Labanana | 2741 - 822 | R$ 19,19 | Labanana |
Regras
:::warning Preço mínimo
O preço definido pelo seller deve ser maior que baseCostCents + platformFee. Se o seller tentar um preço abaixo disso, a API retorna erro 400.
:::
:::info Valores em centavos Todos os valores monetários são em centavos (inteiros). Nunca use Decimal/float.
Para exibir: (priceCents / 100).toFixed(2)
:::
No frontend
O preço é fixo por SKU (priceCents):
- Trocar assets (tamanho, acabamento) → troca de SKU → muda o preço
- Trocar options (cor) → NÃO muda o preço — só muda a imagem
minPriceCents: menor priceCents entre SKUs ativos
maxPriceCents: maior priceCents entre SKUs ativos
O frontend deve exibir: "A partir de R$ X" quando há múltiplos preços, ou o preço direto quando todos são iguais.