API do TOTVS Protheus: o que dá para fazer e como usar com agentes de IA

As APIs fazem parte do Protheus, mas habilitar serviços, licenças de uso e customizações podem ter custo conforme o contrato com a TOTVS ou a consultoria.

Não necessariamente. O iTeam lê a documentação dos serviços e o time de implantação configura com o seu TI; customizações em AdvPL só se o processo exigir.

Sim, desde que os serviços REST estejam habilitados e acessíveis; isso é verificado no diagnóstico.

Segundo a documentação da TOTVS no TDN, os serviços REST do Protheus aceitam autenticação Basic, OAuth 1 e OAuth 2, com usuário de integração do próprio ERP. Nas versões mais novas, a ausência da chave de segurança no appserver.ini faz o serviço exigir autenticação. Confira na documentação oficial o caminho exato do token para a sua versão do AppServer.

Porque o Protheus é muito customizado: rotinas em AdvPL ou TL++, campos próprios e serviços REST habilitados de forma diferente em cada ambiente. Uma consulta de pedido que funciona numa empresa pode não existir em outra. Por isso o primeiro passo é levantar com o TI ou a consultoria quais serviços estão ativos e quais campos são usados no seu caso.

Pelos recursos informados, dá para trabalhar com cadastros, pedidos de venda e compra, estoque, financeiro e faturamento. Exemplos: consultar a posição de um pedido para responder ao cliente, checar saldo de estoque antes de prometer entrega, listar títulos vencidos para cobrança. Inclusões e alterações no ERP pedem homologação e aprovação, então o agente começa lendo.

O Protheus não traz um sandbox público; a prática é usar um ambiente de homologação da própria empresa, cópia do produtivo mantida pelo TI ou pela consultoria. É nele que se valida o usuário de integração e as rotinas antes de tocar em produção. Confirme com quem administra o seu Protheus se esse ambiente existe e como ele é atualizado.

Crie um usuário exclusivo para a automação e libere só as rotinas e filiais necessárias, como o cuidado listado para esta integração recomenda. Assim, um agente que consulta pedidos de uma filial não alcança o financeiro de outra. Esse desenho também facilita auditoria, porque tudo o que o usuário fez fica identificado. Revise as permissões quando a integração ganhar novas funções.

Pode ficar, porque cada consulta usa o servidor do ERP, que atende também o resto da empresa. Não encontrei limites oficiais divulgados, então converse com o TI sobre capacidade e horários. A boa prática é consultar apenas o necessário, guardar resultados repetidos por um tempo e deixar relatórios pesados para fora do horário de pico.

Para regras estáveis, uma rotina fixa é mais barata e previsível. O agente compensa quando há exceção e interpretação, como pedido com cliente bloqueado, divergência de preço ou mensagem de cliente pedindo status em texto livre. Ele junta dados do ERP, do CRM e da conversa e encaminha para a pessoa certa. Para casar um campo com outro, rotina basta.

A entrada é em modo de leitura, validando as consultas num ambiente de homologação, e só depois se discute escrita. O iTeam guarda as credenciais em cofre e registra cada ação do agente, e alterações sensíveis ficam pendentes até a aprovação de quem tem a alçada. O ponto de partida é o diagnóstico em uma semana, que mapeia o que o seu ambiente expõe.