CD_LOCALAPROVADO — Local de Armazenagem Aprovado

Tela de configuração: REC001 — Parâmetros da Recapadora Localização: Aba &Opção 1, campo "&Opção 1" Tabela: PARAMRECAP.CD_LOCALAPROVADO Tipo: INTEGER (FK para LOCALESTOQUE) Valor padrão: Nulo (não há default automático)

---

Finalidade

Define o local de armazenagem para onde os pneus aprovados na recapagem são movidos ao encerrar a ordem de produção ou ao cancelar o estoque com tipo de cancelamento "Aprovado". Funciona em par com CD_TIPOLOCALAPROVADO — ambos devem estar preenchidos para que o sistema utilize o local configurado.

Quando ambos estão configurados, o sistema:

1. Verifica se o item (serviço de recapagem) pertence ao local via tabela ITEMLOCAL.
2. Se não pertence, insere automaticamente o vínculo ITEMLOCAL.
3. Utiliza o local para movimentações de estoque e geração de pedidos de faturamento.

---

Telas impactadas

Tela	Efeito
REC001 — Parâmetros da Recapadora	Campo de configuração direta

---

Campos envolvidos

Campo	Tabela	Relação
CD_LOCALAPROVADO	PARAMRECAP	Parâmetro principal
CD_TIPOLOCALAPROVADO	PARAMRECAP	Parâmetro complementar (obrigatório junto)
DS_LOCALAP	— (campo derivado no dataset)	Descrição do local, preenchida automaticamente via consulta a LOCALESTOQUE.DS_LOCAL

Constraint de integridade: FK_PARAMRECAP_LOCALAP — FOREIGN KEY (CD_LOCALAPROVADO, CD_TIPOLOCALAPROVADO) REFERENCES LOCALESTOQUE (CD_LOCAL, CD_TIPOLOCAL) ON UPDATE CASCADE.

---

Regras de validação

1. Obrigatório em par: Ao informar CD_LOCALAPROVADO sem preencher CD_TIPOLOCALAPROVADO, o sistema exibe: "É Obrigatório informar o Tipo de Local para a Validação do Local de Armazenagem!"
2. Existência no cadastro: O código digitado é consultado em LOCALESTOQUE combinando CD_TIPOLOCAL + CD_LOCAL. Se não encontrado: "O Local de Armazenagem não está Cadastrado ou não está Associado a este Tipo de Local [TEQ003]!"
3. Busca com <F9>: No campo de código, pressionar <F9> abre a tela de busca de Locais de Estoque. Ao selecionar, tanto o tipo de local quanto o local são preenchidos automaticamente (incluindo as descrições).

---

Opções disponíveis

Este parâmetro aceita qualquer código inteiro válido cadastrado na tabela LOCALESTOQUE, desde que acompanhado do respectivo CD_TIPOLOCALAPROVADO. Não há lista fixa de opções — a configuração depende dos locais de estoque cadastrados na tela TEQ003.

(Vazio) — Sem local definido

O que faz	Detalhe
Comportamento	Pneus aprovados NÃO recebem local de destino automático
Exige	Nada
Restrição	Cancelamentos do tipo "Aprovado" e fechamentos de ordem não aplicam movimentação de estoque no local aprovado

Simulação passo a passo

1. Acesse REC001 → aba &Opção 1.
2. Deixe os campos CD_TIPOLOCALAPROVADO e CD_LOCALAPROVADO em branco.
3. Salve os parâmetros.
4. Gere e feche uma ordem de produção de recapagem (FECHA_ORDEMPRODUCAORECAP).
5. O sistema buscará o primeiro local vinculado ao item em ITEMLOCAL como alternativa.

Resultado esperado: O sistema não utiliza local aprovado e recorre ao primeiro vínculo ITEMLOCAL disponível para o item. Se nenhum vínculo existir, a movimentação pode falhar ou não ser gerada.

Excecao / Importante: Na rotina CANCELA_ESTOQUERECAP, se o tipo de cancelamento for "Aprovado" (I_TP_CANCELAMENTO = 'A') e o local estiver nulo, o sistema exibe: "INFORME O LOCAL E TIPO DE LOCAL DE ARMAZENAGEM PARA APROVADA! [REC001]" e aborta a operação.

---

(Código válido) — Local de estoque para aprovados

