AMBIENTE LINHA RM E BACKOFFICE PROTHEUS

Processo

Subprocesso

Ambiente
Montagem de Ambiente com Linha RM e BackOffice Protheus.

Data da publicao

10/12/2012

Este documento ir abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja

integrao utilize Mensagem nica.
um documento geral que no aborda a parte de configurao da integrao em si. Aps a montagem do
ambiente, devem ser realizadas as configuraes referentes a integrao que se encontram na especificao
da mesma.

Contedo
1.

Pr Requisitos .................................................................................................................................................................... 3
1.1 Obtendo Arquivos ............................................................................................................................................................... 3
1.2 Atualizaes Protheus ......................................................................................................................................................... 3

2.

Instalao .......................................................................................................................................................................... 5
2.1 RM ....................................................................................................................................................................................... 6
2.2 Protheus .............................................................................................................................................................................. 6
2.3 DBAcces ............................................................................................................................................................................... 9

3.

Configurao.................................................................................................................................................................... 12
3.1 Protheus Banco de dados ............................................................................................................................................... 12
3.1.1 Configurando Banco SQL .............................................................................................................................................. 15
3.1.2 Configurando Banco Oracle .......................................................................................................................................... 18
3.1.3 Configurando Conexes no DBAcces ............................................................................................................................ 24
3.2 Protheus AppServer ........................................................................................................................................................ 29
3.3 Protheus WS Protheus ..................................................................................................................................................... 29
3.4 TOTVS Business Connect ................................................................................................................................................... 42
3.5 Painel de Controle ............................................................................................................................................................. 43
3.6 Internet Information Services (IIS) .................................................................................................................................... 44
3.7 Web.config ........................................................................................................................................................................ 50

4.

Configurao especficas da Integrao .......................................................................................................................... 53

4.1 Configuraes iniciais ........................................................................................................................................................ 53
4.2 Adapters ............................................................................................................................................................................ 60
4.3 Schedules .......................................................................................................................................................................... 66
4.4 De-para .............................................................................................................................................................................. 70

4.5 Observaes importantes ................................................................................................................................................. 79

4.6 Configuraes iniciais ........................................................................................................................................................ 80
4.7 Parametros da integrao ................................................................................................................................................. 85
4.8 Problemas frequntes ....................................................................................................................................................... 86

Desenvolvimento/Procedimento

1. Pr Requisitos
Para montar o ambiente necessrio instalar:

Protheus verso 11
RM verso 11.80
Oracle 10G | Microsoft SQL Server 2008
Nota: instale o Oracle 10G e o MSSQL caso deseje montar um ambiente com os dois tipos de banco.
Caso contrario escolha somente um.
DBAcces
IIS
SqlDbx, Developer, SQL Tools, etc.
Nota: Qualquer ferramenta para comunicar com o Banco de dados Oracle.
SOAP UI
Nota: para auxiliar na validao referente mensagem nica caso a integrao utilize a mesma.

1.1 Obtendo Arquivos

Oracle: \\fileserver\Softwares\Livres\Banco de Dados\Oracle

MSSQL: \\fileserver\Softwares\Livres\Banco de Dados\SQL Server
RM: \\tecnologiabh\Instalar\CorporeRM\Versoes\11.8x
Protheus: http://www.totvs.com/suporte/central-de-download/seu-segmento/produto/microsiga
Nota: Selecionar a opo TOTVS Application Server.(A pgina s funcionou no IE)

1.2 Atualizaes Protheus

As verses mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:

Espelho do Portal: \\172.16.103.229\espelho-portal

um diretrio interno onde se encontram os arquivos disponibilizados no portal do cliente. Entre eles
podemos destacar as seguintes pastas:
AppServer/SmartClient: Protheus11\binario referencia 700120420
Nota: abrir o arquivo .rar e copiar o contedo da pasta AppServer para a pasta bin\appserver
do seu computador. Fazer o mesmo para a pasta SmartClient.
RPO: Protheus11\1-apo-BRA-CHI-EUA-PAR-URU\topconnect
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho D-1.

Updates: Protheus11\2-update-BRA-CHI-EUA-PAR-URU\topconnect
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho D-1.
Dicionrios/Help Campos/Menus: Protheus11\Systemload
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho ATUSX.
DBAccess: Protheus11\TOTVS DBAccess

D-1: \\172.16.103.229\d-1
um diretrio onde so armazenadas as compilaes dirias do Protheus. Semelhante a CM do RM.
Esta pasta e atualizada automaticamente com os ltimos fontes liberados no TFS. Selecione a pasta
P11.
A nomenclatura do RPO XX-X-X-000; onde:
tt - TOTVS;
a, c, d, t - ads, codebase, ctree, topconnect
e, p, s - english, portuguese, spanish
110 - Verso do Protheus

ATUSX: \\172.16.93.23\temp
um diretrio onde so disponibilizados diariamente as ultimas verses dos dicionrios, dos menus e
dos arquivos de help cadastrados no ATUSX.
ATUSX: Gerenciador de base de dados, helps e CHs. O ATUSX a ferramenta utilizada na criao e
manuteno de:
Dicionrios:
ndices (SIX)
Perguntas (SX1)
Arquivos (SX2)
Campos (SX3)
Tabelas genricas (SX5)
Parmetros (SX6)
Arquivos .CH
Menus do sistema
Tabelas Padro
Help de campos e mensagens

Gatilhos (SX7)
Relacionamentos (SX9)
Pastas (SXA)
Consultas Padro (SXB)
Grupo de campos (SXG)

