Tabela HL4 no Protheus

A tabela HL4 do Protheus está descrita no dicionário (SX2) como “Tabela Fato de Vendas”. Possui 57 campos e 1 índices e chave única HL4_FILIAL+HL4_CFOP+HL4_FAMMAT+HL4_PRDUTO+HL4_PEDIDO+HL4_REGIAO+HL4_MOEDA+HL4_CANALV+HL4_MICREG+HL4_NATOPR+HL4_GRPCLI+HL4_TRARED+HL4_STCRED+HL4_LINPRO+HL4_ISTCIA. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código

HL4

Nome

Tabela Fato de Vendas

Nome (inglês)

Sales Fact Table

Compartilhamento por filial

Compartilhado

Compartilhamento por unidade

Compartilhado

Compartilhamento por empresa

Compartilhado

Chave única

HL4_FILIAL+HL4_CFOP+HL4_FAMMAT+HL4_PRDUTO+HL4_PEDIDO+HL4_REGIAO+HL4_MOEDA+HL4_CANALV+HL4_MICREG+HL4_NATOPR+HL4_GRPCLI+HL4_TRARED+HL4_STCRED+HL4_LINPRO+HL4_ISTCIA

Campos / índices

57 / 1

Perguntas frequentes sobre a tabela HL4

O que é a tabela HL4?

É a tabela “Tabela Fato de Vendas” do ERP TOTVS Protheus, com 57 campos definidos no dicionário SX3.

Qual é a chave única da tabela HL4?

A chave única é HL4_FILIAL+HL4_CFOP+HL4_FAMMAT+HL4_PRDUTO+HL4_PEDIDO+HL4_REGIAO+HL4_MOEDA+HL4_CANALV+HL4_MICREG+HL4_NATOPR+HL4_GRPCLI+HL4_TRARED+HL4_STCRED+HL4_LINPRO+HL4_ISTCIA.

Quais são os índices da tabela HL4?

A tabela tem 1 índice. O principal (ordem 1) usa a chave HL4_FILIAL+HL4_TRANSP+HL4_REPRES+HL4_NATOPR+HL4_CFOP+HL4_ITEM+HL4_FAMCOM+HL4_FAMMAT+HL4_GRPEST+HL4_CONDPG+HL4_GRPCLI+HL4_CLIENT+HL4_MOEDA+DTOS(HL4_DATA).

Qual é o nome físico da tabela HL4 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: HL4990). Em ADVPL, use RetSqlName("HL4") para obter o nome correto do ambiente.

Exemplo de consulta SQL da tabela HL4

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

SELECT
    HL4_LINPRO,
    HL4_ISTCIA,
    HL4_EMPRES,
    HL4_FILIAL,
    HL4_ESTABL,
    HL4_TRANSP,
    HL4_REPRES,
    HL4_NATOPR,
    HL4_CFOP,
    HL4_ITEM,
    HL4_FAMCOM,
    HL4_FAMMAT,
    HL4_GRPEST,
    HL4_PRDUTO,
    HL4_CONDPG,
    HL4_PEDIDO,
    HL4_GRPCLI,
    HL4_CLIENT,
    HL4_REGIAO,
    HL4_MOEDA,
    HL4_STCRED,
    HL4_UNDNEG,
    HL4_DATA,
    HL4_DTENTR,
    HL4_DTIMPL,
    HL4_VVENDA,
    HL4_QVENDA,
    HL4_VIMPVD,
    HL4_VVMERC,
    HL4_VVNDLQ,
    HL4_QVENFC,
    HL4_QVENFM,
    HL4_CANALV,
    HL4_REGCOM,
    HL4_MICREG,
    HL4_ROTA,
    HL4_TABPCO,
    HL4_REFER,
    HL4_NMITVD,
    HL4_VLDESV,
    HL4_NMPRIO,
    HL4_TRARED,
    HL4_STPEDV,
    HL4_STITPV,
    HL4_TPCPIT,
    HL4_LIVRE0,
    HL4_LIVRE1,
    HL4_LIVRE2,
    HL4_LIVRE3,
    HL4_LIVRE4,
    HL4_LIVRE5,
    HL4_LIVRE6,
    HL4_LIVRE7,
    HL4_LIVRE8,
    HL4_LIVRE9,
    HL4_UNITEM,
    HL4_VIPNIN
