# Folha de pagamento — ciclos e pagamento em lote

Fonte: https://docs.barbeiro.app/business-admin/commissions/payroll-periods
Perfil: Administrador
Verificado em: 2026-08-21

As **Folhas de pagamento** em **Comissões** (na aba **Pagar**, atalho **Folhas de pagamento →**) organizam 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](business-admin/commissions/professional-payout).

## 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**.
-   Um ciclo só pode ser **pago** depois de **bloqueado**.

> **Ciclos e o ledger individual**
>
> 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:

| O que aparece na tela    | O que significa                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Acumulando** (◷ cinza) | O ciclo está aberto e ainda recebendo comissões à medida que os atendimentos são concluídos.                                |
| **Bloqueado** (● âmbar)  | O ciclo foi fechado. Os valores estão congelados e definitivos — prontos para pagamento.                                    |
| **Processando…**         | Aparece só enquanto o pagamento está sendo feito. Some sozinho.                                                             |
| **Pago** (✓ verde)       | Todas as comissões foram pagas.                                                                                             |
| **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. |

> **Um ciclo só anda para a frente**
>
> Acumulando → Bloqueado → Pago é o caminho, e ele não volta. **Reabrir um ciclo** e **mover uma
> comissão de um ciclo para outro** ainda não existem — confira o período antes de bloquear.

## Criar um novo ciclo

1. Em **Comissões**, na aba **Pagar**, toque em **Folhas de pagamento →**.

2. Toque em **Nova folha** (canto superior direito).

3. Preencha o **Nome do período** (ex.: "Janeiro 2026"), a **Data inicial** e a **Data final**.

4. 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.

> **Como a tela está organizada**
>
> A página tem três blocos. No topo, **Folha atual** — a folha em que a barbearia está vivendo
> agora (a primeira não paga), com o total, quanto já saiu, o bolão incluído e uma barra de
> progresso do pagamento. Abaixo, **Folhas anteriores**, com a folha **fechada e não paga**
> sempre em primeiro lugar (é a única que ainda custa dinheiro a alguém) e as demais em uma linha
> cada. Ao selecionar qualquer folha, abre-se à direita o painel **quem recebe o quê**.
>
> Folhas mais antigas ficam recolhidas atrás de **Ver folhas mais antigas** no fim da lista.

## 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**).

1. Em **Comissões**, abra a aba **Configuração**.

2. No card **Acerto automático de comissões**, ligue a chave **Automático**.

3. 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).

4. 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.

5. 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 lista de **Folhas de pagamento**, 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).
-   Botão **Ver quem recebe e pagar** — abre o [painel quem recebe o quê](#painel-quem-recebe-o-quê).

## Fechar a folha (Fechar folha)

Bloquear congela os valores do ciclo e é o passo obrigatório antes de pagar.

1. No cartão **Folha atual**, toque em **Fechar folha**.

2. 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."_

3. 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**
>
> Bloquear fecha o **pote de assinaturas** do período — a divisão das fichas acumuladas fica
> definitiva — e congela o valor de todas as comissões do ciclo. Depois disso nenhuma comissão
> nova entra: a quantidade e o total viram números finais.

## Painel 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.

O painel abre à direita ao tocar em **Ver quem recebe e pagar** (na folha atual) ou em **Abrir** (em qualquer folha anterior). É a conferência que se faz antes de mandar o dinheiro, então cada linha mostra **de onde veio** o valor daquela pessoa — serviço, assinatura, produto, bolão — e não só o total. O que você vê:

-   **Uma linha por profissional** com o total a receber.
-   **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 a folha

O pagamento só fica disponível depois que o ciclo está **Bloqueado**.

1. Na folha **fechada e não paga**, toque em **Pagar** (ou **Pagar os N** dentro do painel).

2. No diálogo de acerto, escolha o **Método de pagamento**: **Dinheiro**, **PIX** ou
   **Transferência bancária**.

3. Adicione **Observações** opcionais (ex.: "Transferência referente a Jan/26 — comprovante enviado
   por e-mail").

4. 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 a conta do
> profissional. Repetir o pagamento é seguro: se algo falhar no meio e você tentar de novo,
> 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 **Ver quem recebe e pagar** ou em **Abrir** para abrir o painel lateral com:

-   **Nome, estado e intervalo** do ciclo no cabeçalho.
-   **Quantidade de comissões** atribuídas.
-   **Quem recebe o quê** — uma linha por profissional com a origem do valor, mais a linha do **Bolão das assinaturas** marcada como provisória e o **Total** no pé.
-   **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é**: **Reabrir folha** (indisponível — ver abaixo), **Exportar folha** (CSV) e **Pagar os N** quando a folha está fechada e ainda tem valor em aberto.

> **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

1. Abra o painel da folha (**Ver quem recebe e pagar** ou **Abrir**).

2. Toque em **Exportar folha** no rodapé do painel.

3. 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).

## Folhas mais antigas

As folhas além das três mais recentes ficam ocultas atrás de **Ver folhas mais antigas** no fim da lista. Toque para expandir. Folhas já pagas são somente leitura — você pode abrir o painel e exportar, mas não pagar nem fechar de novo.

## 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)](business-admin/commissions/pool-by-points).

## Perguntas frequentes

**Posso ter mais de um ciclo aberto ao mesmo tempo?**
Sim. Você pode criar várias folhas com intervalos diferentes — por exemplo, uma quinzenal por equipe. O sistema exibe a primeira folha não paga como **Folha atual** e lista as 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.

**Quando devo gerar o pagamento?**
Depende do seu acordo com a equipe: semanal, quinzenal ou mensal. O sistema permite qualquer frequência — o importante é fechar o período depois de pagar para não contar duas vezes.

## Leia também

- [Comissões: por onde começar](https://docs.barbeiro.app/business-admin/commissions/commission-overview)
- [Ledger individual do profissional — extrato e pagamento de comissões](https://docs.barbeiro.app/business-admin/commissions/professional-ledger)
- [Comissão por fichas (pote)](https://docs.barbeiro.app/business-admin/commissions/pool-by-points)