• 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 / Contrato de Câmbio

Contrato de Câmbio

Criado por Igor Ribeiro em 04 de novembro de 2026
•
Atualizado por Igor Ribeiro em 04 de novembro de 2026
Documentação Técnica

Contrato de Câmbio — Financeiro (ERPV1)

A tela Contrato de Câmbio, do módulo Financeiro (menu Comex), serve para cadastrar e acompanhar os contratos de câmbio de exportação e de importação da empresa.

01. VISÃO GERAL

Visão Geral

A tela Contrato de Câmbio, do módulo Financeiro (menu Comex), serve para cadastrar e acompanhar os contratos de câmbio de exportação e de importação da empresa. Cada contrato registra filial, modelo, carteiras de origem e destino, moeda, valor em moeda e em reais, cotação, taxa de juros e as datas de abertura, crédito, vencimento e entrega de documentos.

A tela tem uma lista com filtros e uma janela de cadastro. A partir do contrato é possível consultar as faturas vinculadas e as operações financeiras e contábeis geradas. Também é possível cancelar o contrato e importar vários contratos de uma vez por planilha Excel. Vincular faturas, liquidar e lançar juros são tarefas de outras telas do menu Comex.

02. PRÉ-REQUISITOS

Pré-requisitos

  • Carteira logada: é preciso estar logado em uma carteira. Sem ela a tela não abre.
  • Cadastros de apoio: filial, moeda, carteiras de origem e destino e, no modelo Antecipado cliente (ADX), o cliente com forma de cobrança cadastrada.
  • Histórico contábil configurado: nos modelos que geram movimentos financeiros, a operação precisa ter histórico configurado; sem ele o contrato não é gravado.
  • Cotação da moeda: a cotação é buscada pela moeda na data de abertura; sem cotação cadastrada o campo fica para digitação.
  • Carteira de origem com cadastro vinculado: exigida em todos os modelos, exceto o ADX.
  • Importação: planilha no formato do modelo oferecido pela própria tela, em .xlsx.
03. FLUXO OPERACIONAL

Fluxo Operacional

Consultar contratos

  1. Abra Financeiro > Comex > Contrato de Câmbio. Sem carteira logada o sistema avisa e não abre.
  2. A “Lista de Contrato Câmbio” é exibida. O painel de filtros começa recolhido.
  3. Expanda Filtros, informe os critérios e clique em Buscar. Limpar Filtros zera os campos e recarrega a primeira página.
  4. Para consultar um contrato, selecione-o e clique em Edição, ou dê duplo clique na linha.

Incluir um contrato

  1. Na lista, clique em Novo. A janela “Novo Contrato Câmbio” abre com a filial logada e a Data de Abertura igual à data de movimento.
  2. Preencha modelo, tipo, carteiras (ou participante, no ADX), moeda, valores e datas.
  3. Ao escolher a moeda, o sistema preenche a Cotação e calcula o Valor Contrato.
  4. Salve. O sistema grava o contrato e, conforme o modelo, gera os movimentos financeiros e contábeis.
  5. Em caso de sucesso, o sistema informa que o contrato foi inserido.

Editar um contrato

  1. Selecione o contrato e clique em Edição. A janela “Editar Contrato Câmbio” abre em modo restrito: só Prazo Vencimento, Prazo Entrega Documento e Observação podem ser alterados.
  2. Altere os campos e salve. Contratos que não estão em situação Aberto não podem ser gravados.

Cancelar um contrato

  1. Na janela do contrato, acione o cancelamento e confirme “Deseja cancelar o Contrato de Câmbio?”.
  2. O sistema exibe “Aguarde…” e processa. Em caso de sucesso a situação passa para Cancelado, a mensagem “O contrato foi cancelado com sucesso.” é exibida e a janela reabre atualizada.

Importar contratos por planilha

  1. Na lista, clique em Importar Lançamentos (Ctrl+J). Abre a janela “Opção de Importação — Contratos de Câmbio”.
  2. Na aba Ajuda consulte as colunas e baixe a planilha modelo.
  3. Na aba Importação selecione o arquivo .xlsx e clique em Importar. O sistema exibe “Lendo a planilha, validando e cadastrando os contratos de câmbio…”.
  4. Abre a janela “Resultado da Importação — Contratos de Câmbio” com os totais e a lista de erros. As linhas válidas são cadastradas mesmo que outras falhem.
  5. Havendo erros, clique em “Exportar log de erros (.xlsx)”, corrija a planilha e importe novamente apenas as linhas rejeitadas.

