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

Tabela QL4 no Protheus

Peça x Produto

A tabela QL4 do Protheus está descrita no dicionário (SX2) como “Peça x Produto”. Possui 7 campos e 5 índices e chave única QL4_FILIAL+QL4_PECA+QL4_REV+QL4_PRODUT+QL4_REVI+DTOS(QL4_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
QL4
Nome
Peça x Produto
Nome (inglês)
Part vs. Product
Compartilhamento por filial
Compartilhado
Compartilhamento por unidade
Exclusivo
Compartilhamento por empresa
Exclusivo
Chave única
QL4_FILIAL+QL4_PECA+QL4_REV+QL4_PRODUT+QL4_REVI+DTOS(QL4_DATA)
Campos / índices
7 / 5

Campos da tabela QL4 (7)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 QL4_FILIAL C 2 0 Filial Fililal Real
02 QL4_PECA C 40 0 No. Peca Numero da Peca Real
03 QL4_REV C 2 0 Revisao Revisao Real
04 QL4_PRODUT C 15 0 No. Produto Numero do Produto Real
05 QL4_REVI C 2 0 Revisäo Revisäo Real
06 QL4_DATA D 8 0 Data Data Real
07 QL4_ORIGEM C 9 0 Orig X Dest Origem X Destino Real

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

Índices da tabela QL4 (5)

OrdemChaveDescriçãoApelido
1QL4_FILIAL+QL4_PECA+QL4_REV+QL4_PRODUT+QL4_REVI+DTOS(QL4_DATA)No. Peca + Revisao + No. Produto + Revisäo + Data
2QL4_FILIAL+QL4_PRODUT+QL4_REVI+QL4_PECA+QL4_REV+DTOS(QL4_DATA)No. Produto + Revisäo + No. Peca + Revisao + Data
3QL4_FILIAL+QL4_PECA+QL4_PRODUT+DTOS(QL4_DATA)No. Peca + No. Produto + Data
4QL4_FILIAL+QL4_PRODUT+QL4_PECA+DTOS(QL4_DATA)No. Produto + No. Peca + Data
5QL4_FILIAL+DTOS(QL4_DATA)Data

Perguntas frequentes sobre a tabela QL4

O que é a tabela QL4?

É a tabela “Peça x Produto” do ERP TOTVS Protheus, com 7 campos definidos no dicionário SX3.

Qual é a chave única da tabela QL4?

A chave única é QL4_FILIAL+QL4_PECA+QL4_REV+QL4_PRODUT+QL4_REVI+DTOS(QL4_DATA).

Quais são os índices da tabela QL4?

A tabela tem 5 índices. O principal (ordem 1) usa a chave QL4_FILIAL+QL4_PECA+QL4_REV+QL4_PRODUT+QL4_REVI+DTOS(QL4_DATA).

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

Exemplo de consulta SQL da tabela QL4

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

SELECT
    QL4_FILIAL,
    QL4_PECA,
    QL4_REV,
    QL4_PRODUT,
    QL4_REVI,
    QL4_DATA,
    QL4_ORIGEM
FROM QL4
WHERE
    D_E_L_E_T_ = ' '
    AND QL4_FILIAL = 'VALOR'
    AND QL4_PECA = 'VALOR'
    AND QL4_REV = 'VALOR'
    AND QL4_PRODUT = 'VALOR'
    AND QL4_REVI = 'VALOR'
    AND QL4_DATA BETWEEN '20261001' AND '20261031'
    AND QL4_ORIGEM = 'VALOR'

Outras tabelas relacionadas

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