O produto: o que é o item.
A entrada inicial: quanto você tem desse item no estoque.
Exemplo simples: Argila Verde 1kg

Vá em:

Painel da Empresa → Configurações da Agenda → Estoque → Modo Avançado

Depois abra a aba de cadastro de produto.

1. Preencha os dados do produto

Nome:

Argila Verde

Descrição:

Argila verde para tratamento facial, corporal e capilar.

Unidade base:

Como é um produto medido em peso, escolha:

Gramas (g)

Categoria:

Exemplo:

Tratamentos

Subcategoria:

Exemplo:

Argilas

Estoque mínimo:

Aqui você coloca quando o sistema deve avisar que precisa comprar mais.

Exemplo:

200

Isso significa: quando chegar em 200g, o sistema avisa que está baixo.

Estoque máximo:

Aqui você coloca até quanto deseja manter em estoque.

Exemplo:

1000

Isso significa: seu estoque ideal é 1000g, ou seja, 1kg.

2. Preencha a entrada inicial

Essa é a parte mais importante.

Como o pacote tem 1kg, mas a unidade escolhida foi gramas, você coloca:

Quantidade inicial: 1000

Porque:

1kg = 1000g

Custo total da entrada:

Se você pagou R$ 35,00 no pacote:

35,00

O sistema entende que o custo por grama é:

R$ 35,00 ÷ 1000g = R$ 0,035 por grama

Lote:

Pode colocar um código simples:

ARG-001

Validade:

Coloque a validade do produto.

Fornecedor:

Exemplo:

Distribuidora Beleza

Depois clique em:

Cadastrar produto e entrada
Como cadastrar outros produtos
Shampoo de 1 litro

Escolha unidade:

Mililitros (ml)

Quantidade inicial:

1000

Porque:

1 litro = 1000ml
Máscara de 500g

Unidade:

Gramas (g)

Quantidade inicial:

500
Tinta de cabelo por tubo

Unidade:

Unidade (un)

Quantidade inicial:

1

Ou, se comprou 10 tubos:

10
Regra fácil

Use assim:

Produto líquido → ml
Produto em pó, creme ou argila → g
Produto contado por peça → un

Exemplos:

Shampoo → ml
Oxigenada → ml
Máscara → g
Argila → g
Pó descolorante → g
Tinta em tubo → un
Luvas → un
Touca → un
Depois de cadastrar

Quando você usar esse produto em um serviço, ele será escolhido como insumo.

Exemplo:

Serviço: Limpeza facial
Produto: Argila Verde
Quantidade usada: 30g

Quando o atendimento for finalizado, o sistema baixa automaticamente:

-30g de Argila Verde

E sempre usa primeiro o lote mais antigo válido.

Quem cria

A empresa cria uma campanha de fidelidade no painel dela.

Exemplo:

• “A cada 10 cortes, ganhe 1 hidratação”
• “A cada 5 compras acima de R$ 50, ganhe 1 brinde”
• “Complete 4 sessões e ganhe 20% de desconto”

Quem enxerga

O cliente só vê cartões de fidelidade quando tem vínculo com a empresa ou quando a empresa gerou um cartão para ele.

Ele não vê automaticamente campanhas de todas as empresas do sistema.

Como o cartão nasce

O cartão pode ser criado quando:

• cliente agenda com a empresa;
• cliente compra produto;
• cliente compra pacote;
• cliente faz atendimento;
• empresa adiciona o cliente manualmente;
• cliente escaneia/entra por uma campanha pública da empresa;
• empresa concede acesso ao cliente.

Como o cliente usa

Na carteira do cliente, aparece o cartão da empresa.

Cada ação válida carimba o cartão:

• atendimento concluído;
• compra finalizada;
• sessão usada;
• pacote consumido;
• QR Code ou check-in validado.

A empresa também pode carimbar manualmente pelo scanner, se for o fluxo da recepção.

Quando o cliente ganha

Quando completa a regra da campanha, o cartão muda para status de recompensa disponível.

Exemplo:

• 10 de 10 carimbos
• status: prêmio liberado
• recompensa: “1 hidratação grátis”

Depois a empresa valida o resgate e o cartão fica como concluído.