Consultar faturas e operações do contrato

  1. A partir do contrato, abra a janela “Contrato Câmbio – Faturas” para ver as faturas vinculadas e desvinculadas.
  2. Ou abra “Contrato Câmbio – Fin/Ctb” para ver as operações financeiras e contábeis do contrato.
  3. As duas janelas são somente para consulta; o único comando é Fechar aba.
04. INTERFACE E COMPORTAMENTOS DA TELA

Interface e Comportamentos da Tela

Colunas da lista

ColunaConteúdo
FilialCódigo da filial.
Número do contratoNúmero do contrato.
Data de aberturaData de abertura.
ModeloCódigo e nome do modelo.
Carteira/Participante OrigemCódigo e nome da origem.
Carteira/Participante DestinoCódigo e agência da carteira de destino.
Situação do contratoAberto, Liquidado ou Cancelado.
MoedaCódigo e nome da moeda.
Valor contratoValor em moeda.
Valor vinculadoSoma vinculada de faturas, em moeda.
Saldo a vincularValor contrato menos valor vinculado.
Saldo a liquidarValor contrato menos valor liquidado.

A lista é paginada e pode ser ordenada por qualquer coluna. Sem ordenação escolhida, aparece por filial. Sem resultados, a lista fica vazia.

Filtros da lista

FiltroTipoComportamento
FilialPesquisaFiltra pela filial.
Chave FatoTextoFiltra pela chave do contrato.
Número ContratoPesquisa de múltipla escolhaAceita vários contratos; a pesquisa mostra contratos de qualquer situação.
Modelo do ContratoListaFiltra pelo modelo.
Carteira origemPesquisaFiltra pelo cadastro de origem.
Carteira destinoPesquisaFiltra pela carteira de destino.
Situação do ContratoListaAberto, Liquidado ou Cancelado.
Tipo do ContratoListaExportação ou Importação.
Data de Abertura / Abertura FinalDatasPeríodo inclusivo; cada data é aplicada isoladamente.
Data de Crédito / Crédito FinalDatasIdem.
Data de Vencimento / Vencimento FinalDatasIdem.

Comandos da barra da lista

Novo, Edição, Exportar (Excel, Word, PDF e HTML), Importar Lançamentos (Ctrl+J), Vídeo e Fechar aba, além de Personalizar Listagens. A lista não oferece o comando Excluir.

Campos do cadastro (grupo Dados Gerais)

Identificação e partes

CampoObrigatórioComportamento
Chave Fato—Oculto na inclusão; exibido na edição.
Filial—Filial logada na inclusão.
Número do ContratoSimAté 10 caracteres.
Código do ContratoNãoAté 100 caracteres.
Situação do ContratoSimValor inicial Aberto.
Tipo do ContratoSimValor inicial Exportação.
Modelo do ContratoSimDefine o comportamento do cadastro (ver Regras de Negócio).
Carteira OrigemSim (exceto ADX)Oculta e limpa no ADX.
ParticipanteSim no ADXPesquisa de cliente; só aparece no ADX.
Carteira DestinoSimCarteira do banco que recebe o contrato.

Datas e prazos

CampoObrigatórioComportamento
Data de AberturaSimData de movimento na inclusão.
Data de CréditoSim—
Prazo VencimentoNãoNúmero inteiro de até 4 dígitos.
Data de VencimentoSim—
Prazo Entrega DocumentoNãoNúmero inteiro de até 4 dígitos.
Data de Entrega DocumentoNão—

Moeda e valores

CampoObrigatórioComportamento
MoedaSimPreenche a Cotação.
Valor Contrato MoedaSimMínimo 0, 2 casas decimais.
Cotação moedaNão4 casas decimais.
Valor ContratoNãoCalculado; pode ser alterado com confirmação.
Taxa JurosNão4 casas decimais.
Valor Vinculado Moeda, Valor Liquidado Moeda, Saldo a Vincular, Saldo a Liquidar—Somente leitura.
ObservaçãoNãoTexto livre.

