O Web Service TOTVS RM é um grande facilitador para se trabalhar com integração, executar processos internos ou compartilhar dados com contatos externos.

Com o objetivo de facilitar e agilizar o compartilhamento de dados e informações entre usuários internos e externos, clientes, fornecedores e parceiros, a TOTVS disponibilizou o recurso Web Service TOTVS RM.

Sua configuração é simples e pode ser realizada via IIS ou Host do RM. O primeiro passo para habilitar a ferramenta é ter acesso de administrador ao servidor e permissão de escrita no diretório de instalação do TOTVS RM.

Habilitando o Web Service TOTVS RM com Host

Para definir os parâmetros do Web Service TOTVS RM via Host, deve-se acessar o diretório \TOTVS\ [Alias] \RM.net e abrir em um editor de texto os seguintes arquivos: RM.Host.exe.config e RM.Host.Service.exe.config. Dentro da tag appSettings insira os parâmetros:  

<add key=”defaultdb” value=”CorporeRM” />   (esse é o alias do banco)

<add key=”httpport” value=”8051″ />   (essa é a porta do Host por onde o Web Service será executado)

Agora basta adicionar o endereço do Web Service por meio do promt command e executá-lo com o seguinte comando, que reservará uma url e a porta 8051 para que o Host do RM consiga prover os Web Service neste servidor, na porta configurada : netsh http add urlacl url=http://+:8051/ user=NetworkService

Reinicie o host do TOTVS RM, valide se o processo funcionou e, por fim, acesse seu Web Service.

Para expor os Web Services para acesso externo, torna-se necessária a inclusão da tag: <add key=”ServicesHostName” value=”ip externo OU nome externo” />  onde seu valor deverá ser o DNS ou IP Público da instituição. Por mais que o acesso seja sempre autenticado, cabe uma análise detalhada quanto aos aspectos de segurança.

Se estiver usando o Web Service pelo WsDataServer, deve adicionar a tag: <add key=”WebServiceCulture” value=”Invariant” />. Esse parâmetro define o ponto (.) como separador decimal, seja qual for a cultura definida no sistema operacional.

Habilitando o Web Service com IIS

O primeiro passo para habilitar o Web Service com IIS é instalar o TOTVS Business Connect para que torne possível as integrações padrão do sistema, que são:

  • TOTVS Obras e Projetos – integrada ao – BackOffice Protheus;
  • TOTVS Educacional – integrada ao – BackOffice Protheus;
  • TOTVS Educacional – integrada ao –  EAD (WebEnsino e AMS).
  • TOTVS Incorporação – integrada ao –  BackOffice Protheus;
  • TOTVS Protheus SigaMNT – integrada ao –  Linha RM; e,
  • TOTVS SigaLoja / FrontLoja – integrada ao –  BackOfficeRM.

A instalação do TOTVS Business Connect para o IIS depende da configuração do Internet Information Service, além de demais subcomponentes do IIS como Windows XP ou superiores.

Para configurar o Web Service para integrar com aplicativos de terceiro (diferentes dos da TOTVS), deve-se fazer uso dos serviços hospedados no Host do TOTVS RM.

Caso precise alterar a porta do Web Service ou a url, deve-se atualizar os valores da tag httpport nos arquivos de configuração, e, na sequência remover a acl para a url/porta atual (netsh http delete urlacl url=http://+:8051/ user=NetworkService), definindo uma nova regra para a atual url ou portal.

Se tiver dúvidas ou dificuldades sobre como habilitar e utilizar o Web Service TOTVS RM, nós podemos ajudar. A CRM Services conta com o maior corpo de analistas especialistas do país, com larga experiência em implementações, desenvolvimento e configurações técnicas dos ERPs. Entre em contato e saiba mais.