Adiantamento de Pedidos

Este manual descreve o funcionamento do módulo de Adiantamento de Pedidos no sistema. Cada capítulo aborda uma área: Visão geral e conceito contábil (este capítulo) — fundamentos teóricos Configuração inicial — cadastros que devem ser feitos uma vez ao implantar Operação venda — fluxo dia-a-dia para pedidos com adto de cliente Operação compra — fluxo dia-a-dia para adto a fornecedor (via XML) Consulta de Adiantamentos — tela administrativa (Vincular NF, Desvincular, Devolver) Relatórios — DRE, Balancete, comportamento esperado Troubleshooting — erros comuns, casos especiais, glossário

• Visão geral e conceito contábil
• Configuração inicial
• Operação venda — fluxo dia-a-dia
• Operação compra — fluxo dia-a-dia
• Consulta de Adiantamentos
• Relatórios e comportamento contábil
• Troubleshooting e glossário
• Usar saldo de adiantamento na Nota Fiscal

Visão geral e conceito contábil

Este manual descreve o funcionamento do módulo de Adiantamento de Pedidos no sistema. Cada capítulo aborda uma área:

• Visão geral e conceito contábil (este capítulo) — fundamentos teóricos
• Configuração inicial — cadastros que devem ser feitos uma vez ao implantar
• Operação venda — fluxo dia-a-dia para pedidos com adto de cliente
• Operação compra — fluxo dia-a-dia para adto a fornecedor (via XML)
• Usar saldo de adiantamento na NF — coluna "Antecipada", quadro de antecipações e política de consumo
• Consulta de Adiantamentos — tela administrativa (saldo vivo, avulso, Vincular NF, Desvincular, Devolver, Posição)
• Relatórios — DRE, Balancete, comportamento esperado
• Troubleshooting — erros comuns, casos especiais, glossário

O que é: Tratamento contábil correto para situações em que o cliente paga (ou a empresa paga ao fornecedor) antes da emissão da Nota Fiscal. O adiantamento é registrado como passivo (cliente) ou ativo (fornecedor), virando receita ou despesa apenas quando a NF é emitida.

O problema do recebimento antecipado

Quando um cliente paga um pedido antes da empresa emitir a Nota Fiscal correspondente, esse dinheiro não é receita ainda. Segundo o CPC 47 / IFRS 15 (Receita de Contrato com Cliente), a receita só pode ser reconhecida quando a obrigação de performance for cumprida — ou seja, quando a mercadoria/serviço é efetivamente entregue (representado pela NF).

Até a NF ser emitida, esse dinheiro recebido é uma obrigação da empresa para com o cliente — um passivo chamado "Adiantamento de Clientes".

Simetricamente, quando a empresa paga adiantado a um fornecedor (antes da NF de entrada chegar), esse dinheiro é um ativo ("Adiantamento a Fornecedores") até o produto/serviço ser entregue.

Lançamentos contábeis

Venda — cliente adianta

Evento	Débito	Crédito
Recebimento do adiantamento	Banco/Caixa (Ativo)	Adiantamento de Clientes (Passivo)
Emissão da NF	Adiantamento de Clientes (Passivo)	Receita de Vendas
Devolução	Adiantamento de Clientes (Passivo)	Banco/Caixa (Ativo)

Compra — empresa adianta ao fornecedor

Evento	Débito	Crédito
Pagamento do adiantamento	Adiantamento a Fornecedores (Ativo)	Banco/Caixa (Ativo)
Recebimento da NF	Despesa / Estoque	Adiantamento a Fornecedores (Ativo)
Estorno	Banco/Caixa (Ativo)	Adiantamento a Fornecedores (Ativo)

Impacto nos relatórios

Estado da Fatura A (adto)	DRE	Balancete por RD/CC	Tela Antecipações
Aberta (pedido criado, ainda não pago)	—	—	—
Liquidada (cliente pagou)	—	+ valor sob "Adto Clientes/Fornecedores"	+ saldo de adto
Reconhecida (NF emitida)	+ valor sob RD da NF (data da NF)	(já registrado quando liquidou)	saldo zerado
Devolvida	—	movimento de estorno	saldo zerado

Regra-chave: o DRE só "vê" o adiantamento quando este é reconhecido pela emissão da NF. O Balancete por RD/Centro de Custo enxerga a movimentação financeira real (regime de caixa).

Reconhecimento parcial e saldo vivo (modelo de eventos)

Um adiantamento não precisa ser reconhecido de uma vez só. Um mesmo adiantamento pode ser consumido aos poucos — por exemplo, um adto de R$ 10.000 pode reconhecer R$ 8.000 numa NF e deixar R$ 2.000 de crédito para usar depois (em outro pedido) ou para devolver.

Para suportar isso com precisão, cada movimento do adiantamento é registrado como um evento (reconhecimento por NF, devolução, uso em outro pedido). O crédito que ainda resta é o saldo vivo:

Saldo vivo = valor original do adiantamento − soma de tudo que já foi reconhecido/devolvido. É o quanto ainda está disponível como crédito.

• O valor original da Fatura de adto é imutável (é o "depósito" feito).
• Cada reconhecimento por NF lança um evento com o valor reconhecido e a data de competência da NF — então o DRE conta exatamente o que foi reconhecido, no mês certo.
• O saldo vivo é visível na tela Consulta de Adiantamentos (coluna "Saldo Vivo") e no Relatório de Posição de Antecipações.

