Funcionalidades do app · SaaS

Cobrança: planos, extras e provedores de pagamento

O lado do dono do app. Aqui você decide quanto custa cada plano, quais extras existem, por onde o cliente paga (Mercado Pago, Banco Inter, Stripe ou cobrança manual) e o que acontece quando ele atrasa. Depois, acompanha cada assinatura, marca faturas como pagas, anexa a nota fiscal e concede cortesia. Tudo fica em Administração, nos itens Cobrança, Planos, Extras e Assinaturas.

Dono do app Exige licenciamento ligado Pix · Cartão · Boleto · Manual

Antes de começar

A cobrança se apoia no licenciamento: cada cliente (uma unidade ou uma empresa) já tem um plano, uma validade e um limite de usuários. Ligar a cobrança faz esses três valores passarem a ser escritos pelo pagamento, em vez de por você. Se o licenciamento estiver desligado, a chave Cobrança ativada fica travada, e o aviso ao lado dela diz onde resolver: O licenciamento por unidade é ativado na plataforma MadBuilder, em Multi-tenancy e Banco › Unidade › Licenciamento. Depois, republique o projeto e volte aqui. Ou seja: a chave do licenciamento não está no app, está no MadBuilder, e só chega ao app publicado depois de uma nova publicação.

Como a tela Cobrança é organizada

Administração › SaaS › Cobrança é uma tela só, com o botão Salvar no alto. A chave Cobrança ativada fica no topo, fora das abas. Abaixo dela, quatro abas:

Aba	O que fica nela	Nesta página
Provedor	Escolha do provedor, credenciais, ambiente e a URL de notificação (webhook).	Seção 02
Formas de pagamento	Pix, cartão e boleto; antecedência do Pix e do boleto; instruções da cobrança manual.	Seção 02
Inadimplência	A régua: linha do tempo e os prazos em dias; guarda dos dados após cancelar.	Seção 03
Regras	Moeda, as regras fixas de troca de plano e o aviso da nota fiscal.	Seção 03

Trocar de aba não perde o que você digitou nas outras. Salvar grava as quatro abas de uma vez; se algum campo estiver errado, nada é gravado, o campo fica marcado em vermelho com o motivo embaixo e a aba dele abre sozinha (veja a pergunta frequente sobre isso).

Tela Configurações de cobrança dentro do menu Administração: a chave Cobrança ativada ligada no topo e, abaixo, as abas Provedor, Formas de pagamento, Inadimplência e Regras, com a aba Provedor aberta em Cobrança manual — **Onde tudo mora.** No menu **Administração**, os itens **Planos**, **Assinaturas**, **Extras** e **Cobrança**. Na tela Cobrança, a chave no topo e as quatro abas; o botão **Salvar**, no alto à direita, grava tudo de uma vez.

A ordem que dá menos trabalho

Deixe os planos e os extras prontos (seções 04 e 05): módulos e limite de usuários de cada plano, e o catálogo de extras. As duas telas funcionam com a cobrança desligada, só mostram um aviso. Os campos de preço do plano, porém, só aparecem depois de ligar.
Na aba Provedor, escolha o provedor e cole as credenciais (seção 02). Para começar sem integração, use a cobrança manual. Na aba Formas de pagamento, confira o que fica ligado.
Na aba Inadimplência, ajuste a régua (seção 03) ou aceite os prazos padrão.
No topo da tela, ligue Cobrança ativada e clique em Salvar.
Volte aos planos e coloque os preços, o teste grátis e a vitrine. Só então avise os clientes: até aqui ninguém foi cobrado.

Seção Cobrança ativada, no topo da tela, com a chave ligada e a explicação: desligada, nenhuma tela de assinatura aparece para os clientes e nada é cobrado — **A chave.** Uma só, no topo da tela, fora das abas. Com o licenciamento desligado ela fica travada e o aviso ao lado diz onde ligar.

O que muda para os clientes quando você liga

O administrador do cliente ganha, em Minha conta (menu do usuário, no canto superior direito), as abas Assinatura, Faturas, Pagamento e Dados de cobrança. É por elas que ele escolhe plano, paga, compra extras e baixa recibo e nota. Usuários comuns não veem nada disso.
Quando o limite de usuários estoura, o aviso passa a oferecer Adicionar usuários extras e Mudar de plano.
Com a licença vencida, a faixa de aviso no topo ganha o botão Regularizar. As abas de cobrança continuam abertas mesmo com a licença vencida: é por elas que o cliente resolve.

O lado do cliente está descrito em Minha conta: assinatura, faturas e pagamento.

Desligar é reversível. Com a chave desligada, nenhuma tela de assinatura aparece para os clientes e nada é cobrado nem enviado por e-mail. Planos, extras e as assinaturas já criadas continuam guardados; ligar de novo retoma de onde parou.

Escolher o provedor de pagamento

Tudo desta seção fica em duas abas da tela Cobrança: Provedor (quem cobra e com quais chaves) e Formas de pagamento (o que o cliente pode usar para pagar).

Aba Provedor

