Veja o vídeo do processo de cadastro do Adapter em: 01. Cadastro do Adapter

O modelo de mensagem que será utilizado na integração deve ser avaliado com muito cuidado. Apesar do modelo síncrono parecer o mais adequado para uma integração, isto não é de todo verdade. Em um modelo síncrono deve ser levado em consideração o tempo de processamento: O processamento do sistema que envia, a velocidade do trânsito de dados da rede e o tempo de processamento e resposta do receptor.
Isto pode acarretar um tempo de resposta ao usuário muito maior do que o normal, o que pode transformar a integração de solução ao problema. Já o modelo assíncrono, por não aguardar o retorno do processamento do receptor torna o processo mais rápido, porém, neste modelo de mensagem deve-se levar em consideração que o dado será gravado no sistema que envia a mensagem e que o processamento no receptor ocorrerá posteriormente.

Desta maneira, em algumas situações os dados irão existir no sistema de envio, mas enquanto não forem processados no receptor eles não existirão lá.

Através da Tag <Product> consegue visualizar o Software que esta recebendo ou enviando. Exemplo:

XML de envio (original): <Product version="12.1.18.0" name="RM"/>

XML de recebimento (resposta): <Product version="12" name="PROTHEUS"/>

[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=12.1.2310
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
PROFILE=1            <-------- Insira essa chave
SECURITY=0

• Para desabilitar a geração do log, basta alterar para "PROFILE=0"

• Realize o Download dos Arquivos de Portais (web_files) do Portal do Cliente
• Inclua uma pasta web dentro da Protheus Data do Sistema e insira os web_files
• Selecionar a opção: <HTTP> e clicar na barra superior <Editar> conforme exemplo
• O sistema apresentará a tela para Configuração da Seçãoonde os principais campos são:
  
  1. Flag para Habilitar o Protocolo
  2. Path de Arquivos = Caminho da Pasta Web
  3. Ambiente = Nome do Ambiente
  4. Porta de Conexão = Porta de configuração dos Serviços
     
     

Basta confirmar e gravar as configurações

• Realize as configurações básicas, campos importantes:
  1. Módulo Web = WS - TOTVS Linha Protheus Web Services
  2. Nome da Instância = ws
  3. Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws"
  4. Selecione o Environment = Nome do Ambiente
  5. Flag para habilitar processos na inicialização do Servidor
     
     
• Realize a Configuração de Host x Empresas/Filiais, campos importantes:
  1. Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP)
  2. Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba)
  3. Clique em "Relacionar" e em "Avançar"
     
     
•  Realize a Configuração de Usuários, onde irá definir o número mínimo e máximo de usuários para acesso

Finalizar e confirmar a configuração.

[HTTP]

ENABLE=1

PORT=81

[localhost:92/ws]

ENABLE=1

PATH=c:\seuambiente\Protheus_Data\web\ws

ENVIRONMENT=12.1.025

INSTANCENAME=ws

RESPONSEJOB=JOB_WS_9901

DEFAULTPAGE=wsindex.apw

[JOB_WS_9901]

TYPE=WEBEX

ENVIRONMENT=12.1.025                                         

INSTANCES=1,1

SIGAWEB=WS

INSTANCENAME=ws

ONSTART=__WSSTART

ONCONNECT=__WSCONNECT

LOGPROFILE = 0

PREPAREIN=99,01

SECURITY=0

Veja o vídeo do processo de configuração dos Web Services: Configurando os Web Services

O vídeo está no Google Drive do Suporte FAT / SERV / JUR, caso execute no Navegador do Chrome, a qualidade do vídeo pode ficar mais baixa, sendo esse o caso, é possível fazer o Download do arquivo e a qualidade será bem melhor.

A partir da release 12.1.33, torna-se obrigatório o uso da chave SECURITY = 0 na configuração dos WebServices no appserver.ini do AppServer: https://tdn.totvs.com/x/aiErI

Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização.

Caso a integração seja via arquivo Xml, a seguinte Tag deve ser acrescentada:

<![CDATA[

(XML Conteúdo que irá dentro da TAG)

]]>