Tabela SHF (Necessidades por Filial) no Protheus: campos e índices

A tabela SHF do Protheus está descrita no dicionário (SX2) como “Necessidades por Filial”. Possui 8 campos e 1 índices e chave única HF_FILIAL+HF_FILNEC+HF_PRODUTO+DTOS(HF_DATA). Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código: SHF
Nome: Necessidades por Filial
Nome (inglês): Needs per Branch
Compartilhamento por filial: Compartilhado
Compartilhamento por unidade: Compartilhado
Compartilhamento por empresa: Compartilhado
Chave única: HF_FILIAL+HF_FILNEC+HF_PRODUTO+DTOS(HF_DATA)
Campos / índices: 8 / 1

Campos da tabela SHF (8)

Ordem	Campo	Tipo	Tam.	Dec.	Título	Descrição	Contexto
01	HF_FILIAL	C	2	0	Filial	Filial do Sistema	Real
02	HF_FILNEC	C	2	0	Filial	Código da Filial	Real
03	HF_PRODUTO	C	15	0	Produto	Código do produto	Real
04	HF_DATA	D	8	0	Data	Data da necessidade	Real
05	HF_SALDO	N	12	2	Sld Estoque	Saldo em estoque	Real
06	HF_ENTRADA	N	12	2	Entradas	Entradas na data	Real
07	HF_SAIDAS	N	12	2	Saidas	Saidas na data	Real
08	HF_NECESSI	N	12	2	Necessidade	Necessidade na data	Real

Tipo: C = caractere, N = numérico, D = data, L = lógico, M = memo.

Índices da tabela SHF (1)

Ordem	Chave	Descrição	Apelido
1	`HF_FILIAL+HF_FILNEC+HF_PRODUTO+DTOS(HF_DATA)`	Filial + Produto + Data

Perguntas frequentes sobre a tabela SHF

O que é a tabela SHF?

É a tabela “Necessidades por Filial” do ERP TOTVS Protheus, com 8 campos definidos no dicionário SX3.

Qual é a chave única da tabela SHF?

A chave única é HF_FILIAL+HF_FILNEC+HF_PRODUTO+DTOS(HF_DATA).

Quais são os índices da tabela SHF?

A tabela tem 1 índice. O principal (ordem 1) usa a chave HF_FILIAL+HF_FILNEC+HF_PRODUTO+DTOS(HF_DATA).

Qual é o nome físico da tabela SHF no banco de dados?

No banco, o nome é o código da tabela seguido do código da empresa (no dicionário de referência desta consulta: SHF990). Em ADVPL, use RetSqlName("SHF") para obter o nome correto do ambiente.

Exemplo de consulta SQL da tabela SHF

Modelo gerado a partir da estrutura da tabela. Ajuste os filtros ao seu cenário.

SELECT
    HF_FILIAL,
    HF_FILNEC,
    HF_PRODUTO,
    HF_DATA,
    HF_SALDO,
    HF_ENTRADA,
    HF_SAIDAS,
    HF_NECESSI
FROM SHF
WHERE
    D_E_L_E_T_ = ' '
    AND HF_FILIAL = 'VALOR'
    AND HF_FILNEC = 'VALOR'
    AND HF_PRODUTO = 'VALOR'
    AND HF_DATA BETWEEN '20261001' AND '20261031'
    AND HF_SALDO = 0
    AND HF_ENTRADA = 0
    AND HF_SAIDAS = 0
    AND HF_NECESSI = 0

Outras tabelas relacionadas

Dicionário Protheus · atualizado em 13/10/2026. Voltar ao índice do dicionário.