Integrações / ERP / Plex Smart Manufacturing Platform
Guia de integração do Plex para programação da produção com SkyPlanner APS
Este guia de integração do Plex mostra a parceiros e equipas de TI como ligar a Plex Smart Manufacturing Platform ao SkyPlanner APS. O SkyPlanner integra-se com o Plex nos dois sentidos:
- O SkyPlanner recebe tarefas, peças, gamas operatórias, centros de trabalho, existências e encomendas de compra.
- As horas de início e fim previstas para cada operação são enviadas de volta para o Plex.
- As confirmações dos operadores alimentam os registos de produção do Plex.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua configuração do Plex e assegura o suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver a integração por conta própria com base na REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Plex
O Plex é uma plataforma única na nuvem com arquitetura multi-inquilino, pelo que todos os inquilinos utilizam a versão atual. Existem quatro vias de integração:
- Plex Connect REST APIs. O Plex lançou o Plex Connect em 2015 como “a new REST/JSON API.” (uma nova API baseada em REST e JSON). (fonte) As coleções com controlo de versões abrangem peças, fornecedores, clientes, encomendas de compra, centros de trabalho e ferramentas.
- Plex Custom APIs. A ficha técnica do Plex refere: “The developer portal is also available for creating unique APIs.” (O portal de programadores também permite criar APIs específicas.) (fonte) Os parceiros utilizam esta opção para objetos sem uma coleção padrão.
- Plex UX Data Sources. O Plex disponibiliza as suas fontes de dados através de REST. É por esta via que habitualmente se leem as tarefas, as respetivas operações, os registos de produção e os contentores de existências.
- Plex Classic Data Sources. A via SOAP legada, utilizada apenas quando uma fonte de dados Classic não tem equivalente UX.
O SkyPlanner utiliza o Plex Connect para dados mestre e compras, e o Plex Data Sources para tarefas, operações e dados de produção.
Acesso e PCN
O acesso à API é configurado por aplicação no Plex Developer Portal, onde se ativam as coleções de API necessárias à integração. Cada chamada é dirigida a um PCN, o Plant Control Number que identifica uma fábrica ou entidade jurídica no Plex. Um grupo com três fábricas tem três PCNs. A integração associa cada PCN a uma configuração própria do SkyPlanner ou a grupos de centros de trabalho numa configuração comum.
As chamadas a Data Source utilizam credenciais de serviços Web por PCN. Crie uma conta dedicada à integração, com acesso apenas às fontes de dados necessárias.
No SkyPlanner, a REST API utiliza um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Modelo de sincronização
Do lado do Plex, a sincronização é periódica. O SkyPlanner lê tarefas, operações e existências novas ou alteradas através do Plex Connect e de Data Sources, com uma frequência definida por fábrica. Um parceiro Plex também pode enviar alterações do Plex diretamente para a REST API do SkyPlanner em resposta a eventos no Plex, por exemplo, quando é criada uma tarefa.
O SkyPlanner envia webhooks quando o estado ou o programa de produção mudam, pelo que o envio das atualizações para o Plex é acionado por eventos.
Mapeamento de dados
| Objeto Plex (interface) | Objeto SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Peça (coleção parts do Plex Connect) | Produtos e materiais | Plex → SkyPlanner | Carga inicial, seguida de sincronização incremental |
| Lista de materiais (Data Source) | Estrutura do produto, subprodutos e materiais por produto | Plex → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Gama operatória e operações da peça: centro de trabalho e tempos padrão (Data Source) | Etapas do processo com tempos de preparação e execução | Plex → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Centro de trabalho: máquina, célula ou área (Plex Connect work centers) | Centros de trabalho, grupos de centros de trabalho e eficiências | Plex → SkyPlanner | Carga inicial; raramente depois disso |
| Tarefa e respetivas operações: quantidade e data de entrega (Data Source) | Ordens e tarefas | Plex → SkyPlanner | A intervalos de poucos minutos ou por envio dos dados quando a tarefa é criada |
| Existências e contentores (Data Source) | Saldos de existências | Plex → SkyPlanner | A cada hora ou antes de cada execução da programação |
| Encomendas de compra com receções previstas (Plex Connect purchase orders) | Material a receber na data de entrega; atualização das existências quando assinalado como Delivered | Plex → SkyPlanner | A cada hora ou antes de cada execução da programação |
| Ferramentas (Plex Connect tools) | Ferramentas como recursos partilhados de capacidade limitada | Plex → SkyPlanner | Carga inicial; manutenção posterior no SkyPlanner |
| Início e fim previstos por operação e centro de trabalho (Custom API ou Data Source) | Programa de produção | SkyPlanner → Plex | A cada alteração do programa de produção, através de um webhook do SkyPlanner |
| Registos de produção: quantidades, início, fim e paragens | Registos de tempos e confirmações dos operadores | SkyPlanner → Plex | Por confirmação ou por turno |
| Dados de restrições do SkyPlanner | Matriz de tempos de preparação, número de operadores por tarefa, centros de trabalho e pessoal alternativos | Manutenção no SkyPlanner | Configuração durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Carregue peças, listas de materiais, gamas operatórias com as operações das peças, centros de trabalho e ferramentas. Defina criteriosamente o nível de detalhe dos centros de trabalho. Um centro de trabalho Plex pode ser uma máquina, uma célula ou uma área. O SkyPlanner deve programar ao nível em que existe uma única fila de trabalho.
2. Sincronização de tarefas. Leia as tarefas libertadas com as respetivas operações, quantidades e datas de entrega, bem como as existências e as encomendas de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza as existências quando esta é assinalada como Delivered. A programação verifica em conjunto as existências e as compras a receber.
3. Envio do programa de produção para o Plex. Para cada operação que o motor programou ou deslocou, o SkyPlanner envia para o Plex o início e o fim previstos e o centro de trabalho, através da Custom API ou da fonte de dados acordada. O Plex mantém a tarefa, a respetiva quantidade e o estado.
4. Confirmações na fábrica. Os operadores registam inícios, quantidades e paragens com Mobile Confirmations, Production Timer ou Quick Log Mode, e o programa de produção é atualizado à medida que o trabalho decorre. As confirmações são enviadas de volta para o Plex como registos de produção. Escolha um único canal por centro de trabalho: os operadores confirmam no SkyPlanner ou no Plex Control Panel, não em ambos.
5. Responsabilidade pelos dados e regras de resolução de conflitos. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Peças, listas de materiais, gamas operatórias, quantidade e estado das tarefas, existências | Plex |
| Sequência das operações, horas de início e fim, atribuição do centro de trabalho | SkyPlanner |
| Matriz de tempos de preparação, necessidades de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição do âmbito |
| Registos de produção | Plex, com registos criados a partir das confirmações do SkyPlanner |
Uma alteração da quantidade ou da gama operatória de uma tarefa no Plex dá origem a uma nova versão da tarefa. O SkyPlanner volta a lê-la e o Autopilot reprograma automaticamente quando há alterações na produção.
Etapas habituais do projeto
A implementação fica normalmente concluída poucas semanas após o início do acompanhamento inicial. Antes disso, pode utilizar os seus próprios dados no período de teste gratuito de 30 dias. Exporte do Plex as tarefas em aberto, as operações e os centros de trabalho para Excel ou CSV, importe-os e valide o programa de produção antes de iniciar qualquer trabalho de integração.
O projeto segue depois sete etapas:
- Mapeamento. Defina a tabela de mapeamento, os níveis de PCN e dos centros de trabalho, as regras de responsabilidade pelos dados e as frequências de sincronização.
- Acesso ao Plex. Ative as coleções do Plex Connect no Developer Portal e configure a conta de Data Source para cada PCN.
- Carga inicial. Peças, listas de materiais, gamas operatórias, centros de trabalho e ferramentas.
- Sincronização de tarefas e encomendas de compra. Tarefas, operações, existências e encomendas de compra em aberto, com sincronização periódica.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, número de operadores por tarefa, centros de trabalho e pessoal alternativos.
- Escrita de dados e confirmações no Plex. Envio dos tempos previstos e dos registos de produção para o Plex.
- Funcionamento em paralelo e entrada em produção. Utilize o SkyPlanner em paralelo com o plano atual, corrija os dados mestre e só depois ative o envio das atualizações para o Plex.
O que acautelar numa integração com o Plex
- Escolher a fonte de dados certa. O Plex tem muitas fontes de dados com campos em comum. A parte mais difícil de uma integração com o Plex é escolher a fonte que devolve a quantidade ou o estado pretendido. Na definição do âmbito, acordem o nome de cada fonte a utilizar.
- Nível de detalhe dos centros de trabalho. Um centro de trabalho que, na realidade, corresponde a uma área com quatro máquinas tem de ser representado por quatro centros de trabalho ou por um grupo com eficiências definidas. Caso contrário, a programação atribui-lhe trabalho acima da sua capacidade.
- Unidades de medida. Nas indústrias de processo, os lotes são produzidos em gramas ou litros, mas a etapa seguinte trabalha em peças. Faça a conversão por operação durante a importação.
- Contentores ou totais por peça. O Plex controla as existências em contentores no chão de fábrica. Some as quantidades dos contentores que a programação pode utilizar e exclua as existências bloqueadas ou em quarentena.
- Tempos padrão. Antes de gerar a primeira programação, compare os tempos de preparação e execução das operações de cada peça com os registos reais de produção.
- Vários PCNs. Mantenha as fábricas separadas no mapeamento, para que as tarefas de uma fábrica nunca sejam atribuídas aos centros de trabalho de outra.
Integração com o Plex: quem a configura e presta suporte
O trabalho abrange o mapeamento das suas tarefas, gamas operatórias, centros de trabalho e PCNs, bem como as restrições que o SkyPlanner considera na programação: matriz de tempos de preparação, número de operadores e recursos alternativos.
- A equipa SkyPlanner configura a integração durante a implementação inicial e presta suporte após a entrada em produção, tanto do lado do SkyPlanner como nas interfaces Plex acordadas. Cada fábrica utiliza o Plex de forma diferente, e é aqui que esse conhecimento se aplica.
- O seu parceiro Plex pode participar ou desenvolver a integração. O parceiro conhece o seu PCN, as fontes de dados e as Custom APIs. O SkyPlanner disponibiliza a REST API, a documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores também podem desenvolver a integração com a mesma REST API documentada, utilizando um token de API. Basta um token de API para começar, e a equipa SkyPlanner ajuda sempre que necessário. A documentação pública, que inclui as encomendas de compra e a API de produtos e materiais, está disponível na documentação do SkyPlanner.
O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. O orçamento da integração é apresentado antecipadamente, em conjunto com o seu plano e de acordo com os seus processos e necessidades, para que conheça o custo total antes de começar. Compare com a programação nativa do Plex em programação da produção no Plex com capacidade real de máquinas e pessoal, consulte a visão geral na página do Plex e conheça outros sistemas na área de integrações ERP.
O que dizem os fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de Excel para otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de manobra
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de trabalho chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável de TI
Laboratory & Allied · Produção farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado de três meses para todos os centros de trabalho demora menos de 30 minutos.
6 mesesde capacidade disponível visível para a equipa comercial
“O SkyPlanner dá uma base sólida e fiabilidade a todo o planeamento da produção.”
Anu Järvinen, responsável de produção
Fredman Operations · Papéis de embalagem próprios para contacto alimentar
A equipa comercial vê a capacidade disponível com seis meses de antecedência, e os pedidos de alteração à programação que demoravam uma hora ou mais têm agora resposta em segundos.
100%de fiabilidade das entregas desde 2021
“O SkyPlanner dá-nos visibilidade sobre a capacidade e torna o planeamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Produção química e alimentar
A fiabilidade das entregas tem sido de 100% desde que o SkyPlanner começou a ser utilizado, em 2021.
Perguntas frequentes
O Plex tem uma API para dados de programação da produção?
Sim. O Plex Connect disponibiliza APIs REST/JSON para peças, encomendas de compra, centros de trabalho e ferramentas. As Plex Data Sources disponibilizam tarefas, operações, registos de produção e existências. As Plex Custom APIs abrangem tudo o resto.
Quem desenvolve a integração com o Plex?
A equipa SkyPlanner configura a integração bidirecional de acordo com a sua configuração do Plex durante a implementação inicial e presta suporte após a entrada em produção. O seu parceiro Plex ou os seus próprios programadores também podem desenvolver a integração com a REST API documentada do SkyPlanner. Basta um token de API para começar.
Porquê ligar o SkyPlanner em vez de adicionar o Plex Finite Scheduling ou o Finite Scheduler?
O Plex inclui a programação da produção com capacidade real de máquinas e pessoal nas suas funcionalidades MES/MOM (fonte) e apresenta o Finite Scheduler como “An Adaptive Plex MES Integration” (uma integração adaptativa com o Plex MES) (fonte). O SkyPlanner liga-se ao pacote Plex que já utiliza e entra em produção em poucas semanas após o início da implementação. O Autopilot refaz automaticamente a programação sempre que ocorre uma alteração relevante. A equipa SkyPlanner configura a integração bidirecional e presta suporte, e o seu parceiro Plex pode assumir a responsabilidade pelo lado do Plex.
É necessário instalar alguma coisa no Plex?
Não. O acesso é configurado no Plex Developer Portal e por PCN. O SkyPlanner funciona na nuvem, em paralelo com o Plex.
O Plex pode enviar alterações em tempo real?
Do lado do Plex, a sincronização é executada a intervalos programados, normalmente de poucos em poucos minutos. Um parceiro Plex também pode enviar novas tarefas para a REST API do SkyPlanner em resposta a eventos no Plex. No sentido inverso, os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite utilizar até 20 centros de trabalho com importações CSV ou Excel a partir do Plex, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