Por que isso importa: antes, um adto de R$ 10.000 reconhecido por uma NF de R$ 8.000 lançaria R$ 10.000 de receita (errado). Com o modelo de eventos, lança exatamente os R$ 8.000 reconhecidos, e os R$ 2.000 continuam como crédito vivo.

Estados da Fatura de Adiantamento

Ao longo de seu ciclo de vida, uma Fatura de Adiantamento (chamada internamente de "Fatura A") passa por estes estados:

Status	Significado
ABERTO	Adto criado mas ainda não pago (saldo > 0)
LIQUIDADO	Cliente pagou (ou empresa pagou ao fornecedor), saldo = 0, mas a NF ainda não foi emitida
PARCIAL	Parte do adto já foi reconhecida/consumida por NF, mas ainda há saldo vivo > 0 disponível como crédito
RECONHECIDO	Adto totalmente reconhecido por NF (saldo vivo = 0) — conta no DRE da data da NF
DEVOLVIDO	Adto foi estornado/devolvido (total ou parcialmente) — reduz o saldo vivo sem reconhecimento contábil

Estes estados são visíveis na tela Consulta de Adiantamentos (capítulo dedicado).

Configuração inicial

Esta configuração deve ser feita uma única vez ao implantar o módulo no cliente. Após concluída, o sistema está pronto para operar com adiantamentos.

Pré-requisitos: SQL Fase 1 executado, EDMX atualizado, sistema compilado e funcional.

1. Cadastrar a Receita/Despesa de "Adiantamento de Clientes"

Esta RD representa o passivo de adiantamentos de clientes (vendas).

1. Menu Cadastros → Receitas e Despesas
2. Botão Novo
3. Preencher:
   • Descrição: Adiantamento de Clientes
   • Grupo: criar (ou usar) um grupo chamado Adiantamentos
   • Tipo: + (entrada/receita)
   • DRE: marcar "Não considerar no DRE" (campo idnDreNenhum)
4. Salvar

Atenção: a flag "Não considerar no DRE" é crítica. Sem ela, o adiantamento contaria como receita imediatamente quando o cliente pagasse, contrariando o modelo de passivo.

2. Cadastrar a Receita/Despesa de "Adiantamento a Fornecedores"

Mesmo procedimento do item 1, mas:

• Descrição: Adiantamento a Fornecedores
• Tipo: - (saída/despesa)
• DRE: marcar "Não considerar no DRE"

3. Criar Operação que gera adiantamento (venda)

A operação é o "switch" que diz ao sistema "este tipo de pedido gera adiantamento". Você pode ter várias operações com essa configuração (uma por canal de venda, por exemplo).

1. Menu Cadastros → Operações
2. Botão Novo (ou editar uma operação existente de venda)
3. Preencher os campos normais (descrição, CFOP, série, tipo de operação = Saída, etc.)
4. Na seção Tipos de Operação, marcar:
   • Gerar Fatura ✓
   • Gera Adiantamento ✓ (checkbox novo)
5. No campo Receita/Despesa Padrão, selecionar a RD criada no item 1 (Adiantamento de Clientes)
6. Salvar

Ao salvar, se a RD apontada não tiver "Não considerar no DRE" marcado, o sistema mostra um aviso pedindo confirmação. Recomenda-se sempre marcar — mas é apenas alerta, não bloqueio.

4. Criar Operação que gera adiantamento (compra)

Similar ao item 3, mas:

• Tipo de Operação: Entrada
• Receita/Despesa Padrão: Adiantamento a Fornecedores (do item 2)

5. (Opcional) Operador dedicado para API

Se a empresa for usar a API externa (e-commerce, integração), pode-se configurar um operador dedicado:

1. Menu Cadastros → Operadores → criar um operador API_WEB (ou nome equivalente)
2. No cadastro do Emitente, configurar o campo Operador API apontando para esse operador

Este passo é opcional e só relevante quando a API estiver em uso.

Checklist de aceitação

Após concluir a configuração, confirme:

• [ ] RD "Adiantamento de Clientes" criada com tipo "+" e "Não considerar no DRE" marcado
• [ ] RD "Adiantamento a Fornecedores" criada com tipo "-" e "Não considerar no DRE" marcado
• [ ] Pelo menos uma Operação de venda com "Gera Adiantamento" e RD Padrão apontando para a RD de clientes
• [ ] Pelo menos uma Operação de compra com "Gera Adiantamento" e RD Padrão apontando para a RD de fornecedores
• [ ] (Opcional) Operador API configurado se for integrar com plataforma externa

Operação venda — fluxo dia-a-dia

Este capítulo descreve o passo-a-passo para vender com adiantamento de cliente, do pedido à emissão da NF e reconhecimento contábil.

Pré-requisito: configuração inicial concluída (ver capítulo dedicado).

1. Gerar pedido com adiantamento

1. Menu Cadastros → Emissão de Pedido
2. Selecionar o parceiro (cliente)
3. Selecionar a operação cadastrada como adto (a que tem "Gera Adiantamento" marcado)
4. Adicionar produtos normalmente
5. Escolher a forma de pagamento (PIX, dinheiro, etc.)
6. Gravar

