Histórico da Página

Olá, através dessa documentação vamos te ajudar a fazer algumas configurações no seu Appserver que são pré-requisitos para a integração entre TOTVS Protheus e TOTVS OMNI, sendo elas:

[general]
maxStringSize=100

***  TOTVS S.A.  ***
***   www.totvs.com.br    ***
TOTVS - Build 7.00.131227A - Aug 29 2014 - 09:32:37

'TOTVS' console mode.
Press Ctrl+Break to terminate.
*** SERVER BUILD WITH DUAL-STACK SOCKETS FOR IPV6 IMPLEMENTATION
*** STARTING SERVER WITH PRECISION FLOATING POINT ARITHMETIC
*** STARTING SERVER WITH MAXIMUM STRING SIZE LIMIT SET TO 100 MB. ***

Após realizar a configuração da chave maxStringSize, é necessário realizar a configuração da chave MemoMega no TOTVS | Application Server. Abaixo o exemplo para configuração do arquivo Appserver.ini.

[DBAccess]
MemoMega=100

A chave MemoMega é substituida caso na seção de ambiente a chave TOPMemoMega esteja configurada para o ambiente.

• Por que devo realizar a configuração do serviço REST no Appserver.ini ? 

Para que o EAI Protheus seja capaz de receber mensagens do TOTVS OMMNI(para o envio o Protheus não faz o consumo do seu serviço Web, e sim do serviço do outro sistema) é necessário que seja habilitado o protocolo HTTP/REST no servidor e que as configurações de WebServices estejam ativas. Para isso é necessário configurar o arquivo appserver.ini do servidor Protheus. 

• Agora que você já sabe porque devemos configurar o REST no Appserver.ini, vamos realizar a configuração através desta pagina: Configuração REST SERVER - Protheus. Abaixo um exemplo da configuração do REST.

;===========================REST=================================

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=SEU_AMBIENTE

[HTTPV11]
Enable=1
Sockets=HTTPREST


[HTTPREST] 
Port=SUA_PORTA
IPsBind=
URIs=HTTPURI
Security=1

[HTTPURI]
URL=/rest
PrepareIn=SUA_EMPRESA
Instances=1,1  

;===========================REST=================================

[ONSTART]
Jobs=HTTPJOB

A porta informada na chave Port, deve ser uma porta liberada para IP externos, para que seja possível o a comunicação e envio/recebimentos de dados entre o TOTVS Protheus e TOTVS OMNI.

[24/10/2022 17:25:56] Totvs Application Server is running

Starting Job [HTTPJOB]

Starting Job [186F49545DDE1F4FAB54C91BB1151F76APP_MONITOR_THREADPOOL]

  _____   ______   _____  _______
 |  __ \ |  ____| / ____||__   __|
 | |__) || |__   | (___     | |
 |  _  / |  __|   \___ \    | |
 | | \ \ | |____  ____) |   | |
 |_|  \_\|______||_____/    |_|   Ver. 2.0

*** Loading dbapi.dll

[INFO ][SERVER] [DBAPI] Using DBAPI Memory Control Functions.
*** dbapi.dll Build 20220303-20220720 RELEASE (API Version: 22.1.1.0_ts08)

[INFO ][SERVER] [Thread 21036] JOB Thread finished [-FWHTTPPREPARE]
URI HTTPURI sem configuracao de PrepareIn.

HTTPV11 is ready.
  Listening port 8036
  URL Paths /rest/

Image Added

Caso tenha definido um caminho para o serviço REST em URL o mesmo deve ser considerado no caminho do serviço.

Isso evita erros como: {"code":404,"detailedmessage":"","message":"The server can't find the requested resource."}

Ex :

[HTTPURI]
URL=/exemplo

então o caminho ficaria: http://127.0.0.1:8036/exemplo/totvseai/standardmessage/v1/transactions/

O EndPoint do serviço REST configurado deve ser disponibilizado para o time do TOTVS OMNI, para o TOTVS OMNI conseguir conexão com seu ambiente.

No Protheus, cada grupo de empresas é um aplicativo diferente para o EAI. Desta maneira, cada grupo de empresas deve possuir um endereço REST diferente. Caso seja recebida uma requisição para um endereço cujo grupo de empresas é diferente do enviado, a seguinte mensagem será apresentada: O grupo de empresas do aplicativo  não corresponde ao grupo de empresas deste serviço. Grupo recebido - (A). Grupo do serviço - (B) , onde A e B são respectivamente o grupo recebido na requisição e o grupo de empresas do endereço REST

O que é o GravaBtach e por que preciso configura-lo?

O GravaBatch é um serviço de extrema importância pois é responsável pelo processamento da venda(gera financeiro/Baixa de estoque, geração de Pedido/Livros fiscais etc.).

Este serviço deve ser configurado para as filiais utilizadas na integração.

Este serviço deve ser configurado no seu appserver.ini, abaixo o exemplo de configuração

[Integracao_ERP]
Main=LJGRVBATCH
Environment=SEU_AMBIENTE
nParms=2
Parm1=_CODIGO_EMPRESA
Parm2=CODIGO_FILIAL

[ONSTART]
Jobs=Integracao_ERP

Para maiores detalhes da configuração do serviço acesse: Detalhes GravaBatch

Agora que já realizamos as configurações no Appserver, vamos realizar alguns cadastros e parametrizações no modulo Configurador (SIGACFG) do TOTVS Protheus. Vamos lá...