Skip to main content

Criação de cobranças para um usuário

Este documento explica como criar uma cobrança avulsa para um usuário — por exemplo, a venda de um produto, uma taxa, uma diária ou qualquer valor que não seja gerado automaticamente por um contrato.

Perfil indicado

Rotina administrativa/financeira. O módulo de Finanças é liberado para os perfis Administrador e Financeiro (capacidade view_finances_module).

O que é uma cobrança​

No sistema, uma cobrança é representada por um movimento financeiro: um lançamento de débito/crédito, sempre vinculado a um usuário e a uma Competência (o mês de referência, no formato AAAAMM). Quando você cria uma cobrança manualmente, está gerando um novo movimento financeiro com Origem "manual".

Todo movimento distingue quem gera de quem paga:

  • Usuário de origem (gera) — o usuário ao qual a cobrança está relacionada, quem "originou" o valor.
  • Usuário cobrado (paga) — o usuário que efetivamente é cobrado e paga o movimento.
Preenchimento automático de quem paga

Quando apenas o Usuário de origem é informado, o Usuário cobrado assume por padrão o usuário cobrável do usuário de origem. Assim, se um dependente gera a cobrança, quem paga pode ser o titular responsável definido em seu cadastro. O sistema exibe um aviso quando o usuário cobrável é diferente do usuário atendido, permitindo alternar rapidamente para ele.

Onde criar a cobrança​

Existem dois pontos de entrada, ambos abrindo o mesmo formulário de movimento financeiro.

1. Painel de Finanças → "Incluir Cobrança"​

No painel de Finanças (Dashboard financeiro), o cartão "Incluir Cobrança" ("Adicionar um valor a ser cobrado de um usuário") abre o formulário já configurado com Origem "manual", indicando que se trata de uma cobrança avulsa criada manualmente (e não gerada por contrato, turma etc.).

2. Página de Cobrança → "Inclur movimento"​

Na página de cobrança manual (/billing), com um usuário já selecionado, o botão "Inclur movimento" abre o mesmo formulário, porém já pré-preenchendo:

  • Usuário de origem com o usuário atendido;
  • Usuário cobrado com o usuário cobrável desse usuário;
  • Competência com o mês seguinte;
  • Quantidade igual a 1;
  • Origem "manual".

Preenchendo o formulário​

Os campos mais relevantes de um movimento financeiro são:

  • Usuário de origem / Usuário cobrado — conforme explicado acima.
  • Competência — o mês de referência da cobrança (AAAAMM).
  • Valor unitário e Quantidade — o total é calculado a partir de Valor unitário × Quantidade.
  • Valor adicional / Valor desconto — ajustes sobre o valor.
  • Data do pagamento — deixada em branco enquanto a cobrança estiver em aberto.

Após salvar, o movimento passa a aparecer para o usuário e pode ser efetivamente recebido na página de cobrança manual (veja Cobrança manual).

Restrições de acesso​

  • O módulo de Finanças é liberado pela capacidade view_finances_module (perfis legados ADMINISTRATOR e FINANCIAL).
  • Para criar um movimento é necessária a permissão ADD sobre finances.FinancialMovement.
Dois sistemas de permissão

As permissões podem ser aplicadas via modelo legado (user_type) ou via capabilities do Django, dependendo do permission_mode de cada usuário. Veja Restrições de acesso e permissões para o detalhamento.