Nas próximas semanas, agentes de IA vão dominar a conversa sobre ERP. O Universo TOTVS 2026, marcado para 13 e 14 de outubro no Expo Center Norte, em São Paulo, terá um espaço dedicado ao LYNN, o modelo de IA da TOTVS para o mercado B2B, com agentes funcionando em tempo real. A promessa é real. Mas, para quem roda Protheus, a pergunta que decide se um agente vai ajudar ou atrapalhar não é qual modelo usar. É por onde esse agente vai conversar com o ERP.

O modelo é a parte fácil

Um agente de IA útil dentro de uma empresa precisa fazer duas coisas: consultar dados (saldo de estoque, títulos em aberto, pedidos pendentes) e, em algum momento, executar ações (incluir um pedido, liberar um título, atualizar um cadastro). Qualquer modelo moderno consegue entender o pedido do usuário. O que ele não consegue sozinho é acessar o Protheus de forma segura, auditável e respeitando as regras de negócio que a empresa levou anos para parametrizar.

É aí que a maioria dos projetos escorrega.

Três caminhos, um só é sustentável

1. Query direta no banco de dados. É o atalho mais comum em prova de conceito: conecta o agente ao SQL e pronto. O problema é que o acesso passa por fora de tudo o que o Protheus faz na camada de aplicação: validações do modelo de dados, gatilhos, pontos de entrada, controle de acesso por usuário e rotinas de integridade. Para leitura, é arriscado. Para escrita, é inaceitável: o agente grava um registro que o ERP nunca validou.

2. Robô operando a interface. Automação que simula cliques funciona, mas é frágil. Uma mudança de tela na próxima atualização de release basta para quebrar o fluxo, e o rastro de auditoria fica confuso.

3. API REST padrão TOTVS. É o único caminho em que o agente passa pela mesma regra que o usuário passa. A chamada é autenticada, registrada e processada pela camada de negócio do ERP.

O que já existe pronto no Protheus

Boa parte das empresas não sabe, mas a TOTVS mantém um catálogo das APIs nativas no portal api.totvs.com.br, com a documentação de métodos, parâmetros e respostas. Antes de encomendar qualquer desenvolvimento, vale conferir o que a sua release já entrega.

Essas APIs seguem o Guia de Implementação de API da TOTVS, um padrão único que, na prática, é muito adequado para agentes de IA:

  • Paginação com page, pageSize e hasNext. O agente consulta em blocos, em vez de tentar trazer uma tabela inteira de uma vez.
  • Parâmetro fields. O agente pede apenas os campos de que precisa, o que reduz a carga no AppServer e o volume de dados enviados ao modelo.
  • Filtros e ordenação padronizados. Filtros simples por parâmetro, filtros complexos no padrão OData v4 e ordenação com order. A mesma lógica funciona em qualquer entidade.
  • Coleções no formato items. Resposta previsível, fácil de interpretar.
  • Erros estruturados. Toda falha retorna code, message e detailedMessage, o que permite ao agente entender o problema em vez de repetir a chamada às cegas.
  • Versionamento na URL. Mudanças de estrutura não quebram integrações que já estão em produção.

A autenticação também é padronizada: o Protheus oferece uma API própria para obtenção de token de acesso às APIs REST, com renovação por refresh token, documentada no TDN.

E o MCP?

O Model Context Protocol, padrão aberto para conectar assistentes de IA a sistemas, já começou a aparecer no ecossistema Protheus. Um exemplo é um projeto open source publicado no GitHub que expõe seis ferramentas de diagnóstico do ambiente, como processos do AppServer, consultas longas e sessões bloqueadas no banco. Dois detalhes desse projeto merecem atenção: ele é somente leitura por decisão de projeto e não tem vínculo oficial com a TOTVS. É um bom indicador de onde o mercado está indo, e também de qual é a postura prudente: começar lendo, não escrevendo.

Checklist antes de ligar um agente no seu Protheus

  • Inventário de APIs. Levante quais APIs padrão já existem na sua release antes de desenvolver.
  • Usuário técnico dedicado. Crie um usuário exclusivo para o agente, com perfil de acesso mínimo e autenticação por token. Nunca use o usuário administrador.
  • Leitura primeiro. Comece com consultas. Escrita vem depois, e somente por APIs que passam pela regra de negócio.
  • Limites desde o primeiro teste. Defina pageSize e fields em toda chamada.
  • Log completo. Registre cada chamada com usuário, horário, endpoint e resultado.
  • Dados em ordem. O agente vai tratar o que estiver na base como verdade. Cadastro duplicado e parametrização inconsistente viram resposta errada com cara de certeza.

Conclusão

IA no ERP não é um projeto de modelo. É um projeto de integração com governança, e o modelo vem por cima. Empresas que organizarem esse acesso agora vão conseguir trocar de modelo, testar agentes novos e escalar o uso sem reescrever integração a cada mudança.

Com 21 anos como parceira TOTVS e mais de 150 implantações, a ELR Solutions ajuda empresas a mapear o que já está pronto no Protheus e a preparar a base antes de investir em desenvolvimento. Se você está avaliando agentes de IA para o seu ERP, fale com a nossa equipe.