CD_TIPOLOCALREP — Tipo de Local de Armazenagem (Reprovado)

Tela de configuração: REC001 — Parâmetros da Recapadora Localização: Aba &Opção 1 → campo &Opção 1 (DBEdit20) Tabela: PARAMRECAP.CD_TIPOLOCALREP Tipo: DOM_INTEGER (inteiro, obrigatório) Valor padrão: Não definido (campo obrigatório — deve ser informado)

---

Finalidade

Define o Tipo de Local de Estoque utilizado para armazenar pneus reprovados no exame final da recapagem. O campo compõe a chave estrangeira junto com CD_LOCALREP, referenciando a tabela LOCALESTOQUE. É utilizado pelos scripts de geração e fechamento de ordem de produção para direcionar pneus reprovados ao estoque correto, bem como no cancelamento de estoque.

---

Campos envolvidos

Campo	Tabela	Tipo	Descrição
CD_TIPOLOCALREP	PARAMRECAP	DOM_INTEGER	Código do Tipo de Local para pneus reprovados
CD_LOCALREP	PARAMRECAP	DOM_INTEGER	Código do Local de Estoque para pneus reprovados (par complementar)
DS_TIPOLOCAL	TIPOLOCAL	String	Descrição do Tipo de Local (preenchida automaticamente pela validação)
DS_LOCAL	LOCALESTOQUE	String	Descrição do Local de Estoque (preenchida automaticamente)

Constraint de integridade

FK_PARAMRECA_LOCAL
  FOREIGN KEY (CD_LOCALREP, CD_TIPOLOCALREP)
  REFERENCES LOCALESTOQUE (CD_LOCAL, CD_TIPOLOCAL)
  ON UPDATE CASCADE

Os campos CD_TIPOLOCALREP e CD_LOCALREP devem existir juntos na tabela LOCALESTOQUE.

---

Comportamento na tela

Aspecto	Detalhe
Tipo de controle	DBEdit (campo de código numérico editável)
Obrigatório	Sim (Required = True)
Digitável	Sim — o usuário digita o código do Tipo de Local diretamente
Busca com <F9>	Pressionar <F9> no campo abre a tela de busca de Locais de Estoque (LOCAL). Ao selecionar, preenche automaticamente CD_TIPOLOCALREP, DS_TIPOLOCAL, CD_LOCALREP e DS_LOCAL
Validação OnValidate	Ao sair do campo, o sistema consulta TIPOLOCAL para verificar se o código existe e preenche a descrição

---

Opções disponíveis

Não existem opções de valores pré-definidos (dropdown/combobox) para este parâmetro. Trata-se de um campo numérico livre que aceita qualquer código de Tipo de Local cadastrado na tabela TIPOLOCAL.

---

Inserção manual do código

O que faz	Detalhe
Editável	O campo aceita digitação direta do código numérico
Exige	Código válido na tabela TIPOLOCAL
Par complementar	CD_LOCALREP deve ser informado em conjunto; CD_TIPOLOCALREP é pré-requisito para validar CD_LOCALREP

Simulação passo a passo

1. Acesse REC001 — Parâmetros da Recapadora.
2. Navegue até a aba &Opção 1.
3. No campo &Opção 1 (Tipo de Local Reprovado), digite um código existente em TIPOLOCAL (ex: 1).
4. Saia do campo (pressione <Tab>).
5. O sistema buscará a descrição em TIPOLOCAL e preencherá automaticamente o campo DS_TIPOLOCAL.
6. Se o código não existir, o sistema exibirá o erro: "O Tipo de Local de Armazenagem não está Cadastrado [TEQ002]!"
7. Em seguida, informe o campo CD_LOCALREP (Local de Armazenagem).
8. Salve o registro.

Resultado esperado: O tipo de local é validado contra TIPOLOCAL e sua descrição é exibida. O par (Tipo de Local + Local) será usado para direcionar pneus reprovados ao estoque correto.

Excecao / Importante: Se CD_TIPOLOCALREP estiver vazio e o usuário tentar informar CD_LOCALREP, o sistema bloqueará com o erro: "É Obrigatório informar o Tipo de Local para a Validação do Local de Armazenagem!" — ou seja, o Tipo de Local deve ser preenchido antes do Local.

---

Busca rápida com <F9>

O que faz	Detalhe
Editável	Abre a tela de busca de Locais de Estoque
Preenchimento automático	Ao selecionar um local na busca, todos os 4 campos são preenchidos de uma vez

Simulação passo a passo

1. Acesse REC001 — Parâmetros da Recapadora.
2. Navegue até a aba &Opção 1.
3. Posicione o cursor no campo &Opção 1 (Tipo de Local Reprovado).
4. Pressione <F9>.
5. A tela de busca de Locais de Estoque será aberta.
6. Selecione o local desejado (ex: "Depósito Reprovados").
7. Os campos CD_TIPOLOCALREP, DS_TIPOLOCAL, CD_LOCALREP e DS_LOCAL serão preenchidos automaticamente.
8. Salve o registro.

Resultado esperado: Os quatro campos (código e descrição do tipo de local e do local) são preenchidos de uma única vez pela busca, sem necessidade de digitação manual.

