• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • ERP
    • Cadastro Geral (ERP)
      • Aprovação
        • Comercial
        • Contabilidade
        • Financeira
      • Cadastro geral
      • Consultas
        • Cadastro via SEFAZ
      • Manutenção de Cadastro Geral
      • Órgão Público
        • Item
        • Órgão Público
      • Propriedade rural
      • Relatórios
        • WRCAD009 - Relatório de cadastro geral
        • WRCAD080 - Relatório de endereços
        • WRCAD081 - Relatório de referências
        • WRCAD082 - Relatório de contatos
        • WRCAD083 - Relatório de parâmetros logísticos
        • WRCAD084 - Relatório de crédito de pessoa física
        • WRCAD085 - Relatório de propriedades rurais
        • WRCAD088 - Relatório de parâmetros financeiros
        • WRCAD089 - Relatório de clientes
    • Contabilidade
      • Cadastros
        • Centro de Custo
        • Divisão Contábil
        • Histórico Padrão
        • Lançamento Contábil Padrão
        • Livros Contábeis/Fiscais
        • Notas Explicativas
        • Perfil Contábil Item
        • Plano de Conta x Centro de Custo/Controle
        • Plano de Contas
      • Conciliação
        • Razão Auxiliar - Financeiro x Contábil
      • Consultas
        • Consulta Balancete
        • Consultas DRE
        • Validação do TMV
      • Custeio
        • Apuração Custeio
        • Centro de Custo
      • Demonstrativos
        • Lista de Modelos
      • Geração Arquivos
        • Lançamentos Contábeis
        • Razão Auxiliar – Implantação de Saldo
      • Lalur-Presumido
        • Apuração do IRPJ e da CSLL
      • Movimentações
        • Contábil Extemporâneo
        • Exercício Social
        • Integridade de Saldos Contábeis
        • Lote Contábil
        • Movimentação Contábil - Contabilidade
          • Exclusão de Lançamento - Movimentação Contábil
        • Razão Auxiliar
        • Validar Plano de Contas
      • Orçamento
        • Entidades
        • Entidades/Gestores
        • Geração de Orçamento
        • Indicadores
        • Manutenção de Orçamentos
        • Pacotes
        • Pacotes/Gestores
      • Rateio
        • Critério Rateio
        • Geração Rateio off-line
        • Lista de Modelos Rateio off-line
      • Relatórios
        • Exportação para Excel
        • WRCTD001 - Razão Contábil
        • WRCTD002 - Diário Contábil
        • WRCTD003 – Balanço Patrimonial
        • WRCTD004 - Balancete de Verificação
        • WRCTD005 – Demonstração de Resultado do Exercício
        • WRCTD007 - Conferência Lote Contábil
        • WRCTD008 - Conferência Lote Contábil (Sintético)
        • WRCTD010
        • WRCTD011 - Demonstração de Resultado do Exercício (Trimestral)
        • WRCTD023 – Orçamento Contábil por Pacote de Gastos (Modelo A)
      • Sped Contábil (ECD)
        • Bloco I
          • I053 - Subcontas Correlatas
          • I157 - Transferência de Saldos de Plano de Contas Anterior
        • Bloco K
          • K100 - Empresas Consolidadas
          • K200 - Plano de Contas Consolidadas
          • K300 - Saldos das Contas Consolidadas
        • Geração de Arquivo SPED Contábil
      • Sped Fiscal (ECF)
        • Bloco M
          • M312 - Números dos Lançamentos Relacionados à Conta Contábil IRPJ
          • M315 - Processo do Lalur
          • M362 - Números dos Lançamentos Relacionados à Conta Contábil CSLL
          • M365 - Processo do Lacs
          • M415 - Processo da Parte B
        • Bloco V
          • V010 - DEREX - Instituição
          • V020 - DEREX - Responsável Movimentação
          • V100 - DEREX - Demonstrativo dos recursos em moeda estrangeira
        • Bloco X
          • X280 - Atividade Incentivada
          • X291 - Pessoa Vinculada
          • X292 - Pessoa Não Vinculada
          • X300/X305/X310 - Exportações
          • X320/X325/X330 - Importações
          • X340/X350-X357 - Part. Exterior
          • X400/X410 - Comércio Eletrônico e Tecnologia da Informação
          • X420 - Royalties Rec./Pag. a Beneficiários do Brasil e do Exterior
          • X430 - Rendimentos relativos a Serviços, Juros e Dividendos
          • X450 - Pagamentos/Remessas Relativos a Serviços, Juros e Dividendos Recebidos do Brasil e do Exterior
          • X460 - Inovação Tecnológica e Desenvolvimento Tecnológico
          • X470 - Capacitação de Informática e Inclusão Digital
          • X480/X485 - Benefícios Fiscais - Parte I/Parte II
          • X490 - Pólo Industrial de Manaus e Amazônia Ocidental
          • X500 - Zonas de Processamento de Exportação (ZPE)
          • X510 - Áreas de Livre Comércio
        • Bloco Y
          • Y570 - IR/CSLL Retidos na Fonte
          • Y580 - Doações a Camp. Eleitorais
          • Y590 - Ativos no Exterior
          • Y600 - Ident. Sócios ou Titular
          • Y611 - Rendimentos
          • Y620 - Coligadas/Controladas
          • Y630 - Fundos/Clubes de Investimentos
          • Y640/Y650 - Part. Consórcio de Empresa
          • Y660 - Dados de Sucessora
          • Y665 - Diferenças na Adoção Inicial
          • Y671 - Outra Informação (LR)
          • Y672 - Outra Informação (LP/LA)
          • Y680/Y681 - Refis de Lucros
          • Y690 - Paes
        • Contas e Saldos Iniciais da Parte B
        • Controle de Saldos das Contas do E-lalur e do E-lacs (ParteB)
        • ECF Apuração
    • Controle Patrimonial
      • Cadastros
        • Bem — Cadastro de Bens do Controle Patrimonial
        • Local do Bem — Controle Patrimonial
        • Motivo de Ocorrência
        • Ocorrência do Bem — Controle Patrimonial
        • Ocorrências em Lote — Controle Patrimonial
        • Perfil Contábil do Patrimônio — Controle Patrimonial
      • Fechamentos
        • Depreciação (Simulador) - Controle Patrimonial
        • Fechamento de CIAP
        • Fechamento de CPCAP (Pis/Cofins) — Controle Patrimonial
        • Fechamento do Controle Patrimonial
      • Manuais, Procedimentos, Orientações e Boas Práticas
        • Implantação do Controle Patrimonial
        • Roteiro de Boas Práticas - Orientação de uso rotineiro do módulo Controle Patrimonial do ERP Atak
      • Relatórios
        • WRCPM050 — Relatório de Inventário de Bens (Analítico)
        • WRCPM051
        • WRCPM052 — Extrato de Ocorrência do Bem
        • WRCPM053 — Demonstrativo de Saldo de Bens por Grupo Contábil (Analítico)
        • WRCPM054 — Relação de Ocorrências com Bens por Período
        • WRCPM055
        • WRCPM056 — Ocorrências com Bens por Período (Sintético)
        • WRCPM057 — Extrato do Bem: Recuperação de Tributos
        • WRCPM058 — Resumo Mensal: Recuperação de Tributos
        • WRCPM059 — Lista de Bens a Serem Alocados
        • WRCPM060 — Conferência das Contabilizações das Ocorrências
        • WRCPM061 — Demonstrativo de Tributos a Recuperar
        • WRCPM062 — Relatório de Bens por Centro de Custo/Controle e Conta Contábil
    • Curtume
      • Cadastro de Classificações de Couro
      • Ordem de Produção Classificação de Couros
    • DF-e
      • NFS-e
        • Importação de NFS-e
        • Monitoramento de NFS-e
        • Transmissão de NFS-e
    • Escrita Fiscal
      • Apuração por UF
        • Conferência da Sistemática
        • ICMS Sistemática (PE)
        • Livro SEFAZ
        • Ocorrências do ICMS Antecipado (PE)
      • Apurações
        • Fechamento Apuração de IPI
        • Fechamento Apuração ICMS Difal
        • Fechamento Apuração ICMS-ST - Escrita Fiscal
        • Fechamento Apuração ISS
        • Fechamento Apuração PIS/COFINS - Escrita Fiscal
        • Fechamento Apuração Tributo (Genérico)
        • Período Apuração Tributos - Escrita Fiscal
      • Cadastros
        • 5.3 - Tabela de Ajustes e Informações de Valores Provenientes de Documento Fiscal
        • Classificação Tributária de Crédito Presumido IBS/CBS
        • Classificação Tributária IBS/CBS
        • Classificação Tributária IS
        • Código de Serviço NBS
        • Código Serviço Tributação Nacional do ISSQN
        • INSS - Escrita Fiscal
        • Modelo Guia de Tributos
        • Pauta de Tributo
        • Pauta Produto — Escrita Fiscal
        • Situação Tributária
          • Situação Tributária COFINS — Escrita Fiscal
          • Situação Tributária IBS/CBS — Escrita Fiscal
          • Situação Tributária ICMS — Escrita Fiscal
          • Situação Tributária IPI — Escrita Fiscal
          • Situação Tributária IS — Escrita Fiscal
          • Situação Tributária PIS - Escrita Fiscal
        • Tabela de Códigos de Ajuste da Apuração do IPI
        • Tabela de Códigos de Ajustes da Apuração do ICMS / Tabela de Informações Adicionais da Apuração - Valores Declaratórios
        • Tabela de Informações Adicionais dos Itens do Documento Fiscal
        • Tabela de Tipos de Utilização dos Créditos Fiscais de ICMS
        • Tabelas Códigos Receitas (Federal)
      • Escrita X Contabilidade
        • Consulta de Documentos Eletrônicos - CT-e
        • Consulta de Documentos Eletrônicos - NF-e
        • Consulta de Lançamentos Fiscais
        • Contabilização de Lançamentos Fiscais
        • Contabilização de Tributos Fiscais
        • Importar Notas do XML - Escrita Fiscal
      • Eventos
        • ECONF - Conciliação Financeira - Escrita Fiscal
        • Registro de Eventos — Escrita Fiscal
      • Módulo De Inclusão De Tributos
        • Declaração do MIT
      • Movimentações
        • Inventário de Estoque Fiscal
        • Livro de Registro de Exportação
        • Livro Registro de Importação — Escrita Fiscal
        • Manutenção de Geração de Tributos nos Documentos — Escrita Fiscal
        • Movimentação de Apuração de Tributo — Escrita Fiscal
      • Tabelas/Modelos
        • Exportação para Excel - Escrita Fiscal
        • Modelo de Ajuste de Apuração
      • Tributos
        • Alíquota Referência - Município
        • Alíquota Referência - País
        • Alíquota Referência - UF
        • Assistente de Parametrização IBS/CBS/IS
        • Configurador IBS/CBS/IS
        • Tributação por Item
        • Tributação por TMV — Escrita Fiscal
    • Faturamento
      • Dashboard de Documentos Eletrônicos
      • Geração de Documento Destino
      • Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem
      • Rotina de Transferência de Participante
    • Financeiro
      • Cadastro
        • Moeda
      • Caixa
        • Depósito Não Identificado
        • Despesas
        • Devolução de Cheque a Receber Segunda Vez
        • Devolução de Cheque Próprio pela Primeira Vez
        • Reapresentação de Cheque de Terceiro
        • Reapresentação de Cheque Próprio
        • Receitas
      • Cobranca
        • Alteração da Forma de Cobrança
        • Alteração de Carteira
        • Alteração de Comissão
        • Alteração de Vencimento
        • Baixa de Título da Cobrança
        • Baixa de Título da Cobrança Descontada
        • CobrancaAlteracaoDeFormaDeCobranca
        • Consulta de Remessa
        • Consulta de Títulos
        • Consulta e Liquidação via API (PIX e Boleto)
        • Consulta e Liquidação via API (PIX)
        • Desconto de Duplicatas
        • Inclusão de Decréscimo
        • Inclusão de Desconto na Cobrança
        • Inclusão de Juros
        • Inclusão de Multa
        • Liquidação Manual
        • Remessa (arquivo)
        • Retorno (arquivo)
      • Comex
        • Contrato de Câmbio
          • Contrato de Câmbio
        • Desvinculação de Contrato x Fatura
        • Desvinculação De Fatura
          • Desvinculação de fatura
        • Juros Do Contrato
          • Juros do contrato
        • Juros para Contrato de Câmbio
        • Liquidação de Contrato
          • Liquidação de contrato
        • Liquidação de Fatura
          • Liquidação de fatura
        • Liquidação De Fatura Sem Contrato
          • Liquidação de Fatura Sem Contrato
        • Relatórios
          • Wrexp021 - Faturas Vinculadas X Contrato De Câmbio
            • WREXP021 - Faturas Vinculadas X Contrato De Câmbio
        • Vinculação de Contrato x Fatura
        • Vinculação De Fatura
          • Vinculação de fatura
      • Comex - Relatórios
        • Wrexp011 - Posição Financeira Exportação
          • WREXP011 - Posição Financeira Exportação
        • Wrexp012 - Posição Contrato Câmbio X Faturas Não Vinculadas Por Carteira
          • WREXP012 - Posição Contrato Câmbio x Faturas Não Vinculadas por Carteira
        • Wrexp013 - Contratos De Cambio X Faturas Vinculadas
          • WREXP013 - Contratos de Cambio X Faturas Vinculadas
      • Compensações
        • Pagar X Adto. A Fornecedor
          • Pagar x adto. a fornecedor
        • Pagar X Devolução A Fornecedor
          • Pagar x devolução a fornecedor
        • Receber X Adto. De Cliente
          • Receber x adto. de cliente
        • Receber X Devolução Cliente
          • Receber x devolução cliente
        • Receber X Pagar
          • Receber x pagar
      • Fechamentos
        • Banco
          • Banco
        • Financeiro
          • Financeiro
      • Pagamento
        • Inclusão de Desconto no Pagamento
      • Relatorios
        • Movimentação Financeira por Carteira - Conciliado
        • Relatório de Negativação SERASA
        • WRBNC001 - Fluxo de Caixa Analítico
        • WRBNC002 - Fluxo de Caixa Sintético
        • WRBNC003 - Fluxo de Caixa Analítico por Conta de Resultado
        • WRBNC004 - Fluxo de Caixa Sintético por Conta de Resultado
        • WRBNC005 - Fechamento Diário
        • WRBNC006 - Movimentação Financeira por Carteira
        • WRBNC007 - Movimentação Financeira por Carteira (sintética)
        • WRBNC008 - Fechamento Diário Detalhado
        • WRBNC010 - Fluxo de Caixa
        • WRBNC011 - Movimentação Financeira por Carteira e Conta Contábil
        • WRBNC090 - Conferência Diária Vendas Cupom Loja
      • Renegociações
        • Com Clientes
          • Com clientes
        • Com Fornecedores
          • Com fornecedores
      • Serviços
        • 2ª Via Boleto Cliente
          • 2ª via boleto cliente
        • 2ª Via Comprovante Lançamento
          • 2ª via comprovante lançamento
        • Envio De Negativação
          • Envio de Negativação
        • Geração Pix
          • Geração PIX
        • Manutenção De Remessa
          • Manutenção de Remessa
        • Retorno De Negativação
          • Retorno de Negativação
      • Serviços / Orgão Público
        • Empenho
          • Empenho
      • Transferencias
        • Adiantamento de Cliente
        • Adiantamento de Fornecedor
        • Transferência Entre Contas
        • Transferência Entre Múltiplas Contas
    • Obrigações Acessórias Federais
    • Suprimentos
      • Cadastros
        • Compradores Família Produtos
        • Fornecedores Família Produtos
      • Compra
        • Aprovação de Orçamentos (Cotações)
        • Aprovação de Pedidos de Compra
        • Aprovação de solicitação
        • Cotações de compra
        • Gerar cotações
        • Orçamentos de Fornecedores
        • Pedido de Compra sem Cotação
        • Pré-aprovação de orçamentos
        • Solicitação de Compras
      • Consumo
        • Devolução de consumo
        • Requisição de consumo
        • Solicitação de Materiais
      • Recebimento
        • Registro de entregas
      • Relatórios
        • WRSUP001 - Lista de compradores
        • WRSUP002 - Lista de fornecedores
        • WRSUP003 - Sugestão de compra
        • WRSUP004 - Solicitação de compra
        • WRSUP005 - Cotação
        • WRSUP006 - Orçamento
        • WRSUP007 - Análise de orçamentos
        • WRSUP008 - Entregas em atraso
        • WRSUP009 - Previsão de entrega
        • WRSUP010 - Conferência de carga x lançamentos de notas de entrada
        • WRSUP011 - Acompanhamento de compra
        • WRSUP012 - Solicitação de material
        • WRSUP013 - Gastos por centro de custo/controle
        • WRSUP014 - Gastos por conta contábil
        • WRSUP015 - Gastos por centro de custo/controle conta contábil
        • WRSUP016 - Ficha de histórico de produto
        • WRSUP017 - Histórico de fornecedor
        • WRSUP018 - Sugestão de Compras
    • Tabelas Auxiliares
      • Cadastros Gerais
        • Mensagem
