Tabela SO9 (Ordens de Serviços) no Protheus: campos e índices

A tabela SO9 do Protheus está descrita no dicionário (SX2) como “Ordens de Serviços”. Possui 24 campos e 1 índices. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código: SO9
Nome: Ordens de Serviços
Nome (inglês): Service Orders
Compartilhamento por filial: Exclusivo
Compartilhamento por unidade: Exclusivo
Compartilhamento por empresa: Exclusivo
Campos / índices: 24 / 1

Campos da tabela SO9 (24)

Ordem	Campo	Tipo	Tam.	Dec.	Título	Descrição	Contexto
01	O9_FILIAL	C	2	0	Filial	Filial do Sistema	Real
02	O9_ITEM	C	2	0	Item	No. Item da OS	Real
03	O9_NUM	C	6	0	Numero OS	No. da Ordem de servico	Real
04	O9_PRODUTO	C	15	0	Produto	Codigo do produto	Real
05	O9_DESCRI	C	30	0	Descricao	Descricao do Produto	Real
06	O9_LOCAL	C	2	0	Armazem Pad.	Armazem Padrao do Produto	Real
07	O9_TIPOOS	C	3	0	Tipo Operac.	Indicador da operacao	Real
08	O9_QUANT	N	10	2	Quantidade	Quantidade utilizada	Real
09	O9_UN	C	2	0	Unidade	Unidade de medida	Real
10	O9_PRUNIT	N	16	2	Preco Unit.	Preco Unitario do Produto	Real
11	O9_TOTAL	N	16	2	Valor Total	Valor Total do Item	Real
12	O9_DESCONT	N	16	2	Desconto	Desconto em Valor do Item	Real
13	O9_PERDESC	N	5	2	% Desconto	Percentual de Desconto	Real
14	O9_DATPREV	D	8	0	Dt. prevista	Data prevista termino	Real
15	O9_DATFIM	D	8	0	Encerramento	Data de encerram. da OS	Real
16	O9_PRIOR	C	2	0	Prioridade	Prioridade da operacao	Real
17	O9_STATUS	C	2	0	Status	Status da item	Real
18	O9_PERDA	N	10	2	Perda	Qtde de perda do item	Real
19	O9_TMPPREV	N	5	2	Tempo Prev.	Tempo previsto	Real
20	O9_TMPREAL	N	5	2	Tempo Real	Tempo real	Real
21	O9_NOTA	C	6	0	Nota Fiscal	Nota Fiscal	Real
22	O9_SERIE	C	3	0	Serie	Serie	Real
23	O9_OBS	C	25	0	Observacao	Observacao	Real
24	O9_PRCTAB	N	16	2	Preco Tabela	Preco da Tabela	Real

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

Índices da tabela SO9 (1)

Ordem	Chave	Descrição	Apelido
1	`O9_FILIAL+O9_NUM+O9_ITEM+O9_PRODUTO`	Numero OS + Item + Produto

Perguntas frequentes sobre a tabela SO9

O que é a tabela SO9?

É a tabela “Ordens de Serviços” do ERP TOTVS Protheus, com 24 campos definidos no dicionário SX3.

Quais são os índices da tabela SO9?

A tabela tem 1 índice. O principal (ordem 1) usa a chave O9_FILIAL+O9_NUM+O9_ITEM+O9_PRODUTO.

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

Exemplo de consulta SQL da tabela SO9

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

SELECT
    O9_FILIAL,
    O9_ITEM,
    O9_NUM,
    O9_PRODUTO,
    O9_DESCRI,
    O9_LOCAL,
    O9_TIPOOS,
    O9_QUANT,
    O9_UN,
    O9_PRUNIT,
    O9_TOTAL,
    O9_DESCONT,
    O9_PERDESC,
    O9_DATPREV,
    O9_DATFIM,
    O9_PRIOR,
    O9_STATUS,
    O9_PERDA,
    O9_TMPPREV,
    O9_TMPREAL,
    O9_NOTA,
    O9_SERIE,
    O9_OBS,
    O9_PRCTAB
FROM SO9
WHERE
    D_E_L_E_T_ = ' '
    AND O9_FILIAL = 'VALOR'
    AND O9_ITEM = 'VALOR'
    AND O9_NUM = 'VALOR'
    AND O9_PRODUTO = 'VALOR'
    AND O9_DESCRI = 'VALOR'
    AND O9_LOCAL = 'VALOR'
    AND O9_TIPOOS = 'VALOR'
    AND O9_QUANT = 0
    AND O9_UN = 'VALOR'
    AND O9_PRUNIT = 0
    AND O9_TOTAL = 0
    AND O9_DESCONT = 0
    AND O9_PERDESC = 0
    AND O9_DATPREV BETWEEN '20261101' AND '20261130'
    AND O9_DATFIM BETWEEN '20261101' AND '20261130'
    AND O9_PRIOR = 'VALOR'
    AND O9_STATUS = 'VALOR'
    AND O9_PERDA = 0
    AND O9_TMPPREV = 0
    AND O9_TMPREAL = 0
    AND O9_NOTA = 'VALOR'
    AND O9_SERIE = 'VALOR'
    AND O9_OBS = 'VALOR'
    AND O9_PRCTAB = 0

Outras tabelas relacionadas

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