Guia Completo sobre o Fluxo de Recorrência de Assinaturas no Berga

Atualizado há cerca de 5 horas36 visualizações2 acharam útil

Este documento explica detalhadamente como funciona o sistema de cobranças recorrentes (assinaturas) do Berga. Aqui você encontrará informações sobre como as assinaturas são criadas, gerenciadas e processadas durante todo seu ciclo de vida.

A recorrência do Berga cobra o cliente sozinha a cada ciclo: o contrato de assinatura gera a cobrança na data combinada, envia ao cliente e dá baixa na conciliação. Este guia percorre o fluxo inteiro, do cadastro do plano até a renovação e o cancelamento.

Visão Geral do Sistema de Assinaturas Recorrentes

O sistema de recorrência do Berga funciona com base em ciclos de cobrança, onde cada ciclo gera uma nova fatura individual. Isso significa que uma assinatura mensal, por exemplo, gerará 12 faturas ao longo de um ano, cada uma com seu próprio documento fiscal e meio de pagamento.

Estados Possíveis de uma Assinatura

Uma assinatura pode estar em um dos seguintes estados:

1
Ativa - Assinatura funcionando normalmente e gerando cobranças regulares
2
Atrasada - Assinatura com pagamento pendente ou em atraso
3
Suspensa - Assinatura temporariamente pausada
4
Cancelada - Assinatura encerrada permanentemente

Frequências de Cobrança Disponíveis

As assinaturas podem ser configuradas com diferentes intervalos de cobrança:

Mensal - Cobrança realizada uma vez por mês
Bimestral - Cobrança realizada a cada 2 meses
Trimestral - Cobrança realizada a cada 3 meses
Semestral - Cobrança realizada a cada 6 meses
Anual - Cobrança realizada uma vez por ano

Métodos de Pagamento Aceitos

Atualmente, o sistema de recorrência aceita os seguintes métodos de pagamento:

Boleto - Pagamento via boleto com vencimento programado
PIX - Pagamento instantâneo via chave PIX

Configurações de Documentos Fiscais

O sistema permite configurar como as notas fiscais de serviço serão emitidas:

Automático - O Berga emite a nota fiscal automaticamente após cada cobrança
Manual - O cliente é responsável por emitir a nota fiscal manualmente
Não Necessário - Não é necessário emitir nota fiscal para esta assinatura

Ciclo de Vida Completo de uma Assinatura

1. Processo de Criação da Assinatura

Quando uma nova assinatura é criada no sistema:

1
Todos os dados fornecidos são validados para garantir consistência
2
A assinatura principal é registrada com suas configurações básicas
3
Os itens ou serviços incluídos na assinatura são registrados
4
Se aplicável, são configuradas divisões de pagamento (splits) para marketplace
5
As configurações de emissão de nota fiscal são definidas
6
Todas as informações são salvas no banco de dados

Toda nova assinatura começa no estado Ativa e já tem sua primeira data de cobrança definida automaticamente.

2. Sistema de Processamento de Cobranças Recorrentes

O sistema verifica regularmente quais assinaturas precisam ser cobradas:

1

Geração de Fatura por Ciclo: Cada ciclo de recorrência (mensal, trimestral, etc.) gera uma fatura individual e independente, com seu próprio identificador, vencimento e histórico de pagamento.
2

Processamento Antecipado: As cobranças são iniciadas 7 dias antes da data prevista, garantindo tempo para comunicação com o cliente e processamento do pagamento.
3

Processamento Otimizado: Para garantir desempenho, as cobranças são processadas em lotes de 20 assinaturas por vez.
4

Sistema de Segurança contra Falhas: Se ocorrer qualquer problema durante o processamento, o sistema possui mecanismos para reverter parcialmente a operação e manter os dados consistentes.
5

Emissão Automática de Documentos Fiscais: Se configurado como Automático, o sistema emite a nota fiscal de serviço junto com a cobrança.

3. Mecanismo Inteligente de Tentativas de Cobrança

O sistema gerencia tentativas de cobrança de forma inteligente:

1

Cada tentativa de cobrança é registrada no histórico da assinatura.
2