Se a campanha acabar

Se a empresa encerrar ou deletar a campanha:

• o cliente não perde histórico;
• o cartão aparece como “campanha encerrada”, “concluído” ou “deletado”, dependendo do caso;
• ele não continua recebendo novos carimbos.

Se a empresa não tiver fidelidade no plano

Os clientes daquela empresa não veem nem recebem cartões de fidelidade dessa empresa.

A aba fidelidade da carteira do cliente pode continuar existindo, mas só mostra cartões de empresas com fidelidade ativa e vínculo com o cliente.

Resumo

Campanha é da empresa.
Cartão é do cliente.
Carimbo acontece por evento real.
Recompensa só libera quando a regra é concluída.
Cliente só vê cartões ligados a ele, não campanhas aleatórias do sistema.

A visão do cliente deve respeitar duas camadas:

1. O que o app libera globalmente
2. O que a empresa contratou no plano dela

Então, no exemplo:

A empresa comprou um plano sem Programa de Fidelidade.
Ela concedeu acesso ao cliente para logar no app.

Esse cliente deve conseguir ver normalmente:

• Início / carteira do cliente
• Agendamentos
• Histórico básico
• Empresas que ele se relaciona
• Chat/conexões, se liberado
• Vitrine/loja, se a empresa tiver
• Convênio, se ele for conveniado
• Pedidos ou pacotes, se a empresa tiver esses módulos

Mas ele não deve ver o cartão de fidelidade daquela empresa, porque a empresa não contratou fidelidade.

A regra boa é: o cliente nunca “compra” o módulo da empresa. Ele só enxerga as funções que a empresa dele tem direito de oferecer.

Exemplo prático:

• Cliente da Empresa A, que tem fidelidade: vê cartão fidelidade da Empresa A.
• Cliente da Empresa B, que não tem fidelidade: não vê fidelidade da Empresa B.
• Se ele for cliente das duas, a tela pode mostrar só os recursos da Empresa A.

O ideal é a carteira do cliente não sumir inteira. Ela deve continuar aberta, mas cada aba/card precisa verificar se existe pelo menos uma empresa vinculada com aquele módulo ativo. Se não existir, a aba fica escondida ou mostra uma mensagem elegante tipo: “Nenhuma empresa conectada oferece este recurso no momento.”

A ideia é simples: o salão cria uma campanha, o cliente escaneia um QR Code, e o sistema revela se ele ganhou algum prêmio, desconto ou benefício.

Fluxo

1. A empresa cria a campanha no painel.
2. Define os prêmios:
   • desconto em serviço;
   • brinde;
   • cashback;
   • sessão bônus;
   • produto;
   • vale-presente;
   • pontos/fidelidade.
3. Define as regras:
   • validade da campanha;
   • quantidade de prêmios disponíveis;
   • chance de ganhar;
   • limite por CPF/cliente;
   • se precisa comprar algo antes;
   • se o prêmio expira.
4. O sistema gera um QR Code da campanha.
5. A empresa imprime, coloca no balcão, envia no WhatsApp ou mostra no totem.
6. O cliente escaneia.
7. O sistema identifica o cliente.
8. O sistema sorteia conforme as regras.
9. Se ganhar, gera um voucher/cupom com código ou QR.
10. A empresa valida esse voucher no scanner do painel.

Exemplo
Campanha: “Gire e Ganhe de Aniversário”

Prêmios:

• 10 cupons de 20% de desconto;
• 5 hidratações grátis;
• 50 cupons de R$ 10;
• 100 tentativas sem prêmio.

Cliente escaneia o QR.
O sistema verifica se ele já participou.
Se ainda puder participar, sorteia.
Se ganhar, aparece: “Você ganhou 20% de desconto”.
Depois o salão valida esse prêmio no scanner.

Regras importantes

• Cada cliente só participa conforme o limite configurado.
• O prêmio precisa ter validade.
• O prêmio usado deve ficar marcado como resgatado.
• Se o cliente tentar usar de novo, o sistema bloqueia.
• O salão precisa ter relatório de:
  • quantas pessoas escanearam;
  • quantas ganharam;
  • quais prêmios foram usados;
  • quais ainda estão pendentes;
  • impacto em vendas/retorno.

