Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Integração Datasul x TOTVS MES 

Sumário 
Âncora
inicio
inicio

Integração Datasul x PPI-Multitask - TOTVS MES

Informações

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

Sumário

As transações e mensagens utilizadas no TOTVS MES estão descritas na página Mensagens Datasul x PPI-Multitask - TOTVS MES.   

Quadro de compatibilidade:  ÂncoracompatibilidadecompatibilidadeVersão DatasulVersão PC-FactoryConteú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
  • Mensagens da fase 2 (alocação de materiais, reporte de movimentações, estrutura de produto, etc);
  • Timeout com reprocessamento (incluindo o ‘reprocessa’);

    <BusinessEvent>

                <Entity>productionappointment</Entity>

                <Event>upsert</Event>

                <Identification>

                  <key name="IDPCFactory">9o93049u88557</key>

                  <key name="Reprocess">true</key>

                </Identification>

            </BusinessEvent>

  • Implementação do SFC.
12.1.174.0.1714.1002
  • Mensagens do Bloco K (Subproduto, Coproduto, etc);
  • Recusa;
  • Estorno de mensagens em bloco;
  • Inclusão de tags de refugo na mensagem ProductionAppointment (dentro da tag WasteAppointment)
  • Importação de porcentagem de perda na lista de materiais;
  • Importação de Tempo Homem e Tempo Máquina;
  • Importação de campo de Mão de Obra.
12.1.184.0.1740.100112.1.194.0.1750.100312.1.204.0.1750.1003

*Pacote de atualização: Update_TOTVS_MES_002-010617.zip

Contexto de negócio  ÂncoraContextodenegocioContextodenegocio

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.

4.0.1713.2002

Escopo  Âncoraescopoescopo

Image Removed

Pré-requisitos instalação/implantação/utilização - Datasul Âncoraprerrequisitosprerrequisitos

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

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.

Aviso
titleAtenção!
Situações em que deve ser validado o processo utilizado pelo cliente: Checklist de Aderência ao Ambiente do Cliente.

Retorna ao início

Instalação/Atualização Âncorainstalacaoinstalacao