2. Instalao
2.1 RM
Utilizar a verso 11.82.26.108 (ou superior)
A verso 11.80 da linha RM utiliza internamente o novo modelo de estoque/compras e financeiro.
A TOTVS disponibiliza um backup da base de dados RM vazia que pode ser utilizada para novos clientes. Para clientes que j possuem
verso anterior utilizar o Conversor RM para atualizar o banco de dados.
O TIN j est 100% migrado para a plataforma .net, por isto os clientes podem usar a nova MDI (RM.exe) para todas as suas
funcionalidades, no sendo mais necessrio instalar o RMSGI.exe (instalador TOTVSIncorporacao*.msi).
http://interno.totvs.com/suporte/central-de-download/seu-segmento/produto/rm

2.2 Protheus
O setup da instalao pode ser baixado atravs do seguinte link: http://www.totvs.com/suporte/central-dedownload/seu-segmento/produto/microsiga escolhendo opo TOTVS Application Server.

Este setup far o download do Protheus.

Aps a instalao, os seguintes cones sero gerados:

]
Clicando em Server Configuration Assistent, abrir uma tela de configurao do Protheus.

Caso utilize o instalador acima, clique em TOTVS | Application Server.

Obs: Este modelo de instalao no o obtido atravs do site http://www.totvs.com.
Concluda a instalao, acesse o diretrio onde esta o Protheus e localize a pasta bin\appserver. Crie um atalho na
rea de trabalho para o appserver.exe. Localize a pasta bin\smartclient e faa o mesmo para smartclient.exe.
Selecione o atalho do appserver na rea de trabalho e abra as propriedades do mesmo. No campo Destino insira no
final do caminho: -console.

Selecione tambm o atalho do smartclient e abra as propriedades do mesmo. No campo Destino insira no final do
caminho: -m. Isso ir permitir abrir mais de uma instncia do smartclient.

2.3 DBAcces
Execute novamente o instalador do Protheus e selecione a opo TOTVS | DBAcces. A instalao bem intuitiva.

Aps abra o local onde foi instalado o DBAcces.exe, e no caminho do diretrio, insira no final install.

O DBAcces ser instalado como servio.

Observao:
Outra maneira de configurar o DBAcces sem instalar como servio :

10

Abra a pasta onde o DBAcces foi instalado e crie um atalho do DBAcces.exe e do DBMonitor.exe na rea de
trabalho. Selecione o atalho do DBAcces e abra as propriedades do mesmo. No campo Destino, no final do
caminho insira: -console.

Aps basta iniciar o DBAcces:

Importante!! Quando o DBAcces iniciado dessa forma, sempre que for fechar necessrio digitar CTRL + C,
e YES para confirmar. Aps necessrio aguardar o aplicativo fechar sozinho. Este procedimento deve ser
realizado para no dar inconsistncias na base.
11

3. Configurao
3.1 Protheus Banco de dados
Para criar um ambiente com dois tipos de bancos, acesse o diretrio do Protheus, pasta apo: C:\TOTVS
11\Microsiga\Protheus\apo
Crie duas pastas: MSSQL e ORACLE.

Copie o arquivo RPO para dentro de cada uma das pastas.

O arquivo obtido no caminho D-1: \\172.16.103.229\d-1 pasta P11. Selecione o arquivo tttp110.
Nota: Escolha o arquivo que corresponda ao ambiente que deseja criar. Neste caso, o arquivo refere-se ao topconnect,
linguagem portuguesa, verso 110. A nomenclatura dos arquivos RPO est detalhada no incio do documento, na parte
de Atualizaes Protheus.

12

Observao:
Caso esteja montando ambiente apenas para um tipo de banco, basta no criar as pastas ORACLE e MSSQL,
e copiar o arquivo RPO direto para a pasta Protheus\apo

Copie os arquivos de dicionrio para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\system. Selecione apenas os

arquivos .xnu que so os arquivos de menu.
Os arquivos so encontrados em: \\172.16.93.23\temp\20121128\rel\txt\bra
Nota: Sendo que 20122128 a data (AAAAMMDD). Selecione a pasta com a data mais atual.

13

Copie os outros dois arquivos - sx2.unq e sxsbra.txt - que so arquivos de dicionrio, para a pasta: C:\TOTVS
11\Microsiga\Protheus_Data\systemload

Para um ambiente com os dois tipos de banco, faa uma cpia da pasta Protheus_Data e renomeie uma pasta para
Protheus_oracle e a outra Protheus_mssql.

14

3.1.1 Configurando Banco SQL

So necessrias duas bases, uma para o RM e outra para o Protheus.
Para o RM, restaure e configure a base desejada normalmente. Para o Protheus no necessrio restaurar uma base.
O Protheus cria as tabelas necessrias para o seu funcionamento de forma automtica, sendo necessria apenas a
configurao apontando para uma database vazia.
Para criar uma nova database no SQL Server conecte-se no mesmo, clique com o boto direito em cima de Databases
e selecione New Database.

Informe o nome da base no campo Database name e clique em ok.

As bases foram criadas.

Para a base Protheus necessrio criar um ODBC com o programa odbcad32. Abra o programa, selecione a aba Fonte
de Dados de Sistema, e clique em Adicionar.

15

Selecione a fonte de dados SQL Server e clique em Concluir.

Informe o nome da base de dados protheus criada anteriormente e o servidor. Clique em Avanar.

16

Clique em Avanar.

Selecione Alterar o banco de dados padro para, escolha a base de dados protheus e clique em Avanar.

Caso deseje, altere o idioma. Aps clique em Concluir.

17

Uma janela contendo o resumo da nova fonte de dados exibida. Clique no boto Testar fonte de dados... para
validar a conexo.

Caso tudo tenha sido configurado corretamente o teste ser realizado com sucesso, como mostra a imagem abaixo:

