Tabela T97 (Tipos de Serviços NF) no Protheus: campos e índices

A tabela T97 do Protheus está descrita no dicionário (SX2) como “Tipos de Serviços NF”. Possui 18 campos e 2 índices e chave única T97_FILIAL+T97_ID+T97_VERSAO+T97_SERIE+T97_NUMDOC+T97_NUMFAT+T97_TPSERV. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código: T97
Nome: Tipos de Serviços NF
Nome (inglês): Types of Invoice Services
Compartilhamento por filial: Exclusivo
Compartilhamento por unidade: Exclusivo
Compartilhamento por empresa: Exclusivo
Chave única: T97_FILIAL+T97_ID+T97_VERSAO+T97_SERIE+T97_NUMDOC+T97_NUMFAT+T97_TPSERV
Campos / índices: 18 / 2

Campos da tabela T97 (18)

Ordem	Campo	Tipo	Tam.	Dec.	Título	Descrição	Contexto
01	T97_FILIAL	C	2	0	Filial	Filial	Real
02	T97_ID	C	36	0	ID	Identificador do Registro	Real
03	T97_VERSAO	C	14	0	Id Ver Reg	Id da versão do registro	Real
04	T97_SERIE	C	5	0	Série	Série	Real
05	T97_NUMDOC	C	15	0	Núm Documen	Número do Documento	Real
06	T97_NUMFAT	C	15	0	Núm Fat	Número da Fatura	Real
07	T97_TPSERV	C	6	0	Tipo Serviço	Tipo de serviço	Real
08	T97_CODSER	C	9	0	Cód Tp Serv	Código do tipo de Serviço	Real
09	T97_DTPSER	C	250	0	Desc Tp Serv	Desc. do tipo de serviço	Real
10	T97_VLRBAS	N	14	2	Vlr Bc Ret	Valor Bc Retenção	Real
11	T97_VLRRET	N	14	2	Vlr Retenção	Valor da Retenção	Real
12	T97_VLRRSU	N	14	2	Vlr Ret Sub	Valor Ret Subcontratados	Real
13	T97_VLRNPR	N	14	2	Vlr Ret Prin	Valor de Retenção Princip	Real
14	T97_VLRS15	N	14	2	Vlr Serv 15	Valor Serv 15 anos Cont	Real
15	T97_VLRS20	N	14	2	Vlr Serv 20	Valor Serv 20 anos Cont	Real
16	T97_VLRS25	N	14	2	Vlr Serv 25	Valor Serv 25 anos Cont	Real
17	T97_VLRADI	N	14	2	Vlr Adic	Valor Adicional	Real
18	T97_VLRNRE	N	14	2	Vlr Ad N Con	Valor Ret Não Contratante	Real

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

Índices da tabela T97 (2)

Ordem	Chave	Descrição	Apelido
1	`T97_FILIAL+T97_ID+T97_VERSAO+T97_SERIE+T97_NUMDOC+T97_NUMFAT+T97_TPSERV`	ID + Id Ver Reg + Série + Núm Documen + Núm Fat + Tipo Serviço
2	`T97_FILIAL+T97_TPSERV`	Tipo Serviço

Perguntas frequentes sobre a tabela T97

O que é a tabela T97?

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

Qual é a chave única da tabela T97?

A chave única é T97_FILIAL+T97_ID+T97_VERSAO+T97_SERIE+T97_NUMDOC+T97_NUMFAT+T97_TPSERV.

Quais são os índices da tabela T97?

A tabela tem 2 índices. O principal (ordem 1) usa a chave T97_FILIAL+T97_ID+T97_VERSAO+T97_SERIE+T97_NUMDOC+T97_NUMFAT+T97_TPSERV.

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

Exemplo de consulta SQL da tabela T97

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

SELECT
    T97_FILIAL,
    T97_ID,
    T97_VERSAO,
    T97_SERIE,
    T97_NUMDOC,
    T97_NUMFAT,
    T97_TPSERV,
    T97_CODSER,
    T97_DTPSER,
    T97_VLRBAS,
    T97_VLRRET,
    T97_VLRRSU,
    T97_VLRNPR,
    T97_VLRS15,
    T97_VLRS20,
    T97_VLRS25,
    T97_VLRADI,
    T97_VLRNRE
FROM T97
WHERE
    D_E_L_E_T_ = ' '
    AND T97_FILIAL = 'VALOR'
    AND T97_ID = 'VALOR'
    AND T97_VERSAO = 'VALOR'
    AND T97_SERIE = 'VALOR'
    AND T97_NUMDOC = 'VALOR'
    AND T97_NUMFAT = 'VALOR'
    AND T97_TPSERV = 'VALOR'
    AND T97_CODSER = 'VALOR'
    AND T97_DTPSER = 'VALOR'
    AND T97_VLRBAS = 0
    AND T97_VLRRET = 0
    AND T97_VLRRSU = 0
    AND T97_VLRNPR = 0
    AND T97_VLRS15 = 0
    AND T97_VLRS20 = 0
    AND T97_VLRS25 = 0
    AND T97_VLRADI = 0
    AND T97_VLRNRE = 0

Outras tabelas relacionadas

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