Manual de Integração APS X Microsiga Protheus PDF

Manual de Integrao
TOTVS APS e Microsiga Protheus
Gesto de Produto - Manufatura

Manual de Integrao APS e Protheus 2
ndice
1. Histrico de Alteraes ......................................................................................................... 3
2. Introduo ............................................................................................................................. 4
2.1 Viso Geral .................................................................................................................... 4
2.2 Ferramentas de integrao ........................................................................................... 4
3. Configurao da Integrao APS x Protheus ......................................................................... 6
3.1. Protheus ........................................................................................................................ 8
3.1.1. Atualizando Client WebServices.............................................................................. 10
3.2. TOTVS APS ................................................................................................................... 15
3.3. EAI ............................................................................................................................... 18
3.3.1. Monitor de Integrao EAI ...................................................................................... 19
3.4. ByYou ESB .................................................................................................................... 21
4. Caractersticas da Integrao .............................................................................................. 30
4.1. Acesso as tabelas no Protheus: Exclusivo x Compartilhado........................................ 30
4.2. Entidades / Transaes ............................................................................................... 31
4.3. Entidades do APS sem correspondente no Protheus.................................................. 35
4.4. Campos do APS e seus correspondentes no Protheus................................................ 36
4.5. Numerao de ordens de produo e compras .......................................................... 39
4.6. Horizonte Fixo e Eliminao de Ordens ...................................................................... 40
4.7. Atributos da rede PERT ............................................................................................... 40
5. Rotinas da Integrao.......................................................................................................... 42
5.1. Atualizao de Dados - Planejamento......................................................................... 42
5.2. Atualizao de Dados - Pontos de Controle ................................................................ 42
5.3. Confirmao Programao .......................................................................................... 43
6. Requisitos de Hardware ...................................................................................................... 44
Anexos ......................................................................................................................................... 46
Roteiro de Configurao de Web Services e Portal Protheus ................................................. 46
Boletim Tcnico Integrao com TOTVS APS ....................................................................... 46
1. Histrico de Alteraes
Data Verso Descrio Autor

01/10/2010 1.0 Criao do Documento Rafael Rosario
23/05/2011 1.1 Criao do histrico de alteraes Rafael Rosario
23/05/2011 1.2 Includo tpico Numerao de ordens de produo e Rafael Rosario / Rodrigo
compras Michalski
01/06/2011 1.3 Alteraes no tpico Numerao de ordens de produo e Rodrigo Michalski

compras
01/07/2011 1.4 Incluso do tpico Requisitos de Hardware Ademar Widmann
11/07/2011 1.5 Includas algumas tabelas no tpico Entidades do APS Rafael Rosario
sem correspondente no Protheus
27/09/2011 1.6 Alteraes no tpico Numerao de ordens de produo e Rodrigo Michalski
compras
14/02/2012 1.7 Passa a atualizar o programa Parmetros Planejamento Andr Luis Oliveira
Avanado (DB1000) para parametrizar a integrao
Comentada o realce dos campos vindos do Protheus nas
telas do APS
01/06/2012 1.8 Restruturado o documento: renomeados alguns tpicos e Rafael Rosario

reagrupados de forma a facilitar a consulta.
Detalhado melhor o processo de atualizao dos
WebServices do Protheus
Alteraes no DB1000
09/08/2012 1.9 Atualizao da relao Item x Estab no Protheus Andr Lus Oliveira
2. Introduo
2.1 Viso Geral
O TOTVS APS uma ferramenta avanada de planejamento da produo, que roda

independente do ERP. Tm como principais caractersticas: a rapidez e desempenho no
processamento; a preciso nas programaes geradas; a elevada capacidade de refletir a
realidade operacional dos diferentes sistemas de produo e a alta tecnologia com que so
desenvolvidos.
Veja abaixo o que o TOTVS APS pode responder:
O que, quanto e quando produzir;

O que, quanto e quando comprar;
Em que mquina produzir;
A que horas comear;
Quando liberar o material para a fbrica;
Qual a melhor sequncia de produo/setups;
Como reagir a eventos inesperados;
A necessidade de turnos adicionais ou horas extras;
Quando ser possvel entregar cada pedido;
O que est restringindo a produo;
Onde investir para melhorar a entrega.
Sendo que os Resultados gerados so:
Maior preciso nos Prazos de Entrega;

Reduo das Despesas Operacionais;
Diminuio do lead-time de produo;
Flexibilizao da Produo;
Agilidade nas Reprogramaes;
Aumento no Ganho pela Otimizao das Restries;
Reduo dos Estoques de matria-prima, processo e produto acabado.
O TOTVS APS necessita de vrias informaes oriundas do ERP para realizar o planejamento
de produo, tais como a lista de materiais, processos de fabricao dos produtos, ordens de
compra, produo em andamento, pedidos e previses de venda, posio de estoque entre
outros.
Esta integrao viabiliza aos clientes TOTVS que utilizam o ERP Protheus como seu sistema de
gesto empresarial usufruir dos benefcios do sistema APS.
2.2. Ferramentas de integrao

Antes de falarmos em processo de integrao, interessante esclarecermos os termos abaixo:
EAI (Enterprise Application Integration): Processo para integrao de aplicaes

corporativas permitindo a interao entre sistemas heterogneos por meio da utilizao de
servios;
Datasul EAI: Aplicativo desenvolvido para permitir a interao dos mdulos do Datasul EMS
2 com demais sistemas;
ESB (Enterprise Service Bus): Arquitetura de construo de software baseado no

reconhecimento de padres com objetivo de fornecer uma base centralizada de servios onde
sistemas possam utiliz-lo;
ByYou ESB: Aplicativo TOTVS desenvolvido para trabalhar com a arquitetura ESB.
3. Configurao da Integrao APS x Protheus

Existem 3 pontos de integrao do APS com o Protheus:
1. Atualizao de Dados - Planejamento: responsvel por buscar no ERP as informaes que

o APS necessita para realizar o Planejamento da Produo. Devido ao alto volume de dados,
neste ponto o APS ir buscar as informaes via acesso direto ao banco de dados do
Protheus;
2. Atualizao de Dados - Pontos de Controle: o APS tambm ir acessar via banco de
dados as informaes do Protheus necessrias para o controle de produo realizado pelo
gerenciamento de pulmes (mdulo Buffer Management);
3. Confirmao da Programao: o APS ir enviar ao Protheus as informaes necessrias

para confirmao de ordens de produo e compras, via TOTVS EAI + ByYou ESB + Web
Services Protheus.
A Confirmao de Programao realiza os seguintes passos (conforme figura acima):
1. A Confirmao gera a mensagem com as informaes a serem enviadas ao

Protheus (Ordens de Compra, Produo e Operaes) na base EAI (sender).
2. O ESB busca as mensagens no EAI.
3. O ESB transforma e envia a mensagem para o Web Services Protheus.
4. O WS Protheus tenta gravar as informaes no Protheus.
5. O WS retorna o nmero dos documentos criados (OPs, operaes e OCs) e / ou
os erros encontrados ao tentar cri-los no Protheus.
6. O ESB transforma o retorno do WS Protheus e grava na base EAI.
7. O Agente EAI (receiver) busca as mensagens de retorno criadas pelo ESB.
8. O Agente EAI atualiza as informaes no APS.
Abaixo seguem as instrues de como configurar cada uma das partes envolvidas na
integrao.
3.1. Protheus
1. Verificar se o Protheus est atualizado na ltima verso disponvel;
2. O banco de dados do ERP Protheus dever ser Oracle ou MS-SQL.
3. Criar uma fonte de dados (ODBC) da base de dados do Protheus para que o APS possa
acess-lo;
4. Parmetros: para acessar a tela de parmetros, execute o Protheus e informe na tela de

