Integração Datasul x TOTVS MES 

Sumário 

Âncora
inicio inicio

• Pré-requisitos
• Instalação
• Configuração
• Lista de Mensagens - Transações
• Vá para o final

MJP

Quadro de compatibilidade: 

*Pacote de atualização: Integração Datasul x TOTVS MES

Contexto de negócio

1. MES

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).

2. Planejamento e Controle de Produção

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.

Sistemas Envolvidos

• TOTVS DATASUL 12
• PC-FACTORY (PPI MULTITASK)

Integração

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.

Lista de Mensagens - Transações

4.0.1713.2002

Escopo

Pré-requisitos instalação/implantação/utilização

1. Datasul

Pré-requisitos de instalação da integração:

• Datasul versão 12.1.13 (verificar a versão das mensagens existentes na base "XSD", pois este documento representa a liberação realizada na versão 12.1.17).
• Módulo de produção ou produção com SFC implantados.
• Servidor de Web Service, disponibilizado dentro do EAR Datasul 12.1.6.
• Configuração de usuário de integração EAI.
• Informar a relação entre o estabelecimento do ERP Datasul e o estabelecimento da PC-Factory (CD7003).
• Validação do ambiente de integração via Diagnóstico (CP0106).

Retorna ao início

Pré-requisitos de negócio:

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:

• Alocação de material;
• Ordens de produção com linha do tipo serviço poderão agora utilizar a mensagem de requisição em momento diferente do reporte;
• Ajustes nas reservas das ordens de produção para que cada componente possua depósito e localização de requisição informado.

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.

ATENÇÃO - Situações em que deve ser validar o processo utilizado pelo cliente.

a) PC-Factory não trata referência, no entanto, será possível visualizar itens com referência no mesmo (envio da mensagem de referências do item seja na carga CD7002 ou na relação item referência, CD1506). É possível utilizar itens controlados por referência para mensagens de Apontamento Produção, Requisição e Saldos, desde que o cliente não precise informar referência diferente das existentes como padrão no ERP. Já para a mensagem de Transferência entre depósitos, não é possível.

b) Ordens de produção com reporte por Item não serão integradas, pois não existe apontamento por item suportada pelo PC-Factory.

c) Operações de Roteiro de Produção e Listas de Componentes não serão integrados, pois o PC-Factory não trabalha com processo variável de fabricação.

d) O PC-Factory precisa da informação de qual operação cada componente será consumido, neste caso o cliente terá que informar na estrutura dos produtos a serem integrados, e no caso de OPs já abertas, manuteni-las antes da integração (carga inicial).

e) Para poder informar o consumo real na linha de Processo, deve ser enviado junto a mensagem de apontamento de produção. E para consumir o padrão, deve ser retirada toda a tag <ListOfSupplyOrders>. Caso apenas o PCP esteja ativo, obrigatoriamente para linha de processo deve ser enviada a lista de requisições com os mesmos componentes presentes na reserva, podendo zerar a quantidade (UsedQuantity), caso necessário, para não haver consumo. Obs.: o PC-Factory não envia as informações de OutflowWarehouseCode e OutflowLocationCode no apontamento, e caso o cliente deseje realizar o consumo pelo padrão na linha de Processo, deverá alocar as reservas antes, para que não ocorra erro.

f) Lembrando que a responsabilidade do uso das informações de Estrutura e Operações é do PC-Factory, pois o ERP somente tratará as Ordens de Produção que ele mesmo tenha criado. Sempre que forem alteradas informações destas rotinas, será enviada a mensagem “Upsert” com a lista completa, exceto quando não existir mais lista, que usará “Delete”.

g) O ERP para indicar um co-produto ou sobra durante a produção utiliza quantidades negativas em sua estrutura ou lista de componentes da Ordem de Produção. Há restrições quanto ao seu uso na integração, caso não sejam informadas estas reservas no momento do apontamento. (ver DT_DMANFACTORY01-4220_INTEGRACAO_TOTVS-MES_SOBRA)

h) O ERP trabalha com dois tipos de parada: setup e não setup: quando a parada for de setup, pode utilizar a mesma mensagem de Reporte de Produção, do contrário, usar o próprio Reporte de Parada. Na integração TOTVS-MES somente fará uso do segundo.

i) O ERP com o PCP apenas, Ordens com tipo de reporte por Operação também podem ser produzidas, informando apenas a quantidade produzida na última operação (conforme a FASE 1 da integração).

Agora poderá também ser informado o consumo real (requisição componentes) juntamente a produção. Caso não seja informada, ficará sem a requisição (quando a linha for de processo). A mesma mensagem será também utilizada para estorno.

j) O refugo deve estar na mesma mensagem da produção, mesmo que seja para refugar toda a produção. Para o ERP, se durante a produção identificou-se que o produto resultante é realmente um refugo (consumiu-se componentes e o acabado ficou inutilizável), nesta situação pode-se informar durante o processo produtivo a Quantidade total produzida, e também a quantidade refugada.

Exemplo: Produzidas 5000 peças
              Refugadas     46 peças
         --> Saldo         4054 peças

k) O ERP com o SFC, aceita apontamento de produção apenas de tempo sem quantidade, o contrário, não.

l) Os apontamentos de MOB e GGF, podem ser indicados na mensagem de apontamento de produção, do contrário, não serão feitos pelo padrão. O PC-Factory fará uso das mensagens de apontamento de MOB e GGF, já existentes na fase 1.

m) Na integração com SFC, os tipos de reporte, quando a OP for da linha de Processo, observar para envio do consumo real e refugo, na operação correta, para evitar que seja feito o consumo pelo padrão. Atenção redobrada que caso se deseje o consumo real, ao ser enviado ao menos um componente consumido junto com o apontamento de produção, para não ser feito pelo padrão.

