CD_CONTRATOLOCACAO - Tipo de Contrato de Locação

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: Aba Locações — campo "Código de Tipo de Contrato Locação" Tabela: PARMFATUR.CD_CONTRATOLOCACAO (INTEGER) Referência externa: TIPOCONTRATO.CD_TIPOCONTRATO

Descrição

Define o código do Tipo de Contrato que será utilizado como padrão nas locações do sistema. Quando uma nova locação é criada com tipo diferente de "Venda" (V), o sistema preenche automaticamente o tipo de contrato da locação com o valor informado neste parâmetro.

Telas impactadas

Tela	Rotina	Efeito
MPD043 — Locações	tabLOCACAOTP_LOCACAOValidate	Preenche automaticamente o tipo de contrato da locação quando TP_LOCACAO <> 'V'
MPD043 — Locações	btnGerarPedidoClick	Busca o layout de impressão do contrato na tabela TIPOCONTRATO para gerar/imprimir o contrato da locação

Campos envolvidos

Campo	Tabela	Descrição
CD_CONTRATOLOCACAO	PARMFATUR	Código do tipo de contrato padrão para locações
CD_TIPOCONTRATO	TIPOCONTRATO	Chave primária do tipo de contrato referenciado
DS_SIMPLIFICADA	TIPOCONTRATO	Descrição simplificada exibida na validação
CD_LAYOUT	TIPOCONTRATO	Layout de impressão do contrato
CD_TIPOCONTRATO	LOCACAO	Campo da locação preenchido automaticamente

Comportamento

Configuração (MFA001)

O que faz	Detalhe
Campo editável	Digite o código ou pressione <F9> para buscar
Validação	Verifica existência na tabela TIPOCONTRATO
Obrigatório	Não (pode ficar em branco)

Simulação passo a passo

1. Acesse a tela MFA001 — Parâmetros de Faturamento.
2. Selecione a aba Locações.
3. Posicione o cursor no campo Código de Tipo de Contrato Locação.
4. Digite o código do tipo de contrato desejado (ex.: 3) ou pressione <F9> para abrir a busca de tipos de contrato geral.
5. Selecione o tipo de contrato desejado na janela de pesquisa.
6. Salve os parâmetros.

Resultado esperado: O campo é preenchido com o código do tipo de contrato. Se o código não existir em TIPOCONTRATO, o sistema exibe a mensagem "O Contrato não esta Cadastrado! Verifique[ADM011]!" e impede a saída do campo.

Exceção / Importante: Se o campo ficar em branco, a descrição do tipo de contrato é limpa, mas o sistema não bloqueia o salvamento. Porém, ao gerar pedidos de locação em MPD043, o layout de impressão do contrato usará o código 100 como fallback (COALESCE para 100).

Uso automático (MPD043 — Locações)

O que faz	Detalhe
Preenchimento automático	Ao informar o tipo de locação diferente de "V" (Venda), o tipo de contrato é preenchido com este parâmetro
Impressão de contrato	O layout buscado em TIPOCONTRATO.CD_LAYOUT é usado para imprimir o contrato da locação

Simulação passo a passo

1. Abra a tela MPD043 — Locações.
2. Crie uma nova locação preenchendo os dados do cliente e produto.
3. No campo Tipo de Locação, selecione um tipo diferente de "V" (ex.: "L" — Locação).
4. Confirme o tipo de locação.

Resultado esperado: O campo Tipo de Contrato da locação é preenchido automaticamente com o valor configurado em CD_CONTRATOLOCACAO nos parâmetros de faturamento.

Exceção / Importante: Quando o tipo de locação é "V" (Venda), o sistema utiliza o parâmetro CD_CONTRATOVENDA (configurado em MFA001 — Parâmetros de Faturamento, aba Locações) em vez de CD_CONTRATOLOCACAO.

Procedures impactadas

Rotinas Delphi com referência direta

Rotina	Arquivo	Descrição
edtCD_CONTRATOLOCACAOKeyDown	UMFA001.pas	Busca (<F9>) na tabela TIPOCONTRATO
tabPARMFATURCD_CONTRATOLOCACAOValidate	UdmMFA001.pas	Valida código contra TIPOCONTRATO
tabLOCACAOTP_LOCACAOValidate	UdmMPD043.pas	Preenche CD_TIPOCONTRATO da locação com este parâmetro
btnGerarPedidoClick	UMPD043.pas	Busca layout de impressão do contrato via este parâmetro

Referências SQL diretas ao campo

Não foi encontrada referência direta ao campo CD_CONTRATOLOCACAO em scripts SQL (procedures/views do banco). O uso se dá exclusivamente via Delphi, através do carregamento dos parâmetros de PARMFATUR em memória.

Relação com outros parâmetros

Parâmetro	Configurado em	Relação
CD_CONTRATOVENDA	MFA001 — aba Locações	Usado quando TP_LOCACAO = 'V' (Venda) em vez de CD_CONTRATOLOCACAO
CD_TABLOCACAO	MFA001 — aba Locações	Tabela de preço padrão para locações