Manual de Integração APS X Microsiga Protheus
Manual de Integração APS X Microsiga Protheus
Manual de Integração APS X Microsiga Protheus
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
01/10/2010 23/05/2011 23/05/2011
Verso
1.0 1.1 1.2 Criao do Documento
Descrio
Autor
Rafael Rosario Rafael Rosario Rafael Rosario / Rodrigo Michalski Rodrigo Michalski
Criao do histrico de alteraes Includo tpico Numerao de ordens de produo e compras Alteraes no tpico Numerao de ordens de produo e compras Incluso do tpico Requisitos de Hardware Includas algumas tabelas no tpico Entidades do APS
01/06/2011
1.3
01/07/2011 11/07/2011
1.4 1.5
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 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.
Processos de Integrao
Antes de falarmos em processo de integrao, interessante esclarecermos os termos abaixo:
Manual de Integrao APS e Protheus 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. 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); 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. O modelo EAI (Enterprise Application Integration), que consiste basicamente na troca de dados por intermdio de mensagens XML, utilizando para isso um conjunto de componentes, que compem um framework de integrao. As integraes EAI so feitas por transao de negcio, sendo que, uma transao de negcio pode ser interpretada como um cadastro (item, natureza de operao, empresa, etc.) ou uma rotina / tarefa (implantao de pedido, nota fiscal, ordem de compra, etc.).
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; Para garantir boa performance na integrao sugerida, 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 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
Manual de Integrao APS e Protheus 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.
Verificar se o Protheus est atualizado na ltima verso disponvel (Atualizao de pacotes e gerao dos clients WebServices MTINTEGRATIONAPS, MTPURCHASESREQUEST, MTPRODUCTIONORDER); 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.
O banco de dados do ERP Protheus dever ser Oracle ou MS-SQL. Criar uma fonte de dados (ODBC) da base de dados do Protheus para que o APS possa acess-lo; 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, novamente sugerido que existam pelo menos 5 agentes ativos no total por filial para um bom desempenho; Preencher parmetro MV_APS com TOTVS; Caso deseje utilizar quantidades negativas no Protheus, dever habilitar o parmetro mv_negestrut; 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;
2) Na tela seguinte sero apresentados os detalhes do servio acessado. Clicar no link a direita do texto Descrio do Servio (WSDL).
10
3) Aps clicar no link ser aberta uma nova janela no navegador. Nesta janela dever ser copiada a URL contida na barra de endereos.
Manual de Integrao APS e Protheus 4) Acessar o Totvs Developer Studio e acessar o menu Arquivo/Novo, em seguida acessar o menu Ferramentas/Gerar Client WebService. Na janela exibida, informar a URL copiada e confirmar. No novo arquivo ser gerado o cdigo do client ws.
11
5) Salvar o arquivo com um nome qualquer, adicion-lo ao projeto e compilar. Se no ocorrerem erros o processo esta finalizado. 6) 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).
12
7) Remova o arquivo antigo do projeto, adicione o novo e compile-o. Se no ocorrerem erros, o processo est finalizado. 8) Para integrao APS x Protheus: gerar o client dos servios: a. MTINTEGRATIONAPS b. MTPRODUCTIONORDER c. MTPURCHASESREQUEST
TOTVS APS
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; Na release DBR201-EMS2.06B at Datasul 11.5.X, 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; 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.
Manual de Integrao APS e Protheus (DB0299). Deve ser preferencialmente um diretrio de rede. A sesso do Agente EAI Receiver deve ter o mesmo diretrio de retorno informado;
o
13
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; Servidor: nome do servidor em que a base de dados do Protheus est hospedada; Senha: senha da base de dados.
o o
A partir da release 11.8.0, parametrize na rotina DB1000 Parmetros Planejamento Avanado, as seguintes informaes:
o
Empresa: Extremamente importante parametrizao, pois impossvel executar o procedimento de atualizao de dados;
sem
isso
ser
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;
14
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. Usurio: informe o usurio do banco SQL do Protheus. Caso no haja um usurio, necessrio a criao do mesmo; Servidor: nome do servidor em que a base de dados do Microsiga Protheus est hospedada; Senha: senha da base de dados.
EAI
1) EAI implantado com as transaes de integrao assinadas conforme a configurao
abaixo:
15
ByYou ESB
Manual de Integrao APS e Protheus Verso do produto deve ser igual ou superior 5.0.120. Disponvel para Download no Portal do Cliente:
16
Configure a licena do ByYou ESB conforme explicado no Guia de Instalao anexado no pacote de instalao; Copie os arquivos de configurao do ESB localizados na instalao do APS (pasta Integrator): o Renomei o arquivo APS_totvsesb-config.xml para esb-config.xml e copie o mesmo para a raiz da instao do ESB (C:\ByYou\ESB); o Copie os demais arquivos de configurao para o diretrio C:\transformers: APS_MTPRODUCTIONORDER.xsl APS_MTPURCHASESREQUEST.xsl APS_PUTPOOPERATION.xsl APS_ReturnConfirmation_OPERATION_NOK.xsl APS_ReturnConfirmation_OPERATION_OK.xsl APS_ReturnConfirmation_PO_NOK.xsl APS_ReturnConfirmation_PO_OK.xsl APS_ReturnConfirmation_PRODO_NOK.xsl APS_ReturnConfirmation_PRODO_OK.xsl APS_SiteProductionOrder.std APS_SitePurchaseOrder.std Alterar os diagramas de integrao, contemplando as parametrizaes do EAI (servidor e porta) e dos WebServices Protheus (endereo do WebService): 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:
17
O Primeiro componente o componente 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). Os componentes Transformers devem ser parametrizados conforme abaixo:
18
Onde FileName ser informado com o caminho onde est localizado o .xsl do transformer . Os componentes Eachs sero configurados conforme a funo:
parametrizado operaes
com: com:
O parmetro Name recebe o nome do campo que dever ser identificado (FilialOP para ordens de produo).
Manual de Integrao APS e Protheus O parametro Standard Name ser informado o caminho do arquivo Standard .std. Esse arquivo dever ser criado no menu Applications->StandardEdition e dever ser configurado para identificar o campo SITE . Para cada Filial deveremos ter um caminho a ser seguido:
19
O identificador SITE ser o responsvel para fazer a tratativa. E dever ser configurado conforme abaixo:
Manual de Integrao APS e Protheus 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. O componente WS Interno (Nesse caso ser apresentado o componente WSOCSender que o responsvel por enviar a mensagem para o WebService interno que ir re-enviar a mensagem para o WebService Protheus responsvel pelo servio de implantao de ordens compras) dever ser configurado conforme abaixo:
20
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:
21
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:
22
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:
O componente On Error dever ser configurado em todos os diagramas internos conforme abaixo:
23
Novamente todos os transformers e o EAI Sender devero ser configurados conforme apresentado anteriormente nesse documento.
24
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:
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; 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.
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* Centro trabalho* Descrio Alias APS de Classificao dos itens conforme Grupo de grp-estoq-dbr Estoque. de Indica quais so as mquinas pertencentes a ctrab-dbr um grupo de mquinas. Alias Protheus Rotina(s) Protheus SX5 Dicionrio de Dados (CFGX031) Filtro aplicado Nenhum. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro registro cadastrado. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro registro cadastrado. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro registro cadastrado. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro registro cadastrado. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro registro cadastrado. Quando houver roteiros fabricao diferentes por filial: de
SH1
Recursos (MATA610)
Ferramenta*
SH4
Ferramentas (MATA620)
gm-dbr
SHB
Famlia Material
SBM
de
de Lista de operaes que usadas fabricao de um ou mais itens. da Ferramentas utilizadas pela operao. de Mquinas vlidas para cada operao.
27
trabalhos vlidos da operao (opcional) Vincula um roteiro de fabricao a um rot-item-dbr item. Processo de Indica o roteiro e lista de componentes a ser fabricao do item utilizado na produo conforme parmetros proces-item-dbr determinados. Roteiros do item
filiais diferentes, necessrio que no cadastro de Produto do Protheus os itens existam nas duas filiais (tanto o produto acabado quando seus semiacabados e comprados); - No APS, quando utilizado um cenrio monoestabelecimento, o roteiro utilizado ser sempre o da filial padro do item (que ser a primeira filial encontrada. Exemplo: 01); - Quando utilizado um cenrio 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) como Sim. Itens diferente de mo-de-obra (MOD).
Item
itens
(normais,
DD,
item-dbr
SB1
Produtos (MATA010)
item-estab-dbr
SBZ
Indicadores de Produtos (MATA018) Nenhum. Componentes de quantidade varivel (G1_FIXVAT = V) so trazidos para o APS. No traz componentes com quantidade fixa. Se alias exclusivo no Protheus e existirem cdigos iguais em filiais diferentes, ir considerar o primeiro
Estrutura*
SG1
Estruturas (MATA200)
28
Ordem de Ordens de compra e produo existentes no Produo / Ordem ord-dbr ERP. de Compra
Operao da OP
op-ord-dbr
SHY
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 Ordens de Produo (MATA650) Saldos em Estoque (MATA225) Lotes (MATC060) Pedidos de Venda (MATA410) Documento de Entrada (MATA103) Documento de Sada (MATA460A) Tipos Entrada/Saida (MATA080) Fornecedores (MATA020) Reservas com saldo (D4_QUANT <> 0). Saldos disponveis (B2_STATUS <> 2). Pedidos tipo Normal (C5_TIPO = N). 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
Reserva da OP
Reservas da Ordem de produo, indica os itens previstos na fabricao (no indica res-ord-dbr que o item est reservado no estoque). sdo-estoq-dbr pdven-dbr
SD4 SB2 SB8 SC5 SC6 SC9 SD1 SD2 SF4 SA2
Saldos em Estoque Saldos em estoque oriundos do ERP. Pedidos de venda Pedidos de vendas oriundos do ERP. Saldo em poder de Saldos de estoque em poder de terceiros. terceiros
sdo-terc-dbr
Fornecedores*
Fornecedores para apontamento de causa bmg-fornec de murphies. Depsitos disponveis vinculados a malha. para serem bmg-depos
Depsitos
SB2
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 Alias Protheus Rotina(s) Protheus SC2 SG2 SH6 SC5 Ordens de Produo (MATA650) Operaes (MATA630) Apontamentos (MATA681) Pedidos de Venda (MATA410) 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).
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).
SD4 SGF
SB2 SB8
Saldos disponveis (B2_STATUS <> 2). 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 = ).
Na Confirmao da Programao, o APS utilizam as seguintes transaes para integrao: Entidade Tipo Objetivo
ConfirmationDBR ReturnConfirmationDBR Sender Receiver Envia a Ordens de Produo, Operaes da Ordem de Produo e Ordens de Compra. Recebe o nmero de cada Ordem de Produo e Compra criada no ERP.
30
31
Soluo Utilizar a rotina Manuteno de calendrio (DB0137). Utilizar a rotina Modelos de turnos (DB0138).
32
Famlia Materiais
Campo no Protheus Cd. Grupo Desc. Grupo Campo no APS Famlia Descrio Observao
Item Manufatura
Campo no Protheus 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.
Poltica
Lote Mnimo para fabricado e Qtd Embalag Lote Mltiplo para comprado. Lote Econmico Grupo Tipo Dec. OP Segurana Entrega 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)
Manual de Integrao APS e Protheus 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.
33
Ferramenta Produo
Campo no Protheus Cdigo Descrio Campo no APS Ferramenta Descrio Observao
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.
Cdigo (Recurso)
Centro Trabalho
34
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.
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).
35
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:
Manual de Integrao APS e Protheus 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
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;
37
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).
38
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.
39
opo
Integrao;
3 - apresentada a janela da funo Monitor de Integrao (EAI9999), onde possvel selecionar o estado de processamento da mensagem desejada. Para seleo, so apresentadas as seguintes opes: No processada: Quando selecionada, somente so apresentadas as mensagens no manipuladas no sistema de destino. Erro: Quando selecionada, somente so apresentadas mensagens que o sistema de destino encontrou algum problema ao recuper-las da fila. Processada: Quando selecionada, somente so apresentadas as mensagens processadas com sucesso no sistema de destino. Nota O aplicativo Datasul EAI tambm pode ocasionar erros de execuo.
40
- 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
Manual de Integrao APS e Protheus a release DBR2;01-EMS2.06B at 11.5.X) ou no programa db1000 (a partir da release 11.8.0) para uma correta atualizao dos pontos de controle.
41
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.
42
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:
43
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
Manual de Integrao APS e Protheus 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 (ou similar) 1Gb 3 Gb 100 Gb 10/100 Mbits SVGA (1024 x 768) min
44
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.
45
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).
Chamado
: SCUJNA
17/02/12 TopConnect/DBAcce ss