Nenhum resultado encontrado
Inteligência Atak / Documentação / ERP / Financeiro / Comex

Liquidação de Contrato

Criado por Igor Ribeiro em 03 de setembro de 2026
•
Atualizado por Igor Ribeiro em 08 de outubro de 2026
Documentação Técnica

LiquidacaoContrato

Rotina do módulo Financeiro responsável pela liquidação de contratos de câmbio: permite consultar contratos de câmbio em aberto, selecionar um ou mais contratos e/ou títulos para vincular, calcular os juros proporcionais quando aplicável ao modelo do contrato, gravar a liquidação e gerar os lançamentos contábeis e financeiros correspondentes.

01. VISÃO GERAL

Visão Geral

Rotina do módulo Financeiro responsável pela liquidação de contratos de câmbio: permite consultar contratos de câmbio em aberto, selecionar um ou mais contratos e/ou títulos para vincular, calcular os juros proporcionais quando aplicável ao modelo do contrato, gravar a liquidação e gerar os lançamentos contábeis e financeiros correspondentes.

02. ENDPOINTS

Endpoints

GET /LiquidacaoContrato/ListarContratos

Lista os contratos de câmbio em aberto (status “A”) disponíveis para liquidação, calculando o saldo pendente de cada um e, quando aplicável ao modelo do contrato, o valor de juros proporcional até a data de movimentação informada. Aceita um texto livre de consulta (valorDeConsulta) que é comparado tanto como data quanto como texto contra os campos do contrato.