Comportamentos do cadastro

  • Ao escolher a moeda, a Cotação é preenchida pela cotação da data de abertura e o Valor Contrato passa a ser Valor Contrato Moeda multiplicado pela Cotação.
  • Ao sair de Valor Contrato Moeda ou de Cotação, o Valor Contrato é recalculado, arredondado em duas casas.
  • Ao sair de Valor Contrato com valor diferente do cálculo, o sistema pergunta se deseja prosseguir; Sim recalcula a cotação, Não restaura o valor calculado.
  • No modelo Antecipado cliente (ADX) o campo Carteira Origem some e o Participante aparece; Data de Abertura e Data de Vencimento passam a ser obrigatórias. Nos demais modelos ocorre o inverso.
  • Na edição todos os campos ficam somente leitura, exceto Prazo Vencimento, Prazo Entrega Documento e Observação.

Janela de importação

Duas abas. Importação: seleção do arquivo .xlsx e botão Importar. Ajuda: sub-aba Colunas, com a lista de campos (filtros por texto, Todos os campos/Obrigatórios/Opcionais e Todos os tipos/Texto/Número/Data, com o contador “N campos no total”), e sub-aba Modelo, com nove regras de preenchimento e o botão “Baixar planilha modelo (Modelo_Importacao_Contrato_Cambio.xlsx)”.

Janela de resultado da importação

Mostra Total de linhas lidas, Importadas com sucesso e Com erro; uma lista de erros (Linha, Campo, Descrição do erro) e o botão “Exportar log de erros (.xlsx)”.

Janela de faturas

Título “Contrato Câmbio – Faturas”. Grupo Contrato (Filial, Número, Modelo, Situação, Abertura, Vencimento) e grupo Faturas, com as colunas Título, Participante, Data de emissão, Carteira, Valor moeda, Valor vinculado e Operação (Vinculação ou Desvinculação).

Janela de operações financeiras e contábeis

Título “Contrato Câmbio – Fin/Ctb”. Grupo Contrato com os mesmos dados e duas abas: Operações Financeiras (comprovantes, com Chave de Fato, Valor Cotação e Valor Moeda) e Operações Contábeis (lançamentos contábeis). O campo de busca das listas fica oculto.

05. FEEDBACKS AO USUÁRIO

Feedbacks ao Usuário

Abertura da tela

  • Sem carteira logada: “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.”.

Cadastro e edição

  • Valor Contrato diferente do cálculo: título “Contrato de câmbio”, “O valor informado no campo não corresponde ao cálculo automático, deseja prosseguir?”.
  • Contrato inserido: “Novo Contrato Câmbio” — inserido com sucesso.
  • Contrato editado: “Contrato Câmbio editado com sucesso”.
  • Edição de contrato cancelado: “Não foi possível realizar a operação.” / “O Contrato está cancelado”.
  • Contrato excluído: “Contrato Câmbio excluido com sucesso”.
  • Exclusão com faturas vinculadas: “Não foi possível Excluir Contrato de Câmbio” / “O contrato {0} [{1}] possui faturas vinculadas e não pode ser excluido.” / “Para exclusão, desvincule faturas e tente novamente.”.
  • Sem histórico contábil: “Não foi possível inserir novo Contrato de Câmbio” / “Não é possível executar uma operação financeira sem histórico” / “Configure um histórico no fato contábil do financeiro para os seguintes valores: Operação : {0} Variação : {1}”.
  • ADX sem forma de cobrança: “Não foi possível inserir novo Contrato de Câmbio” / “Não foi informado uma forma de cobrança no cliente” / “Informar uma forma de cobrança no Cliente {0} para a inclusão do título de adiantamento”.
  • Modelo inválido: “Não foi possível obter modelo” / “Não foi informado um modelo valido para o contrato” / “Informar um modelo valido para o contrato. Código informado : {0}”.
  • Carteira inválida: “Não foi possível obter carteira” com “A carteira informada está inválida”, “Carteira {0} não encontrada.” ou “Carteira {0} não possui um cadastro vinculado.”.
  • Moeda inválida: “Não foi possível obter moeda” com “Não foi informada a moeda” ou “A Moeda inserida não foi encontrada.”.
  • Falha genérica: “Falha na operação.” / “Verifique os dados e tente novamente.”.
  • Falha na exclusão: “Não foi possível realizar operação” / “Verifique operação e tente novamente”.

Cancelamento

  • Confirmação: “Cancelar Contrato de Câmbio” — “Deseja cancelar o Contrato de Câmbio?”.
  • Espera: “Aguarde…” — “Por favor, aguarde enquanto o Contrato de Câmbio está sendo cancelado.”.
  • Sucesso: “Sucesso” — “O contrato foi cancelado com sucesso.”.
  • Condições não atendidas: “Não foi possível cancelar o lançamento” — “A situação do contrato não atende às condições necessárias para o cancelamento. O contrato deve estar aberto, sem valor de fatura vinculada (valor vinculado igual a 0), e não deve haver operação de liquidação parcial.” / “Realizar a desvinculação de Fatura ou Excluir a operação de Liquidação”.

