1. Defina a demanda antes de escolher a consulta
Comece por uma pergunta verificável: quais títulos vencem em um período, como uma carteira se distribui por estabelecimento ou qual informação precisa alimentar um painel. A pergunta determina filtros, origem, formato de saída e responsável pela conferência.
Responder a partir de um manual e consultar o ERP são capacidades diferentes. A documentação pode explicar uma regra; para buscar o estado de um título é necessário utilizar a ferramenta conectada à origem correta.
- Qual pergunta a equipe precisa responder?
- Que período, estabelecimento e situação delimitam a consulta?
- Como o resultado será conferido com uma fonte conhecida?
2. Prepare o ambiente e a conexão
No QualiOps, acessos que dependem da rede do cliente são executados pelo qualiops-worker instalado como serviço no servidor. A plataforma utiliza as conexões configuradas para encaminhar o trabalho. Instalação do worker, credenciais e conectividade precisam ser validadas com TI.
Versão e módulos do Datasul, bancos disponíveis e mecanismos de integração do ambiente determinam o caminho adequado. Uma conexão SQL para leitura de dados não é equivalente à execução de uma API ou de um programa de negócio. Escolha a origem de acordo com o objetivo, em vez de tratar todos os acessos como uma única integração.
3. Conecte o significado do negócio à estrutura técnica
Um agente precisa reconhecer o que um campo representa naquele contexto. Termos como cliente, fornecedor, emissão e vencimento não devem ser substituídos por nomes de colunas presumidos. Confirme tabelas, tipos, relacionamentos e índices antes de preparar a consulta.
O catálogo e as orientações da equipe permitem reutilizar conhecimento. Documentos sobre políticas e processos podem complementar o contexto, mantendo clara a distinção entre regra descrita, dado consultado e interpretação do resultado.
4. Valide a ferramenta e a resposta
Teste com recortes que a equipe conhece e compare linhas, totais e significado dos campos. Inclua situações de retorno vazio, filtros inválidos e indisponibilidade da origem. Uma consulta que executa sem erro ainda pode ter usado o campo ou o recorte errado.
Ao ampliar para automações, defina a ferramenta da ação e o processo aplicável. A configuração de uma consulta não concede, por si só, acesso irrestrito para alterar o ERP.
- Comparar o resultado com uma consulta ou relatório conhecido.
- Confirmar filtros, unidade dos valores e atualização da informação.
- Testar as identidades e os acessos que realmente usarão a solução.
- Acompanhar execuções e revisar mudanças de escopo.
Referências e próximos passos
Consulte a documentação correspondente à versão do seu ambiente. As referências abaixo são dos fornecedores das tecnologias, sem indicação de parceria ou endosso ao QualiOps.
Para relacionar estas orientações à solução, veja como o QualiOps conecta IA ao TOTVS Datasul, incluindo requisitos, formas de consulta e limites da integração.