Permissão: coberta pela permissão de acesso à rotina “EditViewDeLiquidacaoDeContratoBuscaContratos” (ID 3107)

Parâmetros:

NomeTipoObrigatórioDescrição
valorDeConsultastringNãoTexto livre de busca; comparado como data ou como texto contra os campos do contrato
dataMovimentacaoDateTimeSimData de referência usada no cálculo dos dias de juros
(demais filtros de tela)—NãoFiltros adicionais de carteira/moeda conforme configuração da tela
Exemplo de request:

“` GET /LiquidacaoContrato/ListarContratos?valorDeConsulta=ACC001&dataMovimentacao=2026-09-01 “`

Exemplo de response:

“`json { “Dados”: [ { “ID”: “123456789”, “Codigo”: “ACC001”, “Modelo”: “ACC”, “Saldo”: 15000.00, “ValorParaLancamentoDeJuros”: 45.20 } ] } “`

POST /LiquidacaoContrato/Salvar

Efetiva a liquidação dos contratos de câmbio (e, quando informados, dos títulos) selecionados pelo usuário: valida os dados enviados, calcula/confirma o valor de liquidação e os juros, gera os lançamentos contábeis específicos do modelo do contrato (ACC, ACE, TRV, NDF, NDFC, OPC, PPE, Pronto), atualiza o status do contrato para “Liquidado” e grava a movimentação financeira. Toda a operação ocorre dentro de uma transação (BeginTran/Commit/FinalizeTran); qualquer falha reverte todas as alterações.

