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
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:
- Localizar o pedido com adto
- Faturar normalmente (a operação da NF pode ser diferente da do pedido — use a operação de venda normal, sem "Gera Adiantamento")
- Autorizar/emitir a NF
O sistema automaticamente:
-
Vincula a Fatura de adiantamento à NF emitida (reconhecimento contábil) — preenche
idNotaFiscalReconhecimento - Abate a Fatura de Recebível (gerada pela NF) no valor do adto já recebido — assim o cliente não é cobrado em dobro
-
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".