O sistema irá gerar automaticamente uma Fatura de Adiantamento (internamente identificada como "Fatura A") com sinal contábil "+" (entrada/receita).

2. Receber o adiantamento

Após gravar o pedido, o sistema abre a tela de recebimento normalmente. Receba o valor à vista (PIX, dinheiro, cartão) ou registre boleto futuro — o fluxo é idêntico a qualquer outro recebimento.

Quando o cliente paga, a Fatura A é liquidada (saldo = 0). O movimento bancário/de caixa é registrado normalmente.

Neste momento o DRE ainda não conta nada — o adto está como passivo. O Balancete por RD mostra o valor sob "Adiantamento de Clientes".

3. Emitir Nota Fiscal (reconhecimento automático)

Quando chegar o momento de entregar a mercadoria/serviço, emita a NF normalmente pela tela Emissão de Nota Fiscal:

1. Localizar o pedido com adto
2. Faturar normalmente (a operação da NF pode ser diferente da do pedido — use a operação de venda normal, sem "Gera Adiantamento")
3. Autorizar/emitir a NF

O sistema automaticamente:

1. Vincula a Fatura de adiantamento à NF emitida (reconhecimento contábil) — preenche idNotaFiscalReconhecimento
2. Abate a Fatura de Recebível (gerada pela NF) no valor do adto já recebido — assim o cliente não é cobrado em dobro
3. Não cria a Fatura de Recebível se 100% abatida — quando o adto cobre o valor total da NF, o sistema detecta a situação antes de criar a Fatura de Recebível e pula a criação inteira. Apenas o Pagamento sintético do abate é registrado como trilha de auditoria, achável via Pagamento.idFaturaAdiantamentoUtilizada

Não vai aparecer Fatura zerada em Contas a Receber: a partir de 2026-05, quando o adto cobre 100% do valor da NF, a Fatura de Recebível nem chega a ser criada. Antes ela existia com valor zero, gerando confusão visual. Agora, no caminho principal, o sistema consulta o saldo de adto antes de gerar a Fatura — se o adto vai abater 100%, gera apenas o Pagamento sintético. Em paths secundários (locação, NF sem produtos, Fatura editada manualmente), um fallback no helper de abate remove a Fatura de Recebível pós-abate caso ela termine zerada, garantindo o mesmo resultado.

Cuidado se a NF tem ICMS-ST ou IPI: a Fatura de Recebível nasce com o valor TOTAL da NF (incluindo impostos), e o sistema abate apenas o valor do adto. Se o adto foi R$ 1.000 e a NF é R$ 1.150 (com impostos), sobrará um saldo de R$ 150 na Fatura de Recebível — esse resíduo é dos impostos extras e deve ser cobrado/recebido separadamente. Nesse caso a Fatura B continua existindo (não foi 100% abatida).

Cancelamento de NF reverte automaticamente o adto: cancelar uma NF que reconheceu adiantamento limpa o vínculo (idNotaFiscalReconhecimento = NULL) e deleta o Pagamento sintético do abate. O adto volta ao estado "liquidado mas não reconhecido", podendo ser usado em nova NF (re-emissão) ou devolvido pela tela "Consulta de Adiantamentos".

4. Conferir no DRE

Após emitir a NF, gere o DRE do mês da NF:

• O valor do adto aparece como receita sob a RD da operação da NF (não a RD "Adiantamento")
• O eventual resíduo da Fatura de Recebível (impostos) também aparece, somando ao total da NF

Resumo do ciclo de vida (Cenário "100% adto PIX")

Mês	Ação	DRE	Balancete	Saldo adto na tela Consulta
1	Pedido + PIX recebido	—	+ R$ 1.000 "Adto Clientes"	R$ 1.000
3	NF emitida	+ R$ 1.000 Receita	—	R$ 0

Resumo do ciclo de vida (Cenário "Sinal parcial 50%")

Mês	Ação	Status no sistema	DRE	Balancete
1	Pedido R$ 10.000, R$ 5.000 PIX adto + R$ 5.000 a prazo	Fatura A R$ 10.000 ABERTO + parcela à vista	—	+ R$ 5.000 "Adto Clientes" (após PIX)
3	NF emitida	Fatura A RECONHECIDO + Fatura B com resíduo	+ R$ 10.000 receita reconhecida	—

O comportamento de "sinal parcial" (Cenário 2) usa uma Fatura para o adto E outra Fatura para o saldo a prazo. O usuário pode configurar essa divisão na hora de montar o pedido escolhendo formas de pagamento mistas.

---

Usar saldo de adiantamento que NÃO é do pedido

O reconhecimento descrito acima é automático e vale para o adiantamento do próprio pedido sendo faturado. Quando o cliente tem um saldo de adiantamento avulso (sem pedido) ou sobras de outros pedidos, o consumo é uma escolha do operador — feito pela coluna "Antecipada" no grid de parcelas.

Esse fluxo (coluna "Antecipada", quadro de antecipações e política de consumo) tem um capítulo dedicado: "Usar saldo de adiantamento na Nota Fiscal".

Operação compra — fluxo dia-a-dia

Este capítulo descreve o passo-a-passo para registrar adiantamento a fornecedor (compra). O fluxo é simétrico ao de venda, mas com diferenças importantes — principalmente que o reconhecimento normalmente vem pela importação do XML do fornecedor.