Permissão: “LiquidacaoContrato/Salvar” (ID 3108)

Parâmetros:

NomeTipoObrigatórioDescrição
IDDaMoedashortSimMoeda da operação
IDDaCarteiraSelecionadaintSimCarteira usada para a liquidação
ValorCotacaodecimalSimCotação usada no cálculo
DataDeLancamentoDateTimeSimData do lançamento contábil/financeiro
TitulosAProcessarList[DTODeTituloAProcessar]NãoTítulos vinculados à liquidação
ContratosCambioAProcessarList[DTODeContratoCambio]SimContratos de câmbio selecionados para liquidação
LiquidacaoSemContratoboolNãoIndica liquidação sem vínculo a contrato
Exemplo de request:

“` POST /LiquidacaoContrato/Salvar { “IDDaMoeda”: 2, “IDDaCarteiraSelecionada”: 10, “ValorCotacao”: 5.32, “DataDeLancamento”: “2026-09-09”, “ContratosCambioAProcessar”: [{ “ID”: “123456789”, “IDDoModelo”: “ACC” }], “LiquidacaoSemContrato”: false } “`

Exemplo de response:

“`json { “Sucesso”: true } “`

GET /LiquidacaoContrato/ObterFiltrosDoXmlDeConfiguracaoDeContrato

