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. (É possível configurar os pedidos para calcularem impostos como IPI e ICMS ST)

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.

---

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)
idnDreNenhum	Flag da RD que indica "não considerar no DRE" — essencial para RDs de adiantamento

---

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 1 — 2026-05-21