Escolar Documentos
Profissional Documentos
Cultura Documentos
ndice
Histrico de Alteraes ................................................................................................................. 3
Introduo ..................................................................................................................................... 4
Viso Geral ................................................................................................................................ 4
Processos de Integrao............................................................................................................ 4
Pr-Requisitos para a Integrao APS x Protheus ......................................................................... 6
Protheus .................................................................................................................................... 6
Atualizando Client WebServices ............................................................................................... 9
TOTVS APS ............................................................................................................................... 12
EAI ........................................................................................................................................... 14
ByYou ESB ................................................................................................................................ 15
Observaes Importantes ........................................................................................................... 24
Acesso as tabelas no Protheus: Exclusivo x Compartilhado.................................................... 24
Entidades / Transaes ........................................................................................................... 26
Entidades do APS sem correspondente no Protheus.............................................................. 31
Campos do APS e seus correspondentes no Protheus............................................................ 32
Numerao de ordens de produo e compras ...................................................................... 35
Horizonte Fixo e Eliminao de Ordens .................................................................................. 36
Atributos da rede PERT ........................................................................................................... 36
Tecnologia ................................................................................................................................... 38
ByYou ESB ................................................................................................................................ 38
Protheus .................................................................................................................................. 38
Monitor de Integrao EAI ...................................................................................................... 39
Rotinas da Integrao.................................................................................................................. 40
Atualizao de Dados - Planejamento .................................................................................... 40
Atualizao de Dados - Pontos de Controle ............................................................................ 40
Confirmao Programao...................................................................................................... 41
Requisitos de Hardware .............................................................................................................. 43
Anexos ......................................................................................................................................... 45
Roteiro de Configurao de Web Services e Portal Protheus ................................................. 45
Boletim Tcnico Integrao com TOTVS APS ....................................................................... 45
Histrico de Alteraes
Data
Verso
Descrio
Autor
01/10/2010
1.0
Criao do Documento
Rafael Rosario
23/05/2011
1.1
Rafael Rosario
23/05/2011
1.2
01/06/2011
1.3
Rodrigo Michalski
01/07/2011
1.4
Ademar Widmann
11/07/2011
1.5
Rafael Rosario
1.6
Rodrigo Michalski
14/02/2012
1.7
Introduo
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 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.
Processos de Integrao
Antes de falarmos em processo de integrao, interessante esclarecermos os termos abaixo:
Manter ativos todos os agentes de comunicao que devero estar disponveis para a
busca e entrega das mensagens.
Protheus
Obter licenas para web services do Protheus: para a utilizao de web services no
Protheus so necessrias liberaes de licenas do tipo TOTVS I;
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
ENVIRONMENT=ENVIRONMENT
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
ENVIRONMENT=ENVIRONMENT
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_0101
Criar uma fonte de dados (ODBC) da base de dados do Protheus para que o APS possa
acess-lo;
Atualizar clients dos WebServices que sero utilizados pela integrao, que so:
MTPurchasesRequest, MTProductionOrder e MTIntegrationAPS;
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. Para acessar a tela de parmetros, informe na tela de Parmetros Iniciais,
o Programa Inicial SIGACFG;
3) Aps clicar no link ser aberta uma nova janela no navegador. Nesta janela dever ser
copiada a URL contida na barra de endereos.
10
11
TOTVS APS
12
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;
sem
isso
ser
13
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.
EAI
1) EAI implantado com as transaes de integrao assinadas conforme a configurao
abaixo:
14
ByYou ESB
15
Verso do produto deve ser igual ou superior 5.0.120. Disponvel para Download no
Portal do Cliente:
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:
16
17
Onde FileName ser informado com o caminho onde est localizado o .xsl do
transformer .
Os componentes Eachs sero configurados conforme a funo:
Path ser
para
parametrizado
operaes
com:
com:
O parmetro Name recebe o nome do campo que dever ser identificado (FilialOP para
ordens de produo).
18
O identificador SITE ser o responsvel para fazer a tratativa. E dever ser configurado
conforme abaixo:
19
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:
20
Outra opo 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 WSOC.
A Configurao dos diagramas internos responsveis ao envio das informaes ao Protheus
sero realizadas conforme o exemplo abaixo:
21
Onde o WSDL Path dever constar o caminho do WebService responsvel pelo servio
desejado (Nesse caso o servio de ordens de compra).
extremamente necessria a criao de um componente WS Notifier que dever ser
configurado conforme abaixo:
22
23
Observaes Importantes
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:
24
25
26
Entidades / Transaes
Na Atualizao de Dados do Planejamento, o APS acessa o banco de dados Protheus para busca de dados das seguintes entidades:
Entidade
Grupo
Estoque*
Descrio
Alias APS
de Classificao dos itens conforme Grupo de
grp-estoq-dbr
Estoque.
Centro
trabalho*
Filtro aplicado
SX5
Nenhum.
SH1
Recursos (MATA610)
SH4
Ferramentas (MATA620)
SHB
SBM
Ferramenta*
Grupo de Mquina
Agrupamento de mquinas similares.
*
gm-dbr
Famlia
Material
Unidade
Medida
de
Roteiros
Fabricao
Ferramentas
operao
Centros
na
rot-fab-dbr
op-ferr-dbr
ctrab-op-dbr
SG2
SH2
SH3
Operaes (MATA630)
Recursos (MATA610)
de
27
trabalhos vlidos
da
operao
(opcional)
Operaes do item
Operaes realizadas na fabricao do item. operac-engr
\ do roteiro
Item
Parmetros dos
configurados).
itens
(normais,
DD,
Item
/
Parmetros dos itens x estabelecimento.
Estabelecimento
Estrutura*
item-dbr
SB1
Produtos (MATA010)
item-estab-dbr
SBZ
SG1
Estruturas (MATA200)
28
registro cadastrado.
Documentos sem eliminao de
resduo (C?_RESIDUO <> S).
Documentos com saldo (C?_QUANT
Solicitaes de Compra (MATA110)
> C?_QUJE).
Pedidos de Compra (MATA120)
Documentos
no
suspensos
Ordens de Produo (MATA650)
(C2_STATUS <> U).
Documentos
no
encerrados
(C2_DATRF = ).
Operaes com saldo (HY_QUANT >
0).
Operaes no encerradas (H6_PT =
Ordens de Produo (MATA650)
T).
Operaes vinculadas a itens que no
sejam fantasma
Ordem
de
Ordens de compra e produo existentes no
Produo / Ordem
ord-dbr
ERP.
de Compra
SC1
SC7
SC2
Operao da OP
op-ord-dbr
SHY
Reserva da OP
SD4
SB2
SB8
SC5
SC6
SC9
SD1
SD2
SF4
sdo-estoq-dbr
pdven-dbr
Saldo em poder de
Saldos de estoque em poder de terceiros.
terceiros
sdo-terc-dbr
Fornecedores*
SA2
Fornecedores (MATA020)
Depsitos
Depsitos
disponveis
vinculados a malha.
SB2
para
serem
bmg-depos
Documentos
com
TES
de
transferncia
entre
filiais
(F4_TRANFIL = 1).
Se alias exclusivo no Protheus e
existirem cdigos iguais em filiais
diferentes, ir considerar o primeiro
registro cadastrado.
Nenhum
29
(*) 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
Programao de produo
Status
das gerada pelo DBR, e atualizada
bmg-programacao
Programaes na Atualizao Pontos de
Controle (BM0200).
Necessidades
de
Material
Necessidades geradas
pelo
DBR,
e
bmg-necessidades
de material atualizadas na Atualizao
Pontos de Controle (BM0200).
Saldo de Estoque dos Itens
Inventrio
MTS,
importados
na
das reservas
sdo-estoq-mts
atualizao Pontos de Controle
(saldos)
(BM0200).
Ordens de Produo e Compra
OC e OP Itens MTS importadas na
bmg-ord-mts
Item MTS
atualizao Pontos de Controle
(BM0200).
Filtro Aplicado
Documentos sem eliminao de resduo
(C?_RESIDUO <> S).
Documentos com saldo (C?_QUANT >
C?_QUJE).
Documentos no suspensos (C2_STATUS <>
U).
Documentos no encerrados (C2_DATRF = ).
Reservas com saldo (D4_QUANT <> 0).
SC2
SG2
SH6
SC5
SD4
SGF
SB2
SB8
SC1
SC7
SC2
Sender
Receiver
30
Soluo
Calendrio
Datas Calendrio
Turno
Turno Dia
Utilizar a rotina Estabelecimento / Filial (DB0136), acessada
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
Estabelecimento*
31
Famlia Materiais
Campo no Protheus
Cd. Grupo
Desc. Grupo
Campo no APS
Famlia
Descrio
Observao
Campo no APS
Observao
Na primeira atualizao, respeitar a regra
abaixo:
Fabricados: Se houver lote econmico
informado no Protheus, esse item ser Lote
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
quantidade mnima a ser produzida aps o
Lote Econmico, ou seja, similar ao Lote
Mltiplo no APS. Para comprados, usamos
o campo Qtd. Embalag. do Protheus.
Item Manufatura
Campo no Protheus
Poltica
Entrega
Filial
Custo Stand.
Lote
Famlia
Se Tipo for igual a Normal, vir para o APS
marcado como Quantidade Fracionada, caso
Quantidade Fracionada
contrrio, vir desmarcado, pois arredonda a
frao.
Quantidade Segurana
Para Itens Comprados -No APS convertido
Ressupr Fornec
para dias, conforme parametrizado no
Protheus.
Para Itens Fabricados - No APS convertido
Ressupr Fabric
para dias, conforme parametrizado no
Protheus.
Estabelecimento
O campo Valor item exibido em
consultas e relatrios, por exemplo a
Valor Item
Consulta de Ganho, Consumo e Desembolso
(db0416)
32
Ferramenta Produo
Campo no Protheus
Cdigo
Descrio
Campo no APS
Ferramenta
Descrio
Observao
Campo no APS
Cdigo C.T.
Grupo Mquina
Nome
Descrio
Observao
A entidade grupo de maquina no APS
corresponde entidade centro de trabalho do
Protheus.
Campo no APS
Cdigo
Centro Trabalho
Observao
A entidade centro de trabalho no APS
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.
Campo no APS
Cdigo (Recurso)
Centro Trabalho
Nome Recurso
Centro Trab
Descrio
Grupo Mquina
Observao
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
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.
Campo no APS
Observao
33
Operao
Descr. Oper.
Centro Trab.
Setup (Hs)
Tempo Padro
Lote Padro
Operao
Descrio
Grupo Mquina
Tempo Preparao
Tempo Mquina
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.
Campo no APS
Item
Descrio
Inic Validade
Fim Validade
Observao
Padro 01/01/0001
Padro 31/12/9999
Campo no APS
Oper Predec
Descrio
Operao
Descr. Oper.
Op Suces
Descrio
Tempo Sobre.
Lote Transferncia
Tempo Sobre.
Tempo Fim
% Overlap
Tempo Transp
Observao
Cdigo da Operao Predecessora do Item
cadastrado no Protheus
Descrio da Operao Predecessora do
Item cadastrado No Protheus
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).
Campo no APS
Roteiro
Descrio
Inic Validade
Fim Validade
Observao
Menor valor do campo Recno WT do
Produto
Formado pelo Cdigo do Produto / Filial
Padro 01/01/0001
Padro 31/12/9999
Campo no APS
Observao
34
Roteiro
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:
35
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.
36
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).
37
Tecnologia
ByYou ESB
Tratamento de Erros de Integrao (ByYou 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\totvsesbtotvsesb-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.
Protheus
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.
Tratamento de Erros de Integrao (Protheus)
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.
38
Acessar
-
"Opes"
Selecionar
no
menu
a
de
opo
qualquer
"Monitor
mdulo
do
de
ERP
2;
Integrao;
aplicativo
Datasul
EAI
tambm
pode
ocasionar
erros
de
execuo.
39
- Para mais detalhes relacionados aos procedimentos do aplicativo Datasul EAI, acessar o
Manual de Referncia do EAI, em especial a funo Monitor de Integrao.
Rotinas da Integrao
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 DBR2;01-EMS2.06B at 11.5.X) ou
no programa db1000 (a partir da release 11.8.0) deve estar parametrizado para a
atualizao executar corretamente
40
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.
41
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:
42
Nota
- Para mais detalhes sobre as rotinas utilizadas na integrao, acesse o Manual de Referncia do
TOTVS APS.
Roteiro de Configurao de Web Services e Portal Protheus
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
43
Cache Interno
Recomendada
Core DUAL CORE ou CORE 2 DUO
(ou similar)
1Gb
Memria
3 Gb
Disco
100 Gb
Placa Rede
10/100 Mbits
Vdeo
Processador
44
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).
Microsiga Protheus
: Planejamento e Controle de
Produo verso 10
Produto
Data
criao
da
08/09/2010
Pas(es)
: Brasil
FNC
: 00000019006/2010
Chamado
: SCUJNA
Data da reviso
Banco(s)
Dados
de
17/02/12
:
TopConnect/DBAcce
ss
45