Importação — janela e resultado

  • Arquivo fora do padrão: “Formato inválido” — “O arquivo selecionado não é uma planilha excel (.xlsx). Selecione um arquivo no formato .xlsx.” ou, ao importar, “Apenas arquivos em excel (.xlsx) são permitidos.”.
  • Espera: “Lendo a planilha, validando e cadastrando os contratos de câmbio…”.
  • Sem contratos: “Nenhum contrato encontrado na planilha. A linha 5 é apenas um exemplo e não é importada; preencha os contratos a partir da linha 6.”.
  • Com erros: “Importação concluída com erros. As linhas abaixo não foram importadas; as demais foram cadastradas normalmente.”.
  • Sucesso: “Importação concluída com sucesso.”.
  • Falha: título “Erro na importação” com a mensagem do sistema, ou “Importação não realizada. Arquivo inválido ou erro ao processar a planilha.”.

Importação — erros por linha

  • “Campo obrigatório não informado.”
  • “O valor ‘{0}’ excede o tamanho máximo de {1} caracteres (informados {2}).”
  • “O valor ‘{0}’ é inválido. Informe um número inteiro entre 0 e {1}.”
  • “O valor ‘{0}’ é inválido. Informe um número decimal (ex: 1234,56).”
  • “O valor ‘{0}’ não pode ser negativo.”
  • “O valor ‘{0}’ excede o tamanho permitido ({1} dígitos inteiros e {2} decimais).”
  • “A data ‘{0}’ é inválida. Use o formato DD/MM/AAAA.”
  • “Tipo ‘{0}’ inválido. Informe E (Exportação) ou I (Importação).”
  • “Situação ‘{0}’ inválida. Informe A (Aberto), L (Liquidado) ou C (Cancelado).”
  • “O Valor Contrato Moeda deve ser maior que zero.”
  • “Informe o Valor Contrato ou a Cotação da Moeda para que o valor seja calculado.”
  • “O Valor Contrato deve ser maior que zero.”
  • “Campo calculado pelo sistema na vinculação de faturas. Deixe em branco ou 0.”
  • “Campo calculado pelo sistema na liquidação do contrato. Deixe em branco ou 0.”
  • “Filial ‘{0}’ não encontrada.”
  • “Modelo de contrato ‘{0}’ não encontrado.”
  • “A Data de Vencimento é obrigatória no modelo Antecipado (ADX).”
  • “Cliente ‘{0}’ não encontrado.”
  • “Já existe um contrato de câmbio com a chave fato ‘{0}’.”
  • “Já existe o contrato ‘{0}’ para a filial {1} e modelo {2} (chave fato {3}).”
  • “Erro não identificado ao gravar o contrato.”

Importação — erros do arquivo

Todos com o título “Erro ao realizar a importação.” — “Erro ao realizar a importação: {0}.” — “Verifique o erro e tente novamente.”, onde {0} pode ser:

  • “A planilha não possui registros a partir da linha {0}.”
  • “Não foi possível ler o arquivo. Verifique se é uma planilha Excel (.xlsx) válida. {0}”
  • “A linha {0} da planilha deve conter os nomes das colunas do modelo. Colunas não encontradas: {1}.”
  • “Arquivo não encontrado.”
  • “Formato de arquivo não permitido. Selecione uma planilha Excel (.xlsx).”
06. REGRAS DE NEGÓCIO

Regras de Negócio

Carteira obrigatória para abrir

A tela só abre com carteira logada.

Situações do contrato

Aberto, Liquidado e Cancelado. Todo contrato novo nasce Aberto.

Tipos do contrato

Exportação e Importação. O valor inicial é Exportação.

Modelos de contrato