Parmetros Iniciais, o Programa Inicial SIGACFG. Configure os seguintes parmetros:
Preencher parmetro MV_APS com TOTVS;
Caso deseje utilizar quantidades negativas no Protheus, dever habilitar o parmetro

MV_NEGESTRUT;
As ordens que forem geradas pelo TOTVS APS no sofrero efeito dos parmetros
MV_GERAOPI e MV_GERASC (utilizados no Microsiga Protheus para gerar
Solicitaes de Compras e Ordens de Produo dos semi-elaborados). Isso ocorre
porque o TOTVS APS envia ao Microsiga Protheus tudo que deve ser criado de
SCs e OPs.As ordens de produo criadas no Protheus continuam respeitando os
parmetros acima citados;
5. Obter licenas para Web services do Protheus: para a utilizao de web services no
Protheus so necessrias liberaes de licenas do tipo TOTVS I;
6. Executar o programa update para criao da tabela de operaes da ordem SHY: na

entrada do Protheus digitar o programa U_UPDPCP16. O programa tem interface de
Wizard. Basta avanar os passos selecionando as opes conforme vo aparecendo e
concluir.
7. Configurar Web Services Protheus:
Parametrizar um WebServices do Protheus para cada filial envolvida na integrao.

Exemplo: Filial 1 http://servidor:8010/ws1; Filial 2 http://servidor:8010/ws2;
Cada WebService deve possuir pelo menos 1 agente ativo e disponvel para
integrao com APS, pois so geradas chamadas simultneas para ordem de
compra, ordem de produo e operao. Para garantir um bom desempenho na
integrao sugerido, no mnimo, a utilizao de 5 JOBS (5 licenas) para
cada filial que executar o planejamento APS x Protheus;
Configurao do .ini do Protheus com web services, esse ponto vital para o
funcionamento da integrao, os web services devero estar parametrizados
conforme o exemplo abaixo:
[HTTP]
ENABLE=1
PATH=C:\p10\Protheus_Data\web\ws
PORT=8010
ENVIRONMENT=ENVIRONMENT
UPLOADPATH=\Protheus_Data\web\ws
[JOB_WS_0101]
TYPE=WEBEX
INSTANCES=5,5
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=01,01
[localhost:8010/ws]
ENABLE=1
PATH=C:\p10\Protheus_Data\web\ws
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_0101
DEFAULTPAGE=wsindex.apw
[ONSTART]
JOBS= JOB_WS_0101
Os parmetros que sero modificados so:
a. ENVIRONMENT: Colocar o ambiente. Exemplo: PRODUCAO, TESTE,

DESENVOLVIMENTO;
b. PORT: Endereo da porta que rodar o servio (pode ser qualquer uma
disponvel);
c. [JOB_WS_0101]: Nome do JOB Responsvel pelo servio ( sugerido utilizar

algo pra identificar que o JOB referente a uma determinada Empresa e Filial)
Exemplo: JOB_WS0101, JOB_WS0102;
d. INSTANCES: O Primeiro valor antes da vrgula se refere quantidade de JOBS

que iram iniciar junto do servio. O segundo valor referente ao Nmero de
JOBS para executar o servio (sugerimos ao menos 5 para bom desempenho).
Exemplo: INSTANCES=3,5. Reservo 5 Jobs para o meu servio, porem inicio
apenas 3. Se for necessrio usar os outros 2 Jobs, ele ir verificar se eles esto
disponveis, e da utilizar o servio. Sugerimos que a quantidade de Jobs
reservada e iniciada sejam as mesmas, pois j reservado o numero necessrio
para a integrao, tendo um bom desempenho.
e. PREPAREIN: O primeiro valor antes da virgula se refere ao cdigo da empresa

cadastrada no ambiente Protheus. O segundo valor referente ao cdigo da
filial. Exemplo: PREPAREIN=01,01;
f. [localhost:8010/ws]: Deve-se colocar no formato <Servidor>:Port/<Nome do

WS dessa filial> Exemplo: Server:Port/ws_01;
g. RESPONSEJOB: Deve ser o nome do JOB parametrizado conforme o tpico

c;
h. JOBS: Deve ser parametrizado com os Jobs de todas as filiais separados por
vrgula ex: JOB_WS0101, JOB_WS0102;
i. Caso se tenha mais filiais, deve-se repetir dos passos C ao G para cada filial, e
tambm colocar nos JOBS (tpico h), o nome do JOB responsvel por cada
filial adicionada.
8. Atualizar clients dos WebServices que sero utilizados pela integrao, que so:
MTPurchasesRequest, MTProductionOrder e MTIntegrationAPS;
3.1.1. Atualizando Client WebServices

1) Atravs de um navegador de internet, acessar a lista de servios do WS Protheus
(atravs da URL utilizada no totvsappserver.ini). Clicar no servio a ter o client
atualizado. Exemplo: http://servidor:8010/ws1
2) Na tela seguinte sero apresentados os detalhes do servio acessado. Clicar no link a

direita do texto Descrio do Servio (WSDL).
3) Aps clicar no link ser aberta uma nova janela no navegador. Nesta janela dever ser
copiada a URL contida na barra de endereos.
4) Acessar o Totvs Developer Studio (Protheus) e acessar o menu Arquivo/Novo, em

seguida acessar o menu Ferramentas/Gerar Client WebService.
5) Na janela exibida, informar a URL copiada e confirmar. No novo arquivo ser gerado o
cdigo do client ws.
6) Salvar o arquivo com um nome qualquer, adicion-lo ao projeto e compilar. Se no

ocorrerem erros o processo esta finalizado.
7) Caso seja gerado um erro acusando classe duplicada o arquivo dever ser salvo com
nome idntico ao apresentado na mensagem de erro (logo aps as palavras Encontrada
em).
8) Remova o arquivo antigo do projeto, adicione o novo e compile-o. Se no ocorrerem

erros, o processo est finalizado.
9) Para integrao APS x Protheus: gerar o client dos servios:
a. MTINTEGRATIONAPS
b. MTPRODUCTIONORDER
c. MTPURCHASESREQUEST
10) No log do Protheus podem ser encontradas as mensagens de erro ocorridas durante seu
uso. Seguem abaixo as mais comuns e como proceder para sua correo.
Erro Mensagem Soluo
No foi possvel post em... O erro ocorre quando por algum motivo no foi possvel
estabelecer comunicao com o servidor. Possveis
solues:
1) Verificar a disponibilidade de licenas Protheus.
2) Recompilar o client do servio executado.
HELP... Mensagens de erro iniciadas por este assistente indicam
retorno negativo em alguma validao do Protheus. Na
maioria dos casos isto ocorre quando h inconsistncias
nos dados recebidos pelo WebService, como, por exemplo,
valores invlidos, campos obrigatrios no preenchidos,
cadastros incorretos etc.
Type mismatch... Tratam de erros de codificao nos programas do Protheus.
Array out of bounds... Nestes casos gerado um log de erro no arquivo error.log
Variable does not exist... do diretrio system no caminho de instalao do sistema
que permite a anlise do erro por analistas conhecedores do
Microsiga Protheus. Nestes casos deve-se entrar em
contato com a equipe de suporte Microsiga Protheus.
3.2. TOTVS APS

