Atualização Importante! Clientes na release 12.1.17 e 12.1.18 devem aplicar o pacote disponibilizado abaixo, que é compatível com a versão 4.0.1714.1002 (ou superior) do PC-Factory. Link para download: Update_TOTVS_MES_003-251017.zip Clientes em releases anteriores à 12.1.17 (12.1.14, 12.1.15 e 12.1.16) devem aplicar o pacote disponibilizado abaixo, que é compatível com a versão 4.0.1713.2002 do PC-Factory. Link para download: Update_TOTVS_MES_002-010617.zip |
As transações e mensagens utilizadas no TOTVS MES estão descritas na página Mensagens Datasul x PPI-Multitask - TOTVS MES.
Versão Datasul | Versão PC-Factory | Conteúdo PC-Factory |
---|---|---|
12.1.14 + Pacote de Atualização* 12.1.15 + Pacote de Atualização* 12.1.16 + Pacote de Atualização* | 4.0.1713.2002 |
|
12.1.17 | 4.0.1714.1002 |
|
12.1.18 | 4.0.1740.1001 |
|
12.1.19 | 4.0.1750.1003 | |
12.1.20 | 4.0.1750.1003 |
|
*Pacote de atualização: Update_TOTVS_MES_002-010617.zip
Manufacturing Execution Systems, ou simplesmente MES, é o termo usado para designar os sistemas focados no gerenciamento das atividades de produção e que estabelecem uma ligação direta entre o Planejamento e o Chão de Fábrica. Os sistemas MES geram informações precisas e em tempo real que promovem a otimização de todas as etapas da produção, desde a emissão de uma ordem até o embarque dos produtos acabados.
A importância destes sistemas vem da lacuna que normalmente existe entre o ERP (Entreprise Resource Planning) e os softwares específicos da linha de produção. O MES pode importar dados do ERP e integrá-los com o dia a dia da produção, gerenciando e sincronizando as tarefas produtivas com o fluxo de materiais.
Considerando que na cadeia de suprimento o maior valor agregado costuma estar na produção, faz todo sentido investir em sistemas que otimizem o fluxo, controle e qualidade do material (Fonte: PPI-Multitask).
A reunião dos meios de produção (matéria-prima, mão de obra e equipamentos) possibilita a fabricação de produtos que surgem pela ação dos Sistemas produtivos.
Os planos que servem de guia na execução e no controle da produção são comandados pelo órgão auxiliar denominado Planejamento e Controle da Produção (PCP), que dita normas a linha de produção, visando a um fluxo ordenado e contínuo do processo produtivo.
O objetivo da Integração PC Factory (software MES) X ERP Datasul é disponibilizar aos clientes TOTVS uma nova opção para controle da produção por meio da automação dos processos, permitindo a atualização e extração de informações de forma on-line de modo a simplificar o fluxo dos clientes, ao que chamaremos a solução como um todo de simplesmente: TOTVS MES.
4.0.1713.2002
A integração padrão atende movimentos de quantidades produzidas e horas reportadas, ou seja, não estão inclusos ajustes de requisições, as requisições necessitam ocorrer de forma automática no momento de reporte de acordo com pelo menos um dos recursos abaixo:
Além dos requisitos listados acima, somente são atendidas na integração TOTVS MES as ordens com política de reporte do tipo "Ordem" ou "Operação", ou seja, reportes por item no Chão de Fábrica não são suportados nesta fase do projeto.
Situações em que deve ser validado o processo utilizado pelo cliente: Checklist de Aderência ao Ambiente do Cliente. |
A integração TOTVS x PPI-Multitask necessita de uma parametrização de qual usuário será utilizado para a integração durante a comunicação com o WebServices do TOTVS MES, essa configuração é importada das credenciais de login do framework metadados, localizada em datasul_framework.properties.
Esse arquivo pode ser localizado em: %JBOSS_HOME%\server\<instancia>\conf\datasul\datasul_framework.properties.
As seguintes linhas representam as credenciais que necessitam ser informadas corretamente:
#+-------------------------------------------+
#| CONFIGURACOES METADADOS |
#+-------------------------------------------+<...>
java.naming.security.principal=<user>
java.naming.security.credentials=<password>
Também deverá ser parametrizado um role e user de integração no JBOSS, nos arquivos jbossws-roles.properties e jbossws-users.properties respectivamente, conforme exemplo:
Exemplo de arquivo jbossws-roles.properties:
# A sample roles.properties file for use with the UsersRolesLoginModule
eai=eai2allowed
Exemplo de arquivo jbossws-users.properties:
# A sample users.properties file for use with the UsersRolesLoginModule
eai=eai@123
Esses logins e senhas devem ser parametrizados na aplicação do PC-Factory.
O webservice disponibilizado para o TOTVS MES é encontrado por meio da URL: <hostname>:<porta>/mes-ws/MESService?wsdl
Para ativação do TOTVS MES é necessário:
Enquanto ainda estiver parametrizando a integração, é importante deixar desmarcada a opção "Ativo", assim é possível Testar o WebService e também efetuar a Carga, sem que as funções que geram mensagens comecem já a gerá-las. |
O botão de Testar WS verifica se é possível realizar a conexão com o WebService informado no campo URL do WebService. Este botão tem dois retornos:
O botão de Parâmetros abre o programa CP0106B que permite o cadastro de filtros para a integração de:
Pasta Ordem de Produção:
As situações a seguir exemplificam a utilização dos parâmetros:
Situação 1 - Poderá ser criado mais de um filtro para um mesmo campo.
Exemplo: somente as ordens criadas ou alteradas com os planejadores João ou José, estabelecimento ALM e linhas de produção 1 ou 2 serão enviadas para a PPI-Multitask.
Código do Campo | Descrição Campo |
Estabelecimento | ALM |
Linha de produção | 1 |
Linha de produção | 2 |
Planejador | João |
Planejador | José |
Situação 2 - Todas as ordens de produção criadas e alteradas serão enviadas para a PPI-Multitask se todos os filtros estiverem cadastrados com *.
Código do Campo | Descrição Campo |
Planejador | * |
Estabelecimento | * |
Linha de produção | * |
Situação 3 - Somente as ordens de produção com estabelecimento 1 serão enviadas para a PPI-Multitask.
Código do Campo | Descrição Campo |
Planejador | * |
Estabelecimento | 1 |
Linha de produção | * |
Um filtro poderá ser removido por meio do botão Remover, localizado no canto inferior direito do programa (CP0106B).
Pasta Item:
A exemplo do que acontece com a pasta Ordem de Produção, esta pasta também aceita o asterisco "*" para considerar todos.
Os dados registrados nesta pasta, filtrarão os registros de Item.
Pasta Lote Item:
A exemplo do que acontece com a pasta Ordem de Produção, esta pasta também aceita o asterisco "*" para considerar todos.
Os dados registrados nesta pasta, filtrarão os registros de Movimento que criaram um novo lote. Serão enviadas apenas as informações de criação deste novo lote. Quantidades não serão enviadas, por causa do risco de envio da mensagem XML de Saldo, em que o movimento foi desfeito por uma transação.
Pasta Estr/Oper:
A exemplo do que acontece com a pasta Ordem de Produção, esta pasta também aceita o asterisco "*" para considerar todos.
Os dados registrados nesta pasta filtrarão os registros de Estrutura e Operações.
As funções de estrutura (EN0105 e EN0109), sempre que alterarem algum componente da estrutura de um item, filtrarão pelos campos informados nesta pasta e enviarão a estrutura completa do item. Caso existaM referências relacionadas a estrutura, estas serão geradas também na mesma mensagem de estrutura em forma de lista.
Exemplo:
Item | Família | Grupo Estoque |
---|---|---|
Caneta | Escritório | Venda |
Corpo | Escritório | Geral |
Tampa | Plásticos | Plásticos |
Tubo | Plásticos | Plásticos |
Carga | Produto/Processo | Geral |
Ponta | Comprado | Geral |
Tinta | Comprado | Geral |
Apenas o filtro de Família foi indicado (família = "Escritório"), neste caso quando for alterado algum componente da Caneta, como este item é da família indicada, será gerada uma mensagem com todos os seus componentes (Corpo e Tampa), mesmo que a família dos componentes não seja a mesma.
Gerar Log mensagens XML da integração TOTVS MES é necessário:
Para desativar, efetuar o mesmo processo, porém o botão estará como Desativa. Somente ativar o log para validação de mensagem, depois de validada, desativar para que não fique consumindo recurso desnecessariamente. |
O grupo TOTVS representado por suas marcas administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
1.a Fase - Integração com Controle de Produção
As seguintes transações são usadas no TOTVS MES:
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Cadastros | 01 | Totvs | PPI-Multitask | Item_3_001.xsd | |
02 | Totvs | PPI-Multitask | Warehouse_1_000.xsd | ||
03 | Totvs | PPI-Multitask | WorkCenter_1_000.xsd | ||
04 | Totvs | PPI-Multitask | ProductionOrder_2_005.xsd | ||
Processos | 05 | PPI-Multitask | Totvs | ProductionAppointment_2_001.xsd | |
06 | Apontamento MOB/GGF | PPI-Multitask | Totvs | WorkforceAndOverheadAppointment_1_000.xsd |
2.a Fase - Integração com Chão de Fábrica
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Cadastros | 03 | Localização/Endereço | ERP Datasul | PPI-Multitask | AddressStock_1_000.xsd |
04 | ERP Datasul | PPI-Multitask | Machine_1_000.xsd | ||
05 | PPI-Multitask | ERP Datasul | StopReason_1_000.xsd | ||
06 | PPI-Multitask | ERP Datasul | WasteReason_1_000.xsd | ||
14 | Estrutura de Produto | ERP Datasul | PPI-Multitask | ItemStructure_1_001.xsd | |
15 | Roteiro de Operações | ERP Datasul | PPI-Multitask | ItemScript_1_000.xsd | |
16 | Ferramenta | ERP Datasul | PPI-Multitask | Resource_1_000.xsd | |
17 | Operador | ERP Datasul | PPI-Multitask | Resource_1_000.xsd | |
20 | Referência do Item | ERP Datasul | PPI-Multitask | ItemReference_1_000.xsd | |
Saldos | 01 | PPI-Multitask | ERP Datasul | StockLevel_2_000.xsd | |
18 | ERP Datasul | PPI-Multitask | ItemStockLevel_1_000.xsd | ||
Movimentos | 02 | PPI-Multitask | ERP Datasul | TransferWarehouse_1_003.xsd | |
08 | ERP Datasul | PPI-Multitask | ProductionOrder_2_005.xsd | ||
09 | ERP Datasul | PPI-Multitask | ProductionOrder_2_005.xsd | ||
11 | PPI-Multitask | ERP Datasul | MovementsInternal_1_001.xsd | ||
Apontamentos | 10 | PPI-Multitask | ERP Datasul | StopReport_1_001.xsd | |
12 | Reporte de Produção via PCP | PPI-Multitask | ERP Datasul | ProductionAppointment_2_001.xsd | |
13 | Reporte de Produção via SFC | PPI-Multitask | ERP Datasul | ProductionAppointment_2_001.xsd | |
14 | Refugo Avulso (Recusa) | PPI-Multitask | ERP Datasul | Refusal_1_000.xsd |
As transações e mensagens utilizadas no TOTVS MES estão descritas na página Mensagens Datasul x PPI-Multitask - TOTVS MES. |
Os programas afetados pela integração são apresentados na tabela abaixo:
Transação | Programa |
Item | CD0204 |
Depósito | CD0601 |
Grupo de máquina | CD0111 |
Ordem de Produção | CP0301 / CPAPI001 |
Localização de Estoque | CE0105 |
Estrutura Item | EN0105 |
Onde se Usa Item | EN0109 |
Centro de Trabalho | SF0104 |
Ferramentas | CD0124 |
Operador | SF0108 |
Processo de Fabricação (Operações) | EN0507 |
Motivo de Parada | BOMF510 (SF0106) |
Motivo de Refugo | SF0107 |
Gerenciamento de Pendências CD2900
Este programa tem por função administrar as pendências/exceções referentes à integração que são criadas quando ocorre um erro no envio. Permite o reprocessamento de uma mensagem, exclusão de uma pendência e a visualização do XML, além de possuir filtro por data de envio, transação, usuário e tipo de pendência. Foi disponibilizada no CD2900 a opção "Executar via RPW", que quando acionada, exibe a tela CD2900C - Gerenciamento de Pendências via RPW.
Carga Inicial Integração TOTVS MES - CD7002
O programa de carga inicial permite o envio das informações do item, depósito, grupo de máquina e ordem de produção e tem o objetivo de efetuar uma carga inicial no momento da implantação do PC Factory, ou então para sincronizar os dois produtos. Cada transação disponibiliza filtros para que o usuário decida o que quer enviar para a PPI-Multitask, esses filtros são apresentados conforme a transação escolhida.
Para ordem de produção, é possível a seleção também do estado das ordens. (O estado "Não Iniciada" somente será habilitada quando o módulo de SFC não esteja implantado no Datasul). |
Manutenção De-Para TOTVS MES - CD7003
O programa de cadastro de-para permite o cadastro da relação entre o estabelecimento do ERP Datasul e o estabelecimento da PPI-Multitask. Possuem os campos tipo de conteúdo, conteúdo ERP e conteúdo MES.
A função CD7004 gera um arquivo *.CSV do log gerado durante a integração, por isto o relatório apresentado em tela é apenas um demonstrativo da seleção realizada para a execução.
A localização e nome do arquivo *.CSV estão logo no começo do demonstrativo: "Log gerado em:"
Para facilitar a performance aconselha-se utilizar um intervalo de datas reduzido, e informar também o ID específico ou a transação desejada.
Um IDPCFactory pode ser apenas reprocessado em caso de erro em processamento anterior. |