ACC (Adiantamento sobre Contrato de Câmbio), ACE (Adiantamento sobre Cambiais Entregues), Pronto, ProntoF (Pronto com Fatura), NDF, NDFC (NDF – Corrente), TRV (Trava), PPE (Pré-Pagamento de Exportação), OPC (Opção), Antecipado (Banco) e Antecipado cliente (ADX). O modelo define o que o sistema gera ao gravar:

  • ACC, ACE e Antecipado (Banco) geram dois movimentos financeiros: um débito com o cadastro de origem e um crédito com o cadastro da carteira de destino.
  • ADX gera o movimento de débito, um título a receber de adiantamento em aberto, com a forma de cobrança do cliente, e o movimento de crédito correspondente.
  • Pronto, ProntoF, NDF, NDFC, TRV, PPE e OPC gravam apenas o contrato. Exceções: NDF e NDFC geram um movimento de crédito de valor zero, sem título; Pronto é liquidado automaticamente na gravação.
  • Liquidação automática do Pronto: o valor liquidado é o Valor em Moeda multiplicado pela cotação; o contrato passa para Liquidado quando o total liquidado iguala o valor do contrato. Qualquer erro desfaz a operação.

Número do contrato

O Número é obrigatório, de 1 a 10 caracteres.

Cálculo do valor

Valor Contrato = Valor Contrato Moeda x Cotação, em duas casas. Se for informado um valor diferente, a cotação é recalculada em quatro casas dividindo o valor pelo valor em moeda.

Modelo ADX

Exige participante (cliente com forma de cobrança), Data de Abertura e Data de Vencimento, não usa carteira de origem e gera título a receber de adiantamento.

Histórico contábil obrigatório

Os modelos que geram movimentos só gravam se houver histórico configurado no fato contábil da operação.

Edição restrita

Só contratos Abertos são editados, e apenas Prazo Vencimento, Prazo Entrega Documento e Observação.

Exclusão

Só contrato Aberto e sem faturas vinculadas. A lista não oferece o comando.

Cancelamento

Exige contrato Aberto, valor vinculado zero e nenhuma operação de liquidação. O cancelamento só muda a situação; não estorna os movimentos gerados.

Saldos

Saldo a vincular = valor do contrato menos valor vinculado; saldo a liquidar = valor do contrato menos valor liquidado.

Importação — colunas

A planilha tem 25 colunas. Obrigatórias: Cod_filial, Tipo_contrato (E ou I), Modelo_contrato, Cod_contrato (até 10), Cod_banco_caixa_orig (no ADX, código do cliente com forma de cobrança), Cod_banco_caixa_dest, Cod_moeda, Data_credito e Valor_contrato_moeda (maior que zero, 15 dígitos com 2 decimais). Opcionais: Chave_fato (vazia gera nova; numérica é completada com zeros até 9 dígitos e não pode existir), Cod_contrato_completo (100), Status (A, L ou C; vazio = A), Data_abertura (vazia = data de movimento), Data_vencto (obrigatória no ADX), Data_entrega_docs, Prazo_dias_vencto e Prazo_dias_entrega_docs (até 9999), Valor_contrato (vazio é calculado), Valor_cotacao (vazia é calculada), Valor_cotacao_original, Perc_juros (6 dígitos com 4 decimais) e Observacao (255). Valor_vinculado_moeda e Valor_liquidado_moeda devem ficar vazios ou 0. É preciso informar Valor_contrato ou Valor_cotacao.

Importação — formatos

Datas aceitas: dd/MM/yyyy, d/M/yyyy, dd/MM/yy, d/M/yy, yyyy-MM-dd, dd-MM-yyyy, data do Excel ou número serial, com ano entre 1753 e 9999. Decimais aceitam vírgula, são arredondados e não podem ser negativos. Filial numérica com menos de 3 dígitos é completada com zeros.

Importação — validações por linha

Filial e modelo devem existir; no ADX exige vencimento e cliente com forma de cobrança; nos demais exige carteira de origem válida; carteira de destino e moeda devem existir; modelos que geram movimentos exigem histórico contábil (erro no campo Modelo_contrato); chave existente é erro; contrato duplicado (mesma filial, modelo e número, não cancelado) é erro.

Importação — parcialidade

Linhas válidas são gravadas mesmo que outras falhem; cada linha é gravada de forma independente.

Importação — formato do arquivo

Só .xlsx.

Faturas e operações

As janelas de faturas e de operações financeiras/contábeis são somente consulta. Vinculação, desvinculação, liquidação e juros do contrato são feitos em outras telas.

07. TROUBLESHOOTING

Troubleshooting

T-01

A tela não abre

Cenário: você abre a rotina sem carteira logada.

Mensagem exibida: “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.”.

O que fazer: logar em uma carteira e abrir novamente.

T-02

Contrato não é gravado por falta de histórico

Cenário: inclusão de contrato de modelo que gera movimento financeiro.

Mensagem exibida: “Não é possível executar uma operação financeira sem histórico”.

O que fazer: pedir a configuração do histórico no fato contábil da operação e variação informadas e salvar novamente.

