ST_CONSIDERABLOQ - Considerar Quantidade Bloqueada no Estoque Comprometido

Tela de configuração: MEQ001 - Parâmetros de Estoque Localização: Aba &Estoque → Seção Estoque Comprometido Tabela: PARMESTOQUE.ST_CONSIDERABLOQ Tipo: CHAR(1) Valor padrão: S (Sim)

Visão Geral

Controla se a quantidade bloqueada (itens com status de bloqueio em pedidos) é incluída ou excluída do cálculo do estoque comprometido. Quando configurado como S, o sistema soma as quantidades bloqueadas ao comprometido, reduzindo o saldo disponível para novas vendas. Quando N, as quantidades bloqueadas são ignoradas no cálculo do comprometido.

O campo só fica visível na tela quando ST_COMPROMETIDO (configurado em MEQ001 — Parâmetros de Estoque, aba &Estoque) possuir valor diferente de N.

Telas Impactadas

Tela	Efeito
CEQ001 — Consulta de Estoque	Exibe saldo comprometido incluindo ou excluindo quantidades bloqueadas, conforme o parâmetro

Campos Envolvidos

Campo	Tabela	Observação
ST_CONSIDERABLOQ	PARMESTOQUE	Flag que determina se a quantidade bloqueada entra no comprometido
ST_BLOQUEIO	Estoques (consultado nos scripts)	Indica se o registro de estoque está bloqueado; é o campo avaliado quando ST_CONSIDERABLOQ = S
ST_COMPROMETIDO	PARMESTOQUE	Tipo de comprometimento; controla a visibilidade do combo

Opções Disponíveis

S - Sim (Considerar Quantidade Bloqueada)

O que faz	Detalhe
Comportamento	Inclui a quantidade bloqueada no cálculo do estoque comprometido
Efeito no saldo	Saldo comprometido = quantidade em pedidos + quantidade bloqueada
Campo editável	Sim, via combo na aba &Estoque
Pré-requisito	ST_COMPROMETIDO <> N

Simulação passo a passo

1. Acesse MEQ001 (Parâmetros de Estoque).
2. Na aba &Estoque, localize o combo "Considerar Bloqueio" (rótulo lblCONSIDERABLOQ).
3. Selecione "Sim" (S).
4. Salve o registro (<Ctrl+S> ou botão Salvar).
5. Acesse CEQ001 (Consulta de Estoque) e pesquise um produto que tenha pedidos com itens bloqueados.
6. Observe que o campo Estoque Comprometido inclui as quantidades bloqueadas no total.

Resultado esperado: O saldo comprometido exibido na consulta de estoque inclui tanto quantidades normais quanto bloqueadas em pedidos, reduzindo o saldo disponível para novas vendas.

Exceção / Importante: Quando ST_COMPROMETIDO = N (configurado em MEQ001 — Parâmetros de Estoque), o combo fica oculto e o sistema ignora este parâmetro, pois não há cálculo de estoque comprometido.

---

N - Não (Desconsiderar Quantidade Bloqueada)

O que faz	Detalhe
Comportamento	Exclui a quantidade bloqueada do cálculo do estoque comprometido
Efeito no saldo	Saldo comprometido = quantidade em pedidos (sem bloqueados); quantidade bloqueada é retornada separadamente em O_QT_BLOQUEADA
Campo editável	Sim, via combo na aba &Estoque
Pré-requisito	ST_COMPROMETIDO <> N

Simulação passo a passo

1. Acesse MEQ001 (Parâmetros de Estoque).
2. Na aba &Estoque, localize o combo "Considerar Bloqueio" (rótulo lblCONSIDERABLOQ).
3. Selecione "Não" (N).
4. Salve o registro (<Ctrl+S> ou botão Salvar).
5. Acesse CEQ001 (Consulta de Estoque) e pesquise um produto com pedidos possuindo itens bloqueados.
6. Observe que o campo Estoque Comprometido não contém as quantidades bloqueadas.

Resultado esperado: O saldo comprometido exibido não inclui quantidades bloqueadas, mantendo maior saldo disponível para novas vendas. A quantidade bloqueada é tratada separadamente no retorno das procedures.

Exceção / Importante: As quantidades bloqueadas ainda existem no sistema — a diferença é que não "consomem" estoque disponível para comprometimento.

Tabela Comparativa Resumida

Opção	Inclui bloqueio no comprometido	Saldo disponível	Uso típico
S (Sim)	✅ Sim	Menor (mais conservador)	Controle rigoroso; evita overselling
N (Não)	❌ Não	Maior (mais permissivo)	Permite vendas mesmo com bloqueios existentes

Exemplo Prático

Produto com 100 unidades em estoque, 30 unidades em pedidos (sendo 10 bloqueadas):

Configuração	Comprometido	Disponível
ST_CONSIDERABLOQ = S	30	70 (100 − 30)
ST_CONSIDERABLOQ = N	20	80 (100 − 20)

Com N, as 10 unidades bloqueadas não são contabilizadas como comprometidas, liberando mais estoque para novas vendas.

Procedures Impactadas

Rotinas Delphi com Referência Direta ao Campo

Rotina	Arquivo	Linha	Evidência
TfrmCEQ001.btnProcurarClick	source/CEQ001/UCEQ001.pas	866	Monta consulta SQL que lê PE.ST_CONSIDERABLOQ
TdmCEQ001.tabSALDOCalcFields	source/CEQ001/UdmCEQ001.pas	318	Calcula campos do saldo lendo PE.ST_CONSIDERABLOQ
TfrmMEQ001.cmbST_COMPROMETIDOChange	source/MEQ001/UMEQ001.pas	1757	Controla visibilidade do combo (oculta quando comprometido = N)
TdmMEQ001.tabPARMESTOQUEAfterInsert	source/MEQ001/UdmMEQ001.pas	286	Atribui valor padrão S ao inserir novo registro

Referências SQL Diretas ao Campo em Scripts/

Procedure/View	Arquivo	Comportamento
RETORNA_ESTOQUECOMPROMETIDO	Scripts/RETORNA_ESTOQUECOMPROMETIDO.sql	Se S: calcula saldo incluindo bloqueados; se N: separa O_QT_BLOQUEADA
RETORNA_ESTOQUECOMPROMETGRADE	Scripts/RETORNA_ESTOQUECOMPROMETGRADE.sql	Idem, para estoque por grade
RETORNA_ESTOQUECOMPROMETLOCAL	Scripts/RETORNA_ESTOQUECOMPROMETLOCAL.sql	Idem, para estoque por local
RETORNA_QTDECOMPROMETIDA	Scripts/RETORNA_QTDECOMPROMETIDA.sql	Se S: inclui bloqueio na quantidade comprometida
RETORNA_QTDEESTOQUEGRADE	Scripts/RETORNA_QTDEESTOQUEGRADE.sql	Se S: inclui bloqueio; se N: calcula sem bloqueio
RETORNA_SALDOCOMPROMETLOCAL	Scripts/RETORNA_SALDOCOMPROMETLOCAL.sql	Se S: inclui bloqueio no saldo local; se N: exclui
RETORNA_SALDOPRODUTOPEDIDO	Scripts/RETORNA_SALDOPRODUTOPEDIDO.sql	Consulta ST_CONSIDERABLOQ para determinar se retorna saldo com ou sem bloqueio

Candidatas por Uso da Tabela PARMESTOQUE

As procedures abaixo acessam a tabela PARMESTOQUE, mas não citam o campo ST_CONSIDERABLOQ nos scripts analisados. Não foram encontradas referências diretas adicionais ao campo além das listadas acima.