Na seção Provedor de pagamento você marca um dos quatro: Mercado Pago, Banco Inter, Stripe ou Cobrança manual. Logo abaixo, a seção Credenciais começa pelo campo Ambiente e mostra, ao lado dele, só as chaves do provedor marcado. No fim da aba, a URL de notificação (webhook).

Provedor	Pix	Cartão de crédito	Boleto	Renovação automática no cartão
Stripe	Sim	Sim	Sim	Sim: o app cobra o cartão salvo a cada renovação.
Mercado Pago	Sim	Sim	Sim	Não. O cliente paga cada fatura; a aba Formas de pagamento avisa Sem renovação automática: o cliente paga cada fatura.
Banco Inter	Sim	Não	Sim	Não há cartão.
Cobrança manual	Nenhuma forma automática. O cliente lê as suas instruções e paga por fora.			Não. Você marca a fatura como paga.

Cobrança manual: sem integração

É o jeito de começar hoje. O app emite a fatura, mostra ao cliente o texto que você escreveu em Instruções de pagamento (na aba Formas de pagamento: chave Pix, dados bancários, prazo de liberação) e espera. Quando o dinheiro chegar, você abre a assinatura e clica em Marcar como paga (seção 09). Nada é liberado antes disso.

Aba Provedor com Cobrança manual marcada: aviso de que o sistema não cobra e você marca como paga em Assinaturas; seção Credenciais só com o campo Ambiente e o texto de que a cobrança manual não usa credencial; URL de notificação terminando em /billing/webhook/manual — **Aba Provedor, cobrança manual.** Não há credencial: a seção mostra só o **Ambiente** e avisa que nada precisa ser configurado. A URL de notificação aparece, mas não precisa ser usada.

Stripe

No painel do Stripe, na área de desenvolvedores, copie a Secret key e a Publishable key. Ao cadastrar o webhook (abaixo), o Stripe mostra um segredo de assinatura: cole em Segredo do webhook.

Mercado Pago

Nas credenciais da sua aplicação no Mercado Pago, copie o Access token e a Public key. Ao configurar as notificações (webhook), o Mercado Pago gera uma assinatura secreta: cole em Segredo do webhook.

Banco Inter

No portal de desenvolvedores do Inter, crie uma aplicação e copie Client ID e Client secret. A aplicação também entrega dois arquivos: abra cada um num editor de texto e cole o conteúdo inteiro, incluindo as linhas BEGIN e END, em Certificado (PEM) (arquivo .crt) e Chave privada (PEM) (arquivo .key). Informe ainda a Conta corrente e a Chave Pix de recebimento: a chave da conta que vai receber.

Como as chaves ficam guardadas

Chaves e segredos são gravados cifrados e nunca voltam para a tela. Depois de salvar, o campo reaparece vazio com o texto •••• configurado.
Campo em branco ao salvar significa manter o que já está gravado. Para trocar uma chave, digite a nova por cima e salve.
O ícone de olho ao lado do campo só mostra o que você acabou de digitar, antes de salvar.

Ambiente: teste ou produção

O campo Ambiente é o primeiro da seção Credenciais. Teste (sandbox) é para homologar sem dinheiro de verdade; Produção é para cobrar. No Stripe e no Mercado Pago o ambiente está na própria chave (o provedor entrega um par de teste e um par de produção), e o app confere: em modo de teste ele recusa uma chave de produção com a mensagem Este sistema está em modo de teste, mas a chave cadastrada é a de produção. Ajuste o ambiente na tela Cobrança antes de cobrar. No Banco Inter, o ambiente escolhe qual endereço do banco o app chama. Ao ir para produção, troque as chaves e o ambiente juntos.

A URL de notificação (webhook)

