• 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 Geral
        • Cadastro via SEFAZ
      • Manutenção de Cadastro Geral
      • Órgão Público
        • Cadastro - Órgão Público
        • Item
      • Propriedade Rural
    • Comercial
    • 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
      • Exclusão de Lançamento — Movimentação Contábil
      • 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 Fiscal (ECF)
        • Contas e Saldos Iniciais da Parte B
    • 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
    • Customização
    • Customização Local
    • DF-e
      • NF-e
        • Manuais, Procedimentos, Orientações e Boas Práticas
        • Transmissão
      • NFS-e
        • Importação
        • Importação de NFS-e
        • Manuais, Procedimentos, Orientações e Boas Práticas
        • Monitoramento
        • Monitoramento de NFS-e
        • Transmissão
        • Transmissão de NFS-e
    • Escrita Fiscal
      • Apuração por UF
        • Conferência da sistemática
        • ICMS Antecipado (PE)
          • Livro SEFAZ
          • Ocorrências
        • ICMS Sistemática (PE)
      • Apurações
      • B.I.
      • Cadastros
        • 4.5.4 - Tabela Código de Ajuste da Apuração do IPI
        • 5.1.1 - Tabela de Códigos de Ajustes da Apuração do ICMS
        • 5.2 - Tabela de informações Adicionais da Apuração - Valores Declaratórios
        • 5.3 - Tabela de Ajustes e Informações de Valores Provenientes de Documento Fiscal
        • 5.5 - Tabela de Tipos de Utilização dos Créditos Fiscais de ICMS
        • 5.6 - Tabela de Informações Adicionais dos Itens do Documento Fiscal
        • CFOP
        • CFOP Exceções
        • CFOP X NCM
        • Classificação Fiscal
        • Classificação Tributária de Crédito Presumido IBS/CBS
        • Classificação Tributária IBS/CBS
        • Classificação Tributária IS
        • Código Serviço NBS
        • Código Serviço Tributação Nacional do ISSQN
        • CST Exceções IPI
        • CST Exceções PIS/COFINS
        • Histórico de apuração
        • IBPT
        • INSS
        • Lista de serviço (Lei Complementar nº 116, de 31 de julho de 2003)
        • Modelo guia de tributos
        • Pauta produto
        • Situação Tributária
          • Situação tributária COFINS
          • Situação Tributária IBS/CBS
          • Situação tributária ICMS
          • Situação tributária IPI
          • Situação Tributária IS
          • Situação tributária PIS
        • Tabelas Códigos Receitas (Federal)
        • Tributo
      • 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
      • Movimentações
        • Inventário estoque fiscal
        • Livro registro de exportação
        • Livro registro de importação
        • Lote Escrita Fiscal
        • Manut. Geração de tributos nos documentos
        • Manut. Valores de Item/Tributos
        • Movimentação apuração de tributo
      • Relatórios
      • Relatórios Personalizados
      • Tabelas/Modelos
        • 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
        • Modelo de ajuste de Apuração
        • Registro de Eventos
        • Tributação por Item
        • Tributação por TMV
      • Tributos
    • Estoque
    • Exportação
    • Fabrica de Ração
    • Faturamento
      • Geração de Documento Destino
      • Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem
      • Monitoramento de Eventos
      • Rotina de Transferência de Participante
      • Venda de Mercado Interno
    • Financeiro
      • Cadastro
        • Condição de Pagamento
        • Forma de Cobrança
        • Forma de Pagamento
        • Instituição Financeira
        • Moeda
      • Cadastros
        • Condição de Pagamento
        • Empenho
        • Forma de Cobrança
        • Forma de Pagamento
        • 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 de Vencimento
        • Alteração Forma de Cobrança
        • Inclusão de Decréscimo
        • Inclusão de Desconto na Cobrança
        • Inclusão de Juros
        • Inclusão de Multa
      • Comex
        • Contrato de Câmbio
        • Desvinculação de Contrato x Fatura
        • Juros para Contrato de Câmbio
        • Liquidação de Contrato
        • Liquidação de Fatura
        • Vinculação de Contrato x Fatura
      • 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
      • Transferencias
        • Adiantamento de Cliente
        • Adiantamento de Fornecedor
        • Transferência Entre Contas
        • Transferência Entre Múltiplas Contas
    • Frente de Loja
    • Frigorífico
    • Indústria
    • Laticínio
    • Logística
    • Movimentação E/S
    • Obrigações Acessórias Federais
      • PER/DCOMP
    • Portal de Vendas
    • Projeto
    • Sped
    • Sped Contábil
    • Sped Reinf
    • Suprimentos
    • Tabelas Auxiliares
    • Telemarketing
    • WMS
Nenhum resultado encontrado
Inteligência Atak / Documentação / ERP / Financeiro / Comex

Desvinculação de Contrato x Fatura

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

DesvinculacaoContratoXFatura