T-03

ADX sem forma de cobrança

Cenário: inclusão de contrato Antecipado cliente (ADX).

Mensagem exibida: “Não foi informado uma forma de cobrança no cliente”.

O que fazer: informar a forma de cobrança no cadastro do cliente.

T-04

Carteira ou moeda inválida

Cenário: carteira inexistente, sem cadastro vinculado, ou moeda não informada ou não encontrada.

Mensagem exibida: “Carteira {0} não encontrada.”, “Carteira {0} não possui um cadastro vinculado.”, “Não foi informada a moeda” ou “A Moeda inserida não foi encontrada.”.

O que fazer: corrigir o cadastro e tentar novamente.

T-05

Edição de contrato cancelado

Cenário: salvar contrato com situação Cancelado.

Mensagem exibida: “O Contrato está cancelado”.

O que fazer: nenhuma edição é possível; se necessário, incluir novo contrato.

T-06

Cancelamento recusado

Cenário: contrato com faturas vinculadas, com liquidação ou fora da situação Aberto.

Mensagem exibida: “A situação do contrato não atende às condições necessárias para o cancelamento. …”.

O que fazer: desvincular as faturas ou excluir a operação de liquidação e cancelar novamente.

T-07

Exclusão recusada

Cenário: contrato com faturas vinculadas.

Mensagem exibida: “O contrato {0} [{1}] possui faturas vinculadas e não pode ser excluido.”.

O que fazer: desvincular as faturas e tentar novamente.

T-08

Arquivo de importação recusado

Cenário: o arquivo não é .xlsx.

Mensagem exibida: “O arquivo selecionado não é uma planilha excel (.xlsx). Selecione um arquivo no formato .xlsx.”.

O que fazer: salvar a planilha como .xlsx.

T-09

Colunas não encontradas ou planilha vazia

Cenário: a linha 3 não traz os nomes das colunas do modelo, ou não há dados a partir da linha 6.

Mensagem exibida: “A linha {0} da planilha deve conter os nomes das colunas do modelo. Colunas não encontradas: {1}.” ou “A planilha não possui registros a partir da linha {0}.”.

O que fazer: usar a planilha modelo sem alterar os cabeçalhos e preencher os contratos a partir da linha 6.

T-10

Linhas rejeitadas na importação

Cenário: o resultado mostra linhas com erro.

Mensagem exibida: “Importação concluída com erros. As linhas abaixo não foram importadas; as demais foram cadastradas normalmente.”.

O que fazer: exportar o log de erros, corrigir apenas as linhas rejeitadas e importar de novo. Não reenvie as linhas já importadas: seriam recusadas como duplicadas.

T-11

Valor do contrato diferente do cálculo

Cenário: você digita Valor Contrato diferente de Valor Moeda x Cotação.

Mensagem exibida: “O valor informado no campo não corresponde ao cálculo automático, deseja prosseguir?”.

O que fazer: responder Sim para recalcular a cotação ou Não para voltar ao valor calculado.

08. CASOS DE USO

Casos de Uso

Caso 1 — Registrar um contrato ACC

O analista clica em Novo, escolhe o modelo ACC, informa carteira de origem e destino, moeda e valor em moeda. A cotação e o valor em reais são preenchidos automaticamente. Ao salvar, o contrato é gravado e os movimentos financeiros são gerados.

Caso 2 — Registrar um adiantamento de cliente (ADX)

O analista escolhe o modelo Antecipado cliente (ADX), informa o participante, as datas de abertura e vencimento e os valores. Ao salvar, o sistema cria o título a receber de adiantamento do cliente.

Caso 3 — Cancelar um contrato lançado por engano

O analista abre o contrato, aciona o cancelamento e confirma. Se o contrato tiver faturas vinculadas, desvincula antes na tela própria.

Caso 4 — Carga de contratos por planilha

O analista baixa o modelo, preenche os contratos a partir da linha 6 e importa. Revisa o resultado, exporta o log de erros, corrige as linhas rejeitadas e importa novamente apenas elas.

Caso 5 — Acompanhar saldos

O analista filtra por modelo e situação Aberto e consulta Saldo a vincular e Saldo a liquidar. Abre a janela de faturas de um contrato para ver o que já foi vinculado.

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Fluxo Operacional
  • Interface e Comportamentos da Tela
  • Feedbacks ao Usuário
  • Regras de Negócio
  • Troubleshooting
  • Casos de Uso
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