Provisionamento (recorrências e ciclos)
Para que serve
O provisionamento é o cadastro de uma receita ou despesa que se repete: mensalidade de cliente, aluguel, assinatura de software, honorário. A cada período, o Tesselys gera o lançamento financeiro sozinho e, se você configurar, emite a nota fiscal, gera a cobrança e prepara o aviso ao cliente. Cada geração é um ciclo.
Os contratos recorrentes também faturam por aqui: cada contrato ativo tem um provisionamento ligado a ele (veja Contratos recorrentes).
Onde fica
Financeiro › Provisão (a tela se chama Provisionamentos). Se o módulo não aparecer na raiz de Módulos, procure em Módulos › Ver todos. O item só aparece se o plano da empresa tem o recurso de Provisão e o seu perfil pode ver provisionamentos. Os nomes do menu podem ter sido personalizados pela sua empresa.
A lista tem as abas Todos, Receitas e Despesas, totalizadores de Receitas, Despesas e Resultado, e as colunas Provisionamento, Categoria, Frequência, Valor e Processamento (quantas repetições já foram geradas, por exemplo "3 de 12" ou "3 de ∞"). Selos na linha indicam Requer arquivo, Canal vinculado, Contrato e quantas pendências de processamento o registro tem.
Clicar na linha abre a página do provisionamento, com as abas Resumo e Histórico (os Lançamentos Gerados) e uma coluna lateral com Ocorrências e Ciclos pendentes. A ação Visualizar abre os detalhes numa gaveta lateral, sem sair da lista.
O filtro (Filtrar Provisionamentos) busca por título e descrição e filtra por tipo, frequência, forma de pagamento, conta bancária, categoria, unidade de negócio, cliente, situação, tipo de processamento (automáticos ou que requerem arquivo), vínculo com contrato, Com pendência de processamento e Apenas registros ativos.
Antes de começar
- Cliente ou fornecedor cadastrado, na ficha da pessoa: em Cadastros › Pessoa, ou no item de cliente ou fornecedor do módulo que a sua empresa usa (por exemplo, Compras › Fornecedor). Veja Pessoas.
- Categoria financeira e conta bancária cadastradas (veja Categorias financeiras e Contas bancárias). Sem categoria, o sistema usa a padrão do tipo; sem conta, a conta padrão.
- Para gerar cobrança: o cliente precisa de um e-mail marcado para receber cobrança (Enviar conta, Enviar cobrança ou Todos os e-mails) e, para boleto registrado, de endereço completo (CEP, logradouro e município). Um banco ou gateway conectado em Sistema › Integrações › Marketplace é recomendado (veja Bancos e gateways de pagamento).
- Para emitir nota fiscal: a emissão automática de notas configurada em Sistema › Configurações › Configuração Fiscal (veja Configuração fiscal). Sem ela, o provisionamento só fatura pela nota que você emite à mão.
Situações do provisionamento
Só um provisionamento Ativo fatura. As outras situações existem para você preparar, pausar ou encerrar sem perder o histórico.
| Situação | O que significa |
|---|---|
| Rascunho | Recém-criado ou reativado. Não processa, nem pela rotina automática nem manualmente. |
| Ativo | Entra na rotina automática e pode ser processado à mão. |
| Bloqueado | Pausado de propósito. Não processa até ser ativado de novo. Nada é excluído. |
| Finalizado | Todas as repetições combinadas já foram geradas. Ainda recebe a nota do último lançamento, mas não gera novos ciclos. É gravado pelo sistema, não dá para escolher. |
| Inativo | Foi inativado. Sai das consultas padrão e pode ser reativado. Também não dá para escolher: acompanha a ação Inativar. |
Criando um provisionamento
- Em Financeiro › Provisão, clique em Novo. A gaveta se chama Nova Receita Recorrente ou Nova Despesa Recorrente, conforme o tipo.
- Preencha as seções do formulário (detalhadas abaixo). No topo, o campo Situação vem como Rascunho; você pode escolher Ativo ou Bloqueado.
- Confira a prévia dos Próximos ciclos e o resumo em texto do que vai acontecer.
- Clique em Salvar. Aparece "Provisionamento criado com sucesso".
- Se ele nasceu como Rascunho, confira valor, vencimento e dados do cliente e use Ativar no menu de ações (⋮).
Para criar outro parecido, use Duplicar Provisionamento: o formulário abre preenchido, com "cópia" no título, e nada é gravado até você salvar.
Dados essenciais
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo | Sim | Receita ou Despesa. Nota fiscal e cobrança só existem em receita. |
| Cliente / Fornecedor | Sim | Pessoa do provisionamento. Em provisionamento de contrato, é o cliente do contrato e só muda pelo contrato. |
| Título | Sim | Nome do provisionamento. Não pode repetir o título de outro provisionamento ativo da empresa. |
| Modelo do título do lançamento | Não | Como cada lançamento gerado será nomeado. Aceita variáveis, como cliente, competência e número da parcela. Vazio: usa o título do provisionamento. |
| Descrição | Não | Copiada para o lançamento de cada ciclo. Não vai para o e-mail do cliente. |
| Valor | Sim | Precisa ser maior que zero, exceto quando o valor depende de documento ou liberação (veja "Aguardar documento" abaixo). Nunca negativo. |
| Origem do valor | Só em provisionamento de contrato | Valor fixo, Do contrato — todos os itens ou De um item do contrato. Vindo do contrato, o valor é recalculado a cada ciclo, só vale em recorrência mensal ou maior e não pode cobrar em dobro o que outro provisionamento do mesmo contrato já cobra. |
| Categoria financeira | Não | Se ficar vazia, usa a categoria padrão do tipo. |
Recorrência
| Campo | Descrição |
|---|---|
| Frequência | Diário, Semanal, A cada 14 dias, Quinzenal (2 dias fixos no mês), Mensal, Bimestral, Trimestral, Semestral ou Anual. Não pode ser trocada depois que o provisionamento gerou lançamentos: inative e crie outro. No diário, Apenas dias úteis pula fins de semana e feriados. |
| Primeiro vencimento | Não pode estar no passado. O dia dele é o dia de todos os próximos vencimentos. Depois que o provisionamento gera lançamentos, essa data não pode mais ser alterada. |
| Vencimento | Regra do dia de vencimento: dia fixo do mês (padrão), N-ésimo dia útil (de 1 a 23), primeiro dia do mês, primeiro dia útil, último dia ou último dia útil. Na quinzenal, informe o 2º dia de vencimento no mês (de 1 a 31, maior que o primeiro e com pelo menos 7 dias entre os dois). Nos meses que não têm o dia escolhido, como fevereiro, o vencimento cai no último dia. |
| Se cair em dia não útil | Padrão do sistema: receita vai para o próximo dia útil e despesa fica na data. Você pode trocar, e a escolha vale também para o vencimento do boleto. |
| Quando processar | O dia em que o lançamento nasce (e, se configurado, a nota e a cobrança): N dias corridos ou úteis antes do vencimento, último dia útil do mês anterior, primeiro dia útil do mês ou N-ésimo dia útil. A antecedência tem um teto por frequência, e o processamento nunca pode cair depois do vencimento. |
| Nº de repetições | Quantos ciclos gerar (maior que zero). Vazio = sem fim. |
A prévia dos Próximos ciclos mostra, para cada ciclo, quando processa, quando vence, a competência e o valor. A rotina automática roda todo dia, de madrugada. As datas exatas dependem do calendário de feriados da empresa.
Pagamento ou recebimento
| Campo | Descrição |
|---|---|
| Forma de pagamento / Forma de recebimento | Como o valor é pago ou recebido. Obrigatório. |
| Conta bancária | Conta dos lançamentos gerados. Se ficar vazia, usa a conta padrão. É a mesma conta que vai na cobrança. |
| Aguardar documento do fornecedor (despesa) / Aguardar liberação de faturamento (receita) | Para valores que mudam a cada mês. Deixe o valor zero e marque esta opção: o ciclo só é gerado quando você enviar o documento ou liberar o faturamento, informando o valor nessa hora. |
| Pagamento automático pelo banco (despesa) | Padrão da conta, Sempre ou Nunca. Veja Pagamento automático. |
Cobrança automática, nota fiscal e comunicação (somente receita)
- Gerar cobrança automaticamente: cria a cobrança a cada ciclo. Escolha o Tipo de cobrança (obrigatório): boleto, Pix, cartão ou transferência. O provedor é escolhido no momento da geração, conforme o tipo; sem provedor que atenda, a cobrança sai pelo fluxo manual, com os dados bancários da conta (se a conta não tem chave Pix, sai como transferência). Defina também o Texto do boleto ou Texto do PIX e o Vencimento da cobrança (dias após o vencimento do lançamento; vazio ou 0 é o mesmo dia).
- Emitir nota fiscal a cada processamento: emite sempre NFS-e (serviço). Para nota de produto, o caminho é medição via ordem de serviço. Os códigos fiscais e o texto da nota herdam da configuração fiscal quando ficam vazios.
- Disparar pela nota fiscal emitida: para empresas sem emissão automática. O ciclo espera você emitir a nota à mão e escolher quais notas faturam aquele ciclo; o valor do lançamento é a soma delas. Não pode ser usado junto com Emitir nota fiscal a cada processamento.
- Ordem de execução: Nota primeiro (lançamento → nota → cobrança) ou Cobrança primeiro (lançamento → cobrança → nota). Com "Nota primeiro", o texto da cobrança pode usar o número da nota; com "Cobrança primeiro", as variáveis da nota saem vazias até a nota ser autorizada.
- Competência — como calcular: igual ao dia da emissão, mês do vencimento (padrão), mês atual, mês anterior ou deslocamento personalizado (informe os meses; negativo para meses anteriores).
- E-mail no cadastro do cliente (Emissor Nacional): o e-mail que fica no cadastro do cliente no emissor e aparece na nota. Não envia e-mail.
- Comunicação: Destinatários no cliente (vazio usa os e-mails habilitados da pessoa), Em cópia, Assunto do e-mail e Mensagem no e-mail ao cliente, que aceitam variáveis. O provisionamento não envia e-mail sozinho: ele define para quem e com que texto a automação de envio dispara.
Para a cobrança chegar, o cliente precisa ter um e-mail marcado para receber cobrança (Enviar conta, Enviar cobrança ou Todos os e-mails); para a nota chegar, um e-mail marcado com Enviar nota fiscal ou Todos os e-mails. Para boleto registrado no banco, o cliente precisa de endereço completo (CEP, logradouro e município), porque o banco recusa boleto sem endereço do pagador. Se faltar, o próprio formulário pede o e-mail ou o endereço (com Buscar endereço pelo CNPJ) e grava no cadastro da pessoa ao salvar.
Classificação e governança
- Classificação: centro de custo, unidade de negócio, workspace e tags.
- Exigir aprovação antes de processar: a rotina automática deixa de processar sozinha; alguém precisa processar manualmente a cada período.
- Notificar o responsável a cada processamento.
- Permitir reprocessar o mesmo período: sem isso, cada período roda uma única vez.
- Silenciar alerta de documento pendente.
- Piso de valor: Sem piso, Nunca menor que o último valor processado ou Nunca menor que o último e ATUALIZA o valor de cadastro. Não pode ser usado com valor vindo do contrato.
- Código de vínculo: código único na empresa, usado no assunto de e-mails para ligar a mensagem a este provisionamento.
- Anotação interna: instruções sobre o registro. Não vai ao cliente nem ao lançamento.
- Notificações automáticas (broadcast): quando ligado, o processamento dispara as automações gerais da empresa. Desligue para registros que não devem avisar ninguém, como aluguel. Se houver automação vinculada diretamente ao provisionamento, este campo fica desligado e só as vinculadas rodam.
Ativar e bloquear
No menu de ações (⋮), Ativar aparece em Rascunho e Bloqueado, e Bloquear aparece em Ativo. As duas pedem confirmação.
- Ativar: o provisionamento entra no processamento automático a partir da próxima rodada ("Provisionamento ativado").
- Bloquear: deixa de ser processado, pela rotina e manualmente, até ser ativado de novo. Nada é excluído e o histórico continua disponível.
Primeiro vencimento já passou
Se o provisionamento nunca foi processado e o primeiro vencimento já passou, a ativação é recusada: ativar faturaria um período vencido. A tela pede para você Ajustar o primeiro vencimento na edição. Outra saída é usar o processamento manual para gerar o ciclo em atraso.
Competências em atraso: gerar ou pular
Ao ativar um provisionamento que ficou parado, o sistema confere se há competências vencidas que não foram geradas. Se houver, abre a pergunta Competências em atraso, sem opção padrão: uma escolha cobraria o cliente sem ordem e a outra deixaria de faturar.
| Opção | O que acontece |
|---|---|
| Gerar as competências em atraso | Cada competência atrasada é gerada, uma por rodada da rotina automática, com o vencimento empurrado para 3 dias a partir da data de geração. O cliente pode receber vários documentos em dias seguidos. |
| Recomeçar no próximo ciclo | O atraso é pulado e o faturamento recomeça no primeiro ciclo ainda não vencido. Nenhum lançamento é gerado para as competências puladas e o contador de repetições não avança (um parcelamento de 12 continua devendo 12). |
As competências puladas ficam registradas em Ocorrências, na página do provisionamento, com os vencimentos. Para cobrar alguma delas depois, use Processar manualmente com a data de vencimento.
Cancelar fecha a pergunta sem ativar.
Ações do menu (⋮)
| Ação | Quando aparece | O que faz |
|---|---|---|
| Visualizar | Na lista | Abre os detalhes numa gaveta lateral. |
| Editar | Registro não inativado | Abre Editar Provisionamento. |
| Novo ciclo | Finalizado, fora de contrato | Pede o Nº total de repetições (maior que o já gerado, ou Sem fim) e volta o registro para Ativo. |
| Ativar / Bloquear | Fora de contrato | Troca a situação (veja acima). |
| Duplicar Provisionamento | Registro não inativado | Abre um novo formulário já preenchido. |
| Processar via arquivo | Ativo e com "Aguardar documento" | Envia o documento do ciclo e gera o lançamento (veja abaixo). |
| Gerenciar Canal de Ingestão | Quem pode criar canais de ingestão | Liga o provisionamento a um canal e mostra o Link do portal do fornecedor. O fornecedor envia o documento pelo portal e o sistema cria o lançamento (se o registro aguarda documento) ou anexa o documento ao lançamento já criado. |
| Gerenciar Automações | Quem pode criar automações | Vincula automações a este provisionamento, por exemplo um e-mail ao fornecedor autorizando a emissão da fatura. |
| Reprocessar automação | Ativo, com permissão de automações | Executa de novo as automações vinculadas, só deste registro ou de todos os ligados à mesma automação. Não gera novo lançamento. |
| Processar manualmente | Ativo | Gera um lançamento agora (veja abaixo). |
| Gerenciar no contrato | Provisionamento de contrato | Leva ao contrato, onde ativar, pausar, cancelar e excluir são feitos. |
| Inativar / Reativar | Fora de contrato | Inativar interrompe a geração automática de lançamentos. Reativar traz o registro de volta como Rascunho. |
Processar manualmente
Gera um lançamento fora da rotina. Só funciona com o provisionamento Ativo. Campos:
- Contar como processamento regular: ligado, avança o contador de repetições; desligado, é um lançamento extra que não afeta contadores.
- Vencimento customizado e Valor (vazio usa o valor configurado; obrigatório quando o provisionamento não tem valor padrão).
- Observações (uso interno) e Mensagem para o cliente (entra no e-mail deste ciclo, abaixo do texto padrão).
- Reprocessar o mesmo período: cria um novo lançamento para um período já processado (o anterior não é substituído). Só aparece se o provisionamento permitir reprocesso, e exige Motivo do reprocesso, que fica no histórico.
- Notas que faturam este ciclo: quando o provisionamento é disparado pela nota emitida, escolha ao menos uma nota emitida que ainda não esteja vinculada a um lançamento. Notas de outro cliente não podem ser usadas.
- Anexar arquivo ao ciclo (opcional).
Clique em Processar. Aparece "Lançamento gerado com sucesso".
Processar via arquivo
Envie XML, PDF, JPG ou PNG e escolha o Papel deste arquivo:
| Papel | O que o sistema faz |
|---|---|
| Documento Fiscal (Leitura Automática) | Lê o arquivo e extrai valor, vencimento e CNPJ. Prefira XML; PDF passa por leitura automática e pode não capturar tudo. O documento precisa ser da pessoa do provisionamento, ter a sua empresa (ou uma unidade de negócio vinculada) do lado certo e não pode ser uma nota que já gerou lançamento. Valor do lançamento em branco usa o valor lido. |
| Boleto do Lançamento | O arquivo é o boleto. Informe o valor; a linha digitável é lida do arquivo ou digitada por você. Sem ela, o boleto não vai anexado ao e-mail. |
| Anexo (Somente Comprovante) | O arquivo não é lido: só acompanha o lançamento e vai anexado no e-mail. Informe o valor. |
Acompanhando os ciclos
Cada ciclo gerado aparece na aba Histórico da página (e em Lançamentos Gerados, na gaveta Visualizar) com a sua situação:
- Ciclo completo: tudo o que estava configurado saiu (por exemplo, "nota nº 123", "cobrança gerada", ou "recebido sem cobrança registrada").
- Ciclo incompleto: mostra o que falta, como "falta gerar a cobrança", "falta emitir a nota fiscal", "faltam a nota fiscal e a cobrança" ou "a cobrança existe, mas sem boleto ou PIX para o cliente pagar".
Na página, os ciclos incompletos ficam também em Ciclos pendentes, na coluna lateral, com as ações:
| Ação | O que faz |
|---|---|
| Retomar | Executa o que ficou pendente e envia o e-mail ao cliente com a nota e os anexos do ciclo. Não gera outro lançamento nem adianta o contrato. Se o ciclo já estava completo, nada é executado. |
| Marcar como resolvido manualmente | Para ciclos resolvidos fora do sistema (cobrança emitida por fora, acerto direto com o cliente). O aviso some, mas o título continua em aberto. Aceita uma observação, guardada com o nome de quem marcou e a data. Pode ser desfeito em Desfazer marcação. |
| Reenviar comunicado | Reenvia o e-mail do ciclo com a nota e os anexos. Os campos vêm do último envio e o que você mudar vale só para este reenvio. Reenviar duas vezes envia dois e-mails. Não funciona se o ciclo não tem cobrança, se a cobrança já foi quitada ou cancelada, ou se o cliente não tem e-mail habilitado. |
Se a nota do ciclo está em rascunho esperando variáveis (selo "Rascunho"), retomar não resolve: abra a nota em Fiscal › Nota Fiscal, preencha e emita.
Pendências do ciclo
O relatório Pendências do ciclo (em Financeiro › Relatórios) reúne o que travou e depende de uma decisão sua, ordenado por vencimento. O que o sistema consegue refazer sozinho, ele refaz a cada 10 minutos. Motivos: Cobrança não nasceu, Emissão recusada pelo provedor, Nota rejeitada, Nota em rascunho, Cobrança parada, Cliente não foi avisado, Nota sem endereço do tomador, Nota sem arquivo, Cobrança sem o boleto arquivado e Título pago sem o documento. Cada motivo traz a ação para resolver: Retomar ciclo, Corrigir cadastro, Completar texto, Anexar documento, Resolver cobrança, Reenviar e-mail, Corrigir endereço ou Resincronizar arquivos.
Quando uma etapa falha na rotina automática, o sistema também avisa por notificação (por exemplo, "Falha no faturamento automático" ou "Ciclo de faturamento travado"), dizendo qual dado corrigir antes de retomar.
Provisionamentos de contrato
Quando o provisionamento pertence a um contrato, ele mostra a etiqueta Contrato com o código. Nesses registros:
- Ativar, pausar, cancelar, excluir e reativar são feitos no contrato. O menu mostra Gerenciar no contrato no lugar dessas ações.
- O cliente é o do contrato.
- Só provisionamento de receita pode ser a cobrança de um contrato.
- Se o contrato já está ativo, o provisionamento nasce ativo e fatura a partir do próximo ciclo.
Regras importantes
| Regra | Detalhe |
|---|---|
| Só Ativo fatura | Rascunho, Bloqueado, Finalizado e Inativo não processam, nem à mão. |
| Título único | Não pode haver dois provisionamentos ativos com o mesmo título na empresa. |
| Valor | Maior que zero, salvo com "Aguardar documento" ou "Aguardar liberação". Nunca negativo. |
| Datas travadas | Frequência e primeiro vencimento não mudam depois do primeiro lançamento gerado. O dia do vencimento dos próximos ciclos pode mudar; os lançamentos já gerados não mudam. |
| Processamento antes do vencimento | A data de processamento nunca pode cair depois do vencimento, e a antecedência tem teto por frequência. |
| Um período, uma vez | Sem "Permitir reprocessar o mesmo período", cada período roda uma única vez. Com ele, o reprocesso exige motivo e cria um lançamento novo. |
| Nota e cobrança só em receita | E a nota é sempre NFS-e. |
| Nota automática exige configuração | Sem emissão automática configurada na empresa, use "Disparar pela nota fiscal emitida". |
| Contrato manda | Em provisionamento de contrato, situação e cliente mudam pelo contrato. |
| Aviso sem comunicação | Se o ciclo gera o lançamento mas não há cobrança, nota nem automação para avisar o cliente, o sistema envia a notificação "Ciclo processado sem comunicação ao cliente". |
Permissões
| Ação | Permissão necessária em Provisão |
|---|---|
| Ver a lista e a página | Leitura |
| Novo, Duplicar, Processar manualmente | Criar |
| Editar, Ativar, Bloquear, Novo ciclo, Processar via arquivo, Reativar | Editar |
| Inativar | Excluir |
| Gerenciar Canal de Ingestão | Criar em Canal de Ingestão |
| Gerenciar e Reprocessar automações | Criar em Automação |
Perguntas frequentes
Salvei o provisionamento e nada foi gerado. Por quê?
Ele nasce como Rascunho, e rascunho não processa. Use Ativar no menu de ações. Depois disso, o primeiro lançamento nasce na data de processamento configurada, na rodada automática de madrugada.
Qual a diferença entre Bloquear e Inativar?
Bloquear pausa o faturamento e mantém o registro na lista, pronto para ser ativado. Inativar tira o registro das consultas padrão. Ao ser reativado, ele volta como Rascunho.
Apareceu "Já existe um provisionamento ATIVO com o título…".
Os títulos precisam ser únicos entre os provisionamentos ativos da empresa. Escolha outro título ou inative o registro que já usa esse nome.
Reativei um provisionamento parado há meses. Ele vai cobrar tudo de uma vez?
Não sem você decidir. Se houver competências em atraso, o sistema pergunta se deve gerá-las (uma por rodada, com vencimento 3 dias depois da geração) ou recomeçar no próximo ciclo ainda não vencido.
Posso mudar o valor de um mês só?
Sim. Use Processar manualmente e informe o valor daquele lançamento. O valor de cadastro não muda (a menos que o piso de valor esteja em "ATUALIZA o valor de cadastro").
Posso alterar o primeiro vencimento ou a frequência?
O primeiro vencimento e a frequência só mudam enquanto nenhum lançamento foi gerado. Depois disso, para mudar o dia dos próximos vencimentos, ajuste o Dia do vencimento: vale a partir do próximo ciclo e os lançamentos já gerados não mudam. Para mudar a frequência, inative o registro e crie outro.
Apareceu "Este período já foi processado".
Cada período roda uma única vez. Para gerar outro lançamento no mesmo período, ligue Permitir reprocessar o mesmo período na edição e use Processar manualmente com Reprocessar o mesmo período e o motivo. Ou desligue Contar como processamento regular para lançar um valor extra.
Não consigo ligar "Emitir nota fiscal a cada processamento".
A empresa não tem emissão automática de notas configurada. Configure em Sistema › Configurações › Configuração Fiscal, ou ligue Disparar pela nota fiscal emitida e emita a nota à mão a cada ciclo.
O arquivo enviado foi recusado por CNPJ diferente.
O documento precisa ser da pessoa do provisionamento e ter a sua empresa do lado certo: emitente em receita, destinatária em despesa. Confira se enviou o documento correto. Se o PDF não tiver CNPJ legível, envie o XML.
O ciclo ficou incompleto. Preciso refazer o lançamento?
Não. Use Retomar no ciclo: ele executa só o que faltou (nota, cobrança, e-mail) sem gerar outro lançamento.
A nossa equipe ajuda você a configurar e usar esse recurso.