Rotina do módulo Financeiro, dentro do submenu “Comex”, que permite desvincular faturas (títulos a receber) que estavam vinculadas a um contrato de câmbio.

01. VISÃO GERAL

Visão Geral

Rotina do módulo Financeiro, dentro do submenu “Comex”, que permite desvincular faturas (títulos a receber) que estavam vinculadas a um contrato de câmbio. A desvinculação não apaga o vínculo original: o sistema registra uma nova operação de desvinculação, com o valor correspondente, mantendo o histórico completo de vinculações e desvinculações de cada fatura ao contrato.

02. ENDPOINTS

Endpoints

GET /DesvinculacaoContratoXFatura/ListarTitulos

Lista os títulos (faturas) elegíveis para desvinculação de um contrato de câmbio, aplicando filtro de busca opcional.

Permissão: ação somente leitura sem entrada própria — coberta pela permissão de acesso à rotina “EditViewDeDesvinculacaoDeContratoXFatura” (ID 1588).

Parâmetros:

NomeTipoObrigatórioDescrição
extGridConfiguracaoDeGridSimPaginação/ordenação da grid (página inicial, quantidade de registros)
codigoContratostringSimCódigo/ID do contrato de câmbio cujas faturas vinculadas serão listadas
valorDeConsultastringNãoTexto livre para filtro adicional sobre as faturas
Exemplo de request:

“` GET /DesvinculacaoContratoXFatura/ListarTitulos?codigoContrato=000004461&valorDeConsulta= “`

Exemplo de response:

“`json { “total”: 2, “rows”: [ { “IdDaFatura”: “…”, “ValorVinculadoMoeda”: 0 } ] } “`

POST /DesvinculacaoContratoXFatura/Salvar

Ação principal: recebe uma ou mais faturas a desvincular de um contrato de câmbio e registra a desvinculação.

Permissão: “DesvinculacaoContratoXFatura/Salvar” (ID 3057)

Parâmetros:

NomeTipoObrigatórioDescrição
dtoDTODeContratoCambioSimObjeto contendo o ID do contrato e a lista de faturas (Faturas) a desvincular, cada uma com IdDaFatura e ValorVinculadoMoeda
Exemplo de request:

“` POST /DesvinculacaoContratoXFatura/Salvar { “ID”: “000004461”, “Faturas”: [ { “IdDaFatura”: “000012345”, “ValorVinculadoMoeda”: 1500.00 } ] } “`

Exemplo de response:

“`json { “success”: true, “retorno”: { “codigoContrato”: “000004461”, “valorMoeda”: 50000.00, “valorVinculado”: 30000.00, “valorSaldo”: 20000.00, “faturas”: [ { “IdDaFatura”: “000012345”, “ValorVinculado”: 1500.00 } ] } } “`

Se a lista de faturas informada (dto.Faturas) estiver vazia ou nula, a ação não executa nenhuma desvinculação e retorna erro (ver Regras de Negócio).

POST /DesvinculacaoContratoXFatura/Imprimir

Ação de suporte à impressão do comprovante de câmbio: garante que existe, na pasta de documentos do cliente, uma cópia do modelo de relatório “ComprovanteCambio.rpt” (Crystal Reports), copiando o modelo padrão caso ainda não exista. Não altera nenhum dado de negócio.

Permissão: “DesvinculacaoContratoXFatura/Imprimir” (ID 3058)

Parâmetros: nenhum.

Exemplo de request:

“` POST /DesvinculacaoContratoXFatura/Imprimir “`

Exemplo de response:

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

03. MODELOS DE DADOS

Modelos de Dados

DTODeContratoCambio (parâmetro de Salvar)

CampoTipoDescrição
IDstringCódigo do contrato de câmbio
FaturasList\<DTODeContratoFatura\>Lista de faturas a desvincular

DTODeContratoFatura (item de Faturas)

CampoTipoDescrição
IdDaFaturastringCódigo do título/fatura a ser desvinculado
ValorVinculadodecimalValor a desvincular, na moeda de origem
ValorVinculadoMoedadecimalValor a desvincular, convertido na moeda do contrato

Retorno de Salvar (composição)

CampoOrigemDescrição
codigoContratoProjecaoDeContratoFatura.NumeroDoContratoNúmero do contrato de câmbio
valorMoedaProjecaoDeContratoFatura.ValorContratoMoedaValor total do contrato na moeda
valorVinculadoProjecaoDeContratoFatura.ValorVinculadoMoedaValor total ainda vinculado ao contrato após a operação
valorSaldoProjecaoDeContratoFatura.SaldoSaldo disponível do contrato
faturasProjecaoDeContratoFaturaTitulo (lista)Faturas vinculadas ao contrato, filtradas pelas faturas informadas na requisição
04. REGRAS DE NEGÓCIO

Regras de Negócio