1. Servidor de Aplicação TOTVS (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

Retorna ao início

2. Datasul Âncoraconfiguracaoconfiguracao

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. Caso desejar efetuar a autenticação do usuário no Web Service, utilizar o botão Segurança (Página 5);
  9. Confirmar a ativação por meio do botão OK.
Aviso
titleAviso:
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:

  • Teste realizado com sucesso.
  • Conexão com o Web Service 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.
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 CampoDescrição CampoEstabelecimentoALMLinha de produção1Linha de produção2PlanejadorJoãoPlanejadorJosé

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 CampoDescrição CampoPlanejador*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 CampoDescrição CampoPlanejador*Estabelecimento1Linha de produção*
  • Situação 4 - Se não existir filtro cadastrado, então nenhuma ordem de produção será enviada para a PPI-Multitask.

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: 

Image Removed

Item
Família
Grupo Estoque
CanetaEscritórioVendaCorpoEscritórioGeralTampaPlásticosPlásticosTuboPlásticosPlásticosCargaProduto/ProcessoGeralPontaCompradoGeralTintaCompradoGeral

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.
Nota
titleNota:
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.

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.

Quadro de compatibilidade: 

Versão DatasulVersão IntegTotvsConteúdo PC-Factory

ProductionQuantity12.1.14 + Pacote de Atualização*

12.1.15 + Pacote de Atualização*

12.1.16 + Pacote de Atualização*


  • Timeout com reprocessamento (incluindo o ‘reprocessa’);

    <BusinessEvent>

                <Entity>productionappointment</Entity>

                <Event>upsert</Event>

                <Identification>

                  <key name="IDPCFactory">9o93049u88557</key>

                  <key name="Reprocess">true</key>

                </Identification>

            </BusinessEvent>

  • Implementação do SFC.
12.1.17
  • Mensagens do Bloco K (Subproduto, Coproduto, etc);
  • Recusa;
  • Estorno de mensagens em bloco;
  • Inclusão de tags de refugo na mensagem ProductionAppointment (dentro da tag WasteAppointment)
  • Importação de porcentagem de perda na lista de materiais;
  • Importação de Tempo Homem e Tempo Máquina;
  • Importação de campo de Mão de Obra.
12.1.18
12.1.22
12.1.24
Tratamento de componentes negativos
12.1.254.0.1927.1000
12.1.294.0.2029.1001
  • Preenchimento das datas de início e término da Ordem quando a integração for apenas com o PCP no ERP.
  • Melhorias nos logs de execução no appserver do Datasul.
  • Permitir que o Reaproveitamento use também as referências de origem e destino (ProductionAppointment passou da versão 2_001 para 2_004).
  • Permitir finalização de Ordem e de Split (utilizada a productionappointment).
  • Reclassificação de Produto
12.1.314.0.2029.1001
  • Utilização da mensagem WhoIs para validação da integração. Ela é disparada a partir do diagnóstico (botão CP0106)

12.1.31

12.1.29.5 

12.1.28.11

12.1.27.15

4.0.2029.1001
  • Enviar somente operações internas (conforme parametrização CP0106B)
  • Permitir inicialização de Ordem (utilizada a productionappointment).
12.1.324.0.2029.1001Apontamento de Horas pra GGF e MOB, passa a tratar num mesmo <Destination> ambos movimentos. 

12.1.32  / 12.1.33 (limite para adoção do Tomcat)

 4.0.2045.1000

Parâmetro de Identificação do Servidor de Aplicação(JBOSS ou Tomcat):
<add key="ErpService" value="" />.
Mais detalhes no link de "Check-list Técnico do Ambiente de Integração Datasul x TOTVS MES".
 

12.1.324.0.2119.1001PCF_IntegTOTVS habilita funcionamento https Datasul.
12.1.324.0.2131.1001Correção na mensagem de reclassificação(TransferWarehouse): removida exigência da existência de apontamento positivo associado ao movimento de reclass.
12.1.324.0.2214.1000Implementação da funcionalidade de exportação para solicitação de serviços de manutenção (uso via REST).
12.1.2205
Inclusão do parâmetro Reporte no PCP no programa CP0106 (DT Apontamento via PCP)


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

  • ERP DATASUL 12 (TOTVS)
  • 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.


Escopo

Image Added


Âncora
prerrequisitos
prerrequisitos

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

1. Datasul

Pré-requisitos técnicos:

  • O servidor onde está hospedado o webservice do MES precisa ter uma versão compatível do JAVA instalada. Para releases 12.1.29 e inferiores, é necessário o JAVA 8 (1.8). A partir da versão 12.1.31, recomenda-se a utilização do JAVA 11.

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.


Âncora
configuracao
configuracao

1. 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. Configurar os parâmetros da integração por meio do botão Parâmetros.
  7. Confirmar a ativação por meio do botão OK.
Aviso
titleAviso:
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:

  • 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:

  • 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).
  • Envia Operação Externa (o padrão é enviar, quando não informado). Quando marcado como "Não", as operações externas e as reservas que as usam, não serão enviadas no XML. Este parâmetro, é validado também na Carga (CD7002).

  - Item: 

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

 - Lote Item:

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

 - Estrutura/Operação:

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

Pasta Ordem:

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:

Código do Campo

Descrição Campo

Planejador

João

Planejador

José

Estabelecimento

ALM

Linha de produção

1

Linha de produção

2

Situação 2:

Código do Campo

Descrição Campo

Planejador

*

Estabelecimento

*

Linha de produção

*

Situação 3:

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 no canto inferior direito do programa.

Nota
titleNota:
Quando a Ordem de Produção é criada automaticamente, a mensagem XML é gerada, porém fica na lista de pendência. Este procedimento é para evitar um alto tráfego de mensagens, uma vez que a criação via planejamento, gera muitas ordens.


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.

Nota
titleNota:
A geração da mensagem XML é disparada apenas na função Implantação Item - CD0204, seja na criação alteração ou eliminação de registros.


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: 

Image Added


Item
Família
Grupo Estoque
CanetaEscritórioVenda
CorpoEscritórioGeral
TampaPlásticosPlásticos
TuboPlásticosPlásticos
CargaProduto/ProcessoGeral
PontaCompradoGeral
TintaCompradoGeral

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.
Nota
titleNota:
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. Alertamos que a geração do log é por sessão, similar ao extrato de versão... Isto se deve por ser apenas uma checagem se o XML gerado no ERP está correto, quando não é possível validá-lo no PC-Factory.

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

