API do TOTVS RM: APIs REST e web services com agentes de IA
O TOTVS RM oferece APIs REST e web services SOAP para ler e gravar dados, executar processos e consultas SQL cadastradas. É usado por TI de empresas e instituições que integram o RM a portais, apps e outros sistemas. O acesso é pelo servidor do próprio cliente, com usuário de integração do RM.
Os grandes recursos da API, em português claro.
Ler e gravar registros de cadastros e movimentos pelos data servers do RM.
Executar sentenças SQL do RM com parâmetros.
Disparar processos do sistema, como cálculos e integrações.
Gerar relatórios configurados no RM.
Usar as APIs publicadas para RH, financeiro e educacional, conforme a versão.
Como se acessa a API do TOTVS RM.
- Com credencial da sua empresaUsuário de integração do RM com permissões de perfil, autenticado por usuário e senha ou token, no servidor da própria empresa.
- Documentação oficialtdn.totvs.com
- Libere só data servers e consultas necessários no perfil do usuário.
- O RM fica no ambiente do cliente: combine rede e VPN com o TI.
- Dados de folha são pessoais e sensíveis pela LGPD.
- api totvs rm
- totvs rm api rest
- totvs rm web service
- totvs rm dataserver
- integração totvs rm
- totvs rm consulta sql api
O que um agente do iTeam faz com a API do TOTVS RM.
O agente consulta férias, banco de horas e holerite no RM e responde no Teams ou WhatsApp.
Pedidos de compra ou reembolso chegam ao aprovador com histórico e orçamento consultados no RM.
O agente lê títulos em aberto e conduz a negociação dentro da política aprovada.
O agente roda consultas SQL cadastradas e monta o fechamento para a controladoria.
Da credencial ao agente trabalhando, com aprovação.
Criar o usuário de integração
O TI cria no RM um usuário de integração com perfil restrito e publica os serviços REST ou SOAP necessários.
Definir permissões por agente
No iTeam, a credencial do TOTVS RM vai para o cofre e cada agente ganha uma lista fechada de ações (executar consultas, ler cadastros). Ações que alteram dados exigem aprovação de uma pessoa.
Validar em pequeno e depois ampliar
Comece por um caso: rode uma consulta SQL cadastrada de leitura. Com o resultado conferido, o processo ganha mais volume, sempre com auditoria e aprovação onde houver risco.
Dúvidas sobre a API do TOTVS RM.
A API do TOTVS RM é gratuita?
As APIs fazem parte do produto; o uso depende das licenças e da versão do RM contratadas com a TOTVS.
Preciso programar para usar a API do TOTVS RM com o iTeam?
Não precisa. O iTeam lê a documentação da API do TOTVS RM, monta as chamadas e o time de implantação ajusta o fluxo com você. O que fica com a empresa é aprovar e acompanhar.
O RM precisa estar na nuvem da TOTVS?
Não. O agente acessa o servidor do RM onde ele estiver, desde que o TI libere a conexão de forma segura.
Como um agente de IA acessa o TOTVS RM?
Pelas APIs REST por módulo e pelos web services do RM, que ficam no servidor da própria empresa, com um usuário de integração do RM. A documentação está no TDN da TOTVS. Confirme com seu TI qual versão do RM roda, quais serviços estão publicados e se a rede permite que o agente alcance o servidor.
O que são data servers e consultas SQL cadastradas no RM?
Data servers leem e gravam registros de um módulo, e as consultas SQL cadastradas são consultas pré-aprovadas, expostas como serviço. Para um agente, a consulta cadastrada é uma forma controlada de ler dados: o TI define o SQL e o agente só informa os parâmetros, sem acesso livre ao banco.
O RM precisa estar na nuvem da TOTVS para o agente funcionar?
Não: o RM costuma ficar no ambiente do cliente, e o agente se conecta a ele por rede. O desafio é a conectividade segura, como VPN ou publicação controlada do serviço, combinada com o TI. Se o RM roda na nuvem da TOTVS, o endereço muda, mas o mesmo modelo de usuário de integração se aplica.
Como limitar o que o agente enxerga no RM?
Criando um usuário de integração com perfil restrito e liberando apenas os data servers e consultas necessários. Dados de folha são pessoais e sensíveis, e o agente de finanças não precisa deles. O RM aplica as permissões do perfil às chamadas, então o desenho de acesso é feito uma vez e vale para todas.
Quais tarefas um agente assume sobre dados do RM?
Consultar títulos a pagar e receber, listar pedidos, conferir cadastros e montar um resumo do fechamento. Também pode responder a perguntas de colaboradores sobre o próprio holerite, se o acesso permitir. Gravações passam por aprovação de quem tem a alçada. O iTeam registra quem pediu e o que o agente consultou.
Existe ambiente de homologação do RM para testar o agente?
Em geral, empresas com RM mantêm uma base de homologação, e é nela que o agente deve ser testado primeiro. Não é um sandbox da TOTVS: depende de o TI ter esse ambiente. Se não houver, restrinja o início a consultas de leitura em produção.
Preciso de desenvolvedor para conectar o RM a um agente de IA?
Precisa de alguém que conheça o RM: configurar usuário, publicar serviços, cadastrar consultas e liberar rede exigem o TI ou o time TOTVS da empresa. A parte do agente é configurada na plataforma a partir da documentação. O diagnóstico inicial mapeia quais módulos têm serviço pronto e quais exigem desenvolvimento.
Quando um agente de IA sobre o TOTVS RM não vale a pena?
Quando a base tem cadastros inconsistentes, ninguém mantém o serviço publicado, ou o relatório fixo do próprio RM já responde. Nesse cenário, o agente só amplifica a confusão. Vale quando analistas gastam o dia cruzando o RM com planilhas e e-mails, e o dado já é confiável.