A ação Salvar é implementada por “IServicoDeContratosCambio.DesvincularFaturas”, em ATAK.ServicoDeAplicacao.Implementacao\Exportacao\ContratosCambio\ServicoDeContratoCambio.cs.

  1. Nenhuma fatura informada: se dto.Faturas estiver vazio ou nulo, a operação não é executada.
Mensagem exibida: “Não foi possível Desvincular Faturas. Nenhuma fatura informada.”
  1. Contrato não encontrado: se o contrato indicado por dto.ID não existir na base, a operação não é executada.
Mensagem exibida: “Não foi possível Desvincular Faturas. Contrato {0} não encontrado. Verifique o contrato e tente novamente.” (onde {0} é o código do contrato informado)
  1. Para cada fatura informada, o sistema localiza o título (fatura) correspondente. Se não for encontrado:
Mensagem exibida: “Não foi possível obter Fatura. A Fatura {0} não foi encontrada. Verifique e informe a fatura corretamente.” (onde {0} é o código da fatura)
  1. Se a fatura possuir valor a vincular informado (ValorVinculadoMoeda > 0), o sistema valida, nesta ordem:
  • O documento da fatura deve ser do tipo “FAT” (Fatura). Caso contrário:
    Mensagem exibida: “Não foi possível obter Fatura. Apenas faturas do documento FAT podem ser vinculadas. Fatura incorreta : {0}. Informe faturas do documento FAT para operação.”
  • A fatura deve possuir moeda cadastrada. Caso contrário:
    Mensagem exibida: “Não foi possível obter Fatura. Fatura {0} Não possui moeda. Informe fatura que possui moeda ou edite a fatura desejada.”
  • O valor a vincular não pode ser maior que o valor do título. Caso contrário:
    Mensagem exibida: “Não foi possível obter Fatura. Valor a vincular da Fatura {0} é maior que o valor do título. Informe valor a vincular que não seje maior que o valor do títulos.”
  • A moeda da fatura deve ser igual à moeda do contrato de câmbio. Caso contrário:
    Mensagem exibida: “Não foi possível obter Fatura. Moeda da fatura {0} é diferente da moeda do contrato. Moeda do contrato : {1} Moeda da fatura : {2}. Infome moeda da fatura igual a moeda do contrato.”
  • O sistema soma o valor já vinculado à fatura em outras operações (considerando vinculações menos desvinculações já registradas) e valida que o total, somado ao valor desta operação, não ultrapasse o valor do título. Caso contrário:
    Mensagem exibida: “Não foi possível validar valor da fatura. Valor informado para Fatura {0} ultrapassa o valor do título, Saldo disponível : {1} – {2}. Informe um valor para fatura que não ultrapasse o valor do título.”
  1. Se a fatura NÃO possuir valor a vincular informado (ValorVinculadoMoeda ausente/zero):
Mensagem exibida: “Não foi possível obter Fatura. Fatura {0} não possui valor a vincular. Vincule um valor a fatura e tente novamente.”
  1. Validação do valor a desvincular: o sistema localiza o vínculo original (registro com Operacao = Vinculação) da fatura com o contrato e valida que o valor informado para desvincular não é maior que o valor originalmente vinculado. Caso contrário:
Mensagem exibida: “Não foi possível validar valor a desvincular. Valor a desvincular ultrapassa valor vinculado. Valor do Vinculado : {0} Valor a desvincular : {1}. Informe um valor a desvincular que não ultrapasse o valor vinculado.”
  1. Efeito da desvinculação: passadas todas as validações, para cada fatura o sistema adiciona um novo registro de ContratoFatura ao contrato, com Operacao = Desvinculacao e o valor informado (o registro original de vinculação não é removido — o histórico é mantido por soma de operações). Em seguida, a transação é persistida (“GerenciadorDeUnidadeDeTrabalho.Corrente.Commit()”).
  2. Se nenhuma fatura for informada na requisição do controller (Salvar) — nível de controller, antes mesmo de chamar o serviço:
Mensagem exibida: “Não foi possível Salvar. Os dados informados podem estar incorretos. Verifique se os dados informados estão corretos.”
  1. Composição da resposta: após a desvinculação, o sistema consulta novamente o contrato (valor total, valor vinculado, saldo) e a lista de faturas vinculadas ao contrato (considerando vinculações e desvinculações já registradas) para retornar ao usuário o estado atualizado.
05. PERMISSÕES

Permissões

Acesso à rotina: “EditViewDeDesvinculacaoDeContratoXFatura” (ID 1588) — submenu do menu “Comex” (ID 1585, Financeiro)

AçãoPermissãoID
Salvar“DesvinculacaoContratoXFatura/Salvar”3057
Imprimir“DesvinculacaoContratoXFatura/Imprimir”3058
ListarTitulos (leitura)coberta por “EditViewDeDesvinculacaoDeContratoXFatura”—

NA PÁGINA

  • Visão Geral
  • Endpoints
  • Modelos de Dados
  • Regras de Negócio
  • Permissões
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