Pré-requisito: configuração inicial concluída — incluindo a Operação de compra com "Gera Adiantamento" marcada (ver capítulo dedicado).

1. Gerar pedido de compra com adiantamento ao fornecedor

1. Menu Cadastros → Emissão de Pedido → tipo Compra
2. Selecionar fornecedor
3. Selecionar a operação de compra com adto (a configurada com "Gera Adiantamento")
4. Adicionar produtos
5. Gravar

O sistema gera uma Fatura de Adiantamento a Fornecedor (sinal contábil "-").

2. Pagar o adiantamento ao fornecedor

Via tela de pagamento padrão (Caixa Recebimento/Pagamento) — saída do banco para o fornecedor.

Após o pagamento, a Fatura de Adto fica com status LIQUIDADO.

3. Receber XML do fornecedor e importar

Quando o fornecedor emitir a NF da entrega e enviar o XML, importe pela tela dedicada:

1. Menu Cadastros → Importar XML
2. Selecionar o arquivo XML do fornecedor
3. Importante: clicar no botão "Relacionar Pedido" e selecionar o pedido de compra criado no passo 1
4. Selecionar a operação de compra normal (sem "Gera Adiantamento")
5. Gravar

O sistema automaticamente:

• Reconhece o adto (vincula à NF importada)
• Abate a Fatura de Despesa (gerada pela NF) no valor já adiantado

Saldo livre a fornecedor: além do adto do próprio pedido (reconhecido automaticamente acima), o fornecedor pode ter saldo de adiantamento avulso ou sobras de outros pedidos. Na importação de XML esse saldo livre é consumido por política (parâmetro politicaConsumoSaldoAdiantamento em Automático/Perguntar) — não há coluna manual por parcela aqui, diferente da venda. Em "Manual" (padrão), o saldo livre não é consumido na compra. Ver capítulo "Usar saldo de adiantamento na Nota Fiscal".

Não use Emissão de Nota Fiscal (FEmissaoNF) para compras: para compras o caminho correto é importar o XML do fornecedor via tela de Importar XML. Emitir NF de saída via Emissão de NF para um pedido de compra resulta em sinais contábeis invertidos e o sistema irá ignorar o adiantamento.

4. Conferir no DRE

O DRE do mês da NF mostra o valor do adto como despesa reconhecida, sob a RD da operação da NF (não a RD "Adiantamento a Fornecedores").

Resumo do ciclo de vida

Mês	Ação	DRE	Balancete	Status do adto
1	Pedido compra + pagamento PIX ao fornecedor	—	+ R$ X "Adto a Fornecedores"	LIQUIDADO
2	XML do fornecedor importado	+ R$ X despesa reconhecida	—	RECONHECIDO

Caso: NF do fornecedor inclui IPI/ICMS-ST

Quando a NF do fornecedor tem impostos extras embutidos no total (IPI, ICMS-ST), o mesmo comportamento da venda acontece:

• Adto cobre o valor das mercadorias (ex: R$ 1.000)
• NF inclui impostos extras (ex: R$ 1.150 total)
• Fatura de Despesa fica com saldo residual de R$ 150 (impostos) que devem ser pagos ao fornecedor separadamente

Consulta de Adiantamentos

A tela Consulta de Adiantamentos é o painel administrativo para gerenciar todos os adiantamentos em aberto, liquidados, reconhecidos e devolvidos.

Acesso à tela

Caminho será definido ao liberar a atualização

Colunas exibidas

Coluna	Descrição
Cód.	Código interno da Fatura de Adiantamento
Data	Data do pedido / criação do adto
Tipo	CLIENTE (venda) ou FORNECEDOR (compra)
Parceiro	Razão social do cliente/fornecedor
Valor	Valor original do adto (imutável)
Saldo	Saldo financeiro a receber/pagar (0 = liquidado/pago)
Saldo Vivo	Crédito de adiantamento ainda disponível (valor original − reconhecido em NF − devolvido). É o quanto resta para consumir.
Status	ABERTO / LIQUIDADO / PARCIAL / RECONHECIDO / DEVOLVIDO
Nº Pedido	Pedido vinculado
NF Reconhec.	Número da NF (ou movimento) que reconheceu este adto
Receita/Despesa	Nome da RD configurada
Motivo Baixa	Texto descritivo quando devolvido ou abatido

Ações disponíveis

Na ribbon superior da tela há botões com ações administrativas:

Botão	Ícone	Quando usar
Novo Adiantamento Avulso	Adicionar	Lançar um adiantamento sem pedido (ex.: cliente deposita um valor em crédito) — abre a tela de Cadastro de Fatura já em modo adiantamento
Vincular NF	Corrente	Adto foi liquidado mas a NF correspondente foi emitida sem vincular ao pedido — usar para fazer a vinculação manual
Desvincular NF	Corrente quebrada	NF foi vinculada por engano, ou NF foi cancelada
Devolver Adto	Seta de retorno	Cliente desistiu (total ou parcialmente) — gera uma Fatura de Devolução com vencimento configurável
Posição (Relatório)	Relatório	Imprime a posição de antecipações por data de corte (saldo vivo por parceiro em uma data) — ver capítulo "Relatórios"

---

Ação: Novo Adiantamento Avulso

