FJFrigo · Lançamentos · menu226 e menu22R — Empréstimos

Validações dos Empréstimos

As duas telas de empréstimo — Captação (226) e FIDC/Fomento (22R) — no mesmo documento: elas compartilham o código, e o que muda é o que cada uma financia.

Telas: Empréstimos Captação (226) e FIDC/Fomento (22R) Gravar gera título: os dois nascem juntos Autoridade: o backend — a tela é espelho

Bloqueia

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

Aviso

Comportamento que surpreende sem ser erro.

226 — Captação

A empresa toma dinheiro emprestado do banco e paga em parcelas.

22R — FIDC/Fomento

A empresa antecipa recebíveis: entrega títulos de clientes e recebe o valor adiantado, menos tarifas.

A

As duas telas, e o que muda entre elas

Para quem atende

Nas duas a empresa recebe dinheiro hoje e devolve depois — a diferença é o que garante a operação.

226 — Captação22R — FIDC / Fomento
O que éEmpréstimo bancário comumAntecipação de recebíveis: títulos de clientes são entregues à financeira
O que a empresa devolveParcelas, com jurosNada diretamente — quem paga é o cliente do título; a empresa paga tarifas e o deságio
Grade filhaParcelasTítulos entregues, e tarifas
Entrada de dadosDigitaçãoDigitação, ou importação do borderô em planilha

Gravar um empréstimo gera os títulos financeiros dele na mesma transação. Empréstimo sem título não aparece no financeiro, e título sem empréstimo não tem tela para corrigir — por isso os dois nascem juntos, ou nenhum nasce.

É isso que torna a alteração perigosa, e o motivo das travas da seção D: regravar apaga e refaz todos os títulos.

B

Campos obrigatórios

Vale nas duas telas
Bloqueia

Campo [Data] em branco.

Campo [Emitente] em branco.

Campo [Conta Bancária] em branco.

QuandoQualquer um deles em branco ou zerado, ao incluir e ao alterar.

O emitente aquiÉ quem emprestou — o banco ou a financeira —, não um cliente.

Todos
Bloqueia

Informe o valor bruto e o total de crédito líquido - não é possível gravar com valor zerado.

QuandoValor bruto ou líquido zerado. Ausência do campo já é barrada antes; esta regra existe para o zero.

Por que importaEmpréstimo de valor zero geraria um título a receber de 0,00 no financeiro.

Todos
C

Período fechado

U.D.F. da filial
Bloqueia

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

QuandoData do empréstimo menor ou igual à U.D.F. da filial. A data limite vem na mensagem.

Todos
D

Alterar e excluir — as duas travas

Por que elas existem

Regravar um empréstimo apaga e refaz todos os títulos dele. As duas travas abaixo impedem que isso leve junto trabalho de outra pessoa.

Bloqueia

Este empréstimo já tem parcela baixada - não é possível alterá-lo, porque regravar desfaria a baixa lançada por outra pessoa.

QuandoAlguma parcela do empréstimo já foi paga.

No sistema antigoAli o botão Gravar é apenas desabilitado. Aqui a trava é no servidor, porque a consequência é concreta e o endpoint responde a qualquer chamada.

Todos
Bloqueia

Não é possível alterar: o empréstimo já foi conferido na contabilidade.

QuandoO empréstimo já virou lançamento contábil e foi conferido. Enquanto ninguém conferiu, continua editável.

Sem escapeNão há grupo nem regra que passe por cima — o caminho é a contabilidade retirar a conferência.

Todos
E

Tipo de título e tipo de faturamento

Recusas específicas
Bloqueia

Empréstimo de terceiros só aceita título CHQ (cheque)

QuandoEmpréstimo marcado como de terceiros com tipo de título diferente de cheque.

Todos
Bloqueia

Empréstimo sem tipo de faturamento - não é possível regravar o financeiro com segurança.

Empréstimo sem tipo de faturamento - não é possível desfazer o financeiro com segurança.

QuandoEmpréstimo antigo, sem tipo de faturamento gravado, sendo alterado ou excluído.

Por que recusa em vez de seguirO tipo de faturamento é parte da chave que acha os títulos do empréstimo. Sem ele, apagar "os títulos deste empréstimo" poderia alcançar títulos de outro módulo com o mesmo número.

Todos
F

A importação do borderô

Só no 22R

No FIDC os títulos podem vir de uma planilha do borderô da financeira, em vez de digitados. A importação não grava nada — ela preenche a tela, e a gravação é a de sempre.

Bloqueia

Nenhum título encontrado na planilha - confira se é o borderô de fomento (a coluna H precisa ter o número da NF).

QuandoA planilha não tem a forma esperada. A causa quase sempre é arquivo errado, ou o borderô salvo em outro layout.

Todos
Aviso

Tarifa que não existe no cadastro volta sem id

ComportamentoAs tarifas da planilha são casadas por descrição com o cadastro de tarifas. A que não casar aparece na tela sem vínculo, para alguém resolver — não é erro, é aviso.

SairCadastrar a tarifa com a mesma descrição, ou ajustar a linha na tela antes de gravar.

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.

Empréstimo e títulos são uma transação só. Falhando a geração dos títulos, o empréstimo não fica no banco. Ao reproduzir um erro, a base volta sozinha.

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

H

O cálculo das parcelas e dos títulos

Como funciona hoje

226 — botão "Gerar". Monta o cronograma a partir do valor, do número de parcelas, do prazo e da taxa, como o sistema anterior: taxa mensal sobre 30 dias; anual sobre 360 (Brasil e tipos 1162/1163) ou 365; juros sobre saldo, prazo fechado e "valor captado na última parcela". Nada é gravado até o Gravar. Ao alterar o prazo de uma parcela, os juros, o IVA e o líquido daquela linha são refeitos.

22R — vencimento com float e % de juros. Calculados só na linha que se edita, como no sistema anterior: ao mudar o vencimento, o vencimento com float é refeito (vencimento + dias de float; vencimento no sábado ou domingo vai antes para segunda, e o resultado no fim de semana vai para terça). O vencimento com float pode ser digitado. Ao confirmar a linha, o % de juros e o líquido são refeitos pelo float da linha. Mudar a data ou os dias de float do cabeçalho não mexe nos títulos já lançados, e a gravação guarda o que está na grade. Dias de float = 0 é válido (o vencimento sem dias somados).

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