FJFrigo · Lançamentos · menu223 — Lançamentos Bancários Manuais

Validações do Lançamento Bancário

O que a tela exige para gravar um lançamento bancário manual, e o que ele significa no saldo da conta. É a tela mais simples do módulo financeiro — e por isso a que mais aparece em dúvida sobre o que pode e o que não pode.

Tela: Lançamentos Bancários Manuais (223) Tabela: financeiro_lancamento_banco Autoridade: o backend — a tela é espelho

Bloqueia

Recusa e não grava. Chega como statuscode 400 com a frase abaixo.

Aviso

Regra da tela, ou comportamento que surpreende sem ser erro.

O que esta tela faz

Lança um movimento na conta bancária sem título por trás — tarifa, rendimento, ajuste. Entra no saldo e na conciliação como qualquer outro movimento.

A

O que é um lançamento bancário manual

Para quem atende

Quase todo movimento de uma conta bancária no sistema nasce de outra coisa: uma baixa de título (alguém pagou ou recebeu) ou uma transferência entre contas. O lançamento manual é a exceção — é o movimento que não tem título nenhum por trás.

Quando se usa: tarifa do banco, rendimento de aplicação, estorno, IOF, débito automático, ajuste de saldo. Tudo que aparece no extrato e não corresponde a um título lançado no sistema.

O que ele afeta: entra no saldo da conta, aparece na Conciliação Bancária (225) para ser marcado contra o extrato, e é levado para a contabilidade pela sincronização.

O que ele NÃO faz: não baixa título, não mexe em pendência de cliente ou fornecedor, e não gera cheque. Quem precisa quitar um título usa a tela de Títulos (221) ou a Baixa Coletiva (222).

O sinal do valor não é escolhido no valor — quem decide se entra ou sai da conta é o Tipo de Lançamento, que tem a operação (entrada ou saída) no cadastro dele. Um valor lançado com o tipo errado aparece no lado errado do saldo.

B

Campos obrigatórios

Incluir e alterar

A tela marca como obrigatórios conta, data, valor, moeda e tipo de lançamento; o servidor confere de novo cada um deles. O histórico não é obrigatório (o sistema antigo também não o exige).

Bloqueia

Conta bancária / Data / Valor: campo obrigatório (mensagens da tela)

QuandoQualquer um dos três em branco. A tela recusa antes de enviar e marca o campo.

Também no servidorConta bancária e data também são exigidas pelo servidor (validação do pedido, recusa com 400) — uma chamada por fora da tela sem conta não chega ao banco.

Todos
Bloqueia

Campo [Moeda] em branco.

QuandoMoeda não informada. A tela também marca a moeda como obrigatória; o servidor confere de novo ao gravar.

Todos
Bloqueia

Campo [Tipo de lançamento] em branco.

QuandoTipo de lançamento bancário não informado. A tela também o marca como obrigatório; o servidor confere de novo.

Por que importaÉ ele que diz se o movimento entra ou sai da conta — sem ele o lançamento não teria sinal.

Todos
Bloqueia

Campo [Valor original] em branco.

QuandoValor vazio ou zero. Valor negativo é aceito — o sinal do movimento vem do tipo de lançamento, não do valor.

Todos
Bloqueia

Tipo de lançamento 113/114 é de transferência entre contas - grave pela tela de Transferências (224), não por aqui.

QuandoTipo 113 ou 114 escolhido na inclusão ou na alteração (o sistema antigo não barra; sem a trava nascia uma perna de transferência órfã).

Todos
Bloqueia

Sem cotação da moeda X em dd/mm/aaaa - cadastre a cotação (tela 21) antes de gravar.

QuandoMoeda diferente da moeda local da filial e sem cotação financeira naquele dia.

Todos
Aviso

O câmbio vem da cotação do dia

ComportamentoO campo de câmbio fica desabilitado: a tela mostra a cotação financeira da moeda na data (e a atualiza ao mudar moeda ou data) e o servidor a recalcula na gravação. Na moeda local o câmbio é 1; sem cotação a tela avisa e a gravação é recusada (regra acima).

Todos
C

Data e período fechado

U.D.F. geral da filial
Bloqueia

Essa data já está fechada.

QuandoData do lançamento menor ou igual à U.D.F. da filial. O dia da própria U.D.F. já está fechado.

Conferirparametros.udf — a mesma data que trava os títulos, mostrada no rodapé do sistema.

Vale nos doisIncluir e alterar. Alterar um lançamento antigo, de período já fechado, também é recusado.

Todos
Bloqueia

Data inicial inválida.

Data final inválida.

QuandoNos filtros de período da grade, com data em formato que o sistema não entende. Não é do lançamento — é da consulta.

Todos
D

Alterar e excluir

O que trava, e o que não trava

Além do período fechado, o servidor recusa alterar ou excluir lançamento já conciliado, perna de transferência (tipo 113/114) e variação cambial gerada automaticamente. Não há trava de "já contabilizado". Estas travas não existem no sistema antigo — foram acrescentadas no porte (decisão de 16/09/2026).

Bloqueia

O lançamento N já está conciliado em dd/mm/aaaa - desfaça a conciliação antes de alterar (ou excluir).

QuandoO lançamento tem data_conciliacao preenchida. Vale para alterar e excluir; é preciso desfazer a conciliação (tela 225) antes.

OrigemTrava acrescentada no porte (o sistema antigo deixava alterar e desfazia o casamento com o extrato sem avisar).

Todos
Bloqueia

O lançamento N é de transferência entre contas (tipo 113/114) - alterar/excluir pela tela de Transferências (224).

O lançamento N é de variação cambial, gerado automaticamente, e não pode ser alterado/excluído por esta tela.

QuandoLançamento fora do recorte da grade (histórico começando por "Variacion cambial", ou tipo 113/114).

Todos
Bloqueia

Essa data já está fechada. (excluir)

QuandoExcluir lançamento cuja data gravada é menor ou igual à U.D.F. da filial.

Todos
Aviso

A exclusão é lógica

ComportamentoO lançamento não é apagado: fica marcado como excluído, com o usuário registrado, e some da grade. Dá para recuperar consultando o banco.

Todos

Não há permissão específica nesta tela. Quem enxerga a opção no menu inclui, altera e exclui. O controle é o do menu, em Manutenção › Acesso dos Grupos.

E

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, 401 para sessão expirada, 503 para banco em manutenção.

Ao abrir chamado, copie o código de ocorrência de 8 caracteres que aparece nos erros inesperados — com ele o suporte acha a linha exata no log, entre todos os clientes.

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