A tabela ACH do Protheus está descrita no dicionário (SX2) como “Suspects”. Possui 70 campos e 5 índices e chave única ACH_FILIAL+ACH_CODIGO+ACH_LOJA. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.
Propriedades da tabela
- Código
- ACH
- Nome
- Suspects
- Nome (inglês)
- Suspects
- Compartilhamento por filial
- Compartilhado
- Compartilhamento por unidade
- Exclusivo
- Compartilhamento por empresa
- Exclusivo
- Chave única
ACH_FILIAL+ACH_CODIGO+ACH_LOJA- Campos / índices
- 70 / 5
Campos da tabela ACH (70)
| Ordem | Campo | Tipo | Tam. | Dec. | Título | Descrição | Contexto |
|---|---|---|---|---|---|---|---|
| 01 | ACH_FILIAL | C | 2 | 0 | Filial | Filial | Real |
| 02 | ACH_CODIGO | C | 6 | 0 | Codigo | Codigo | Real |
| 03 | ACH_LOJA | C | 2 | 0 | Loja | Loja | Real |
| 04 | ACH_RAZAO | C | 40 | 0 | Razao Social | Razao Social | Real |
| 05 | ACH_NFANT | C | 20 | 0 | N. Fantasia | Nome Fantasia | Real |
| 06 | ACH_TIPO | C | 1 | 0 | Tipo | Tipo do Suspect | Real |
| 07 | ACH_PESSOA | C | 1 | 0 | Física/Jurid | Pessoa Física/Jurídica | Real |
| 08 | ACH_CGC | C | 14 | 0 | CNPJ | CNPJ do Suspect | Real |
| 09 | ACH_END | C | 80 | 0 | Endereco | Endereco | Real |
| 10 | ACH_BAIRRO | C | 40 | 0 | Bairro | Bairro do Suspect | Real |
| 11 | ACH_CEP | C | 8 | 0 | Cep | Cep | Real |
| 12 | ACH_EST | C | 2 | 0 | Estado | Estado | Real |
| 13 | ACH_CODMUN | C | 5 | 0 | Cd.Municipio | Codigo do Municipio | Real |
| 14 | ACH_CIDADE | C | 60 | 0 | Municipio | Municipio do Suspect | Real |
| 15 | ACH_REGIAO | C | 6 | 0 | Regiao | Regiao do Suspect | Real |
| 16 | ACH_DSCREG | C | 55 | 0 | Desc.Região | Descrição da Região | Real |
| 17 | ACH_DDI | C | 6 | 0 | DDI | Codigo do DDI | Real |
| 18 | ACH_DDD | C | 3 | 0 | DDD | Codigo do DDD | Real |
| 19 | ACH_TEL | C | 15 | 0 | Telefone | Telefone | Real |
| 20 | ACH_FAX | C | 20 | 0 | Fax | Fax | Real |
| 21 | ACH_EMAIL | C | 40 | 0 | Real | ||
| 22 | ACH_URL | C | 40 | 0 | Home page | Home page | Real |
| 23 | ACH_STATUS | C | 1 | 0 | Status | Status do Suspect | Real |
| 24 | ACH_CODPRO | C | 6 | 0 | Prospect | Codigo como Prospect | Real |
| 25 | ACH_LOJPRO | C | 2 | 0 | Lj. Prospect | Loja do Prospect | Real |
| 26 | ACH_DESPRO | C | 40 | 0 | Descricäo | Nome do Prospect | Virtual |
| 27 | ACH_CNAE | C | 9 | 0 | Código CNAE | Código do CNAE | Real |
| 28 | ACH_OBS | C | 250 | 0 | Observacao | Observacao | Real |
| 29 | ACH_CONCOR | C | 6 | 0 | Concorrente | Codigo do Concorrente | Real |
| 30 | ACH_MOTIVO | C | 6 | 0 | Motivo Desc. | Motivo da desqualificação | Real |
| 31 | ACH_FATANU | N | 14 | 2 | Faturamento | Faturamento Anual | Real |
| 32 | ACH_QTFUNC | C | 1 | 0 | Funcionários | Quant. de funcionários | Real |
| 33 | ACH_PAIS | C | 3 | 0 | País | País do Suspect | Real |
| 34 | ACH_MIDIA | C | 6 | 0 | Mídia | Mídia pela qual o Suspect | Real |
| 35 | ACH_CODTMK | C | 6 | 0 | Cod Atend | Codigo Atendimento | Real |
| 36 | ACH_VEND | C | 6 | 0 | Vendedor | Codigo do Vendedor | Real |
| 37 | ACH_RESERV | C | 1 | 0 | Reserva | Reserva da Conta | Real |
| 38 | ACH_DTCAD | D | 8 | 0 | Dt.Cadastro | Data de Cadastro | Real |
| 39 | ACH_HRCAD | C | 5 | 0 | Hr.Cadastro | Hora de Cadastro | Real |
| 40 | ACH_DTCONV | D | 8 | 0 | Conversäo | Data da Conversäo | Real |
| 41 | ACH_HRCONV | C | 5 | 0 | Hr.Conversão | Hora da Conversão | Real |
| 42 | ACH_DURCAD | C | 120 | 0 | Dur.Cadastro | Duração do Cadastro | Virtual |
| 43 | ACH_IMGUMO | C | 100 | 0 | URL.Img.uMov | Ver imagem uMov.me | Real |
| 44 | ACH_ORIGEM | C | 1 | 0 | Origem | Origem do Suspect | Real |
| 45 | ACH_INTUMO | C | 1 | 0 | Int.uMov.me | Integrado uMov.me | Real |
| 46 | ACH_ENTORI | C | 6 | 0 | Ent. Origem | Entidade de Origem | Real |
| 47 | ACH_IDESTN | C | 30 | 0 | Id.Estr.Neg | Id. de Acesso Estr. Neg. | Real |
| 48 | ACH_NVESTN | N | 2 | 0 | Nvl. Est.Neg | Nvl de Acesso a Estr. Neg | Real |
| 49 | ACH_MSBLQL | C | 1 | 0 | Status | Status do Registro | Real |
| 50 | ACH_TPCAMP | C | 1 | 0 | Tipo Camp | Tipo de Campanha | Real |
| 51 | ACH_CHVCAM | C | 14 | 0 | Código | Código da Campanha | Real |
| 52 | ACH_DESCAM | C | 40 | 0 | Desc. Camp. | Descrição da Campanha | Virtual |
| 53 | ACH_CODESQ | C | 6 | 0 | Cód. Desqual | Código da Desqualificação | Real |
| 54 | ACH_CODTER | C | 6 | 0 | Cod. Terr. | Código do Território | Real |
| 55 | ACH_NOMTER | C | 40 | 0 | Nome | Nome do Território | Virtual |
| 56 | ACH_DESQUA | C | 40 | 0 | Desc. Desqu. | Desc. da Desqualificação | Virtual |
| 57 | ACH_TPMEM | C | 1 | 0 | Tipo Membro | Tipo do Membro | Real |
| 58 | ACH_OBSDES | M | 10 | 0 | Motivo Desq. | Motivo da Desqualificação | Real |
| 59 | ACH_CODSEG | C | 6 | 0 | Cod Segmento | Código do Segmento | Real |
| 60 | ACH_CODMEM | C | 14 | 0 | Membro | Codigo do Membro | Real |
| 61 | ACH_CODUSR | C | 25 | 0 | Usuário Desq | Cod. Do usuário de desq. | Real |
| 62 | ACH_DESSEG | C | 40 | 0 | Descr. Segm. | Descrição do Segmento | Virtual |
| 63 | ACH_DESUSR | C | 25 | 0 | Nome Usuário | Nome do usuário de Desqu. | Virtual |
| 64 | ACH_DSCMEM | C | 100 | 0 | Desc. Membro | Descrição do Membro | Virtual |
| 65 | ACH_DTDESQ | D | 8 | 0 | Dt Desqual. | Data de Desqualificacao | Real |
| 66 | ACH_DTREAT | D | 8 | 0 | Dt Reativ. | Data da reativação | Real |
| 67 | ACH_PROPRI | C | 6 | 0 | Proprietário | Proprietário | Real |
| 68 | ACH_DSCPRO | C | 25 | 0 | Dsc Propriet | Descrição do priprietário | Virtual |
| 69 | ACH_SETPUB | C | 1 | 0 | Setor Publ. | Setor Público | Real |
| 70 | ACH_NSOCIA | C | 40 | 0 | Nome Social | Nome Social | Real |
Tipo: C = caractere, N = numérico, D = data, L = lógico, M = memo.
Índices da tabela ACH (5)
| Ordem | Chave | Descrição | Apelido |
|---|---|---|---|
| 1 | ACH_FILIAL+ACH_CODIGO+ACH_LOJA | Codigo + Loja | |
| 2 | ACH_FILIAL+ACH_CGC | CNPJ | |
| 3 | ACH_FILIAL+ACH_RAZAO | Razao Social | |
| 4 | ACH_FILIAL+ACH_CODPRO+ACH_LOJPRO | Prospect + Lj. Prospect | |
| 5 | ACH_FILIAL+ACH_VEND+ACH_CODIGO+ACH_LOJA | Vendedor + Codigo + Loja |
Perguntas frequentes sobre a tabela ACH
O que é a tabela ACH?
É a tabela “Suspects” do ERP TOTVS Protheus, com 70 campos definidos no dicionário SX3.
Qual é a chave única da tabela ACH?
A chave única é ACH_FILIAL+ACH_CODIGO+ACH_LOJA.
Quais são os índices da tabela ACH?
A tabela tem 5 índices. O principal (ordem 1) usa a chave ACH_FILIAL+ACH_CODIGO+ACH_LOJA.
Qual é o nome físico da tabela ACH 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: ACH990). Em ADVPL, use RetSqlName("ACH") para obter o nome correto do ambiente.
Exemplo de consulta SQL da tabela ACH
Modelo gerado a partir da estrutura da tabela. Ajuste os filtros ao seu cenário.
SELECT
ACH_FILIAL,
ACH_CODIGO,
ACH_LOJA,
ACH_RAZAO,
ACH_NFANT,
ACH_TIPO,
ACH_PESSOA,
ACH_CGC,
ACH_END,
ACH_BAIRRO,
ACH_CEP,
ACH_EST,
ACH_CODMUN,
ACH_CIDADE,
ACH_REGIAO,
ACH_DSCREG,
ACH_DDI,
ACH_DDD,
ACH_TEL,
ACH_FAX,
ACH_EMAIL,
ACH_URL,
ACH_STATUS,
ACH_CODPRO,
ACH_LOJPRO,
ACH_DESPRO,
ACH_CNAE,
ACH_OBS,
ACH_CONCOR,
ACH_MOTIVO,
ACH_FATANU,
ACH_QTFUNC,
ACH_PAIS,
ACH_MIDIA,
ACH_CODTMK,
ACH_VEND,
ACH_RESERV,
ACH_DTCAD,
ACH_HRCAD,
ACH_DTCONV,
ACH_HRCONV,
ACH_DURCAD,
ACH_IMGUMO,
ACH_ORIGEM,
ACH_INTUMO,
ACH_ENTORI,
ACH_IDESTN,
ACH_NVESTN,
ACH_MSBLQL,
ACH_TPCAMP,
ACH_CHVCAM,
ACH_DESCAM,
ACH_CODESQ,
ACH_CODTER,
ACH_NOMTER,
ACH_DESQUA,
ACH_TPMEM,
ACH_OBSDES,
ACH_CODSEG,
ACH_CODMEM,
ACH_CODUSR,
ACH_DESSEG,
ACH_DESUSR,
ACH_DSCMEM,
ACH_DTDESQ,
ACH_DTREAT,
ACH_PROPRI,
ACH_DSCPRO,
ACH_SETPUB,
ACH_NSOCIA
FROM ACH
WHERE
D_E_L_E_T_ = ' '
AND ACH_FILIAL = 'VALOR'
AND ACH_CODIGO = 'VALOR'
AND ACH_LOJA = 'VALOR'
AND ACH_RAZAO = 'VALOR'
AND ACH_NFANT = 'VALOR'
AND ACH_TIPO = 'VALOR'
AND ACH_PESSOA = 'VALOR'
AND ACH_CGC = 'VALOR'
AND ACH_END = 'VALOR'
AND ACH_BAIRRO = 'VALOR'
AND ACH_CEP = 'VALOR'
AND ACH_EST = 'VALOR'
AND ACH_CODMUN = 'VALOR'
AND ACH_CIDADE = 'VALOR'
AND ACH_REGIAO = 'VALOR'
AND ACH_DSCREG = 'VALOR'
AND ACH_DDI = 'VALOR'
AND ACH_DDD = 'VALOR'
AND ACH_TEL = 'VALOR'
AND ACH_FAX = 'VALOR'
AND ACH_EMAIL = 'VALOR'
AND ACH_URL = 'VALOR'
AND ACH_STATUS = 'VALOR'
AND ACH_CODPRO = 'VALOR'
AND ACH_LOJPRO = 'VALOR'
AND ACH_DESPRO = 'VALOR'
AND ACH_CNAE = 'VALOR'
AND ACH_OBS = 'VALOR'
AND ACH_CONCOR = 'VALOR'
AND ACH_MOTIVO = 'VALOR'
AND ACH_FATANU = 0
AND ACH_QTFUNC = 'VALOR'
AND ACH_PAIS = 'VALOR'
AND ACH_MIDIA = 'VALOR'
AND ACH_CODTMK = 'VALOR'
AND ACH_VEND = 'VALOR'
AND ACH_RESERV = 'VALOR'
AND ACH_DTCAD BETWEEN '20261001' AND '20261031'
AND ACH_HRCAD = 'VALOR'
AND ACH_DTCONV BETWEEN '20261001' AND '20261031'
AND ACH_HRCONV = 'VALOR'
AND ACH_DURCAD = 'VALOR'
AND ACH_IMGUMO = 'VALOR'
AND ACH_ORIGEM = 'VALOR'
AND ACH_INTUMO = 'VALOR'
AND ACH_ENTORI = 'VALOR'
AND ACH_IDESTN = 'VALOR'
AND ACH_NVESTN = 0
AND ACH_MSBLQL = 'VALOR'
AND ACH_TPCAMP = 'VALOR'
AND ACH_CHVCAM = 'VALOR'
AND ACH_DESCAM = 'VALOR'
AND ACH_CODESQ = 'VALOR'
AND ACH_CODTER = 'VALOR'
AND ACH_NOMTER = 'VALOR'
AND ACH_DESQUA = 'VALOR'
AND ACH_TPMEM = 'VALOR'
AND ACH_CODSEG = 'VALOR'
AND ACH_CODMEM = 'VALOR'
AND ACH_CODUSR = 'VALOR'
AND ACH_DESSEG = 'VALOR'
AND ACH_DESUSR = 'VALOR'
AND ACH_DSCMEM = 'VALOR'
AND ACH_DTDESQ BETWEEN '20261001' AND '20261031'
AND ACH_DTREAT BETWEEN '20261001' AND '20261031'
AND ACH_PROPRI = 'VALOR'
AND ACH_DSCPRO = 'VALOR'
AND ACH_SETPUB = 'VALOR'
AND ACH_NSOCIA = 'VALOR'
Outras tabelas relacionadas
- AC0 Cadastro de Feriado
- AC1 Processos de Venda (Funil Vnd)
- AC2 Estágios do Processo de Vendas
- AC3 Concorrentes
- AC4 Parceiros
- AC5 Eventos do Contato x Visita
- AC6 Metas de Venda x Marketing
- AC7 Campanhas x Metas
- AC8 Relação de Contatos x Entidade
- AC9 Relação de Objetos x Entidades
- ACA Equipe de Vendas
- ACB Bancos de Conhecimentos
Dicionário Protheus · atualizado em 13/10/2026. Voltar ao índice do dicionário.