O sistema limita a 3 tentativas de cobrança para evitar problemas recorrentes. Após este limite, a assinatura é bloqueada para cobranças automáticas e exige verificação manual.
3

Quando uma cobrança é processada com sucesso, o contador de tentativas é reiniciado.
4

Em caso de erro no processamento, o sistema desfaz automaticamente o registro da tentativa.

4. Cálculo Automático da Próxima Data de Cobrança

Após cada cobrança bem-sucedida, o sistema calcula automaticamente a próxima data:

1
A data é determinada de acordo com a frequência configurada (mensal, trimestral, etc.)
2
O sistema trata corretamente casos especiais, como meses com diferentes números de dias
3
Sempre procura manter o mesmo dia do mês para a cobrança, quando possível

5. Opções de Cancelamento de Assinaturas

Quando uma assinatura precisa ser cancelada, o sistema oferece duas opções:

1
Cancelamento Imediato: a assinatura é encerrada na hora, sem gerar novas cobranças.
2
Cancelamento ao Final do Período: a assinatura continua ativa até a próxima data de cobrança e é encerrada automaticamente nessa data, sem gerar nova cobrança.

Motivo do cancelamento

Você cadastra os motivos que fazem sentido para o seu negócio em Configurações → Motivos de cancelamento (por exemplo: preço, mudou de fornecedor, encerrou atividade). Na hora de cancelar, escolhe um deles e pode complementar com uma observação livre.

Padronizar o motivo permite acompanhar por que os clientes saem. Um motivo que você desativa some da lista de escolha, mas continua nos cancelamentos antigos. Motivo já usado não pode ser excluído, só desativado.

Veja o passo a passo em Como Configurar Motivos de Cancelamento de Recorrência.

Fidelidade e multa por cancelamento antecipado

Na recorrência, em Fidelidade e Rescisão, você define um período mínimo de contrato e como a multa é calculada:

Proporcional ao tempo restante: a multa diminui conforme o cliente cumpre o contrato. É a forma recomendada para pessoa física, seguindo o que a legislação e os tribunais brasileiros aceitam.
Valor fixo: cobra o mesmo valor independente de quanto falta. Use quando houver um custo real a recuperar, como equipamento cedido ou instalação.

Você ainda pode definir um teto — um limite percentual sobre o valor das mensalidades que faltam.

Antes de confirmar o cancelamento, o Berga mostra o valor da multa e como ele foi calculado, para você conferir. Se quiser, pode isentar a multa informando o motivo, que fica registrado. Quando a multa é cobrada, ela vira uma fatura para o cliente.

Cancelamento programado para o fim do período não gera multa: o cliente avisou e cumpriu o prazo contratado.

Fluxo Detalhado do Processamento de Cobranças

O sistema segue uma sequência específica e segura para cada cobrança:

1
Registra uma nova tentativa de cobrança no histórico
2
Cria uma nova fatura individual para o período atual (cada ciclo = uma fatura)
3
Emite o documento fiscal correspondente, quando necessário
4
Gera o meio de pagamento escolhido (PIX ou boleto)
5
Atualiza automaticamente a data para a próxima cobrança
6
Reinicia o contador de tentativas após processamento bem-sucedido

Se ocorrer qualquer falha durante estas etapas, o sistema reverte as operações já realizadas para manter a consistência e integridade dos dados.

Informações Técnicas Importantes

Proteção Contra Problemas Recorrentes

Assinaturas bloqueadas após 3 tentativas malsucedidas são removidas do ciclo automático de cobrança, evitando tentativas infinitas de cobranças que sempre falham. Nesses casos, é necessário uma verificação manual para identificar e resolver o problema.

Gerenciamento Avançado de Datas

O sistema padroniza todas as datas e remove informações de hora para evitar problemas com diferentes fusos horários, garantindo consistência no processamento.

Integração Completa com Sistema de Documentos Fiscais

O sistema se integra perfeitamente com o módulo de emissão de Notas Fiscais de Serviço Eletrônicas (NFS-e), garantindo conformidade fiscal em todas as cobranças.

Sistema Flexível de Divisão de Pagamentos