Onde entra no sistema
No painel da empresa pode ficar dentro de Sorteio ou Marketing.

No cliente aparece como:

• campanha recebida;
• prêmio disponível;
• voucher para usar;
• histórico de prêmios.

Resumo
O QR Code Premiado funciona como uma campanha automática: o salão cria as regras, o cliente escaneia, o sistema sorteia e gera um prêmio validável. Isso ajuda a trazer cliente de volta e medir resultado da campanha.

Como funciona
A empresa cria um pacote e marca a opção agenda fixa. Depois escolhe em quais semanas do mês o cliente terá direito ao atendimento.

Exemplo:

• Pacote: Corte mensal masculino
• Semanas marcadas: 2ª e 4ª semana
• Dia escolhido pelo cliente: sábado
• Profissional: João
• Horário: 10:00

Então o sistema entende:

• Todo mês, na 2ª semana, sábado às 10:00, o cliente tem um horário reservado.
• Todo mês, na 4ª semana, sábado às 10:00, ele tem outro horário reservado.

O que é “semana fixa”
É a semana do mês:

• 1ª semana
• 2ª semana
• 3ª semana
• 4ª semana

Se o pacote tiver 4 sessões mensais, pode marcar 1ª, 2ª, 3ª e 4ª semana.
Se tiver 2 sessões mensais, pode marcar 2ª e 4ª semana, por exemplo.

Fluxo correto

1. A empresa cria o pacote.
2. Marca Plano de barbearia / agenda fixa.
3. Escolhe quais semanas do mês fazem parte do pacote.
4. Cliente compra o pacote.
5. Cliente escolhe dia da semana, horário e profissional.
6. O sistema gera os agendamentos recorrentes conforme as semanas escolhidas.
7. A cada sessão usada, o pacote dá baixa.
8. Se acabar o pacote ou vencer a validade, para de gerar/permitir uso.

Exemplo prático
Cliente compra pacote de 4 cortes no mês.

Configuração:

• Semanas: 1ª, 2ª, 3ª e 4ª
• Dia: sexta-feira
• Horário: 18:00

Resultado:
O cliente fica com corte reservado toda sexta correspondente às semanas marcadas daquele mês.

Importante
Esse modelo é diferente de pacote comum.
No pacote comum, o cliente usa quando quiser.
No pacote com semana fixa, o sistema já prende uma rotina de atendimento na agenda.

Fluxo ideal

1. O dono do salão entra no painel da empresa.
2. Ele conecta a própria conta de pagamento dele, por exemplo Mercado Pago.
3. O gateway valida a conta, documentos e dados bancários.
4. Quando o cliente compra produto, serviço, pacote ou agenda algo que é 100% da empresa, o pagamento cai no checkout ligado à conta da empresa.
5. O dinheiro vai para a conta Mercado Pago/Asaas/etc da empresa.
6. Depois a própria empresa saca para o banco dela pelo gateway.

O que passa pelo checkout da empresa

• Serviços do salão.
• Produtos da loja da empresa.
• Pacotes da empresa.
• Agendamentos pagos diretamente para a empresa.
• Vendas normais que não são receita do aplicativo.

O que passa pelo checkout do Hora Beauty

• Assinatura do sistema.
• Créditos de busca de horário.
• Créditos de proposta.
• Marketing pago.
• Propaganda no totem.
• Marketplace quando o sistema cobra comissão.
• Convênio de Beleza.
• Afiliados, porque precisa dividir entre afiliado, empresa e sistema.

Como a empresa recebe dos próprios clientes
Existem duas formas boas:

Opção 1: Conta conectada no gateway
Essa é a melhor e mais profissional.

A empresa conecta a conta Mercado Pago dela no painel. Quando o cliente paga, o checkout já sabe que aquele pagamento pertence à empresa. O sistema cria a cobrança, mas o recebedor é a empresa.

Opção 2: Carteira interna
O cliente paga no checkout do sistema, o saldo entra na carteira da empresa dentro do Hora Beauty, e depois a empresa pede saque. Essa opção é boa para convênio, afiliados e comissões, mas para vendas normais dá mais responsabilidade financeira para o sistema.

