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

Tabela DH4 no Protheus

Itens Documento de Entrada DCL

A tabela DH4 do Protheus está descrita no dicionário (SX2) como “Itens Documento de Entrada DCL”. Possui 27 campos e 7 índices e chave única DH4_FILIAL+DH4_DOC+DH4_SERIE+DH4_FORNEC+DH4_LOJA+DH4_ITEM. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código
DH4
Nome
Itens Documento de Entrada DCL
Nome (inglês)
DCL Inflow Document Items
Compartilhamento por filial
Exclusivo
Compartilhamento por unidade
Exclusivo
Compartilhamento por empresa
Exclusivo
Chave única
DH4_FILIAL+DH4_DOC+DH4_SERIE+DH4_FORNEC+DH4_LOJA+DH4_ITEM
Campos / índices
27 / 7

Campos da tabela DH4 (27)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 DH4_FILIAL C 2 0 Filial Filial do sistema Real
02 DH4_DOC C 9 0 Documento Numero do Documento/Nota Real
03 DH4_SERIE C 3 0 Serie Serie da Nota Fiscal Real
04 DH4_FORNEC C 6 0 Forn/Cliente Codigo do Forn/Cliente Real
05 DH4_LOJA C 2 0 Loja Loja do Forn/Cliente Real
06 DH4_ITEM C 4 0 Item NF Item da Nota Fiscal Real
07 DH4_CODPRO C 15 0 Cód. Produto Código do Produto Real
08 DH4_DUTO C 6 0 Cod. Duto Codigo do Duto Real
09 DH4_SRVIMP C 1 0 Servico SIMP Servico i-SIMP contratado Real
10 DH4_DTENT D 8 0 Dt.Entrega Data da Entrega Real
11 DH4_DCPROV C 6 0 Nr.ORP Documento Provisorio Real
12 DH4_NLCIMP C 10 0 Num.Lic.Imp. Numero da Licenca de Imp. Real
13 DH4_DECIMP C 10 0 Num.Dec.Imp. Num. da Declaracao de Imp Real
14 DH4_CODVGL C 6 0 Cod.Vas.GLP Codigo do Vasilhame GLP Real
15 DH4_CODEMB C 4 0 Cod. Embarc. Codigo da Embarcacao Real
16 DH4_QTDAPU N 11 2 Qtd.Apurada Quantidade Apurada Real
17 DH4_TMPTAQ N 5 2 Temp.Tanque Temperatura do Tanque Real
18 DH4_TMPAMO N 5 2 Temp.Amostra Temperatura Amostra Real
19 DH4_DENSID N 6 4 Densidade Densidade Real
20 DH4_FATCOR N 6 4 Fat.Correcao Fator de Correcao Real
21 DH4_QTD20G N 11 2 Qtd 20 Graus Quantidade a 20 graus Real
22 DH4_ATUTNQ C 1 0 Atual.Tanque Atualiza Tanque Real
23 DH4_TRANS C 6 0 Transp Cod. do Transportador Real
24 DH4_TANQUE C 6 0 Tanque Tanque Real
25 DH4_MODANP C 2 0 Modal ANP Via Transp. Modal ANP Real
26 DH4_MASSA N 8 3 Massa Esp. Massa Especifica do Prod. Real
27 DH4_TDCARG C 2 0 Tipo Descarg Tipo de Descarga Real

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

Índices da tabela DH4 (7)

OrdemChaveDescriçãoApelido
1DH4_FILIAL+DH4_DOC+DH4_SERIE+DH4_FORNEC+DH4_LOJA+DH4_ITEMDocumento + Serie + Forn/Cliente + Loja + Item NF
2DH4_FILIAL+DH4_MODANPModal ANP
3DH4_FILIAL+DH4_DUTOCod. Duto
4DH4_FILIAL+DH4_CODEMBCod. Embarc.
5DH4_FILIAL+DH4_CODVGLCod.Vas.GLP
6DH4_FILIAL+DTOS(DH4_DTENT)Dt.Entrega
7DH4_FILIAL+DH4_DCPROVNr.ORP

Perguntas frequentes sobre a tabela DH4

O que é a tabela DH4?

É a tabela “Itens Documento de Entrada DCL” do ERP TOTVS Protheus, com 27 campos definidos no dicionário SX3.

Qual é a chave única da tabela DH4?

A chave única é DH4_FILIAL+DH4_DOC+DH4_SERIE+DH4_FORNEC+DH4_LOJA+DH4_ITEM.

Quais são os índices da tabela DH4?

A tabela tem 7 índices. O principal (ordem 1) usa a chave DH4_FILIAL+DH4_DOC+DH4_SERIE+DH4_FORNEC+DH4_LOJA+DH4_ITEM.

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

Exemplo de consulta SQL da tabela DH4

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

SELECT
    DH4_FILIAL,
    DH4_DOC,
    DH4_SERIE,
    DH4_FORNEC,
    DH4_LOJA,
    DH4_ITEM,
    DH4_CODPRO,
    DH4_DUTO,
    DH4_SRVIMP,
    DH4_DTENT,
    DH4_DCPROV,
    DH4_NLCIMP,
    DH4_DECIMP,
    DH4_CODVGL,
    DH4_CODEMB,
    DH4_QTDAPU,
    DH4_TMPTAQ,
    DH4_TMPAMO,
    DH4_DENSID,
    DH4_FATCOR,
    DH4_QTD20G,
    DH4_ATUTNQ,
    DH4_TRANS,
    DH4_TANQUE,
    DH4_MODANP,
    DH4_MASSA,
    DH4_TDCARG
FROM DH4
WHERE
    D_E_L_E_T_ = ' '
    AND DH4_FILIAL = 'VALOR'
    AND DH4_DOC = 'VALOR'
    AND DH4_SERIE = 'VALOR'
    AND DH4_FORNEC = 'VALOR'
    AND DH4_LOJA = 'VALOR'
    AND DH4_ITEM = 'VALOR'
    AND DH4_CODPRO = 'VALOR'
    AND DH4_DUTO = 'VALOR'
    AND DH4_SRVIMP = 'VALOR'
    AND DH4_DTENT BETWEEN '20261101' AND '20261130'
    AND DH4_DCPROV = 'VALOR'
    AND DH4_NLCIMP = 'VALOR'
    AND DH4_DECIMP = 'VALOR'
    AND DH4_CODVGL = 'VALOR'
    AND DH4_CODEMB = 'VALOR'
    AND DH4_QTDAPU = 0
    AND DH4_TMPTAQ = 0
    AND DH4_TMPAMO = 0
    AND DH4_DENSID = 0
    AND DH4_FATCOR = 0
    AND DH4_QTD20G = 0
    AND DH4_ATUTNQ = 'VALOR'
    AND DH4_TRANS = 'VALOR'
    AND DH4_TANQUE = 'VALOR'
    AND DH4_MODANP = 'VALOR'
    AND DH4_MASSA = 0
    AND DH4_TDCARG = 'VALOR'

Outras tabelas relacionadas

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