3.1.2 Configurando Banco Oracle

Da mesma forma que no SQL, so necessrias duas instncias, uma para o RM e outra para o Protheus.
Para o RM, restaure e configure uma base de dados normalmente. Para o Protheus, iremos configurar um novo
schema no Oracle. Para isso temos que criar um usurio que ser utilizado pelo Protheus. Utilize uma ferramenta para
acessar a instncia oracle criada para o RM. O comando que ser executado deve ser rodado com o usurio sys ou
system.
18

No exemplo abaixo foi utilizado a ferramenta SqlDbx.

O comando para criar um novo usurio :

-- USER SQL
CREATE USER usurioProtheus IDENTIFIED BY senhaProtheus
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP;
-- ROLES
GRANT "RESOURCE" TO usurioProtheus WITH ADMIN OPTION;
GRANT "DBA" TO usurioProtheus WITH ADMIN OPTION;
GRANT "CONNECT" TO usurioProtheus WITH ADMIN OPTION;
ALTER USER usurioProtheus DEFAULT ROLE "RESOURCE","DBA","CONNECT";
-- QUOTAS
ALTER USER usurioProtheus QUOTA UNLIMITED ON SYSTEM;

Nota: Altere usurioProtheus para o nome do usurio que deseja criar, e senhaProtheus para a senha do usurio.
Nota: Altere usurioProtheus para o nome do usurio que deseja criar, e senhaProtheus para a senha do usurio.
Para validar se o usurio foi criado, basta logar na mesma instncia informando o usurio e senha.

19

Aps a criao do usurio do protheus devemos configurar uma nova nomeao de servio na ferramenta Oracle Net
Manager.
Selecione a pasta Nomeao de Servio no Net Manager e clique em + para criar uma nova nomeao.

20

Informe um nome para o servio de rede e clique em Prximo.

Selecione o protocolo TCP/IP e clique em Prximo.

Informe o nome do host e a porta (default 1521) e clique em Prximo. (Insira o nome da sua mquina ou
simplesmente localhost)

21

Informe o nome do SID informado na instalao do Oracle. Clique em Prximo.

Nota: O SID o nome da instncia RM do Oracle

Clique em Testar para validar se as configuraes realizadas esto corretas.

22

Clique no boto Alterar Login e informe o nome do usurio e senha criados com o script anteriormente. Clique no
boto Ok.

Aps clique em Testar. Caso a configurao tenha sido executada corretamente o teste de conexo ser bem
sucedido.

Clique em Fechar para fechar a tela de testes e depois clique em Finalizar para concluir a instalao.
Importante!
Antes de encerrar a aplicao selecione o menu Arquivo | Salvar Configurao de Rede para salvar a
configurao realizada.

23

3.1.3 Configurando Conexes no DBAcces

Aps a criao e configurao do database/schema temos que configurar as conexes no TOTVS DBAccess. Ele a
ferramenta utilizada pelo Protheus para fazer a comunicao entre o appserver e o SGBD.
Inicialize o DBAcces.
Observao
Se o DBAcces foi instalado como servio verifique se o mesmo esta ativo.

Caso tenha sido configurado da outra forma, execute o DBAcces atravs do atalho.

Aps iniciar o DBAcces, inicie o DBMonitor.

24

Para configurarmos a conexo com o SQL Server utilizaremos a aba Configuraes e depois a aba Microsoft SQL.
Clique no boto Novo, e informe a base protheus referente ao banco SQL, nome do usurio e senha.

25

Para configurarmos a conexo Oracle utilizaremos a aba Configuraes e depois a aba Oracle. Clique no boto
Novo e informe a base protheus, o nome do usurio e a senha.
Marque o checkbox Usar BLOB para campo MEMO.

Importante!
26

O DBAccess precisa que o caminho para a biblioteca do Oracle seja informada para o seu correto
funcionamento.
Fazemos isto atravs do arquivo DBAccess.ini no diretrio onde foi instalado o DBAcces. Edite o arquivo e
acrescente a propriedade clientlibrary abaixo da chave [Oracle].
Exemplo:
[ORACLE]
environments=protheus,P11
Nota: a propriedade clientlibrary deve ser igual ao caminho onde esta instalada a dll oci.dll. Podendo variar
conforme escolha do diretrio de instalao do DBAcces.

Aps finalizarmos a configurao das conexes podemos realizar o teste das mesmas atravs da aba Assistentes.
Clique no boto Validao de Conexo.
Clique em Avanar. Selecione o SGBD e clique em Avanar. Informe o nome da conexo criada e clique em
Finalizar.

27

28

Se a conexo foi configurada corretamente ser mostrada a janela a seguir.

Realize o mesmo teste para a base oracle.

3.2 Protheus Appserver.ini

Nesta segunda parte da configurao do Protheus, iremos configurar o arquivo appserver.ini. Ele se encontra na pasta
appserver, no diretrio onde foi instalado o Protheus: C:\TOTVS 11\Microsiga\Protheus\bin\appserver

29

Seo Environment
Deve possuir as propriedades:
[Environment]
SOURCEPATH=pasta onde se encontra o RPO
ROOTPATH=pasta protheus data
STARTPATH=nome da pasta system
RPODB=tipo de conexo (TOP)
RPOLANGUAGE=linguagem do RPO (Portuguese)
RPOVERSION=verso do RPO (110)
LOCALFILES=tipo dos arquivos locais (ADS)
LOCALDBEXTENSION=extenso das tabelas locais (.dbf)
PICTFORMAT=DEFAULT
REGIONALLANGUAGE=localizao (BRA)
TOPSERVER=endereo do DBAccess
TOPPORT=porta do DBAccess (7890)
TOPDATABASE=banco de dados (MSSQL/ORACLE)
TOPALIAS=alias do banco Protheus
TOPALIASRM=alias do banco RM

