📅 Data de publicação: 28/01/2026

✅ 🧾 Resumo

A rotina Consultas Genéricas (programa EDAPP) do TOTVS Microsiga Protheus permite consultar tabelas do dicionário de dados (ex.: SA1, SB1, SF2, SE1, etc.), aplicar filtros, selecionar campos via Dicionário e exportar os resultados para CSV/XML/Excel, conforme o módulo e a configuração do ambiente.

🎯 📌 Aplicabilidade

Indicado para:

• 🔎 Consultas rápidas em tabelas do Protheus (auditoria, validação, conferência cadastral).

• 📤 Extração de dados para análise (Excel) via Exp. CSV.

• 🧩 Apoio ao suporte (geração de evidências e levantamentos sem desenvolvimento).

🧩 🛠️ Pré-requisitos

• 👤 Usuário com permissão de acesso ao menu Consultas > Cadastros > Genéricos (ou equivalente no módulo).

• 🧾 Menu do módulo devidamente gerado/atualizado no SIGACFG quando necessário (principalmente quando a tabela não aparece na lista).

• 💻 Microsoft Excel instalado (para abertura automática quando aplicável) e/ou associação correta para abrir CSV/XML.

🧭 🧰 Passo a passo

1) 🗺️ Acessar a rotina (EDAPP)

1. Acesse o módulo desejado (ex.: SIGAFAT, SIGAFIS, SIGAGPE, etc.).

2. Navegue até: Consultas > Cadastros > Genéricos.

3. Na pesquisa, informe/seleciona a tabela (ex.: SA1) e confirme (OK).

2) 🧠 Usar o Dicionário para selecionar colunas

1. Com a consulta aberta, clique em Dicionário.

2. Selecione os campos desejados para exibição/extração.

3. Confirme para aplicar na grade.

Dica Mastersiga: selecione apenas os campos necessários para reduzir volume e melhorar a leitura no Excel.

3) 🔎 Aplicar filtros na consulta

1. Na própria tela da consulta, utilize os recursos de filtro (por campo/coluna).

2. Refaça a consulta para validar o resultado.

4) 📤 Exportar resultados (Exp. CSV / XML / Excel)

✅ Exportar em CSV

1. Clique em Exp.CSV.

2. Selecione CSV.

3. Ajuste o separador (comumente Ponto e vírgula) e Confirme.

✅ Exportar para abrir no Excel

• Em alguns cenários/módulos, o fluxo recomendado é:

  1. Exp. CSV

  2. Selecionar Formato XML + MS Excel

  3. Confirmar e abrir no Excel.

✅ Quando o arquivo não abrir automaticamente

• Em exportação XML, o Protheus pode gravar o arquivo em partes na pasta temporária do Windows.

• Verifique a mensagem da rotina com o caminho e acesse manualmente (ex.: ...\AppData\Local\Temp\).

5) 🧩 Incluir/retirar tabelas que aparecem na Consulta Genérica (EDAPP) — via SIGACFG

Use quando:

• A tabela não aparece para seleção na consulta genérica do módulo.

• Você quer restringir a lista de tabelas exibidas.

Procedimento (alto nível):

1. Acesse o SIGACFG (Configurador).

2. Vá em Ambiente > Cadastros > Menus.

3. Selecione o(s) módulo(s) onde deseja aplicar (ex.: SIGAFAT, SIGAFIS etc.) e confirme.

4. Localize a opção relacionada à Consulta Genérica (EDAPP) e clique em Detalhes.

5. Pesquise a tabela e marque para incluir ou desmarque para remover.

   • Observação importante: se nenhuma tabela estiver marcada, o Protheus pode entender que deve exibir todas; ao marcar algumas, ele passa a exibir somente as selecionadas.

6. Clique em Gerar o menu e depois saia e entre no sistema para validar.

🧯 ❌ Erros comuns (e como resolver)

1) “A tabela não aparece na lista da Consulta Genérica”

• Causa comum: tabela não está habilitada no menu do módulo (EDAPP).

• Solução: ajustar no SIGACFG > Menus > Detalhes e Gerar o menu.

2) “Exportei em XML e não achei o arquivo”

• Causa comum: arquivo gravado na pasta Temp do usuário.

• Solução: localizar o caminho exibido na mensagem e abrir manualmente.

3) “Excel não abre automaticamente”

• Verificar:

  • Instalação/versão do Excel

  • Associação de arquivos (CSV/XML)

  • Permissão do usuário no Windows para pasta Temp

4) “A consulta trouxe ‘dados demais’ e ficou lenta”

• Boas práticas:

  • Aplique filtros antes de exportar

  • Selecione menos colunas no Dicionário

  • Evite consultas sem filtro em tabelas muito grandes

❓ 📚 FAQ

✅ A consulta genérica altera dados?

Não. A rotina é voltada para consulta/exibição e exportação. (Alterações de dados devem seguir rotinas específicas e governança do cliente.)

✅ Posso usar em qualquer módulo?

Em geral sim, desde que o menu do módulo contenha a opção EDAPP e as tabelas estejam habilitadas na configuração do menu.

✅ Qual formato é melhor: CSV ou XML?

• CSV: simples, leve e rápido para análise.

• XML: útil quando o Protheus/Excel do ambiente está padronizado para abertura via “MS Excel” e quando o arquivo é tratado via pasta Temp.

🔗 📎 Referências (TOTVS)

• Central TOTVS — Incluir/retirar tabelas da consulta genérica (EDAPP) no Faturamento

• Central TOTVS — Como gerar tabela em planilha na Consulta Genérica (Exp.CSV / CSV)

• Central TOTVS — Como extrair tabela do Protheus em Excel (Exp.CSV / XML / MS Excel)

• Central TOTVS — Consulta Genérica: exportação para XML e localização do arquivo (Temp)

• Central TOTVS — Configurar Consulta Genérica para tabelas de um módulo (ex.: SIGAGFE)

🗂️ Cadastro na Base de Conhecimento

• Título sugerido: Utilização da rotina Consultas Genéricas (EDAPP) no TOTVS Microsiga Protheus

• Categoria sugerida: Protheus > Configurador (SIGACFG) / Consultas e Utilitários

• Tags sugeridas: Protheus, EDAPP, Consulta Genérica, Consultas, Exportação, Exp.CSV, Excel, SIGACFG, Menus, Dicionário de Dados

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria