Integraciones / ERP / proALPHA ERP
Guía de integración de proALPHA para programar la producción con SkyPlanner APS
Esta guía de integración de Proalpha explica a partners y equipos de TI cómo conectar Proalpha ERP con SkyPlanner APS. La integración entre SkyPlanner y Proalpha es bidireccional:
- Se importan artículos, órdenes de fabricación con sus operaciones, recursos productivos, calendarios, existencias y pedidos de compra.
- El inicio y el fin previstos de cada operación se devuelven mediante setWorkOrderOperationDates.
- Los cambios de recurso productivo se devuelven mediante changeWorkOrderOperationResource.
- Las confirmaciones de los operarios se devuelven mediante operationDataEntry.
- Los webhooks de SkyPlanner envían los cambios en la programación en cuanto se producen.
Durante la puesta en marcha, el equipo de SkyPlanner adapta la integración a la configuración de Proalpha y ofrece soporte tras la entrada en producción. Esta guía está dirigida a partners y desarrolladores que quieran participar o desarrollar por su cuenta sobre la REST API documentada de SkyPlanner (referencia de la API).
Las interfaces de Proalpha
Proalpha ERP funciona sobre Progress OpenEdge. Con Release 9, la plataforma pasó a OpenEdge 12. (Proalpha) Hay cuatro interfaces relevantes para la programación.
- Proalpha ERP REST APIs. El portal público Proalpha API Portal recoge 108 especificaciones OpenAPI 3.0 bajo
api/web/v1. Esta es la vía para devolver datos y para leer artículos y existencias. - Integration Workbench (INWB). En palabras de Proalpha, INWB «is a central platform which connects different IT systems, machines, sites» (es una plataforma central que conecta distintos sistemas de TI, máquinas y centros) y «converts the data into the format of the target system.» (convierte los datos al formato del sistema de destino). (Proalpha) Recibe mensajes pAX mediante
POST /api/web/v1/inwb/message. Utilícelo para los flujos de órdenes de fabricación que entran y salen de Proalpha. - Proalpha Integration Platform. Anunciada en abril de 2026 y basada en n8n, «will be available to customers either on-premises or in the cloud.» (estará disponible para los clientes tanto en sus propias instalaciones como en la nube). Proalpha «will rely on an API-centric reference architecture and REST interfaces.» (se basará en una arquitectura de referencia centrada en API y en interfaces REST). (Proalpha)
- EDI y exportación de archivos. INWB gestiona formatos de archivo específicos de cada sector. Las exportaciones de archivos bastan para la prueba de SkyPlanner.
Endpoints de producción
| API de Proalpha | Endpoint | Uso en la integración |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Inicio y fin previstos de cada operación (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Recurso productivo seleccionado al programar (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Confirmaciones: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artículos con partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Existencias por área MRP |
Autenticación
Las especificaciones publicadas de Proalpha utilizan autenticación HTTP Basic. Los endpoints dependen del entorno, {schema}://{host}:{port}/api/web/v1/..., ya sea en su servidor Proalpha o en Proalpha Cloud. Cree un usuario técnico específico con permisos limitados a los objetos de la tabla de correspondencias. Planifique con su equipo de TI el acceso de red desde la nube de SkyPlanner hasta ese endpoint.
Por parte de SkyPlanner, la REST API se autentica mediante un token de API (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. Basta con un token de API para empezar. El tutorial de integración explica paso a paso las primeras llamadas.
Eventos y consultas periódicas
Proalpha API Portal no incluye ninguna API de suscripción a webhooks. Los cambios se envían desde Proalpha mediante:
- un flujo de mensajes de INWB que envía las órdenes de fabricación nuevas y modificadas con sus operaciones
- un flujo de trabajo de n8n en Proalpha Integration Platform
- consultas periódicas programadas a Material API para obtener las existencias
SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la devolución de datos a Proalpha se activa por eventos.
Correspondencias de datos
| Objeto o API de Proalpha | Objeto de SkyPlanner | Dirección | Frecuencia |
|---|---|---|---|
| Part (Part API) | Productos y materiales | Proalpha → SkyPlanner | Carga inicial y, después, con cada cambio |
| Modelo de proceso del producto: process, activities; líneas de la BOM de la orden de fabricación | Estructura del producto, subproductos y etapas del proceso | Proalpha → SkyPlanner | Carga inicial y, después, con cada cambio |
| Orden de fabricación (Fertigungsauftrag) con cantidad y fecha límite | Orden y tareas con fecha límite y prioridad | Proalpha → SkyPlanner | Envío mediante INWB o n8n, o cada pocos minutos |
| Operaciones de la orden de fabricación: targetSetupTime, targetProcessTime, resource | Etapas del proceso con tiempos de preparación y duraciones | Proalpha → SkyPlanner | Junto con la orden de fabricación |
| Recursos productivos, grupos de recursos productivos y grupos alternativos | Estaciones de trabajo, grupos de estaciones de trabajo y estaciones alternativas | Proalpha → SkyPlanner | Carga inicial |
| Bloques del calendario de recursos productivos con intensity y overloadIntensity | Turnos y eficiencias de las estaciones de trabajo | Proalpha → SkyPlanner | Carga inicial; actualización diaria o mantenimiento en SkyPlanner |
| Existencias por área MRP | Existencias de materiales | Proalpha → SkyPlanner | Cada hora o antes de cada ejecución de la programación |
| Pedidos de compra con fecha de entrega | Material entrante en su fecha de entrega | Proalpha → SkyPlanner | Cada hora o antes de cada ejecución de la programación |
| setWorkOrderOperationDates | Inicio y fin programados de cada operación | SkyPlanner → Proalpha | Con cada cambio en la programación, mediante un webhook de SkyPlanner |
| changeWorkOrderOperationResource | Estación de trabajo seleccionada por el motor | SkyPlanner → Proalpha | Con cada cambio en la programación |
| operationDataEntry (setup, process, combined) | Registros de tiempo y cantidades de Mobile Confirmations | SkyPlanner → Proalpha | Por confirmación o por turno |
| Reglas de programación de SkyPlanner | Matriz de tiempos de preparación y transición, herramientas como recursos productivos de capacidad limitada y número de operarios | Se mantienen en SkyPlanner | Se configuran durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lea los artículos mediante Part API y cargue una sola vez los recursos productivos, sus grupos y los calendarios mediante INWB o una exportación de archivos. Defina cuidadosamente la correspondencia entre cada recurso productivo de Proalpha y una estación de trabajo de SkyPlanner. Los grupos de recursos productivos alternativos se convierten en estaciones de trabajo alternativas.
2. Sincronización de órdenes. Un flujo de mensajes de INWB o un flujo de trabajo de n8n envía las órdenes de fabricación abiertas con sus operaciones, tiempos objetivo y recursos productivos. Las existencias se obtienen de Material API por área MRP, y los pedidos de compra abiertos, a través de INWB. SkyPlanner considera que el material pedido estará disponible en la fecha de entrega del pedido de compra y actualiza las existencias cuando este se marca como Delivered.
3. Escritura de la programación en Proalpha. Por cada operación que el motor haya programado o desplazado, la integración llama a setWorkOrderOperationDates con el guid de la operación y sus fechas y horas de inicio y fin. Si el motor ha elegido otro recurso productivo, a continuación se ejecuta changeWorkOrderOperationResource.
4. Confirmaciones en planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations o Production Timer. Los registros de tiempo mantienen la programación al día y se envían a Proalpha mediante operationDataEntry. Si su planta ya realiza las confirmaciones en terminales PDC, mantenga un único canal para evitar registros duplicados.
5. Reglas de responsabilidad y resolución de conflictos. Déjelas por escrito antes de la puesta en marcha:
| Datos | Sistema responsable |
|---|---|
| Artículos, modelos de proceso, cantidades y estado de las órdenes de fabricación | Proalpha |
| Secuencia de operaciones, fechas y horas de inicio y fin, asignación de recursos productivos | SkyPlanner |
| Matriz de tiempos de preparación, herramientas y número de operarios | SkyPlanner |
| Turnos y ausencias | Un único sistema, elegido durante la definición del alcance |
| Confirmaciones y registros de movimientos de existencias | Proalpha, con datos de los registros de tiempo de SkyPlanner o de PDC |
Si Proalpha APS o Feinplanung está activo, decida qué sistema será responsable de las fechas de las operaciones. Si dos planificadores escriben las mismas fechas, sobrescribirán los cambios del otro. Con Autopilot, SkyPlanner reprograma automáticamente cuando cambia la producción.
Fases habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la incorporación. Antes, puede utilizar sus propios datos durante la prueba gratuita de 30 días. Exporte desde Proalpha las órdenes de fabricación abiertas, las operaciones y los recursos productivos a CSV o Excel, impórtelos y valide la programación.
- Sesión de mapeo. Acuerde con su partner de Proalpha la tabla de correspondencias, las reglas de responsabilidad, las frecuencias de sincronización y el canal de confirmación.
- Configuración de interfaces. Habilite las REST API y los flujos de INWB, cree el usuario técnico y permita el acceso de red. Primero en el sistema de pruebas y después en producción.
- Carga inicial. Artículos, recursos productivos, grupos de recursos productivos y calendarios.
- Sincronización de órdenes, existencias y pedidos de compra. Envío de órdenes de fabricación mediante INWB o n8n y consultas periódicas de existencias, con reintentos.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación, herramientas, número de operarios y estaciones de trabajo alternativas.
- Escritura de la programación en Proalpha. setWorkOrderOperationDates y changeWorkOrderOperationResource; en esta fase se añade operationDataEntry.
- Funcionamiento en paralelo. Compare las fechas de SkyPlanner con el plan actual y corrija los datos maestros.
- Puesta en marcha. Active la escritura en Proalpha cuando los datos coincidan.
Qué prever al integrar Proalpha
- No existe un objeto de ruta de fabricación. Proalpha planifica a partir de modelos de proceso de producto. Las herramientas copiadas de proyectos de SAP o Business Central buscan rutas de fabricación y dejan datos sin recoger. Lea las operaciones y las líneas de la BOM en la orden de fabricación.
- Intensidad del calendario. Los bloques del calendario contienen intensity y overloadIntensity. Establezca su correspondencia con los turnos y las eficiencias de SkyPlanner en lugar de copiar las horas sin más.
- Unidades de medida. Compruebe quantityUnitCode y si el tiempo de preparación objetivo se indica por orden o por pieza. Unas unidades incorrectas distorsionan todas las duraciones.
- Endpoints alojados en el cliente. La capa REST se ejecuta en su servidor de Proalpha. Los cortafuegos, los puertos y los certificados condicionan la fecha de inicio del proyecto, por lo que conviene prepararlos con antelación.
- Versión instalada. Confirme con su partner qué REST API ofrece su versión de Proalpha antes de cerrar el mapeo.
- Documentación con acceso restringido. La ayuda en línea de Proalpha requiere acceso a Documentation Portal. Confirme los nombres de los campos con su partner en lugar de adivinarlos.
Integración con Proalpha: quién la configura y ofrece soporte
- El equipo de SkyPlanner la configura durante la incorporación y ofrece soporte tras la puesta en marcha. Cada instalación de Proalpha tiene un modelo distinto, y es aquí donde se aplica ese conocimiento.
- Su partner de Proalpha puede participar. Conoce sus modelos de proceso, los flujos de INWB y la versión instalada, y puede configurar el acceso a la API. SkyPlanner proporciona la REST API, la documentación Swagger/OpenAPI y los webhooks.
- Sus propios desarrolladores pueden ampliar la integración utilizando la misma REST API con un token de API. El equipo de SkyPlanner les ayuda cuando lo necesitan. La documentación del producto es pública y está disponible en la documentación de SkyPlanner.
SkyPlanner está disponible desde 199 € al mes con 5 estaciones de trabajo incluidas y facturación mensual. La integración se presupuesta de antemano según sus procesos y necesidades, junto con su plan, para que conozca el coste total antes de empezar. Consulte cómo planifica Proalpha la capacidad en ¿Permite proALPHA programar la producción respetando la capacidad real de máquinas y personal?, obtenga una visión general en la página de proALPHA y descubra otros sistemas en el centro de integraciones ERP.
Opiniones de fabricantes sobre SkyPlanner
2 hahorradas cada semana
“Con SkyPlanner hemos pasado de planificar la producción en hojas de Excel a optimizarla en tiempo real.”
Kalle Kalliomäki, especialista en cadena de suministro
UTU · Cuadros eléctricos y aparamenta
La planificación de la producción ahorra 2 horas de trabajo cada semana, y una nueva cola de trabajo llega a la línea en segundos.
+90%de eficiencia en producción
“La eficiencia en producción ha aumentado un 90%.”
Abdul Rucyinga, director de TI
Laboratory & Allied · Fabricación farmacéutica
La eficiencia en producción ha aumentado un 90%, y elaborar un plan optimizado de tres meses para todas las estaciones de trabajo lleva menos de 30 minutos.
99,2%de cumplimiento de plazos de entrega
“SkyPlanner nos ha dado visibilidad para identificar los cuellos de botella y ha aportado claridad a la gestión de la producción.”
Toni Tuori, responsable de producción
Piristeel · Sistemas de seguridad para cubiertas y evacuación de aguas pluviales
El cumplimiento de plazos de entrega alcanzó el 99,2% este año, y la programación ahorra hasta cuatro horas de trabajo al día.
Menosparadas por falta de material
“El valor que nos aporta SkyPlanner es que funciona en el día a día, especialmente para fijar las fechas de entrega.”
Tommi Männistö, responsable de planificación de la producción
Eskomatic · Mecanizado por encargo
La programación automática de la carga permite fijar fechas de entrega más precisas, y las paradas de producción por falta de material se han reducido considerablemente.
Preguntas frecuentes
¿Qué interfaces de Proalpha utiliza la integración?
Las REST API de Proalpha para artículos, existencias y la escritura de fechas, recursos productivos y confirmaciones de vuelta en Proalpha. Los flujos de mensajes de INWB o Integration Platform, basada en n8n, transfieren las órdenes de fabricación con sus operaciones. Las exportaciones de archivos se utilizan para la prueba y las cargas masivas.
¿Dónde se guardan las fechas planificadas en Proalpha?
En la operación de la orden de fabricación, mediante setWorkOrderOperationDates, con las fechas y horas de inicio y fin. Si el motor ha trasladado la tarea a otra máquina, changeWorkOrderOperationResource actualiza el recurso productivo.
¿Admite Proalpha webhooks?
Proalpha API Portal no incluye ninguna API de suscripción a webhooks. Los cambios llegan a SkyPlanner mediante flujos de mensajes de INWB, flujos de trabajo de n8n o consultas periódicas. Los webhooks propios de SkyPlanner permiten que la escritura en Proalpha se active por eventos.
¿Se pueden enviar a Proalpha las confirmaciones de los operarios?
Sí. Los registros de tiempo de SkyPlanner Mobile Confirmations se envían mediante operationDataEntry, con la cantidad y los tiempos del empleado y del recurso productivo. Mantenga un único canal de confirmación si también se utilizan terminales PDC.
¿Necesitamos Proalpha APS? ¿Y si ya lo utilizamos?
No lo necesitan. SkyPlanner programa la producción por sí mismo a partir de sus órdenes de fabricación, operaciones y recursos productivos, respetando la capacidad real de máquinas y personal, y Autopilot mantiene esa programación al día. Si Proalpha APS está activo, decida durante la definición del alcance qué sistema será responsable de las fechas de las operaciones. SkyPlanner escribirá entonces solo las fechas que le correspondan, de modo que ninguno de los dos planes sobrescriba nunca los datos del otro.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días admite hasta 20 estaciones de trabajo con una exportación de sus órdenes de fabricación en CSV o Excel, sin necesidad de tarjeta de crédito. Inicie la prueba o hable con ventas para definir el alcance de la integración.