No fim da aba Provedor a tela mostra a URL de notificação (webhook), montada a partir do endereço do seu app (por exemplo https://seu-app.com.br/billing/webhook/stripe). Clique em Copiar e cadastre essa URL no painel do provedor, na área de webhooks ou notificações. É por ela que o provedor avisa o app de que um pagamento foi confirmado.

Sem o webhook cadastrado, o app só fica sabendo do pagamento enquanto o cliente está com a tela de pagamento aberta. Um boleto que compensa dois dias depois, ou um Pix pago com a tela fechada, só é reconhecido quando o cliente volta à tela de pagamento, ou quando você marca a fatura como paga. O aviso do provedor nunca libera nada sozinho: ao recebê-lo, o app consulta o provedor e só então dá o pagamento como confirmado.

Aba Formas de pagamento

A aba mostra, lado a lado, as chaves Pix, Cartão de crédito e Boleto, mas só as que o provedor marcado na aba anterior oferece. Você pode desligar uma delas (aceitar só Pix no Stripe, por exemplo). Com a cobrança manual, nenhuma aparece: a aba avisa A cobrança manual não usa forma de pagamento automática.

Antecedência da fatura no Pix (dias) e Antecedência do boleto (dias): quantos dias antes do fim do período a fatura de renovação é emitida e enviada por e-mail, para o cliente ter tempo de pagar. No cartão com renovação automática a cobrança acontece no fim do período, sem antecedência.
Instruções de pagamento: o texto que o cliente lê na fatura quando o provedor é a cobrança manual. Fica aqui mesmo com outro provedor marcado, mas só é usado na cobrança manual.

Trocar de provedor vale na hora. Ao salvar a tela com outro provedor, as próximas faturas passam a ser cobradas por ele. Faça isso fora do horário em que os clientes costumam pagar e confira o webhook do novo provedor antes.

Definir a régua de inadimplência

A régua diz o que acontece com um cliente que não paga, dia a dia. Ela fica na aba Inadimplência da tela Cobrança. Todos os prazos são contados a partir do vencimento da fatura e valem para todos os clientes.

Aba Inadimplência: linha do tempo com Vencimento dia 0, Nova tentativa dia 3, Aviso final dia 7, Suspender acesso dia 10 e Cancelar assinatura dia 30; abaixo, os quatro campos em quatro colunas e o campo Guardar os dados após cancelar com 90 dias — **Aba Inadimplência.** A linha do tempo no alto acompanha o que você digita nos quatro campos logo abaixo: mude um número e o "dia" correspondente muda na hora. Embaixo, a guarda dos dados após cancelar.

Momento	O que o app faz	O que o cliente vê
Vencimento (dia 0) passa sem pagamento	A assinatura vira Pagamento em atraso. Envia um e-mail avisando que o pagamento não foi concluído.	Continua usando o app. Em Minha conta, a fatura aparece vencida.
Nova tentativa (dia 3)	No Stripe, com cartão salvo e renovação automática, tenta cobrar o mesmo cartão de novo. Nos demais casos, manda outro e-mail de cobrança.	Se o cartão passou, tudo se resolve sem ele fazer nada.
Aviso final (dia 7)	Envia o último e-mail antes da suspensão, dizendo quantos dias faltam.	E-mail com a data-limite.
Suspender acesso (dia 10)	A assinatura vira Suspensa e a licença vence: os módulos contratados somem.	Ainda consegue entrar. Vê a faixa de licença vencida com o botão Regularizar e as abas de cobrança para pagar. Os dados não são apagados.
Cancelar assinatura (dia 30)	A assinatura vira Cancelada, com motivo "não paga". Envia o e-mail de cancelamento citando o prazo de guarda dos dados.	Para voltar, escolhe um plano de novo em Minha conta.

Pagar em qualquer ponto da régua, seja o cliente pelo Minha conta, seja você com Marcar como paga, zera a régua e devolve o acesso na hora. Estender validade (seção 08) também zera.

Guardar os dados após cancelar (dias), o campo de baixo, é o prazo que o app promete ao cliente nos e-mails e nas telas de cancelamento ("seus dados ficam guardados por N dias"). O app não apaga nada sozinho: quem cumpre ou estende esse prazo é você. As antecedências do Pix e do boleto ficam na aba Formas de pagamento (seção 02).

A ordem é obrigatória. Os prazos têm de crescer: nova tentativa, depois aviso final, depois suspensão, depois cancelamento. Nenhum prazo pode ser negativo. Se você salvar fora de ordem, nada é gravado: o campo errado fica marcado em vermelho com o motivo embaixo, e a aba Inadimplência abre sozinha, mesmo que você tenha clicado em Salvar a partir de outra aba.

Aba Inadimplência aberta pelo próprio app após um Salvar recusado: o campo Nova tentativa com 99 está contornado em vermelho, com o texto Os prazos da régua têm de crescer embaixo; a linha do tempo mostra Nova tentativa dia 99 antes de Aviso final dia 7 — **Um Salvar recusado.** Nova tentativa em 99 dias, depois do aviso final em 7: o app abre a aba Inadimplência, contorna o campo e explica o motivo embaixo dele. Nada foi gravado; corrija e salve de novo.

Aba Regras

A última aba junta o que não muda com frequência: o campo Moeda (fica em BRL), as três regras fixas de troca de plano e o lembrete sobre a nota fiscal.

Colocar preço nos planos

Os planos são os mesmos do licenciamento (um pacote de módulos com limite de usuários; como montá-los está em Licenciamento, seção 03). Com a cobrança ligada, a tela Administração › SaaS › Planos ganha as colunas de preço, teste e vitrine, e o formulário ganha a seção Preço. Com a cobrança desligada, o formulário mostra no lugar dela a linha Preço, teste grátis e vitrine aparecem quando a cobrança estiver ativada em Administração › SaaS › Cobrança: cadastre os módulos e o limite agora e volte para os preços depois de ligar.

Lista de planos com colunas Code, Nome, Limite de usuários, Mensal, Anual, Dias de teste, Aparece na vitrine de planos e Ativo; o Profissional tem o selo Mais escolhido e o plano Interno está fora da vitrine — **Três planos, três usos.** As colunas **Mensal**, **Anual**, **Dias de teste** e **Aparece na vitrine de planos** só existem com a cobrança ligada. **Essencial** e **Profissional** têm *Sim* na vitrine; o Profissional tem 14 dias de teste e o selo **Mais escolhido**. O **Interno (fora da vitrine)** custa zero e tem *Não*: só você o atribui, pelo cadastro do cliente.

O formulário do plano

Formulário do plano Profissional: Nome, Code, Limite de usuários 10, Ativo, Descrição; seção Preço com Mensal 349,00, Anual 3.490,00, Dias de teste 14, chaves Aparece na vitrine de planos e Marcar como Mais escolhido; seção Extras que este plano aceita com a linha Usuário extra e o preço mensal só neste plano em branco — **Preço, teste, vitrine e extras.** Abaixo dos dados do plano vem a seção **Preço**: mensal e anual em reais, dias de teste e os dois interruptores que controlam a vitrine. Depois, a lista **Extras que este plano aceita**, aqui só **Usuário extra**, sem preço próprio na coluna **Preço mensal só neste plano** (a dica embaixo da lista explica: em branco, vale o do catálogo). Mais abaixo, fora do recorte, ficam os módulos do plano.

Mensal e Anual: os preços dos dois ciclos. Anual em branco (ou 0,00) com mensal preenchido quer dizer que o plano não é vendido no ciclo anual: a vitrine não oferece a opção. A dica da tela lembra a conta usual: anual valendo dez mensalidades equivale a dois meses grátis. Os dois preços zerados fazem um plano gratuito.
Dias de teste: 0 é sem teste. Com um número, quem assina entra em Em teste até essa data, sem pagar nada; se o teste acabar sem um plano pago, a assinatura fica Encerrada (o que o cliente vê nesse caso está em Minha conta, seção 08).
Aparece na vitrine de planos: desligado, o plano some da tela de escolha do cliente e só você consegue atribuí-lo, pelo cadastro da unidade ou empresa. Serve para preços negociados.
Marcar como "Mais escolhido": destaca o cartão na vitrine.
Extras que este plano aceita: a lista dos extras que quem assina este plano pode comprar. Em cada linha dá para informar um Preço mensal só neste plano; em branco, vale o preço do catálogo de Extras. Extra que não está nesta lista não aparece para o cliente.
Módulos do plano: os módulos liberados, como no licenciamento.

Plano em uso não pode ser excluído. Ao tentar, a tela responde Este plano tem N assinatura(s) em cima dele. Desative-o em vez de excluir. Um plano desativado some da vitrine e das listas de escolha, mas quem já assinou continua com ele.

Vender extras

Extras são itens que o cliente compra por cima do plano, em Administração › SaaS › Extras. Existem três tipos, e o tipo decide o que o app faz quando o cliente paga (o lado do cliente está em Minha conta, seção 05 — Comprar e remover extras):

Tipo	O que faz ao ser contratado	Exemplo
Usuários extras	Cada unidade comprada soma uma vaga ao limite de usuários do cliente.	Usuário extra, R$ 19,00 por mês cada.
Módulo avulso	Libera o módulo escolhido em Módulo liberado, mesmo que ele não esteja no plano. Só pode existir um extra por módulo.	Módulo Auditoria, R$ 89,00 por mês.
Pacote de uso	Só registra a quantidade contratada. O app não controla nada sozinho: é para o que você controla por fora ou nas suas próprias telas.	Armazenamento +10 GB, R$ 29,00 por mês.

Lista de extras com colunas Código, Nome, Tipo, Módulo liberado, Preço mensal, Preço anual, Ordem e Ativo: Usuário extra, Módulo Auditoria e Armazenamento +10 GB — **O catálogo.** Um extra de cada tipo, com as colunas **Tipo**, **Módulo liberado** (preenchido só no Módulo Auditoria), **Preço mensal**, **Preço anual** e **Ordem**. No início de cada linha, o lápis edita, o botão de energia ativa ou desativa e a lixeira exclui.

Formulário do extra Módulo Auditoria: Nome, Código modulo_auditoria, Tipo Módulo avulso, Módulo liberado Auditoria, Descrição, Preço mensal 89,00, Preço anual em branco, Ordem 2, Ativo — **Um extra do tipo Módulo avulso.** O **Tipo** é escolhido entre três opções; o campo **Módulo liberado**, logo abaixo, só vale para o tipo Módulo avulso e nos outros é ignorado. Na seção **Preço**, o anual aparece como 0,00: sem valor próprio, o app cobra doze vezes o mensal, como diz a dica.

Código: preenchido sozinho a partir do nome se você deixar em branco; serve para o app identificar o extra por dentro e precisa ser único.
Ordem: a posição na lista que o cliente vê.
Para o cliente conseguir comprar, o extra precisa estar listado em Extras que este plano aceita, no plano dele (seção 04).
A compra cobra só os dias que faltam até o fim do período (o proporcional) e entra inteira na mensalidade seguinte. Remover um extra vale no fim do ciclo; o cliente faz isso em Minha conta.

Extra contratado não pode ser excluído. A tela responde Este extra está contratado em N assinatura(s). Desative-o em vez de excluir. Desativado, ele deixa de ser oferecido, e quem já paga continua com o que contratou.

Iniciar a assinatura de um cliente

Uma assinatura nasce de três jeitos. O mais comum é o próprio cliente escolher um plano na vitrine, em Minha conta (Minha conta, seção 03). Os outros dois são seus:

Pela tela Assinaturas

Em Administração › SaaS › Assinaturas, clique em Iniciar assinatura. A lista Cliente só traz os contratos que ainda não têm assinatura. Escolha o Plano, o Ciclo e, se quiser, um número de Dias de teste diferente do que o plano define (em branco usa o do plano).

Painel Iniciar assinatura com Cliente Associação Ponto de Luz, Plano Essencial, Ciclo Mensal e Dias de teste em branco — **Quatro campos.** **Cliente**, **Plano**, **Ciclo** e **Dias de teste**; a frase no alto lembra que o contrato escolhido ainda não tem assinatura. O botão **Iniciar assinatura** cria a assinatura na hora.

O que acontece depende do plano:

Com dias de teste: a assinatura nasce Em teste, com todos os módulos liberados até a data, e nenhuma fatura é emitida.
Sem teste e com preço: a assinatura nasce Ativa com a marca Aguardando o primeiro pagamento e uma fatura do tipo Primeira cobrança em aberto. O cliente paga em Minha conta, ou você marca como paga quando receber por fora.

Assinatura recém-criada: situação Ativa com o selo Aguardando o primeiro pagamento, período de 30 dias, e na aba Faturas a fatura 2026-0016 do tipo Primeira cobrança em aberto, com os botões de marcar como paga, cancelar fatura e enviar nota — **Logo depois de iniciar.** No cabeçalho, a **Situação** é **Ativa**, mas o selo laranja logo abaixo avisa *Aguardando o primeiro pagamento*. Na aba **Faturas**, a **Primeira cobrança** em aberto e, na coluna **Ações**, os três botões da linha: marcar como paga (preto), cancelar fatura (vermelho) e enviar nota.

Pelo cadastro do cliente

No cadastro da unidade ou da empresa (Administração › Unidades ou Empresas), a seção Licença tem o campo Cobrança. Ele começa em Gerenciada pelo dono (sem cobrança): você edita plano, validade e limite à mão, como no licenciamento (Licenciamento, seção 04). Trocar para Assinatura, escolher o Ciclo da assinatura e salvar inicia a assinatura com o plano marcado ali. A partir daí a tela avisa Plano, validade e limite são gerenciados pela assinatura e oferece o botão Abrir assinatura.

Seção Licença do cadastro de uma unidade com o campo Cobrança em Gerenciada pelo dono (sem cobrança), Ciclo da assinatura Mensal, Plano Essencial, Válida até e Limite de usuários editáveis — **Antes.** O campo **Cobrança** em **Gerenciada pelo dono (sem cobrança)**: **Válida até** e **Limite de usuários** são campos livres, que você preenche à mão (aqui, 27/10/2026 e 3).

Seção Licença do Instituto Aurora com Cobrança em Assinatura: aviso Plano, validade e limite são gerenciados pela assinatura, botão Abrir assinatura, e os campos Válida até e Limite de usuários bloqueados — **Depois.** Com **Cobrança** em **Assinatura**, aparece o aviso azul e o botão **Abrir assinatura**; **Válida até** e **Limite de usuários** ficam em cinza, preenchidos pelo pagamento. O botão leva para a tela da seção 08.

Validade e suspensão. Enquanto a assinatura está em dia, a validade da licença fica no fim do período mais os dias de Suspender acesso da régua. É por isso que um cliente com período até 31/10 aparece com licença válida até 10/11: é a folga para pagar antes de perder os módulos.

Acompanhar as assinaturas

Administração › SaaS › Assinaturas é o painel do dia a dia. No alto, cinco cartões com números calculados na hora; abaixo, a lista de todos os clientes com assinatura.

Cinco cartões: Receita recorrente mensal R$ 1.221,00 com 6 assinaturas pagantes, Em teste 1, Pagamento pendente 1 com R$ 298,00 em atraso, Cancelamentos no mês 0, Pagamentos a conciliar 0 — **Os cinco cartões.** **Receita recorrente mensal** soma o equivalente mensal das assinaturas pagantes (uma anual entra dividida por doze); a linha menor diz quantas são. **Em teste** e **Cancelamentos no mês** são contagens. **Pagamento pendente** conta quem está em atraso e quanto. **Pagamentos a conciliar** fica em zero até chegar dinheiro fora de hora (seção 10).

Lista de assinaturas com colunas Cliente, Plano, Ciclo, Valor, Situação e Próxima cobrança, mostrando clientes nas situações Encerrada, Suspensa, Ativa, Pagamento em atraso e Em teste — **A lista.** Cada linha diz o plano (com "+ extras" quando há extras), o valor, a **Situação** (selo colorido: verde em dia, amarelo em atraso, vermelho suspensa ou encerrada, azul em teste) e a **Próxima cobrança**. Em atraso, a data vira *venceu em*; em teste, *termina em*. O ícone de seta no início da linha é o **Abrir**, que leva à tela da seção 08. Os filtros nas colunas **Ciclo** e **Situação** ajudam quando a lista cresce.

Situação	Significa
Em teste	No período grátis do plano. Nenhuma cobrança até a data indicada.
Ativa	Em dia. Com o selo Aguardando o primeiro pagamento quando a fatura de estreia ainda está aberta.
Pagamento em atraso	Fatura vencida e não paga. O cliente ainda usa o app; a régua está correndo.
Suspensa	A régua chegou à suspensão: os módulos sumiram, o login continua.
Cancelada	Cancelada pelo cliente ou por você: o acesso vale até o fim do período pago. Cancelada pela régua: o acesso já tinha sido suspenso.
Encerrada	O teste terminou sem que um plano pago fosse escolhido.

Clientes em cortesia e contratos que nunca foram cobrados não têm assinatura, então não aparecem na lista nem nos cartões. Eles ficam no bloco Contratos sem cobrança, no fim da tela (seção 08).

Cuidar de uma assinatura

Clique em Abrir numa linha da lista. O painel mostra, no alto, o cliente, o plano e o ciclo, a situação, o período atual e o equivalente mensal (quanto o cliente paga por mês, com extras; numa assinatura anual, o valor dividido por doze). Quando existe uma mudança marcada para o fim do período (um plano menor pedido pelo cliente, por exemplo), um aviso Mudança agendada para o fim do período aparece aqui. Abaixo, três abas: Ações do dono, Faturas e Histórico.

Painel da assinatura do Instituto Aurora de Educação, aba Ações do dono: cabeçalho com plano Essencial mensal, situação Ativa, período 01/10 a 31/10/2026 e equivalente mensal R$ 276,00; seções Trocar plano ou ciclo, Estender validade, Conceder cortesia e Cancelar ou reativar — **Aba Ações do dono.** No cabeçalho, cliente, **Plano**, **Situação**, **Período atual** e **Equivalente mensal** (R$ 276,00 = plano de R$ 149,00 mais R$ 127,00 de extras). Abaixo, quatro seções, cada uma com o próprio botão: **Aplicar troca**, **Estender**, **Conceder cortesia** e **Cancelar assinatura**. Nenhuma delas cobra o cliente: quem cobra é o pagamento feito por ele em Minha conta.

Trocar plano ou ciclo, sem cobrar

Escolha o novo Plano e o Ciclo e clique em Aplicar troca. Vale na hora, sem fatura e sem proporcional: é para acertos comerciais (cliente que negociou outro plano, correção de cadastro). O período atual e os extras já contratados continuam; uma mudança que o cliente tinha agendado para o fim do período é descartada. Se a ideia é cobrar a diferença, não use esta ação: peça ao cliente para fazer a troca em Minha conta, onde subir de plano gera a fatura dos dias que faltam (Minha conta, seção 03).

Estender a validade

Informe o Novo fim do período e clique em Estender. O fim do período atual muda para a data escolhida, a régua de inadimplência é zerada, a assinatura volta a Ativa e o acesso volta. O dia do mês em que o cliente paga não muda. Serve para dar prazo a um cliente em atraso que prometeu pagar, ou para compensar um problema. A data precisa ser hoje ou depois: uma data no passado deixaria a licença vencida, e a tela recusa.

Conceder cortesia

Cortesia é parar de cobrar sem tirar o acesso. Escreva uma Observação (ela vai para as anotações do contrato) e clique em Conceder cortesia. A assinatura deixa de existir; o contrato continua valendo com o plano, a validade e o limite que tinha, agora editados por você no cadastro da unidade ou empresa. Os módulos que vinham de extras pagos ficam liberados. As faturas já emitidas continuam no histórico.

Bloco Contratos sem cobrança no fim da tela Assinaturas, com colunas Cliente, Plano, Válida até, Limite de usuários, Ativo e o botão Abrir cliente; a Associação Ponto de Luz aparece após a cortesia — **Depois.** O cliente sai da lista de assinaturas e passa para o bloco **Contratos sem cobrança**, no fim da tela, com **Plano**, **Válida até** e **Limite de usuários**. O botão **Abrir cliente** leva ao cadastro da unidade ou empresa, onde plano e validade voltam a ser campos livres.

Para voltar a cobrar um cliente em cortesia, inicie uma nova assinatura para ele (seção 06). O contrato aparece de novo na lista Cliente de Iniciar assinatura.

Cancelar ou reativar

Escreva o Motivo e clique em Cancelar assinatura. O cancelamento vale no fim do período já pago: o cliente usa o app até lá e não recebe a próxima fatura. Enquanto esse período não acaba, o botão vira Reativar, que desfaz o cancelamento sem cobrar nada. Não existe pausa. O cliente também pode cancelar e reativar sozinho (Minha conta, seção 10).

Faturas e nota fiscal

A aba Faturas lista todas as faturas do cliente e é onde você registra pagamentos recebidos por fora, cancela uma fatura errada, anexa a nota fiscal e lança cobranças avulsas.

Aba Faturas do Instituto Aurora: cinco faturas pagas (Itens adicionais, três Renovações e a Primeira cobrança), uma delas com a nota fiscal nfse-2026-09.pdf anexada; abaixo, as seções Nota fiscal e Lançamento manual — **Aba Faturas.** Em cima, a tabela com **Número**, **Tipo**, **Vencimento**, **Valor**, **Situação** e **Nota fiscal**. Fatura paga só tem o botão de enviar nota; a 2026-0005, que já tem nota, ganha mais dois: **Baixar nota** e **Remover nota** (vermelho). Abaixo da tabela, as duas seções descritas adiante: **Nota fiscal** e **Lançamento manual**.

Tipo de fatura	Quando aparece
Primeira cobrança	Ao iniciar uma assinatura sem teste.
Renovação	A cada período, emitida com a antecedência da régua (Pix e boleto) ou no fim do período (cartão).
Mudança de plano	Cliente subiu de plano: cobra a diferença só pelos dias que faltam no período.
Itens adicionais	Compra de extras pelo cliente: cobra só os dias até o fim do período.
Cobrança avulsa	Lançada por você em Lançamento manual.

Situações: Em aberto, Paga, Cancelada e Devolvida. A numeração segue o ano: 2026-0001, 2026-0002… O cliente vê as mesmas faturas, com recibo e nota, em Minha conta, seção 06 — Faturas, recibos e notas fiscais.

Marcar uma fatura como paga

O cliente pagou por transferência, em dinheiro, ou você usa a cobrança manual. Na linha da fatura Em aberto, clique no primeiro botão (o círculo com o sinal de certo) e confirme. É o mesmo caminho que o pagamento pelo provedor percorre: a fatura vira Paga, o plano ou os extras que ela cobrava são liberados na hora, a régua é zerada e o cliente recebe o recibo por e-mail.

Caixa de confirmação: Registrar esta fatura como recebida? O plano e os extras dela são liberados na hora. Botões Cancelar e Confirmar — **A confirmação.** A pergunta *Registrar esta fatura como recebida?* avisa o efeito antes de você clicar em **Confirmar**. Depois disso não há como desfazer: a fatura fica paga e o que ela cobrava é liberado.

Cancelar uma fatura

Emitiu errado, cobrou em duplicidade, fez um acordo: na linha da fatura Em aberto, o botão vermelho Cancelar fatura muda a situação para Cancelada e ela deixa de ser cobrada. Só faturas em aberto podem ser canceladas; uma fatura paga não tem esse botão. Cancelar a fatura de renovação não cancela a assinatura: como o próximo período continua sem fatura, o app emite outra renovação na hora seguinte. Para parar de cobrar de verdade, cancele a assinatura ou conceda cortesia (seção 08).

Tabela de faturas com a Cobrança avulsa 2026-0017 na situação Cancelada e a Primeira cobrança 2026-0016 na situação Paga — **Depois das duas ações.** Na coluna **Situação**, a cobrança avulsa aparece *Cancelada* e a primeira cobrança, *Paga*. Na coluna **Ações**, as duas só conservam o botão de enviar nota: os de marcar como paga e cancelar sumiram.

Lançar uma cobrança avulsa

Na seção Lançamento manual, preencha Descrição, Valor e Vencimento e clique em Lançar fatura. Nasce uma fatura do tipo Cobrança avulsa, que o cliente vê e paga em Minha conta como qualquer outra. Pagá-la não muda plano nem extras: cobra apenas o valor lançado. Serve para um serviço, um ajuste, uma taxa de implantação.

Seção Lançamento manual preenchida com Descrição Treinamento da equipe (2 horas), Valor R$ 200,00 e Vencimento 30/09/2026, e o botão Lançar fatura — **Uma cobrança avulsa.** A seção **Lançamento manual** preenchida: **Descrição**, **Valor** e **Vencimento**, e o botão **Lançar fatura**. A descrição é o que o cliente lê na fatura.

Anexar a nota fiscal

O app não emite nota fiscal. Você emite pelo sistema da sua prefeitura ou pelo seu emissor, salva o arquivo e anexa aqui, fatura por fatura. Na seção Nota fiscal, escolha a Fatura, envie o arquivo (PDF ou XML, até 5 MB) e clique em Enviar nota. O nome do arquivo passa a aparecer na coluna Nota fiscal da tabela, e o cliente ganha o botão de baixar em Minha conta › Faturas (Minha conta, seção 06).

Seção Nota fiscal com a fatura 2026-0006 escolhida e o arquivo nfse-demo.pdf carregado na área de envio, com os botões Visualizar, Trocar e Remover e, embaixo, Enviar nota — **Antes de enviar.** À esquerda, a **Fatura** escolhida na lista; à direita, o arquivo já carregado na área de envio, com os botões **Visualizar**, **Trocar** e **Remover**. Só o clique em **Enviar nota**, embaixo, grava.

Tabela de faturas com a Primeira cobrança 2026-0016 paga e o arquivo nfse-demo.pdf na coluna Nota fiscal; na linha aparecem os botões de trocar, baixar e remover a nota — **Nota anexada.** O nome do arquivo aparece na coluna **Nota fiscal** da linha paga e a coluna **Ações** passa a ter três botões: trocar a nota (o mesmo ícone de enviar), **Baixar nota** (seta para baixo) e **Remover nota** (clipe vermelho). A cobrança avulsa cancelada, acima, continua *sem nota*.

Substituir: envie outro arquivo para a mesma fatura. O anterior é apagado.
Remover: o botão com o clipe vermelho, na linha, apaga o arquivo depois de uma confirmação.
O arquivo fica em área privada do servidor. Só você e o administrador daquele cliente conseguem baixar.

Histórico

A aba Histórico conta a vida da assinatura em ordem: início, fim do teste, cada fatura emitida e paga, nota enviada, cancelamento e pagamentos inesperados. É o primeiro lugar para olhar quando um cliente pergunta "o que aconteceu com a minha conta".

Conciliar um pagamento inesperado

Às vezes o dinheiro chega para uma fatura que já não podia recebê-lo: o cliente pagou um boleto de uma fatura que você tinha cancelado, ou pagou a mesma fatura duas vezes. O app não engole esse dinheiro nem o aplica em silêncio. Ele faz duas coisas, e deixa para você conciliar, isto é, conferir o caso e dar por resolvido:

O valor vira crédito a favor do cliente na assinatura, e abate a próxima fatura.
Aparece uma linha em Conciliações pendentes, no alto da tela Assinaturas, e o cartão Pagamentos a conciliar deixa de ser zero.

Bloco Conciliações pendentes acima da lista: uma linha com cliente Associação Ponto de Luz, fatura 2026-0017 cancelada, valor recebido R$ 200,00, provedor manual com o código da cobrança, data, crédito gerado R$ 200,00 e os botões Abrir e Marcar como conciliado — **Uma conciliação pendente.** O bloco amarelo explica o caso e a linha diz quem pagou, qual fatura (aqui, uma já *Cancelada*), quanto, por qual provedor, quando e que crédito foi gerado. Em **Ações**, **Abrir** leva à assinatura e o botão preto com o sinal de certo é o **Marcar como conciliado**.

Cabeçalho da assinatura com o selo Crédito a favor do cliente: R$ 200,00 e a nota Abate a próxima fatura — **Na assinatura.** O selo azul **Crédito a favor do cliente: R$ 200,00** aparece no cabeçalho, logo abaixo do equivalente mensal, com a nota *Abate a próxima fatura*: o desconto é feito sozinho.

O bloco existe para você falar com o cliente: avisar que o valor virou crédito, ou combinar uma devolução por fora. Resolvido, clique em Marcar como conciliado e confirme. A linha some; o crédito do cliente continua valendo. Quando não há nada pendente, o cartão mostra 0 e o bloco não aparece.

Perguntas frequentes

Posso ligar a cobrança sem ter conta em nenhum provedor?

Sim. Escolha Cobrança manual, escreva as instruções de pagamento e ligue a chave. As faturas são emitidas normalmente; você marca cada uma como paga ao receber. Quando tiver o provedor, troque na aba Provedor da mesma tela.

O cliente pagou por transferência. Como registro?

Abra a assinatura, aba Faturas, e clique em Marcar como paga na fatura em aberto. O plano e os extras dela são liberados na hora e a régua zera.

Quero dar um preço especial para um cliente.

Não há campo de desconto por cliente. O caminho é criar um plano com o preço combinado e deixá-lo com Aparece na vitrine de planos desligado: ele não é oferecido a ninguém, e você o atribui a esse cliente pelo cadastro da unidade ou pela ação Trocar plano ou ciclo. Para um item pontual, use Lançamento manual; para não cobrar nada, Conceder cortesia.

O app emite a nota fiscal?

Não. Emita pelo seu sistema e anexe o PDF ou XML na fatura, em Assinaturas › Faturas › Nota fiscal. O cliente baixa em Minha conta.

Cancelei a fatura de renovação por engano. E agora?

Nada a fazer. A fatura cancelada não volta, mas o app percebe, na hora seguinte, que o próximo período está sem fatura e emite uma renovação nova, com o mesmo valor; o cliente recebe o aviso de novo. Já uma Cobrança avulsa cancelada por engano precisa ser lançada outra vez em Lançamento manual.

Quem recebe os e-mails de cobrança?

O e-mail cadastrado nos dados do contratante do cliente (o mesmo que ele edita em Minha conta › Dados de cobrança) e os administradores do cliente. Usuários comuns não recebem.

O que acontece se eu desligar a cobrança com assinaturas em andamento?

As telas de assinatura somem para os clientes, nenhuma fatura nova é emitida e a régua para. Os cadastros e as assinaturas ficam guardados; ao religar, tudo continua de onde estava. Enquanto estiver desligada, plano, validade e limite voltam a ser editados por você, no cadastro do cliente.

O cliente diz que pagou o Pix, mas o plano continua bloqueado.

Primeiro confira a fatura na aba Faturas da assinatura. Se ela continua Em aberto, o provedor ainda não avisou o app: o motivo mais comum é a URL de notificação não estar cadastrada no painel do provedor (seção 02). Peça ao cliente para abrir a tela de pagamento de novo, o que força a consulta, ou, se você já vê o dinheiro na conta, use Marcar como paga. Depois, cadastre a URL para não repetir.

Salvei e apareceu um erro numa aba que eu não estava vendo. E agora?

É o app abrindo a aba certa para você. Salvar grava as quatro abas de uma vez; se um campo de outra aba está errado (um prazo da régua fora de ordem, por exemplo), nada é gravado, a aba desse campo abre sozinha e ele aparece contornado em vermelho com o motivo embaixo. Corrija ali e clique em Salvar de novo: o que você digitou nas outras abas continua preenchido.