Especialistas em TOTVS Protheus, BI e Automação de Processos
Dicionário Protheus · SX2

Tabela HL2 no Protheus

Tabela Fato de Faturamento

A tabela HL2 do Protheus está descrita no dicionário (SX2) como “Tabela Fato de Faturamento”. Possui 95 campos e 1 índices e chave única HL2_FILIAL+HL2_FAMMAT+HL2_CFOP+HL2_REGIAO+HL2_MOEDA+DTOS(HL2_DATA)+HL2_PRDUTO+HL2_TABPCO+HL2_CANALV+HL2_ROTA+HL2_MICREG+HL2_TRARED+HL2_NATOPR+HL2_GRPCLI. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código
HL2
Nome
Tabela Fato de Faturamento
Nome (inglês)
Table Invoicing Fact
Compartilhamento por filial
Compartilhado
Compartilhamento por unidade
Compartilhado
Compartilhamento por empresa
Compartilhado
Chave única
HL2_FILIAL+HL2_FAMMAT+HL2_CFOP+HL2_REGIAO+HL2_MOEDA+DTOS(HL2_DATA)+HL2_PRDUTO+HL2_TABPCO+HL2_CANALV+HL2_ROTA+HL2_MICREG+HL2_TRARED+HL2_NATOPR+HL2_GRPCLI
Campos / índices
95 / 1