Minha recomendação:

• Venda normal da empresa: checkout conectado da própria empresa.
• Venda com divisão, afiliado, convênio ou comissão do app: checkout do Hora Beauty + carteira/split controlado.

Resumo simples
O salão vai cobrar o cliente pelo sistema, mas o dinheiro pode cair direto na conta de pagamento do próprio salão quando for venda normal. O Hora Beauty só fica no meio quando existir comissão, assinatura, crédito, afiliado, convênio ou alguma taxa do app.

### Quem pode ser afiliado?

Clientes e profissionais podem usar a área Renda Extra para se afiliar a produtos, serviços e pacotes liberados pelas empresas.

### O que a empresa precisa fazer?

A empresa precisa aceitar os termos de afiliados e ligar a chave Aceitar Afiliados.

Depois disso, os itens que podem receber afiliados ficam disponíveis no portal, desde que estejam configurados para aceitar comissão de afiliado.

Itens aceitos:

– Produtos da loja.
– Pacotes.
– Serviços da tabela inteligente.

### Como o afiliado pega um produto e envia o link?

1. O afiliado entra em Renda Extra.
2. O sistema mostra produtos, serviços e pacotes disponíveis.
3. O afiliado escolhe um item.
4. Clica em Gerar meu link.
5. O sistema cria um link único com o código do afiliado.
6. O afiliado copia o link e envia para WhatsApp, Instagram, grupos ou qualquer canal de divulgação.

O link segue o padrão:

“`text
/vitrine/nome-da-empresa?aff=CODIGO_DO_AFILIADO
“`

### Por que a venda do afiliado precisa passar pelo checkout do sistema?

Sim, você está certo: toda venda feita por link de afiliado deve passar pelo checkout do sistema.

Motivo: o sistema precisa controlar o rastreio e o rateio da venda.

Se a venda for paga direto no checkout externo da empresa, o Hora Beauty não consegue garantir:

– Quem foi o afiliado da venda.
– Qual produto, serviço ou pacote foi vendido.
– Quanto a empresa deve receber.
– Quanto o afiliado deve receber.
– Quanto o sistema deve reter.
– Se a comissão foi registrada corretamente.

Por isso, venda de afiliado é receita processada pelo checkout do sistema. Depois da aprovação do pagamento, o sistema registra e divide os valores na carteira.

### Como o sistema paga cada parte?

Depois que o pagamento é aprovado pelo Mercado Pago, o webhook do sistema processa a venda de afiliado.

O rateio esperado é:

– Afiliado: recebe a comissão configurada para o item.
– Empresa: recebe a parte da empresa na carteira.
– Sistema Hora Beauty: recebe a taxa configurada do sistema.

Esses valores entram como registro de carteira/relatório. A empresa e o afiliado podem acompanhar os valores nas áreas correspondentes.

### Onde cada parte acompanha?

Afiliado:

– Renda Extra.
– Links ativos.
– Acessos.
– Conversões.
– Ganhos.
– Histórico de vendas.

Empresa:

– Relatório de Afiliados na carteira da empresa.
– Vendas filtradas por produto, serviço e pacote.
– Valor da empresa.
– Comissão do afiliado.
– Parte do sistema.

Admin:

– Aba Afiliados.
– Configuração dos termos.
– Percentual padrão do afiliado.
– Percentual padrão do sistema.
– Lista de afiliados.
– Empresas participantes.
– Links criados.
– Vendas geradas.

## 3. Regra principal para não quebrar o financeiro

Tudo que for venda comum da empresa pode ir para o checkout da empresa, conforme a regra financeira definida.

Mas tudo que for venda por afiliado deve ir para o checkout do sistema, porque o sistema é quem faz o controle do link, da comissão e do rateio.

Essa é a forma correta para manter rastreio, auditoria e pagamento seguro sem depender de conferência manual.

Este documento explica, em linguagem de regra de negócio, como devem funcionar a lista de espera automática e o sistema de afiliados do Hora Beauty.

## 1. Lista de Espera Automática

### Por que existem dois campos de horário?

Na lista de espera existem dois campos de horário porque eles representam uma janela de preferência do cliente:

– Horário inicial: a partir de que hora o cliente aceita ser encaixado.
– Horário final: até que hora o cliente aceita ser encaixado.

Exemplo: se o cliente informa 14:00 até 17:00, ele aceita receber aviso apenas para vagas que abram dentro desse período. Isso evita oferecer um horário fora da disponibilidade real do cliente.

### Campos principais

– Nome do cliente: identifica quem está esperando vaga.
– WhatsApp: canal usado para aviso e confirmação.
– Serviço: serviço desejado pelo cliente.
– Profissional escolhido: profissional obrigatório para o match automático.
– Data preferida: dia em que o cliente quer atendimento.
– Horário inicial: começo da janela aceita pelo cliente.
– Horário final: fim da janela aceita pelo cliente.
– Observação: informação extra para a empresa.

### Critério de compatibilidade

O sistema só deve avisar um cliente quando a vaga aberta for compatível com:

– Mesma empresa/salão.
– Mesma data escolhida.
– Horário dentro da janela informada.
– Mesmo profissional escolhido.
– Serviço compatível, quando o serviço estiver preenchido.

Se qualquer uma dessas informações não bater, o cliente não deve receber o convite.

### Ordem da fila

A fila respeita a ordem de entrada. Quem entrou primeiro tem prioridade.

Quando uma vaga abre, o sistema procura o primeiro cliente apto. Se ele não confirmar, a vaga passa para o próximo cliente apto.

### Tempo de confirmação

Fluxo normal:

– O primeiro cliente apto recebe o link.
– O link fica válido por 20 minutos.
– Se confirmar dentro do prazo, a vaga vira agendamento.
– Se recusar ou não responder, o link expira e o sistema chama o próximo cliente.

Cancelamento de última hora:

– Se a vaga abrir faltando menos de 2 horas para o atendimento, o sistema avisa os 3 primeiros clientes aptos ao mesmo tempo.
– Quem confirmar primeiro fica com a vaga.
– Os outros links são invalidados.

### Restrição de horário

O sistema não deve enviar avisos automáticos entre 20:00 e 08:00.

Se uma vaga abrir durante esse período, o disparo deve ficar agendado para 08:00.

### Cliente que ignora ou recusa muitas vezes

Se o cliente recusar ou deixar expirar 3 convites no mesmo mês, ele deve ser removido das filas ativas para evitar mensagens incômodas.

Depois disso, ele pode entrar novamente na fila quando quiser.

1. No painel do salão, vá em Configurações (a engrenagem no topo).
2. Abra a seção Equipe / Profissionais.
3. Cadastre um novo profissional ou edite um existente (ícone de lápis ).
4. Rolando o formulário do profissional, tem a seção “Comissão mista (por categoria)” com o botão “+ Adicionar regra por categoria”.

Lá você monta cada regra: Categoria + % de comissão + checkbox “Descontar taxas” (que abre os campos de taxa cartão/sistema/custo).

Depois, ela é usada automaticamente quando você conclui um atendimento: na Agenda → Grelha, clica no card do horário → “ Concluir Atendimento”. O sistema pega a regra da categoria daquele serviço, calcula e joga o resultado na aba Financeiro → Comissões (parte do salão / parte do profissional).

Deixa eu confirmar no código o caminho exato da seção, pra te dar certeza.

Confirmando onde está a UI de comissão mista”

Confirmando onde está a UI de comissão mista”

Confirmado no código. A seção “Comissão mista (por categoria)” existe no formulário do profissional (linha 6594).

Caminho exato:

1. Painel do salão → Configurações ().
2. Equipe / Profissionais.
3. Novo profissional (ou editar um existente).
4. Rola o formulário até “Comissão mista (por categoria)” → “+ Adicionar regra por categoria”.

Monta as regras (ex.: Química 50% sem taxa / Corte 60% descontando cartão), salva o profissional.

Depois, pra usar: Agenda → Grelha → clica no card do atendimento → “ Concluir Atendimento” → o resultado aparece em Financeiro → Comissões.

Dois pré-requisitos pro cálculo funcionar (já comentei antes): o serviço precisa ter categoria e o profissional precisa ter uma regra pra essa categoria (senão usa a % padrão dele, sem taxas).