Na release Datasul 11.5.X:
Habilitar a integrao com Protheus por intermdio da rotina CD7070 - Liberao de

Funo Especial, ativando a funo integra-aps-protheus. Se a banco de dados do
Protheus for Oracle, habilitar tambm a funo protheus-oracle;
Parametrize na rotina DB0100 Configurao Programas, as seguintes informaes:
o Empresa: Extremamente importante a parametrizao pois sem isso ser impossvel

executar o procedimento de atualizao de dados;
o Diretrio Retorno: informar o diretrio das informaes de retorno do ERP para o

APS, aps a confirmao da programao. Neste diretrio sero gravadas
informaes referentes a ordens de produo (e suas operaes) e ordens compras
criadas no ERP, que sero utilizados pela rotina Monitor de Integrao APS.
(DB0299). Deve ser preferencialmente um diretrio de rede. A sesso do Agente
EAI Receiver deve ter o mesmo diretrio de retorno informado;
o DSN / Usurio: informar a string com o DSN (Data Source Name ou Nome de
Fonte de Dados) e o usurio que ser autenticado no banco de dados. obrigatrio
o uso da barra normal / entre o DSN e o Usurio (No permitido a utilizao da
barra invertida \). Ex de parametrizao do Campo DSN / Usurio em Ambiente
APS x Protheus: P10/administrador. Nos bancos SQL, caso no haja um usurio,
sugerimos a criao do mesmo;
o Servidor: nome do servidor em que a base de dados do Protheus est hospedada;
o Senha: senha da base de dados.
Na release Datasul 12 ou superior - parametrize na rotina DB1000 Parmetros

Planejamento Avanado, as seguintes informaes:
o ERP Origem: selecione Protheus;

o Banco de Dados: informe qual o banco de dados utilizado pelo Microsiga Protheus;
utiliza
o Empresa: Extremamente importante parametrizao, pois sem isso ser
impossvel executar o procedimento de atualizao de dados;
o Diretrio Retorno ERP: informe o diretrio das informaes de retorno do ERP

