Como cadastrar formas de pagamento, adquirentes e taxas de cartão#

Esta página resolve a base do recebimento: quais formas o caixa aceita, quem são as credenciadoras, qual taxa cada bandeira e modalidade custa e em quantos dias o dinheiro cai. Quem opera: o responsável financeiro, com o responsável da loja.

Antes de começar — você precisa de:

permissão financeiro.forma_pagamento para Formas de pagamento;
permissão financeiro.conciliacao para Adquirentes e Taxas de cartão;
o contrato ou o extrato da adquirente com as taxas praticadas por bandeira e modalidade.

Parte 1 — Formas de pagamento#

Passo a passo#

Abra Financeiro > Formas de pagamento.
Clique em Incluir forma.
Informe o Nome e o Código.
Escolha o Tipo.
Marque os comportamentos: Trabalha com TEF, Exige autorização (NSU/cód.), Permite troco, Abre a gaveta, A prazo (fiado/crediário).
Se for cartão, informe a Taxa da adquirente (%) e o Prazo de recebimento (dias).
Informe a Adquirente e a Ordem no PDV.
Deixe Forma ativa marcado e salve.

Campos e o que significam#

Campo	O que é	Observação
Nome *	nome que aparece no caixa	ex.: "Cartão de crédito"
Código *	código da forma	ex.: `CARTAO_CREDITO`. Os dois primeiros são obrigatórios
Tipo	a natureza da forma	`Dinheiro`, `Pix`, `Cartão de débito`, `Cartão de crédito`, `Fiado / crediário`, `Vale (alimentação/refeição)`, `Cheque`, `Outros`
Trabalha com TEF	usa terminal TEF	a forma entra no filtro Com TEF
Exige autorização (NSU/cód.)	exige NSU ou código de autorização	evita fechar cartão sem comprovante
Permite troco	a forma aceita troco	típico de dinheiro
Abre a gaveta	dispara a abertura da gaveta	típico de dinheiro
A prazo (fiado/crediário)	a forma gera título a receber	liga a forma ao Contas a receber
Taxa da adquirente (%)	taxa percentual da credenciadora	cuidado: percentual usa vírgula ou ponto como decimal
Prazo de recebimento (dias)	em quantos dias o dinheiro cai	D+0 vira `0`
Adquirente	nome da credenciadora	ex.: Cielo, Rede, Stone
Ordem no PDV	posição no caixa	define a ordem de exibição
Forma ativa	se a forma está em uso	forma inativa sai do PDV

Chips: Todas, Cartão, Com TEF, A prazo, Inativas.

Cartões: Formas, Com TEF ("integradas"), Cartão ("crédito/débito"), Inativas ("fora do PDV").

Parte 2 — Adquirentes#

Passo a passo#

Abra Financeiro > Adquirentes.
Clique em Nova adquirente.
Informe o Nome da adquirente.
Se a credenciadora antecipa recebíveis, marque Antecipa recebíveis (D+1) e informe a Taxa de antecipação (% ao mês).
Deixe Ativa marcada e salve.

Campos e o que significam#

Campo	O que é	Observação
Nome da adquirente *	a credenciadora	ex.: Cielo, Rede, Stone
Antecipa recebíveis (D+1)	se a credenciadora antecipa	muda o prazo do recebível para D+1
Taxa de antecipação (% ao mês)	custo mensal da antecipação	só aparece quando Antecipa está marcado. ex.: `1,60`
Ativa	se a adquirente está em uso	vem marcada

Chips: Todas, Antecipam, Inativas.

Cartões: Adquirentes ("credenciadoras"), Antecipam ("recebem em D+1"), Inativas ("fora do uso").

Parte 3 — Taxas de cartão#

Passo a passo#

Abra Financeiro > Taxas de cartão.
Clique em Nova taxa.
Informe a Adquirente e a Bandeira.
Escolha a Modalidade.
Se for crédito parcelado, informe Parcela de e Parcela até.
Informe a Taxa (%).
Informe o Prazo (dias, D+N).
Deixe Ativa marcada e salve.
Repita para cada combinação de adquirente × bandeira × modalidade que a loja pratica.
Olhe o filtro Ajustar de tempo em tempo: são as taxas criadas automaticamente que precisam da sua revisão.

Campos e o que significam#

