LiquidacaoFatura

A rotina de Liquidação de Fatura pertence ao módulo Financeiro, na área de Comex/Câmbio (menu 1585).

A rotina de Liquidação de Fatura pertence ao módulo Financeiro, na área de Comex/Câmbio (menu 1585). Ela permite liquidar títulos (faturas) a receber vinculados a contratos de câmbio (modelos ACC, ACE, TRV, entre outros) ou sem vínculo a contrato (modelos NDF, OPC e Pronto), aplicando a cotação de câmbio informada, gerando os lançamentos financeiros e a integração contábil correspondentes, e atualizando o status do contrato de câmbio quando ele for totalmente liquidado.

A rotina possui duas telas de acesso distintas, cada uma com sua própria permissão de tela: “Liquidação de fatura” (busca por contratos ACC/ACE/TRV, permissão ID 3887) e “Liquidação de Fatura Sem Contrato” (busca de faturas sem vínculo a contrato, permissão ID 3888) — ambas dentro da área “Comex” (ID 1585), mas cada uma controlada por sua própria permissão de tela (ver seção Permissões).

Cabeçalho da liquidação (DTODeCabecalhoLiquidacaoFatura) — corpo do request da ação Salvar:

Título a processar (DTODeTituloAProcessar) — principais campos relevantes à liquidação de fatura (o DTO é compartilhado com outras rotinas financeiras e possui um número grande de campos genéricos de título; abaixo estão destacados os campos com relevância direta ao contexto de liquidação de fatura em câmbio):

Fatura elegível para liquidação sem contrato (ProjecaoDeContratoFaturaTitulo) — retornado por “ListarFaturasSemContrato”:

[informação não disponível na análise de código — validar com analista/vídeo do sistema: os demais campos deste DTO (juros, desconto, tarifa, multa, acréscimo, decréscimo, campos de boleto/CNAB, campos de retenção de impostos, campos Serasa, etc.) pertencem ao modelo genérico de título financeiro compartilhado por várias rotinas e não são exclusivos da liquidação de fatura em câmbio; não foram detalhados individualmente por não fazerem parte do escopo de negócio desta rotina. A projeção completa de ProjecaoDeContratoFaturaTitulo também possui campos adicionais não listados aqui, por não terem sido lidos até o fim na análise]

Contrato de câmbio a processar (DTODeContratoCambio): [informação não disponível na análise de código — validar com analista/vídeo do sistema: o conteúdo detalhado deste DTO não foi lido nesta análise; o contrato de câmbio é identificado, entre outros dados, pelo modelo da operação (NDF, NDFC, OPC, PPE, Pronto, ACC, ACE, TRV, ProntoF), usado para determinar o fato contábil da integração]

Regra 1 — Lista de títulos obrigatória. A ação Salvar exige que ao menos um título seja informado em TitulosAProcessar; se a lista vier vazia, a operação é bloqueada antes de qualquer processamento.

Regra 2a — Validação de saldo vinculado (liquidação com contrato). Para faturas vinculadas a um contrato de câmbio, o sistema valida se o valor já vinculado à fatura dentro do contrato é suficiente para cobrir o valor da liquidação solicitada; se o valor da liquidação for maior que o valor vinculado, a operação é bloqueada.

Regra 2b — Validação de saldo da fatura (liquidação sem contrato). Para faturas sem vínculo a contrato de câmbio, o sistema valida se o saldo disponível da fatura (saldo total menos o valor já vinculado a outros contratos) é suficiente para o valor da liquidação solicitada; se o valor da liquidação for maior que esse saldo, a operação é bloqueada.

Regra 3 — Cotação especial para operações do tipo TRV. Para contratos cujo modelo de operação é TRV, a rotina consulta e aplica a cotação específica do contrato TRV (quando existente e maior que zero), substituindo a cotação genérica informada no cabeçalho da liquidação — diferente do tratamento padrão dado aos demais modelos (NDF, NDFC, OPC, PPE, Pronto, ACC, ACE, ProntoF).

Regra 4 — Encerramento automático do contrato de câmbio. Quando o valor liquidado acumulado do contrato de câmbio se iguala ao valor total do contrato, o sistema atualiza automaticamente o status do contrato para “Liquidado”, refletindo que não há mais saldo pendente de liquidação naquele contrato.

Regra 5 — Geração de lançamentos financeiros e integração contábil. Toda liquidação de fatura bem-sucedida gera os lançamentos financeiros correspondentes (movimentação financeira) e aciona a integração contábil automática, associando o lançamento ao fato contábil determinado pelo modelo de operação do contrato de câmbio (NDF, NDFC, OPC, PPE, Pronto, ACC, ACE, TRV ou ProntoF). Se o modelo de operação do contrato não tiver um fato contábil implementado no sistema, a operação de liquidação não é concluída.

Regra 6 — Liquidação sem contrato restrita a determinados modelos. A liquidação sem vínculo a contrato de câmbio (LiquidacaoSemContrato = verdadeiro) só é aplicável às faturas cujo modelo é NDF, NDFC, OPC ou “Pronto” (ou sem modelo definido); a listagem de faturas sem contrato (“ListarFaturasSemContrato”) já filtra apenas faturas nessa condição, com saldo em aberto positivo e ainda não totalmente vinculadas a um contrato de câmbio. Para os demais modelos, a liquidação deve necessariamente estar vinculada a um contrato de câmbio informado em ContratosCambioAProcessar.

Regra 7 — Toda a operação de liquidação é transacional. A liquidação (atualização de títulos, contrato de câmbio, lançamentos financeiros e integração contábil) ocorre dentro de uma única transação de banco de dados (Unidade de Trabalho); se qualquer etapa falhar, nenhuma alteração é persistida, evitando dados inconsistentes entre título, contrato e contabilidade. Caso ocorra uma exceção durante a integração contábil ou o processamento dos lançamentos, o sistema registra a falha em log e interrompe a operação.

Acesso às telas:

Ambas as telas pertencem à área/menu “Comex” (ID 1585) dentro do módulo Financeiro, mas cada uma tem sua própria permissão de tela — um usuário pode ter acesso a uma sem ter acesso à outra.