Retorna os filtros de configuração (definidos em XML) usados para montar as opções de busca/consulta de contratos na tela de liquidação.

Permissão: coberta pela permissão de acesso à rotina “EditViewDeLiquidacaoDeContratoBuscaContratos” (ID 3107)

Parâmetros:

NomeTipoObrigatórioDescrição
(sem parâmetros de entrada específicos)———
Exemplo de request:

“` GET /LiquidacaoContrato/ObterFiltrosDoXmlDeConfiguracaoDeContrato “`

Exemplo de response:

“`json { “Filtros”: [] } “`

GET /LiquidacaoContrato/Imprimir

Gera a impressão/relatório da liquidação de contrato realizada.

Permissão: coberta pela permissão de acesso à rotina “EditViewDeLiquidacaoDeContratoBuscaContratos” (ID 3107) — [informação não disponível na análise de código — validar com analista/vídeo do sistema se existe permissão granular própria para esta ação]

Parâmetros:

NomeTipoObrigatórioDescrição
(parâmetros de identificação da liquidação a imprimir)—Sim[informação não disponível na análise de código — validar com analista]
Exemplo de request:

“` GET /LiquidacaoContrato/Imprimir?id=123456789 “`

Exemplo de response:

“` [arquivo/relatório binário ou HTML de impressão] “`