n) A mensagem utilizada para o envio de novo Lote será ItemStockLevel. Não serão enviadas quantidades.

o) Informar o tipo da linha de produção na ordem (Processo ou Serviço), para que o PC-Factory saiba quando pode devolver apenas as requisições, sem necessidade de apontamento da produção.

p) Tempo Máquina e Tempo Homem no ERP Datasul, são dois campos, no entanto o PC-Factory possui apenas um, que pode receber ou tempo homem ou tempo máquina. Como o PC-Factory integra com dois de nossos ERPs (Datasul e Protheus), e para o Protheus o conceito de Tempo Homem é diferente do Datasul, foi necessário efetuar a padronização, para que o PC-Factory recebesse de ambos ERPs a mesma informação (tempo máquina foi o eleito). Sendo assim, é orientado que no ERP os clientes tenham valor registrado no campo tempo máquina.

q) O PC-Factory não trabalha com rede-pert, e sempre segue a ordem de numeração das operações da ordem. Quando o módulo SFC estiver ativo, o tipo de reporte da Ordem for por Operação (ou por Ordem parametrizado para seguir rede-pert), deve ser corrigida no ERP a numeração das Operações (Engenharia e Ordem de Produção) para que siga a sequência da Rede-pert.

Exemplo: Rede-pert de operações na Engenharia

Image Removed

Deverá ser corrigida para:

Image Removed

Demais recursos serão complementadas neste documento, conforme liberação das próximas fases.Check-List de Aderência

Instalação/Atualização

1. Servidor de Aplicação TOTVS

1.1 Servidor de aplicação legado (JBOSS)

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

Além disso, é necessário informar a TAG totvs.datasul.mes no arquivo service_locator.properties, conforme exemplo abaixo:

totvs.datasul.mes=${datasul.framework}

1.2 Servidor de aplicação Novo Frame (Tomcat)

• Caso o ambiente esteja configurado para utilizar Datasul for THF (Novo Framework), a URL de acesso ao webservice do MES é diferente, seguindo o padrão http://servidor:porta/totvsmes/public/ws/MESService.wsdl.
• O usuário de integração não mais será conforme a parametrização do Jboss (descrito no item 1.1) mas sim através de um usuário do sistema através de autenticação direta.
• Também deverá ser conferido a instalação do pacote totvsmes.war dentro do webapps do servidor de aplicação, conforme imagem abaixo:

Retorna ao início

2. Datasul

Para ativação do TOTVS MES é necessário:

1. Abrir o programa de Parâmetros do Controle da Produção - CP0106.
2. Selecionar a Página 5.
3. Na área de Integração TOTVS MES, marcar a opção Ativo.
4. Informar a URL do WebService.
5. Verificar a conectividade do WebService por meio do botão Testar WS.
6. Informar a Fase Integração como "2 - PCP + SFC".
7. Configurar os parâmetros da integração por meio do botão Parâmetros.
8. Confirmar a ativação por meio do botão OK.

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:

• Teste realizado com sucesso.
• Conexão com o WebService MES Channel falhou.

O botão de Parâmetros abre o programa CP0106B que permite o cadastro de filtros para a integração de:

 - Ordem de Produção:

• Linha de produção.
• Estabelecimento.
• Planejador.
• Reaproveitamento (linha de serviço específica para criação de ordem de produção interna para consumo de um acabado que trocou de código).

  - Item: 

• Código Item
• Família Material
• Grupo Estoque

 - Saldo Item:

• Código Item
• Família Material
• Grupo Estoque
• Estabelecimento
• Depósito
• Localização
• Espécie Documento

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. Por 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.

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 *.

Situação 3 - Somente as ordens de produção com estabelecimento 1 serão enviadas para a PPI-Multitask.

Situação 4 - Se não existir filtro cadastrado, então nenhuma ordem de produção será enviada para a PPI-Multitask.

Situação 1:

Situação 2:

Situação 3:

Um filtro poderá ser removido por meio do botão Remover no canto inferior direito do programa.

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: 

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:

1. Abrir o programa de Parâmetros do Controle da Produção - CP0106.
2. Selecionar a Página 5.
3. Na área de Integração TOTVS MES, pressionar o botão Log XML.
4. Na tela que abre pressionar o botão Ativa.
5. A partir deste momento sempre que houver algum envio de XML a partir do ERP, será gerada a mensagem no diretório informado.

Retorna ao início

Controle de Versão

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.

Suporte

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.

Programa de 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.

Programa de Carga inicial CD7002 - 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. 

Programa de cadastro de-para CD7003 - 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. 

Checklist de suporte da aplicação 

Âncora
final final

Checklist de Verificações:

• No programa CP0106, página 5:
     - Verificar se o checkbox Ativo da Integração PPI-Multitask está seleiconado.
     - Testar conexão com o WebService informado por meio do botão Testar WS.
     - Verificar se os parâmetros da integração foram preenchidos, acessando o botão de Parâmetros.
• Acessar o diretório “<Pasta temporária de trabalho>\INTEGR_MES” para verificar se o envio de uma transação foi executado sucesso ou se ocorreu um erro. (Válido por meio da rotina de carga inicial CD7002).
• Verificar se o cadastro De-para Totvs - MES foi preenchido corretamente no programa CD7003.
• Caso ocorra algum erro no envio de uma transação será gerada uma pendência no programa CD2900. Neste programa é possível ver o arquivo com as informações da mensagem XML enviada e também fazer o reprocessamento do envio.

Verificação do LOG de Integração 

      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.