Campos da tabela HL2 (95)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 HL2_LINPRO C 2 0 Linha Produt Linha de Produto Real
02 HL2_ISTCIA C 2 0 Instância Instância da Instalação Real
03 HL2_EMPRES C 32 0 Empresa Empresa do Sistema Real
04 HL2_FILIAL C 2 0 Filial Filial do Sistema Real
05 HL2_ESTABL C 32 0 Estabelecim. Estabelecimento Real
06 HL2_ITEM C 32 0 Item Produto Item de Produto Real
07 HL2_FAMCOM C 32 0 Famil Comerc Familia Comercial Real
08 HL2_FAMMAT C 32 0 Famil Mater Familia Material Real
09 HL2_GRPEST C 32 0 Grp Estoque Grupo de Estoque Real
10 HL2_PRDUTO C 32 0 Produto Produto Real
11 HL2_REPRES C 32 0 Representant Representante/Vendedor Real
12 HL2_TRANSP C 32 0 Transportado Transportadora Real
13 HL2_NATOPR C 32 0 Natur. Oper. Natureza da Operação Real
14 HL2_CFOP C 32 0 CFOP Cód Fiscal Operac Prestac Real
15 HL2_GRPCLI C 32 0 Grp Cliente Grupo de Cliente Real
16 HL2_CLIENT C 32 0 Cliente Cliente Real
17 HL2_REGIAO C 32 0 Regiao Geogr Região Geográfica Real
18 HL2_MOEDA C 32 0 Moeda Moeda Real
19 HL2_CONDPG C 32 0 Condcao Pgto Condição de Pagamento Real
20 HL2_UNDNEG C 32 0 Unidad Negoc Unidade de Negocio Real
21 HL2_DATA D 8 0 Data Periodo Data do Periodo Real
22 HL2_SERNF C 8 0 Série NF Série da Nota Fiscal Real
23 HL2_NUMNF C 35 0 Nota Fiscal Número da Nota Fiscal Real
24 HL2_VFATOT N 16 2 Fatur. Total Valor Faturamento Total Real
25 HL2_VCMFAT N 16 2 Comissao Fat Valor Comissão Faturament Real
26 HL2_VLCSFT N 16 2 Custo Fatur. Valor Custo Faturamento Real
27 HL2_VICMSF N 16 2 ICMS Faturam ICMS do Faturamento Real
28 HL2_VIPIFT N 16 2 IPI Faturam. Valor IPI Faturamento Real
29 HL2_VRECFI N 16 2 Receit Finc Receita Financeira Real
30 HL2_VFRTNF N 16 2 Frete NF Valor Frete NF Real
31 HL2_VDESPE N 16 2 Despesas Valor das Despesas Real
32 HL2_VFATME N 16 2 Fatur. Merc. Faturamento Mercadoria Real
33 HL2_VFATLQ N 16 2 Fatur. Liqud Faturmaneto Líquido Real
34 HL2_VPISFT N 16 2 PIS Faturam. PIS do Faturamento Real
35 HL2_VCOFIN N 16 2 COFINS Fatur COFINS do Faturamento Real
36 HL2_QFATIT N 16 2 Qtde Item Qtde de Item Faturada Real
37 HL2_VISSFT N 16 2 ISS Faturam. ISS do Faturamento Real
38 HL2_PEDIDO C 12 0 Num. Pedido Num. Pedido Real
39 HL2_QFATFC N 16 4 Qtde. Fat. Qtde. Fat. Fam. Com. Real
40 HL2_QFATFM N 16 4 Qtde. Fat. Qtde. Fat. Fam. Mat. Real
41 HL2_TABPCO C 32 0 Tab.de Preço Tabela de Preço Real
42 HL2_CANALV C 32 0 Canal de Ven Canal de Venda Real
43 HL2_ROTA C 32 0 Rota Rota Real
44 HL2_REGCOM C 32 0 Região Com Região Comercial Real
45 HL2_MICREG C 32 0 Microrregião Microrregião Real
46 HL2_REFER C 32 0 Referência Referência Real
47 HL2_NMITNF C 10 0 Número Item Número do Item Real
48 HL2_VICMSS N 16 2 Vl ICMS Subs Vl ICMS Subst Faturamento Real
49 HL2_VLDESF N 16 2 Vl Desconto Vl Desconto Faturamento Real
50 HL2_VLIRFF N 16 2 Vl IRF Fatur Vl IRF Faturamento Real
51 HL2_VINSSF N 16 2 Vl INSS Fatu Vl INSS Faturamento Real
52 HL2_FGERDP C 1 0 Itm Gera Dup Item Gera Duplicata? Real
53 HL2_DTSANF D 8 0 Dat Saída NF Data de Saída da NF Real
54 HL2_QPRZDP N 16 4 Qtde Prazo D Qtde Prazo Duplicata Real
55 HL2_TPFRET C 3 0 Tipo de Fret Tipo de Frete Real
56 HL2_TPNOTA C 20 0 Tipo de Nota Tipo de Nota Fiscal Real
57 HL2_QTPESL N 16 4 Peso Liquido Peso Liquido Real
58 HL2_QTPESB N 16 4 Peso Bruto Peso Bruto Real
59 HL2_TRARED C 32 0 Transportado Transportadora Redespacho Real
60 HL2_FBXEST C 1 0 Itm Baixa Es Item Baixa Estoque? Real
61 HL2_TPCPIT C 20 0 Tipo de Item Tipo de Item da NF Real
62 HL2_LIVRE0 N 16 4 Livre 0 Livre 0 Real
63 HL2_LIVRE1 N 16 4 Livre 1 Livre 1 Real
64 HL2_LIVRE2 N 16 4 Livre 2 Livre 2 Real
65 HL2_LIVRE3 N 16 4 Livre 3 Livre 3 Real
66 HL2_LIVRE4 N 16 4 Livre 4 Livre 4 Real
67 HL2_LIVRE5 D 8 0 Livre 5 Livre 5 Real
68 HL2_LIVRE6 D 8 0 Livre 6 Livre 6 Real
69 HL2_LIVRE7 D 8 0 Livre 7 Livre 7 Real
70 HL2_LIVRE8 C 50 0 Livre 8 Livre 8 Real
71 HL2_LIVRE9 C 50 0 Livre 9 Livre 9 Real
72 HL2_REMITO C 13 0 Remito Número do Remito Real
73 HL2_SERREM C 3 0 Série Remito Série Remito Real
74 HL2_ITEREM C 4 0 Item Remito Item Remito Real
75 HL2_UNITEM C 32 0 Und Med Item Unidade Medida do Item Real
76 HL2_VIPINC N 16 2 Vl Imp Inc Vl Impostos Incidentes Real
77 HL2_VIPNIN N 16 2 Vl Imp ñ inc Vl Impostos não incidente Real
78 HL2_VIAGEM C 32 0 Viagem Viagem Real
79 HL2_CLIREM C 32 0 Cliente Reme Cliente Remetente Real
80 HL2_CLIDES C 32 0 Cliente Dest Cliente Destinatário Real
81 HL2_CLIDEV C 32 0 Cliente Deve Cliente Devedor Real
82 HL2_REGTRA C 32 0 Reg Tran Ori Região de Transporte de O Real
83 HL2_REGDES C 32 0 Reg Trans De Região de Transporte de D Real
84 HL2_SERTRA C 32 0 Serviço de T Serviço de Transporte Real
85 HL2_TIPDOC C 32 0 Tipo de Docu Tipo de Documento de Tran Real
86 HL2_TIPTRA C 32 0 Tipo Transpo Tipo Transporte Real
87 HL2_FILORI C 32 0 Filial de Or Filial de Origem Real
88 HL2_FXHORA C 32 0 Faixa de Hor Faixa de Hora Real
89 HL2_CANMID C 32 0 Canal de Míd Canal de Mídia Real
90 HL2_FORPAG C 32 0 Forma de Pag Forma de Pagamento Real
91 HL2_ORILAN C 32 0 Origem do La Origem do Lançamento Real
92 HL2_QTDVEN N 16 4 Quantidade Quantidade Vendida Real
93 HL2_VLUNIT N 16 2 Valor Unitár Valor Unitário Real
94 HL2_VLCMEV N 16 2 Custo da Mer Custo da Mercadoria Vendi Real
95 HL2_FORNEC C 32 0 Fornecedor Fornecedor Real

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

