STSUGEREQTDEPRODADIC — Sugerir Quantidade do Produto Adicional

Tela de configuração: REC001 — Parâmetros de Recapadora Tabela: PARAMRECAP.STSUGEREQTDEPRODADIC Tipo: CHAR(1) — Checkbox (S/N) Valor padrão: S

---

Resumo

Controla se o sistema deve preencher automaticamente a quantidade dos produtos adicionais importados para a Ordem de Produção de Recapagem. A regra de negócio se aplica de forma diferente para produtos que controlam balança versus os que não controlam.

---

Telas impactadas

Tela	Descrição do impacto
REC001 (Parâmetros de Recapadora)	Checkbox "Sugerir Qtde para o produto adicional que controla balança"
Formulário de Produto Recap (TfrmProdutoRecap)	Ao importar produtos adicionais para a etapa de produção, a quantidade sugerida varia conforme este parâmetro

---

Campos envolvidos

Campo	Tabela	Tipo	Descrição
STSUGEREQTDEPRODADIC	PARAMRECAP	CHAR(1)	Flag que ativa/desativa a sugestão automática de quantidade

Campos correlacionados consultados na lógica:

Campo	Tabela	Descrição
CD_BALANCA	ITEM	Indica se o produto controla balança (vazio = não controla)
QTITEMCONVERSAO	PRODUTORECAPETAPA / SERVPRODADICIONAL	Quantidade baseada em conversão do serviço
QTITEMFIXA	PRODUTORECAPETAPA / SERVPRODADICIONAL	Quantidade fixa cadastrada para o produto adicional

---

Opções disponíveis

O que faz	Detalhe
S — Sugere quantidade	O sistema preenche automaticamente a quantidade do produto adicional com base em QTITEMCONVERSAO × resultado ou QTITEMFIXA, incluindo produtos que controlam balança.
N — Não sugere para balança	O sistema sugere quantidade apenas para produtos que não controlam balança (CD_BALANCA vazio). Produtos com balança ficam com a quantidade em branco.

---

S — Sempre Sugerir Quantidade (padrão)

Simulação passo a passo

1. Acesse REC001 — Parâmetros de Recapadora.
2. Marque o checkbox "Sugerir Qtde para o produto adicional que controla balança".
3. Salve o parâmetro.
4. Abra uma Ordem de Produção de Recapagem e avance até uma etapa que tenha produtos adicionais cadastrados em SERVPRODADICIONAL.
5. O sistema importa os produtos adicionais automaticamente.
6. Todos os produtos adicionais terão a quantidade sugerida automaticamente — mesmo aqueles cujo item possui CD_BALANCA preenchido (controla balança).
7. Se existir QTITEMCONVERSAO, o sistema calcula QTITEMCONVERSAO × resultado do serviço.
8. Se existir apenas QTITEMFIXA, o sistema usa esse valor diretamente.

Resultado esperado: Todos os produtos adicionais importados para a etapa já aparecem com quantidade preenchida. O operador pode ajustar manualmente se necessário.

---

N — Não Sugerir Quantidade para Produtos com Balança

Simulação passo a passo

1. Acesse REC001 — Parâmetros de Recapadora.
2. Desmarque o checkbox "Sugerir Qtde para o produto adicional que controla balança".
3. Salve o parâmetro.
4. Abra uma Ordem de Produção de Recapagem e avance até uma etapa com produtos adicionais.
5. Ao importar os produtos adicionais:
   • Produtos sem balança (CD_BALANCA vazio): a quantidade continua sendo sugerida automaticamente (mesma lógica de conversão/fixa).
   • Produtos com balança (CD_BALANCA preenchido): o campo de quantidade fica em branco, aguardando que o operador informe o valor manualmente (tipicamente a leitura direta da balança).

Resultado esperado: Produtos adicionais que controlam balança ficam sem quantidade sugerida — o operador deve pesar o produto e digitar a quantidade. Os demais produtos continuam com sugestão automática.

Excecao / Importante: Quando STSUGEREQTDEPRODADIC = 'N', a restrição afeta apenas itens que possuem CD_BALANCA preenchido. Itens sem código de balança continuam recebendo sugestão normal de quantidade, independentemente deste parâmetro.

---