para o APS, aps a confirmao da programao. Neste diretrio so gravadas
informaes referentes a ordens de produo (e suas operaes) e ordens compras
criadas no ERP, que so utilizados pela rotina Monitor de Integrao APS (DB0299
Deve ser preferencialmente um diretrio de rede. A sesso do Agente EAI Receiver
deve ter o mesmo diretrio de retorno informado;
o Datasource: informe a string com o DSN (Data Source Name ou Nome de Fonte de
Dados) e o usurio que ser autenticado no banco de dados.
o Usurio: informe o usurio do banco SQL do Protheus. Caso no haja um usurio,

necessrio a criao do mesmo;
o Servidor: nome do servidor em que a base de dados do Microsiga Protheus est

hospedada. No obrigatrio (quando o banco Oracle, a conexo feita somente
pelo Datasource, no utilizando a informao de servidor);
o Senha: senha da base de dados.

3.3. EAI
Neste ponto importante frisar que existem 2 configuraes a serem realizada: EAI
Sender e EAI Receiver.
EAI Sender: o EAI deve estar implantado na base do Datasul 11, com a transao
ConfirmationDBR assinada conforme figura abaixo.
EAI Receiver: o agente EAI receiver configurado como um atalho separado do

Datasul 11. Este atalho deve apontar para um arquivo de configurao do EAI
(eai-config.xml) diferente do atalho padro do Datasul 11.
A configurao deve conter a transao ConfirmationDBR apontando para o adapter
axrdb019.p, conforme figura abaixo.
Deve-se instalar o EAI para receber Webservice conforme documentao do EAI

(Agente Receiver padro processando mensagens no banco EAI).
3.3.1. Monitor de Integrao EAI

Permite a manuteno da fila de mensagens XML utilizadas na integrao assncrona do
EAI. As mensagens visualizadas no Monitor so filtradas de acordo com seu destino, estado de
processamento, tipo, transao s quais esto associadas e a data em que foram geradas.
Para acessar o Monitor de integrao, selecione a opo:
Foundation => Bsico (NPS) => Monitor de Integrao EAI
Ou executando o programa xmlutp\queue_monitor.p;
apresentada a janela da funo Monitor de Integrao (EAI9999), onde possvel

selecionar o estado de processamento da mensagem desejada.
Parametrizando o Destino como Out, so exibidas as mensagens de envio do APS
para o Protheus. Selecionado Destino como In so exibidas as mensagem de retorno do
Protheus (nmero das ordens criadas ou mensagens de erro ao tentar criar as ordens).
Se aps a confirmao, o ESB no fizer nenhum processamento (nenhuma alterao no
log do ESB), a mensagem de sada (out) ficar como no processada no Monitor de Integrao
EAI. Nestes casos, ou o ESB no est ativo (soluo: configurar e iniciar o servio ESB) ou ele
est no lendo a base EAI correta (soluo: configurar o ESB para ler a base EAI correta).
Para mais detalhes relacionados aos procedimentos do aplicativo Datasul EAI, acessar o
Manual de Referncia do EAI, em especial a funo Monitor de Integrao.
3.4. ByYou ESB

1. A verso ESB deve ser igual ou superior 12.2. Disponvel para Download no Portal do
Cliente:
2. Configure a licena do ByYou ESB conforme explicado no Guia de Instalao existente no

pacote de instalao do ByYouESB (pasta docs-esb localizada dentro do diretrio de
instalao do ESB)
3. Para configurar os diagramas do ESB necessrio baixar o TOTVS Developer Studio

verso 11 (TDS), tambm disponvel para Download no Portal do Cliente:
4. Instale o plugin que adiciona a perspectiva TOTVS ESB ao TDS
5. Copie os arquivos com os diagramas de integrao, localizados na mdia de instalao do

APS, na pasta Integrator/APS-ESB12. Caso necessrio consultar o arquivo TOTVS ESB -
Manual de Importaco e Exportao de Diagramas.pdf disponvel ou na instalao do TDS
ou na instao do ESB ou no site https://www.byyou.com
6. Altere os diagramas de integrao, contemplando as parametrizaes do EAI (servidor e

porta) e dos WebServices Protheus (endereo do WebService):
6.1. O Diagrama ser configurado conforme o detalhamento abaixo, para cada filial ser
necessrio replicar um diagrama de ordem de compra e 1 diagrama de ordem de
produo:
6.2. O primeiro componente que precisar ter a parametrizao alterada o que recebe as
informaes da fila do banco EAI Datasul:
Obs: obrigatrio a criao do usurio sysprogress no EMS Datasul. O parmetro

Host: deve ser configurado informando o servidor e porta (Broker SQL) em que o
servio do EAI est rodando. A mesma configurao dever ser feita no ltimo
componente do diagrama (Datasul Sender).
Exemplo para banco Datasul Oracle:

6.3. Os componentes Transformers j vem parametrizados e a princpio no precisam de

alterao. Devem estar configurados conforme abaixo:
Onde FileName ser informado com o caminho onde est localizado o .xsl do
transformer .
6.4. Os componentes Eachs j vem parametrizados e a princpio no precisam de alterao.

Devem estar configurados conforme abaixo:
Para Ordens de produo o Node Path ser parametrizado com:

ListaOPs/PUTPRODUCTIONORDER e para operaes com:
ListaOperacoes/PUTPOOPERATIONS.
6.5. Para cada Filial existente no Protheus, deveremos configurar um componente When
(simbolizado pela interrogao - ?):
O identificador SITE ser o responsvel para fazer a tratativa. E dever ser configurado
conforme abaixo:
Lembrando que esse um exemplo no caso de duas filiais, se houver a necessidade de

outras filiais, dever ser criado 1 identifier para cada filial, onde o identifier value ir
ser parametrizado com o cdigo da filial desejada no exemplo acima, filial 01 e filial
02.
6.6. O componente WS Sender (nesse caso ser apresentado o componente WSOCSender)

o responsvel por enviar a mensagem para o WebService interno (configurado em
outro diagrama do ESB). Esse WS interno ir reenviar a mensagem para o WebService
Protheus responsvel pelo servio de implantao do registro no Protheus. Os
componentes WS Sender j vem parametrizados e a princpio no precisam de
Aqui importante observar que o nmero da porta em WSDL Path ser o nmero da
porta parametrizado nos properties do ByYou ESB na opo HTTP Server:
Outra observao importante que o valor do parmetro name do objeto rec dever
ser exatamente igual ao nome do diagrama responsvel pelo envio das informaes ao
Protheus, neste caso o WSEMSOC.
A Configurao dos diagramas internos responsveis ao envio das informaes ao

Protheus sero realizadas conforme o exemplo abaixo:
6.7. Nos componentes WS Sender deve ser informando o WSDL Path, que indica o
caminho do WebService responsvel pelo servio desejado (nesse caso o servio de
ordens de compra :
http://vmint237.sp01.local:8010/ws/MTPURCHASESREQUEST.apw?WSDL).
6.8. Os componentes WS Sync Sender j vem parametrizados e a princpio no precisam

de alterao. Devem estar configurados conforme abaixo:
6.9. Os componentes On Error j vem parametrizados e a princpio no precisam de

6.10. Utilize as ferramentas e logs do ESB para verificar eventuais erros na configurao e
execuo:
Log do ESB: disponvel na pasta em que o ESB est instalado
(exemplo: C:\Totvs\ESB\data\esb.log) e que pode ser visualizado
atravs do link <host>/log/webtail.jsp na verso 12.2.3 do ESB (ex:
moitas:8085/log/webtail.jsp)
Logs dos Diagramas: os diagramas possuem alguns logs para verificar
como as mensagens esto vindo do APS e retornando do Protheus
(C:\Totvs\ESB\output\aps);
Monitor ESB: disponvel no servidor em que o ESB est instalado
atravs do link <host>/monitor/monitor.jsf (exemplo:
http://moitas:8085/monitor/monitor.jsf)
6.11. Lista dos erros mais comuns no By You ESB:

Erro Mensagem Soluo
java.io.FileNotFoundException: Verifique se o certificado est presente no diretrio raiz
'integrator.certs' not found in do produto ByYou ESB. Caso no esteja, solicite-o.
classpath
[Bootstrap] Arquivo de Verifique se no diretrio raiz do produto ByYou ESB
Configurao no encontrado. consta o arquivo de diagramas do produto, chamado de
(C:\ByYou\ESB\totvsesb- totvsesb-config.xml.
config.xml)
Exitting application Essa mensagem indica que o nmero de integraes
java.lang.Exception: Number of contratado foi ultrapassado. Deve ser solicitado um novo
Integrations exceeded limit. certificado ou revisados os diagramas, fazendo um
Allowed: 0 - Found: 2 saneamento deles.
Proxy configurations not found As propriedades no foram configuradas no produto
on integrator-config.xml! ByYou ESB. Acesse o produto, clique em Config Edit
Properties e insira as informaes necessrias, de acordo
com seu ambiente.
[LS Error -20] Excedeu numero A licena do ESB est invlida. Entre em contato com o
de licencas.. suporte ESB para obter uma licena vlida
4. Caractersticas da Integrao
4.1. Acesso as tabelas no Protheus: Exclusivo x

Compartilhado
A integrao contempla as situaes de tabelas compartilhadas e exclusivas existentes no

Protheus, sendo que existem algumas restries que devem ser respeitadas:
Estrutura: No podem existir estruturas diferenciadas para um mesmo item,

independente se as tabelas de estrutura e item estejam configuradas como
compartilhadas ou exclusivas.
o Caso exista estrutura para mais de uma filial, somente a da primeira filial ser
considerada;
o Um mesmo cdigo de item no poder existir em mais de um estabelecimento, pois
o controle de Item do APS no por estabelecimento. Ex: Item 00A41 vinculado ao
Estab 1 e 2, sendo que no Estab 1, ele possui a descrio Madeira e no Estab 2
possui a descrio Chapa de Ao
Para alguns cadastros do Protheus, h uma limitao quando usados de forma exclusiva.
Para estas entidades, quando houver registros de filiais distintas, porm de mesmo
cdigo, sempre ser considerado o primeiro registro encontrado, desconsiderando-se os
demais. So estas entidades:
o Recursos;
o Tipo de Produtos;
o Ferramentas;
o Centro de Trabalho;
o Grupo de Produtos;
o Unidade de Medida.
Empresa: a integrao APS x Protheus monoempresa, ou seja, o APS s l dados de
uma s empresa do Protheus. Assim, para cada empresa existente no Protheus, seria
necessrio uma base do APS (bancos mgdbr e movdbr)
31 Manual de Integrao APS e Protheus
4.2. Entidades / Transaes

Na Atualizao de Dados do Planejamento, o APS acessa o banco de dados Protheus para busca de dados das seguintes entidades:
Entidade Descrio Alias APS Alias Protheus Rotina(s) Protheus Filtro aplicado
Grupo de Classificao dos itens conforme Grupo de
grp-estoq-dbr SX5 Dicionrio de Dados (CFGX031) Nenhum.
Estoque* Estoque.
Se alias exclusivo no Protheus e
Centro de Indica quais so as mquinas pertencentes a existirem cdigos iguais em filiais
ctrab-dbr SH1 Recursos (MATA610)
trabalho* um grupo de mquinas. diferentes, ir considerar o primeiro
registro cadastrado.
Ferramentas de produo, restritivas e no- existirem cdigos iguais em filiais
Ferramenta* ferram-dbr SH4 Ferramentas (MATA620)
restritivas. diferentes, ir considerar o primeiro
Grupo de Mquina existirem cdigos iguais em filiais
Agrupamento de mquinas similares. gm-dbr SHB Centro de Trabalho (MATA770)
* diferentes, ir considerar o primeiro
Famlia de Classificao dos itens conforme famlia de existirem cdigos iguais em filiais
familia-dbr SBM Grupo de Produtos (MATA035)
Material materiais. diferentes, ir considerar o primeiro
Unidade de existirem cdigos iguais em filiais
Unidades de medida utilizadas pelos itens. unid-medid-dbr SAH Unidades de Medida (QIEA030)
Medida diferentes, ir considerar o primeiro
Roteiros de Lista de operaes que usadas na
rot-fab-dbr SG2 Quando houver roteiros de
Fabricao fabricao de um ou mais itens.
SH2 Operaes (MATA630) fabricao diferentes por filial:
Ferramentas da
Ferramentas utilizadas pela operao. op-ferr-dbr SH3 Recursos (MATA610)
operao
- Alm de incluir operaes para as
Centros de Mquinas vlidas para cada operao. ctrab-op-dbr
trabalhos vlidos filiais diferentes, necessrio que no

da operao cadastro de Produto do Protheus os
(opcional) itens existam nas duas filiais (tanto o
Vincula um roteiro de fabricao a um produto acabado quando seus
Roteiros do item rot-item-dbr
item. semiacabados e comprados);
Processo de Indica o roteiro e lista de componentes a ser
fabricao do item utilizado na produo conforme parmetros proces-item-dbr - No APS, quando utilizado um
determinados. cenrio monoestabelecimento, o
roteiro utilizado ser sempre o da
filial padro do item (que ser a
primeira filial encontrada. Exemplo:
01);
Operaes do item - Quando utilizado um cenrio

Operaes realizadas na fabricao do item. operac-engr
\ do roteiro multiestabelecimento, o roteiro
utilizado ser o da malha informada
no cenrio (exemplo: malha do
cenrio com estabelecimento 02, usa
roteiro da filial 02).
Campo Entra MRP (B1_MRP)

Parmetros dos itens (normais, DD, como Sim.
Item item-dbr SB1 Produtos (MATA010)
configurados). Itens diferente de mo-de-obra
(MOD).
Item /
Parmetros dos itens x estabelecimento. item-estab-dbr SBZ Indicadores de Produtos (MATA018) Nenhum.
Estabelecimento
Componentes de quantidade varivel
(G1_FIXVAT = V) so trazidos
para o APS. No traz componentes
Estrutura* Lista de materiais para fabricao do item. estrut-item-dbr SG1 Estruturas (MATA200) com quantidade fixa.
existirem cdigos iguais em filiais
diferentes, ir considerar o primeiro
Documentos sem eliminao de
resduo (C?_RESIDUO <> S).
Documentos com saldo (C?_QUANT
Ordem de SC1 Solicitaes de Compra (MATA110)
Ordens de compra e produo existentes no > C?_QUJE).
Produo / Ordem ord-dbr SC7 Pedidos de Compra (MATA120)
ERP. Documentos no suspensos
de Compra SC2 Ordens de Produo (MATA650)
(C2_STATUS <> U).
Documentos no encerrados
(C2_DATRF = ).
Operaes com saldo (HY_QUANT >
0).
Operaes no encerradas (H6_PT =
Operao da OP Operaes da ordem de produo. op-ord-dbr SHY Ordens de Produo (MATA650)
T).
Operaes vinculadas a itens que no
sejam fantasma
Reservas da Ordem de produo, indica os
Reservas com saldo (D4_QUANT <>
Reserva da OP itens previstos na fabricao (no indica res-ord-dbr SD4 Ordens de Produo (MATA650)
0).
que o item est reservado no estoque).
SB2 Saldos em Estoque (MATA225) Saldos disponveis (B2_STATUS <>
Saldos em Estoque Saldos em estoque oriundos do ERP. sdo-estoq-dbr
SB8 Lotes (MATC060) 2).
SC5
Pedidos tipo Normal (C5_TIPO =
Pedidos de venda Pedidos de vendas oriundos do ERP. pdven-dbr SC6 Pedidos de Venda (MATA410)
N).
SC9
SD1 Documento de Entrada (MATA103) Documentos com TES de
Saldo em poder de
Saldos de estoque em poder de terceiros. sdo-terc-dbr SD2 Documento de Sada (MATA460A) transferncia entre filiais
terceiros
SF4 Tipos Entrada/Saida (MATA080) (F4_TRANFIL = 1).
Fornecedores para apontamento de causa existirem cdigos iguais em filiais
Fornecedores* bmg-fornec SA2 Fornecedores (MATA020)
de murphies. diferentes, ir considerar o primeiro
Depsitos disponveis para serem
Depsitos bmg-depos SB2 Saldos em Estoque (MATA225) Nenhum
vinculados a malha.
(*) Para essas tabelas necessrio que o modo de acesso seja compartilhado. Caso o modo de acesso seja exclusivo e haja duplicidade de cdigo do
registro, ser trazido para o APS somente o primeiro registro encontrado.
Na Atualizao de Dados do Pontos de Controle, o APS acessa o banco de dados Protheus para busca de dados das seguintes entidades.
Entidade Descrio Alias APS Alias Protheus Rotina(s) Protheus Filtro Aplicado
Documentos sem eliminao de resduo
(C?_RESIDUO <> S).
Programao de produo SC2 Ordens de Produo (MATA650)
Documentos com saldo (C?_QUANT >
Status das gerada pelo DBR, e atualizada SG2 Operaes (MATA630)
bmg-programacao C?_QUJE).
Programaes na Atualizao Pontos de SH6 Apontamentos (MATA681)
Documentos no suspensos (C2_STATUS <>
Controle (BM0200). SC5 Pedidos de Venda (MATA410)
U).
Documentos no encerrados (C2_DATRF = ).
Necessidades de Material Reservas com saldo (D4_QUANT <> 0).
Necessidades geradas pelo DBR, e SD4 Ordens de Produo (MATA650)
bmg-necessidades
de material atualizadas na Atualizao SGF Operaes X Componentes (MATA635)
Pontos de Controle (BM0200).
Saldo de Estoque dos Itens
Inventrio
MTS, importados na SB2 Saldos em Estoque (MATA225)
das reservas sdo-estoq-mts Saldos disponveis (B2_STATUS <> 2).
atualizao Pontos de Controle SB8 Lotes (MATC060)
(saldos)
(BM0200).
Documentos sem eliminao de resduo
(C?_RESIDUO <> S).
Ordens de Produo e Compra
SC1 Solicitaes de Compra (MATA110) Documentos com saldo (C?_QUANT >
OC e OP Itens MTS importadas na
bmg-ord-mts SC7 Pedidos de Compra (MATA120) C?_QUJE).
Item MTS atualizao Pontos de Controle
SC2 Ordens de Produo (MATA650) Documentos no suspensos (C2_STATUS <>
(BM0200).
U).
Documentos no encerrados (C2_DATRF = ).
Na Confirmao da Programao, o APS utilizam as seguintes transaes para integrao:

Entidade Tipo Objetivo
ConfirmationDBR Sender Envia a Ordens de Produo, Operaes da Ordem de Produo e Ordens de Compra.
ReturnConfirmationDBR Receiver Recebe o nmero de cada Ordem de Produo e Compra criada no ERP.
4.3. Entidades do APS sem correspondente no Protheus

As tabelas listadas abaixo foram entidades identificadas no APS que no possuem
correspondncia nas tabelas do Protheus. Para cada caso foi adotada uma soluo conforme
segue.
O APS no trata o conceito de grade existente no Protheus.
Tabelas em que sero utilizadas informaes cadastradas no APS:
Tabela Soluo
Calendrio
Utilizar a rotina Manuteno de calendrio (DB0137).
Datas Calendrio
Turno Utilizar a rotina Modelos de turnos (DB0138).
Turno Dia
Utilizar a rotina Estabelecimento / Filial (DB0136), acessada
Estabelecimento*
atravs da rotina Manuteno Cenrio (DB0101)
Relaciona os modelos de turno utilizados pelo grupo de
mquina. Como a informao no existe no Protheus ser
Grupo de Maquina x Modelos
considerado para todos os grupos de mquina o turno
Turno (Turno GM)
informado nos Parmetros do Cenrio (DB0101). Utilizar a
rotina de Relacionamento GM x Turno (DB0139)
Turnos de Exceo So informaes que devem ser cadastradas diretamente no
Detalhes Turno Exceo TOTVS APS, pois no h entidades correspondentes no
Cdigo Redutor Preparao Protheus.
Matriz Redutor Preparao
Recurso Secundrio
Recurso Secundrio x Centro de
Trabalho
Recurso Secundrio x Operao
Grupo de Mquina x Grupo de
Mquina Alternativo
Tabelas em que sero criadas com somente um registro (valor fixo):

Linha de Produo Indica a linha de produo da ordem de produo.
Planejador Planejador das ordens de produo.
rea de Produo Agrupa os grupos de mquina em reas.
Tabelas que no sero consideradas:

Referncia* Cdigos de referncia vlidos (variaes do item).
Referncia do item (variaes de um item, como cor ou
Referncias do item*
tamanho).
Referencias da estrutura* Relaciona referncias dos itens pais e itens filhos da estrutura.
Operao Padro Operao Padro da engenharia.
* Entidades que no sero utilizadas na integrao, pois no Protheus constar sempre o cdigo do
item/produto, j contemplando o que referncia/grade no APS.
4.4. Campos do APS e seus correspondentes no Protheus

So os campos que so atualizados no APS atravs dos dados do Protheus. Os campos que no
existem no Protheus podem ser atualizados diretamente no APS. Ao executar novamente o
passo da atualizao, essas alteraes no sero sobrescritas. Porm se o campo existir no
Protheus, ou tiver algum correspondente, ele ser sobrescrito com o valor vindo do Protheus
toda vez que for rodado a atualizao e solicitado para atualizar tal tabela.
Nas tabelas abaixo esto os campos das principais entidades que sero atualizados do Protheus.
Os demais campos so informados diretamente no APS.
Famlia Materiais
Campo no Protheus Campo no APS Observao
Cd. Grupo Famlia
Desc. Grupo Descrio
Item Manufatura
Na primeira atualizao, respeitar a regra
abaixo:
Fabricados: Se houver lote econmico
informado no Protheus, esse item ser Lote
Poltica Econmico, seno ser Nvel Superior.
Comprados: Todos os comprados sero
Perodo Fixo.
Nas demais atualizaes ser mantido o
valor parametrizado no APS.
No Protheus, o Lote Mnimo indica a
Lote Mnimo para quantidade mnima a ser produzida aps o
fabricado e Qtd Embalag Lote Mltiplo Lote Econmico, ou seja, similar ao Lote
para comprado. Mltiplo no APS. Para comprados, usamos
o campo Qtd. Embalag. do Protheus.
Lote Econmico Lote
Grupo Famlia
Se Tipo for igual a Normal, vir para o APS
marcado como Quantidade Fracionada, caso
Tipo Dec. OP Quantidade Fracionada
contrrio, vir desmarcado, pois arredonda a
frao.
Segurana Quantidade Segurana
Para Itens Comprados -No APS convertido
Entrega Ressupr Fornec para dias, conforme parametrizado no
Protheus.
Para Itens Fabricados - No APS convertido
Entrega Ressupr Fabric para dias, conforme parametrizado no
Protheus.
Filial Estabelecimento
O campo Valor item exibido em
consultas e relatrios, por exemplo a
Custo Stand. Valor Item
Consulta de Ganho, Consumo e Desembolso
(db0416)
Campos sem correspondente no Protheus: Fator Refugo, Horizonte Fixo, Perodo Fixo,
Quantidade Perda, Ressupr Compras, Ressupr CQ Compras, Prioridade, Planejador,
Antecipao, Lote Mnimo, Lote Mximo, Arredonda Sobra, Divide Ordem.
Ferramenta Produo
Cdigo Ferramenta
Descrio Descrio
Grupo de Mquinas (Centro de Trabalho)

A entidade grupo de maquina no APS
Cdigo C.T. Grupo Mquina corresponde entidade centro de trabalho do
Protheus.
Nome Descrio
Centro de Trabalho (Recurso)

A entidade centro de trabalho no APS
Cdigo Centro Trabalho
corresponde entidade recurso do Protheus.
Nome Recurso Descrio
Centro Trab Grupo Mquina
Campos sem correspondente no Protheus: O campo Eficiencia Ctrab no APS poderia ser
atualizado com o valor do campo M.O (efic) do Protheus, porm, como no Protheus no
possvel valores decimais(Ex.: 1,2), optamos por deixar o usurio informar esse valor no APS.
Centro de Trabalho Vlido

Para cadastrar um centro de trabalho vlido
no Protheus existem 3 opes:
1) Informar o recurso na prpria operao.
2) Diretamente no recurso principal (SH2
Recursos alternativos/secundrios):
estes sero vlidos para todas as
operaes que utilizam o recurso
Cdigo (Recurso) Centro Trabalho principal.
3) Especfico para a operao (SH3
Recursos alternativos por operao):
estes sero validos somente para a
operao cadastrada.
Lembrando que no APS, o Centro de
Trabalho Vlido precisa pertencer ao mesmo
Grupo de Mquina da Operao.
Nome Recurso Descrio
Centro Trab Grupo Mquina
Roteiro Fabricao Operaes