Índices da tabela HL2 (1)

OrdemChaveDescriçãoApelido
1HL2_FILIAL+HL2_LINPRO+HL2_ISTCIA+HL2_EMPRESLinha Produt + Instância + Empresa

Perguntas frequentes sobre a tabela HL2

O que é a tabela HL2?

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

Qual é a chave única da tabela HL2?

A chave única é HL2_FILIAL+HL2_FAMMAT+HL2_CFOP+HL2_REGIAO+HL2_MOEDA+DTOS(HL2_DATA)+HL2_PRDUTO+HL2_TABPCO+HL2_CANALV+HL2_ROTA+HL2_MICREG+HL2_TRARED+HL2_NATOPR+HL2_GRPCLI.

Quais são os índices da tabela HL2?

A tabela tem 1 índice. O principal (ordem 1) usa a chave HL2_FILIAL+HL2_LINPRO+HL2_ISTCIA+HL2_EMPRES.

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

Exemplo de consulta SQL da tabela HL2

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

SELECT
    HL2_LINPRO,
    HL2_ISTCIA,
    HL2_EMPRES,
    HL2_FILIAL,
    HL2_ESTABL,
    HL2_ITEM,
    HL2_FAMCOM,
    HL2_FAMMAT,
    HL2_GRPEST,
    HL2_PRDUTO,
    HL2_REPRES,
    HL2_TRANSP,
    HL2_NATOPR,
    HL2_CFOP,
    HL2_GRPCLI,
    HL2_CLIENT,
    HL2_REGIAO,
    HL2_MOEDA,
    HL2_CONDPG,
    HL2_UNDNEG,
    HL2_DATA,
    HL2_SERNF,
    HL2_NUMNF,
    HL2_VFATOT,
    HL2_VCMFAT,
    HL2_VLCSFT,
    HL2_VICMSF,
    HL2_VIPIFT,
    HL2_VRECFI,
    HL2_VFRTNF,
    HL2_VDESPE,
    HL2_VFATME,
    HL2_VFATLQ,
    HL2_VPISFT,
    HL2_VCOFIN,
    HL2_QFATIT,
    HL2_VISSFT,
    HL2_PEDIDO,
    HL2_QFATFC,
    HL2_QFATFM,
    HL2_TABPCO,
    HL2_CANALV,
    HL2_ROTA,
    HL2_REGCOM,
    HL2_MICREG,
    HL2_REFER,
    HL2_NMITNF,
    HL2_VICMSS,
    HL2_VLDESF,
    HL2_VLIRFF,
    HL2_VINSSF,
    HL2_FGERDP,
    HL2_DTSANF,
    HL2_QPRZDP,
    HL2_TPFRET,
    HL2_TPNOTA,
    HL2_QTPESL,
    HL2_QTPESB,
    HL2_TRARED,
    HL2_FBXEST,
    HL2_TPCPIT,
    HL2_LIVRE0,
    HL2_LIVRE1,
    HL2_LIVRE2,
    HL2_LIVRE3,
    HL2_LIVRE4,
    HL2_LIVRE5,
    HL2_LIVRE6,
    HL2_LIVRE7,
    HL2_LIVRE8,
    HL2_LIVRE9,
    HL2_REMITO,
    HL2_SERREM,
    HL2_ITEREM,
    HL2_UNITEM,
    HL2_VIPINC,
    HL2_VIPNIN,
    HL2_VIAGEM,
    HL2_CLIREM,
    HL2_CLIDES,
    HL2_CLIDEV,
    HL2_REGTRA,
    HL2_REGDES,
    HL2_SERTRA,
    HL2_TIPDOC,
    HL2_TIPTRA,
    HL2_FILORI,
    HL2_FXHORA,
    HL2_CANMID,
    HL2_FORPAG,
    HL2_ORILAN,
    HL2_QTDVEN,
    HL2_VLUNIT,
    HL2_VLCMEV,
    HL2_FORNEC
