A aba Períodos em Comissões organiza os pagamentos de comissão em lotes fechados — chamados de ciclos (ou "folhas"). Cada ciclo agrupa as comissões de um intervalo de datas, passa por uma progressão de estados e é pago de uma só vez.
Com o extrato do profissional ativo, os ciclos ficam somente para consulta
Se o seu plano inclui o extrato do profissional (saldo contínuo), o pagamento passou a ser
feito pelo saldo de cada profissional, e não mais por ciclo. Nesse caso, o botão Pagar
ciclo fica indisponível e o painel do ciclo exibe a observação de que o acerto agora é
pelo extrato. Os ciclos existentes permanecem visíveis — você ainda cria, bloqueia, vê a
prévia e exporta a folha — apenas o pagamento em lote sai de cena para evitar pagar duas
vezes (uma pelo ciclo, outra pelo extrato). Para pagar, veja Pagar um profissional pelo
extrato.
Antes de começar
Você precisa de acesso de administrador do negócio.
Comissões só entram num ciclo depois que as reservas são marcadas como Concluído.
Para bloquear um ciclo, todos os caixas do período devem estar fechados.
Os ciclos organizam o pagamento em lote — tudo de uma vez, com um método e uma observação
registrados. Para pagar comissões individuais fora de um ciclo, use o botão Ver na tabela de
profissionais da Visão geral e marque cada comissão no ledger individual. As duas abordagens são
complementares, não excludentes.
O que é um ciclo de pagamento
Um ciclo é um lote de comissões delimitado por um intervalo de datas. Ao criar um ciclo, o sistema atribui automaticamente todas as comissões pendentes dentro daquele intervalo. Um ciclo passa pelo seguinte caminho:
| Estado do sistema | Label visível | O que significa |
| ----------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| OPEN | Acumulando (◷ cinza) | O ciclo está aberto e ainda recebendo comissões à medida que os atendimentos são concluídos. |
| CLOSED | Bloqueado (● âmbar) | O ciclo foi fechado. Os valores estão congelados e definitivos — prontos para pagamento. |
| — (efêmero) | Processando… | Indicação transitória exibida enquanto a operação de pagamento está em andamento. Desaparece sozinha. |
| PAID | Pago (✓ verde) | Todas as comissões foram pagas. |
| PAID + janela passada | Arquivado (✓ verde) | Ciclo pago cujo período de datas já encerrou. Fica oculto na seção recolhida Ciclos arquivados para não poluir a lista. |
Os estados do sistema são três — os labels são cinco
O sistema persiste apenas OPEN, CLOSED e PAID. Os labels Acumulando, Bloqueado,
Processando, Pago e Arquivado são derivações visuais que facilitam a leitura do
ciclo de vida — nenhum comportamento muda com base neles. Reabrir e atribuir manualmente
comissões a um ciclo estão previstos para uma fase futura e não estão disponíveis ainda.
Criar um novo ciclo
Em Comissões, toque na aba Períodos.
Toque em Novo ciclo (canto superior direito).
Preencha o Nome do período (ex.: "Janeiro 2026"), a Data inicial e a Data final.
Toque em Criar. O sistema atribui automaticamente todas as comissões pendentes dentro do
intervalo. Uma notificação confirma quantas comissões foram atribuídas.
Ciclo ativo e lista de ciclos
A página tem dois blocos: Ciclo ativo (o primeiro ciclo não pago — aberto ou bloqueado —
destacado com borda primária e exposto em maior detalhe) e Todos os ciclos (os demais, em
cards compactos). Ciclos pagos e arquivados aparecem recolhidos no final da lista sob o botão
Ciclos arquivados (N).
Acerto automático (fechamento por cadência)
Em vez de criar e bloquear cada ciclo na mão, você pode ligar o acerto automático: o sistema cria e bloqueia as folhas sozinho, na frequência que você escolher. O pagamento continua manual — nada sai da sua conta automaticamente.
A configuração fica em Comissões → Configuração, no primeiro card (Acerto automático de comissões).
Em Comissões, abra a aba Configuração.
No card Acerto automático de comissões, ligue a chave Automático.
Escolha a frequência: Semanal (escolha o dia do acerto), Quinzenal (fecha nos dias 1 e
16 do calendário) ou Mensal (escolha o dia do mês).
Defina o prazo de fechamento — quantos dias após o fim do período o sistema espera antes de
fechar (padrão 2 dias), dando tempo de fechar os caixas e lançar atendimentos atrasados.
Toque em Salvar.
Fechar não é pagar
O acerto automático cria e bloqueia as folhas — nunca paga. As comissões entram no saldo a
pagar de cada profissional, e você faz o pagamento quando quiser (pelo Pagar ciclo ou, com o
extrato ativo, pelo repasse do profissional). Nada sai da sua conta sozinho.
O que acontece ao ligar (folhas anteriores)
Se, ao ligar a automação, houver comissões antigas fora de qualquer folha, aparece a janela
Organizar folhas anteriores: ela lista os períodos que faltam, quantas comissões cada um tem e
o pote estimado. Você confirma e o sistema cria (e fecha, se você deixar marcado) essas folhas
retroativas de uma vez. Também é só organização — não paga ninguém.
Caixa aberto adia o fechamento automático
O fechamento automático respeita a mesma regra do manual: se um caixa do período ainda estiver
aberto, a folha não fecha e você recebe um aviso ("acerto adiado — feche o caixa de tal dia").
Assim que o caixa fecha, o sistema fecha a folha sozinho na próxima verificação. Se você usa
fechamento de caixa manual, ligue também o fechamento de caixa automático para o acerto
fluir sem intervenção.
Negócios novos já vêm com acerto mensal
Toda barbearia criada agora nasce com o acerto automático mensal ligado — não precisa
configurar nada para as comissões de assinatura começarem a fechar sozinhas. Você pode trocar a
frequência ou voltar para manual quando quiser, em Comissões → Configuração.
Como reconhecer uma folha automática na lista
Na aba Períodos, uma folha criada pela automação mostra um selo ⚙ Auto ao lado do estado. Enquanto está aberta, exibe a contagem "Fecha em N dias" (a data do fechamento automático). Se o fechamento estiver adiado por um caixa aberto, aparece uma faixa âmbar "Fechamento adiado" — feche o caixa indicado para liberar. Quando a folha fecha sozinha, você recebe uma notificação "Folha fechada — R$ X pronto para pagar", e cada barbeiro recebe o recibo do pote (N fichas × valor = total).
"R$ X está parado" — o aviso de comissão presa
Se o seu negócio tem assinaturas gerando pote mas nenhuma folha fechada cobrindo esse período, a Visão geral de Comissões mostra um card roxo: "R$ X em comissão de assinatura dos seus barbeiros está parado." Toque em Organizar e ativar para, de uma vez, ligar o acerto automático e abrir a janela de folhas retroativas (a mesma da seção acima). É só organização — não paga ninguém.
O card do ciclo ativo
O card expandido do ciclo ativo exibe:
Nome e intervalo de datas do ciclo.
Pill de estado (Acumulando / Bloqueado / Pago / Arquivado).
Três métricas lado a lado: Total (soma de todas as comissões do ciclo), Pago (já quitado) e Pendente (ainda não pago).
Quantidade de comissões atribuídas ao ciclo.
Barra de progresso de pagamento com o percentual já pago.
Ação primária — varia conforme o estado (ver seções abaixo).
Bloquear congela os valores do ciclo e é o passo obrigatório antes de pagar.
No card do ciclo Acumulando, toque em Bloquear ciclo.
Leia a confirmação: "Isso bloqueia o período e impede que novas comissões sejam atribuídas.
Todos os caixas do período devem estar fechados."
Toque em Fechar Período para confirmar.
Caixas abertos bloqueiam o bloqueio
Se houver caixas ainda abertos dentro do período do ciclo, o sistema recusa o bloqueio com um
erro. Feche todos os caixas do período antes de bloquear. Para fechar um caixa, vá em Caixa
no menu lateral.
O que o bloqueio faz nos bastidores
O bloqueio executa o serviço closePoolForPeriodByOwner, que emite o pote de assinaturas
(fixando definitivamente a distribuição das fichas acumuladas no período) e congela os valores
de todas as comissões do ciclo. Depois do bloqueio, nenhuma nova comissão pode ser atribuída ao
ciclo — o número de comissões e o total ficam definitivos.
Prévia da folha (Quem recebe o quê)
A prévia é uma visão de leitura que mostra o valor a receber por cada profissional no ciclo, com a quebra por origem das comissões. Ela serve como gate de confiança antes de bloquear ou pagar — você confere que os valores estão certos antes de qualquer ação irreversível.
Chips de origem abaixo do nome: serviço (azul), assinatura (roxo), misto, produto e pote — mostrando de onde vem cada real.
Estimativa do pote (apenas em ciclos Acumulando): linha tracejada com o valor estimado do pote de assinaturas, marcado como "Estimado" porque ainda pode mudar até o bloqueio.
Total geral do ciclo na linha de rodapé.
A prévia é somente leitura
A prévia não executa nenhuma ação — é uma conferência. O pagamento acontece pelo botão Pagar
ciclo no card ou no painel de detalhes, não dentro da prévia.
Pagar o ciclo (Pagar ciclo)
O pagamento só fica disponível depois que o ciclo está Bloqueado.
No card do ciclo Bloqueado, toque em Pagar ciclo.
No diálogo de acerto, escolha o Método de pagamento: Dinheiro, PIX ou
Transferência bancária.
Adicione Observações opcionais (ex.: "Transferência referente a Jan/26 — comprovante enviado
por e-mail").
Toque em Pagar. Todas as comissões pendentes do ciclo são marcadas como pagas em uma única
operação — o método e as observações ficam registrados em cada uma delas e no próprio ciclo.
Pagamento é tudo-ou-nada
O sistema paga todas as comissões pendentes do ciclo de uma vez. Não é possível pagar parte
das comissões pelo fluxo de ciclo — se precisar pagar individualmente, use o ledger individual
do profissional. O pagamento é idempotente: se algo falhar no meio e você repetir, comissões
já pagas não são pagas duas vezes.
Pague pelo assistente, com confirmação
Você também pode pedir ao assistente: "pagar a folha de janeiro" ou "paga o ciclo de
comissões". Como é dinheiro saindo, ele mostra primeiro um resumo (quantidade de comissões
e total) e só efetua depois que você confirma. O ciclo precisa estar Bloqueado antes — o
assistente não paga ciclos Acumulando.
Painel de detalhes do ciclo
Toque em Detalhes em qualquer card (ou Ver recibo em ciclos já pagos) para abrir o painel lateral com:
Nome, estado e intervalo do ciclo no cabeçalho.
Quantidade de comissões atribuídas.
Prévia da folha — "Quem recebe o quê" (ver seção acima).
Atividade — linha do tempo de auditoria imutável com cada evento do ciclo: Criado, Bloqueado, Pago (com data, horário e ator). Substitui logs manuais e dá rastreabilidade completa.
Ações de rodapé: Exportar folha (CSV), Bloquear (se Acumulando) ou Pagar ciclo (se Bloqueado).
Reabrir ciclo não está disponível
O botão Reabrir aparece no painel mas está desativado — a funcionalidade de reabrir um
ciclo bloqueado ou pago está prevista para uma fase futura e ainda não foi implementada. Se
precisar corrigir comissões num ciclo fechado, use o ledger individual do profissional para
ajustes pontuais.
Exportar a folha em CSV
Abra o painel de detalhes do ciclo (botão Detalhes no card).
Toque em Exportar folha no rodapé do painel.
O arquivo CSV é gerado e baixado no dispositivo. O nome do arquivo segue o padrão
payroll-<nome-do-ciclo>.csv.
O CSV contém uma linha por profissional com as colunas: nome, total, pago, pendente, quantidade de comissões e os cinco buckets de origem (serviço, assinatura, misto, produto, pote).
Ciclos arquivados
Ciclos pagos cujo período já encerrou ficam ocultos na seção recolhida Ciclos arquivados (N) no final da lista. Toque no botão para expandir e ver os ciclos mais antigos. Eles são somente leitura — você pode abrir os detalhes e exportar, mas não pagar ou bloquear.
Pote de assinaturas
Para acompanhar a estimativa do pote em tempo real durante o ciclo, toque em Pote de assinaturas no canto superior da página. Para o detalhamento completo do modelo de comissão por fichas, veja
Comissão por fichas (pote).
Perguntas frequentes
Posso ter mais de um ciclo aberto ao mesmo tempo?
Sim. Você pode criar vários ciclos com intervalos diferentes — por exemplo, um quinzenal por equipe. O sistema exibe o primeiro ciclo não pago como "Ciclo ativo" e lista os demais abaixo.
O que acontece se eu criar um ciclo com datas que se sobrepõem a outro?
O sistema recusa — não é possível criar um ciclo cujo intervalo se sobreponha (mesmo parcialmente) a um ciclo existente. Isso evita que o mesmo faturamento de assinatura seja distribuído duas vezes no pote. Escolha datas que não colidam com nenhum ciclo já criado.
Posso editar o nome ou as datas de um ciclo depois de criado?
Não — o nome e o intervalo de datas são definidos na criação e não podem ser alterados depois. Se errou, exclua o ciclo (se ainda não há comissões atribuídas) e crie um novo.
O que acontece com as comissões do ciclo se eu fechar um caixa depois do bloqueio?
Depois do bloqueio, nenhuma nova comissão pode entrar no ciclo — o fechamento de caixa posterior não altera os valores. As comissões geradas por esse caixa ficarão sem ciclo até você criar ou atribuir um novo ciclo.
O assistente consegue criar ou bloquear ciclos?
Sim. O assistente consegue criar um ciclo ("abrir a folha de julho"), bloquear um ciclo aberto ("fechar a folha de julho" — com confirmação, porque trava o pote), pagar um ciclo já bloqueado (também com confirmação, porque é dinheiro saindo) e organizar folhas retroativas ("organizar as folhas anteriores" — cria e fecha os períodos que faltam para liberar o pote parado, com confirmação).
Reabrir um ciclo bloqueado está disponível?
Não ainda. O botão Reabrir aparece no painel de detalhes mas está desativado. A funcionalidade está prevista para uma fase futura.
