Integrações / ERP / proALPHA ERP
Guia de integração do proALPHA para programação da produção com SkyPlanner APS
Este guia de integração do Proalpha mostra aos parceiros e às equipas de TI como ligar o Proalpha ERP ao SkyPlanner APS. A integração entre o SkyPlanner e o Proalpha funciona nos dois sentidos:
- O SkyPlanner recebe artigos, ordens de fabrico com as respetivas operações, recursos, calendários, existências e encomendas de compra.
- O início e o fim planeados de cada operação são enviados de volta através de setWorkOrderOperationDates.
- As alterações de recursos são enviadas de volta através de changeWorkOrderOperationResource.
- As confirmações dos operadores são enviadas de volta através de operationDataEntry.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação, a equipa do SkyPlanner configura a integração de acordo com a sua instalação do Proalpha e presta apoio 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 a REST API documentada do SkyPlanner (referência da API).
As interfaces do Proalpha
O Proalpha ERP funciona sobre Progress OpenEdge e, com a Release 9, a plataforma passou para OpenEdge 12. (Proalpha) Há quatro interfaces relevantes para a programação.
- REST APIs do Proalpha ERP. O portal de APIs do Proalpha, de acesso público, apresenta 108 especificações OpenAPI 3.0 em
api/web/v1. Estas APIs permitem escrever dados de volta no Proalpha e ler artigos e existências. - Integration Workbench (INWB). Nas palavras do Proalpha, o INWB “is a central platform which connects different IT systems, machines, sites” (é uma plataforma central que liga diferentes sistemas informáticos, máquinas e instalações) e “converts the data into the format of the target system.” (converte os dados para o formato do sistema de destino). (Proalpha) Recebe mensagens pAX através de
POST /api/web/v1/inwb/message. Utilize-o para os fluxos de ordens de fabrico de e para o Proalpha. - Proalpha Integration Platform. Anunciada em abril de 2026 e baseada em n8n, esta plataforma “will be available to customers either on-premises or in the cloud.” (estará disponível para os clientes em instalação local ou na nuvem). O Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (recorrerá a uma arquitetura de referência centrada em APIs e a interfaces REST). (Proalpha)
- EDI e exportação de ficheiros. O INWB processa formatos de ficheiro específicos de cada setor, e a exportação de ficheiros é suficiente para o teste do SkyPlanner.
Endpoints de produção
| API do Proalpha | Endpoint | Utilização na integração |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Início e fim planeados de cada operação (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Recurso selecionado pela programação (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Confirmações: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artigos com partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Existências por área MRP |
Autenticação
As especificações publicadas do Proalpha utilizam autenticação HTTP Basic. Os endpoints são específicos de cada ambiente e seguem o formato {schema}://{host}:{port}/api/web/v1/..., no seu servidor Proalpha ou na Proalpha Cloud. Crie um utilizador técnico dedicado com permissões limitadas aos objetos da tabela de mapeamento. Planeie com a sua equipa de TI o acesso de rede da nuvem do SkyPlanner a esse endpoint.
Do lado do SkyPlanner, a REST API utiliza um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. Basta um token de API para começar. O tutorial de integração explica passo a passo as primeiras chamadas.
Eventos e consultas periódicas
O portal de APIs do Proalpha não apresenta nenhuma API para subscrição de webhooks. As alterações são enviadas a partir do Proalpha através de:
- um fluxo de mensagens INWB que envia ordens de fabrico novas e alteradas com as respetivas operações
- um fluxo de trabalho n8n na Proalpha Integration Platform
- consultas periódicas agendadas à Material API para obter as existências
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que a escrita de dados de volta no Proalpha é desencadeada por eventos.
Mapeamento de dados
| Objeto ou API do Proalpha | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Part (Part API) | Produtos e materiais | Proalpha → SkyPlanner | Carregamento inicial e, depois, a cada alteração |
| Modelo de processo do produto: process, activities; linhas da BOM da ordem de fabrico | Estrutura do produto, subprodutos e etapas do processo | Proalpha → SkyPlanner | Carregamento inicial e, depois, a cada alteração |
| Ordem de fabrico (Fertigungsauftrag) com quantidade e prazo | Ordem e tarefas com prazo e prioridade | Proalpha → SkyPlanner | Envio por INWB ou n8n, ou de poucos em poucos minutos |
| Operações da ordem de fabrico: targetSetupTime, targetProcessTime, resource | Etapas do processo com tempos de preparação e durações | Proalpha → SkyPlanner | Com a ordem de fabrico |
| Recursos, grupos de recursos e grupos de recursos alternativos | Centros de trabalho, grupos de centros de trabalho e centros de trabalho alternativos | Proalpha → SkyPlanner | Carregamento inicial |
| Blocos do calendário de recursos com intensity e overloadIntensity | Turnos e eficiências dos centros de trabalho | Proalpha → SkyPlanner | Carregamento inicial; atualização diária ou manutenção no SkyPlanner |
| Existências por área MRP | Existências de materiais | Proalpha → SkyPlanner | De hora a hora ou antes de cada execução da programação |
| Encomendas de compra com data de entrega | Material a receber na respetiva data de entrega | Proalpha → SkyPlanner | De hora a hora ou antes de cada execução da programação |
| setWorkOrderOperationDates | Início e fim programados de cada operação | SkyPlanner → Proalpha | Quando a programação muda, através de um webhook do SkyPlanner |
| changeWorkOrderOperationResource | Centro de trabalho selecionado pelo motor | SkyPlanner → Proalpha | Quando a programação muda |
| operationDataEntry (setup, process, combined) | Registos de tempo e quantidades de Mobile Confirmations | SkyPlanner → Proalpha | Por confirmação ou por turno |
| Regras de programação do SkyPlanner | Matriz de tempos de preparação e transição, ferramentas como recursos de capacidade finita e número de operadores | Mantidas no SkyPlanner | Configuração durante a implementação |
Modelos de integração
1. Carregamento inicial de dados mestre. Leia os artigos através da Part API e carregue os recursos, os grupos de recursos e os calendários uma única vez, através do INWB ou da exportação de um ficheiro. Defina criteriosamente a correspondência entre cada recurso do Proalpha e um centro de trabalho do SkyPlanner. Os grupos de recursos alternativos passam a centros de trabalho alternativos.
2. Sincronização de ordens. Um fluxo de mensagens INWB ou um fluxo de trabalho n8n envia as ordens de fabrico em aberto com as respetivas operações, tempos previstos e recursos. As existências são obtidas através da Material API por área MRP, e as encomendas de compra em aberto através do INWB. 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.
3. Gravação da programação no ERP. Para cada operação que o motor programou ou deslocou, a integração chama setWorkOrderOperationDates com o guid da operação e as datas e horas de início e fim. Se o motor tiver escolhido outro recurso, segue-se uma chamada a changeWorkOrderOperationResource.
4. Confirmações na fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. Os registos de tempo mantêm a programação atualizada e são enviados para o Proalpha através de operationDataEntry. Se a fábrica já regista confirmações em terminais PDC, mantenha um único canal para evitar registos duplicados.
5. Regras de responsabilidade e de resolução de conflitos. Documente-as antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos, modelos de processo, quantidades, estado das ordens de fabrico | Proalpha |
| Sequência das operações, datas e horas de início e fim, atribuição de recursos | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, número de operadores | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição do âmbito |
| Confirmações e movimentos de existências | Proalpha, alimentado pelos registos de tempo do SkyPlanner ou pelo PDC |
Se o Proalpha APS ou o Feinplanung estiver ativo, decida qual o sistema responsável pelas datas das operações. Se dois sistemas de programação gravarem as mesmas datas, irão sobrepor as alterações um do outro. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há alterações na produção.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, o período de avaliação gratuita de 30 dias permite trabalhar com os seus próprios dados. Exporte do Proalpha as ordens de fabrico em aberto, as operações e os recursos para CSV ou Excel, importe-os e valide a programação.
- Sessão de mapeamento. Defina com o seu parceiro Proalpha a tabela de mapeamento, as regras de responsabilidade, as frequências de sincronização e o canal de confirmação.
- Configuração das interfaces. Ative as REST APIs e os fluxos INWB, crie o utilizador técnico e abra os acessos de rede. Primeiro no sistema de testes, depois no de produção.
- Carregamento inicial. Artigos, recursos, grupos de recursos e calendários.
- Sincronização de ordens, existências e encomendas de compra. Envio das ordens de fabrico por INWB ou n8n e consulta periódica das existências, com novas tentativas em caso de falha.
- Configuração das restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores e centros de trabalho alternativos.
- Gravação da programação no ERP. setWorkOrderOperationDates e changeWorkOrderOperationResource; nesta etapa, acrescenta-se operationDataEntry.
- Funcionamento em paralelo. Compare as datas do SkyPlanner com o plano atual e corrija os dados mestre.
- Entrada em produção. Ative a gravação no ERP quando os dados coincidirem.
O que prever numa integração com o Proalpha
- Não existe um objeto de gama operatória. O Proalpha planeia com base em modelos de processo dos produtos. As ferramentas copiadas de projetos SAP ou Business Central procuram gamas operatórias e deixam dados por recolher. Na ordem de fabrico, leia as operações e as linhas da BOM.
- Intensidade do calendário. Os blocos do calendário incluem intensity e overloadIntensity. Mapeie estes valores para os turnos e as eficiências do SkyPlanner, em vez de copiar apenas as horas.
- Unidades de medida. Verifique quantityUnitCode e confirme se o tempo de preparação previsto é por ordem ou por peça. Unidades incorretas distorcem todas as durações.
- Endpoints alojados no cliente. A camada REST é executada no seu servidor Proalpha. As firewalls, as portas e os certificados condicionam a data de início do projeto, por isso trate destes acessos com antecedência.
- Versão instalada. Antes de finalizar o mapeamento, confirme com o seu parceiro quais as REST APIs que a sua versão do Proalpha disponibiliza.
- Documentação com autenticação obrigatória. A ajuda online do Proalpha está no Documentation Portal e exige autenticação. Confirme os nomes dos campos com o seu parceiro, em vez de os tentar adivinhar.
Integração com o Proalpha: quem a configura e presta assistência
- A equipa SkyPlanner configura a integração durante o acompanhamento inicial e presta assistência após a entrada em produção. Cada instalação Proalpha tem uma modelação diferente, e é aqui que esse conhecimento se aplica.
- O seu parceiro Proalpha pode participar. O parceiro conhece os seus modelos de processo, fluxos INWB e versão instalada, e pode configurar o acesso à API. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores podem desenvolver a integração com a mesma REST API e um token de API. A equipa SkyPlanner presta apoio quando necessário. A documentação do produto está disponível publicamente 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, de acordo com os seus processos e necessidades, juntamente com o seu plano, para que conheça o custo total antes de começar. Veja como o Proalpha planeia a capacidade em O proALPHA permite programar a produção respeitando a capacidade real das máquinas e dos operadores?, consulte a visão geral na página do proALPHA e conheça outros sistemas na área de integrações com 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 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 manobra
O planeamento da produção poupa 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 · Indústria farmacêutica
A eficiência na produção aumentou 90%, e a criação de um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
99,2%de fiabilidade das entregas
“O SkyPlanner deu-nos visibilidade para identificar estrangulamentos e tornou a gestão da produção mais clara.”
Toni Tuori, diretor de produção
Piristeel · Sistemas de segurança para coberturas e de drenagem de águas pluviais
A fiabilidade das entregas atingiu 99,2% este ano, e a programação poupa até quatro horas de trabalho por dia.
Menosparagens por falta de materiais
“O valor que o SkyPlanner nos traz é 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 em regime de subcontratação
A programação automática da carga permite definir datas de entrega mais precisas, e as paragens de produção por falta de materiais diminuíram acentuadamente.
Perguntas frequentes
Que interfaces do Proalpha utiliza a integração?
As REST APIs do Proalpha para artigos, existências e gravação de datas, recursos e confirmações no ERP. Os fluxos de mensagens INWB ou a Integration Platform baseada em n8n transportam as ordens de fabrico com as respetivas operações. A exportação de ficheiros permite realizar a avaliação e os carregamentos em massa.
Onde são gravadas as datas planeadas no Proalpha?
Na operação da ordem de fabrico, através de setWorkOrderOperationDates, com as datas e horas de início e fim. Se o motor tiver transferido a tarefa para outra máquina, changeWorkOrderOperationResource atualiza o recurso.
O Proalpha suporta webhooks?
O Proalpha API Portal não apresenta nenhuma API de subscrição de webhooks. As alterações chegam ao SkyPlanner através de fluxos de mensagens INWB, fluxos de trabalho n8n ou consultas periódicas. Os webhooks do próprio SkyPlanner permitem que a gravação no ERP seja desencadeada por eventos.
É possível enviar as confirmações dos operadores para o Proalpha?
Sim. Os registos de tempo de SkyPlanner Mobile Confirmations são enviados através de operationDataEntry, com a quantidade e os tempos do colaborador e do recurso. Se também utilizar terminais PDC, mantenha um único canal de confirmação.
Precisamos do Proalpha APS? E se já o utilizarmos?
Não é necessário. O próprio SkyPlanner cria a programação da produção a partir das suas ordens de fabrico, operações e recursos, respeitando a capacidade real das máquinas e dos operadores. O Autopilot mantém-na atualizada. Se o Proalpha APS estiver ativo, decida na definição do âmbito qual o sistema responsável pelas datas das operações. O SkyPlanner grava então apenas as datas que lhe competem, para que nenhum dos planos substitua as datas do outro.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. A avaliação gratuita de 30 dias permite utilizar até 20 centros de trabalho com uma exportação das suas ordens de fabrico em CSV ou Excel, sem necessidade de cartão de crédito. Inicie a avaliação ou fale com a equipa comercial para definir o âmbito da integração.
