SEA Logo

Casos de uso

Onde o SEA entra no seu trabalho

Situações comuns de quem trabalha com o Sankhya ERP, com a pergunta que você faria à sua IA e os especialistas que respondem.

Cenários ilustrativos: mostram como o SEA é usado, não relatam resultados de clientes. A resposta depende da sua IA, do seu ambiente e da pergunta feita.

Cenário ilustrativoDesenvolvedores e times de integração

Desenvolver uma integração com o Sankhya ERP

Você precisa enviar pedidos de um e-commerce para o Sankhya e não sabe qual serviço usar, quais campos o módulo exige nem como autenticar no ambiente certo.

Como o SEA entra

  1. O agente de código consulta o especialista de Integrações antes de escrever a chamada.
  2. Quando a dúvida passa pela regra do módulo (TOP, tipo de negociação), o Agent Core traz o especialista Comercial junto.
  3. A resposta separa o que a API exige do que a regra do módulo exige.

Pergunte assim

Vou integrar pedidos de venda de um e-commerce com o Sankhya. Qual o caminho recomendado pela API, como autenticar e quais campos do cabeçalho do pedido são obrigatórios?
O que esperar
O roteiro da integração com a evidência de cada ponto e o nível de confiança, mais o que precisa ser confirmado no seu ambiente.
Confira no seu ambiente
Credenciais, versão do ambiente e parametrização da TOP são da sua empresa: teste no ambiente de homologação antes de produção.
IntegraçõesComercialClaude CodeCodexSEA MCP
Cenário ilustrativoConsultores, analistas de suporte e usuários-chave

Tirar uma dúvida técnica sem sair da conversa

Uma rejeição fiscal travou o faturamento e é preciso saber se é cadastro, parametrização ou regra tributária antes de abrir chamado.

Como o SEA entra

  1. Você pergunta no ChatGPT, no Claude ou no Gemini como faria a um consultor.
  2. A IA chama o SEA, que encaminha ao especialista Fiscal.
  3. A resposta vem como sequência de verificação, cada ponto com o tipo de evidência.

Pergunte assim

A NF-e no Sankhya está voltando com rejeição de código de município inválido. Onde isso é parametrizado e o que devo conferir, na ordem?
O que esperar
Uma sequência de verificação classificada por evidência (documentação oficial, regra de governo, inferência técnica).
Confira no seu ambiente
Regra fiscal muda por estado e por data: confirme na legislação vigente e no seu cadastro antes de alterar parâmetros.
FiscalChatGPTClaude (web)Gemini
Cenário ilustrativoDesenvolvedores de relatórios e consultores técnicos

Criar ou ajustar um relatório formatado

A área pede um relatório novo no padrão do Sankhya Om (iReport) e montar o .jrxml à mão consome horas de tentativa e erro.

Como o SEA entra

  1. No SEA Report, você monta o relatório num editor visual, com IA e os dados reais da sua base.
  2. O especialista de iReport sustenta o que é próprio do relatório no Sankhya; o de SQL e BI, a consulta.
  3. Sai o .jrxml pronto para importar.

Pergunte assim

Preciso de um relatório de pedidos pendentes por vendedor, agrupado por mês, com subtotal. Quais tabelas usar e como montar o agrupamento no relatório?
O que esperar
A consulta e a estrutura do relatório com a origem de cada campo, e no SEA Report o arquivo pronto para importar.
Confira no seu ambiente
Confira o resultado com dados conhecidos antes de publicar o relatório para os usuários.
IReportSQL/BIDicionário de DadosClaude CodeSEA Report
Cenário ilustrativoDesenvolvedores e times de sustentação

Diagnosticar um erro de API

A integração devolve um erro com stack trace longo e ninguém sabe se o problema é de autenticação, de payload ou de regra do Sankhya.

Como o SEA entra

  1. Você cola a mensagem de erro inteira: o SEA condensa a mensagem, as causas, os códigos e as classes envolvidas.
  2. O especialista de Integrações (ou de SDK, se o erro vier de customização Java) separa causa provável de hipótese.
  3. A IA propõe a correção com o que conferir primeiro.

Pergunte assim

Minha chamada à API do Sankhya está retornando este erro (colo abaixo o stack trace). Qual a causa mais provável e o que conferir primeiro?
O que esperar
Causas ordenadas por probabilidade, cada uma com a evidência, e os passos de verificação.
Confira no seu ambiente
Não cole credenciais, tokens ou dados de clientes na pergunta: o erro basta.
IntegraçõesSDKCursorVS Code
Cenário ilustrativoDesenvolvedores de BI e de telas

Construir um dashboard ou tela HTML5

Você precisa de um dashboard para o Construtor de BI do Sankhya Om e não quer escrever HTML, JSP e JavaScript do zero.

Como o SEA entra

  1. No SEA Builder, você monta o dashboard com blocos, IA e os dados reais da sua base.
  2. O especialista HTML5 sustenta o que é próprio dos componentes do Sankhya; o de Construtor de Telas, a parte de telas.
  3. Sai um único .zip pronto para subir.

Pergunte assim

Quero um painel de faturamento do mês com indicador, gráfico por vendedor e filtro de período no Construtor de BI. Como estruturar o componente?
O que esperar
A estrutura do componente e as consultas, e no SEA Builder o pacote pronto para importar.
Confira no seu ambiente
Teste o componente num ambiente de homologação e confira as permissões dos usuários que vão vê-lo.
HTML5Construtor de TelasSQL/BIClaude CodeCodexSEA Builder
Cenário ilustrativoAnalistas de dados, desenvolvedores e consultores

Escrever uma consulta SQL segura

Gerar SQL com uma IA genérica costuma errar nome de tabela e de campo, ou ignorar o relacionamento certo entre as tabelas do Sankhya.

Como o SEA entra

  1. O especialista de Dicionário de Dados confirma tabelas, campos e relacionamentos.
  2. O de SQL e BI cuida da consulta e do desempenho.
  3. A IA monta a consulta só de leitura e explica cada junção.

Pergunte assim

Preciso listar as notas de venda do mês com o nome do parceiro e o total por TOP. Quais tabelas e junções usar no Sankhya?
O que esperar
A consulta com a origem de cada tabela e campo, e o aviso do que depende da sua customização.
Confira no seu ambiente
Rode a consulta primeiro em homologação e só com leitura; customizações da sua base podem ter campos adicionais.
Dicionário de DadosSQL/BIClaude CodeCursor
Cenário ilustrativoArquitetos, líderes técnicos e consultores

Revisar a arquitetura de uma customização

Uma especificação de customização chegou e é preciso saber o que conflita com o comportamento padrão do Sankhya antes de aprovar o escopo.

Como o SEA entra

  1. Você entrega a especificação à IA, que consulta o SEA durante a leitura.
  2. O Agent Core aciona os especialistas dos domínios citados (por exemplo, Financeiro e Fiscal).
  3. Os pontos de conflito voltam com a evidência e a separação entre comportamento documentado e inferência.

Pergunte assim

Vou colar uma especificação de customização do faturamento. Aponte o que conflita com o comportamento padrão do Sankhya e o que exige regra de negócio em vez de parametrização.
O que esperar
Uma revisão ponto a ponto, com o nível de confiança de cada observação.
Confira no seu ambiente
A decisão de escopo é da equipe do projeto: use a revisão como insumo, não como aprovação.
ProjetosFinanceiroFiscalClaude (web)Claude Desktop

Um cenário para cada cliente de IA

Cada página de conexão traz um cenário próprio do jeito como aquele cliente é usado (também ilustrativos).