Campo	O que é	Observação
Adquirente *	a credenciadora	os dois primeiros campos são obrigatórios
Bandeira *	a bandeira do cartão	ex.: Visa, Mastercard, Elo
Modalidade *	`Débito`, `Crédito à vista` ou `Crédito parcelado`	—
Parcela de	primeira parcela da faixa	aparece só no crédito parcelado. O rótulo sugere `2`
Parcela até	última parcela da faixa	aparece só no crédito parcelado. O rótulo sugere `6`
Taxa (%) *	a taxa daquela faixa	ex.: `2,49`
Prazo (dias, D+N)	prazo de recebimento	ex.: `30`. O rótulo sugere `30`
Ativa	se a taxa está em uso	vem marcada

Chips: Todas, Débito, Crédito à vista, Crédito parcelado, Ajustar, Inativas.

Cartões: Taxas ("cadastradas"), Adquirentes ("credenciadoras"), Bandeiras ("cobertas") e Ajustar ("auto-criadas, revisar").

Resultado esperado#

A taxa aparece com o título Adquirente · Bandeira e o prazo no subtítulo.
O cartão Ajustar fica em zero quando todas as taxas auto-criadas foram revisadas.
O resumo diz quantas taxas existem e em quantas bandeiras.

Como o líquido a receber é calculado#

O cálculo do recebível replica a regra da planilha de taxas do cliente:

Peça	Como entra
MDR	taxa da adquirente por bandeira, modalidade e faixa de parcelas — já resolvida pela tabela de taxas
Antecipação	só no crédito; débito já cai em D+1 sem antecipar. É % ao mês
Antecipação efetiva	numa venda parcelada em n vezes antecipada para D+1, cada parcela é adiantada um número diferente de meses; a antecipação efetiva é a média, `antecipação mensal × (n+1)/2`
Taxa efetiva	MDR + antecipação média (quando antecipa); senão, só MDR
Líquido	`bruto × (1 − taxa efetiva)` — é o que a loja recebe
Valor a repassar	`bruto ÷ (1 − taxa efetiva)` — preço com o custo embutido, quando a loja repassa o custo ao cliente
Prazo	D+1 quando antecipa; senão, o prazo natural da modalidade

Resultado esperado#

O caixa passa a oferecer a forma de pagamento na ordem definida em Ordem no PDV.
A conciliação de cartões consegue calcular o líquido de cada venda.
O prazo de repasse fica coerente com o contrato: D+0 ou D+1 na antecipação, D+N no prazo natural.

Se algo der errado#

Sintoma	Causa provável	O que fazer
"informe nome e código"	Nome ou Código vazio	preencha os dois
"informe o nome da adquirente"	Nome da adquirente vazio	preencha o nome
"informe adquirente e bandeira"	Adquirente ou Bandeira vazio	preencha os dois
"sem permissao para gerenciar formas de pagamento"	falta `financeiro.forma_pagamento`	peça a permissão
"sem permissao para gerenciar adquirentes"	falta `financeiro.conciliacao`	peça a permissão
"sem permissao para gerenciar taxas de cartao"	falta `financeiro.conciliacao`	peça a permissão
A forma não aparece no caixa	forma inativa, ou Ordem no PDV conflitante	ative a forma e ajuste a ordem
A taxa gravou um valor absurdo	percentual digitado com ponto quando o campo esperava o padrão brasileiro	confira o valor gravado e corrija. O ERPia aceita vírgula ou ponto como decimal em percentual — mas `1.60` digitado como "mil, sessenta" seria erro de leitura, não do sistema
A conciliação diz que não há taxa	combinação de adquirente × bandeira × modalidade sem cadastro	cadastre a taxa que falta
Aparecem taxas que você não cadastrou	são as auto-criadas, marcadas em Ajustar	revise e ajuste cada uma

Como funciona por dentro#

O parser de percentual aceita vírgula ou ponto. Isso é deliberado: existe um parser separado para percentual e outro para dinheiro. O parser de dinheiro apaga o ponto por ser separador de milhar — o que é correto para valor e desastroso para percentual.
A ordem no PDV é campo próprio. A forma aparece no caixa na ordem definida, e não na ordem alfabética.
Forma inativa sai do caixa. Ao lançar movimento no Caixa Geral, a lista de formas só traz as ativas.
A adquirente decide o prazo. Com Antecipa recebíveis (D+1) marcado, o recebível antecipado cai em D+1 independentemente do prazo natural da modalidade.
O débito não antecipa. Débito já cai em D+1 sem antecipação; a antecipação é custo do crédito.