Tabela MAH (Controle Número de Contrato) no Protheus: campos e índices

A tabela MAH do Protheus está descrita no dicionário (SX2) como “Controle Número de Contrato”. Possui 19 campos e 5 índices e chave única MAH_FILIAL+MAH_CONTRA. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código: MAH
Nome: Controle Número de Contrato
Nome (inglês): Contract Number Control
Compartilhamento por filial: Compartilhado
Compartilhamento por unidade: Exclusivo
Compartilhamento por empresa: Exclusivo
Chave única: MAH_FILIAL+MAH_CONTRA
Campos / índices: 19 / 5

Campos da tabela MAH (19)

Ordem	Campo	Tipo	Tam.	Dec.	Título	Descrição	Contexto
01	MAH_FILIAL	C	2	0	Filial	Filial do Sistema	Real
02	MAH_CODCLI	C	6	0	Cliente	Codigo do Cliente	Real
03	MAH_LOJA	C	2	0	Loja	Código da loja do cliente	Real
04	MAH_CONTRA	C	10	0	Contrato	Número do contrato	Real
05	MAH_EMISSA	D	8	0	Dt.Emissão	Data de Emissão	Real
06	MAH_DTCANC	D	8	0	Dt. Canc.	Data do Cancelamento	Real
07	MAH_HRCANC	C	8	0	Hora Canc.	Hora do Cancelamento	Real
08	MAH_USERCA	C	25	0	Usuario	Usuario do Cancelamento	Real
09	MAH_TRANS	C	1	0	Transação	Transação de crédito	Real
10	MAH_DTTRN	D	8	0	Data Trans.	Data da Transacao	Real
11	MAH_HRTRN	C	8	0	Hora Trans.	Hora da Transação	Real
12	MAH_USRTRN	C	25	0	Usuario	Usuario resp.pela trans.	Real
13	MAH_PDVTRN	C	10	0	PDV	PDV solic.Transação	Real
14	MAH_CXTRN	C	3	0	Caixa	Caixa resp.p/transação	Real
15	MAH_LJTRN	C	20	0	Loja Trans.	Loja resp.p/transação	Real
16	MAH_STATUS	C	1	0	Status	Status do credito	Real
17	MAH_VLRFIN	N	12	2	Vlr. Financ.	Valor Total Financiado	Real
18	MAH_CHAVE	C	20	0	Chave doc.	Numero do documento chave	Real
19	MAH_USRCRD	C	6	0	Usuario CRD	Usuario que fez analise	Real

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

Índices da tabela MAH (5)

Ordem	Chave	Descrição
1	`MAH_FILIAL+MAH_CONTRA`	Contrato
2	`MAH_FILIAL+MAH_CODCLI+MAH_LOJA+MAH_CONTRA`	Cliente + Loja + Contrato
3	`MAH_FILIAL+MAH_CODCLI+MAH_LOJA+MAH_TRANS`	Cliente + Loja + Transação
4	`MAH_FILIAL+DTOS(MAH_EMISSA)+MAH_CODCLI+MAH_LOJA+MAH_CONTRA`	Dt.Emissão + Cliente + Loja + Contrato
5	`MAH_FILIAL+MAH_USRCRD+DTOS(MAH_EMISSA)`	Usuario CRD + Dt.Emissão

Perguntas frequentes sobre a tabela MAH

O que é a tabela MAH?

É a tabela “Controle Número de Contrato” do ERP TOTVS Protheus, com 19 campos definidos no dicionário SX3.

Qual é a chave única da tabela MAH?

A chave única é MAH_FILIAL+MAH_CONTRA.

Quais são os índices da tabela MAH?

A tabela tem 5 índices. O principal (ordem 1) usa a chave MAH_FILIAL+MAH_CONTRA.

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

Exemplo de consulta SQL da tabela MAH

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

SELECT
    MAH_FILIAL,
    MAH_CODCLI,
    MAH_LOJA,
    MAH_CONTRA,
    MAH_EMISSA,
    MAH_DTCANC,
    MAH_HRCANC,
    MAH_USERCA,
    MAH_TRANS,
    MAH_DTTRN,
    MAH_HRTRN,
    MAH_USRTRN,
    MAH_PDVTRN,
    MAH_CXTRN,
    MAH_LJTRN,
    MAH_STATUS,
    MAH_VLRFIN,
    MAH_CHAVE,
    MAH_USRCRD
FROM MAH
WHERE
    D_E_L_E_T_ = ' '
    AND MAH_FILIAL = 'VALOR'
    AND MAH_CODCLI = 'VALOR'
    AND MAH_LOJA = 'VALOR'
    AND MAH_CONTRA = 'VALOR'
    AND MAH_EMISSA BETWEEN '20261001' AND '20261031'
    AND MAH_DTCANC BETWEEN '20261001' AND '20261031'
    AND MAH_HRCANC = 'VALOR'
    AND MAH_USERCA = 'VALOR'
    AND MAH_TRANS = 'VALOR'
    AND MAH_DTTRN BETWEEN '20261001' AND '20261031'
    AND MAH_HRTRN = 'VALOR'
    AND MAH_USRTRN = 'VALOR'
    AND MAH_PDVTRN = 'VALOR'
    AND MAH_CXTRN = 'VALOR'
    AND MAH_LJTRN = 'VALOR'
    AND MAH_STATUS = 'VALOR'
    AND MAH_VLRFIN = 0
    AND MAH_CHAVE = 'VALOR'
    AND MAH_USRCRD = 'VALOR'

Outras tabelas relacionadas

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