FJFrigo · Lançamentos · menu228 — Adiantamentos / Prestação de Contas

Validações do Adiantamento

Dinheiro entregue a alguém antes da despesa, e a prestação de contas que fecha o ciclo. As regras de cada etapa, e por que o sistema recusa um segundo adiantamento a quem ainda não prestou contas do primeiro.

Tela: Adiantamentos / Prestação de Contas (228) Duas etapas: entregar e prestar contas Autoridade: o backend — a tela é espelho

1. Adiantamento

A empresa entrega dinheiro a alguém — motorista, comprador, despachante — para gastar em nome dela.

2. Prestação de contas

A pessoa volta com as notas. Cada despesa é lançada e o saldo é acertado.

3. Quitação

Sobrou dinheiro? Devolve. Faltou? A empresa completa. Aí o adiantamento fecha.

Bloqueia

Recusa e não grava. statuscode 400.

A

Como o ciclo funciona

Para quem atende

O adiantamento é dinheiro que sai da empresa sem despesa definida ainda — alguém vai gastar e depois presta contas. Enquanto isso não acontece, aquele valor é uma pendência aberta no nome da pessoa.

O que o sistema grava em cada etapa:

· Adiantamento — o registro, mais o movimento bancário da saída (a conta de saída) e da entrada (a conta que representa o adiantado).
· Prestação de contas — as despesas apresentadas, com nota, IVA e centro de custo.
· Quitação — a devolução do que sobrou, ou o complemento do que faltou, e a data que fecha o adiantamento.

Enquanto a data de quitação estiver vazia, o adiantamento está em aberto — e é isso que a trava da seção D vigia.

B

Lançar o adiantamento — campos

Na ordem em que são conferidos
Bloqueia

Valor incorreto.

QuandoValor vazio, zero ou negativo.

Todos
Bloqueia

Data incorreta.

Todos
Bloqueia

Conta de saída incorreta.

Conta de entrada incorreta.

As duas contasA de saída é de onde o dinheiro sai (banco ou caixa); a de entrada é a conta que passa a registrar o valor adiantado, no nome de quem recebeu.

Todos
Bloqueia

Emitente incorreto.

O emitente aquiÉ quem recebeu o dinheiro — normalmente um funcionário ou prestador cadastrado como emitente.

Todos
C

Moeda e câmbio

A conta de entrada manda
Bloqueia

Moeda da conta de entrada diferente da moeda do lançamento.

QuandoA moeda escolhida no adiantamento não é a moeda cadastrada na conta de entrada. A conta de saída não é conferida por esta regra.

Todos
Bloqueia

Sem cotação da moeda X em 2026-09-09 - cadastre o cambio do dia antes de gravar.

QuandoMoeda estrangeira sem cotação cadastrada naquele dia.

SairCadastrar a cotação do dia na tela de moedas e gravar de novo.

Todos
D

A trava do adiantamento em aberto

A regra que mais gera chamado

A mesma pessoa não recebe outro adiantamento na mesma moeda enquanto tiver um sem prestação de contas há mais de 7 dias. É a trava que impede saldo aberto se acumulando no nome de alguém.

Bloqueia

Existe adiantamento sem prestação de contas [1002345], de 2026-08-20.

QuandoO mesmo emitente já tem adiantamento sem data de quitação, na mesma moeda, com data diferente da que está sendo lançada, e a diferença passa de 7 dias.

O que NÃO disparaAdiantamento aberto do mesmo dia (é o caso de dois adiantamentos na mesma viagem) · aberto há 7 dias ou menos · em outra moeda · já quitado.

SairPrestar contas do adiantamento citado — o número e a data vêm na mensagem — ou quitá-lo.

Todos
E

Período fechado — nas três etapas

U.D.F. da filial

A conferência vale nas três operações, e a mensagem diz qual data está travada — o que importa, porque a data do adiantamento e a da prestação são diferentes.

Bloqueia

Período já fechado: a data do adiantamento precisa ser posterior a 2026-07-31.

Período já fechado: a data da prestação precisa ser posterior a 2026-07-31.

QuandoAo incluir (data do adiantamento), ao gravar a prestação de contas (data da prestação) e ao excluir — e na exclusão vale a data do adiantamento, não a da quitação.

A comparaçãoÉ menor ou igual: o próprio dia da U.D.F. já está fechado.

Todos
F

Prestação de contas e quitação

A segunda metade do ciclo
Bloqueia

Esse centro de custo nao aceita lancamentos manuais.

QuandoUma despesa da prestação usa centro de custo que não aceita lançamento manual.

ConferirCadastro do centro de custo, marcador de lançamento manual — o mesmo que trava a tela de Títulos.

Todos
Bloqueia

Sem centro de custo de quitacao.

Nenhum tipo de faturamento marcado como "…" - sem ele nao da pra lancar a prestacao no financeiro.

QuandoFalta cadastro: o centro de custo de quitação da filial, ou o tipo de faturamento que a prestação usa para gerar o título.

SairÉ cadastro, não lançamento — precisa ser resolvido nos parâmetros da filial e no cadastro de tipos de faturamento.

Todos
Bloqueia

Esse adiantamento não tem transferência vinculada.

Transferência do adiantamento não encontrada.

QuandoAo abrir ou alterar a transferência bancária que o adiantamento gerou, e ela não existe — normalmente registro antigo, gravado antes de o vínculo existir.

Todos
G

Como o erro chega na tela

Para o QA reproduzir e reportar

Toda resposta sai com HTTP 200; quem diz o que aconteceu é o statuscode no corpo — 400 para as recusas deste documento.

As três gravações são transação única. Elas tocam o adiantamento, as faturas da prestação (que são apagadas e regravadas) e o movimento bancário da devolução — tudo junto, ou nada.

Ao abrir chamado, copie o código de ocorrência de 8 caracteres dos erros inesperados.

Nenhuma regra bate com essa busca. Tente um trecho menor da mensagem, ou limpe os filtros.