A tabela SOA do Protheus está descrita no dicionário (SX2) como “Apontamento de Tempos da OS”. Possui 9 campos e 2 í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
- SOA
- Nome
- Apontamento de Tempos da OS
- Nome (inglês)
- Annotation of Time in SO
- Compartilhamento por filial
- Exclusivo
- Compartilhamento por unidade
- Exclusivo
- Compartilhamento por empresa
- Exclusivo
- Campos / índices
- 9 / 2
Campos da tabela SOA (9)
| Ordem | Campo | Tipo | Tam. | Dec. | Título | Descrição | Contexto |
|---|---|---|---|---|---|---|---|
| 01 | OA_FILIAL | C | 2 | 0 | Filial | Filial do Sistema | Real |
| 02 | OA_NUM | C | 6 | 0 | Numero OS | Numero da Ordem de Serv. | Real |
| 03 | OA_ITEM | C | 2 | 0 | Item da OS | Item da Ordem de Servico | Real |
| 04 | OA_TEMPREV | N | 5 | 2 | Tempo Prev. | Tempo previsto para o ser | Real |
| 05 | OA_INIREAL | N | 5 | 2 | Inicio | Horario real de Inicio | Real |
| 06 | OA_FIMREAL | N | 5 | 2 | Fim | Horario real de finaliz. | Real |
| 07 | OA_TEMREAL | N | 5 | 2 | Tempo Real | Hora prevista de termino | Real |
| 08 | OA_FUNC | C | 6 | 0 | Cod. Funcion | Codigo do Funcionario | Real |
| 09 | OA_DATA | D | 8 | 0 | Data Servico | Data do Servico | Real |
Tipo: C = caractere, N = numérico, D = data, L = lógico, M = memo.
Índices da tabela SOA (2)
| Ordem | Chave | Descrição | Apelido |
|---|---|---|---|
| 1 | OA_FILIAL+OA_NUM+OA_ITEM | Numero OS + Item da OS | |
| 2 | OA_FILIAL+OA_FUNC+DTOS(OA_DATA)+OA_NUM+OA_ITEM | Cod. Funcion + Data Servico + Numero OS + Item da OS |
Perguntas frequentes sobre a tabela SOA
O que é a tabela SOA?
É a tabela “Apontamento de Tempos da OS” do ERP TOTVS Protheus, com 9 campos definidos no dicionário SX3.
Quais são os índices da tabela SOA?
A tabela tem 2 índices. O principal (ordem 1) usa a chave OA_FILIAL+OA_NUM+OA_ITEM.
Qual é o nome físico da tabela SOA 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: SOA990). Em ADVPL, use RetSqlName("SOA") para obter o nome correto do ambiente.
Exemplo de consulta SQL da tabela SOA
Modelo gerado a partir da estrutura da tabela. Ajuste os filtros ao seu cenário.
SELECT
OA_FILIAL,
OA_NUM,
OA_ITEM,
OA_TEMPREV,
OA_INIREAL,
OA_FIMREAL,
OA_TEMREAL,
OA_FUNC,
OA_DATA
FROM SOA
WHERE
D_E_L_E_T_ = ' '
AND OA_FILIAL = 'VALOR'
AND OA_NUM = 'VALOR'
AND OA_ITEM = 'VALOR'
AND OA_TEMPREV = 0
AND OA_INIREAL = 0
AND OA_FIMREAL = 0
AND OA_TEMREAL = 0
AND OA_FUNC = 'VALOR'
AND OA_DATA BETWEEN '20261101' AND '20261130'Outras tabelas relacionadas
- SO1 Tabela de Serviços
- SO2 Solicitações de Garantia
- SO3 Funcionários da Oficina
- SO4 Kit de Reparos
- SO5 Identificação do Veículo
- SO6 Cabeçalho de Orçamento
- SO7 Itens do Orçamento
- SO8 Cabeçalho da Ordem de Serviço
- SO9 Ordens de Serviços
- SOB Manutenções Gratuitas
- SOC Itens da Tabela de Serviços
- SOD Parâmetros da integraçao MES
Dicionário Protheus · atualizado em 13/10/2026. Voltar ao índice do dicionário.