Use quando o parceiro deixa um valor em crédito sem um pedido associado — por exemplo, um cliente que deposita um valor para usar em compras futuras. Esse saldo fica disponível para ser consumido depois, em qualquer NF, pela coluna "Antecipada" (ver capítulo "Usar saldo de adiantamento na NF").

Passo a passo

1. Clicar no botão Novo Adiantamento Avulso
2. Abre a tela de Cadastro de Fatura já em modo adiantamento (origem = adiantamento, sem pedido)
3. Selecionar o parceiro, a Receita/Despesa de adiantamento (a lista já vem filtrada pelas RDs marcadas como "Não considerar no DRE") e o valor
4. Definir forma/condição/vencimento
5. Salvar (F5)

O adiantamento avulso nasce como qualquer adto: precisa ser liquidado (recebido) pelo fluxo financeiro normal para virar saldo disponível. Depois de liquidado, aparece como saldo livre nas próximas notas do parceiro.

---

Ação: Vincular NF manualmente

Use esta ação quando:

• O adto foi liquidado em uma data
• A NF da entrega foi emitida depois, mas sem vínculo ao pedido do adto (por algum motivo operacional)
• Você precisa reconhecer contabilmente o adto manualmente

Passo a passo

1. Selecionar a linha do adto na grid (status deve ser LIQUIDADO)
2. Clicar no botão Vincular NF
3. O sistema mostra um diálogo com as NFs candidatas — todas do mesmo parceiro+emitente, com mesmo sentido (saída para vendas / entrada para compras), autorizadas (cstat 100 ou 150)
4. Selecionar a NF e clicar Vincular
5. Confirmar

Após a vinculação, o adto aparecerá no DRE do mês da NF como receita/despesa.

---

Ação: Desvincular NF

Use esta ação quando:

• A NF foi vinculada ao adto errado (por engano de operador)
• A NF foi cancelada na SEFAZ
• Você precisa retirar o adto do DRE consolidado para revisão

Passo a passo

1. Selecionar a linha do adto na grid (status deve ser RECONHECIDO)
2. Clicar no botão Desvincular NF
3. Confirmar (atenção: o sistema mostra um aviso de que o adto sairá do DRE)

Cuidado: desvincular um adto reconhecido faz com que ele saia do DRE do mês original da NF. Se o DRE daquele mês já foi fechado/auditado, isso pode gerar inconsistência. Use apenas em correções genuínas (NF errada/cancelada).

---

Ação: Devolver Adiantamento

Use quando o cliente desiste da compra (ou a empresa desiste de comprar do fornecedor), ou quando sobra um crédito que não será mais usado. A devolução gera uma Fatura de Devolução (a pagar/receber) que poderá ser liquidada pelo fluxo financeiro normal — permitindo negociar prazo de pagamento com o parceiro e manter trilha de auditoria completa.

Devolução parcial: você pode devolver apenas parte do crédito. O valor vem pré-preenchido com o saldo vivo, mas pode ser reduzido — e devoluções parciais sucessivas são permitidas, sempre limitadas ao saldo vivo restante.

Pré-requisitos

• O adto deve estar LIQUIDADO (saldo financeiro = 0 — o dinheiro entrou)
• O adto deve ter saldo vivo > 0 (há crédito disponível para devolver). Mesmo um adto parcialmente reconhecido em NF pode ter o saldo vivo restante devolvido.

Passo a passo

1. Selecionar a linha do adto na grid
2. Clicar no botão Devolver Adto
3. Informar o motivo da devolução (obrigatório, livre)
4. A tela de Cadastro de Fatura abre pré-preenchida: parceiro e RD vêm do adto e ficam bloqueados; o valor vem com o saldo vivo, mas pode ser reduzido para devolver só parte. Operador define:
   • Forma de pagamento (Dinheiro, PIX, Transferência…)
   • Condição (à vista, 30 dias, parcelado…)
   • Datas de vencimento
   • Centro de custo
5. Salvar a Fatura (F5)

O que o sistema faz

• Cria uma Fatura de Devolução (origemFatura=8) com sinal contábil trocado em relação ao adto original (mesma RD)
• Vincula a Fatura nova à Fatura do adto via idFaturaAdiantamentoOrigem para rastreabilidade
• Mantém a Fatura do Adto intacta (saldo=0, quitada): o adto foi efetivamente recebido — a devolução é uma nova operação que estorna no Balancete
• Carimba na Fatura do Adto o histórico: "DEVOLUÇÃO GERADA via Fatura D Cód. X — Motivo: <seu motivo>"
• Registra atividade no log de auditoria

Liquidando a Fatura de Devolução

A nova Fatura aparece em Contas a Pagar (para devolução de venda) ou Contas a Receber (para devolução de compra). Liquide pelo fluxo normal (ucCaixaRecebimento / ucFaturaLiquidacao) quando devolver o dinheiro ao parceiro. O sistema escolhe automaticamente o destino correto conforme o Numerário escolhido:

• Dinheiro: só CaixaMovimento (caixa do operador logado)
• PIX / Transferência / Depósito: BancoMovimento + CaixaMovimento vinculados
• Cheque: ChequeMovimento + CaixaMovimento

Quando a Fatura de Devolução for liquidada, o saldo do passivo no Balancete zera automaticamente (entrada do adto + saída da devolução na mesma RD).

Relatórios e comportamento contábil

