Cobrança manual
A cobrança manual é a rotina usada no balcão para receber, estornar ou deletar valores de um usuário. Ela é feita na página "/billing" (BillingPage), acessível pelo item de menu "Cobrança Manual".
Rotina administrativa/financeira, liberada para os perfis Administrador e Financeiro (capacidade view_finances_module).
Visão geral da tela
A tela é dividida em duas áreas:
- Coluna de controle (à esquerda) — onde você busca o usuário, escolhe a operação, seleciona a forma de pagamento e confirma.
- Lista de documentos e movimentos (à direita) — os documentos financeiros e movimentos do usuário, que você seleciona para a operação.
Fluxo passo a passo
1. Buscar Usuário
Clique em "Buscar Usuário" para abrir a busca e selecionar a pessoa a ser atendida. A página também pode ser aberta já com um usuário pré-carregado (por exemplo, ao vir de outra tela via ?user_id=).
Se o usuário atendido tiver um usuário cobrável diferente dele mesmo, a tela exibe um aviso destacando quem é o responsável financeiro. Clicando nesse aviso, você alterna a cobrança para o usuário cobrável.
2. Escolher a operação
Selecione uma das operações no seletor:
- Receber (
bill) — registra o recebimento dos valores selecionados. - Estornar (
reverse) — estorna valores já recebidos. - Deletar (
delete) — remove movimentos/documentos ainda em aberto.
A operação escolhida filtra automaticamente o que aparece na lista à direita (por exemplo, "Receber" mostra apenas documentos e movimentos ainda não pagos; "Estornar" mostra apenas os que já possuem valor recebido).
3. Selecionar documentos e/ou movimentos
- Documentos financeiros — faturas já compiladas (por exemplo, boletos). Ao selecionar um único documento na operação "Receber", o sistema ainda oferece as "Opções de pagamento" cadastradas para facilitar a cobrança.
- Movimentos financeiros — cobranças que ainda não foram compiladas em um documento. É possível selecionar vários de uma vez ("Selecionar todos").
Durante a operação "Receber" você ainda pode:
- Alterar o valor de um movimento individualmente (o sistema recalcula acréscimo/desconto automaticamente);
- Calcular juros aplicando uma porcentagem a todos os movimentos selecionados.
A coluna de controle mostra em tempo real a Data do Recebimento, a quantidade de Movimentos Selecionados e o Valor à Receber.
4. Escolher a forma de pagamento
Na operação "Receber", selecione o Método de pagamento. A lista é filtrada para exibir apenas os métodos com allow_manually_billing habilitado — ou seja, somente os meios autorizados para cobrança manual aparecem, evitando o uso indevido de formas que não devem ser operadas no balcão.
5. Confirmar
Clique em "Confirmar Transação". O sistema pede uma confirmação exibindo o valor total e a quantidade de movimentos. Ao confirmar a operação de recebimento, é gerado um recibo dos documentos processados.
O botão de confirmação fica desabilitado enquanto nenhum movimento estiver selecionado ou, no caso de "Receber", enquanto nenhuma forma de pagamento tiver sido escolhida.
Restrições de acesso
- Página liberada pela capacidade
view_finances_module(perfis legados ADMINISTRATOR e FINANCIAL). - Salvar um
FinancialDocumentexige, no mínimo, acesso de nível Colaborador (Collaborator).
Consulte também Criação de cobranças para um usuário e Restrições de acesso e permissões.