Notas:
o Algumas propriedades podem se encontrar na sesso DBAcces. Neste caso, retire as mesmas dessa
sesso e transfira-as para a sesso Environment, inserindo TOP na frente. A sesso DBAcces deixa
de existir.
o Altere o nome Environment por um nome que represente a conexo que est sendo criada.
o Caso esteja montando dois ambientes Oracle e MSSQL basta criar outra seo Environment,
renomeando a mesma.
Realizada as alteraes, a seo ficar assim:

30

Seo Geral
Deve possuir as propriedades:
[GENERAL]
InstallPath=pasta do Protheus
console=loga no console (0/1)
BuildKillUsers=desconecta todos os usurios quando compilar o RPO (0/1)
LogEnable=habilitar arquivo de log (0/1)
ConsoleLog=loga no console (0/1)
consolemaxsize=tamanho mximo do log (10000000)
ConsoleFile=arquivo de log
Segmento=cYdTm3WWERZF=1hu
Serie===AV

Realizada as alteraes, a seo ficar assim:

31

Seo de Servio
Deve possuir as propriedades:
[SERVICE]
Name=Protheus11
DisplayName=Protheus 11

Nota: Caso no exista no arquivo deve ser includa.

Realizada as alteraes, a seo ficar assim:

Sees [TCP], [Drivers] e [GENTCPIP]

Devem possuir as propriedades:
[TCP]
TYPE=TCPIP
Port=porta do appserver
32

[Drivers]
Active=TCP
[GENTCPIP]
Enable=0

Notas:
o Caso no existam no arquivo as sees devem ser includas.
o A porta informada na seo TCP deve ser informada tambm no arquivo smartclient.ini na seo.
Realizada as alteraes, as sees ficaro assim:

Seo LICENSECLIENT
Deve possuir as propriedades:
[LICENSECLIENT]
server= servidor
port= porta

Realizada as alteraes, a seo ficar assim:

33

Segue descritivo da Configurao do INI para o WebService. (EXEMPLO)

Primeira Pgina:
[ws]
SourcePath=E:\Protheus11\APO_WS
RootPath=E:\Protheus11\Protheus_Data
StartPath=\system\
x2_path=
RpoDb=Top
RpoLanguage=portuguese
RpoVersion=110
LocalFiles=ads
Trace=0
localdbextension=.dbf
PictFormat=DEFAULT
DateFormat=DEFAULT
RegionalLanguage=BRA
THEME=STANDARD
helpserver=help.outsourcing.com.br/p11/
;IXBLOG=NORUN
[DBAccess]
DataBase=MSSQL
Server=192.168.1.3
ALIAS=DADOSP10
PROTHEUSONLY=0
[Drivers]
Active=TCP
[TCP]
TYPE=TCPIP
Port=3333
[General]
InstallPath=E:\Protheus11

Segunda Pgina:
[HTTP]
ENABLE=1
PORT=84
RpcEnable=0
instances=1,10
SessionTimeout=30000
HyperHsEnv=1
Cache-control=no-store
PATH=E:\Protheus11\Protheus_Data
RESPONSEJOB=JOB_WSINTEGRACAO_T1_MSP11
[192.168.1.3:84]
ENABLE=1
environment=ws
PATH=E:\Protheus11\Protheus_Data
INSTANCENAME=JOB_WSINTEGRACAO_MSP11
DEFAULTPAGE=wsindex.apw
RESPONSEJOB=JOB_WSINTEGRACAO_MSP11
[JOB_WSINTEGRACAO_MSP11]
TYPE=WEBEX
INSTANCES=1,10
SIGAWEB=WS
INSTANCENAME=status
ONSTART=__WSSTART
ENVIRONMENT=ws
ONCONNECT=__WSCONNECT
;PREPAREIN=99,01
Trace=1
;COMANDO PARA MOSTRAR LOG E ERROS
XMLSAVEALL=1
NameSpace=http://www.totvs.com.br
WEBSERVICELocation=http://192.168.1.3:84
URLLocation=http://192.168.1.3:84

[LICENSESERVER]
enable=0
port=5555
ShowStatus=1
[LICENSECLIENT]
server=192.168.1.3
port=5556
[TDS]
allowApplyPatch=*
[SERVICE]
NAME=Protheus11Service-ws
DISPLAYNAME=TOTVS - ServerWS

34

3.3 Protheus WS Protheus

Abra o SmartClient com SRVWIZARD

Em mdulo web selecione WS Microsiga Protheus 11 Web Services

Nome da instancia = EAI
O diretrio raiz preenchido automaticamente
Selecione o enviroment (Ambiente)

O parmetro habilitar processos faz o WS subir automaticamente com o appserver e criar a tag ONSTART=__WSSTART
no .ini

35

Neste assistente, necessrio informar no host:

Localost, o ip da mquina e o nome da mquina, como no exemplo abaixo

Ao adicionar cada host, necessrio em seguida selecionar a filial (no necessrio fazer o procedimento para todas as filiais)
E clicar em relacionar. O registro aparecer na parte de baixo da janela.

Insira o nmero mnimo de usurios e o nmero mximo. Clique em avanar.

36

Sim

Clique em ok e reinicie o appserver.

O wizard cria como padro na porta 80. Poder acontecer conflito caso haja o IIS rodando na mquina, que
tambm roda na porta 80.
Para alterar a porta, necessrio acessar o appserver.ini realizara a alterao como no exemplo:

37

Testando o WS

38

Caso no esteja modo console, poder ser visualizado via log