Este capítulo descreve como os adiantamentos aparecem (ou não) nos relatórios principais do sistema.

DRE (Demonstrativo de Resultados)

O DRE opera em regime de competência — só registra receitas e despesas no momento em que elas são reconhecidas, não quando o dinheiro entra/sai.

Comportamento dos adiantamentos no DRE

• Adiantamentos não aparecem no DRE do mês em que foram pagos
• Após a emissão da NF, o valor do adto aparece como receita/despesa no DRE do mês da NF
• A classificação no DRE deriva da RD da operação da NF (geralmente "Receita de Vendas" ou similar), não da RD original "Adiantamento"

Reconhecimento parcial: o DRE conta exatamente o valor reconhecido por cada NF, não o valor cheio do adto. Um adto de R$ 10.000 reconhecido por uma NF de R$ 8.000 lança R$ 8.000 de receita no mês dessa NF; os R$ 2.000 restantes só contam quando (e se) forem reconhecidos por outra NF. Cada reconhecimento entra no DRE pela data de competência da sua NF.

Hierarquia de data para reconhecimento

Quando um adto é reconhecido por uma NF, o DRE usa esta ordem de preferência para determinar em qual mês contar:

1. dataCompetencia da NF (se preenchida)
2. dataEmissaoNotaFiscal (se preenchida)
3. dataEmissao (fallback final)

Balancete por RD / Centro de Custo

O Balancete opera em regime de caixa — registra o movimento financeiro real (BancoMovimento, CaixaMovimento).

Comportamento dos adiantamentos no Balancete

• O movimento financeiro do adto aparece quando o dinheiro entra/sai (recebimento ou pagamento)
• Aparece sob a RD "Adiantamento de Clientes" (ou Fornecedores)
• Quando o adto é reconhecido, não há novo movimento no Balancete (o dinheiro já tinha sido registrado anteriormente)

Balancete por grupo DRE

Este relatório agrupa por classificação no DRE (Receita / Despesa Fixa / Variável / etc.).

Como as RDs de adiantamento têm "Não considerar no DRE" marcado, não aparecem nesse relatório — comportamento intencional. O saldo de adto deve ser consultado na tela de Consulta de Adiantamentos ou no Balanço Patrimonial.

Relatório de Posição de Antecipações

Este relatório mostra o saldo vivo de adiantamentos por parceiro em uma data de corte — útil para a contabilidade fechar o mês com a posição do passivo (adiantamentos de clientes) e do ativo (adiantamentos a fornecedores) em uma data específica.

Como gerar

1. Abrir a tela Consulta de Adiantamentos
2. Clicar no botão Posição (Relatório)
3. Informar a data de corte (tipicamente o último dia do mês a fechar)
4. Confirmar — o relatório é gerado em tela/impressão

O que mostra

• Saldo vivo de cada adiantamento até a data de corte (considera apenas reconhecimentos/devoluções ocorridos até essa data)
• Agrupado em ANTECIPAÇÕES A CLIENTES (passivo) e ANTECIPAÇÕES A FORNECEDORES (ativo)
• Subtotais por grupo e total geral
• Apenas adiantamentos com saldo vivo > 0 na data

Por ser baseado na data de corte, a posição de um mês já fechado permanece estável mesmo que novos reconhecimentos aconteçam depois — exatamente o que a contabilidade precisa para conciliar.

A impressão deste relatório pode exigir permissão específica (sistema de permissões por relatório). Se o botão não gerar nada, verifique com o administrador se o operador tem acesso a RELATORIO.IMPRIMIR.RelPosicaoAdiantamentos.

Consulta geral de Faturas

Na consulta geral de Faturas, as Faturas de adto aparecem normalmente. Para filtrar apenas adiantamentos, use a Consulta de Adiantamentos dedicada (capítulo dedicado neste manual).

Tabela resumo — onde o adto aparece

Relatório	Adto aberto	Adto liquidado	Adto reconhecido
DRE	—	—	+ valor (no mês da NF)
Balancete por RD/CC	—	+ valor sob "Adto Clientes/Fornecedores"	(já registrado quando liquidou)
Balancete por grupo DRE	—	—	—
Contas a Receber	+ valor	—	—
Borderô / Fluxo de Caixa	—	+ valor	—
Conciliação Bancária	—	+ valor	—
Consulta de Adiantamentos	+ (status ABERTO)	+ (status LIQUIDADO)	+ (status RECONHECIDO; PARCIAL se sobra saldo vivo)
Relatório de Posição	—	+ saldo vivo na data de corte	+ saldo vivo restante, se ainda houver (parcial)

Exemplo prático — Cenário "100% adto"

Pedido R$ 10.000, cliente paga PIX em janeiro, NF emitida em março:

Mês	DRE	Balancete RD/CC	Tela Antecipações
Janeiro (PIX)	—	+ R$ 10.000 "Adto Clientes"	R$ 10.000
Março (NF)	+ R$ 10.000 Receita	—	R$ 0

Exemplo prático — Cenário "50% adto + 50% boleto"

Pedido R$ 10.000, R$ 5.000 PIX em janeiro como adto + R$ 5.000 boletos para fev/mar/abr, NF emitida em março:

