nova_montagem ambiente totvs incorporação x backoffice protheus
DESCRIPTION
Incorporação x BackOffice ProtheusTRANSCRIPT
![Page 1: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/1.jpg)
AMBIENTE LINHA RM E BACKOFFICE PROTHEUS
Processo : Ambiente
Subprocesso Montagem de Ambiente com Linha RM e BackOffice Protheus.
Data da publicação : 10/12/2012
Este documento irá abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja
integração utilize Mensagem Única.
É um documento geral que não aborda a parte de configuração da integração em si. Após a montagem do
ambiente, devem ser realizadas as configurações referentes a integração que se encontram na especificação
da mesma.
Conteúdo 1. Pré Requisitos .................................................................................................................................................................... 3
1.1 Obtendo Arquivos ............................................................................................................................................................... 3
1.2 Atualizações Protheus ......................................................................................................................................................... 3
2. Instalação .......................................................................................................................................................................... 5
2.1 RM ....................................................................................................................................................................................... 6
2.2 Protheus .............................................................................................................................................................................. 6
2.3 DBAcces ............................................................................................................................................................................... 9
3. Configuração.................................................................................................................................................................... 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 Conexões 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. Configuração específicas da Integração .......................................................................................................................... 53
4.1 Configurações iniciais ........................................................................................................................................................ 53
4.2 Adapters ............................................................................................................................................................................ 60
4.3 Schedules .......................................................................................................................................................................... 66
4.4 De-para .............................................................................................................................................................................. 70
![Page 2: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/2.jpg)
2
4.5 Observações importantes ................................................................................................................................................. 79
4.6 Configurações iniciais ........................................................................................................................................................ 80
4.7 Parametros da integração ................................................................................................................................................. 85
4.8 Problemas frequêntes ....................................................................................................................................................... 86
![Page 3: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/3.jpg)
3
Desenvolvimento/Procedimento
1. Pré Requisitos
Para montar o ambiente é necessário instalar:
Protheus versão 11
RM versão 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 validação referente à mensagem única caso a integração 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 opção TOTVS Application Server.(A página só funcionou no IE)
1.2 Atualizações Protheus
As versões mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:
Espelho do Portal: \\172.16.103.229\espelho-portal
É um diretório 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 conteúdo 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 homologação o ideal é utilizar o do caminho D-1.
![Page 4: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/4.jpg)
4
Updates: Protheus11\2-update-BRA-CHI-EUA-PAR-URU\topconnect
Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho D-1.
Dicionários/Help Campos/Menus: Protheus11\Systemload
Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho ATUSX.
DBAccess: Protheus11\TOTVS DBAccess
D-1: \\172.16.103.229\d-1
É um diretório onde são armazenadas as compilações diárias 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 - Versão do Protheus
ATUSX: \\172.16.93.23\temp
É um diretório onde são disponibilizados diariamente as ultimas versões dos dicionários, 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 criação e
manutenção de:
Dicionários:
• Índices (SIX)
• Perguntas (SX1)
• Arquivos (SX2)
• Campos (SX3)
• Tabelas genéricas (SX5)
• Parâmetros (SX6)
• Gatilhos (SX7)
• Relacionamentos (SX9)
• Pastas (SXA)
• Consultas Padrão (SXB)
• Grupo de campos (SXG)
Arquivos “.CH”
Menus do sistema
Tabelas Padrão
Help de campos e mensagens
![Page 5: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/5.jpg)
5
2. Instalação
2.1 RM
Utilizar a versão 11.82.26.108 (ou superior)
A versão 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
versão 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, não sendo mais necessário instalar o RMSGI.exe (instalador TOTVSIncorporacao*.msi).
http://interno.totvs.com/suporte/central-de-download/seu-segmento/produto/rm
![Page 6: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/6.jpg)
6
2.2 Protheus
O setup da instalação pode ser baixado através do seguinte link: http://www.totvs.com/suporte/central-de-
download/seu-segmento/produto/microsiga escolhendo opção TOTVS Application Server.
Este setup fará o download do Protheus.
![Page 7: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/7.jpg)
7
Após a instalação, os seguintes ícones serão gerados:
]
Clicando em Server Configuration Assistent, abrirá uma tela de configuração do Protheus.
![Page 8: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/8.jpg)
8
Caso utilize o instalador acima, clique em TOTVS | Application Server.
Obs: Este modelo de instalação não é o obtido através do site http://www.totvs.com.
Concluída a instalação, acesse o diretório 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 faça 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.
![Page 9: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/9.jpg)
9
Selecione também 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 instância do smartclient.
2.3 DBAcces
Execute novamente o instalador do Protheus e selecione a opção TOTVS | DBAcces. A instalação é bem intuitiva.
![Page 10: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/10.jpg)
10
Após abra o local onde foi instalado o DBAcces.exe, e no caminho do diretório, insira no final –install.
O DBAcces será instalado como serviço.
Observação:
Outra maneira de configurar o DBAcces sem instalar como serviço é:
![Page 11: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/11.jpg)
11
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.
Após basta iniciar o DBAcces:
Importante!! Quando o DBAcces é iniciado dessa forma, sempre que for fechar é necessário digitar CTRL + C,
e YES para confirmar. Após é necessário aguardar o aplicativo fechar sozinho. Este procedimento deve ser
realizado para não dar inconsistências na base.
![Page 12: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/12.jpg)
12
3. Configuração
3.1 Protheus – Banco de dados
Para criar um ambiente com dois tipos de bancos, acesse o diretório 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, versão 110. A nomenclatura dos arquivos RPO está detalhada no início do documento, na parte
de Atualizações Protheus.
![Page 13: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/13.jpg)
13
Observação:
Caso esteja montando ambiente apenas para um tipo de banco, basta não criar as pastas ORACLE e MSSQL,
e copiar o arquivo RPO direto para a pasta Protheus\apo
Copie os arquivos de dicionário para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\system. Selecione apenas os
arquivos .xnu que são os arquivos de menu.
Os arquivos são 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.
![Page 14: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/14.jpg)
14
Copie os outros dois arquivos - sx2.unq e sxsbra.txt - que são arquivos de dicionário, para a pasta: C:\TOTVS
11\Microsiga\Protheus_Data\systemload
Para um ambiente com os dois tipos de banco, faça uma cópia da pasta Protheus_Data e renomeie uma pasta para
Protheus_oracle e a outra Protheus_mssql.
![Page 15: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/15.jpg)
15
3.1.1 Configurando Banco SQL
São necessárias duas bases, uma para o RM e outra para o Protheus.
Para o RM, restaure e configure a base desejada normalmente. Para o Protheus não é necessário restaurar uma base.
O Protheus cria as tabelas necessárias para o seu funcionamento de forma automática, sendo necessária apenas a
configuração apontando para uma database vazia.
Para criar uma nova database no SQL Server conecte-se no mesmo, clique com o botão 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 é necessário criar um ODBC com o programa odbcad32. Abra o programa, selecione a aba “Fonte
de Dados de Sistema”, e clique em “Adicionar”.
![Page 16: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/16.jpg)
16
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 “Avançar”.
![Page 17: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/17.jpg)
17
Clique em “Avançar”.
Selecione “Alterar o banco de dados padrão para”, escolha a base de dados protheus e clique em “Avançar”.
Caso deseje, altere o idioma. Após clique em “Concluir”.
![Page 18: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/18.jpg)
18
Uma janela contendo o resumo da nova fonte de dados é exibida. Clique no botão “Testar fonte de dados...” para
validar a conexão.
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, são necessárias duas instâncias, 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 usuário que será utilizado pelo Protheus. Utilize uma ferramenta para
acessar a instância oracle criada para o RM. O comando que será executado deve ser rodado com o usuário sys ou
system.
![Page 19: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/19.jpg)
19
No exemplo abaixo foi utilizado a ferramenta SqlDbx.
O comando para criar um novo usuário é:
-- USER SQL
CREATE USER usuárioProtheus IDENTIFIED BY senhaProtheus
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP;
-- ROLES
GRANT "RESOURCE" TO usuárioProtheus WITH ADMIN OPTION;
GRANT "DBA" TO usuárioProtheus WITH ADMIN OPTION;
GRANT "CONNECT" TO usuárioProtheus WITH ADMIN OPTION;
ALTER USER usuárioProtheus DEFAULT ROLE "RESOURCE","DBA","CONNECT";
-- QUOTAS
ALTER USER usuárioProtheus QUOTA UNLIMITED ON SYSTEM;
Nota: Altere usuárioProtheus para o nome do usuário que deseja criar, e senhaProtheus para a senha do usuário.
Nota: Altere usuárioProtheus para o nome do usuário que deseja criar, e senhaProtheus para a senha do usuário.
Para validar se o usuário foi criado, basta logar na mesma instância informando o usuário e senha.
![Page 20: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/20.jpg)
20
Após a criação do usuário do protheus devemos configurar uma nova nomeação de serviço na ferramenta Oracle Net
Manager.
Selecione a pasta “Nomeação de Serviço” no Net Manager e clique em + para criar uma nova nomeação.
![Page 21: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/21.jpg)
21
Informe um nome para o serviço de rede e clique em “Próximo”.
Selecione o protocolo TCP/IP e clique em “Próximo”.
Informe o nome do host e a porta (default 1521) e clique em “Próximo”. (Insira o nome da sua máquina ou
simplesmente localhost)
![Page 22: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/22.jpg)
22
Informe o nome do SID informado na instalação do Oracle. Clique em “Próximo”.
Nota: O SID é o nome da instância RM do Oracle
Clique em “Testar” para validar se as configurações realizadas estão corretas.
![Page 23: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/23.jpg)
23
Clique no botão “Alterar Login” e informe o nome do usuário e senha criados com o script anteriormente. Clique no
botão “Ok”.
Após clique em “Testar”. Caso a configuração tenha sido executada corretamente o teste de conexão será bem
sucedido.
Clique em “Fechar” para fechar a tela de testes e depois clique em “Finalizar” para concluir a instalação.
Importante!
Antes de encerrar a aplicação selecione o menu Arquivo | Salvar Configuração de Rede para salvar a
configuração realizada.
![Page 24: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/24.jpg)
24
3.1.3 Configurando Conexões no DBAcces
Após a criação e configuração do database/schema temos que configurar as conexões no TOTVS DBAccess. Ele é a
ferramenta utilizada pelo Protheus para fazer a comunicação entre o appserver e o SGBD.
Inicialize o DBAcces.
Observação
Se o DBAcces foi instalado como serviço verifique se o mesmo esta ativo.
Caso tenha sido configurado da outra forma, execute o DBAcces através do atalho.
Após iniciar o DBAcces, inicie o DBMonitor.
![Page 25: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/25.jpg)
25
Para configurarmos a conexão com o SQL Server utilizaremos a aba “Configurações” e depois a aba “Microsoft SQL”.
Clique no botão “Novo”, e informe a base protheus referente ao banco SQL, nome do usuário e senha.
![Page 26: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/26.jpg)
26
Para configurarmos a conexão Oracle utilizaremos a aba “Configurações” e depois a aba “Oracle”. Clique no botão
“Novo” e informe a base protheus, o nome do usuário e a senha.
Marque o checkbox “Usar BLOB para campo MEMO”.
Importante!
![Page 27: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/27.jpg)
27
O DBAccess precisa que o caminho para a biblioteca do Oracle seja informada para o seu correto
funcionamento.
Fazemos isto através do arquivo DBAccess.ini no diretório 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 diretório de instalação do DBAcces.
Após finalizarmos a configuração das conexões podemos realizar o teste das mesmas através da aba “Assistentes”.
Clique no botão “Validação de Conexão”.
Clique em “Avançar”. Selecione o SGBD e clique em “Avançar”. Informe o nome da conexão criada e clique em
“Finalizar”.
![Page 28: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/28.jpg)
28
![Page 29: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/29.jpg)
29
Se a conexão 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 configuração do Protheus, iremos configurar o arquivo appserver.ini. Ele se encontra na pasta
appserver, no diretório onde foi instalado o Protheus: C:\TOTVS 11\Microsiga\Protheus\bin\appserver
![Page 30: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/30.jpg)
30
Seção 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 conexão (TOP)
RPOLANGUAGE=linguagem do RPO (Portuguese)
RPOVERSION=versão do RPO (110)
LOCALFILES=tipo dos arquivos locais (ADS)
LOCALDBEXTENSION=extensão das tabelas locais (.dbf)
PICTFORMAT=DEFAULT
REGIONALLANGUAGE=localização (BRA)
TOPSERVER=endereço 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 sessão DBAcces. Neste caso, retire as mesmas dessa
sessão e transfira-as para a sessão Environment, inserindo TOP na frente. A sessão DBAcces deixa
de existir.
o Altere o nome Environment por um nome que represente a conexão que está sendo criada.
o Caso esteja montando dois ambientes – Oracle e MSSQL – basta criar outra seção Environment,
renomeando a mesma.
Realizada as alterações, a seção ficará assim:
![Page 31: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/31.jpg)
31
Seção Geral
Deve possuir as propriedades:
[GENERAL]
InstallPath=pasta do Protheus
console=loga no console (0/1)
BuildKillUsers=desconecta todos os usuários quando compilar o RPO (0/1)
LogEnable=habilitar arquivo de log (0/1)
ConsoleLog=loga no console (0/1)
consolemaxsize=tamanho máximo do log (10000000)
ConsoleFile=arquivo de log
Segmento=cYdTm3WWERZF=1hu
Serie===AV
Realizada as alterações, a seção ficará assim:
![Page 32: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/32.jpg)
32
Seção de Serviço
Deve possuir as propriedades:
[SERVICE]
Name=Protheus11
DisplayName=Protheus 11
Nota: Caso não exista no arquivo deve ser incluída.
Realizada as alterações, a seção ficará assim:
Seções [TCP], [Drivers] e [GENTCPIP]
Devem possuir as propriedades:
[TCP]
TYPE=TCPIP
Port=porta do appserver
![Page 33: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/33.jpg)
33
[Drivers]
Active=TCP
[GENTCPIP]
Enable=0
Notas:
o Caso não existam no arquivo as seções devem ser incluídas.
o A porta informada na seção TCP deve ser informada também no arquivo smartclient.ini na seção.
Realizada as alterações, as seções ficarão assim:
Seção LICENSECLIENT
Deve possuir as propriedades:
[LICENSECLIENT]
server= servidor
port= porta
Realizada as alterações, a seção ficará assim:
![Page 34: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/34.jpg)
34
Segue descritivo da Configuração do INI para o WebService. (EXEMPLO)
Primeira Página: Segunda Página:
[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
[LICENSESERVER]
enable=0
port=5555
ShowStatus=1
[LICENSECLIENT]
server=192.168.1.3
port=5556
[TDS]
allowApplyPatch=*
[SERVICE]
NAME=Protheus11Service-ws
DISPLAYNAME=TOTVS - ServerWS
[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
![Page 35: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/35.jpg)
35
3.3 Protheus – WS Protheus
Abra o SmartClient com SRVWIZARD
Em módulo web selecione WS Microsiga Protheus 11 Web Services Nome da instancia = EAI
O diretório raiz é preenchido automaticamente
Selecione o enviroment (Ambiente)
O parâmetro habilitar processos faz o WS subir automaticamente com o appserver e criará a tag ONSTART=__WSSTART
no .ini
![Page 36: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/36.jpg)
36
Neste assistente, é necessário informar no host: Localost, o ip da máquina e o nome da máquina, como no exemplo abaixo
Ao adicionar cada host, é necessário em seguida selecionar a filial (não é necessário fazer o procedimento para todas as filiais)
E clicar em relacionar. O registro aparecerá na parte de baixo da janela.
Insira o número mínimo de usuários e o número máximo. Clique em avançar.
![Page 37: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/37.jpg)
37
Sim
Clique em ok e reinicie o appserver.
O wizard cria como padrão na porta 80. Poderá acontecer conflito caso haja o IIS rodando na máquina, que
também roda na porta 80. Para alterar a porta, é necessário acessar o appserver.ini realizara a alteração como no exemplo:
![Page 38: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/38.jpg)
38
Testando o WS
![Page 39: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/39.jpg)
39
Caso não 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
![Page 40: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/40.jpg)
40
Para configurar o EAI precisamos cadastrar o job que irá monitorar a fila de integração. Esta configuração é feita no
módulo SIGACFG do Protheus.
Inicie o appserver, e após o smartclient. Informe usuário e senha.
Nota: caso o protheus tenha sido instalado desde o zero, será necessário realizar algumas configurações antes de
acessar o módulo SigaCFG:
Escolha a localização.
Informe o diretório dos arquivos de dados (selecione a pasta data).
Informe o valor das Moedas
![Page 41: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/41.jpg)
41
Acesse: Ambiente | Schedule | Schedule. Após: Schedule | Agent | Cadastro
Clique em Incluir para cadastrar o JOB. Insira as informações solicitadas e salve o cadastro.
![Page 42: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/42.jpg)
42
Depois em Agendamento|Cadastro. Clique em incluir e informe a Rotina: FWEAI e Empresa/Filial: Informe a empresa.
3.4 TOTVS Business Connect
Para instalar os web services execute o instalador do TOTVS Business Connect.
O aplicativo esta disponível em: \\tecnologiabh\Instalar\CorporeRM\Versoes
![Page 43: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/43.jpg)
43
Nota: Quando o IIS é instalado após o Visual é necessário rodar um comando para aplicar algumas configurações antes
instalar o web service:
Abra o prompt de comando e acesse o diretório: C:\Windows\Microsoft.NET\Framework\v4.0.30319
Após execute o comando aspnet_regiis -1.
Após 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”.
Verifique se todas as opções referentes a “Serviços de Informações da Internet” estão selecionadas. Caso não esteja,
selecione e salve as alterações.
![Page 44: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/44.jpg)
44
3.6 Internet Information Services (IIS)
Abra o IIS.
![Page 45: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/45.jpg)
45
Selecione “Pools de Aplicativos” e verifique se todos os serviços estão iniciados.
Selecione: Sites | Default Web Site | TOTVBusinessConnect. Do lado direito selecione “Configurações Avançadas”.
Em Pool de Aplicativos deve estar Classic .NET AppPool.
Nota: Também pode estar preenchido com ASP.NET v4.0 Classic ou TOTVSBusinessConnect
![Page 46: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/46.jpg)
46
Após realizar a configuração do Pool de Aplicativos selecione “TOTVBusinessConnect” e clique em “Autenticação”.
Apenas a “Autenticação Anônima” deve estar habilitada. Todas as outras devem estar desabilitadas.
![Page 47: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/47.jpg)
47
Em seguida, selecione o servidor e clique em “Restrições ISAPI e CGI”.
Valide se a restrição do ASP.NET v4 está como Permitido. Caso não esteja altere para este status.
![Page 48: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/48.jpg)
48
Nota: Os itens listados podem estar ou não com status permitido, mas é necessário que pelo menos o ASP.NET v4 esteja
com este status.
Para verificar se o WebService do RM está Funcionando utilize a chamada
http://Servidor/TOTVSBusinessConnect/wsEAIService.asmx?wsdl no browser, o usuário e senha que pedir será o mesmo que foi
configurado no Protheus em Parâmetros.
Para criação do De-Para das informações já existente na base de dados das tabelas: FCFO, FLAN, GCCUSTO, TTBORCAMENTO.
Deve-se rodar o script abaixo após ter executado a rotina de criação do De-Para no Protheus.
![Page 49: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/49.jpg)
49
As configurações do “RM.Host.Service.exe.config”, “RM.exe.config” e “Web.config” devem estar corretamente alinhados,
como na figura abaixo:
![Page 50: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/50.jpg)
50
3.7 Web.config
No diretório do RM, os web services foram instalados na pasta WS_TBC. Será necessário realizar alguma configurações
no arquivo web.config.
Abra o arquivo e localize a tag appSettings.
![Page 51: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/51.jpg)
51
Altere as tags:
Host = informe a máquina
Port = porta do host
DBAlias = alias do banco de dados RM (no momento só aceita CORPORERM)
JobServer3Camadas = true (apenas se o acesso for de outra máquina)
Após alterar o arquivo irá ficar assim:
O smartclient.ini também deve ser verificado. Ele pode ser localizado na mesma pasta do smartclient.exe.
Para validar se as configurações realizadas estão corretas abra o browser e informe no endereço: localhost ou IP da
máquina /TOTVSBusinessConnect/wsEAIService.asmx
Será solicitado que informe usuário e senha para realizar a autenticação.
Nota: O usuário e senha são da base de dados que foi configurada no arquivo web.config.
![Page 52: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/52.jpg)
52
Após informar os dados e realizar o login, a página do web.service será apresentada.
![Page 53: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/53.jpg)
53
4. Configuração do TOTVS Incorporação
4.1 Configurações iniciais
O WebService é fundamental para integração das funcionalidades do TOTVS – Protheus com o RM TIN.
O WebService deve estar com o Serviço EAISERVICE - HABILITADO, como segue figura abaixo:
É importante ter um serviço e um RPO do Protheus separados para o WebService. Diante disso foi criado as seguintes pastas
para o WebService:
o PROTHEUS11\BIN\APPSERVER_WS (Diretório do serviço de WS) o PROTHEUS11\APO_WS (RPO do service de WS)
OBS: O Serviço de WebService é único, não havendo necessidade de ter um serviço por empresa.
![Page 54: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/54.jpg)
54
Procedimento de Atualização de Parâmetros, Adapters e Schedules
Configuração de Parâmetros (Por empresa)
Parâmetro MV_EAIMETH – Informe o método de envio do EAI para envio a outro EAI - Conteúdo = receiveMessage.
Parâmetro MV_EAIURL2 – Conteúdo = Webservice RM (Ex: http://192.168.1.3/TOTVSBusinessConnect/wsEAIService.asmx?wsdl)
![Page 55: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/55.jpg)
55
Parâmetro MV_EAIWS – Informe o nome do Client WebService do EAI para envio a outro EAI - Conteúdo = WSEAISERVICE
Parâmetro MV_EAIUSER - <Nome do usuário> (Opcional em caso do servidor precisar de autenticação)
![Page 56: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/56.jpg)
56
Parâmetro MV_EAIPASS – <Senha do usuário> (Opcional em caso do servidor precisar de autenticação)
Parâmetro MV_MULNATR – Conteúdo = F (Esse parâmetro determina se vai haver rateio de Natureza Financeira no Contas a
Receber, deve ser configurado conforme regra de negócio da empresa).
![Page 57: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/57.jpg)
57
Parâmetro MV_MULNATP – Conteúdo = F (Esse parâmetro determina se vai haver rateio de Natureza Financeira no Contas a Pagar,
deve ser configurado conforme regra de negócio da empresa).
Parâmetro MV_FINJRTP – Conteúdo = 3 - (Considerar na baixa do título em atraso: 1. Taxa de permanência(padrão) 2. Juros
3.Ambos).
![Page 58: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/58.jpg)
58
Parâmetro MV_ITLBCPO – Conteúdo = .T. - (Libera campos multa, juros caso tenha integração TIN x PROTHEUS).
Menu SigaCfg Protheus:
É necessário que as seguintes opções existam no menu do configurador do Protheus, para que seja possível configurar os
cadastros necessários para a integração RM TIN x Protheus:
![Page 59: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/59.jpg)
59
![Page 60: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/60.jpg)
60
4.2 Adapters
Configuração de Adapters (Por Empresa)
Os Adapters são as rotinas que englobam o envio e recebimento das informações entre TOTVS – Protheus e RM TIN, de modo
on-line, através de mensagem única (arquivo XML).
É importante que os dados sejam preenchidos e criados exatamente como segue nas figuras e descrições.
Para realizar a inclusão ou alteração de um Adapter, é necessário ter permissão para acesso ao ambiente Configurador do
Protheus. SIGACFG.
Obs: O campo ALIAS no cadastro de adapter serve para a seguinte situação: Gestão de empresas e cadastros compartilhados
por nível 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 não replicar os informações enviadas.
Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Adapter E.a.i.
![Page 61: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/61.jpg)
61
Segue tela com todos os Adapters necessários para funcionamento da integração.
O adapter APCFG060 - WHOIS é padrão do sistema, mas deve estar configurado exatamente como segue abaixo.
Adapter CTBA030 – COSTCENTER – CENTRO DE CUSTO
![Page 62: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/62.jpg)
62
Adapter FINA010 – FINANCIALNATURE
Adapter FINA055 – FINANCING
Adapter FINA070 – ACCOUNTRECEIVABLEDOCUMENTDISCHARGE
![Page 63: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/63.jpg)
63
Adapter FINA070 – REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE
Adapter FINA080 – ACCOUNTPAYABLEDOCUMENTDISCHARGE
![Page 64: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/64.jpg)
64
Adapter FINA080 – REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE
Adapter FINA070A – UPDATECONTRACTPARCEL
Adapter MATA020 – CUSTOMERVENDOR
![Page 65: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/65.jpg)
65
Adapter MATA030 – CUSTOMERVENDOR
Adapter MATA070 – BANK
Adapter MATA120 – ORDER
![Page 66: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/66.jpg)
66
4.3 Schedules
Configuração de Schedules
Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Schedule
Schedules configurados
![Page 67: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/67.jpg)
67
Configuração do Agent
![Page 68: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/68.jpg)
68
Monitor do Agent
Agendamentos
![Page 69: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/69.jpg)
69
Após cadastro do Agendamento, deve-se configurar a Recorrência, clicando no botão e configurando conforme tela
abaixo:
![Page 70: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/70.jpg)
70
4.4 De-para
Entre no Protheus
Módulo SIGACFG
Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Emp. Fil Msg. Única (Deve ser feito por
empresa)
![Page 71: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/71.jpg)
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 divisões:
Grupo de empresa = T1
Empresa = D e M
Unidade de negócio = MG, RJ, SP e PR
Filial = 01 e 02
Este entendimento é necessário para a correta parametrização 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 negócio = MG, RJ, SP e PR
Filial = 01 e 02
Já como parametro Business Unity marcado seria:
![Page 72: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/72.jpg)
72
Grupo de empresa = T1 COLIGADA
Empresa = D e M COLIGADA
Unidade de negócio = 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 criação da coligada, considerar apenas a Coligada de acordo com o TIN para Chave do Protheus também.
Neste exemplo, temos 2 coligadas:
Na criação da filial, considerar para “Valor Chave Integração” a Empresa e Filial do Protheus.
![Page 73: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/73.jpg)
73
Neste exemplo, temos 2 coligada com 4 filiais cada uma.
* Atenção: Sempre que cadastrar uma nova coligada no De/Para RM o código informado para “Valor da Chave Primária RM” e “Valor da Chave Integração”
o código da Coligada RM para os dois campos.
![Page 74: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/74.jpg)
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 criação 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
![Page 75: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/75.jpg)
75
De para de Condição de Pagamento
Como exemplo, temos a condição 001
O de-para é ‘ 001 (8 espaços+codigo da condição)
Com base no exemplo, o valor da chave primária é composta pela coligada 2|001 (código da condição)
![Page 76: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/76.jpg)
76
Protheus
Módulo SIGACOM
No módulo 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
![Page 77: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/77.jpg)
77
De para de Produto
Cadastre Produto (Este cadastro somente é usado nas rotinas de Comissão de Venda)
O produto deverá ser serviço e o parâmetro último nível marcado
No de para, como no exemplo ao lado, temos duas coligadas.
O cadastro deve ser feito por coligada
![Page 78: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/78.jpg)
78
Módulo SIGACOM no Protheus
Atualizações > Cadastros > Produtos
Insira produto com o tipo mão de obra (MO)
![Page 79: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/79.jpg)
79
4.5 Observações importantes
Procedimento de Criação/Configuração de Campos Obrigatórios para Integração
PROTHEUS
Cadastro de Clientes – SA1 O campo SA1->A1_END (“Endereço”) - O campo endereço deve ser preenchido com o Endereço da Rua, Avenida, etc., após
a descrição uma vírgula “,” para indicar o número. Não deve existir o carácter vírgula “,” no campo da Descrição da Rua, Avenida,
etc.
Cadastro de Fornecedores – SA2 O campo SA2->A2_END (“Endereço”) - O campo endereço deve ser preenchido com o Endereço da Rua, Avenida, etc., após
a descrição uma vírgula “,” para indicar o número. Não deve existir o caractere vírgula “,” no campo da Descrição da Rua, Avenida,
etc.
Cadastro de Bancos – SA6 O campo SA6->A6_NUMBCO (“No. Banco”) – Esse campo deve ser preenchido obrigatoriamente.
RM
É necessário o cadastrar Meio de Pagamento (dinheiro) no RM. Obs: o parâmetro CODMEIOPAGAMENTO configurado com o valor do Meio de pagamento cadastrado.
A ação do valor de integração 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 Antecipação de Parcela, o componente de 32 (Juros de Acordo M.Indexado) deve estar configurado.
Para Distratos, a situação da subunidade deve estar preenchida.
OBSERVAÇÔES GERAIS:
Nos cadastros e tabelas utilizadas pela integração, deve se ter atenção para os seguintes pontos:
Habilitar e desabilitar a obrigatoriedade dos campos; Criação de gatilhos; Pontos de entradas; Validações de usuários;
Pois isso pode afetar o correto funcionamento da integração.
![Page 80: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/80.jpg)
80
4.6 Configurações iniciais
Navegue no menu e clique em Integração
Dentro de integração, clique em Ferramentas e em seguida configurar
![Page 81: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/81.jpg)
81
Dê um nome para o processo e clique em Avançar
Insira usuário e senha do banco de dados, teste a conexão e clique em Avançar.
Obs: o Alias, driver e o nome do servidor e nome do banco já estão preenchidos.
![Page 82: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/82.jpg)
82
Marque a opção TOTVS Incorporação x BackOffice Protheus
Clique em Executar.
![Page 83: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/83.jpg)
83
Se o processo for executado com êxito, será exibido esta tela com um resumo do que foi feito.
![Page 84: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/84.jpg)
84
Para saber se a integração está ligada, devemos verificar se a Integração existe, se o caminho do WebService do Protheus
está correto (Para verificar WebService Protheus, após iniciar o appserver.ini copie e cole o texto do campo “URL Webservice” no
browser).
Verificando versões para erro no momento de inclusão de alguma informação que seja integrada.
*a imagem acima mostra a última versão que a integração foi homologada.
As versões das mensagens mapeadas no RM devem estar alinhadas com as do adapter Protheus. Havendo
divergências, poderá ocasionar no mal funcionamento da integração pois ao receber a mensagem.
![Page 85: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/85.jpg)
85
Adapters do Protheus e suas respectivas versões.
Em seguida, não deixe de verificar se a Integração está ativa.
4.7 Parâmetros da Integração
Temos alguns parâmetros da integração, são eles:
o CENTRODECUSTOAUTOINC: quando true, faz todos os cadastros de centro de custo virem pro RM de forma
sequencial.
o CLIFORAUTOINC: quando true, faz todos cadastros de Cliente/Fornecedor virem pro RM de forma sequencial.
o CODMEIOPAGAMENTO = a integração necessita de um Meio de Pagamento cadastrado. O código deste
cadastro deve ser definido neste parâmetro.
o CONTACAIXAAUTOINC: quando true, faz todos cadastros de conta caixa virem pro RM de forma sequencial.
o NATUREZAFISCAOAUTOINC: quando true, faz todos os cadastros de natureza Financeira virem pro RM de
forma sequencial.
o GERARTITULONF: quando true, todos os títulos dos lançamentos serão gerados como NF para o Protheus.
![Page 86: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/86.jpg)
86
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 “Clássico”.
![Page 87: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/87.jpg)
87
Erro no EAI. WS funcionando corretamente ao acessar pelo browser, mas quando tentamos executar algum processo que
utilize a integração do lado TIN não é 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: dll’s da Lib desatualizadas no ambiente RM.Net.
Solução: Pegar ambiente RM.Net anterior a instalação do conversor de base e aplicar somente release de
atualização de ambiente do RM.Net.
![Page 88: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/88.jpg)
88
Erro ao enviar “Natureza Orçamentária Financeira” para o financeiro do Protheus
Erro ao gerar o plano de financiamento, ocorreu porque não 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.
Como está no XML (Natureza|IdLan)
mensagem única com erro <Financialcode>|11852<Financialcode>
mensagem única correta <Financialcode>0|11852<Financialcode>
Apresentação da mensagem de erro:
Falha ao tentar efetivar a venda [191919]:
Falha na Geração de Lançamentos para o RM Fluxus.
Erro na execução da Atividade: 'conTotvsMessageActivity1'
Erro: EAIService:receiveMessage : <Message type="ERROR" code="c2">Codigo da Natureza nao cadastrado
no Protheus------Item 1</Message>
Fórmula Visual: 'Mensagem Padrão - Lançamentos Financeiros'.
![Page 89: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/89.jpg)
89
Erro ao gerar plano de financiamento.
Situação: Erro pode ocorrer devido a campos existentes no Backoffice Protheus que o cliente tenha criado e ou
customizado como obrigatório na geração de um título, também pode ocorrer devido a gatilhos dentro do Protheus
que venha a tentar inserir informações no título no momento de sua geração.
Solução: Desabilitar customizações e gatilhos criados pelo cliente no Protheus. Muitas das vezes após efetuar a
solução citada, se faz necessário reiniciar o appserver.ini do Protheus.
ERRO ao gerar Plano de Financiamento: Falha ao tentar efetivar a venda [191919]:
Falha na Geração de Lançamentos para o RM Fluxus.
Erro na execução 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
Fórmula Visual: 'Mensagem Padrão - Lançamentos Financeiros'.
Mensagem com versões divergentes.
"XML response structure is not well formatted". Está é a mensagem que pode ser apresentada.
Solução: Ir no Protheus e verificar se as versões se encontram iguais a do RM, não estando altere a versão do
Protheus para a mesma versão do RM.
![Page 90: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/90.jpg)
90
Erro de cancelamento de baixa no Protheus.
Na tentativa de cancelar uma baixa de título no PROTHEUS ocorreu erro e não apresentava nada em tela, O
cancelamento não ocorria. Os parâmetros no ADAPTER da Mensagem de cancelamento no Protheus não foram
cadastrados corretamente.
Caso dê alguma mensagem de erro com relação ao número do dígito da parcela se difere, cheque nos parâmetros do SGI na parte de integração financeira, neste item:
![Page 91: NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus](https://reader033.vdocuments.mx/reader033/viewer/2022050703/5695d04a1a28ab9b0291da8d/html5/thumbnails/91.jpg)
91
Um problema no ambiente Serveng foi solucionado neste parâmetro do appserver.ini. Quando foram geradas
70 lançamentos, apareceu um erro. Caso isso ocorra, verifique este parâmetro.
Conexões SGBD (Sistema de Gerenciamento de Banco de Dados), realizadas através do TOTVS | DBAccess,
utilizem campo "M" Memo com até 1000000 de bytes.
Abrangência
ERP 10 e 11
Por compatibilidade com as versões anteriores do AdvPL, por padrão um campo "M" Memo suporta até 64 Kb do
texto. Com esta chave, especificada explicitamente no ambiente onde os programas serão executados, é possível
manipular até 1 milhão de bytes em um campo Memo.
Valor Descrição
0 (Padrão) Desabilita
1 Habilita
Caso esta parametrização não seja feita, o Protheus irá recusar mensagens de criação de lançamentos para vendas
com muitas parcelas.