Regra de Negócio — Tabela Comparativa

Condição	CD_BALANCA vazio (sem balança)	CD_BALANCA preenchido (com balança)
STSUGEREQTDEPRODADIC = S	Sugere quantidade ✓	Sugere quantidade ✓
STSUGEREQTDEPRODADIC = N	Sugere quantidade ✓	Quantidade em branco — aguarda digitação manual

---

Parâmetro relacionado

Parâmetro	Descrição	Observação
STREMOVEPRODADICREC	Remove produto adicional da recapagem	Coluna adjacente na tabela PARAMRECAP. Quando S, os produtos adicionais são removidos durante o processo de recapagem. Documentar separadamente.

---

Procedures impactadas

Rotinas Delphi com referência direta ao parâmetro

Rotina	Arquivo	Linha	Trecho relevante
TdmREC001.qryCadastroAfterInsert	UdmREC001.pas	969	Define valor padrão 'S' quando o registro é inserido
chkSTSUGEREQTDEPRODADICMouseMove	UframeREC001.pas	2346	Handler do tooltip do checkbox na tela de parâmetros
TfrmProdutoRecap.FormShow	UProdutoRecap.pas	314	Lógica principal: verifica o parâmetro para decidir se sugere quantidade ao importar produtos adicionais

Referências SQL diretas ao campo

Nenhuma referência SQL direta a STSUGEREQTDEPRODADIC foi encontrada em Scripts/. O campo é consultado em tempo de execução via ParamRecap.Values['STSUGEREQTDEPRODADIC'] no Delphi.

Candidatas por uso da tabela PARAMRECAP

As procedures abaixo acessam a tabela PARAMRECAP mas não citam o campo STSUGEREQTDEPRODADIC diretamente. Não há impacto funcional direto confirmado para este parâmetro:

<details> <summary>Procedures que fazem JOIN em PARAMRECAP (expandir)</summary>

• ATUALIZA_PEDIDONOTA — Scripts/ATUALIZA_PEDIDONOTA.sql
• ATUALIZA_PREVISAOORDEMPROD — Scripts/ATUALIZA_PREVISAOORDEMPROD.sql
• ATUALIZA_STFATURAAUTO — Scripts/ATUALIZA_STFATURAAUTO.sql
• ATUALIZA_TIPOPESSOARECAP — Scripts/ATUALIZA_TIPOPESSOARECAP.sql
• CANCELA_ESTOQUERECAP — Scripts/CANCELA_ESTOQUERECAP.sql
• CANCELA_NOTAFISCAL — Scripts/CANCELA_NOTAFISCAL.sql
• CONFIRMA_PNEURECUSADO — Scripts/CONFIRMA_PNEURECUSADO.sql
• EXCLUSAO_BANDA — Scripts/EXCLUSAO_BANDA.sql
• FECHA_ORDEMPRODUCAORECAP — Scripts/FECHA_ORDEMPRODUCAORECAP.sql
• FECHA_ORDEMPRODUCAORECAPNOTA — Scripts/FECHA_ORDEMPRODUCAORECAPNOTA.sql
• GERA_NOTAPEDIDO — Scripts/GERA_NOTAPEDIDO.sql
• GERA_ORDEMPRODUCAORECAP — Scripts/GERA_ORDEMPRODUCAORECAP.sql
• GERA_PEDIDOENTRADACARCACA — Scripts/GERA_PEDIDOENTRADACARCACA.sql
• GERA_PEDIDOSAIDACARCACA — Scripts/GERA_PEDIDOSAIDACARCACA.sql
• GERA_PRODACABAMENTO — Scripts/GERA_PRODACABAMENTO.sql
• GERA_PRODAPLICACAOCOLA — Scripts/GERA_PRODAPLICACAOCOLA.sql
• GERA_PRODAPLICACAOCONSERTO — Scripts/GERA_PRODAPLICACAOCONSERTO.sql
• GERA_PRODBANDA — Scripts/GERA_PRODBANDA.sql
• GERA_PRODCONFERENCIAPNEU — Scripts/GERA_PRODCONFERENCIAPNEU.sql
• GERA_PRODDESENVELOPAMENTO — Scripts/GERA_PRODDESENVELOPAMENTO.sql

</details>