FROM HL4
WHERE
    D_E_L_E_T_ = ' '
    AND HL4_LINPRO = 'VALOR'
    AND HL4_ISTCIA = 'VALOR'
    AND HL4_EMPRES = 'VALOR'
    AND HL4_FILIAL = 'VALOR'
    AND HL4_ESTABL = 'VALOR'
    AND HL4_TRANSP = 'VALOR'
    AND HL4_REPRES = 'VALOR'
    AND HL4_NATOPR = 'VALOR'
    AND HL4_CFOP = 'VALOR'
    AND HL4_ITEM = 'VALOR'
    AND HL4_FAMCOM = 'VALOR'
    AND HL4_FAMMAT = 'VALOR'
    AND HL4_GRPEST = 'VALOR'
    AND HL4_PRDUTO = 'VALOR'
    AND HL4_CONDPG = 'VALOR'
    AND HL4_PEDIDO = 'VALOR'
    AND HL4_GRPCLI = 'VALOR'
    AND HL4_CLIENT = 'VALOR'
    AND HL4_REGIAO = 'VALOR'
    AND HL4_MOEDA = 'VALOR'
    AND HL4_STCRED = 'VALOR'
    AND HL4_UNDNEG = 'VALOR'
    AND HL4_DATA BETWEEN '20261001' AND '20261031'
    AND HL4_DTENTR BETWEEN '20261001' AND '20261031'
    AND HL4_DTIMPL BETWEEN '20261001' AND '20261031'
    AND HL4_VVENDA = 0
    AND HL4_QVENDA = 0
    AND HL4_VIMPVD = 0
    AND HL4_VVMERC = 0
    AND HL4_VVNDLQ = 0
    AND HL4_QVENFC = 0
    AND HL4_QVENFM = 0
    AND HL4_CANALV = 'VALOR'
    AND HL4_REGCOM = 'VALOR'
    AND HL4_MICREG = 'VALOR'
    AND HL4_ROTA = 'VALOR'
    AND HL4_TABPCO = 'VALOR'
    AND HL4_REFER = 'VALOR'
    AND HL4_NMITVD = 'VALOR'
    AND HL4_VLDESV = 0
    AND HL4_NMPRIO = 0
    AND HL4_TRARED = 'VALOR'
    AND HL4_STPEDV = 'VALOR'
    AND HL4_STITPV = 'VALOR'
    AND HL4_TPCPIT = 'VALOR'
    AND HL4_LIVRE0 = 0
    AND HL4_LIVRE1 = 0
    AND HL4_LIVRE2 = 0
    AND HL4_LIVRE3 = 0
    AND HL4_LIVRE4 = 0
    AND HL4_LIVRE5 BETWEEN '20261001' AND '20261031'
    AND HL4_LIVRE6 BETWEEN '20261001' AND '20261031'
    AND HL4_LIVRE7 BETWEEN '20261001' AND '20261031'
    AND HL4_LIVRE8 = 'VALOR'
    AND HL4_LIVRE9 = 'VALOR'
    AND HL4_UNITEM = 'VALOR'
    AND HL4_VIPNIN = 0

Outras tabelas relacionadas

• HL0 Tabela Fato Avaliação Crédito
• HL1 Tabela Fato Previsão de Vendas
• HL2 Tabela Fato de Faturamento
• HL3 Tabela Fato Carteira de Vendas
• HL5 Tabela Fato Cotas de Vendas
• HL6 Tabela Fato Devolução Vendas
• HL7 Tabela Fato Entregas de Vendas
• HL8 Fluxo de Caixa Realizado
• HL9 Gestão Contábil e Orçamentária
• HLA Indicadores Economicos Finance
• HLC Gestão Contábil e Orçamentária
• HLD Contas a Pagar - Vencimento

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