03. MODELOS DE DADOS

Modelos de Dados

DTODeCabecalhoLiquidacaoFatura (corpo enviado por Salvar)

CampoTipoDescrição
IDDaMoedashortMoeda da operação
IDDaCarteiraSelecionadaintCarteira selecionada
ValorCotacaodecimalCotação usada no cálculo
DataDeLancamentoDateTimeData do lançamento
TitulosAProcessarList[DTODeTituloAProcessar]Títulos vinculados
ContratosCambioAProcessarList[DTODeContratoCambio]Contratos selecionados
LiquidacaoSemContratoboolIndica liquidação sem contrato vinculado

DTODeContratoCambio (principais campos usados na liquidação)

CampoTipoDescrição
IDstringChave de fato do contrato
IDDoTipostringTipo do contrato
IDDoModelostringModelo do contrato (ACC, ACE, TRV, NDF, NDFC, OPC, PPE, Pronto)
CodigostringCódigo do contrato de câmbio
DataAberturaDateTime?Data de abertura
DataVencimentoDateTime?Data de vencimento
DataEntregaDocsDateTime?Data de entrega de documentos
Valordecimal?Valor do contrato
ValorMoedadecimal?Valor do contrato em moeda estrangeira
Jurosdecimal?Percentual de juros do contrato
ValorCotacaodecimal?Valor da cotação
IDDoStatusstringStatus do contrato (ex: “A” = Aberto)
ObservacaostringObservação
IDDaMoedashort?Moeda
ValorVinculadoMoedadecimal?Valor já vinculado em moeda
PrazoVencimentoint?Prazo de vencimento em dias
DataCreditoDateTime?Data de crédito
ValorLiquidadoMoedadecimal?Valor já liquidado em moeda
ValorParaLancamentoDeJurosdecimalValor de juros calculado para o lançamento
SaldoAVinculardecimal?Saldo ainda a vincular
SaldoALiquidardecimal?Saldo ainda a liquidar
04. REGRAS DE NEGÓCIO

