ST_VALIDAHISTORICO — Parâmetro de Validação de Histórico

Tela de configuração: REC001 — Parâmetros Recapadora Localização: Opção 1 → checkbox "Validar Histórico[MRC024/Produtos Adicionais]" Tabela / Coluna: PARAMRECAP.ST_VALIDAHISTORICO Tipo: CHAR(1) — S / N Valor padrão: N (Não obriga)

---

Telas impactadas

Tela	Descrição
MRC024	Produtos Adicionais — valida antes do post (tabPRODUTOSBeforePost)
UProdutoRecap (jRecapadora)	Tela genérica de produto da recapadora — valida antes do post (tabPRODUTORECAPBeforePost)

Campos envolvidos

Campo	Tabela	Observação
IDHISTORICO	Produtos / ProdutoRecap	Campo de histórico do produto. Obrigatório quando o parâmetro está ativo e um produto (IDITEM) já foi informado.

---

Opções disponíveis

S — Exigir Histórico nos Produtos Adicionais

O que faz	Detalhe
Obriga preenchimento	O campo Histórico (IDHISTORICO) torna-se obrigatório ao salvar um produto adicional nas telas MRC024 e UProdutoRecap
Quando valida	No evento BeforePost — ao tentar salvar/inserir o registro
Exceção	Na tela UProdutoRecap, a validação é ignorada quando o sistema está carregando a tela (AbrindoaTela = true)

Simulação passo a passo

1. Acesse REC001 → aba Opção 1.
2. Marque o checkbox Validar Histórico[MRC024/Produtos Adicionais].
3. Salve os parâmetros.
4. Acesse MRC024 (ou a tela de ProdutoRecap) e abra uma ordem de produção / pedido.
5. Na grade de Produtos Adicionais, insira um produto (informe o campo Produto/Item).
6. Deixe o campo Histórico (IDHISTORICO) em branco.
7. Tente salvar o registro.

Resultado esperado: O sistema exibe a mensagem "O Histórico deve ser Informado!" (MRC024) ou W-0205 (UProdutoRecap) e impede a gravação.

Exceção / Importante: Na tela UProdutoRecap, durante o carregamento inicial da tela (AbrindoaTela = true), a validação é ignorada para permitir a leitura de registros já existentes sem histórico.

---

N — Não Exigir Histórico (Padrão)

O que faz	Detalhe
Campo livre	O campo Histórico nos Produtos Adicionais torna-se opcional
Valor padrão	Este é o valor atribuído automaticamente ao inserir um novo registro de empresa

Simulação passo a passo

1. Acesse REC001 → aba Opção 1.
2. Certifique-se de que o checkbox Validar Histórico[MRC024/Produtos Adicionais] esteja desmarcado.
3. Salve os parâmetros.
4. Acesse MRC024, insira um produto adicional sem preencher o Histórico.
5. Salve o registro.

Resultado esperado: O sistema permite a gravação normalmente, sem exigir o preenchimento do Histórico.

---

Procedures impactadas

Rotinas Delphi com referência direta ao parâmetro

Rotina	Arquivo	Evidência
TdmMRC024.tabPRODUTOSBeforePost	source/MRC024/UdmMRC024.pas:429	ParamRecap.Values['ST_VALIDAHISTORICO'] = 'S' → levanta exceção "O Histórico deve ser Informado!" se IDHISTORICO vazio e IDITEM preenchido
TfrmProdutoRecap.tabPRODUTORECAPBeforePost	source/jRecapadora/UProdutoRecap.pas:423	ParamRecap.Values['ST_VALIDAHISTORICO'] = 'S' → levanta exceção W-0205 se IDHISTORICO vazio e AbrindoaTela = false
TdmREC001.qryCadastroAfterInsert	source/REC001/UdmREC001.pas:804	Define valor padrão 'N' se o campo estiver nulo ao inserir novo registro

Referências SQL diretas ao campo em Scripts/

Não foi encontrada referência direta a ST_VALIDAHISTORICO nos scripts SQL. O campo é lido em memória via Delphi (ParamRecap.Values).

Candidatas por uso da tabela PARAMRECAP

Diversas procedures SQL utilizam FROM PARAMRECAP / INNER JOIN PARAMRECAP, porém nenhuma consulta diretamente a coluna ST_VALIDAHISTORICO. Essas rotinas não são impactadas funcionalmente por este parâmetro.

---

Tabela Comparativa Resumida

Valor	Histórico obrigatório	Exceção
S	Sim, ao salvar produto adicional em MRC024 e UProdutoRecap	Ignorado durante carregamento da tela (AbrindoaTela = true)
N	Não	—