Mês	DRE	Balancete RD/CC	Tela Antecipações
Janeiro	+ R$ 5.000 (Fatura B pela dataFatura)	+ R$ 5.000 "Adto Clientes"	R$ 5.000
Fev	—	+ R$ 1.667 receita boleto	—
Março	+ R$ 5.000 (Fatura A reconhecida)	+ R$ 1.667 receita boleto	R$ 0
Abril	—	+ R$ 1.667 receita boleto	—

Note como o DRE em março reconhece os R$ 5.000 do adto (que tinha sido pago em janeiro), enquanto os outros R$ 5.000 já tinham aparecido pela data da fatura no DRE de janeiro.

Troubleshooting e glossário

Casos especiais e cuidados

NF com impostos extras (ICMS-ST, IPI)

Quando a NF tem ICMS-ST ou IPI que somam ao valor total, surge uma diferença entre o valor do adto e o valor da NF:

• Adto cobre o valor das mercadorias (ex: R$ 1.000)
• NF inclui impostos extras (ex: R$ 1.150 total)
• Após reconhecimento + abatimento, a Fatura de Recebível fica com saldo residual de R$ 150 (apenas os impostos)

O operador deve cobrar/receber esses R$ 150 separadamente, ou ajustar a operação para que o adto já inclua a expectativa de impostos.

Excluir pedido com adiantamento

Estado da Fatura de Adto	Pode excluir o pedido?
ABERTA (sem pagamento)	Sim, normalmente — não há dinheiro a estornar
LIQUIDADA (cliente pagou)	Não. O sistema bloqueia e orienta usar "Devolver Adto"
RECONHECIDA (NF emitida)	Não. Cancelar via fluxo fiscal (NF de devolução)

Excluir Pagamento de adto reconhecido

Se você tentar excluir um Pagamento que liquidou uma Fatura de adto já reconhecida em NF, o sistema bloqueia com a mensagem:

"Este Pagamento liquidou Faturas de Adiantamento JÁ RECONHECIDAS em NF... Desvincule esses adiantamentos via Consulta de Adiantamentos antes de excluir."

Solução: ir na Consulta de Adiantamentos, desvincular a NF do adto, depois voltar e excluir o pagamento.

Gerar boleto para Fatura de adto

O sistema bloqueia geração de boleto para Faturas de adto. Adto representa dinheiro a receber por outra via (PIX, depósito, dinheiro à vista) — não se cobra adto via boleto.

Se quiser que o cliente pague o adto via boleto a vencer, use a operação normal (sem "Gera Adiantamento") com forma de pagamento boleto. Só ative o adto quando o recebimento for confirmado.

---

Erros comuns e como resolver

"Operação marcada como 'Gera Adiantamento' exige uma Receita/Despesa Padrão"

Causa: tentou salvar uma operação com "Gera Adiantamento" marcado, mas sem preencher o campo R/D Padrão.

Solução: preencher o campo R/D Padrão apontando para a RD de adiantamento (ver capítulo "Configuração inicial").

"A Receita/Despesa não está marcada como 'Não Considerar no DRE'..."

Causa: ao salvar a operação, o sistema detectou que a RD apontada não tem a flag "Não considerar no DRE" marcada.

Solução: confirmar Sim para continuar (o adto contará no DRE imediatamente, contra o modelo recomendado) OU cancelar, ir na RD e marcar a flag, depois voltar.

"Esta Fatura é um Adiantamento de Pedido LIQUIDADO. Não pode ser removida diretamente..."

Causa: tentou excluir uma Fatura de Adto liquidada — há dinheiro real movimentado que precisa ser estornado contabilmente.

Solução: usar a ação Devolver Adto na Consulta de Adiantamentos para fazer o estorno bancário registrado.

"Existem Faturas de Adiantamento ABERTAS nos pedidos desta NF..."

Causa: tentou emitir a NF de um pedido cuja Fatura de Adto ainda não foi liquidada (cliente não pagou o adto ainda).

Solução: ir na tela de Caixa Recebimento, liquidar a Fatura de Adto, depois retornar e emitir a NF.

"Este Pagamento liquidou Faturas de Adiantamento JÁ RECONHECIDAS em NF..."

Causa: tentou excluir um Pagamento que liquidou um adto que já foi reconhecido (NF emitida).

Solução: desvincular o adto da NF primeiro (ação Desvincular NF na Consulta de Adiantamentos), depois excluir o Pagamento.

Adto não aparece como reconhecido após emitir a NF

Possíveis causas:

• Sinal divergente: o pedido era de compra mas a NF foi emitida como saída (ou vice-versa). O sistema não vincula adtos com sinal contábil oposto à NF.
• NF não está autorizada: status cstat diferente de 100 ou 150. Reemitir/autorizar a NF.
• Pedido não vinculado: em Importar XML, não foi usado o botão "Relacionar Pedido".

Solução: usar a ação Vincular NF na Consulta de Adiantamentos para vincular manualmente.

A coluna "Antecipada" não aparece na emissão da NF

Possíveis causas:

• O parceiro não tem saldo livre. A coluna só aparece quando há adiantamento liquidado (saldo financeiro = 0) com saldo vivo > 0 e do mesmo sinal da NF. Adto ainda em aberto (não pago) não conta.
• As parcelas ainda não foram geradas. Feche a forma/condição de pagamento para o grid de parcelas aparecer.
• O adto é do próprio pedido sendo faturado. Esse é reconhecido automaticamente e é excluído do saldo livre — não aparece como coluna manual.

