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.
Rotina administrativa/financeira. O módulo de Finanças é liberado para os perfis Administrador e Financeiro.
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 da cobrança, informado como ano seguido do mês — por exemplo, julho de 2026 é escrito como 202607). 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.
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"
Acesse o menu Administrativo → Finanças (/finances) para abrir o painel de Finanças. Nele, 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, acessível pelo cartão "Cobrança Manual" do painel de Finanças (menu Administrativo → Finanças → "Cobrança Manual", rota /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 (o mês de referê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, no formato ano+mês (por exemplo,
202607para julho de 2026). - 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).
Quem pode acessar
O módulo de Finanças — e, portanto, a criação de cobranças — é liberado para os perfis Administrador e Financeiro.