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

Tabela HKQ no Protheus

Compras em Carteira

A tabela HKQ do Protheus está descrita no dicionário (SX2) como “Compras em Carteira”. Possui 48 campos e 1 índices e chave única HKQ_EMPRES+HKQ_ESTABL+HKQ_FILIAL+HKQ_FAMMAT+HKQ_REGIAO+HKQ_MOEDA+HKQ_UNDNEG+HKQ_ISTCIA+HKQ_LINPRO+HKQ_GRPFOR+HKQ_SITCMP+HKQ_NATCMP+HKQ_REFER. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código
HKQ
Nome
Compras em Carteira
Nome (inglês)
Purchases in Portfolio
Compartilhamento por filial
Compartilhado
Compartilhamento por unidade
Compartilhado
Compartilhamento por empresa
Compartilhado
Chave única
HKQ_EMPRES+HKQ_ESTABL+HKQ_FILIAL+HKQ_FAMMAT+HKQ_REGIAO+HKQ_MOEDA+HKQ_UNDNEG+HKQ_ISTCIA+HKQ_LINPRO+HKQ_GRPFOR+HKQ_SITCMP+HKQ_NATCMP+HKQ_REFER
Campos / índices
48 / 1

Campos da tabela HKQ (48)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 HKQ_LINPRO C 2 0 Linh Product Linha de Produto Real
02 HKQ_ISTCIA C 2 0 Instância Instância Real
03 HKQ_EMPRES C 32 0 Empresa Empresa Real
04 HKQ_FILIAL C 2 0 FILIAL FILIAL Real
05 HKQ_ESTABL C 32 0 Estabelecime Estabelecimento Real
06 HKQ_FORNEC C 32 0 Fornecedor ID Fornecedor Real
07 HKQ_TRANSP C 32 0 Transp Transportadora Real
08 HKQ_FAMMAT C 32 0 Familia Mat. Familia Material Real
09 HKQ_FAMCOM C 32 0 Fami Comerci Familia Comercial Real
10 HKQ_GRPEST C 32 0 Grupo de Est Grupo de Estoque Real
11 HKQ_ITEM C 32 0 Item / Prod Item / Produto Real
12 HKQ_CMPRDR C 32 0 Comprador Comprador Real
13 HKQ_ORDEM C 10 0 Ordem de Com Ordem de Compra Real
14 HKQ_PEDIDO C 10 0 Ped. de Comp Pedido de Compra Real
15 HKQ_CONDPG C 32 0 Cond. Pag. Condição de Pagamento Real
16 HKQ_REGIAO C 32 0 Região Região Real
17 HKQ_MOEDA C 32 0 Moeda Moeda Real
18 HKQ_CCUSTO C 32 0 Centro Custo Centro de Custo Real
19 HKQ_UNDNEG C 32 0 UN Negocio Unidade de Negócio Real
20 HKQ_DTENTR D 8 0 Dt Prev Entr Data Previsão de Entrega Real
21 HKQ_DTPEDC D 8 0 Dt Emis Ped Dt Emissão Pedido Compra Real
22 HKQ_DTEXTR D 8 0 Dt. Extração Data da Extração Real
23 HKQ_QCARTE N 16 4 Qtd Carteira Qtde Carteira Real
24 HKQ_VCARTE N 16 2 Vlr. Carteir Valor da Carteira Real
25 HKQ_QDSATR N 4 0 Dias Atrasad Dias Atrasados Carteira Real
26 HKQ_QCTFMT N 16 4 Qtd Cart FC Qtd Carteira Familia Mat Real
27 HKQ_DTEORD D 8 0 Dt. Emiss. Dt. Emiss. Ord. Real
28 HKQ_NUMPRG N 4 0 Num. Prog. Num. Prog. Real
29 HKQ_PLCCST C 32 0 Plano C. C. Plano Centro Custo Real
30 HKQ_GRPFOR C 32 0 Grupo Fornec Grupo de Fornecedor Real
31 HKQ_EMERG C 1 0 Pedido Emerg Pedido Emergencial Real
32 HKQ_SITCMP C 32 0 Situação Com Situação Compra Real
33 HKQ_NATCMP C 32 0 Natureza Com Natureza Compra Real
34 HKQ_REFER C 32 0 Referência Referência Real
35 HKQ_QENTAT N 16 4 Qt Ent Atr C Qtde Ent Atras Carteiras Real
36 HKQ_QENTAN N 16 4 Qt Ent Ant C Qtde Ent Antec Carteiras Real
37 HKQ_QDSANT N 4 0 Dias Antec C Dias Antecipados Carteira Real
38 HKQ_LIVRE0 N 16 4 Livre 0 Livre 0 Real
39 HKQ_LIVRE1 N 16 4 Livre 1 Livre 1 Real
40 HKQ_LIVRE2 N 16 4 Livre 2 Livre 2 Real
41 HKQ_LIVRE3 N 16 4 Livre 3 Livre 3 Real
42 HKQ_LIVRE4 N 16 4 Livre 4 Livre 4 Real
43 HKQ_LIVRE5 D 8 0 Livre 5 Livre 5 Real
44 HKQ_LIVRE6 D 8 0 Livre 6 Livre 6 Real
45 HKQ_LIVRE7 D 8 0 Livre 7 Livre 7 Real
46 HKQ_LIVRE8 C 50 0 Livre 8 Livre 8 Real
47 HKQ_LIVRE9 C 50 0 Livre 9 Livre 9 Real
48 HKQ_UNITEM C 32 0 Und Med Item Unidade Medida do Item Real

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

Índices da tabela HKQ (1)