Solução: confirmar na Consulta de Adiantamentos que o parceiro tem um adto com Saldo Vivo > 0 e status LIQUIDADO/PARCIAL.

O saldo de adiantamento não foi consumido ao gravar a NF

Possíveis causas:

• Política em "Manual" e nenhuma parcela marcada. No modo Manual (padrão), o saldo só é consumido nas parcelas que você marcar como "Antecipada". Sem marcar, a fatura sai cheia — isso é o esperado.
• Adto não liquidado. Só adto pago (saldo financeiro = 0) vira saldo disponível.
• Sinal divergente. Adto a fornecedor não abate NF de venda (e vice-versa).
• Na compra (XML), a política está em Manual. A compra não tem coluna manual — precisa de política Automático/Perguntar para consumir.

Solução: marcar as parcelas na coluna "Antecipada" (venda), ou mudar o parâmetro politicaConsumoSaldoAdiantamento para Automático/Perguntar.

"Saldo de adiantamento insuficiente para antecipar esta parcela"

Causa: a soma das parcelas marcadas como "Antecipada" ultrapassou o saldo disponível do parceiro.

Solução: marcar menos parcelas (ou parcelas de menor valor), respeitando o "Disp." mostrado ao lado do botão Antecipações.

 

Glossário

Termo	Significado
Adiantamento	Pagamento (ou recebimento) feito antes da emissão da Nota Fiscal correspondente
Fatura de Adto (Fatura A)	Fatura interna do sistema com origem 3 que representa o adiantamento (passivo ou ativo)
Fatura de Recebível (Fatura B)	Fatura interna criada pela emissão/importação da NF — representa o recebível/pagável normal
Reconhecimento	Ato de vincular um adiantamento a uma NF emitida, transformando o passivo/ativo em receita/despesa contábil
Vinculação	Sinônimo de reconhecimento
Devolução	Estorno bancário do adiantamento — usado quando o pedido é cancelado antes da NF
Liquidação	Pagamento (ou recebimento) que zera o saldo da Fatura — diferente do reconhecimento
Abatimento	Redução do saldo da Fatura de Recebível em valor já adiantado — feita automaticamente pelo sistema na emissão/importação da NF
Sinal contábil	Indicador "+" (receita/entrada) ou "-" (despesa/saída) da Fatura
CPC 47 / IFRS 15	Norma contábil brasileira/internacional que define quando uma receita pode ser reconhecida
RD	Receita/Despesa (cadastro de classificação contábil)
cstat	Código de status da NF na SEFAZ. 100 = autorizada; 150 = autorizada fora de prazo
origemFatura	Campo interno da Fatura que classifica de onde veio: 1=Pedido, 2=NotaFiscal, 3=PedidoAdiantamento, 4=OrdemServico, 5=Manual, 6=Agrupamento, 7=AdiantamentoManual (legado), 8=DevoluçãoAdiantamento
idnDreNenhum	Flag da RD que indica "não considerar no DRE" — essencial para RDs de adiantamento
Saldo Vivo	Crédito de adiantamento ainda disponível = valor original − tudo que já foi reconhecido em NF ou devolvido. Diferente do "Saldo financeiro" (que indica se o adto foi pago)
Saldo livre	Adiantamentos do parceiro disponíveis para consumir numa NF: avulsos + sobras de outros pedidos (exclui o adto do pedido sendo faturado)
Reconhecimento parcial	Reconhecer apenas parte do adto numa NF (ex.: adto R$ 10.000, NF R$ 8.000 → reconhece R$ 8.000, sobra R$ 2.000 de saldo vivo)
Coluna "Antecipada"	Coluna no grid de parcelas da emissão de NF onde o operador marca quais parcelas serão quitadas com o saldo de adiantamento
Adiantamento avulso	Adiantamento criado sem pedido (crédito do parceiro), lançado pelo botão "Novo Adiantamento Avulso" na Consulta de Adiantamentos
politicaConsumoSaldoAdiantamento	Parâmetro que define como o saldo livre é consumido: Manual (só o que o operador marcar), Automático (FIFO sem perguntar) ou Perguntar

---

Suporte

Em caso de dúvidas operacionais ou comportamentos inesperados:

1. Conferir as seções "Casos especiais" e "Erros comuns" deste capítulo
2. Verificar os filtros da operação e da RD (capítulo "Configuração inicial")
3. Reproduzir o cenário em ambiente de teste com dados controlados
4. Contatar o suporte do sistema com:
   • Número do pedido
   • Códigos da(s) Fatura(s) envolvida(s)
   • Print da tela e mensagem de erro
   • Descrição do que esperava acontecer

Versão deste manual: Rev 2 — 2026-06-10 (modelo de eventos / saldo vivo, reconhecimento e devolução parciais, adiantamento avulso, Relatório de Posição, política de consumo e coluna "Antecipada" na emissão de NF)

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)

1. Monte a NF normalmente (cliente, operação, produtos) e feche o parcelamento (forma + condição) — as parcelas aparecem no grid.
2. Clique em "Antecipações" para conferir o saldo disponível do cliente (opcional).
3. Na coluna "Antecipada", marque as parcelas que devem ser quitadas com o saldo de adiantamento.
4. 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)