Liquidação de Contrato
Criado por Igor Ribeiro em 03 de setembro de 2026
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Liquidação de Contrato
Processo de liquidação de contratos de câmbio com atualização monetária automática, cálculo de juros e integração contábil.
Visão Geral da Liquidação de Contrato
A rotina “Liquidação de Contrato” fica no módulo Financeiro, dentro do submenu Comex, e o usuário a utiliza para dar baixa nos Contratos de Câmbio que a empresa já tem cadastrados. É nesse momento que o valor negociado em moeda estrangeira é efetivamente liquidado junto à carteira, reduzindo (ou zerando) o saldo do contrato.
A tela funciona como um assistente de três passos: no passo “1 – Selecione os contratos” o usuário pesquisa e escolhe os contratos que deseja liquidar; no passo “2 – Liquidação das contratos” o usuário informa quanto quer liquidar de cada contrato e confere a variação cambial e os juros já calculados pelo sistema; no passo “3 – Comprovante” o usuário emite o comprovante da operação. A rotina trabalha em lote, ou seja, o usuário consegue liquidar vários contratos de uma só vez, em uma única execução.
Processamento em Transação Única
A liquidação não é apenas um registro de baixa. Ao concluir o processo, o sistema executa automaticamente uma série de ações: atualiza monetariamente os contratos selecionados, lança os juros dos modelos que os admitem (ACC, ACE e TRV), gera as movimentações financeiras de débito e crédito entre as carteiras envolvidas, envia tudo para a integração contábil e, quando o contrato é liquidado integralmente, muda a situação dele para “Liquidado”. Tudo isso acontece em uma única operação: se algum contrato do lote falhar, nenhum contrato do lote é liquidado.
Vídeo Tutorial da Liquidação de Contrato
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso da Liquidação de Contrato
Permissões de Acesso
Para acessar o caminho “Financeiro > Comex > Liquidação de Contrato”, o usuário precisa ter, no seu perfil de acesso, a permissão “EditViewDeLiquidacaoDeContratoBuscaContratos”. Sem essa permissão, o item de menu desta rotina nem aparece para o usuário. O identificador interno desta rotina, exibido no rodapé da tela, é 3107 (esse número serve apenas de referência, caso seja necessário abrir um chamado de suporte sobre esta tela).
Para efetivamente concluir uma liquidação (ou seja, para clicar em “Concluir” e gravar o processamento), o usuário precisa também da permissão “LiquidacaoContrato/Salvar”. Um usuário que tenha acesso à rotina, mas não tenha essa permissão adicional, consegue pesquisar contratos e montar o lote de liquidação, mas não consegue efetivar (concluir) a liquidação.
A emissão do comprovante, no passo “3 – Comprovante”, não exige uma permissão própria cadastrada especificamente para essa ação. [informação não disponível na documentação de origem, validar com analista responsável: outras rotinas do mesmo submenu Comex possuem uma permissão específica de impressão do comprovante, e esta rotina aparentemente não possui; não foi possível confirmar se essa ausência é intencional]
Dependências e Configurações
Antes de usar esta rotina, o usuário precisa ter:
- Contratos de Câmbio já cadastrados na rotina “Contrato de Câmbio”, com situação “Aberto” e ainda com saldo a liquidar.
- Moeda estrangeira da liquidação já cadastrada no sistema, com cotação registrada para a data em que a liquidação está sendo feita.
- Carteira ativa selecionada na sessão de trabalho do usuário. Nos modelos de contrato ACC, ACE e TRV, é essa carteira ativa que entra como contrapartida dos lançamentos gerados pela liquidação.
- Fato Contábil do módulo Financeiro configurado e ativo para a operação de “liquidação de contrato de câmbio”, combinado com a variação de cada modelo de contrato que será liquidado. Sem essa configuração, a liquidação não pode ser concluída (ver seção 9, Regra 11).
Processo de Criação: Passo a Passo da Liquidação de Contrato
Acessar a rotina
O usuário acessa o caminho “Financeiro > Comex > Liquidação de Contrato”. O sistema abre a aba “Liquidação de contrato” já no passo “1 – Selecione os contratos” e recupera automaticamente o último filtro que esse mesmo usuário utilizou nesta rotina, preenchendo sozinho o combo “Filtro” e o campo de filtro correspondente.
Escolher o tipo de filtro
No combo “Filtro”, o usuário escolhe por qual campo quer pesquisar os contratos: “Número contrato”, “Carteira”, “Vencimento”, “Modelo”, “Participante” ou “Valor”. Assim que o usuário escolhe uma opção, o sistema exibe, ao lado, apenas o campo de filtro correspondente àquela opção e esconde os demais campos de filtro.
Preencher o filtro escolhido
O usuário preenche o campo de filtro que o sistema exibiu. É obrigatório informar pelo menos um filtro: o sistema não permite pesquisar contratos sem nenhum critério preenchido (ver seção 9, Regra 1). Quando o filtro escolhido é “Número contrato”, o usuário pode selecionar vários números de contrato de uma só vez.
Informar a Moeda e conferir a Cotação
O usuário seleciona a moeda da liquidação clicando na lupa de pesquisa do campo “Moeda”. Assim que a moeda é selecionada, o sistema preenche automaticamente o campo “Valor Cotação” com a última cotação registrada para aquela moeda, na data de movimentação do usuário. Esse campo de cotação é somente leitura: o usuário não digita nele.
Buscar os contratos
O usuário clica no botão “Buscar Contratos”. Nesse momento, o sistema grava o filtro utilizado no perfil do usuário (para lembrar da próxima vez), executa a pesquisa e preenche a grade com os contratos disponíveis para liquidação, ou seja, apenas os contratos que estão com situação “Aberto” e ainda têm saldo a liquidar. Se nenhum contrato atender aos critérios informados, o sistema exibe a mensagem “Nenhuma ocorrência encontrada.” no rodapé da grade.
Selecionar os contratos na grade
O usuário marca, na primeira coluna da grade de resultados, os contratos que deseja liquidar. Para agilizar, o botão “Selecionar todos” marca de uma só vez todos os contratos que estão sendo exibidos na grade.
Adicionar ao lote
O usuário clica em “Adicionar ao lote”. O sistema transfere os contratos que estavam marcados para a lista de liquidação (o lote). O usuário pode repetir os passos 2 a 7 quantas vezes quiser, usando filtros diferentes a cada vez, acumulando contratos de várias pesquisas diferentes dentro do mesmo lote, antes de avançar para o próximo passo.
Avançar para o passo “2 – Liquidação das contratos”
O usuário clica em “Próximo”. O sistema abre o passo “2 – Liquidação das contratos”, exibindo a lista de contratos que foram acumulados no lote, com as colunas: Modelo, Contrato, Carteira, Data de emissão, Data de vencimento, Saldo Moeda, Valor a liquidar, Variação cambial, Tipo Variação, Cotação do contrato e Juros.
Informar o valor a liquidar de cada contrato
Para cada contrato da lista, o usuário informa, na coluna “Valor a liquidar”, quanto deseja liquidar daquele contrato. Esse valor não pode ultrapassar o saldo do contrato (ver seção 9, Regra 5). Nos modelos de contrato NDF e NDFC, o valor precisa ser exatamente igual ao valor total do contrato: esses dois modelos não aceitam liquidação parcial (ver seção 9, Regra 6).
Conferir a variação cambial e os juros
O sistema calcula e exibe, para cada contrato, a variação cambial e o valor de juros que será lançado. Os juros só são calculados para os modelos ACC, ACE e TRV. Para os demais modelos, o valor de juros aparece zerado.
Remover contratos indesejados do lote (opcional)
Se o usuário quiser retirar algum contrato do lote antes de concluir, seleciona a linha correspondente na grade e usa a ação de exclusão disponível na própria grade. Se o usuário tentar excluir sem selecionar nenhuma linha antes, o sistema exibe o aviso “Atenção — É necessário selecionar um título para poder excluí-lo.”.
Concluir a liquidação
O usuário clica em “Concluir”. O sistema exibe a mensagem “O sistema está trabalhando, por favor aguarde …” enquanto processa, em sequência: grava a moeda utilizada no perfil do usuário; executa a atualização monetária dos contratos; valida o valor informado para liquidar em cada contrato; gera os lançamentos de juros; gera as movimentações financeiras de débito e crédito; atualiza o valor liquidado de cada contrato; muda para “Liquidado” os contratos que foram totalmente liquidados; e envia tudo para a integração contábil. Todas essas ações acontecem dentro de uma única operação (ver seção 8 e seção 9, Regra 15).
Emitir o comprovante
Concluída a liquidação, o sistema avança automaticamente para o passo “3 – Comprovante”, mostrando as movimentações financeiras e os lançamentos contábeis que foram gerados. A partir daí, o usuário pode imprimir o comprovante em PDF, ou exportá-lo para Excel ou Word. Nesse momento, o sistema desabilita os botões “Concluir”, “Anterior” e “Fechar Aba”, justamente para impedir que o mesmo lote seja processado duas vezes.
Descrição de Cada Campo da Tela da Liquidação de Contrato
Campos do Passo 1 – Selecione os Contratos: Filtros de Pesquisa
Filtro
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: define por qual campo o usuário quer pesquisar os contratos. As opções disponíveis são: “Número contrato”, “Carteira”, “Vencimento”, “Modelo”, “Participante” e “Valor”.
Comportamento: ao escolher uma opção, o sistema exibe ao lado apenas o campo de filtro correspondente e esconde os demais. A escolha feita fica gravada no perfil do usuário e volta preenchida automaticamente no próximo acesso à rotina.
Impacto: determina qual critério é usado na pesquisa de contratos.
Número Contrato
Tipo: campo de busca com seleção múltipla (lupa)
Obrigatoriedade: condicional, obrigatório quando “Número contrato” é a opção escolhida no campo “Filtro”
Descrição: número do contrato de câmbio que o usuário quer liquidar.
Comportamento: permite escolher vários contratos de uma só vez. Ao clicar na lupa, o sistema lista os contratos disponíveis para seleção.
Impacto: restringe a pesquisa exatamente aos contratos escolhidos pelo usuário.
Carteira
Tipo: campo de busca (lupa)
Obrigatoriedade: condicional, obrigatório quando “Carteira” é a opção escolhida no campo “Filtro”
Descrição: carteira de destino do contrato de câmbio.
Comportamento: a lupa pesquisa as carteiras (banco/caixa) já cadastradas no sistema.
Impacto: traz para a grade apenas os contratos cuja Carteira Destino seja a informada neste campo.
Data vencimento
Tipo: data
Obrigatoriedade: condicional, obrigatório quando “Vencimento” é a opção escolhida no campo “Filtro”
Descrição: data de vencimento dos contratos que o usuário quer pesquisar.
Comportamento: funciona como “a partir de”: o sistema traz os contratos cuja Data de Vencimento seja igual ou posterior à data informada.
Impacto: restringe a pesquisa por período de vencimento.
Modelo do Contrato
Tipo: seleção
Obrigatoriedade: condicional, obrigatório quando “Modelo” é a opção escolhida no campo “Filtro”
Descrição: modelo do contrato de câmbio que o usuário quer liquidar (ACC, ACE, TRV, NDF, NDFC, OPC, PPE, Pronto).
Comportamento: seleção única, a partir de uma lista fixa de modelos do sistema.
Impacto: além de restringir a pesquisa, o modelo escolhido determina como o contrato será liquidado, isto é, se aceita liquidação parcial, se gera juros e qual fato contábil o sistema usará (ver seção 9).
Código participante
Tipo: campo de busca (lupa)
Obrigatoriedade: condicional, obrigatório quando “Participante” é a opção escolhida no campo “Filtro”
Descrição: participante (cliente ou banco) vinculado ao contrato.
Comportamento: a lupa pesquisa os cadastros gerais de participantes por tipo de cadastro.
Impacto: traz para a grade apenas os contratos daquele participante.
Valor Fatura
Tipo: número decimal
Obrigatoriedade: condicional, obrigatório quando “Valor” é a opção escolhida no campo “Filtro”
Descrição: valor do contrato em moeda nacional.
Comportamento: aceita até 17 caracteres, com 2 casas decimais. O sistema procura contratos cujo Valor Contrato seja exatamente igual ao valor informado.
Impacto: restringe a pesquisa ao valor exato informado; não funciona como faixa de valores nem como valor aproximado.
Moeda
Tipo: campo de busca (lupa)
Obrigatoriedade: obrigatório
Descrição: moeda estrangeira da liquidação.
Comportamento: a lupa usada é a de “Moeda com Cotação”. Ao selecionar a moeda, o sistema preenche automaticamente o campo “Valor Cotação” com a última cotação registrada para aquela moeda na data de movimentação do usuário. A moeda escolhida fica gravada no perfil do usuário a cada liquidação concluída.
Impacto: além de restringir a pesquisa aos contratos daquela moeda, define a cotação usada para converter os valores liquidados em moeda nacional.
Valor Cotação
Tipo: número decimal (somente leitura)
Obrigatoriedade: obrigatório
Descrição: cotação da moeda que será usada na liquidação.
Comportamento: preenchido automaticamente pelo sistema assim que o usuário seleciona a Moeda, exibido com 4 casas decimais. O usuário não digita neste campo.
Impacto: é a cotação usada para converter o valor liquidado em moeda nacional e para calcular a variação cambial exibida no passo 2. Existem duas exceções em que o sistema ignora esta cotação e usa, em vez dela, a cotação gravada no próprio contrato: quando este campo vem zerado, e quando o modelo do contrato é TRV (ver seção 9, Regra 8).
Pesquisar
Tipo: texto
Obrigatoriedade: opcional
Descrição: campo de busca livre, aplicado sobre os contratos que já foram retornados pelo filtro principal.
Comportamento: o texto digitado é convertido para maiúsculas e as vírgulas são trocadas por pontos automaticamente. O sistema procura correspondência exata em Filial e Número do Contrato, e correspondência parcial em Nome da Filial, Tipo de Contrato, Modelo, código e nome do Participante, Valor Contrato, Valor Contrato Moeda e Cotação. Se o texto digitado corresponder a uma data, o sistema procura contratos cuja Data de Abertura ou Data de Vencimento seja igual a essa data.
Impacto: refina o resultado já trazido pela pesquisa, mas não substitui o filtro principal; o usuário continua precisando preencher pelo menos um filtro.
Campos do Passo 1 – Selecione os Contratos: Colunas da Grade de Contratos
Filial
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: filial responsável pelo contrato de câmbio.
Comportamento: exibida no formato de código e nome da filial.
Impacto: identifica a filial que receberá os lançamentos financeiros e contábeis gerados pela liquidação.
Contrato
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: número do contrato de câmbio.
Comportamento: valor definido no cadastro do contrato.
Impacto: identifica o contrato no comprovante e nos lançamentos gerados pela liquidação.
Data abertura
Tipo: data (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: data em que o contrato foi aberto.
Comportamento: exibida no formato dia/mês/ano.
Impacto: usada como critério na busca livre do campo “Pesquisar”.
Tipo de contrato
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: tipo de operação do contrato, Exportação ou Importação.
Comportamento: valor definido no cadastro do contrato.
Impacto: apenas informativo nesta rotina; também é usado como critério na busca livre do campo “Pesquisar”.
Modelo
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: modelo do contrato de câmbio.
Comportamento: valor definido no cadastro do contrato.
Impacto: determina todo o comportamento da liquidação, ou seja, se o contrato aceita liquidação parcial, se gera juros, qual é a contrapartida dos lançamentos e qual fato contábil é usado (ver seção 9).
Carteira origem/ Participante
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: carteira de origem do contrato ou, nos modelos de adiantamento de cliente, o participante do contrato.
Comportamento: exibida no formato de código e nome.
Impacto: é uma das pontas dos lançamentos de débito e crédito gerados pela liquidação.
Data vencimento
Tipo: data (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: data de vencimento do contrato.
Comportamento: exibida no formato dia/mês/ano.
Impacto: usada como filtro de pesquisa e como referência de controle do contrato.
Valor contrato moeda
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: valor total do contrato em moeda estrangeira.
Comportamento: valor definido no cadastro do contrato.
Impacto: é o teto do que pode ser liquidado ao longo de toda a vida do contrato. Quando o valor já liquidado atinge esse valor, o contrato passa para a situação “Liquidado”.
Saldo moeda
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é calculado pelo sistema
Descrição: quanto do contrato ainda pode ser liquidado, em moeda estrangeira.
Comportamento: calculado como Valor contrato moeda menos o valor já liquidado. Contratos com saldo zero ou negativo não aparecem nesta grade.
Impacto: é o limite máximo que o usuário pode informar na coluna “Valor a liquidar” do passo 2 (ver seção 9, Regra 5).
Cotação moeda
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: cotação que ficou gravada no contrato de câmbio no momento do cadastro dele.
Comportamento: exibida com 4 casas decimais.
Impacto: usada como base de comparação para calcular a variação cambial da liquidação e, no modelo TRV, é a cotação efetivamente usada na conversão do valor liquidado para moeda nacional.
Campos do Passo 2 – Liquidação das Contratos: Colunas da Grade de Liquidação
Modelo
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: modelo do contrato de câmbio selecionado para liquidação.
Comportamento: repetido a partir do contrato escolhido no passo 1.
Impacto: define as regras aplicadas a esta linha da grade, ou seja, se a liquidação parcial é permitida, se há cálculo de juros e qual a contrapartida dos lançamentos.
Contrato
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: número do contrato a liquidar.
Comportamento: repetido a partir do contrato escolhido no passo 1.
Impacto: identifica o contrato nas mensagens de erro e no comprovante final.
Carteira
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: carteira de origem do contrato.
Comportamento: repetida a partir do cadastro do contrato.
Impacto: é uma das pontas dos lançamentos de débito e crédito gerados pela liquidação.
Data de emissão
Tipo: data (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: data de abertura do contrato.
Comportamento: exibida no formato dia/mês/ano.
Impacto: apenas informativo, serve para o usuário conferir antes de liquidar.
Data de vencimento
Tipo: data (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: data de vencimento do contrato.
Comportamento: exibida no formato dia/mês/ano.
Impacto: apenas informativo, serve para o usuário conferir antes de liquidar.
Saldo Moeda
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é calculado pelo sistema
Descrição: saldo do contrato que ainda está disponível para liquidação, em moeda estrangeira.
Comportamento: calculado como Valor contrato moeda menos o valor já liquidado.
Impacto: é o teto do campo “Valor a liquidar” desta mesma linha da grade.
Valor a liquidar
Tipo: número decimal (editável)
Obrigatoriedade: obrigatório
Descrição: quanto o usuário quer liquidar deste contrato nesta operação, em moeda estrangeira.
Comportamento: o usuário digita o valor diretamente na grade. O sistema recusa a liquidação se o valor informado for maior que o “Saldo Moeda” daquela linha. Nos modelos NDF e NDFC, o valor precisa ser exatamente igual ao valor total do contrato.
Impacto: é somado ao valor já liquidado do contrato e convertido em moeda nacional pela cotação para gerar os lançamentos de débito e crédito. Quando o valor acumulado atinge o valor total do contrato, o contrato passa para a situação “Liquidado”.
Variação cambial
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é calculado pelo sistema
Descrição: diferença de valor que ocorre por causa da mudança de cotação entre o cadastro do contrato e a data da liquidação.
Comportamento: calculada pelo sistema a partir da cotação registrada no contrato e da cotação informada no cabeçalho da tela.
Impacto: gera lançamentos próprios de atualização monetária, executados automaticamente antes da liquidação em si (ver seção 9, Regra 3).
Tipo Variação
Tipo: texto (somente leitura)
Obrigatoriedade: não se aplica, é calculado pelo sistema
Descrição: indica se a variação cambial apurada representa ganho ou perda para a empresa.
Comportamento: definido automaticamente pelo sistema, conforme o sinal da variação calculada.
Impacto: determina a natureza do lançamento contábil gerado pela atualização monetária.
Cotação do contrato
Tipo: número decimal (somente leitura)
Obrigatoriedade: não se aplica, é uma informação já registrada no contrato
Descrição: cotação que foi registrada no contrato de câmbio no momento do cadastro.
Comportamento: exibida com 4 casas decimais.
Impacto: no modelo TRV, é a cotação efetivamente usada para converter o valor liquidado para moeda nacional, ignorando a cotação informada no cabeçalho da tela.
Juros
Tipo: número decimal
Obrigatoriedade: opcional
Descrição: valor de juros que será lançado junto com a liquidação deste contrato.
Comportamento: calculado automaticamente pelo sistema, mas apenas para os modelos ACC, ACE e TRV, com base na taxa de juros do contrato, no saldo do contrato e nos dias decorridos desde a data de crédito (ver seção 9, Regra 4). Nos demais modelos, este campo fica zerado.
Impacto: gera lançamentos financeiros e contábeis adicionais de juros, separados dos lançamentos da liquidação principal.
Utilização e Consulta de Registros da Liquidação de Contrato
Esta rotina não mantém um cadastro próprio de registros. Ela consulta os Contratos de Câmbio que já estão cadastrados na rotina “Contrato de Câmbio” e processa a liquidação deles.
A pesquisa acontece no passo “1 – Selecione os contratos” e exige que o usuário informe pelo menos um critério entre: Número contrato, Carteira (destino), Data vencimento, Modelo, Participante e Valor. O sistema não permite pesquisar sem nenhum filtro preenchido.
A grade só exibe contratos que atendam, ao mesmo tempo, a três condições: estar com situação “Aberto”; ter saldo a liquidar maior que zero (Valor contrato moeda menos o valor já liquidado); e ter saldo positivo depois do recálculo de atualização monetária feito pelo sistema. Contratos já liquidados, cancelados ou sem saldo simplesmente não aparecem na grade.
O campo “Pesquisar”, localizado acima da grade, aplica uma busca livre adicional sobre o resultado que já foi filtrado. Ele refina o resultado, mas não substitui o filtro principal.
Quando nenhum contrato atende aos critérios informados, o sistema exibe a mensagem “Nenhuma ocorrência encontrada.” no rodapé da grade.
Memorização de Preferências
O sistema lembra do último filtro usado por cada usuário nesta rotina: ao reabrir a tela, o combo “Filtro” e o campo correspondente já voltam preenchidos com o que foi usado da última vez. A moeda usada na última liquidação concluída também fica gravada no perfil do usuário.
Processo de Edição da Liquidação de Contrato
Edição Não Permitida
Esta rotina não permite edição. Ela não é um cadastro, e sim um processo: cada execução gera uma liquidação nova, com movimentações financeiras e lançamentos contábeis próprios.
Uma vez concluída a liquidação, não existe, dentro da rotina, nenhuma função para alterar ou desfazer o que foi processado. O sistema inclusive desabilita os botões “Concluir”, “Anterior” e “Fechar Aba” logo após a conclusão, justamente para impedir que o mesmo lote seja processado uma segunda vez.
Antes de concluir, porém, o usuário tem liberdade total sobre o lote: pode adicionar contratos de várias pesquisas diferentes, alterar o “Valor a liquidar” de cada linha e remover contratos da lista. Nada é gravado definitivamente até o clique em “Concluir”.
Para corrigir uma liquidação que já foi efetivada, é necessário recorrer às rotinas de estorno do módulo Financeiro. [informação não disponível na documentação de origem, validar com analista responsável: qual rotina específica realiza o estorno de uma liquidação de contrato de câmbio não foi identificada no escopo desta análise]
[informação não disponível na documentação de origem, validar com analista responsável: não foi localizada, no escopo desta análise, uma tela de histórico ou log das liquidações realizadas que seja acessível ao usuário final]
Estrutura Técnica e Comportamento do Sistema da Liquidação de Contrato
Ao concluir a liquidação, o sistema dispara automaticamente, sem nenhuma ação adicional do usuário e nesta ordem:
- Atualização monetária de todos os contratos do lote, usando a cotação informada e a data de lançamento. As movimentações geradas por essa atualização entram no mesmo conjunto de lançamentos da liquidação.
- Lançamento dos juros dos contratos dos modelos ACC, ACE e TRV, quando houver: um lançamento para liquidar os juros já acumulados do contrato e outro para lançar os juros parciais apurados nesta operação.
- Movimentações financeiras de débito e crédito para cada contrato liquidado, entre o participante do contrato e a contrapartida definida pelo modelo do contrato.
- Atualização do contrato, somando o valor liquidado ao Valor Liquidado Moeda e mudando a situação do contrato para “Liquidado” quando o valor total é atingido.
- Integração contábil, gerando os lançamentos contábeis correspondentes às movimentações financeiras que foram produzidas.
Transação Atomar
Toda essa cadeia de ações acontece dentro de uma única transação: se qualquer contrato do lote falhar, nenhum contrato é liquidado, inclusive os que já haviam sido processados com sucesso naquela mesma execução.
A rotina também grava, de forma automática e transparente para o usuário, duas preferências no cadastro dele: o filtro de pesquisa utilizado (a cada busca realizada) e a moeda da liquidação (a cada conclusão de liquidação). Essas gravações não ficam registradas na auditoria do sistema. A gravação do filtro acontece antes mesmo da consulta ser executada, independentemente de a pesquisa retornar resultados ou não.
Relacionamentos com Outras Rotinas
Esta rotina se relaciona diretamente com:
- Contrato de Câmbio: cadastra os contratos que esta rotina liquida.
- Vinculação e Desvinculação de fatura: controlam o outro saldo do mesmo contrato (o saldo a vincular a faturas).
- Liquidação de fatura e Liquidação de Fatura Sem Contrato: rotinas irmãs, que liquidam faturas em vez de liquidar o contrato diretamente.
- Atualização Monetária de Contratos de Câmbio: executada automaticamente como primeiro passo desta liquidação.
Regras de Negócio e Restrições da Liquidação de Contrato
É obrigatório informar pelo menos um filtro na pesquisa
O sistema recusa a consulta de contratos se nenhum destes campos for informado: Número contrato, Carteira, Data vencimento, Modelo, Participante, Valor ou carteira de origem.
Mensagem exibida: “Deve ser informado um campo de filtro para realizar a consulta”
Só aparecem contratos abertos e com saldo a liquidar
A grade do passo “1 – Selecione os contratos” exibe apenas contratos que atendam, ao mesmo tempo, a: situação “Aberto”; Valor contrato moeda menos valor já liquidado maior que zero; e saldo positivo depois do recálculo de atualização monetária. Contratos liquidados, cancelados ou sem saldo não aparecem, mesmo que atendam ao filtro informado pelo usuário.
A atualização monetária é executada antes da liquidação
Ao concluir a operação, e antes de gerar qualquer lançamento de liquidação, o sistema executa a atualização monetária de todos os contratos do lote, usando a cotação informada. As movimentações resultantes dessa atualização fazem parte da mesma operação e entram na mesma integração contábil.
Cálculo automático dos juros
Aplica-se apenas aos modelos ACC, ACE e TRV. O sistema toma como base de dias o dia do mês da data de movimentação do usuário; se a Data de Crédito do contrato estiver no mesmo mês e ano dessa data, o sistema subtrai dessa base o dia da Data de Crédito menos 1, contando assim apenas os dias decorridos desde o crédito. Sobre essa base de dias, o sistema aplica a taxa de juros do contrato dividida por 360 e por 100, e multiplica o resultado pelo saldo do contrato. Se a taxa de juros do contrato for zero, o valor de juros calculado também é zero. Nos demais modelos, o sistema não calcula juros.
O valor a liquidar não pode ultrapassar o saldo do contrato
Para cada contrato do lote, o sistema calcula o saldo como Valor contrato moeda menos o valor já liquidado. Se o valor informado na coluna “Valor a liquidar” for maior que esse saldo, a operação inteira é bloqueada.
Mensagem exibida: “Valor de liquidação inválido – Saldo do contrato (Valor moeda – Valor liquidado) : [saldo] – Valor da liquidação : [valor informado]” / “Não é possível liquidar um valor acima do saldo do contrato.” / “Informe um valor menor ou igual ao saldo do contrato”
Contratos NDF e NDFC não aceitam liquidação parcial
Nesses dois modelos, o valor a liquidar precisa ser exatamente igual ao valor total do contrato em moeda estrangeira.
Mensagem exibida: “Valor inválido para liquidar o contrato [número do contrato]” / “Contrato NDF não permite liquidação parcial.” / “Informe valor total e tente novamente”
A contrapartida dos lançamentos depende do modelo do contrato
Nos modelos ACC, ACE e TRV, a contrapartida dos lançamentos gerados é a carteira ativa do usuário no momento da liquidação. Nos demais modelos, a contrapartida é a Carteira Destino cadastrada no próprio contrato; se o contrato não tiver Carteira Destino cadastrada, o sistema usa o cadastro do sistema como contrapartida.
Qual cotação o sistema usa na conversão do valor liquidado
O valor liquidado em moeda nacional é sempre o “Valor a liquidar” multiplicado pela cotação. O sistema usa, como regra geral, a cotação informada no cabeçalho da tela, com duas exceções em que usa, em vez dela, a cotação gravada no próprio contrato: quando a cotação do cabeçalho vem zerada, e quando o modelo do contrato é TRV.
O contrato muda sozinho para a situação “Liquidado”
A cada liquidação realizada, o sistema soma o valor liquidado ao Valor Liquidado Moeda do contrato. Quando esse valor acumulado se iguala ao Valor contrato moeda, o sistema muda automaticamente a situação do contrato para “Liquidado”. A partir desse momento, o contrato não aparece mais nas pesquisas desta rotina de liquidação, e também não pode mais ser editado nem excluído na rotina “Contrato de Câmbio”.
Os lançamentos gerados variam conforme o modelo do contrato
Todos os modelos geram um par de lançamentos (débito e crédito) para cada contrato liquidado, mas a forma varia:
- NDF e NDFC: o par de lançamentos é gerado com valor zero em ambas as pontas, usando o cadastro do sistema como origem e como contrapartida. Os valores desses contratos são tratados pela atualização monetária, e não pela liquidação em si.
- TRV: débito lançado no participante do contrato e crédito lançado na contrapartida.
- Demais modelos: débito lançado na contrapartida e crédito lançado no participante do contrato, ou seja, sentido inverso ao do modelo TRV.
O Fato Contábil precisa estar configurado e ativo
Antes de gerar os lançamentos, o sistema busca o Fato Contábil cadastrado para a operação de “liquidação de contrato de câmbio”, combinada com a variação do modelo em questão. Se esse fato contábil não existir, estiver inativo ou não tiver lançamentos configurados, a operação é bloqueada.
Mensagem exibida: “Não foi possível obter fato contábil do financeiro” / “Fato contábil para operação [descrição da operação] e variação [descrição da variação] não configurado.” / “Configure fato contábil e variação e tente novamente”
Nem todos os modelos de contrato podem ser liquidados por esta rotina
Apenas os modelos NDF, NDFC, OPC, PPE, Pronto, ACC, ACE e TRV estão implementados para liquidação nesta rotina. Os modelos “Antecipado (Banco)” e “Antecipado (ADX)” não são aceitos aqui.
Mensagem exibida: “Não foi possível obter fato contábil por modelo” / “Modelo [descrição do modelo] não implementado para liquidação” / “Verifique operação e implemente modelo para liquidação”
A integração contábil é parcial quando há contratos NDF no lote
Se o lote não tiver nenhum contrato NDF ou NDFC, o sistema envia todas as movimentações geradas para a integração contábil. Se houver pelo menos um contrato NDF ou NDFC no lote, o sistema envia apenas as movimentações originadas da variação cambial; as demais movimentações não são integradas naquela execução.
A liquidação sem contratos selecionados é recusada
Se o usuário tentar clicar em “Concluir” sem ter nenhum contrato no lote, o sistema não executa nenhuma ação.
Mensagem exibida: [informação não disponível na documentação de origem, validar com analista responsável: a recusa dispara uma mensagem interna indicando que os dados informados podem estar incorretos, mas o texto literal dessa mensagem não estava disponível na análise realizada]
Tudo ou nada, o lote é processado em uma única transação
A atualização monetária, o cálculo de juros, os lançamentos de todos os contratos e a integração contábil ocorrem dentro de uma única transação. Qualquer falha em qualquer contrato do lote desfaz toda a operação, inclusive a liquidação dos contratos que já haviam sido processados com sucesso naquela mesma execução. O usuário recebe a mensagem original referente à falha ocorrida.
A emissão do comprovante preserva o layout personalizado do cliente
Ao emitir o comprovante, o sistema verifica se já existe um arquivo de layout salvo na pasta do cliente. Se não existir, o sistema copia o modelo padrão para lá. Se já existir, o sistema mantém o arquivo atual, ou seja, personalizações feitas no layout do comprovante não são sobrescritas pelo sistema.
