VinculacaoContratoXFatura

Rotina do módulo Financeiro (área de Câmbio/Comex) que permite vincular um Contrato de Câmbio a uma ou mais faturas (títulos a receber) do cliente, associando o valor recebido em moeda estrangeira do contrato à liquidação das faturas correspondentes.

Rotina do módulo Financeiro (área de Câmbio/Comex) que permite vincular um Contrato de Câmbio a uma ou mais faturas (títulos a receber) do cliente, associando o valor recebido em moeda estrangeira do contrato à liquidação das faturas correspondentes. É o mecanismo usado para “baixar” faturas de exportação usando o valor de um contrato de câmbio já fechado.

1. Só é possível vincular faturas a um contrato existente. Se o contrato informado não for encontrado, a operação é bloqueada.
   Mensagem exibida: “Não foi possível vincular Faturas — Contrato {0} não encontrado — Verifique o contrato e informe corretamente” (onde {0} é o ID do contrato informado)
2. É obrigatório informar ao menos uma fatura para vincular. Se a lista de faturas vier vazia, a operação é bloqueada tanto no controller quanto na camada de serviço.
   Mensagem exibida (serviço): “Não foi possível vincular Faturas — Nenhuma fatura informada — Informe uma fatura valida e tente novamente”
   
   Mensagem exibida (controller, quando o modelo enviado não possui faturas): “Não foi possível Salvar — Os dados informados podem estar incorretos — Verifique se os dados informados estão corretos.”
3. O valor total vinculado a um contrato nunca pode ultrapassar o valor do próprio contrato. O sistema soma o valor já vinculado ao novo valor informado e compara com o valor total do contrato antes de gravar.
   Mensagem exibida: “Não foi possível validar valor a vincular — Valor a vincular ultrapassa valor do contrato. Valor do contrato : {0} Total vinculado : {1} Valor a vincular : {2} — Informe um valor que não ultrapasse o valor do contrato”
4. Somente faturas do tipo de documento “FAT” podem ser vinculadas a um contrato de câmbio. Qualquer outro tipo de documento é rejeitado.
   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”
5. A fatura precisa ter moeda estrangeira definida para poder ser vinculada a um contrato de câmbio.
   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”
6. O valor a vincular de uma fatura não pode ser maior que o valor total do título.
   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”
7. A moeda da fatura precisa ser a mesma moeda do contrato de câmbio. Não é permitido vincular fatura em moeda diferente da moeda do contrato.
   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”
8. É obrigatório informar um valor a vincular maior que zero para cada fatura selecionada.
   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”
9. A fatura informada precisa existir no cadastro de títulos a receber.
   Mensagem exibida: “Não foi possível obter Fatura — A Fatura {0} não foi encontrada — Verifique e informe a fatura corretamente”
10. O valor total vinculado a uma mesma fatura (somando vinculações anteriores e descontando desvinculações) não pode ultrapassar o valor do título. O sistema recalcula esse total considerando o histórico de vínculos/desvínculos já registrados para o contrato.
    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”
11. A vinculação é persistida de forma transacional: somente após todas as faturas informadas passarem pelas validações acima é que a operação é confirmada (commit) na base de dados; qualquer falha em uma fatura interrompe a gravação de todo o lote.
12. A ação “Imprimir” gera o comprovante de câmbio a partir de um modelo padrão (“ComprovanteCambio.rpt”), copiando-o para a pasta do cliente apenas se ainda não existir — não gera um novo arquivo a cada impressão.

Acesso à rotina: não há uma permissão “ListView” própria registrada em RecursosGeraisFinanceiro.cs para esta rotina — o acesso de leitura/consulta (ListarContratos, ListarTitulos e as consultas de filtro) não exige permissão granular específica; as ações de escrita (“Salvar” e “Imprimir”) possuem permissão própria e são o que efetivamente controla o acesso à funcionalidade.