Usar saldo de adiantamento na Nota Fiscal

Este capítulo descreve como consumir o saldo de adiantamento de um cliente (ou fornecedor) ao emitir uma Nota Fiscal — incluindo o caso em que o saldo não está vinculado ao pedido que está sendo faturado.

Pré-requisito: o adiantamento que se quer usar precisa estar LIQUIDADO (saldo financeiro = 0, ou seja, o dinheiro já entrou). Um adiantamento ainda em aberto não é saldo disponível — ele ainda não foi recebido.

Os dois cenários de consumo

Existem duas formas de um adiantamento abater uma NF, e elas funcionam de maneira diferente:

Cenário	O que é	Como é consumido
Adto do próprio pedido	O cliente adiantou contra este pedido, e agora você está faturando este pedido	Automático — o sistema reconhece e abate sozinho ao gravar a NF, sem você marcar nada
Saldo livre do parceiro	Adiantamentos avulsos (sem pedido) ou sobras de outros pedidos que o parceiro tem em crédito	Manual / por política — você decide se usa, marcando parcelas ou conforme a política configurada

Por que a diferença? O adto do próprio pedido é abatido automaticamente para evitar duplo recebimento (o cliente pagaria duas vezes pelo mesmo pedido). Já o saldo livre é uma escolha: esquecer de usá-lo não cobra ninguém em dobro — apenas deixa um crédito guardado para depois. Por isso o saldo livre é manual.

Situação típica que motivou este recurso

O cliente faz um adiantamento e, por algum motivo, aquele pedido ainda não teve a Nota Fiscal emitida. Nesse meio-tempo, ele faz outro pedido, a prazo. Ao faturar esse novo pedido, o Faturamento pode decidir usar (ou não) o saldo de adiantamento que o cliente já tem em crédito para abater parcelas dessa nova nota.

É exatamente isso que a coluna "Antecipada" permite: parcela a parcela, marcar quais serão quitadas com o saldo de adiantamento e quais permanecem normais (a prazo).

A coluna "Antecipada" na emissão da NF

Na tela Emissão de Nota Fiscal, na aba de Cobrança / Parcelas (grid de duplicatas), aparece uma coluna chamada "Antecipada" sempre que o parceiro da nota tiver saldo livre disponível.

Junto à coluna há:

O botão "Antecipações", que abre um quadro com o saldo disponível detalhado;
Um rótulo de feedback mostrando "Disp." (saldo disponível) e "Aplic." (quanto já foi marcado nesta nota).

Passo a passo (venda)

Monte a NF normalmente (cliente, operação, produtos) e feche o parcelamento (forma + condição) — as parcelas aparecem no grid.
Clique em "Antecipações" para conferir o saldo disponível do cliente (opcional).
Na coluna "Antecipada", marque as parcelas que devem ser quitadas com o saldo de adiantamento.
Grave/emita a NF normalmente.

Marque as parcelas por último. Se você alterar a condição de pagamento ou o valor depois de marcar, o sistema regenera as parcelas e as marcações de "Antecipada" se perdem. Feche o parcelamento primeiro, marque depois.

O que o sistema faz ao gravar

Soma as parcelas marcadas como "Antecipada" e abate esse valor do saldo de adiantamento livre do parceiro (consumindo do mais antigo para o mais novo);
As parcelas marcadas saem do recebível (ficam quitadas pelo adto); as não marcadas permanecem a prazo;
Registra a trilha de auditoria (Pagamento de abatimento + movimento de reconhecimento na data da NF).

Abatimento total = sem fatura no financeiro. Se todas as parcelas forem marcadas como "Antecipada" e o saldo cobrir o valor cheio, a Nota Fiscal não gera fatura a receber no financeiro — apenas o registro de abatimento. Não aparece fatura zerada em Contas a Receber.

A duplicata continua na NF-e. Marcar uma parcela como "Antecipada" afeta apenas o financeiro (a fatura a receber). A cobrança/duplicata fiscal da NF-e é preservada normalmente — o parcelamento aparece completo no documento fiscal.

Validação do saldo

O sistema não deixa marcar parcelas que somem mais do que o saldo disponível. Ao exceder, a marcação é desfeita e uma mensagem informa o saldo disponível.

O quadro "Antecipações"

O botão "Antecipações" abre uma janela (somente leitura) com o saldo de adiantamento livre do parceiro, em formato de grid:

Coluna	Descrição
Código	Código da Fatura de adiantamento
Data	Data do adiantamento
Histórico	Descrição/origem do adiantamento
Valor Original	Valor com que o adiantamento foi criado
Saldo Disponível	Quanto ainda resta para consumir (valor original menos o que já foi reconhecido/devolvido)

No topo, o quadro mostra o total disponível e o total aplicado nesta NF. Por ser um grid padrão do sistema, você pode ajustar/salvar as colunas e usar o botão direito para imprimir / exportar para Excel.

O saldo livre exclui o adiantamento do próprio pedido que está sendo faturado (esse é tratado automaticamente). Aparecem aqui apenas avulsos e sobras de outros pedidos.

Política de consumo (parâmetro)

O comportamento do consumo de saldo livre é controlado pelo parâmetro politicaConsumoSaldoAdiantamento (em Configurações / Parâmetros):

Política	Comportamento ao gravar a NF
Manual (padrão)	Nada é consumido automaticamente. O consumo é o que o operador marcou na coluna "Antecipada".
Automático	O sistema consome o saldo livre automaticamente (do mais antigo para o mais novo) até o valor da nota, sem perguntar.
Perguntar	Se houver saldo livre, o sistema pergunta se deseja usá-lo; se confirmado, consome.

Na política Manual (padrão), se você não marcar nenhuma parcela, o saldo livre não é usado e a fatura a receber sai cheia — isso é o esperado. Para consumo sem marcação, mude a política para Automático ou Perguntar.

NF de pedido x venda direta

A coluna "Antecipada" funciona nos dois casos:

Venda direta (NF sem pedido): o saldo livre são os adiantamentos avulsos e sobras do parceiro.
NF de pedido: o adto do próprio pedido é reconhecido automaticamente primeiro; em seguida, as parcelas que ainda restarem podem ser marcadas para consumir o saldo livre (avulsos + sobras de outros pedidos).

Em uma NF de pedido, as parcelas que o adto do próprio pedido já quitou são ignoradas pela marcação manual (não há saldo a abater nelas) — a marcação só consome saldo livre no que sobrou.

Compra (importação de XML)

Na importação de XML de compra (entrada de mercadoria), o consumo de saldo de adiantamento a fornecedor funciona por política — não há coluna manual por parcela (o fluxo do XML é automatizado).

O adto do próprio pedido de compra é reconhecido automaticamente (como na venda);
O saldo livre a fornecedor (avulsos + sobras) é consumido conforme a política Automático / Perguntar;
Na política Manual (padrão), o saldo livre não é consumido na compra (não há marcação manual lá).

Para o consumo na compra acontecer, a política precisa estar em Automático ou Perguntar, e o fornecedor precisa ter adiantamento liquidado (pago) e do mesmo sinal contábil da NF de entrada.

Resumo

Quero...	Como fazer
Ver o saldo de adiantamento do cliente na NF	Botão "Antecipações" na aba de Cobrança
Quitar algumas parcelas com o saldo	Marcar a coluna "Antecipada" nessas parcelas (política Manual)
Quitar a NF inteira com o saldo	Marcar todas as parcelas — se cobrir 100%, não nasce fatura a receber
Consumir sem marcar	Mudar a política para Automático ou Perguntar
Consumir saldo a fornecedor na compra	Política Automático/Perguntar (sem coluna manual no XML)