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:

Conferir as seções "Casos especiais" e "Erros comuns" deste capítulo
Verificar os filtros da operação e da RD (capítulo "Configuração inicial")
Reproduzir o cenário em ambiente de teste com dados controlados
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)