Operao Operao
Descr. Oper. Descrio
Centro Trab. Grupo Mquina
Setup (Hs) Tempo Preparao
Tempo Padro Tempo Mquina
Lote Padro Unid.
Inicio Validade Padro 01/01/0001
Fim Validade Padro 31/12/9999
Campos sem Correspondente no Protheus: Tempo Homem, Tempo Significativo, Lote
Padro, Lote Mltiplo, Lote Mnimo.
Roteiro Fabricao Relao Item x Roteiro

Produto Item
Descrio Descrio
Inic Validade Padro 01/01/0001
Roteiro Fabricao Rede PERT

Cdigo da Operao Predecessora do Item
Oper Predec
cadastrado no Protheus
Descrio da Operao Predecessora do
Descrio
Item cadastrado No Protheus
Operao Op Suces
Descr. Oper. Descrio
Quando o Tipo Sobrep. = Tempo ou
Tempo Sobre. Lote Transferncia
Quantidade
Tempo Sobre. % Overlap Quando o Tipo Sobrep. = Percentual
Tempo Fim Tempo Transp
Vale salientar que para as ordens de produo firmes o overlap, lote de transferncia e tempo de
transporte considerados ser sempre o da engenharia do produto no Protheus (Exemplo: Se
alterar o tempo fim na engenharia do Protheus, afetar as ordens firmes).
Processo Fabricao Roteiros

