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

Tabela ACH no Protheus

Suspects

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)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
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 E-mail E-Mail 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)

OrdemChaveDescriçãoApelido
1ACH_FILIAL+ACH_CODIGO+ACH_LOJACodigo + Loja
2ACH_FILIAL+ACH_CGCCNPJ
3ACH_FILIAL+ACH_RAZAORazao Social
4ACH_FILIAL+ACH_CODPRO+ACH_LOJPROProspect + Lj. Prospect
5ACH_FILIAL+ACH_VEND+ACH_CODIGO+ACH_LOJAVendedor + 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

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