Regras de Negócio

  1. Contratos elegíveis para liquidação: apenas contratos com Status = “A” (Aberto) e saldo pendente maior que zero são retornados pela consulta de listagem. O saldo é calculado como Valor em moeda menos o Valor liquidado em moeda (ou o Valor vinculado em moeda, dependendo do modo de consulta configurado).
  2. Busca livre por texto ou data: o parâmetro valorDeConsulta é comparado tanto como data quanto como texto contra os campos do contrato, permitindo que o usuário digite tanto um código/observação quanto uma data para localizar o contrato desejado.
  3. Cálculo de juros proporcional (aplica-se apenas a modelos com juros aplicável, ex: ACC/ACE/TRV): os dias de juros são obtidos a partir do dia da data de movimentação (qtdeDias = dataMovimentacao.Day), ajustado quando a Data de Crédito do contrato cai no mesmo mês/ano da data de movimentação. A fórmula aplicada é: taxaDivisao = arredondar(TaxaDeJuros / 360, 9); taxaMultiplicada = arredondar(arredondar(taxaDivisao * qtdeDias, 9) / 100, 9); ValorParaLancamentoDeJuros = arredondar(taxaMultiplicada * Saldo, 2) quando TaxaDeJuros for diferente de zero; caso contrário, o valor de juros é zero.
  4. Transação atômica na gravação: toda a operação de liquidação (Salvar) ocorre dentro de uma transação (BeginTran/Commit/FinalizeTran). Se qualquer validação ou gravação falhar, todas as alterações da operação são revertidas — nenhum contrato fica parcialmente liquidado.
  5. Valor de liquidação inválido: se o valor informado para liquidação for inválido (ex: zero, negativo ou incompatível com o saldo do contrato), a operação é bloqueada.
    Mensagem exibida: “Valor de liquidação inválido” (mensagem associada ao método VALOR_DE_LIQUIDACAO_INVALIDO_SVOWR em Portugues.cs — [informação não disponível na análise de código — o texto completo de Erro/Motivo/Solução deste método específico deve ser validado com o analista, pois não foi possível confirmar a íntegra dos três campos durante a análise]).
  6. Cálculo do saldo do contrato: o saldo utilizado tanto na listagem quanto no cálculo de juros é ValorMoeda menos ValorLiquidadoMoeda (ou ValorVinculadoMoeda, conforme o modo de consulta), refletindo o quanto ainda resta a liquidar/vincular naquele contrato.
  7. Valor inválido para liquidar o contrato: se o valor informado para liquidar um contrato específico não for compatível com as regras de validação da tela, a gravação é bloqueada.
    Mensagem exibida: mensagem associada ao método VALOR_INVALIDO_PARA_LIQUIDAR_O_CONTRATO__VKGXC em Portugues.cs — [informação não disponível na análise de código — texto literal completo deve ser validado com o analista].
  8. Falha genérica ao salvar: se os dados enviados estiverem incorretos ou incompletos e não se enquadrarem em nenhuma validação específica anterior, a gravação é bloqueada com uma mensagem genérica.
    Mensagem exibida: Erro: “Não foi possível Salvar” / Motivo: “Os dados informados podem estar incorretos” / Solução: “Verifique se os dados informados estão corretos.” (mensagem associada ao método NAO_POSSIVEL_SALVAR_DADOS_INFORMADOS_PODEM_ESTAR_INCORRETOS em Portugues.cs).
  9. Lançamento contábil específico por modelo de contrato: o fato contábil gerado na liquidação depende do modelo do contrato: NDF e NDFC utilizam a rotina de gravação de NDF (com filtro específico para operações “BCOVC”); OPC, PPE e Pronto possuem suas próprias rotinas de geração de fato contábil; ACC/ACE/TRV seguem a rotina padrão de contrato de câmbio.
  10. Filtro “BCOVC” para NDF/NDFC: ao gerar o fato contábil de contratos do modelo NDF ou NDFC, a rotina aplica um filtro específico para identificar operações do tipo “BCOVC” antes de compor o lançamento contábil.
  11. Atualização de status após liquidação: ao concluir a liquidação com sucesso, o status do contrato de câmbio é atualizado para “Liquidado”.
  12. Movimentação financeira vinculada: além do lançamento contábil, a liquidação gera o registro de movimentação financeira correspondente, refletindo a baixa do valor liquidado.
  13. Integração contábil obrigatória: a liquidação não é considerada concluída sem a geração do fato contábil correspondente ao modelo do contrato — a ausência dessa integração indica falha na operação e a transação é revertida.
  14. Liquidação sem contrato vinculado: quando a flag LiquidacaoSemContrato é usada, a liquidação é processada a partir dos títulos informados (TitulosAProcessar) sem exigir um contrato de câmbio vinculado; as mesmas validações de valor e persistência se aplicam, podendo resultar na mensagem genérica de falha ao salvar descrita na Regra 8.
  15. Vínculo entre contratos e títulos: quando a liquidação envolve tanto contratos de câmbio quanto títulos (TitulosAProcessar preenchido), o sistema associa os valores liquidados entre as duas listas conforme a moeda e a carteira selecionadas no cabeçalho da operação.
  16. Cotação usada no cálculo: o ValorCotacao informado no cabeçalho da liquidação é o valor efetivamente utilizado para conversão e cálculo dos valores em moeda nacional/estrangeira durante a gravação.
  17. Reversão total em caso de erro em qualquer contrato do lote: ao processar múltiplos contratos em uma única chamada de Salvar, se a validação ou gravação de qualquer um dos contratos falhar, a transação inteira é revertida — nenhum dos contratos do lote é liquidado parcialmente.
05. PERMISSÕES

Permissões

Acesso à rotina: “EditViewDeLiquidacaoDeContratoBuscaContratos” (ID 3107, menu pai ID 1585)

AçãoPermissãoID
Salvar“LiquidacaoContrato/Salvar”3108
ListarContratoscoberta por “EditViewDeLiquidacaoDeContratoBuscaContratos”3107
ObterFiltrosDoXmlDeConfiguracaoDeContratocoberta por “EditViewDeLiquidacaoDeContratoBuscaContratos”3107
Imprimircoberta por “EditViewDeLiquidacaoDeContratoBuscaContratos” (permissão granular própria não localizada em RecursosGeraisFinanceiro.cs)3107
06. ROTINAS RELACIONADAS

Rotinas relacionadas

RotinaRelação
Contrato de Câmbio (cadastro)Origem dos contratos elegíveis para liquidação
Movimentação FinanceiraRecebe o lançamento de baixa gerado na liquidação
Integração Contábil (Fato Contábil)Recebe o lançamento contábil específico do modelo do contrato liquidado

NA PÁGINA

  • Visão Geral
  • Endpoints
  • Modelos de Dados
  • Regras de Negócio
  • Permissões
  • Rotinas relacionadas
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06