Pular para o conteúdo principal

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çãoO que significa
RascunhoRecém-criado ou reativado. Não processa, nem pela rotina automática nem manualmente.
AtivoEntra na rotina automática e pode ser processado à mão.
BloqueadoPausado de propósito. Não processa até ser ativado de novo. Nada é excluído.
FinalizadoTodas 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.
InativoFoi 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​

  1. Em Financeiro › Provisão, clique em Novo. A gaveta se chama Nova Receita Recorrente ou Nova Despesa Recorrente, conforme o tipo.
  2. Preencha as seções do formulário (detalhadas abaixo). No topo, o campo Situação vem como Rascunho; você pode escolher Ativo ou Bloqueado.
  3. Confira a prévia dos Próximos ciclos e o resumo em texto do que vai acontecer.
  4. Clique em Salvar. Aparece "Provisionamento criado com sucesso".
  5. 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​

CampoObrigatórioDescrição
TipoSimReceita ou Despesa. Nota fiscal e cobrança só existem em receita.
Cliente / FornecedorSimPessoa do provisionamento. Em provisionamento de contrato, é o cliente do contrato e só muda pelo contrato.
TítuloSimNome do provisionamento. Não pode repetir o título de outro provisionamento ativo da empresa.
Modelo do título do lançamentoNãoComo 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çãoNãoCopiada para o lançamento de cada ciclo. Não vai para o e-mail do cliente.
ValorSimPrecisa ser maior que zero, exceto quando o valor depende de documento ou liberação (veja "Aguardar documento" abaixo). Nunca negativo.
Origem do valorSó em provisionamento de contratoValor 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 financeiraNãoSe ficar vazia, usa a categoria padrão do tipo.

Recorrência​

CampoDescrição
FrequênciaDiá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 vencimentoNã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.
VencimentoRegra 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 útilPadrã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 processarO 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çõesQuantos 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​

CampoDescrição
Forma de pagamento / Forma de recebimentoComo o valor é pago ou recebido. Obrigatório.
Conta bancáriaConta 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.
Cadastro do cliente

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çãoO que acontece
Gerar as competências em atrasoCada 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 cicloO 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çãoQuando apareceO que faz
VisualizarNa listaAbre os detalhes numa gaveta lateral.
EditarRegistro não inativadoAbre Editar Provisionamento.
Novo cicloFinalizado, fora de contratoPede o Nº total de repetições (maior que o já gerado, ou Sem fim) e volta o registro para Ativo.
Ativar / BloquearFora de contratoTroca a situação (veja acima).
Duplicar ProvisionamentoRegistro não inativadoAbre um novo formulário já preenchido.
Processar via arquivoAtivo e com "Aguardar documento"Envia o documento do ciclo e gera o lançamento (veja abaixo).
Gerenciar Canal de IngestãoQuem pode criar canais de ingestãoLiga 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çõesQuem pode criar automaçõesVincula automações a este provisionamento, por exemplo um e-mail ao fornecedor autorizando a emissão da fatura.
Reprocessar automaçãoAtivo, com permissão de automaçõesExecuta de novo as automações vinculadas, só deste registro ou de todos os ligados à mesma automação. Não gera novo lançamento.
Processar manualmenteAtivoGera um lançamento agora (veja abaixo).
Gerenciar no contratoProvisionamento de contratoLeva ao contrato, onde ativar, pausar, cancelar e excluir são feitos.
Inativar / ReativarFora de contratoInativar 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:

PapelO 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çamentoO 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çãoO que faz
RetomarExecuta 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 manualmentePara 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 comunicadoReenvia 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​

RegraDetalhe
Só Ativo faturaRascunho, Bloqueado, Finalizado e Inativo não processam, nem à mão.
Título únicoNão pode haver dois provisionamentos ativos com o mesmo título na empresa.
ValorMaior que zero, salvo com "Aguardar documento" ou "Aguardar liberação". Nunca negativo.
Datas travadasFrequê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 vencimentoA data de processamento nunca pode cair depois do vencimento, e a antecedência tem teto por frequência.
Um período, uma vezSem "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 receitaE a nota é sempre NFS-e.
Nota automática exige configuraçãoSem emissão automática configurada na empresa, use "Disparar pela nota fiscal emitida".
Contrato mandaEm provisionamento de contrato, situação e cliente mudam pelo contrato.
Aviso sem comunicaçãoSe 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çãoPermissão necessária em Provisão
Ver a lista e a páginaLeitura
Novo, Duplicar, Processar manualmenteCriar
Editar, Ativar, Bloquear, Novo ciclo, Processar via arquivo, ReativarEditar
InativarExcluir
Gerenciar Canal de IngestãoCriar em Canal de Ingestão
Gerenciar e Reprocessar automaçõesCriar 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.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.