Menor valor do campo Recno WT do
Roteiro
Produto
Descrio Formado pelo Cdigo do Produto / Filial
Inic Validade Padro 01/01/0001
Processo Fabricao Processos

Menor valor do campo Recno WT do

Roteiro
Produto
Filial Estabelecimento
Tais informaes podero ser visualizadas nas prprias telas do sistema, ao clicar no boto que
aparecer ao lado direito de cada campo atualizado com informaes do Protheus, conforme
abaixo:
4.5. Numerao de ordens de produo e compras

Sero importadas todas as ordens de produo, operaes da ordem de produo e
ordens de compras (solicitao e pedido de compra do Protheus) para o APS.
Ordem de Produo: Nmero da OP + Item + Sequencia + Filial (SC2.C2_NUM +

SC2.C2_ITEM + SC2.C2_SEQUEN + SC2.C2_FILIAL). A formatao ficar de
XXXXXX.99.999.99:
o Quando integrado ao APS, o Protheus no gera as ordens dos intermedirios
(PIs).
o O campo Grade (SC2.C2_ITEMGRD) no considerado. Assim, ordens de
produo com o mesmo nmero (SC2.C2_NUM + SC2.C2_ITEM +
SC2.C2_SEQUEN + SC2.C2_FILIAL) e grades diferente, ser importado
apenas a primeira ordem encontrada;
Ordem de Compra: Pode ser importado a partir de uma solicitao de compra, com os
campos Nmero da Solicitao + Item + Filial (SC1.C1_NUM + SC1.C1_ITEM +
SC1.C1_FILIAL) ou de um pedido de venda, com os campos Nmero do Pedido + Item
+ Filial (SC7.C7_NUM + SC7.C7_ITEM + SC7.C7_FILIAL). Para diferenciar as
solicitaes e pedidos no APS, ser usada a abreviao SC para solicitao de compra e
PC para pedido de compra. Essa abreviao estar composta no cdigo da ordem. A
formatao ficar de 999999.9999.SC.99 para solicitao de compra e
999999.9999.PC.99 para pedido de compra.
4.6. Horizonte Fixo e Eliminao de Ordens

