ST_VENDARESTRITA - Vendas Restritas no Saldo

Tela de configuração: MEQ001 - Parâmetros de Estoque Localização: Aba &Estoque Tabela: PARMESTOQUE.ST_VENDARESTRITA Tipo: Combobox (S / N) Valor padrão: S (Sim)

Resumo

Controla se pedidos de venda marcados como restritos (ST_RESTRITO = 'S' no pedido) devem ser descontados do saldo disponível de estoque na tela de Consulta de Estoque (CEQ001).

• S (Sim): Vendas restritas são consideradas no cálculo do saldo disponível. A quantidade comprometida por pedidos restritos já está embutida no saldo.
• N (Não): Vendas restritas não são consideradas no saldo. Uma coluna extra "Qt Restrita" é exibida no grid para que o usuário visualize quanto do estoque está comprometido por pedidos restritos, e essa quantidade é subtraída do total de vendas antes de calcular o saldo final.

Telas impactadas

Tela	Efeito
CEQ001 (Consulta de Estoque)	Controla visibilidade da coluna 5 do grid SALDO e o cálculo da quantidade restrita no tabSALDOCalcFields.

Campos envolvidos

Campo	Tabela	Observação
ST_VENDARESTRITA	PARMESTOQUE	Campo principal do parâmetro
QT_RESTRITA	Grid SALDO (CEQ001)	Campo calculado — exibido somente quando ST_VENDARESTRITA = 'N'
QTDEVENDA	Grid SALDO (CEQ001)	Reduzido pela quantidade restrita quando ST_VENDARESTRITA = 'N'

Condição de visibilidade

O campo cmbST_VENDARESTRITA na tela MEQ001 só fica visível quando o parâmetro ST_COMPROMETIDO (PARMESTOQUE.ST_COMPROMETIDO, configurado em MEQ001 — Parâmetros de Estoque, aba &Estoque) possuir valor diferente de N. Quando ST_COMPROMETIDO = 'N', o campo e seu rótulo ficam ocultos.

Opções disponíveis

S - Vendas Restritas Incluídas no Saldo (Padrão)

O que faz	Detalhe
Comportamento	Vendas restritas já estão embutidas no saldo disponível
Campo visível	Coluna "Qt Restrita" oculta no grid de Consulta de Estoque
Cálculo	Saldo = Estoque + Compras − Vendas (incluindo restritas)

Simulação passo a passo

1. Acesse MEQ001 (Parâmetros de Estoque).
2. Na aba &Estoque, localize o campo "Venda Restrita".
3. Selecione "Sim" no combobox.
4. Salve o registro.
5. Acesse CEQ001 (Consulta de Estoque).
6. Pesquise um produto que tenha pedidos de venda com ST_RESTRITO = 'S'.
7. Observe que a coluna de quantidade restrita não aparece no grid de saldo.
8. O saldo disponível já contempla todas as vendas (restritas e normais).

Resultado esperado: O saldo exibido no grid já inclui as vendas restritas no comprometimento. Não há distinção visual entre vendas normais e restritas.

---

N - Vendas Restritas Separadas do Saldo

O que faz	Detalhe
Comportamento	Vendas restritas são calculadas separadamente e exibidas em coluna própria
Campo visível	Coluna "Qt Restrita" visível no grid de Consulta de Estoque
Cálculo	Qt Restrita = soma de PS_PEDIDO/QT_PEDIDA de pedidos com ST_RESTRITO = 'S'; Saldo = Estoque + Compras − (Vendas − Restritas)

Simulação passo a passo

1. Acesse MEQ001 (Parâmetros de Estoque).
2. Na aba &Estoque, localize o campo "Venda Restrita".
3. Selecione "Não" no combobox.
4. Salve o registro.
5. Acesse CEQ001 (Consulta de Estoque).
6. Pesquise um produto que tenha pedidos de venda com ST_RESTRITO = 'S' (por exemplo, um pedido especial ou aguardando aprovação).
7. Observe que a coluna 5 do grid ("Qt Restrita") agora está visível, mostrando a quantidade comprometida por pedidos restritos.
8. Verifique que o saldo disponível é calculado como: Estoque + Compras − (Vendas − Restritas).

Resultado esperado: A quantidade comprometida por pedidos restritos é exibida em coluna separada. O saldo final desconta apenas as vendas não restritas, efetivamente "liberando" a quantidade restrita para o saldo disponível. Isso permite que o usuário visualize quanto estoque está retido por vendas especiais vs. vendas normais.

Excecao / Importante: A quantidade restrita é calculada apenas para pedidos de venda (TP_PEDIDO = 'S'), com status ST_RESTRITO = 'S' e que não estejam cancelados ou bloqueados (ST_PEDIDO NOT IN ('B', 'C')), e que possuam movimentação vinculada (CD_OPERACAO IS NOT NULL). A visibilidade do campo na tela MEQ001 depende de ST_COMPROMETIDO estar habilitado (valor diferente de N).

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Evidência
iniciar	source/CEQ001/UCEQ001.pas	261	Controla visibilidade da coluna 5 do grid SALDO
TfrmCEQ001.btnProcurarClick	source/CEQ001/UCEQ001.pas	853	Consulta ST_VENDARESTRITA para definir visibilidade da coluna
TdmCEQ001.tabSALDOCalcFields	source/CEQ001/UdmCEQ001.pas	271	Calcula QT_RESTRITA e ajusta QTDEVENDA quando valor é N
TfrmMEQ001.cmbST_COMPROMETIDOChange	source/MEQ001/UMEQ001.pas	1759	Controla visibilidade do campo na tela de configuração

Referências SQL diretas ao campo

Não foram encontradas referências diretas ao campo ST_VENDARESTRITA em procedures/Scripts SQL. O campo é consultado apenas via Delphi (ExecutaConsulta em runtime).

Candidatas por uso da tabela

As procedures abaixo acessam a tabela PARMESTOQUE mas não referenciam o campo ST_VENDARESTRITA diretamente. Não há impacto funcional direto identificado para este parâmetro nessas rotinas.

Exemplos: GERA_ESTOQUE, GERA_ESTOQUE_NOTAFISCAL, CANCELA_ESTOQUE, CONFIRMA_ORDEMSERVICO, entre outras.