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

Tabela AI1 no Protheus

Regras/Bonificação Financeira

A tabela AI1 do Protheus está descrita no dicionário (SX2) como “Regras/Bonificação Financeira”. Possui 9 campos e 3 índices e chave única AI1_FILIAL+AI1_CODBNF. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código
AI1
Nome
Regras/Bonificação Financeira
Nome (inglês)
Financial Rules/Bonus
Compartilhamento por filial
Compartilhado
Compartilhamento por unidade
Exclusivo
Compartilhamento por empresa
Exclusivo
Chave única
AI1_FILIAL+AI1_CODBNF
Campos / índices
9 / 3

Campos da tabela AI1 (9)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 AI1_FILIAL C 2 0 Filial Filial Real
02 AI1_CODBNF C 6 0 Codigo Codigo de Bonificacao Real
03 AI1_DESCRI C 30 0 Descricao Descricao Real
04 AI1_CODCLI C 6 0 Cliente Cliente Real
05 AI1_LOJA C 2 0 Loja Loja Real
06 AI1_NOMCLI C 50 0 Nome Cliente Nome do Cliente Virtual
07 AI1_GRPVEN C 6 0 Grp.Clientes Grupo de Clientes Real
08 AI1_DESGRP C 30 0 Descr.Grupo Descricao do Grupo Virtual
09 AI1_RECGRP C 1 0 Recurs.Grupo Recursividade no grupo Real

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

Índices da tabela AI1 (3)

OrdemChaveDescriçãoApelido
1AI1_FILIAL+AI1_CODBNFCodigo
2AI1_FILIAL+AI1_CODCLI+AI1_LOJA+AI1_CODBNFCliente + Loja + Codigo
3AI1_FILIAL+AI1_GRPVENGrp.Clientes

Perguntas frequentes sobre a tabela AI1

O que é a tabela AI1?

É a tabela “Regras/Bonificação Financeira” do ERP TOTVS Protheus, com 9 campos definidos no dicionário SX3.

Qual é a chave única da tabela AI1?

A chave única é AI1_FILIAL+AI1_CODBNF.

Quais são os índices da tabela AI1?

A tabela tem 3 índices. O principal (ordem 1) usa a chave AI1_FILIAL+AI1_CODBNF.

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

Exemplo de consulta SQL da tabela AI1

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

SELECT
    AI1_FILIAL,
    AI1_CODBNF,
    AI1_DESCRI,
    AI1_CODCLI,
    AI1_LOJA,
    AI1_NOMCLI,
    AI1_GRPVEN,
    AI1_DESGRP,
    AI1_RECGRP
FROM AI1
WHERE
    D_E_L_E_T_ = ' '
    AND AI1_FILIAL = 'VALOR'
    AND AI1_CODBNF = 'VALOR'
    AND AI1_DESCRI = 'VALOR'
    AND AI1_CODCLI = 'VALOR'
    AND AI1_LOJA = 'VALOR'
    AND AI1_NOMCLI = 'VALOR'
    AND AI1_GRPVEN = 'VALOR'
    AND AI1_DESGRP = 'VALOR'
    AND AI1_RECGRP = 'VALOR'

Outras tabelas relacionadas

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