Contas¶
A tela Contas é o local central para gerenciar toda a atividade de Contas a Receber (AR) e Contas a Pagar (AP) sem precisar navegar até cada registro individual de cliente ou fornecedor. Reúne o resumo de saldo, o livro de pagamentos e (para AR) o agendamento de cobrança em uma única visão cruzada entre pessoas.
Como abrir¶
- Menu: Financeiro → Contas
- Atalho:
Ctrl+Shift+A
Abas¶
A tela tem duas abas principais:
- A Receber (AR) — clientes que devem para você (ou a quem você deve um reembolso).
- A Pagar (AP) — fornecedores para quem você deve (ou que devem um reembolso).
Ambas compartilham o mesmo enquadramento: seletor de modo, controles de filtro, um grid e uma barra de totais.
Modos¶
O seletor de modo (canto superior esquerdo) alterna entre duas visões:
Modo pessoa¶
Lista clientes (AR) ou fornecedores (AP) que satisfazem o filtro selecionado. Cada linha mostra um resumo financeiro. Clicar na linha expande um painel com o livro de pagamentos daquela pessoa, e (para AR) um formulário de agendamento de cobrança.
Filtros do modo pessoa:
| Filtro | Descrição |
|---|---|
| Saldo negativo | Saldo abaixo da tolerância (padrão: 0). Em AR, são clientes que devem. Uma tolerância de -100 retorna apenas pessoas com saldo abaixo de -100 — ou seja, devendo mais de 100. |
| Saldo positivo | Saldo acima da tolerância. Em AR, são clientes a receber crédito. Uma tolerância de 100 retorna apenas pessoas com saldo acima de 100. |
| Todas as pessoas | Todos os registros ativos + inativos. Busca por nome opcional. |
| Pagou na data | Pessoas que tiveram pagamento recebido/pago em uma data específica. |
| Instruções de cobrança | (somente AR) Clientes com instruções de cobrança preenchidas. |
Modo pagamento¶
Lista pagamentos individuais entre todas as pessoas (não agrupados). Usado para encontrar pagamentos vencidos, pendentes ou dentro de um intervalo de datas específico.
Filtros do modo pagamento:
| Filtro | Descrição |
|---|---|
| Vencidos | Data de vencimento no passado, ainda não recebido (AR) ou pago (AP). |
| Pendentes | Data de vencimento hoje ou no futuro, ainda não recebido/pago. |
| Durante o período | Pagamentos recebidos/pagos dentro de um intervalo de datas, além de pagamentos com vencimento nesse intervalo ainda não recebidos/pagos. |
Cores da data de vencimento: no modo pagamento, a coluna Vencimento recebe cor quando o pagamento ainda não foi quitado (sem data de recebimento/pagamento):
- Vermelho — vencido (data de vencimento no passado).
- Âmbar/negrito — vence hoje.
- Verde — pendente, com vencimento futuro.
Quando o pagamento é registrado como recebido/pago, a cor é removida.
Editar um pagamento no modo pagamento: cada linha possui os mesmos botões ✎ Editar e 🗑 Excluir da grade de pagamentos do modo pessoa. Clicar em ✎ (ou em qualquer outra parte da linha, como atalho) abre o modal de pagamento pré-carregado com aquele único pagamento. 🗑 pede confirmação e, em seguida, exclui o pagamento.
Marcar rapidamente como recebido
Quando o modal é aberto pelo modo pagamento e o pagamento ainda não tem data de recebimento/pagamento, o campo é preenchido automaticamente com a data de hoje. Salve sem alterar nada para registrar o recebimento com um clique adicional. Limpe o campo antes de salvar caso queira usar uma data diferente.
Como os saldos são calculados¶
- Saldo AR = Σ pagamentos recebidos − Σ valor dos materiais entregues.
- Saldo AP = Σ pagamentos feitos − Σ valor de todas as ordens de compra. Ordens de compra pendentes são debitadas assim que lançadas na tela Pedidos de Compra, mesmo que ainda não tenham sido marcadas como RECEBIDAS. Ordens com data futura reduzem o saldo do fornecedor imediatamente.
Referência de colunas — modo pessoa AR¶
| Coluna | Descrição |
|---|---|
| Nome | Nome do cliente. |
| Saldo | Saldo atual. Vermelho quando negativo (cliente deve); verde quando positivo. |
| Saldo Futuro | (coluna extra) Saldo incluindo todos os pagamentos pendentes não recebidos. |
| Total Comprado | (coluna extra) Soma de todos os pedidos e vendas rápidas. |
| Média Dias p/ Pagar | (coluna extra) Média de dias entre a data do pedido e a data em que o pagamento foi recebido. |
| % Dívida | (coluna extra) abs(saldo) / total_comprado × 100. |
| Dias Desde Pagamento | Dias desde o último pagamento recebido. Vermelho tênue acima de 30 dias; vermelho sólido acima de 60. |
| ⚠ | Ícone quando o cliente não possui pagamentos registrados. |
| Próx. Cobrança | Próxima data de cobrança agendada. |
| Instruções de Cobrança | Texto livre do agendamento de cobrança (truncado). |
Use o seletor Mostrar mais colunas para revelar as colunas extras.
Referência de colunas — modo pessoa AP¶
| Coluna | Descrição |
|---|---|
| Nome | Nome do fornecedor. |
| Saldo | Saldo atual. Vermelho quando negativo; verde quando positivo. |
| Saldo Futuro | (coluna extra) Saldo incluindo todos os pagamentos pendentes não pagos. |
| Total Comprado | Soma de todos os valores de ordens de compra, incluindo ordens ainda não recebidas. |
| Média Dias p/ Pagar | (coluna extra) Média de dias entre a data da ordem de compra e a data em que foi pago. |
| Dias Desde Pagamento | (coluna extra) Dias desde o último pagamento feito. |
Popup de contato¶
Cada linha das grades de pessoas (AR e AP) tem um ícone ⓘ no início. Clique para abrir um pequeno popup com os dados de contato da pessoa (nome de contato, telefone, e-mail, endereço, CEP, CPF/CNPJ, observações) sem sair da tela nem expandir o painel. O popup é somente leitura — para editar as informações, use as telas Clientes ou Fornecedores.
Painel de expansão¶
Clicar em uma linha no modo pessoa expande um painel abaixo dela.
Seção Pagamentos¶
O painel contém o livro de pagamentos da pessoa com um filtro de status (Todos / Recebidos-ou-Pagos / Pendentes) e um botão Adicionar que abre o modal de pagamento. Os botões de edição (✎) e exclusão (🗑) ficam ao final de cada linha. Clicar em qualquer outra parte da linha é um atalho equivalente a ✎.
O modal de pagamento troca automaticamente o comportamento conforme a aba ativa: AR usa o modal de cliente (com cheques, incluindo o fluxo de cheques em lote ao adicionar); AP usa o de fornecedor (com número de parcela, sem cheques).
Registrar uma data de recebimento/pagamento anterior a hoje exige
permissão sales:manage ou owner — consulte a referência
Modal de Pagamento para as
regras de permissão completas.
Descontos são créditos, não débitos
Um pagamento DESCONTO é um crédito positivo, não um valor negativo.
Se o pedido de um cliente totaliza 203,65 e ele arredonda para 200,00,
lance um pagamento DINHEIRO de 200,00 e um pagamento DESCONTO de
3,65 — ambos lançados como valores positivos. Um acréscimo seria
o negativo.
Agendamento de cobrança (somente AR)¶
Abaixo da seção de pagamentos, linhas AR exibem um formulário de agendamento de cobrança com três campos:
- Próxima Data de Cobrança — Data programada para a próxima cobrança.
- Responsável — Usuário responsável pelo follow-up.
- Instruções — Texto livre.
O botão Salvar Dados de Cobrança salva os três campos em uma única requisição e atualiza o grid.
Limpeza automática quando o cliente não tem mais dívida
A próxima data de cobrança, o responsável e as instruções são automaticamente limpos sempre que o saldo do cliente é recalculado e fica zero ou positivo. Quando o cliente não está mais em débito, as informações de cobrança deixam de ser relevantes e são reiniciadas.
Após editar um pagamento¶
Quando um pagamento é adicionado, editado ou excluído pelo painel expandido, a linha da pessoa correspondente na grade acima é atualizada no lugar — saldo, saldo futuro, dias desde o último pagamento e campos de cobrança são atualizados sem re-executar a busca e sem perder a posição de rolagem. O painel expandido permanece aberto na mesma pessoa, permitindo continuar o trabalho.
Caso a alteração faça com que a pessoa deixe de atender ao filtro ativo (por exemplo, o saldo passa de negativo para zero com o filtro Saldo negativo ativo), a linha permanece visível com os valores atualizados — saldo verde, etc. — para que você veja o que acabou de acontecer. Clique em Buscar novamente para limpar registros que não correspondem ao filtro.
Edições que não alteram o saldo (apenas data de vencimento, forma, observações, etc.) dispensam a atualização da linha e economizam uma ida ao servidor.
Cores do saldo¶
- Vermelho — saldo negativo (cliente deve; você deve ao fornecedor).
- Verde — saldo positivo (cliente em crédito; fornecedor deve um reembolso).
- Neutro — saldo zero.
Cores dos dias desde pagamento¶
- Vermelho sólido — mais de 60 dias desde o último pagamento.
- Vermelho tênue — 31–60 dias.
- Neutro — 30 dias ou menos.
Barra de totais¶
A barra de totais no rodapé soma os saldos de todas as pessoas ativas no grid atual. Registros inativos ficam com opacidade reduzida e não entram na soma.
Marcadores¶
- ⚠ (Nenhum pagamento registrado) — exibido para clientes sem pagamentos registrados. Geralmente indica uma conta há muito tempo dormente ou um problema de dados.
Pessoas inativas¶
Clientes e fornecedores inativos continuam aparecendo em todos os filtros, porém com opacidade reduzida. São excluídos da barra de totais.
Impressão de carta de cobrança
A geração de cartas para contas vencidas ainda não está disponível. Será adicionada em uma versão futura como parte dos recursos de geração de documentos, usando o agente de IA específico do tenant.