Integrações / ERP / PSIpenta
Guia de integração do PSIpenta para programação da produção com o SkyPlanner APS
Este guia de integração do PSIpenta mostra aos parceiros PSI e às equipas de TI como ligar o PSIpenta/ERP ao SkyPlanner APS. O SkyPlanner integra-se com o PSIpenta nos dois sentidos, através das interfaces da própria PSI:
- São importadas as ordens de produção (Fertigungsaufträge) com as respetivas operações (Arbeitsgänge), gamas operatórias (Arbeitspläne), listas de materiais (Stücklisten), centros de trabalho, máquinas, ferramentas (Betriebsmittel), existências e encomendas de compra.
- O início, o fim e o centro de trabalho previstos para cada operação são enviados de volta para a ordem de produção.
- Se assim o pretender, os registos de tempos dos operadores podem ser enviados de volta como confirmações BDE (Rückmeldungen).
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
A equipa SkyPlanner configura a integração de acordo com a sua instalação do PSIpenta durante a implementação e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver as suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do PSIpenta
A PSI disponibiliza três vias para ligar um sistema externo de programação da produção (brochura da PSI):
- PSIpenta/ERP REST API. A PSI refere uma API REST e SOAP para o PSIpenta/ERP e afirma que todos os componentes do PSIpenta podem ser integrados em arquiteturas existentes através de serviços web RESTful. Esta é a principal via para ler dados de produção e escrever datas previstas.
- PSIpenta/BDE REST and SOAP API. O módulo de recolha de dados de fábrica tem a sua própria API. É por esta via que se registam as confirmações dos operadores.
- PSIintegration. É a camada de integração padrão da PSI para os módulos PSIpenta. Usa uma arquitetura em estrela, permite mapear mensagens graficamente nos adaptadores e arquiva todas as mensagens numa base de dados. Utilize-a se a sua instalação já encaminhar as comunicações com sistemas externos por esta camada.
O PSIpenta/ERP 10 acrescenta fluxos de trabalho BPMN 2.0, criados no Workflow Developer baseado na web, para integrar sistemas externos (PSI). Um fluxo de trabalho pode reagir a uma alteração no PSIpenta e fazer uma chamada ao SkyPlanner.
Autenticação e acesso
- No PSIpenta. A integração é executada com um utilizador técnico dedicado, cujas permissões se limitam aos objetos que lê e escreve. O seu parceiro PSI configura esse utilizador e o acesso à API na sua instalação.
- Rede. O PSIpenta funciona normalmente em infraestrutura local. A integração acede-lhe pela via autorizada pela sua equipa de TI, por exemplo, um endpoint de API publicado ou um pequeno conector dentro da sua rede.
- No SkyPlanner. A autenticação na REST API é feita com um token de API, criado em Settings > API e enviado no cabeçalho
Authorization-Token. A API está documentada em Swagger/OpenAPI, e o tutorial de integração explica as primeiras chamadas passo a passo.
Eventos e consultas periódicas
Do lado do PSIpenta, a integração consulta periodicamente a REST API para obter ordens de produção em aberto e alterações recentes. Em alternativa, um fluxo de trabalho BPMN ou uma mensagem PSIintegration envia a alteração para o SkyPlanner. A frequência é definida por fábrica: pode ir de intervalos de poucos minutos para as ordens a intervalos de uma hora para as existências.
O SkyPlanner envia webhooks quando o estado ou a programação se alteram, pelo que o envio de dados de volta é desencadeado por eventos.
Mapeamento de dados
| Objeto PSIpenta | Objeto SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Artigos (Artikel), unidades | Produtos e materiais | PSIpenta → SkyPlanner | Carga inicial, seguida de consultas periódicas |
| Listas de materiais (Stücklisten) multinível | Estrutura do produto, subprodutos, materiais por produto | PSIpenta → SkyPlanner | Carga inicial, depois a cada alteração |
| Gamas operatórias (Arbeitspläne) com operações e tempos de preparação e execução | Etapas do processo com durações e tempos de preparação e desmontagem | PSIpenta → SkyPlanner | Carga inicial, depois a cada alteração |
| Centros de trabalho (Arbeitsplätze) e máquinas | Centros de trabalho, grupos de centros de trabalho e eficiências | PSIpenta → SkyPlanner | Carga inicial, raramente depois |
| Ferramentas e dispositivos de fixação (Betriebsmittel) | Ferramentas como recursos partilhados de disponibilidade limitada | PSIpenta → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Calendários de turnos | Turnos e dias não úteis | PSIpenta → SkyPlanner | Diariamente, ou turnos geridos no SkyPlanner |
| Ordens de produção (Fertigungsaufträge) com operações e materiais | Ordens e tarefas com prazos de entrega e necessidades de materiais | PSIpenta → SkyPlanner | Consultas de poucos em poucos minutos |
| Existências em armazém | Saldos de existências | PSIpenta → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Encomendas de compra (Bestellungen) com datas de entrega | Encomendas de compra, materiais a receber por data de entrega | PSIpenta → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
| Início, fim e centro de trabalho previstos para cada operação da ordem de produção | Início e fim programados por tarefa | SkyPlanner → PSIpenta | A cada alteração da programação, por webhook do SkyPlanner |
| Confirmações BDE (Rückmeldungen): tempo e quantidade por operação, colaborador | Registos de tempos e confirmações dos operadores | SkyPlanner → PSIpenta | Por confirmação ou por turno, se essa opção for escolhida |
| Regras de programação do SkyPlanner | Matriz de tempos de preparação, número de operadores por tarefa, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Leia artigos, listas de materiais, gamas operatórias, centros de trabalho, máquinas, Betriebsmittel e calendários através da PSIpenta/ERP REST API. Defina criteriosamente o mapeamento dos centros de trabalho: um centro com quatro máquinas passa a ser um grupo de centros de trabalho ou quatro centros de trabalho.
2. Sincronização de ordens. Leia as ordens de produção lançadas, com as respetivas operações e materiais, bem como 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 é marcada como Delivered. As propostas de compra permanecem no PSIpenta até se tornarem encomendas.
3. Escrita da programação no PSIpenta. Quando o motor agenda ou desloca uma operação, um webhook do SkyPlanner desencadeia uma chamada à PSIpenta/ERP REST API. Esta atualiza o início previsto, o fim previsto e o centro de trabalho dessa operação na ordem de produção. As datas da ordem decorrem das suas operações. Os recursos e campos da sua instalação são definidos durante a definição do âmbito da implementação.
4. Confirmações de fábrica. Os operadores registam o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registos de tempos mantêm a programação atualizada. Cabe-lhe decidir se os tempos reais são enviados de volta. Em caso afirmativo, o tempo e a quantidade são registados por operação como confirmações BDE através da API PSIpenta/BDE. Se os terminais BDE continuarem em utilização, o SkyPlanner lê as confirmações do PSIpenta em vez de as enviar.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, listas de materiais, gamas operatórias, quantidades e estado das ordens | PSIpenta |
| Sequência das operações, horas de início e fim, atribuição de máquinas | SkyPlanner |
| Matriz de tempos de preparação, número de operadores e recursos alternativos | SkyPlanner |
| Dados mestre de Betriebsmittel | PSIpenta; disponibilidade ao longo do tempo planeada no SkyPlanner |
| Turnos e dias não úteis | Um sistema, escolhido na definição do âmbito |
| Confirmações, saídas e entradas de materiais | PSIpenta, com introdução direta ou envio a partir dos registos de tempos do SkyPlanner |
Escolha um único sistema para escrever as datas das operações. Se o Leitstand, o Adaptive Planung ou o MES Scheduling também definir datas previstas, desative essa função para as ordens programadas pelo SkyPlanner.
Etapas típicas do projeto
A implementação fica normalmente concluída em poucas semanas após o seu início. Antes disso, valide a programação durante o período de avaliação gratuita de 30 dias, com centros de trabalho, gamas operatórias e ordens de produção em aberto exportados do PSIpenta em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se as confirmações serão enviadas de volta.
- Acesso ao PSIpenta. Crie o utilizador técnico, ative as vias de acesso à API com o seu parceiro PSI e teste primeiro numa instalação de testes.
- Carga inicial. Artigos, listas de materiais, gamas operatórias, centros de trabalho, máquinas, Betriebsmittel e calendários.
- Sincronização de ordens e encomendas de compra. Consultas periódicas com filtros, paginação e novas tentativas, ou mensagens desencadeadas por fluxos de trabalho.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Escrita da programação no PSIpenta. Datas das operações a partir dos webhooks do SkyPlanner e, se assim for decidido, confirmações BDE.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o plano atual, compare datas e corrija os dados mestre.
- Entrada em produção. Ative a escrita no PSIpenta quando os dados coincidirem.
O que prever numa integração com o PSIpenta
- Módulos em utilização. Verifique quais os módulos de planeamento PSI licenciados e em produção. Cada módulo que escreva datas precisa de uma regra clara.
- Centro de trabalho ou máquina. Decida se o SkyPlanner programa ao nível do centro de trabalho ou da máquina e mantenha o mesmo nível nos dois sentidos.
- Betriebsmittel. Os dispositivos de fixação e as ferramentas da lista Betriebsmittel passam a ser ferramentas com disponibilidade limitada no SkyPlanner. Assim, cada operação também reserva a sua ferramenta.
- Unidades dos tempos de preparação e execução. Na importação, converta os tempos de preparação e execução com a unidade e a base de cálculo corretas. Caso contrário, todas as durações estarão erradas.
- Operações externas. As operações subcontratadas representam tempo decorrido, não capacidade interna. Modele-as como etapas apenas com duração.
- Operações iniciadas. Leia o progresso a partir das confirmações antes de cada execução da programação, para que esta tenha em conta o trabalho já realizado. O Running Time Lock fixa depois as tarefas das próximas horas.
Quem configura e presta apoio à integração com o PSIpenta
- A equipa SkyPlanner configura a integração durante a implementação e presta apoio após a entrada em produção, no âmbito das chamadas à API e das mensagens acordadas. Cada fábrica utiliza o PSIpenta de forma diferente, e é nesta configuração que se aplica esse conhecimento.
- O seu parceiro PSI pode participar. Conhece os seus módulos, campos personalizados e configuração do PSIintegration, e pode disponibilizar o acesso à API em conjunto com a equipa SkyPlanner.
- Os seus próprios programadores podem desenvolver soluções sobre a integração através da REST API do SkyPlanner, com um token de API. Um token de API é suficiente para começar, e a equipa SkyPlanner ajuda quando necessário. Consulte a documentação de integraçã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, de acordo com o seu processo e as suas necessidades. Consulte os preços, a programação da produção com o PSIpenta, respeitando a capacidade real das máquinas e do pessoal, a página do PSIpenta e a área de integrações ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em folhas de cálculo Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de comutação
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas 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 para três meses que abranja todos os centros de trabalho demora menos de 30 minutos.
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% durante todo o período de utilização do SkyPlanner, desde 2021.
Menosparagens por falta de materiais
“O valor do SkyPlanner para nós está em ser uma ferramenta que funciona no dia a dia, sobretudo para definir datas de entrega.”
Tommi Männistö, responsável pelo planeamento da produção
Eskomatic · Maquinação por subcontratação
A programação automática da carga de trabalho permite definir datas de entrega mais precisas, e as paragens de produção por falta de materiais diminuíram acentuadamente.
Perguntas frequentes
O PSIpenta tem uma API para ordens de produção?
Sim. A PSI refere uma API REST e SOAP para PSIpenta/ERP e PSIpenta/BDE e afirma que todos os componentes PSIpenta podem ser integrados através de serviços web RESTful. O PSIintegration acrescenta uma camada de integração entre módulos baseada em mensagens.
Como são gravadas no PSIpenta as datas planeadas?
Através da REST API do PSIpenta/ERP. A cada alteração na programação, um webhook do SkyPlanner desencadeia a atualização do início planeado, do fim planeado e do centro de trabalho de cada operação da ordem de produção.
O SkyPlanner pode enviar confirmações para o PSIpenta BDE?
Sim, se optar por essa configuração. Os registos de tempo dos operadores no SkyPlanner são enviados como confirmações BDE, com o tempo e a quantidade por operação, através da API do PSIpenta/BDE. Nas fábricas que mantêm os terminais BDE, o SkyPlanner lê as confirmações em vez de as enviar.
Um parceiro PSI deve propor o PSIpenta Leitstand ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende ter, em poucas semanas, uma programação da produção operacional que respeite a capacidade real das máquinas e das equipas. O Leitstand, o Adaptive Planung e o MES Scheduling são módulos separados do produto modular da PSI (PSI). O SkyPlanner liga-se através das APIs do PSIpenta/ERP e do BDE, reprograma automaticamente quando há alterações na produção e planeia mudanças de série, ferramentas, equipas e materiais. Inclui utilizadores ilimitados, a partir de 199 € por mês.
A integração requer o PSIpenta/MES?
Não. O SkyPlanner liga-se ao PSIpenta/ERP e, para as confirmações, ao PSIpenta/BDE. Os operadores podem registar o trabalho no SkyPlanner num telemóvel ou tablet.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O período de teste gratuito de 30 dias permite utilizar até 20 centros de trabalho, importar dados do PSIpenta em CSV ou Excel e aceder a todas as funcionalidades Basic, sem cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