Quando integrado ao Datasul EMS, o APS possui uma tratativa para trazer do ERP
somente as ordens de compra e produo dentro do horizonte fixo. Na integrao com o
Protheus sero trazidas todas as ordens de compra e produo, no considerando o horizonte
fixo.
Da mesma forma, ao confirmar a programao, o APS no ir eliminar as ordens de
produo e compra fora do horizonte fixo.
4.7. Atributos da rede PERT

No Protheus, essas informaes so cadastradas diretamente na operao. No exemplo
abaixo:
Na operao 02 o tipo de sobreposio foi informado como Quantidade. Isso

ser enviado para o APS como um lote de transferncia entre as operaes 01 e
02, na quantidade informada (40 unidades). A sobreposio considerada sempre
em relao operao anterior;
Na operao 03 o tipo de sobreposio foi informado como Percentual. Isso ser
enviado para o APS como um percentual de overlap entre as operaes 02 e 03
(30%);
Na operao 04 o tipo de sobreposio foi informado como Tempo. Como no
existe esse tipo de sobreposio no APS, ele ser convertido em um lote de
transferncia utilizando a seguinte frmula:
o Lote Transferncia = (Tempo Sobreposio * Lote Padrao) / Tempo
Padrao. Neste exemplo teramos: (0,5 * 100) / 2 = 25 unidades;
O tempo fim ser enviado para o APS como tempo de transporte. No exemplo abaixo,
haver 1 hora de tempo de transporte entre as operaes 01 e 02, e 3 horas aps o
trmino a operao 04.
Como a sobreposio sempre em relao operao anterior, caso seja cadastrado
uma sobreposio para a primeira operao (01), esse valor ser ignorado. O APS no
trata sobreposio entre ordens de produo (somente entre operaes da mesma
ordem).
5. Rotinas da Integrao
5.1. Atualizao de Dados - Planejamento

Na Atualizao de dados, aps realizar as configuraes descritas no tpico Pr-Requisitos,
basta selecionar as entidades que se deseja importar e clicar em Executar. Observao: O
campo empresa no programa db0100 (para a release Datasul 11.5.X) ou no programa
db1000 (a partir da release 12) deve estar parametrizado para a atualizao executar
corretamente
5.2. Atualizao de Dados - Pontos de Controle

Na Atualizao dos Pontos de Controle, aps realizar as configuraes descritas no tpico Pr-
Requisitos, basta clicar em Executar. Observao: no deve ser marcado a opo Integrao
XML, pois neste ponto a integrao feita atravs de acesso direto ao banco de dados.
Novamente importante que o campo empresa esteja parametrizado no programa db0100 (para
a release Datasul 11.5.X) ou no programa db1000 (a partir da release Datasul 12) para uma
correta atualizao dos pontos de controle.
5.3. Confirmao Programao

O processo de Confirmao da Programao realizado atravs de transao do EAI. Desta
forma, necessrio marcar a opo XML antes de executar. A integrao realizada de forma
assncrona: a mensagem criada na fila EAI, e ser buscada pelo ByYou ESB para ser integrada
ao Protheus via WebService.
Aps serem criadas as ordens de produo, compra e operaes, a numerao destas ordens
retornada ao APS, para que seja possvel verificar as consultas e relatrios j com a numerao
das ordens criadas no Protheus.
Atravs da rotina Monitor de Integrao APS (DB0299) possvel verificar quantas e quais
registros j foram efetivados no Protheus, alm dos possveis erros ocorridos durante a criao
das ordens e operaes:
Nota
- Para mais detalhes sobre as rotinas utilizadas na integrao, acesse o Manual de Referncia do
TOTVS APS.
6. Requisitos de Hardware
Este item tem por objetivo divulgar recomendaes sobre o uso de hardware relacionados ao
TOTVS APS, e algumas informaes sobre configurao dos mesmos. Estas recomendaes
tm por inteno ajudar nossos clientes na configurao do seu ambiente utilizando-o ao
mximo, obtendo uma melhor relao custo/benefcio. Porm no representam compromissos
com tecnologias ou algum fornecedor em especial por parte da TOTVS. A deciso sobre a
tecnologia e fornecedor de competncia do cliente, bem como o nvel de servio, segurana e
confiabilidade que deseja do seu ambiente. As posies deste relatrio tambm podem ser
alteradas, isto devido evoluo das tecnologias e dos nossos produtos.
importante lembrar que o ambiente cliente/servidor utilizado pelo TOTVS APS de

complexidade maior que um ambiente host-based. A correta configurao e tuning de todas
partes do ambiente (servidores, redes, clientes, banco de dados, etc.) importante para o
funcionamento do TOTVS APS, pois caso uma das partes esteja mal configurada toda a
performance do ambiente poder ser afetada.
As recomendaes e exemplos citados abaixo levam em considerao somente o uso do TOTVS
APS e outros softwares de uso genrico (Office e E-mail). No caso de instalao de outros
softwares no mesmo ambiente (que no sejam ligados ao TOTVS APS importante levar isto
em considerao, pois as recomendaes e exemplos abaixo podem no ser suficiente).
Requisitos para instalao da rea de Trabalho (Cliente)
- O sistema operacional deve ser Windows NT ou superior devido a capacidade de