ÂncoraTransacoesEntidadesTransacoesEntidades

Transações/Entidades/Mensagens únicas 

1.a Fase - Integração com Controle de Produção

As seguintes transações são usadas no TOTVS MES:

Image Removed

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

Cadastros

01

Item

Totvs

PPI-Multitask

Item_3_001.xsd

02

Depósito

Totvs

PPI-Multitask

Warehouse_1_000.xsd

03

Grupo de Máquina

Totvs

PPI-Multitask

WorkCenter_1_000.xsd

04

Ordem de Produção

Totvs

PPI-Multitask

ProductionOrder_2_005.xsd

Processos

05

Apontamento de Produção

PPI-Multitask

Totvs

ProductionAppointment_2_001.xsd

06Apontamento MOB/GGFPPI-MultitaskTotvsWorkforceAndOverheadAppointment_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

03Localização/EndereçoERP DatasulPPI-MultitaskAddressStock_1_000.xsd

04

Centro de Trabalho

ERP Datasul

PPI-Multitask

Machine_1_000.xsd

05

Motivo de Parada

PPI-Multitask

ERP Datasul

StopReason_1_000.xsd

06

Motivo de Refugo

PPI-Multitask

ERP Datasul

WasteReason_1_000.xsd

14Estrutura de Produto ERP DatasulPPI-MultitaskItemStructure_1_001.xsd15Roteiro de Operações ERP DatasulPPI-MultitaskItemScript_1_000.xsd16FerramentaERP DatasulPPI-MultitaskResource_1_000.xsd17Operador ERP DatasulPPI-MultitaskResource_1_000.xsd20Referência do ItemERP DatasulPPI-MultitaskItemReference_1_000.xsd

Saldos

01

Solicitação de Saldo Item

PPI-Multitask

ERP Datasul

StockLevel_2_000.xsd

18

Envio de Lote Item

ERP DatasulPPI-MultitaskItemStockLevel_1_000.xsdMovimentos
02

Transferência de Depósito

PPI-MultitaskERP Datasul

TransferWarehouse_1_003.xsd

08

Ordem de Produção/Alocação PCP

ERP DatasulPPI-MultitaskProductionOrder_2_005.xsd09

Ordem de Produção/Alocação SFC

ERP DatasulPPI-MultitaskProductionOrder_2_005.xsd11

Requisição Componente

PPI-MultitaskERP Datasul

MovementsInternal_1_001.xsd

Apontamentos
10

Reporte de Parada

PPI-MultitaskERP Datasul

StopReport_1_001.xsd

12Reporte de Produção via PCPPPI-MultitaskERP Datasul

ProductionAppointment_2_001.xsd

13Reporte de Produção via SFCPPI-MultitaskERP Datasul

ProductionAppointment_2_001.xsd

14Refugo Avulso (Recusa)PPI-MultitaskERP DatasulRefusal_1_000.xsd
Nota
titleNota:
As transações e mensagens utilizadas no TOTVS MES estão descritas na página Mensagens Datasul x PPI-Multitask - TOTVS MES.

Retorna ao início

Programas afetados pela Integração  ÂncoraProgramasafetadosProgramasafetados

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 EstoqueCE0105Estrutura ItemEN0105Onde se Usa ItemEN0109Centro de TrabalhoSF0104FerramentasCD0124OperadorSF0108Processo de Fabricação (Operações)EN0507Motivo de ParadaBOMF510 (SF0106)Motivo de RefugoSF0107

ÂncoraCD2900CD2900Gerenciamento 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.pendência.


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


Nota
titleNota:

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

habilitada quando o módulo de SFC não esteja implantado no Datasul).

Na seleção de Ordem de Produção, é também usado o parâmetro do CP0106B (Pasta Ordem) "Envia Operação Externa", quando marcado como "Não", as operações externas e as reservas que as usam, não serão enviadas no XML.

Âncora
cd7003
cd7003

Programa Manutenção De-Para TOTVS MES - CD7003
O 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 TOTVS MES está selecionadoPPI-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.
  • Executar o Diagnóstico
  • 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 

Âncora
log
log

      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. 

Nota
titleNota:
Um IDPCFactory pode ser apenas reprocessado em caso de erro em processamento anterior.
Retorna ao início