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