Cadastro de Condição de Pagamento
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Condições de Pagamento > "Nova Condição" ou ícone Editar na lista Última atualização: 20/04/2026
Para que serve
Cria e edita condições de pagamento. Define como o valor de uma venda é distribuído no tempo: número de parcelas, dias de vencimento de cada parcela, percentual de entrada, juros, multa, desconto e formas de pagamento aceitas. Condições de pagamento são aplicadas em pedidos de venda, orçamentos e canais de venda.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Para criar, clique em "Nova Condição" na Lista de Condições de Pagamento.
- Preencha os campos obrigatórios: Descrição e Tipo.
- Configure o parcelamento na seção "Parcelas":
- Clique em "Parcela" para adicionar linhas.
- Informe os dias de vencimento e o percentual de cada parcela.
- Use "Distribuir Igual" para distribuir os percentuais igualmente.
- Na seção "Formas de Pagamento Aceitas", ative as formas desejadas e marque a principal.
- Clique em "Cadastrar Condição". O sistema redireciona para a tela de edição.
- Na edição, clique em "Salvar Alterações". A tela permanece aberta.
Campos da tela
Seção: Dados Gerais
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Gerado automaticamente | Exibido somente na edição; sequencial por tenant |
| Situação | Não | Ativa ou Inativa | Default: Ativa |
| Descrição | Sim | Nome da condição | Ex.: "30/60/90 dias" |
| Tipo | Sim | À Vista, À Prazo, Parcelado ou Entrada + Parcelas | Determina a estrutura |
| Gera Financeiro | Não | Liga/desliga | Default: ligado. Quando ativo, gera contas a receber ao confirmar pedidos |
| Exige Entrada | Não | Liga/desliga | Default: desligado |
| % Entrada | Sim (quando Exige Entrada ativo) | Percentual (0,01–100) | Aparece somente quando "Exige Entrada" está ligado |
| Dias 1º Venc. | Não | Inteiro ≥ 0 | Dias entre a emissão e o primeiro vencimento. Default: 0 |
| Intervalo (dias) | Não | Inteiro ≥ 0 | Intervalo padrão entre parcelas (usado ao adicionar nova parcela). Default: 30 |
| Juros (% a.m.) | Não | Percentual | Taxa de juros mensal por atraso |
| Multa (%) | Não | Percentual | Percentual de multa por atraso |
| Desconto (%) | Não | Percentual | Desconto para pagamento antecipado |
| Observações | Não | Texto livre | Campo aberto |
Seção: Parcelas
Tabela editável com as parcelas da condição. A soma dos percentuais deve ser exatamente 100%.
| Coluna | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| # | — | Número sequencial | Gerado automaticamente |
| Dias Vencimento | Sim | Inteiro ≥ 0 | Dias a partir da emissão para vencimento desta parcela |
| Percentual (%) | Sim | Valor numérico | Percentual do total da venda nesta parcela |
| Ações | — | Lixeira | Remove a parcela; mínimo 1 parcela |
Botão "Distribuir Igual": divide 100% igualmente entre todas as parcelas. O resíduo de arredondamento vai para a última parcela.
Seção: Formas de Pagamento Aceitas
Tabela com todas as formas de pagamento ativas. Para cada forma:
| Coluna | Descrição |
|---|---|
| Selecionar | Switch para incluir/excluir a forma desta condição |
| Descrição | Nome da forma de pagamento |
| Tipo | Tipo da forma |
| Cod. SEFAZ | Código SEFAZ da forma |
| Principal | Switch para marcar como forma principal (apenas uma por vez) |
Validações e regras
- A soma dos percentuais das parcelas deve ser exatamente 100% antes de salvar. O sistema valida e exibe a soma em tempo real (tag verde quando válida, vermelha quando inválida).
- Ao ativar "Exige Entrada", o campo "% Entrada" torna-se obrigatório.
- Deve haver ao menos 1 parcela.
- Ao salvar em criação, navega para
/comercial/condicoes-pagamento/:id/editar(replace: true). - Ao salvar em edição, o registro é recarregado da API sem fechar a tela.
- A navegação de volta pede confirmação se houver alterações não salvas.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe a descricao" | Campo Descrição vazio | Preencha o nome da condição |
| "Selecione o tipo" | Tipo não selecionado | Escolha o tipo de condição |
| "Informe o percentual" | % Entrada vazio com Exige Entrada ativo | Informe o percentual de entrada |
| "Soma dos percentuais deve ser 100%. Atual: X%" | Parcelas não somam 100 | Ajuste os percentuais ou use "Distribuir Igual" |
| "Erro ao carregar condicao de pagamento" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Erro ao salvar condicao de pagamento" | Erro de validação ou conflito no backend | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
condicoesPagamentoService(condicoes-pagamento.service) - Serviço auxiliar:
formasPagamentoService(carrega formas de pagamento ativas para vinculação) - Condições são usadas nos Pedidos de Venda, Orçamentos, Canais de Venda e Regiões de Venda
Dúvidas frequentes
Por que a tag de soma fica vermelha? Os percentuais das parcelas não somam exatamente 100%. Clique em "Distribuir Igual" ou ajuste manualmente.
Posso vincular várias formas de pagamento? Sim. Uma condição pode aceitar múltiplas formas (ex.: "30/60" pode aceitar boleto e PIX). Marque a forma preferencial como "Principal".
O que acontece se eu não vincular nenhuma forma? A condição pode ainda ser usada, mas o pedido precisará especificar a forma de pagamento individualmente.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |