Modal de Pagamento¶
O Modal de Pagamento é o diálogo compartilhado em todo o Sofie para registrar e editar tanto pagamentos de clientes (Contas a Receber) quanto pagamentos a fornecedores (Contas a Pagar). É aberto automaticamente a partir das telas Clientes, Fornecedores e Contas.
Esta página descreve os campos, as diferenças AR/AP, o fluxo de cheques em lote e os cenários de lançamento mais nuançados.
Como abrir¶
| Origem | Como |
|---|---|
| Clientes → aba Pagamentos | Botão Adicionar para criar, ou ✎ na linha para editar. |
| Fornecedores → aba Pagamentos | Igual a Clientes. |
| Contas (modo pessoa) | Botão Adicionar no painel expandido ou ✎ na linha do pagamento. |
| Contas (modo pagamento) | Clique em qualquer linha para editar aquele pagamento. |
O modal alterna automaticamente entre as variantes AR e AP:
- Variante AR (Clientes, aba Contas a Receber) — exibe a seção de cheques. O campo da data de recebimento é rotulado Data Recebida.
- Variante AP (Fornecedores, aba Contas a Pagar) — exibe o campo de número da parcela. O campo da data é rotulado Data Paga.
Campos¶
| Campo | Descrição |
|---|---|
| Ref. nº pedido | Referência opcional a um pedido de venda (AR) ou ordem de compra (AP). Use 0 se o pagamento não estiver associado a um pedido específico. Vários pagamentos com a mesma referência são agrupados para conciliação. Texto livre — aceita qualquer notação, não apenas números. |
| Parcela nº (somente AP) | Texto livre indicando a parcela, ex.: 2/3 para a segunda de três. Útil ao pagar uma fatura de fornecedor em partes. |
| Forma | Forma de pagamento. Sugestões pré-carregadas: CHEQUE, DINHEIRO, PIX, BOLETO, CARTÃO, TRANSFERÊNCIA. Digite outra à vontade. |
| Valor | Valor do pagamento. Sempre positivo — inclusive descontos (veja abaixo). |
| Data de vencimento | Quando o pagamento vence/venceu. Opcional, mas recomendado. |
| Data Recebida (AR) / Data Paga (AP) | Quando o pagamento foi efetivado. Deixe em branco para pagamento pendente. Limitada ao momento atual — datas futuras não são aceitas. |
| Observações | Notas livres sobre o pagamento. |
Seções específicas por forma de pagamento¶
Quando a Forma corresponde a um dos tipos suportados, uma seção adicional aparece abaixo:
- CHEQUE (somente AR) — veja o fluxo de cheques em lote abaixo para adicionar novos pagamentos em cheque, ou os campos do cheque diretamente ao editar.
- PIX, BOLETO, CARTÃO — cada um abre uma área de Notas para informações específicas da forma de pagamento (chave PIX / ID da transação / código de barras / código de autorização / número de parcelas etc.). As notas são gravadas no campo Observações do pagamento.
Fluxo de cheques em lote (somente AR)¶
Ao definir a Forma como CHEQUE durante a adição de um novo
pagamento, o modal alterna para o modo lote — desenhado para o caso
comum de um cliente entregar vários cheques de uma só vez referentes ao
mesmo pedido e com o mesmo vencimento.
O modo lote tem três seções:
- Sessão — campos compartilhados por todo o lote:
- Ref. nº pedido
- Data de vencimento
- Dados do cheque — campos preenchidos por cheque:
- Valor
- Data Recebida
- Pré-datado para (data de pré-datação, se houver)
- CPF/CNPJ — o botão de autopreencher consulta os cheques mais recentes do pagador e os oferece como pré-preenchimento (banco, agência, conta, nome).
- Nome no cheque, Banco, Agência, Conta, Nº do Cheque.
- Adicionados — a lista de cheques na fila para gravação, com botão ✕ em cada linha para remover.
Como registrar um lote¶
- Escolha CHEQUE como Forma — o modal alterna para o layout em lote.
- Preencha os campos da Sessão (Ref. nº pedido e Data de vencimento) — eles valem para todos os cheques do lote.
- Preencha os Dados do cheque do primeiro cheque e clique em Adicionar. O cheque aparece na lista Adicionados e os campos ficam pré-preenchidos com os valores anteriores para o próximo cheque — apenas Nº do Cheque e Pré-datado para são limpos (eles sempre mudam de cheque para cheque).
- Repita o passo 3 para cada cheque.
- Quando a lista estiver completa, clique em Salvar Todos (n) para gravar todos. Cada cheque vira um registro de pagamento separado na conta do cliente.
Da primeira vez que um cliente entrega um lote de cheques, os campos banco/agência/conta começam vazios. Após o primeiro lote ser gravado, ao abrir o modal novamente para esse cliente, esses campos vêm pré-preenchidos com base no cheque mais recente do cliente (consultado pelo CPF/CNPJ), de modo que lotes seguintes já começam com o banco preenchido. O campo Data Recebida é preenchido automaticamente com o momento atual.
Cancelar a partir do modo lote¶
O botão Cancelar do modo lote é em duas etapas:
- Primeiro clique — sai do modo lote e volta ao modo simples. O campo Forma é limpo para que você escolha outra forma, ou clique em Cancelar novamente.
- Segundo clique (ou o × no cabeçalho) — fecha o modal.
Editando um pagamento em CHEQUE existente¶
Ao editar um pagamento em cheque existente (clicando em ✎ na linha), o modal permanece em modo simples — você edita o registro do pagamento junto com seus campos de cheque na própria tela. O modo lote vale apenas para novas entradas.
Permissões¶
Restrição de retroatividade¶
O campo Data Recebida / Data Paga não pode ser definido com data anterior a hoje, a menos que o usuário tenha o privilégio owner ou sales:manage. Usuários sem esse privilégio que tentarem salvar um pagamento retroativo recebem o erro "Apenas proprietários podem registrar uma data de pagamento anterior a hoje".
A regra vale tanto na criação quanto na edição — um usuário sem privilégio não pode mover um pagamento pendente para uma data passada de recebimento na mesma alteração.
Edição de pagamentos antigos¶
Usuários sem privilégio não podem editar um pagamento cuja Data Recebida já é anterior a hoje (a linha aparece sem botões de ação no grid). Proprietários podem editar qualquer pagamento, independentemente da data.
Datas futuras¶
Datas futuras são bloqueadas para todos — não há exceção por
privilégio. A regra é aplicada tanto pelo atributo max do campo de
data no cliente quanto pela API ao gravar.
Marcar rapidamente como recebido¶
Quando o modal é aberto pelo modo pagamento da tela Contas, o campo Data Recebida / Data Paga é preenchido automaticamente com a data de hoje se estiver vazio. Salvar sem mudar mais nada registra o recebimento em um clique. Limpe o campo antes de salvar caso o pagamento tenha sido recebido em outra data.
Cenários de lançamento¶
O modal é flexível — vários pagamentos podem ser combinados para registrar situações mais elaboradas.
Desconto no momento do pagamento¶
A conta de um cliente totaliza 203,65 mas ele arredonda para 200,00. Lance dois pagamentos contra o mesmo pedido:
| Ref. nº pedido | Forma | Valor | Data Recebida |
|---|---|---|---|
| 899 | DINHEIRO | 200,00 | 26/04/2026 |
| 899 | DESCONTO | 3,65 | 26/04/2026 |
Ambos são positivos — o desconto é tratado como crédito, não como valor negativo. Assim, o total da caixa pequena fecha. Um acréscimo seria o caso negativo.
Onde aplicar descontos idealmente
Descontos e acréscimos costumam ser aplicados diretamente no pedido, na tela de Pedidos e Orçamentos, no momento da venda. O padrão de dois pagamentos acima é para situações em que o pedido já foi entregue e não pode ser modificado.
Cheque + dinheiro em um mesmo acerto¶
Um cliente acerta um pedido de 2.550,00 com um cheque de terceiro de 2.539,10 e 10,90 em dinheiro. Lance dois pagamentos:
| Ref. nº pedido | Forma | Valor | Data Recebida |
|---|---|---|---|
| 657 | CHEQUE | 2.539,10 | 26/04/2026 |
| 657 | DINHEIRO | 10,90 | 26/04/2026 |
O pagamento em CHEQUE abre o modo lote para registrar os dados do cheque (banco, agência, conta, número do cheque, CPF/CNPJ do titular).
Pagamento em bloco para vários pedidos¶
Um cliente paga 4.000,00 referente a quatro pedidos em aberto (1055, 1066, 1111, 1212) usando dois cheques e o restante em dinheiro. Os valores dos cheques não dividem exatamente entre os pedidos. Lance três pagamentos todos contra o primeiro pedido, listando os demais números em Observações:
| Ref. nº pedido | Forma | Valor | Data Recebida | Observações |
|---|---|---|---|---|
| 1055 | CHEQUE | 1.500,00 | 26/04/2026 | Ref. 4 pedidos 1055, 1066, 1111, 1212 |
| 1055 | CHEQUE | 1.500,00 | 26/04/2026 | Ref. 4 pedidos 1055, 1066, 1111, 1212 |
| 1055 | DINHEIRO | 1.000,00 | 26/04/2026 | Ref. 4 pedidos 1055, 1066, 1111, 1212 |
Agrupar tudo no pedido 1055 mantém o histórico do cliente organizado. Lançar números diferentes em cada linha espalharia os pagamentos pelo extrato.
Os dois cheques podem ser entrados numa única sessão de lote — escolha CHEQUE como Forma, defina Ref. nº pedido e Data de vencimento uma só vez, depois Adicione cada cheque e Salve Todos. O pagamento em dinheiro é gravado em seguida como um pagamento separado em modo simples.