OrdemChaveDescriçãoApelido
1HKQ_FILIAL+HKQ_FORNEC+HKQ_ITEM+HKQ_CONDPGFornecedor + Item / Prod + Cond. Pag.

Perguntas frequentes sobre a tabela HKQ

O que é a tabela HKQ?

É a tabela “Compras em Carteira” do ERP TOTVS Protheus, com 48 campos definidos no dicionário SX3.

Qual é a chave única da tabela HKQ?

A chave única é HKQ_EMPRES+HKQ_ESTABL+HKQ_FILIAL+HKQ_FAMMAT+HKQ_REGIAO+HKQ_MOEDA+HKQ_UNDNEG+HKQ_ISTCIA+HKQ_LINPRO+HKQ_GRPFOR+HKQ_SITCMP+HKQ_NATCMP+HKQ_REFER.

Quais são os índices da tabela HKQ?

A tabela tem 1 índice. O principal (ordem 1) usa a chave HKQ_FILIAL+HKQ_FORNEC+HKQ_ITEM+HKQ_CONDPG.

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

Exemplo de consulta SQL da tabela HKQ

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

SELECT
    HKQ_LINPRO,
    HKQ_ISTCIA,
    HKQ_EMPRES,
    HKQ_FILIAL,
    HKQ_ESTABL,
    HKQ_FORNEC,
    HKQ_TRANSP,
    HKQ_FAMMAT,
    HKQ_FAMCOM,
    HKQ_GRPEST,
    HKQ_ITEM,
    HKQ_CMPRDR,
    HKQ_ORDEM,
    HKQ_PEDIDO,
    HKQ_CONDPG,
    HKQ_REGIAO,
    HKQ_MOEDA,
    HKQ_CCUSTO,
    HKQ_UNDNEG,
    HKQ_DTENTR,
    HKQ_DTPEDC,
    HKQ_DTEXTR,
    HKQ_QCARTE,
    HKQ_VCARTE,
    HKQ_QDSATR,
    HKQ_QCTFMT,
    HKQ_DTEORD,
    HKQ_NUMPRG,
    HKQ_PLCCST,
    HKQ_GRPFOR,
    HKQ_EMERG,
    HKQ_SITCMP,
    HKQ_NATCMP,
    HKQ_REFER,
    HKQ_QENTAT,
    HKQ_QENTAN,
    HKQ_QDSANT,
    HKQ_LIVRE0,
    HKQ_LIVRE1,
    HKQ_LIVRE2,
    HKQ_LIVRE3,
    HKQ_LIVRE4,
    HKQ_LIVRE5,
    HKQ_LIVRE6,
    HKQ_LIVRE7,
    HKQ_LIVRE8,
    HKQ_LIVRE9,
    HKQ_UNITEM
FROM HKQ
WHERE
    D_E_L_E_T_ = ' '
    AND HKQ_LINPRO = 'VALOR'
    AND HKQ_ISTCIA = 'VALOR'
    AND HKQ_EMPRES = 'VALOR'
    AND HKQ_FILIAL = 'VALOR'
    AND HKQ_ESTABL = 'VALOR'
    AND HKQ_FORNEC = 'VALOR'
    AND HKQ_TRANSP = 'VALOR'
    AND HKQ_FAMMAT = 'VALOR'
    AND HKQ_FAMCOM = 'VALOR'
    AND HKQ_GRPEST = 'VALOR'
    AND HKQ_ITEM = 'VALOR'
    AND HKQ_CMPRDR = 'VALOR'
    AND HKQ_ORDEM = 'VALOR'
    AND HKQ_PEDIDO = 'VALOR'
    AND HKQ_CONDPG = 'VALOR'
    AND HKQ_REGIAO = 'VALOR'
    AND HKQ_MOEDA = 'VALOR'
    AND HKQ_CCUSTO = 'VALOR'
    AND HKQ_UNDNEG = 'VALOR'
    AND HKQ_DTENTR BETWEEN '20261001' AND '20261031'
    AND HKQ_DTPEDC BETWEEN '20261001' AND '20261031'
    AND HKQ_DTEXTR BETWEEN '20261001' AND '20261031'
    AND HKQ_QCARTE = 0
    AND HKQ_VCARTE = 0
    AND HKQ_QDSATR = 0
    AND HKQ_QCTFMT = 0
    AND HKQ_DTEORD BETWEEN '20261001' AND '20261031'
    AND HKQ_NUMPRG = 0
    AND HKQ_PLCCST = 'VALOR'
    AND HKQ_GRPFOR = 'VALOR'
    AND HKQ_EMERG = 'VALOR'
    AND HKQ_SITCMP = 'VALOR'
    AND HKQ_NATCMP = 'VALOR'
    AND HKQ_REFER = 'VALOR'
    AND HKQ_QENTAT = 0
    AND HKQ_QENTAN = 0
    AND HKQ_QDSANT = 0
    AND HKQ_LIVRE0 = 0
    AND HKQ_LIVRE1 = 0
    AND HKQ_LIVRE2 = 0
    AND HKQ_LIVRE3 = 0
    AND HKQ_LIVRE4 = 0
    AND HKQ_LIVRE5 BETWEEN '20261001' AND '20261031'
    AND HKQ_LIVRE6 BETWEEN '20261001' AND '20261031'
    AND HKQ_LIVRE7 BETWEEN '20261001' AND '20261031'
    AND HKQ_LIVRE8 = 'VALOR'
    AND HKQ_LIVRE9 = 'VALOR'
    AND HKQ_UNITEM = 'VALOR'

Outras tabelas relacionadas

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