gerenciamento de memria.
- Recomenda-se a seguinte configurao para uma boa performance, no caso de instalao de
PCs como estao de trabalho (Fat Client):
Recomendada
Core DUAL CORE ou CORE 2 DUO
Processador
(ou similar)
Cache Interno 1Gb
Memria 3 Gb
Disco 100 Gb
Placa Rede 10/100 Mbits
Vdeo SVGA (1024 x 768) min
Obs.: Essas recomendaes se aplicam a ambiente e tecnologias atuais.
TOTVS APS at pode ser executado em estaes com menos memria , ou uma CPU menos
potente, entretanto a performance estaria abaixo do aceitvel. No recomendamos o uso de
estaes menores que o mnimo pois a performance no atender as necessidades dos usurios
em nenhum caso. Caso a sua empresa possua muitas estaes com configuraes inferiores a
mnima recomendada, sugerimos utilizar o recurso de Servidores de Terminais Grficos que ir
utilizar este hardware j existente.
A configurao recomendada atende a maioria dos usurios, contudo para usurios mais
exigentes talvez exista a necessidade de uma configurao melhor. Compreende-se por usurio
mais exigente aquele que utilize processos mais pesados (necessidade de uma CPU melhor e
uma placa de rede mais rpida e/ou ligada em uma porta de switcher dedicada para ele) ou de
um usurio que use vrias aplicaes simultneas (necessidade de mais memria para executar
processos como Office, E-mail, CAD, EIS, etc. ao mesmo tempo).
Recomendamos a ltima configurao para novos equipamentos, caso a empresa venha
adquirir novas estaes e queira utiliz-las por um longo tempo sem necessidade de upgrade e
sem ficarem obsoletos. Tambm foram levadas em considerao quais as configuraes que os
fornecedores de hardware esto oferecendo atualmente, e que tenham uma boa relao
custo/benefcio.
No caso das placas de rede recomenda-se comprar placas de fornecedores de primeira linha
(Ex.: 3COM, Cabletron, outros). Isto porque estas placas so mais performticas, tem drivers
suportados pela Microsoft, e tem muitos menos problemas de compatibilidade. Ou seja, a
confiabilidade, performance e qualidade so muito mais altas, com um acrscimo muito
pequeno de custo.
Requisitos para outros Tipos de Instalao: Para outros tipos de instalao como Servidor de
Aplicao, Banco de Dados e Programas sugerimos fazer um servio de SIZING.
Anexos
Roteiro de Configurao de Web Services e Portal

Protheus
Este boletim tem o objetivo de estabelecer um roteiro de configurao e utilizao do Portal

Protheus em uma rede corporativa (LAN). Esse roteiro de configurao destina-se aos analistas
e tcnicos de infra-estrutura.
Mais detalhes consulte o documento Roteiro de Configurao de Web Services e Portal
Protheus (portal_roteiro_config_web_services_portal_protheus.pdf).
Boletim Tcnico Integrao com TOTVS APS

Este boletim tcnico traz informaes adicionais aos usurios Protheus de como realizar a
integrao com o TOTVS APS. Esse boletim encontra-se disponvel atravs do Portal de
Clientes(suporte.totvs.com). Escolher no menu a opo Microsiga Protheus, e na consulta
informar o chamado SCUJNA.
Microsiga Protheus
Produto : Planejamento e Controle de Chamado : SCUJNA
Produo verso 10
Data da
08/09/2010 Data da reviso 13/08/12
criao
Banco(s) de TopConnect/DBAcce
Pas(es) : Brasil :
Dados ss
FNC : 00000019006/2010

Manual de Integração APS X Microsiga Protheus PDF

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual de Integração APS X Microsiga Protheus PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Integrao

TOTVS APS e Microsiga Protheus

Gesto de Produto - Manufatura

Data Verso Descrio Autor

23/05/2011 1.1 Criao do histrico de alteraes Rafael Rosario

01/06/2011 1.3 Alteraes no tpico Numerao de ordens de produo e Rodrigo Michalski

01/07/2011 1.4 Incluso do tpico Requisitos de Hardware Ademar Widmann

01/06/2012 1.8 Restruturado o documento: renomeados alguns tpicos e Rafael Rosario

2.1 Viso Geral

O TOTVS APS uma ferramenta avanada de planejamento da produo, que roda

Veja abaixo o que o TOTVS APS pode responder:

O que, quanto e quando produzir;

Sendo que os Resultados gerados so:

Maior preciso nos Prazos de Entrega;

2.2. Ferramentas de integrao

EAI (Enterprise Application Integration): Processo para integrao de aplicaes

ESB (Enterprise Service Bus): Arquitetura de construo de software baseado no

3. Configurao da Integrao APS x Protheus

1. Atualizao de Dados - Planejamento: responsvel por buscar no ERP as informaes que

3. Confirmao da Programao: o APS ir enviar ao Protheus as informaes necessrias

A Confirmao de Programao realiza os seguintes passos (conforme figura acima):

1. A Confirmao gera a mensagem com as informaes a serem enviadas ao

2. O banco de dados do ERP Protheus dever ser Oracle ou MS-SQL.

4. Parmetros: para acessar a tela de parmetros, execute o Protheus e informe na tela de

Preencher parmetro MV_APS com TOTVS;

Caso deseje utilizar quantidades negativas no Protheus, dever habilitar o parmetro

6. Executar o programa update para criao da tabela de operaes da ordem SHY: na

7. Configurar Web Services Protheus:

Parametrizar um WebServices do Protheus para cada filial envolvida na integrao.

Os parmetros que sero modificados so:

a. ENVIRONMENT: Colocar o ambiente. Exemplo: PRODUCAO, TESTE,

c. [JOB_WS_0101]: Nome do JOB Responsvel pelo servio ( sugerido utilizar

d. INSTANCES: O Primeiro valor antes da vrgula se refere quantidade de JOBS

e. PREPAREIN: O primeiro valor antes da virgula se refere ao cdigo da empresa

f. [localhost:8010/ws]: Deve-se colocar no formato <Servidor>:Port/<Nome do

g. RESPONSEJOB: Deve ser o nome do JOB parametrizado conforme o tpico

3.1.1. Atualizando Client WebServices

2) Na tela seguinte sero apresentados os detalhes do servio acessado. Clicar no link a

4) Acessar o Totvs Developer Studio (Protheus) e acessar o menu Arquivo/Novo, em

6) Salvar o arquivo com um nome qualquer, adicion-lo ao projeto e compilar. Se no

8) Remova o arquivo antigo do projeto, adicione o novo e compile-o. Se no ocorrerem

9) Para integrao APS x Protheus: gerar o client dos servios:

3.2. TOTVS APS

Habilitar a integrao com Protheus por intermdio da rotina CD7070 - Liberao de

Parametrize na rotina DB0100 Configurao Programas, as seguintes informaes:

o Empresa: Extremamente importante a parametrizao pois sem isso ser impossvel

o Diretrio Retorno: informar o diretrio das informaes de retorno do ERP para o

o Servidor: nome do servidor em que a base de dados do Protheus est hospedada;

o Senha: senha da base de dados.

Na release Datasul 12 ou superior - parametrize na rotina DB1000 Parmetros

o ERP Origem: selecione Protheus;

o Diretrio Retorno ERP: informe o diretrio das informaes de retorno do ERP

o Usurio: informe o usurio do banco SQL do Protheus. Caso no haja um usurio,

o Servidor: nome do servidor em que a base de dados do Microsiga Protheus est

o Senha: senha da base de dados.

EAI Receiver: o agente EAI receiver configurado como um atalho separado do

Deve-se instalar o EAI para receber Webservice conforme documentao do EAI

3.3.1. Monitor de Integrao EAI

apresentada a janela da funo Monitor de Integrao (EAI9999), onde possvel

3.4. ByYou ESB

2. Configure a licena do ByYou ESB conforme explicado no Guia de Instalao existente no

3. Para configurar os diagramas do ESB necessrio baixar o TOTVS Developer Studio