O que faz	Detalhe
Comportamento	Move pneus aprovados para o local indicado ao encerrar ordem de produção
Exige	CD_TIPOLOCALAPROVADO também preenchido; local deve existir em LOCALESTOQUE
Restrição	Código deve corresponder a um CD_LOCAL válido no CD_TIPOLOCAL informado

Simulação passo a passo

1. Acesse REC001 → aba &Opção 1.
2. No campo Tipo de Local Aprovado (CD_TIPOLOCALAPROVADO), informe o código do tipo (ex: 1).
3. No campo Local Aprovado (CD_LOCALAPROVADO), informe o código do local (ex: 5). Ou pressione <F9> para buscar.
4. O sistema valida contra LOCALESTOQUE e preenche a descrição automaticamente.
5. Salve os parâmetros.
6. Gere uma ordem de produção de recapagem (GERA_ORDEMPRODUCAORECAP).
7. No fechamento da ordem (FECHA_ORDEMPRODUCAORECAP), o sistema:
   • Verifica se o serviço de pneu pertence ao local via ITEMLOCAL.
   • Se não pertence, insere o vínculo (ST_ESTOQUE = 'N', ST_FATURAMENTO = 'S').
   • Cria o item do pedido de faturamento com CD_TIPOLOCAL e CD_LOCAL apontando para o local aprovado.

Resultado esperado: O pneu aprovado é vinculado ao local de estoque configurado, o pedido de venda é gerado com o item associado a esse local, e a movimentação de estoque aponta para o local correto.

Excecao / Importante: Ao cancelar estoque com tipo "Aprovado" (CANCELA_ESTOQUERECAP), o sistema utiliza CD_LOCALAPROVADO como destino da operação de estoque inversa, revertendo a movimentação para o mesmo local.

---

Regra Geral

Aspecto	Comportamento
Obrigatório?	Não obrigatório para salvar os parâmetros, mas necessário para movimentações automáticas de pneus aprovados
Depende de	CD_TIPOLOCALAPROVADO deve estar preenchido
Validado contra	LOCALESTOQUE(CD_TIPOLOCAL, CD_LOCAL)
Utilizado em	Fechamento de ordem de produção, geração de pedido de venda, cancelamento de estoque (tipo Aprovado), inserção de consertos
Vinculação automática	Se o item não pertence ao local em ITEMLOCAL, o vínculo é criado automaticamente no fechamento da ordem

---

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	O que faz
TdmREC001.qryCadastroCD_LOCALAPROVADOValidate	UdmREC001.pas	Valida existência do local em LOCALESTOQUE e preenche descrição
TframeREC001.edtCD_LOCALAPROVADOKeyDown	UframeREC001.pas	Trata <F9> para busca de local; preenche tipo + local + descrições
TframeREC001.edtCD_TIPOLOCALAPROVADOKeyDown	UframeREC001.pas	Busca que também preenche CD_LOCALAPROVADO ao selecionar pelo tipo

Referências SQL diretas ao campo em Scripts/

Procedure/Script	Arquivo	O que faz
FECHA_ORDEMPRODUCAORECAP	Scripts/FECHA_ORDEMPRODUCAORECAP.sql	No fechamento: vincula item ao local aprovado em ITEMLOCAL, usa no pedido de venda (ITEMPEDIDO.CD_TIPOLOCAL/CD_LOCAL)
CANCELA_ESTOQUERECAP	Scripts/CANCELA_ESTOQUERECAP.sql	Valida se local está preenchido para cancelamento tipo "Aprovado"; utiliza como destino da operação de estoque
GERA_ORDEMPRODUCAORECAP	Scripts/GERA_ORDEMPRODUCAORECAP.sql	Na geração da ordem: vincula item ao local aprovado em ITEMLOCAL se ambos os campos estiverem preenchidos
FECHA_ORDEMPRODUCAORECAPNOTA	Scripts/FECHA_ORDEMPRODUCAORECAPNOTA.sql	Leitura do parâmetro para uso no fechamento com nota
INSERE_CONSERTOSPNEU	Scripts/INSERE_CONSERTOSPNEU.sql	Recebe CD_LOCALAPROVADO como parâmetro para vinculação de consertos ao local

---

Scripts e tabelas relacionados

• LOCALESTOQUE — Cadastro de locais de estoque (destino da FK)
• ITEMLOCAL — Vínculo item × local, criado automaticamente pelo sistema quando necessário
• ITEMPEDIDO — Pedido de faturamento gerado com CD_TIPOLOCAL e CD_LOCAL do local aprovado