http://localhost:8095/EAISERVICE.apw?WSDL
http://10.31.8.37:8095/EAISERVICE.apw?WSDL
http://bhd0005396:8095/EAISERVICE.apw?WSDL

39

Para configurar o EAI precisamos cadastrar o job que ir monitorar a fila de integrao. Esta configurao feita no
mdulo SIGACFG do Protheus.
Inicie o appserver, e aps o smartclient. Informe usurio e senha.
Nota: caso o protheus tenha sido instalado desde o zero, ser necessrio realizar algumas configuraes antes de
acessar o mdulo SigaCFG:
Escolha a localizao.

Informe o diretrio dos arquivos de dados (selecione a pasta data).

Informe o valor das Moedas

40

Acesse: Ambiente | Schedule | Schedule. Aps: Schedule | Agent | Cadastro

Clique em Incluir para cadastrar o JOB. Insira as informaes solicitadas e salve o cadastro.

41

Depois em Agendamento|Cadastro. Clique em incluir e informe a Rotina: FWEAI e Empresa/Filial: Informe a empresa.

So necessrios rodar os seguintes updates no Protheus:

U_UPDFIN
U_UPDCTB
U_UPDSIGAFIS
Estes updates so inseridos na tela inicial do mdulo (aonde inserimos o nome do mdulo)

3.4 TOTVS Business Connect

Para instalar os web services execute o instalador do TOTVS Business Connect.
O aplicativo esta disponvel em: \\tecnologiabh\Instalar\CorporeRM\Versoes

42

Nota: Quando o IIS instalado aps o Visual necessrio rodar um comando para aplicar algumas configuraes antes
instalar o web service:
Abra o prompt de comando e acesse o diretrio: C:\Windows\Microsoft.NET\Framework\v4.0.30319
Aps execute o comando aspnet_regiis -1.

Aps executar o comando, rode o instalador TOTVS Business Connect para instalar o web service

3.5 Painel de Controle

Antes de abrir o IIS, abra o Painel de Controle e acesse a parte referente a Programas e Recursos. Clique em Ativar
ou desativar recursos do Windows.

43

Verifique se todas as opes referentes a Servios de Informaes da Internet esto selecionadas. Caso no esteja,
selecione e salve as alteraes.

3.6 Internet Information Services (IIS)

Abra o IIS.

44

Selecione Pools de Aplicativos e verifique se todos os servios esto iniciados.

Selecione: Sites | Default Web Site | TOTVBusinessConnect. Do lado direito selecione Configuraes Avanadas.

45

Em Pool de Aplicativos deve estar Classic .NET AppPool.

Nota: Tambm pode estar preenchido com ASP.NET v4.0 Classic ou TOTVSBusinessConnect

Aps realizar a configurao do Pool de Aplicativos selecione TOTVBusinessConnect e clique em Autenticao.

46

Apenas a Autenticao Annima deve estar habilitada. Todas as outras devem estar desabilitadas.

Em seguida, selecione o servidor e clique em Restries ISAPI e CGI.

47

Valide se a restrio do ASP.NET v4 est como Permitido. Caso no esteja altere para este status.
Nota: Os itens listados podem estar ou no com status permitido, mas necessrio que pelo menos o ASP.NET v4 esteja
com este status.

48

Para
verificar
se
o
WebService
do
RM
est
Funcionando
utilize
a
chamada
http://Servidor/TOTVSBusinessConnect/wsEAIService.asmx?wsdl no browser, o usurio e senha que pedir ser o mesmo que foi
configurado no Protheus em Parmetros.

Para criao do De-Para das informaes j existente na base de dados das tabelas: FCFO, FLAN, GCCUSTO, TTBORCAMENTO.
Deve-se rodar o script abaixo aps ter executado a rotina de criao do De-Para no Protheus.

As configuraes do RM.Host.Service.exe.config, RM.exe.config e Web.config devem estar corretamente alinhados,

como na figura abaixo:

49

3.7 Web.config
No diretrio do RM, os web services foram instalados na pasta WS_TBC. Ser necessrio realizar alguma configuraes
no arquivo web.config.

50

Abra o arquivo e localize a tag appSettings.

Altere as tags:
Host = informe a mquina
Port = porta do host
DBAlias = alias do banco de dados RM (no momento s aceita CORPORERM)
51

JobServer3Camadas = true (apenas se o acesso for de outra mquina)

Aps alterar o arquivo ir ficar assim:

O smartclient.ini tambm deve ser verificado. Ele pode ser localizado na mesma pasta do smartclient.exe.

Para validar se as configuraes realizadas esto corretas abra o browser e informe no endereo: localhost ou IP da
mquina /TOTVSBusinessConnect/wsEAIService.asmx
Ser solicitado que informe usurio e senha para realizar a autenticao.
Nota: O usurio e senha so da base de dados que foi configurada no arquivo web.config.

52

Aps informar os dados e realizar o login, a pgina do web.service ser apresentada.

53

4. Configurao do TOTVS Incorporao

4.1 Configuraes iniciais
O WebService fundamental para integrao das funcionalidades do TOTVS Protheus com o RM TIN.
O WebService deve estar com o Servio EAISERVICE - HABILITADO, como segue figura abaixo:

importante ter um servio e um RPO do Protheus separados para o WebService. Diante disso foi criado as seguintes pastas
para o WebService:
o
o

PROTHEUS11\BIN\APPSERVER_WS (Diretrio do servio de WS)

PROTHEUS11\APO_WS (RPO do service de WS)

OBS: O Servio de WebService nico, no havendo necessidade de ter um servio por empresa.

54

Procedimento de Atualizao de Parmetros, Adapters e Schedules