---

Regra de integridade e validações

Validação do Tipo de Local (OnValidate)

Ao informar o código no campo, o sistema executa:

• Consulta SELECT DS_TIPOLOCAL FROM TIPOLOCAL WHERE CD_TIPOLOCAL = <código>
• Se encontrado → preenche DS_TIPOLOCAL automaticamente
• Se não encontrado → exibe erro: "O Tipo de Local de Armazenagem não está Cadastrado [TEQ002]!"

Validação cruzada com CD_LOCALREP

O campo CD_LOCALREP (Local de Estoque) depende de CD_TIPOLOCALREP:

• Se CD_TIPOLOCALREP estiver vazio ao tentar validar CD_LOCALREP → erro: "É Obrigatório informar o Tipo de Local para a Validação do Local de Armazenagem!"
• O local é validado contra LOCALESTOQUE usando a combinação (CD_TIPOLOCAL, CD_LOCAL)

Uso nos scripts de processamento

Script	Condição	Uso de CD_TIPOLOCALREP
FECHA_ORDEMPRODUCAORECAP	Exame Final = 'R' (Reprovado)	Define o local de estoque para o pneu reprovado; insere associação em ITEMLOCAL; grava no item do pedido
FECHA_ORDEMPRODUCAORECAPNOTA	Exame Final = 'R' (Reprovado)	Mesma lógica de fechamento com nota fiscal
GERA_ORDEMPRODUCAORECAP	Exame Final = 'R' (Reprovado)	Define local de estoque ao gerar a ordem de produção
CANCELA_ESTOQUERECAP	Cancelamento tipo 'R'	Usa o local/tipolocal de reprovado para movimentação de cancelamento. Se vazio, exige preenchimento

Fluxo no fechamento da ordem de produção

1. O script FECHA_ORDEMPRODUCAORECAP lê CD_TIPOLOCALREP e CD_LOCALREP de PARAMRECAP para a empresa.
2. Se o status do exame final for 'R' (Reprovado) e CD_LOCALREP estiver nulo, o sistema exibe: "Informe o Local e TipoLocal de Armazenagem Para Exame Final com status de Reprovado! [REC001]".
3. Se preenchido, o script verifica se o serviço do pneu já está associado ao local em ITEMLOCAL. Se não estiver, insere a associação.
4. Ao gerar o pedido de saída do pneu reprovado, o item é criado com CD_TIPOLOCAL = CD_TIPOLOCALREP e CD_LOCAL = CD_LOCALREP.

---

Tabela Comparativa — Campos relacionados de Local/TipoLocal

Parâmetro	Destino	Script que utiliza
CD_TIPOLOCALREP + CD_LOCALREP	Pneus Reprovados	FECHA_ORDEMPRODUCAORECAP, GERA_ORDEMPRODUCAORECAP, CANCELA_ESTOQUERECAP
CD_TIPOLOCALRETR + CD_LOCALRETR	Pneus para Retrabalho	FECHA_ORDEMPRODUCAORECAP, GERA_ORDEMPRODUCAORECAP, CANCELA_ESTOQUERECAP
CD_TIPOLOCALAPROVADO + CD_LOCALAPROVADO	Pneus Aprovados	Scripts de fechamento/geração de ordem
CD_TIPOLOCALREMENT + CD_LOCALREMENT	Remessa de Entrada	Scripts de remessa
CDTIPOLOCALREMSAIDA + CDLOCALREMSAIDA	Remessa de Saída	Scripts de remessa

---

Procedures impactadas

Rotinas Delphi com referência direta

Rotina	Arquivo	Evidência
TdmREC001.qryCadastroCD_TIPOLOCALREPValidate	UdmREC001.pas	Valida o código contra TIPOLOCAL e preenche descrição
TdmREC001.qryCadastroCD_LOCALREPValidate	UdmREC001.pas	Verifica se CD_TIPOLOCALREP está preenchido antes de validar CD_LOCALREP
TframeREC001.edtCD_TIPOLOCALREPKeyDown	UframeREC001.pas	Trata <F9> para busca de local, preenchendo ambos os campos

Scripts SQL com referência direta ao campo

Procedure/Script	Arquivo
FECHA_ORDEMPRODUCAORECAP	Scripts/FECHA_ORDEMPRODUCAORECAP.sql
FECHA_ORDEMPRODUCAORECAPNOTA	Scripts/FECHA_ORDEMPRODUCAORECAPNOTA.sql
GERA_ORDEMPRODUCAORECAP	Scripts/GERA_ORDEMPRODUCAORECAP.sql
CANCELA_ESTOQUERECAP	Scripts/CANCELA_ESTOQUERECAP.sql

Candidatas por uso da tabela (sem referência direta ao campo)

Diversas procedures utilizam FROM PARAMRECAP mas não citam CD_TIPOLOCALREP diretamente. Não há impacto funcional direto identificado no código para essas rotinas. Exemplos: ATUALIZA_PEDIDONOTA, GERA_NOTAPEDIDO, GERA_PEDIDOENTRADACARCACA, entre outras.