Ciclos de cobrança e itens de cada ciclo
O que é
O ciclo é cada período cobrado dentro de uma assinatura. Um clube mensal de doze meses tem doze ciclos: em cada um sai uma cobrança e, quando o plano entrega produtos, uma remessa.
O plano define quantos ciclos a assinatura tem e quando cobrar dentro deles. Os ciclos em si — as datas de início e fim — ficam nesta tela, e é aqui também que se define o que é entregue em cada um.
Se você ainda não sabe como plano, assinatura e ciclo se relacionam, comece por O que são planos e assinaturas.
Dois caminhos: automático ou manual
Há duas formas de os ciclos existirem, e escolher a errada dá muito trabalho depois.
| Geração automática | Cadastro manual | |
|---|---|---|
| Como funciona | Você define a periodicidade uma vez e o sistema cria os ciclos | Você cadastra cada ciclo, um a um |
| Serve para | Planos com ritmo fixo: mensal, semanal, anual | Clubes com curadoria, em que cada remessa é diferente |
| Trabalho recorrente | Nenhum | Cadastrar novos ciclos antes de os atuais acabarem |
| Itens | Os itens do plano valem para todos os ciclos | Cada ciclo tem os próprios itens |
Se o seu plano entrega sempre a mesma coisa, use a geração automática. O cadastro manual existe para o caso em que cada ciclo tem conteúdo diferente — o clube que manda um vinho diferente por mês, por exemplo.
Onde tudo isso fica
Em Assinaturas › Planos, marque o plano e abra Ações. É de lá que saem os dois caminhos:
| Ação | Para quê |
|---|---|
| Ciclos de cobrança | ver e cadastrar os ciclos, um a um |
| Configurar geração automática de ciclos de cobrança | deixar o sistema criá-los sozinho |
| Campos extras replicáveis entre ciclos dos planos | quais campos se repetem de um ciclo para o outro |
Geração automática de ciclos
Fica em Ações › Configurar geração automática de ciclos de cobrança, numa tela separada do cadastro do plano.
| Campo | Obrigatório | O que é |
|---|---|---|
| Número de períodos da duração dos ciclos | Sim, se usar geração automática | Quantos períodos cada ciclo dura. Com periodicidade "Meses" e número 1, o ciclo é mensal; com 3, trimestral. Número inteiro, mínimo 1. |
| Período de duração dos ciclos | Sim, se usar geração automática | Dias, Semanas, Meses ou Anos. |
| Momento de geração | Sim, se usar geração automática | Quando cada ciclo começa. As opções estão na tabela abaixo. |
| Dia específico | Sim, se o momento for "Dia específico do mês" | Dia do mês em que o ciclo começa. Número, mínimo 1. |
As opções de momento de geração
| Opção | O que significa |
|---|---|
| No mesmo dia que a assinatura foi efetuada | O ciclo acompanha a data em que cada cliente assinou. Cada assinante tem o próprio calendário. |
| Ao término do ciclo anterior | Cada ciclo começa quando o anterior acaba, sem data fixa. |
| Toda segunda-feira, dia 1º do mês ou dia 01 de janeiro | O ciclo começa no início do período: depende da periodicidade escolhida — segunda-feira para semanal, dia 1º para mensal, 1º de janeiro para anual. |
| Dia específico do mês | Todos os ciclos começam no dia que você escolher. |
| Aos domingos, Às segundas-feiras, … | O ciclo começa sempre no dia da semana escolhido. |
As duas primeiras opções fazem o calendário ser de cada assinante; as demais alinham todos os assinantes no mesmo calendário. Isso muda a operação: com calendário alinhado, todas as remessas saem juntas.
Cadastro manual de ciclos
Quando cada ciclo tem conteúdo próprio, você os cadastra um a um.
Como acessar
Em Assinaturas › Planos, selecione o plano e use Ações › Ciclos de cobrança.
A listagem mostra ID, Início, Término, Criado em e Itens no ciclo — esta última é a que denuncia ciclo cadastrado e esquecido sem itens. Use Adicionar para criar um ciclo novo.
Os campos do ciclo
| Campo | Obrigatório | O que é |
|---|---|---|
| Início | Sim | Data em que o ciclo começa. |
| Término | Sim | Data em que o ciclo acaba. Precisa ser depois do início — o sistema recusa datas invertidas. |
| Imagem | Não | Imagem associada ao ciclo. |
| Principal | Não | Marca a imagem como a principal do ciclo. |
Cadastre os ciclos com antecedência. A cobrança acontece uma vez por ciclo, e o sistema só cobra dentro de ciclos que existem. Se os ciclos cadastrados acabarem, as cobranças param — sem erro aparente, simplesmente não há período a cobrar. É a falha mais comum de quem usa cadastro manual.
Os itens de cada ciclo
Depois de criar o ciclo, defina o que ele entrega: selecione o ciclo e use Ações › Itens do ciclo.
| Campo | Obrigatório | O que é |
|---|---|---|
| Item | Sim | O produto entregue neste ciclo. |
| Quantidade | Sim | Quantas unidades. Número, mínimo 1. |
| Preço unitário | Não | Valor de cada unidade dentro do plano. |
A soma dos itens deve fechar o valor do plano. Num plano de R$ 50,00 com dois itens no ciclo, os preços unitários precisam somar R$ 50,00 — por exemplo, R$ 25,00 cada. Se não fecharem, o valor cobrado e o valor dos itens divergem, e essa diferença aparece depois na conciliação.
Passo a passo
Plano com ritmo fixo (recomendado)
- Em Assinaturas › Planos, abra o plano.
- Configure a geração automática: número de períodos, periodicidade e momento de geração.
- Adicione os itens do plano — eles valem para todos os ciclos.
- Salve e faça uma assinatura de teste para conferir as datas do primeiro ciclo.
Plano com conteúdo diferente por ciclo
- Em Assinaturas › Planos, selecione o plano e vá em Ações › Ciclos de cobrança.
- Clique em Adicionar e informe Início e Término do ciclo.
- Salve.
- Selecione o ciclo criado e vá em Ações › Itens do ciclo.
- Adicione cada item com Quantidade e Preço unitário, fechando o valor do plano.
- Repita para os próximos ciclos. Cadastre com folga: sem ciclo cadastrado, não há cobrança.
Exemplo prático
Um clube de vinhos mensal, em que cada mês tem um rótulo diferente. O plano tem 12 ciclos e valor de R$ 120,00 por ciclo.
Ciclo de março:
| Campo | Valor |
|---|---|
| Início | 01/03/2026 |
| Término | 31/03/2026 |
Itens do ciclo:
| Item | Quantidade | Preço unitário |
|---|---|---|
| Vinho Malbec Reserva 750ml | 1 | 90,00 |
| Taça de cristal | 2 | 15,00 |
Total: R$ 120,00, fechando o valor do plano. Em abril, um novo ciclo com outros itens.
Erros comuns
As cobranças pararam sem erro nenhum. Os ciclos cadastrados acabaram. O sistema só cobra dentro de ciclos existentes. Cadastre os próximos — e, daqui em diante, com mais antecedência.
O sistema recusou o cadastro do ciclo. A data de término precisa ser posterior à de início.
O valor cobrado não bate com os itens entregues. A soma dos preços unitários dos itens do ciclo não fecha o valor do plano.
Configurei a geração automática mas não vejo os ciclos na listagem. Com "No mesmo dia que a assinatura foi efetuada" ou "Ao término do ciclo anterior", os ciclos seguem o calendário de cada assinante, e não um calendário fixo do plano.
Todos os clientes recebem no mesmo dia e eu queria escalonar — ou o contrário. É o momento de geração que decide isso. As opções de dia fixo e dia da semana alinham todos os assinantes; as de data da assinatura dão a cada um o próprio calendário.
Comentários
0 comentário
Por favor, entre para comentar.