Configurao de Parmetros (Por empresa)

Parmetro MV_EAIMETH Informe o mtodo de envio do EAI para envio a outro EAI - Contedo = receiveMessage.

Parmetro MV_EAIURL2 Contedo = Webservice RM (Ex: http://192.168.1.3/TOTVSBusinessConnect/wsEAIService.asmx?wsdl)

55

Parmetro MV_EAIWS Informe o nome do Client WebService do EAI para envio a outro EAI - Contedo = WSEAISERVICE

Parmetro MV_EAIUSER - <Nome do usurio> (Opcional em caso do servidor precisar de autenticao)

56

Parmetro MV_EAIPASS <Senha do usurio> (Opcional em caso do servidor precisar de autenticao)

Parmetro MV_MULNATR Contedo = F (Esse parmetro determina se vai haver rateio de Natureza Financeira no Contas a
Receber, deve ser configurado conforme regra de negcio da empresa).

57

Parmetro MV_MULNATP Contedo = F (Esse parmetro determina se vai haver rateio de Natureza Financeira no Contas a Pagar,
deve ser configurado conforme regra de negcio da empresa).

Parmetro MV_FINJRTP Contedo = 3 - (Considerar na baixa do ttulo em atraso: 1. Taxa de permanncia(padro) 2. Juros
3.Ambos).

58

Parmetro MV_ITLBCPO Contedo = .T. - (Libera campos multa, juros caso tenha integrao TIN x PROTHEUS).

Menu SigaCfg Protheus:

necessrio que as seguintes opes existam no menu do configurador do Protheus, para que seja possvel configurar os
cadastros necessrios para a integrao RM TIN x Protheus:

59

60

4.2 Adapters

Configurao de Adapters (Por Empresa)

Os Adapters so as rotinas que englobam o envio e recebimento das informaes entre TOTVS Protheus e RM TIN, de modo
on-line, atravs de mensagem nica (arquivo XML).
importante que os dados sejam preenchidos e criados exatamente como segue nas figuras e descries.
Para realizar a incluso ou alterao de um Adapter, necessrio ter permisso para acesso ao ambiente Configurador do
Protheus. SIGACFG.
Obs: O campo ALIAS no cadastro de adapter serve para a seguinte situao: Gesto de empresas e cadastros compartilhados
por nvel de empresa. Quando informado o Alias referente a aquela mensagem, o sistema (Protheus) ira verificar o compartilhamento
do Alias informado, e dependendo do como estiver compartilhado o RM ira tratar se devera ou no replicar os informaes enviadas.

Abrindo o mdulo configurador, deve-se abrir o Menu Ambiente Schedule Adapter E.a.i.

61

Segue tela com todos os Adapters necessrios para funcionamento da integrao.

O adapter APCFG060 - WHOIS padro do sistema, mas deve estar configurado exatamente como segue abaixo.

Adapter CTBA030 COSTCENTER CENTRO DE CUSTO

62

Adapter FINA010 FINANCIALNATURE

Adapter FINA055 FINANCING

Adapter FINA070 ACCOUNTRECEIVABLEDOCUMENTDISCHARGE

63

Adapter FINA070 REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE

Adapter FINA080 ACCOUNTPAYABLEDOCUMENTDISCHARGE

64

Adapter FINA080 REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE

Adapter FINA070A UPDATECONTRACTPARCEL

Adapter MATA020 CUSTOMERVENDOR

65

Adapter MATA030 CUSTOMERVENDOR

Adapter MATA070 BANK

Adapter MATA120 ORDER

66

4.3 Schedules

Configurao de Schedules
Abrindo o mdulo configurador, deve-se abrir o Menu Ambiente Schedule Schedule

Schedules configurados

67

Configurao do Agent

68

Monitor do Agent

Agendamentos

69

Aps cadastro do Agendamento, deve-se configurar a Recorrncia, clicando no boto

e configurando conforme tela

abaixo:

70

4.4 De-para
Entre no Protheus
Mdulo SIGACFG

Abrindo o mdulo configurador, deve-se abrir o Menu Ambiente Schedule Emp. Fil Msg. nica (Deve ser feito por
empresa)

71

Neste exemplo temos duas coligadas RM (Company 1 e 2) com 4 filiais cada uma
O company equivale coligada no RM.
Branch equivale a filial no RM.

No Protheus temos as seguintes divises:

Grupo de empresa = T1
Empresa = D e M
Unidade de negcio = MG, RJ, SP e PR
Filial = 01 e 02
Este entendimento necessrio para a correta parametrizao do sistema, no configurador devemos dizer ao RM como o sistema
entedender o Company do Protheus

Seguindo o exemplo, com o parametro Company marcado seria:

Grupo de empresa = T1

COLIGADA

Empresa = D e M

COLIGADA

Unidade de negcio = MG, RJ, SP e PR

Filial = 01 e 02

J como parametro Business Unity marcado seria:

72

Grupo de empresa = T1

COLIGADA

Empresa = D e M

COLIGADA

Unidade de negcio = MG, RJ, SP e PR

COLIGADA

Filial = 01 e 02

Cadastros no RM Empresa Filial

Criar o De-Para por Coligada (GColigada) e Filial (GFilial).

Na criao da coligada, considerar apenas a Coligada de acordo com o TIN para Chave do Protheus tambm.

Neste exemplo, temos 2 coligadas:

Na criao da filial, considerar para Valor Chave Integrao a Empresa e Filial do Protheus.
73

Neste exemplo, temos 2 coligada com 4 filiais cada uma.

* Ateno: Sempre que cadastrar uma nova coligada no De/Para RM o cdigo informado para Valor da Chave Primria RM e Valor
da Chave Integrao
o cdigo da Coligada RM para os dois campos.

74

De para de moeda
O cadastro da moeda deve ser feito de forma MANUAL em ambos sistemas

Criar o De-Para por Moeda (GMoeda).

A criao do de-para da moeda feito Global que deve ser feito por FILIAL (uma nica vez para cada moeda).

Seguindo o exemplo acima, segue o depara no Protheus

75

De para de Condio de Pagamento

Como exemplo, temos a condio 001

O de-para
001 (8 espaos+codigo da condio)
Com base no exemplo, o valor da chave primria composta pela coligada 2|001 (cdigo da condio)

76

Protheus
Mdulo SIGACOM

No mdulo de Compras do Protheus (SIGACOM) entre em cond. De pagamento.

De para Protheus com base no exemplo. Temos o valor externo composto como CODCOLIGADA|CODCPG

77

De para de Produto
Cadastre Produto (Este cadastro somente usado nas rotinas de Comisso de Venda)

O produto dever ser servio e o parmetro ltimo nvel marcado

No de para, como no exemplo ao lado, temos duas coligadas.

O cadastro deve ser feito por coligada

78

Mdulo SIGACOM no Protheus

Atualizaes > Cadastros > Produtos

Insira produto com o tipo mo de obra (MO)

79

4.5 Observaes importantes

Procedimento de Criao/Configurao de Campos Obrigatrios para Integrao

PROTHEUS

Cadastro de Clientes SA1

O campo SA1->A1_END (Endereo) - O campo endereo deve ser preenchido com o Endereo da Rua, Avenida, etc., aps
a descrio uma vrgula , para indicar o nmero. No deve existir o carcter vrgula , no campo da Descrio da Rua, Avenida,
etc.

Cadastro de Fornecedores SA2

O campo SA2->A2_END (Endereo) - O campo endereo deve ser preenchido com o Endereo da Rua, Avenida, etc., aps
a descrio uma vrgula , para indicar o nmero. No deve existir o caractere vrgula , no campo da Descrio da Rua, Avenida,
etc.

Cadastro de Bancos SA6

O campo SA6->A6_NUMBCO (No. Banco) Esse campo deve ser preenchido obrigatoriamente.

RM

necessrio o cadastrar Meio de Pagamento (dinheiro) no RM.

Obs: o parmetro CODMEIOPAGAMENTO configurado com o valor do Meio de pagamento cadastrado.
A ao do valor de integrao do componente desconto deve estar = DESCONTA
No componente de desconto, o tipo de componente deve estar como tipo 900.
Para o processo do aditivo de Antecipao de Parcela, o componente de 32 (Juros de Acordo M.Indexado) deve estar configurado.
Para Distratos, a situao da subunidade deve estar preenchida.

OBSERVAES GERAIS:
Nos cadastros e tabelas utilizadas pela integrao, deve se ter ateno para os seguintes pontos:

Habilitar e desabilitar a obrigatoriedade dos campos;

Criao de gatilhos;

Pontos de entradas;

Validaes de usurios;

Pois isso pode afetar o correto funcionamento da integrao.

80

4.6 Configuraes iniciais

Navegue no menu e clique em Integrao

Dentro de integrao, clique em Ferramentas e em seguida configurar

81

D um nome para o processo e clique em Avanar

Insira usurio e senha do banco de dados, teste a conexo e clique em Avanar.

Obs: o Alias, driver e o nome do servidor e nome do banco j esto preenchidos.

82

Marque a opo TOTVS Incorporao x BackOffice Protheus

Clique em Executar.

83

Se o processo for executado com xito, ser exibido esta tela com um resumo do que foi feito.

84

Para saber se a integrao est ligada, devemos verificar se a Integrao existe, se o caminho do WebService do Protheus
est correto (Para verificar WebService Protheus, aps iniciar o appserver.ini copie e cole o texto do campo URL Webservice no
browser).

Verificando verses para erro no momento de incluso de alguma informao que seja integrada.

*a imagem acima mostra a ltima verso que a integrao foi homologada.

As verses das mensagens mapeadas no RM devem estar alinhadas com as do adapter Protheus. Havendo
divergncias, poder ocasionar no mal funcionamento da integrao pois ao receber a mensagem.

85

Adapters do Protheus e suas respectivas verses.

Em seguida, no deixe de verificar se a Integrao est ativa.

4.7 Parmetros da Integrao

Temos alguns parmetros da integrao, so eles:

o
o
o
o

CENTRODECUSTOAUTOINC: quando true, faz todos os cadastros de centro de custo virem pro RM de forma
sequencial.
CLIFORAUTOINC: quando true, faz todos cadastros de Cliente/Fornecedor virem pro RM de forma sequencial.
CODMEIOPAGAMENTO = a integrao necessita de um Meio de Pagamento cadastrado. O cdigo deste
cadastro deve ser definido neste parmetro.
CONTACAIXAAUTOINC: quando true, faz todos cadastros de conta caixa virem pro RM de forma sequencial.
86

o
o
o

NATUREZAFISCAOAUTOINC: quando true, faz todos os cadastros de natureza Financeira virem pro RM de
forma sequencial.
GERARTITULONF: quando true, todos os ttulos dos lanamentos sero gerados como NF para o Protheus.
PERCENTMULTAFIXO: define o valor da multa. Para a utilizao deste, deve-se seguir o procedimento abaixo:

Configurando o PERCENTMULTAFIXO

Definir o percenual de juros no parametro PERCENTMULTAFIXO.

87

Inserir uma consulta SQL no Globais

Entrar no financeiro e inserir o query:

SELECT * FROM HCPARAMETROS WHERE CODCOLIGADA = 0 AND UPPER(NOMECOLUNA) =
'PERCENTMULTAFIXO'
sem ponto e virgula

88

No cadastro de formulas, inserir o codigo da sentena no Contexto. Teste o resultado.

Em EXECSQL('0099') aonde 0099 o cdigo da sentea criada
no RESULTSQL('0099','VALOR'); aonde 0999 o codigo da sentena e VALOR o campo que guarda o
valor da multa definida no parametro.
lembrar de mudar o contexto na tela de formulas

Teste o resultado

89

Vincule a formula nos parametros do Financeiro.

90

4.8 Problemas frequentes

Erro ao tentar acessar WebService instalado no IIS. Ocorre quando o Modo de pipeline est como Integrado, o
mesmo funciona corretamente quando est como Clssico.

Erro no EAI.
WS funcionando corretamente ao acessar pelo browser, mas quando tentamos executar algum processo que
utilize a integrao do lado TIN no registrado nenhuma mensagem na fila e no Protheus tenta encontrar o WS (TBC)
em para entregar a mensagem gerada, no entanto na fila do Protheus apresentado a mensagem de erro que segue
abaixo.
Causa: dlls da Lib desatualizadas no ambiente RM.Net.
91

Soluo: Pegar ambiente RM.Net anterior a instalao do conversor de base e aplicar somente release de
atualizao de ambiente do RM.Net.

Erro ao enviar Natureza Oramentria Financeira para o financeiro do Protheus

Erro ao gerar o plano de financiamento, ocorreu porque no est enviando a natureza financeira corretamente
na TAG <Financialcode>, para que preencha corretamente preciso informar o Centro de custo no Empreendimento
independente, se o cliente utiliza ele em seus processos, como demonstra a figura abaixo.

mensagem nica com erro

mensagem nica correta

Como est no XML (Natureza|IdLan)

<Financialcode>|11852<Financialcode>
<Financialcode>0|11852<Financialcode>

Apresentao da mensagem de erro:

Falha ao tentar efetivar a venda [191919]:
Falha na Gerao de Lanamentos para o RM Fluxus.
Erro na execuo da Atividade: 'conTotvsMessageActivity1'
Erro: EAIService:receiveMessage : <Message type="ERROR" code="c2">Codigo da Natureza nao cadastrado
no Protheus------Item 1</Message>
92

Frmula Visual: 'Mensagem Padro - Lanamentos Financeiros'.

Erro ao gerar plano de financiamento.

Situao: Erro pode ocorrer devido a campos existentes no Backoffice Protheus que o cliente tenha criado e ou
customizado como obrigatrio na gerao de um ttulo, tambm pode ocorrer devido a gatilhos dentro do Protheus
que venha a tentar inserir informaes no ttulo no momento de sua gerao.
Soluo: Desabilitar customizaes e gatilhos criados pelo cliente no Protheus. Muitas das vezes aps efetuar a
soluo citada, se faz necessrio reiniciar o appserver.ini do Protheus.
ERRO ao gerar Plano de Financiamento: Falha ao tentar efetivar a venda [191919]:
Falha na Gerao de Lanamentos para o RM Fluxus.
Erro na execuo da Atividade: 'conTotvsMessageActivity1'
Erro: EAIService:receiveMessage : <Message type="ERROR" code="c2">Tabela SE1 08 11 13 11:31:47
</Message><Message type="ERROR" code="c2">Filial
E1_FILIAL := 01 </Message><Message type="ERROR"
code="c2">Prefixo
E1_PREFIXO := 1
Frmula Visual: 'Mensagem Padro - Lanamentos Financeiros'.

Mensagem com verses divergentes.

"XML response structure is not well formatted". Est a mensagem que pode ser apresentada.
Soluo: Ir no Protheus e verificar se as verses se encontram iguais a do RM, no estando altere a verso do
Protheus para a mesma verso do RM.

93

 Erro de cancelamento de baixa no Protheus.

Na tentativa de cancelar uma baixa de ttulo no PROTHEUS ocorreu erro e no apresentava nada em tela, O
cancelamento no ocorria. Os parmetros no ADAPTER da Mensagem de cancelamento no Protheus no foram
cadastrados corretamente.
Caso d alguma mensagem de erro com relao ao nmero do dgito da parcela se difere, cheque nos
parmetros do SGI na parte de integrao financeira, neste item:

94

Um problema no ambiente Serveng foi solucionado neste parmetro do appserver.ini. Quando foram geradas
70 lanamentos, apareceu um erro. Caso isso ocorra, verifique este parmetro.
Conexes SGBD (Sistema de Gerenciamento de Banco de Dados), realizadas atravs do TOTVS | DBAccess,
utilizem campo "M" Memo com at 1000000 de bytes.
Abrangncia
ERP 10 e 11

Por compatibilidade com as verses anteriores do AdvPL, por padro um campo "M" Memo suporta at 64 Kb do
texto. Com esta chave, especificada explicitamente no ambiente onde os programas sero executados, possvel
manipular at 1 milho de bytes em um campo Memo.
Valor

Descrio

0 (Padro)

Desabilita

Habilita

Caso esta parametrizao no seja feita, o Protheus ir recusar mensagens de criao de lanamentos para vendas
com muitas parcelas.

Erro da mascara do fornecedor - checar regio no sistema operacional---ORACLE

ORA-01843: not a valid month
ORA-06512: at "RM.SPC_PARAMETROSCOLIGADA", line 77
ORA-06512: at line 9
-----------------------------------------------

=====

Os adapters que possuem condio devem ser preenchidos dessa forma:

Alltrim(SE1->E1_ORIGEM) == "FINI055"

95