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 a parceiros e equipes de TI como conectar o Proalpha ERP ao SkyPlanner APS. A integração entre SkyPlanner e Proalpha funciona nos dois sentidos:
- O SkyPlanner recebe peças, ordens de produção com suas operações, recursos, calendários, estoques e pedidos de compra.
- O início e o término planejados de cada operação são enviados de volta via setWorkOrderOperationDates.
- As alterações de recursos são enviadas de volta via changeWorkOrderOperationResource.
- Os apontamentos dos operadores são enviados de volta via operationDataEntry.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Durante a implantação, a equipe do SkyPlanner configura a integração de acordo com o seu ambiente Proalpha e oferece suporte após a entrada em produção. Este guia é para parceiros e desenvolvedores que querem participar desse processo ou desenvolver a integração por conta própria com a REST API documentada do SkyPlanner (referência da API).
Interfaces do Proalpha
O Proalpha ERP roda sobre Progress OpenEdge, e a Release 9 migrou a plataforma para OpenEdge 12. (Proalpha) Quatro interfaces são relevantes para a programação da produção.
- Proalpha ERP REST APIs. O portal público Proalpha API Portal lista 108 especificações OpenAPI 3.0 em
api/web/v1. Esse é o caminho para gravar dados de volta no Proalpha e para consultar peças e estoques. - Integration Workbench (INWB). Nas palavras da Proalpha, o INWB “is a central platform which connects different IT systems, machines, sites” (é uma plataforma central que conecta diferentes sistemas de TI, máquinas e unidades) e “converts the data into the format of the target system.” (converte os dados para o formato do sistema de destino). (Proalpha) Ele recebe mensagens pAX via
POST /api/web/v1/inwb/message. Use-o para enviar e receber ordens de produção no Proalpha. - Proalpha Integration Platform. Anunciada em abril de 2026 e baseada no n8n, a plataforma “will be available to customers either on-premises or in the cloud.” (estará disponível aos clientes tanto em ambiente local quanto na nuvem). A Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (adotará uma arquitetura de referência centrada em APIs e interfaces REST). (Proalpha)
- EDI e exportação de arquivos. O INWB trabalha com formatos de arquivo específicos de cada setor, e a exportação de arquivos atende às necessidades do teste do SkyPlanner.
Endpoints de produção
| API do Proalpha | Endpoint | Uso na integração |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Início e término planejados de cada operação (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Recurso selecionado na programação (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Apontamentos: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Peças com partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Estoque por área de MRP |
Autenticação
As especificações publicadas do Proalpha usam autenticação HTTP Basic. Os endpoints são específicos de cada ambiente, {schema}://{host}:{port}/api/web/v1/..., no seu servidor Proalpha ou no Proalpha Cloud. Crie um usuário técnico dedicado, com permissões restritas aos objetos da tabela de mapeamento. Planeje com sua equipe de TI o acesso de rede da nuvem do SkyPlanner a esse endpoint.
No SkyPlanner, a REST API usa um token de API para autenticação (Configurações do SkyPlanner > API) e tem documentação em Swagger/OpenAPI. Um token de API é suficiente para começar. O tutorial de integração orienta as primeiras chamadas.
Eventos e consultas periódicas
O Proalpha API Portal não lista nenhuma API para assinatura de webhooks. As alterações são enviadas a partir de:
- um fluxo de mensagens do INWB que envia ordens de produção novas e alteradas com suas operações
- um fluxo de trabalho do n8n na Proalpha Integration Platform
- consultas periódicas à Material API para obter o estoque
O SkyPlanner envia webhooks quando o estado ou a programação muda. Assim, a gravação de dados de volta no Proalpha é acionada por eventos.
Mapeamento de dados
| Objeto ou API do Proalpha | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
| Peça (Part API) | Produtos e materiais | Proalpha → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Modelo de processo do produto: processo, atividades; itens da BOM da ordem de produção | Estrutura do produto, subprodutos, etapas do processo | Proalpha → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Ordem de produção (Fertigungsauftrag) com quantidade e prazo de entrega | Ordem e operações com prazo de entrega e prioridade | Proalpha → SkyPlanner | Envio via INWB ou n8n, ou a cada poucos minutos |
| Operações da ordem de produção: targetSetupTime, targetProcessTime, resource | Etapas do processo com tempos de setup e durações | Proalpha → SkyPlanner | Junto com a ordem de produção |
| Recursos, grupos de recursos, grupos de recursos alternativos | Centros de trabalho, grupos de centros de trabalho, centros de trabalho alternativos | Proalpha → SkyPlanner | Carga inicial |
| Blocos do calendário de recursos com intensity e overloadIntensity | Turnos e eficiências dos centros de trabalho | Proalpha → SkyPlanner | Carga inicial; atualização diária ou manutenção no SkyPlanner |
| Estoque por área de MRP | Estoque de materiais | Proalpha → SkyPlanner | A cada hora ou antes de cada execução da programação |
| Pedidos de compra com data de entrega | Entrada de material na data de entrega | Proalpha → SkyPlanner | A cada hora ou antes de cada execução da programação |
| setWorkOrderOperationDates | Início e término programados de cada operação | SkyPlanner → Proalpha | A cada alteração na programação, via webhook do SkyPlanner |
| changeWorkOrderOperationResource | Centro de trabalho selecionado pelo motor de programação | SkyPlanner → Proalpha | A cada alteração na programação |
| operationDataEntry (setup, process, combined) | Registros de tempo e quantidades do Mobile Confirmations | SkyPlanner → Proalpha | A cada apontamento ou por turno |
| Regras de programação do SkyPlanner | Matriz de tempos de preparação e transição, ferramentas como recursos de capacidade finita, quantidade de operadores | Manutenção no SkyPlanner | Configuração durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Consulte as peças pela Part API e faça uma carga única de recursos, grupos de recursos e calendários via INWB ou exportação de arquivo. Mapeie com critério cada recurso do Proalpha para um centro de trabalho do SkyPlanner. Os grupos de recursos alternativos tornam-se centros de trabalho alternativos.
2. Sincronização de ordens. Um fluxo de mensagens INWB ou um fluxo de trabalho n8n envia as ordens de produção em aberto com suas operações, tempos previstos e recursos. Os dados de estoque vêm da Material API por área de MRP, e os pedidos de compra em aberto chegam pelo INWB. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido recebe o status Delivered.
3. Gravação da programação no ERP. Para cada operação que o motor programou ou moveu, a integração chama setWorkOrderOperationDates com o guid da operação, o início e o fim. Se o motor escolheu outro recurso, changeWorkOrderOperationResource é chamado em seguida.
4. Apontamentos de chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. Os registros de tempo mantêm a programação atualizada e são enviados ao Proalpha por operationDataEntry. Se a fábrica já faz apontamentos em terminais PDC, mantenha um único canal para evitar lançamentos duplicados.
5. Regras de responsabilidade e resolução de conflitos. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Peças, modelos de processo, quantidades e status das ordens de produção | Proalpha |
| Sequência das operações, horários de início e fim e alocação de recursos | SkyPlanner |
| Matriz de tempos de preparação e transição, ferramentas e número de operadores | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição de escopo |
| Apontamentos de produção e lançamentos de estoque | Proalpha, alimentado pelos registros de tempo do SkyPlanner ou pelo PDC |
Se Proalpha APS ou Feinplanung estiver ativo, defina qual sistema será responsável pelas datas das operações. Quando dois sistemas de programação gravam as mesmas datas, um sobrescreve o outro. Com Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.
Etapas típicas do projeto
A implantação normalmente é concluída em poucas semanas após o início do onboarding. Antes disso, você faz o teste gratuito de 30 dias com seus próprios dados. Exporte do Proalpha as ordens de produção em aberto, operações e recursos para CSV ou Excel, importe os dados e valide a programação.
- Workshop de mapeamento. Defina com seu parceiro Proalpha a tabela de mapeamento, as regras de responsabilidade, as frequências de sincronização e o canal de apontamento.
- Configuração das interfaces. Habilite as REST APIs e os fluxos INWB, crie o usuário técnico e libere o acesso à rede. Primeiro no ambiente de testes, depois no de produção.
- Carga inicial. Peças, recursos, grupos de recursos e calendários.
- Sincronização de ordens, estoque e pedidos de compra. Envio de ordens de produção por INWB ou n8n e consultas periódicas de estoque, com novas tentativas em caso de falha.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação e transição, ferramentas, número de operadores e centros de trabalho alternativos.
- Gravação da programação no ERP. setWorkOrderOperationDates e changeWorkOrderOperationResource; operationDataEntry é adicionado nesta etapa.
- Operação em paralelo. Compare as datas do SkyPlanner com o plano atual e corrija os dados mestres.
- Entrada em produção. Ative a gravação no ERP quando os dados coincidirem.
O que considerar ao planejar uma integração com Proalpha
- Não há objeto de roteiro de produção. O Proalpha planeja com base em modelos de processo do produto. Ferramentas copiadas de projetos SAP ou Business Central buscam roteiros de produção e deixam dados de fora. Na ordem de produção, leia as operações e as linhas da lista de materiais.
- Intensidade do calendário. Os blocos do calendário contêm intensity e overloadIntensity. Mapeie esses campos para os turnos e as eficiências do SkyPlanner, em vez de copiar as horas sem tratamento.
- Unidades de medida. Verifique quantityUnitCode e se o tempo de setup previsto é por ordem ou por peça. Unidades incorretas distorcem todas as durações.
- Endpoints hospedados pelo cliente. A camada REST roda no seu servidor Proalpha. Firewalls, portas e certificados determinam a data de início do projeto. Por isso, providencie as liberações com antecedência.
- Versão instalada. Antes de fechar o mapeamento, confirme com seu parceiro quais REST APIs estão disponíveis na sua versão do Proalpha.
- Documentação com acesso por login. A ajuda online do Proalpha fica no Documentation Portal e exige login. Confirme os nomes dos campos com seu parceiro em vez de tentar adivinhá-los.
Integração com Proalpha: quem configura e dá suporte
- A equipe SkyPlanner configura a integração durante o onboarding e dá suporte após a entrada em produção. Cada instalação do Proalpha tem uma modelagem diferente, e é nessa etapa que esse conhecimento é aplicado.
- Seu parceiro Proalpha pode participar. Ele conhece seus modelos de processo, fluxos INWB e versão instalada e pode configurar o acesso às APIs. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores podem ampliar a integração usando a mesma REST API com um token de API. A equipe SkyPlanner auxilia quando necessário. A documentação do produto é pública e está disponível na documentação do SkyPlanner.
O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. O orçamento da integração é apresentado antecipadamente, junto com o plano, de acordo com seus processos e necessidades. Assim, você conhece o custo total antes de começar. Veja como o Proalpha planeja a capacidade em O proALPHA oferece programação da produção que respeita a capacidade real de máquinas e equipes?, confira a visão geral na página do proALPHA e conheça outros sistemas na central de integrações com ERP.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, saímos das planilhas de Excel no planejamento da produção e passamos a otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Painéis elétricos e equipamentos de manobra
O planejamento da produção economiza 2 horas de trabalho por semana, e uma nova fila de operações chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável por TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
A eficiência na produção aumentou 90%, e a criação de um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
99,2%de pontualidade de entrega
“O SkyPlanner trouxe visibilidade para identificar gargalos e tornou a gestão da produção mais clara.”
Toni Tuori, gerente de produção
Piristeel · Sistemas de segurança para telhados e de águas pluviais
A pontualidade de entrega chegou a 99,2% neste ano, e a programação economiza até quatro horas de trabalho por dia.
Menosparadas por falta de material
“O valor que o SkyPlanner nos traz é ser uma ferramenta que funciona no dia a dia, especialmente para definir datas de entrega.”
Tommi Männistö, gerente de planejamento da produção
Eskomatic · Usinagem sob encomenda
A programação automática da carga de produção permite definir datas de entrega mais precisas, e as paradas de produção por falta de material caíram drasticamente.
Perguntas frequentes
Quais interfaces do Proalpha a integração utiliza?
As REST APIs do Proalpha são usadas para peças, estoque e gravação de datas, recursos e apontamentos no ERP. Fluxos de mensagens INWB ou a Integration Platform baseada em n8n transportam as ordens de produção com suas operações. As exportações de arquivos atendem ao teste e às cargas em massa.
Onde as datas planejadas são gravadas no Proalpha?
Na operação da ordem de produção, por meio de setWorkOrderOperationDates, com os instantes de início e fim. Se o motor moveu a operação para outra máquina, changeWorkOrderOperationResource atualiza o recurso.
O Proalpha oferece suporte a webhooks?
O Proalpha API Portal não lista nenhuma API de assinatura de webhooks. As alterações chegam ao SkyPlanner por 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 acionada por eventos.
Os apontamentos dos operadores podem ser enviados ao Proalpha?
Sim. Os registros de tempo do SkyPlanner Mobile Confirmations são enviados por operationDataEntry, com a quantidade e os tempos do funcionário e do recurso. Mantenha um único canal de apontamento se também houver terminais PDC em uso.
Precisamos do Proalpha APS? E se já o utilizamos?
Não é necessário. O próprio SkyPlanner cria a programação da produção a partir das suas ordens de produção, operações e recursos, respeitando a capacidade real de máquinas e equipes. O Autopilot mantém essa programação atualizada. Se o Proalpha APS estiver ativo, decida na definição de escopo qual sistema será responsável pelas datas das operações. O SkyPlanner então grava apenas as datas sob sua responsabilidade, para que os dois planos nunca sobrescrevam um ao outro.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho com uma exportação das suas ordens de produção em CSV ou Excel, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
