Cadastro de Forma de Pagamento
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Formas de Pagamento > "Nova Forma" ou ícone Editar na lista Última atualização: 23/04/2026
Para que serve
Cria e edita formas de pagamento. Define como o cliente paga (tipo, código SEFAZ, parcelamento, taxa administrativa) e se o valor deve ser creditado automaticamente em uma conta caixa/banco no momento do faturamento (Liquidação automática). Formas cadastradas aqui são vinculadas às condições de pagamento e usadas na emissão de NF-e.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Para criar, clique em "Nova Forma" na Lista de Formas de Pagamento.
- Preencha os campos obrigatórios: Descrição, Tipo e Código SEFAZ.
- Ative "Permite Parcelamento" se a forma aceitar pagamento em parcelas; o campo "Max. Parcelas" aparecerá.
- (Opcional) No card Liquidação automática no faturamento, ligue o interruptor e selecione a conta caixa/banco de destino. Com isso, toda vez que essa forma for usada numa parcela de pedido faturado (NF-e autorizada), a conta a receber correspondente já nasce paga e o valor é creditado na conta escolhida.
- Clique em "Cadastrar Forma". 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 da Forma de Pagamento
| 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 forma de pagamento | Ex.: "PIX", "Cartão Visa Crédito" |
| Tipo | Sim | Dinheiro, Cheque, Cartão de Crédito, Cartão de Débito, Boleto Bancário, PIX, Transferência Bancária, Crediário, Vale ou Outros | Determina a categoria |
| Código SEFAZ (NF-e) | Sim | Código numérico da tabela SEFAZ | Ex.: 17 para PIX, 03 para Cartão de Crédito |
| Exige Autorização | Não | Liga/desliga | Indica se a forma exige autorização antes de ser aceita |
| Permite Parcelamento | Não | Liga/desliga | Default: desligado |
| Max. Parcelas | Sim (quando parcelamento ativo) | Número inteiro (1–99) | Aparece somente quando "Permite Parcelamento" está ligado |
| Taxa Adm. (%) | Não | Percentual (0–100) | Taxa administrativa cobrada pela operadora |
Seção: Liquidação automática no faturamento
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Habilitar liquidação automática | Não | Liga/desliga | Default: desligado. Quando ligado, a conta a receber gerada ao faturar um pedido com essa forma já nasce paga e o valor é creditado na conta escolhida abaixo. |
| Conta de destino (caixa ou banco) | Sim (quando liquidação automática está ligada) | Conta cadastrada em Contas Bancárias / Caixa | Somente contas ativas aparecem. Pode ser uma conta do tipo Caixa (para dinheiro em espécie), Corrente (para PIX que cai no banco), Poupança ou Outros. |
Quando usar: formas em que o cliente paga no ato (dinheiro no balcão, PIX instantâneo). Quando NÃO usar: cartão de débito/crédito via maquininha (repasse D+1/D+30), boleto, cheque, crediário — nesses casos a baixa deve ser manual após o recebimento efetivo.
Validações e regras
- Ao ativar "Permite Parcelamento", o campo "Max. Parcelas" torna-se obrigatório.
- Ao desativar "Permite Parcelamento", o campo "Max. Parcelas" some e seu valor é descartado.
- Ao ativar "Habilitar liquidação automática", o campo "Conta de destino" torna-se obrigatório.
- Ao desativar "Habilitar liquidação automática", a conta de destino deixa de ser exigida e é descartada no payload.
- Se a conta bancária vinculada for posteriormente inativada ou deletada, a liquidação automática falha silenciosamente no faturamento (a CR é criada aberta, sem quebrar a emissão da NF-e).
- Ao salvar em criação, o sistema navega para
/comercial/formas-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 forma de pagamento |
| "Selecione o tipo" | Tipo não selecionado | Escolha um tipo na lista |
| "Selecione o codigo" | Código SEFAZ não selecionado | Escolha o código correspondente ao tipo |
| "Informe o maximo" | Max. Parcelas vazio com parcelamento ativo | Informe o número máximo de parcelas |
| "Selecione a conta onde o valor deve entrar" | Liquidação automática ligada sem conta selecionada | Escolha uma conta ativa ou desligue a liquidação automática |
| "Conta de destino obrigatoria quando liquidacao automatica esta habilitada" | Validação do backend (mesma causa acima) | Selecione uma conta e salve novamente |
| "Conta bancaria esta inativa" | Conta de destino foi inativada após o cadastro | Reative a conta em Contas Bancárias / Caixa ou escolha outra |
| "Erro ao carregar forma de pagamento" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Erro ao salvar forma de pagamento" | Erro de validação ou conflito no backend | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
formasPagamentoService(formas-pagamento.service) - Formas de pagamento são vinculadas às Condições de Pagamento
- O Código SEFAZ é exigido pela NF-e na hora da emissão
- A conta de destino referencia Contas Bancárias / Caixa; quando a liquidação automática dispara, a baixa gerada aparece no Detalhe de conta a receber com a observação "Baixa automática — liquidação na emissão da NF-e" e o saldo da conta é atualizado imediatamente
Dúvidas frequentes
Qual código SEFAZ usar para PIX? 17 — PIX. Para boleto: 15. Para dinheiro: 01. Consulte a tabela do Manual de Orientação do Contribuinte (MOC) da SEFAZ.
Taxa Adm. é descontada automaticamente do pedido?
Quando a liquidação automática acontece? No momento em que a NF-e do pedido de venda é autorizada pela SEFAZ. A conta a receber da parcela é criada e a baixa é registrada dentro da mesma transação — se a emissão falhar, nada é gravado.
Posso ter PIX com liquidação automática e Cartão de Crédito sem? Sim. A flag é por forma de pagamento. Num mesmo pedido com "entrada em PIX + 2x no cartão", a parcela PIX já nasce paga e as duas do cartão ficam abertas aguardando baixa manual.
E se a parcela usar uma forma sem conta vinculada? A CR é criada normalmente como "aberta" — a baixa fica manual, sem diferença do comportamento original do sistema.
Histórico de alterações
| Data | Alteração |
|---|---|
| 23/04/2026 | Adicionada seção "Liquidação automática no faturamento" (toggle + conta de destino); integração com Contas Bancárias / Caixa. |
| 20/04/2026 | Documento inicial criado. |