CD_CONTRATOVENDA - Tipo de Contrato de Venda

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: aba Locações — campo Código de Tipo de Contrato Venda Tabela: PARMFATUR.CD_CONTRATOVENDA (DOM_INTEGER) Foreign Key: RPARMFATUR_TIPOCONTRATOVENDA → TIPOCONTRATO.CD_TIPOCONTRATO Valor padrão: preenchido via busca (<F9>) ou informado manualmente.

Telas impactadas

Tela	Rotina	Efeito
MFA001 — Parâmetros de Faturamento	edtCD_CONTRATOVENDAKeyDown	Permite busca <F9> na tabela TIPOCONTRATOGERAL para selecionar o código.
MPD043 — Locações	TfrmMPD043.btnGerarPedidoClick	Ao gerar pedido de venda, busca o layout de impressão do contrato configurado.
MPD043 — Locações	TdmMPD043.tabLOCACAOTP_LOCACAOValidate	Quando o tipo de locação é V (Venda), preenche automaticamente CD_TIPOCONTRATO com o valor deste parâmetro.

Campos envolvidos

Campo	Tabela	Tipo	Descrição
CD_CONTRATOVENDA	PARMFATUR	INTEGER	Código do tipo de contrato usado em locações do tipo Venda.
DS_TIPOCONTRATOVENDA	(calc)	—	Descrição simplificada do tipo de contrato (preenchida automaticamente na validação).
CD_TIPOCONTRATO	TIPOCONTRATO	INTEGER	Chave primária da tabela de tipos de contrato.
CD_TIPOCONTRATO	LOCACAO	INTEGER	Campo que recebe automaticamente o valor do parâmetro quando a locação é do tipo Venda.

Comportamento

Trata-se de um campo de preenchimento livre (edit) que armazena o código de um Tipo de Contrato cadastrado em TIPOCONTRATO. Não possui opções fixas (como S/N); o valor deve corresponder a um registro válido na tabela TIPOCONTRATO.

O que faz	Detalhe
Validação	Ao digitar um código, o sistema consulta TIPOCONTRATO e exibe a descrição simplificada. Se o código não existir, exibe erro "O Contrato não está Cadastrado! Verifique[ADM011]!".
Busca <F9>	Abre a janela de pesquisa genérica sobre TIPOCONTRATOGERAL. Ao selecionar, o campo é preenchido automaticamente.
Uso em locações	Na tela de Locações (MPD043), quando o tipo de locação é V (Venda), o sistema copia este código para o campo CD_TIPOCONTRATO da locação.
Layout de impressão	Ao gerar pedido de venda em MPD043, o sistema usa o CD_LAYOUT do tipo de contrato informado para imprimir o documento.

Simulação passo a passo — Configuração

1. Acesse MFA001 — Parâmetros de Faturamento.
2. Clique na aba Locações.
3. Posicione o cursor no campo Código de Tipo de Contrato Venda.
4. Pressione <F9> para abrir a busca ou digite diretamente o código do tipo de contrato.
5. Selecione o tipo de contrato desejado na lista (ex.: contrato 5 — Venda de Equipamentos).
6. Salve os parâmetros.

Resultado esperado: o campo é preenchido com o código do tipo de contrato e a descrição aparece ao lado. Esse contrato será usado automaticamente em novas locações do tipo Venda.

Simulação passo a passo — Uso na Locação (MPD043)

1. Abra MPD043 — Locações.
2. Crie uma nova locação e selecione o Tipo de Locação como V (Venda).
3. Preencha os demais dados da locação.

Resultado esperado: o campo Tipo de Contrato da locação é preenchido automaticamente com o valor configurado em CD_CONTRATOVENDA. Ao gerar o pedido, o layout de impressão associado a esse tipo de contrato será utilizado.

Exceção / Importante: se o campo CD_CONTRATOVENDA estiver vazio ou nulo em PARMFATUR, a locação do tipo Venda não terá um contrato padrão atribuído automaticamente, e a geração do pedido poderá não encontrar o layout de impressão adequado.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TfrmMFA001.edtCD_CONTRATOVENDAKeyDown	UMFA001.pas	Busca <F9> sobre TIPOCONTRATOGERAL.
TdmMFA001.tabPARMFATURCD_CONTRATOVENDAValidate	UdmMFA001.pas	Valida existência em TIPOCONTRATO e preenche descrição.
TfrmMPD043.btnGerarPedidoClick	UMPD043.pas	Usa CD_CONTRATOVENDA para buscar layout de impressão do tipo de contrato ao gerar pedido.
TdmMPD043.tabLOCACAOTP_LOCACAOValidate	UdmMPD043.pas	Atribui CD_CONTRATOVENDA ao campo CD_TIPOCONTRATO da locação quando tipo = V.

Referências SQL diretas ao campo

Não foi encontrada referência direta a CD_CONTRATOVENDA em scripts SQL (Scripts/). O uso do campo está restrito às rotinas Delphi listadas acima.