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

Tabela QL3 no Protheus

VDA - Itens Amostra Inicial

A tabela QL3 do Protheus está descrita no dicionário (SX2) como “VDA - Itens Amostra Inicial”. Possui 13 campos e 2 índices e chave única QL3_FILIAL+QL3_PECA+QL3_REV+QL3_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
QL3
Nome
VDA - Itens Amostra Inicial
Nome (inglês)
VDA - Initial Sample Items
Compartilhamento por filial
Compartilhado
Compartilhamento por unidade
Exclusivo
Compartilhamento por empresa
Exclusivo
Chave única
QL3_FILIAL+QL3_PECA+QL3_REV+QL3_ITEM
Campos / índices
13 / 2

Campos da tabela QL3 (13)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 QL3_FILIAL C 2 0 Filial Filial Real
02 QL3_PECA C 40 0 No. da Peca Numero da Peca Real
03 QL3_REV C 2 0 Revisao Revisao da Peca Real
04 QL3_REVINV C 2 0 Rev Invertid Revisao Invertida Real
05 QL3_ITEM C 3 0 Item Item Real
06 QL3_NPEMAT C 20 0 No Peca/Mat. No. Peca / Material Real
07 QL3_NOMEPC C 20 0 Nome da Peca Nome da Peca Real
08 QL3_COMZSB C 20 0 Mat. ZSB Materiais ZSB Real
09 QL3_MASSA C 15 0 Massa Massa Real
10 QL3_MATESP C 20 0 Mat Esp Prod Mat Esp Prod Fabricante Real
11 QL3_SUBCAS C 15 0 Sub Cont CAS Subs. Contida No CAS Real
12 QL3_DENMAT C 15 0 Den. Mater. Denominacao do Material Real
13 QL3_TEOR C 10 0 Teor [%] Teor [%] Real

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

Índices da tabela QL3 (2)

OrdemChaveDescriçãoApelido
1QL3_FILIAL+QL3_PECA+QL3_REV+QL3_ITEMNo. da Peca + Revisao + Item
2QL3_FILIAL+QL3_PECA+QL3_REVINV+QL3_ITEMNo. da Peca + Rev Invertid + Item

Perguntas frequentes sobre a tabela QL3

O que é a tabela QL3?

É a tabela “VDA - Itens Amostra Inicial” do ERP TOTVS Protheus, com 13 campos definidos no dicionário SX3.

Qual é a chave única da tabela QL3?

A chave única é QL3_FILIAL+QL3_PECA+QL3_REV+QL3_ITEM.

Quais são os índices da tabela QL3?

A tabela tem 2 índices. O principal (ordem 1) usa a chave QL3_FILIAL+QL3_PECA+QL3_REV+QL3_ITEM.

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

Exemplo de consulta SQL da tabela QL3

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

SELECT
    QL3_FILIAL,
    QL3_PECA,
    QL3_REV,
    QL3_REVINV,
    QL3_ITEM,
    QL3_NPEMAT,
    QL3_NOMEPC,
    QL3_COMZSB,
    QL3_MASSA,
    QL3_MATESP,
    QL3_SUBCAS,
    QL3_DENMAT,
    QL3_TEOR
FROM QL3
WHERE
    D_E_L_E_T_ = ' '
    AND QL3_FILIAL = 'VALOR'
    AND QL3_PECA = 'VALOR'
    AND QL3_REV = 'VALOR'
    AND QL3_REVINV = 'VALOR'
    AND QL3_ITEM = 'VALOR'
    AND QL3_NPEMAT = 'VALOR'
    AND QL3_NOMEPC = 'VALOR'
    AND QL3_COMZSB = 'VALOR'
    AND QL3_MASSA = 'VALOR'
    AND QL3_MATESP = 'VALOR'
    AND QL3_SUBCAS = 'VALOR'
    AND QL3_DENMAT = 'VALOR'
    AND QL3_TEOR = 'VALOR'

Outras tabelas relacionadas

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