O sistema permite configurar divisões do valor de uma assinatura entre diferentes beneficiários, ideal para modelos de marketplace ou programas de parceria e afiliados.

Principais Benefícios do Sistema de Recorrência

O sistema de recorrência do Berga oferece:

1
Máxima Confiabilidade: Tratamento adequado de falhas e erros durante todo o processo
2
Total Flexibilidade: Diversas frequências de cobrança e métodos de pagamento disponíveis
3
Conformidade Fiscal Garantida: Emissão automática e segura de documentos fiscais
4
Alto Desempenho: Processamento otimizado para lidar com grande volume de assinaturas
5
Previsibilidade Financeira: Datas de cobrança calculadas de forma consistente e precisa

Lançamentos Agendados por Competência (encargos e descontos extras)

Além do valor fixo cobrado todo ciclo, é possível lançar valores extras que entram só na fatura de um mês específico — por exemplo, uma parcela de IPTU ou de seguro que só deve ser cobrada em julho, junto com o aluguel.

Onde encontrar

Na tela da recorrência, na seção "Lançamentos Agendados por Competência".

Como funciona

Cada lançamento tem: tipo (Encargo, que soma no valor da fatura, ou Desconto, que subtrai), o item (produto ou serviço do seu cadastro — obrigatório, pois é ele que vira a linha da fatura), descrição (ex: "IPTU 3/6"), valor e a competência (mês/ano) em que deve ser cobrado.
O lançamento só entra na fatura do mês exato da competência escolhida — não existe cobrança retroativa automática. Se um lançamento não foi cobrado na sua competência (por exemplo, foi cadastrado depois que a fatura daquele mês já tinha sido gerada), ele fica pendente e precisa ser tratado manualmente (ex: mudar a competência para um mês ainda não faturado).
Depois de entrar numa fatura, o lançamento fica marcado como aplicado e não pode mais ser editado ou cancelado.

Qual competência escolher

A recorrência pode ser configurada como:

Pré-pago: a fatura cobra o período que está começando — a competência é o mesmo mês do vencimento.
Pós-pago: a fatura cobra o período que já passou — a competência é o mês anterior ao vencimento. Por exemplo, um boleto pós-pago com vencimento em 10/08 cobra a competência de julho.

Por isso, o sistema não deixa cadastrar (ou editar) um lançamento numa competência que já foi efetivamente cobrada — mas permite competências que ainda serão cobradas, mesmo que pareçam "passadas" no calendário (como cadastrar a competência de julho já em pleno mês de agosto, antes do boleto pós-pago de 10/08 ser gerado).

Cancelar ou editar

Só é possível editar ou cancelar um lançamento enquanto ele estiver pendente (ainda não entrou em nenhuma fatura).

Perguntas Frequentes sobre Recorrência

P: O que acontece quando uma cobrança falha no processamento? R: O sistema tenta novamente automaticamente até 3 vezes. Se todas as tentativas falharem, a assinatura é bloqueada para cobranças automáticas e exige verificação manual para identificar e resolver o problema.

P: Como o sistema trata assinaturas com dia 31 em meses que têm menos dias? R: O sistema ajusta automaticamente para o último dia do mês. Por exemplo, uma cobrança programada para o dia 31 de janeiro seria ajustada para o dia 28 (ou 29 em anos bissextos) em fevereiro.

P: É possível configurar divisão de receita em uma assinatura recorrente? R: Sim, através do recurso de divisão de pagamentos (splits), que permite distribuir o valor de cada cobrança entre múltiplos beneficiários, ideal para modelos de marketplace.

P: Como funciona exatamente o cancelamento ao final do período pago? R: A assinatura permanece completamente ativa até a próxima data de cobrança programada. Quando essa data chega, o sistema altera automaticamente o estado para Cancelada sem gerar nova cobrança, permitindo que o cliente aproveite o serviço pelo período já pago.

P: Cada ciclo de cobrança gera uma nova fatura? R: Sim, o sistema gera uma fatura individual e independente para cada ciclo de cobrança. Por exemplo, uma assinatura mensal gerará 12 faturas diferentes ao longo de um ano, cada uma com seu próprio identificador, vencimento e documento fiscal.