FROM HL2
WHERE
    D_E_L_E_T_ = ' '
    AND HL2_LINPRO = 'VALOR'
    AND HL2_ISTCIA = 'VALOR'
    AND HL2_EMPRES = 'VALOR'
    AND HL2_FILIAL = 'VALOR'
    AND HL2_ESTABL = 'VALOR'
    AND HL2_ITEM = 'VALOR'
    AND HL2_FAMCOM = 'VALOR'
    AND HL2_FAMMAT = 'VALOR'
    AND HL2_GRPEST = 'VALOR'
    AND HL2_PRDUTO = 'VALOR'
    AND HL2_REPRES = 'VALOR'
    AND HL2_TRANSP = 'VALOR'
    AND HL2_NATOPR = 'VALOR'
    AND HL2_CFOP = 'VALOR'
    AND HL2_GRPCLI = 'VALOR'
    AND HL2_CLIENT = 'VALOR'
    AND HL2_REGIAO = 'VALOR'
    AND HL2_MOEDA = 'VALOR'
    AND HL2_CONDPG = 'VALOR'
    AND HL2_UNDNEG = 'VALOR'
    AND HL2_DATA BETWEEN '20261001' AND '20261031'
    AND HL2_SERNF = 'VALOR'
    AND HL2_NUMNF = 'VALOR'
    AND HL2_VFATOT = 0
    AND HL2_VCMFAT = 0
    AND HL2_VLCSFT = 0
    AND HL2_VICMSF = 0
    AND HL2_VIPIFT = 0
    AND HL2_VRECFI = 0
    AND HL2_VFRTNF = 0
    AND HL2_VDESPE = 0
    AND HL2_VFATME = 0
    AND HL2_VFATLQ = 0
    AND HL2_VPISFT = 0
    AND HL2_VCOFIN = 0
    AND HL2_QFATIT = 0
    AND HL2_VISSFT = 0
    AND HL2_PEDIDO = 'VALOR'
    AND HL2_QFATFC = 0
    AND HL2_QFATFM = 0
    AND HL2_TABPCO = 'VALOR'
    AND HL2_CANALV = 'VALOR'
    AND HL2_ROTA = 'VALOR'
    AND HL2_REGCOM = 'VALOR'
    AND HL2_MICREG = 'VALOR'
    AND HL2_REFER = 'VALOR'
    AND HL2_NMITNF = 'VALOR'
    AND HL2_VICMSS = 0
    AND HL2_VLDESF = 0
    AND HL2_VLIRFF = 0
    AND HL2_VINSSF = 0
    AND HL2_FGERDP = 'VALOR'
    AND HL2_DTSANF BETWEEN '20261001' AND '20261031'
    AND HL2_QPRZDP = 0
    AND HL2_TPFRET = 'VALOR'
    AND HL2_TPNOTA = 'VALOR'
    AND HL2_QTPESL = 0
    AND HL2_QTPESB = 0
    AND HL2_TRARED = 'VALOR'
    AND HL2_FBXEST = 'VALOR'
    AND HL2_TPCPIT = 'VALOR'
    AND HL2_LIVRE0 = 0
    AND HL2_LIVRE1 = 0
    AND HL2_LIVRE2 = 0
    AND HL2_LIVRE3 = 0
    AND HL2_LIVRE4 = 0
    AND HL2_LIVRE5 BETWEEN '20261001' AND '20261031'
    AND HL2_LIVRE6 BETWEEN '20261001' AND '20261031'
    AND HL2_LIVRE7 BETWEEN '20261001' AND '20261031'
    AND HL2_LIVRE8 = 'VALOR'
    AND HL2_LIVRE9 = 'VALOR'
    AND HL2_REMITO = 'VALOR'
    AND HL2_SERREM = 'VALOR'
    AND HL2_ITEREM = 'VALOR'
    AND HL2_UNITEM = 'VALOR'
    AND HL2_VIPINC = 0
    AND HL2_VIPNIN = 0
    AND HL2_VIAGEM = 'VALOR'
    AND HL2_CLIREM = 'VALOR'
    AND HL2_CLIDES = 'VALOR'
    AND HL2_CLIDEV = 'VALOR'
    AND HL2_REGTRA = 'VALOR'
    AND HL2_REGDES = 'VALOR'
    AND HL2_SERTRA = 'VALOR'
    AND HL2_TIPDOC = 'VALOR'
    AND HL2_TIPTRA = 'VALOR'
    AND HL2_FILORI = 'VALOR'
    AND HL2_FXHORA = 'VALOR'
    AND HL2_CANMID = 'VALOR'
    AND HL2_FORPAG = 'VALOR'
    AND HL2_ORILAN = 'VALOR'
    AND HL2_QTDVEN = 0
    AND HL2_VLUNIT = 0
    AND HL2_VLCMEV = 0
    AND HL2_FORNEC = 'VALOR'

Outras tabelas relacionadas

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