Integraciones / ERP / Monitor ERP
Guía de integración de Monitor ERP para la programación de la producción con SkyPlanner APS
Esta guía de integración de Monitor ERP explica a partners y equipos de TI cómo conectar Monitor ERP (Monitor G5) con SkyPlanner APS. SkyPlanner se integra con Monitor ERP en ambos sentidos a través de la API de Monitor ERP:
- Se importan las órdenes de fabricación, las operaciones, los centros de trabajo, las rutas de fabricación y los materiales.
- Se escriben en Monitor el inicio previsto, el fin previsto y el centro de trabajo de cada operación.
- Los tiempos y las cantidades registrados mantienen ambos sistemas sincronizados.
- Los webhooks de SkyPlanner envían los cambios de la programación en cuanto se producen.
Durante la puesta en marcha, el equipo de SkyPlanner configura la integración según tu instalación de Monitor G5 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 soluciones basadas en la REST API documentada de SkyPlanner (referencia de la API).
La API de Monitor ERP
La interfaz de integración documentada de Monitor G5 es Monitor ERP API v1. Combina CQRS y REST y utiliza JSON sobre HTTPS. (Monitor ERP API)
- Las consultas leen datos mediante GET. Admiten opciones de tipo OData:
$filter,$select,$expand,$orderby,$topy$skip. - Los comandos escriben datos mediante POST, por ejemplo,
Manufacturing/ManufacturingOrderOperations/Update. - Batch ejecuta varios comandos en una única transacción de todo o nada mediante
POST /api/v1/Batch. Añade/Simulateo/Validatepara probar un lote y revertirlo. Es la forma segura de escribir un programa de producción completo. (Batch)
La URL base es https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. El número de empresa combina el número de la base de datos y el identificador de empresa, por ejemplo, 004.1.
Sobre las licencias, Monitor indica: «It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.» (Todos nuestros clientes pueden consultar y extraer información de la API de forma gratuita. Sin embargo, para utilizar comandos y escribir datos en el sistema ERP, es necesario adquirir Monitor ERP API). Incluye la licencia de escritura en el proyecto desde el primer día. (api.monitor.se)
Autenticación
- Inicio de sesión. Una petición a
POST /{languageCode}/{companyNumber}/logincon el nombre de usuario y la contraseña de un usuario de Monitor devuelve una cabeceraX-Monitor-SessionIdpara las llamadas posteriores. También hay disponible un flujo con token MFA. - OIDC. A partir de Monitor 25.8, también se puede iniciar sesión a través de Microsoft Entra ID con Authorization Code y PKCE. (Autenticación)
- Usuario exclusivo para la API. Crea un usuario para la integración. Se le aplican los permisos propios de Monitor, como Show manufacturing orders y Replan existing manufacturing order.
En SkyPlanner, la REST API utiliza un token de API para la autenticación (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. El tutorial de integración explica paso a paso las primeras llamadas.
Detección de cambios y sondeo
La referencia de la API de Monitor ERP no documenta webhooks ni suscripciones a eventos. Los cambios se detectan mediante sondeo:
Common/EntityChangeLogs(a partir de 2.33) devuelveChangeType(Update, Create, Delete),EntityTypeId,EntityIdyModifiedTimestamp. Consúltalo cada pocos minutos y recupera solo los registros modificados. (EntityChangeLog)- Filtra las consultas de órdenes de fabricación para obtener solo las órdenes abiertas y pagina los resultados con
$topy$skip.
SkyPlanner envía webhooks cuando cambia el estado o el programa de producción, por lo que la escritura de datos de vuelta a Monitor se basa en eventos.
Mapeo de datos
| Objeto de Monitor ERP (API) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
Part (Inventory/Parts) | Productos y materiales | Monitor → SkyPlanner | Carga inicial; después, mediante el registro de cambios |
BOM y ruta de fabricación: Manufacturing/MaterialRows, Manufacturing/OperationRows | Estructura del producto; etapas del proceso con tiempos de preparación y por unidad | Monitor → SkyPlanner | Carga inicial; después, con cada cambio |
Manufacturing/AlternativeOperationRows | Estaciones de trabajo alternativas para cada etapa | Monitor → SkyPlanner | Carga inicial; después, con cada cambio |
Centro de trabajo (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Estaciones de trabajo, grupos de estaciones de trabajo y eficiencias | Monitor → SkyPlanner | Carga inicial; después, rara vez |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Turnos y ausencias | Monitor → SkyPlanner | A diario, o con turnos propios en SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Órdenes con fechas de entrega y estado | Monitor → SkyPlanner | Sondeo del registro de cambios cada pocos minutos |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Trabajos con duraciones y cantidad pendiente | Monitor → SkyPlanner | Sondeo del registro de cambios cada pocos minutos |
Manufacturing/ManufacturingOrderMaterials | Necesidades de material por orden | Monitor → SkyPlanner | Sondeo del registro de cambios |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Existencias; material entrante en su fecha de entrega | Monitor → SkyPlanner | Sondeo cada hora o al ejecutar la programación |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Inicio y fin previstos por operación | SkyPlanner → Monitor | Cuando cambia el programa de producción, mediante un webhook de SkyPlanner |
ManufacturingOrderOperations/SetWorkCenter | Estación de trabajo elegida por el motor | SkyPlanner → Monitor | Cuando cambia el programa de producción |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Registros de tiempo y cantidades | Un canal, elegido durante la definición del alcance | Con cada confirmación o por turno |
| No disponible en Monitor | Matriz de tiempos de preparación, herramientas como recursos limitados y trabajos con varios operarios | Se mantiene en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lee los centros de trabajo, las líneas de operaciones, las líneas de operaciones alternativas, las líneas de materiales, los artículos y los horarios. Define con cuidado la correspondencia entre cada centro de trabajo y una estación de trabajo de SkyPlanner. Un centro de trabajo de tipo Pool se convierte en un grupo de estaciones de trabajo, y los centros que lo componen se convierten en las estaciones entre las que elige el motor.
2. Sincronización de órdenes. Lee las órdenes de fabricación abiertas con sus nodos, operaciones y materiales, así como las existencias y los pedidos de compra abiertos. SkyPlanner considera que el material pedido está disponible en la fecha de entrega del pedido de compra y actualiza las existencias cuando este se marca como Delivered. Tras la primera carga, las actualizaciones incrementales se basan en Common/EntityChangeLogs.
3. Escritura del programa de producción en Monitor. Por cada operación que el motor haya programado o desplazado, SkyPlanner envía ManufacturingOrderOperations/Update con PlannedStartDate y PlannedFinishDate. Si el motor ha trasladado una operación a otra máquina de un grupo, primero se ejecuta SetWorkCenter. Los comandos de una misma orden se agrupan en un único Batch, de modo que Monitor los acepta todos o ninguno. Durante las pruebas, ejecuta el lote mediante /Validate.
En las versiones de Monitor anteriores a 24.5, no se pueden escribir las fechas previstas mediante Update. Utiliza en su lugar ManufacturingOrders/ReplanOperation (a partir de 2.40) con StartDate y FinishDate, y configura RestrictToOrderBounds según tus reglas.
4. Confirmaciones en planta. Mantén un único canal de registro:
- Monitor sigue siendo el canal. Los operarios registran el trabajo en Recording terminal o mediante la integración con las máquinas, como hasta ahora. SkyPlanner lee
ManufacturingOrderOperationReportingspara conocer el avance y reprogramar la producción. - SkyPlanner pasa a ser el canal. Los operarios registran el trabajo con Mobile Confirmations o Production Timer, y SkyPlanner envía
ReportManufacturingOrderOperationa Monitor.
Registrar el trabajo en ambos sistemas duplica los tiempos y las cantidades.
5. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjalas por escrito antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Artículos, BOM y ruta de fabricación, cantidades y estado de la orden | Monitor |
| Secuencia de operaciones, inicio y fin previstos, centro de trabajo dentro de un grupo | SkyPlanner |
| Matriz de tiempos de preparación, herramientas, número de operarios, recursos alternativos | SkyPlanner |
| Turnos y ausencias | Un sistema, elegido durante la definición del alcance |
| Notificación de operaciones | Un canal, elegido durante la definición del alcance |
La principal fuente de conflictos es que los planificadores sigan modificando el plan de prioridades. Rescheduling according to New finish y el arrastre de filas en Priority planning sobrescriben las fechas que ha registrado SkyPlanner. Cuando SkyPlanner pasa a controlar la secuencia, Priority planning se utiliza solo como vista de consulta. Con Autopilot, SkyPlanner reprograma automáticamente cuando cambia la producción.
Pasos habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, la prueba gratuita de 30 días permite trabajar con tus propios datos. Exporta de Monitor a Excel las operaciones de las órdenes de fabricación abiertas y los centros de trabajo, impórtalos y valida la programación antes de iniciar cualquier trabajo de integración.
El proyecto incluye los siguientes pasos:
- Definición del alcance. Establece la tabla de correspondencias, las reglas sobre qué sistema controla cada dato, los intervalos de consulta, el canal de notificación y la versión de Monitor.
- Acceso. Crea el usuario de la API, adquiere la licencia de escritura de Monitor ERP API y habilita el acceso de red al puerto 8001.
- Carga inicial. Artículos, centros de trabajo, líneas de operaciones, alternativas, materiales y calendarios de producción.
- Sincronización de órdenes y pedidos de compra a partir del registro de cambios.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación, herramientas, número de operarios y máquinas o personal alternativos.
- Escritura de la programación en Monitor por lotes, comprobada con
/Validate. - Pruebas en paralelo. Ejecuta SkyPlanner en paralelo con el plan de prioridades, compara las fechas y corrige los datos maestros.
- Entrada en producción. Activa la escritura en Monitor cuando los datos coincidan.
Qué tener en cuenta al integrar Monitor ERP
- Factor de disponibilidad. Monitor calcula la capacidad neta a partir de la bruta mediante el factor de disponibilidad, que por defecto es del 80 % en un centro de trabajo nuevo. Aplícalo una sola vez: como eficiencia en SkyPlanner o como turnos más cortos, nunca de ambas formas.
- Precisión horaria. Los centros de trabajo que utilizan Day planning expresan la capacidad como tiempo básico por día, sin horarios de turno. Configure los turnos reales en SkyPlanner a partir de los calendarios de producción para que los trabajos se programen dentro del horario laboral.
- Tiempo de espera y solapamiento. Las líneas de operaciones incluyen el tiempo de espera y el solapamiento en %. Decida durante la definición del alcance cómo trasladar cada uno a SkyPlanner; de lo contrario, los plazos cambiarán tras la entrada en producción.
- Grupos de centros de trabajo. Los centros de trabajo agrupados se planifican en Pool planning, no en Priority planning. Lea los centros de trabajo que componen el grupo, no solo la fila del grupo.
- Requisitos de versión. Las fechas previstas mediante Update requieren la versión 24.5. Los campos de capacidad de los centros de trabajo en la API requieren la 24.3, y OIDC requiere la 25.8. Compruebe la compilación antes de la definición del alcance.
- Red y certificado. En las instalaciones locales, Monitor ofrece la API a través del puerto 8001 con un certificado autofirmado. SkyPlanner funciona en la nube, por lo que debe prever una regla de cortafuegos o un servidor de retransmisión y configurar explícitamente la confianza en el certificado.
- Licencias. Cada aplicación de terceros que escriba datos necesita sus propios usuarios con licencia de API. Cada sistema incluye un usuario de API de solo lectura.
Integración con Monitor ERP: quién la configura y quién presta soporte
El trabajo incluye definir cómo se corresponden los datos de la integración con sus centros de trabajo, líneas de operaciones y flujo de órdenes, además de incorporar las restricciones que Monitor no almacena: matriz de tiempos de preparación, herramientas, número de operarios y recursos alternativos.
- El equipo de SkyPlanner configura la integración durante la puesta en marcha y presta soporte tras la entrada en producción, tanto para la parte de SkyPlanner como para las llamadas acordadas a Monitor ERP API. Cada planta utiliza Monitor G5 de forma distinta, y es aquí donde se aplica ese conocimiento.
- Su socio de Monitor puede participar. Conoce su configuración, versión y permisos, y puede preparar el usuario de API, la licencia y el acceso de red. 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 documentada y un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner ofrece ayuda cuando se necesita. La documentación pública está disponible en la documentación de SkyPlanner.
Una vez establecida la conexión, el motor Arcturus programa a partir de las órdenes actuales de Monitor y las fechas previstas se registran en las operaciones de las órdenes de fabricación. 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 los precios, compare la planificación propia de Monitor en programación de la producción con Monitor ERP respetando la capacidad real de máquinas y personal, vea el resumen en la página de Monitor ERP y descubra otros ERP en la sección de integraciones con 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, responsable 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.
Miles (1.000)de órdenes de trabajo programadas automáticamente
“Ahora controlamos la producción de otra manera y conocemos nuestra capacidad a un nivel completamente distinto.”
Hannu Ryynänen, director general
Mamec · Mezcladores industriales, bombas y fabricación de alta tecnología por contrato
Miles de órdenes de trabajo se programan automáticamente, con una visión de la producción en tiempo real para toda la organización.
6 mesesde capacidad disponible visible para ventas
“SkyPlanner aporta una base sólida y fiabilidad a toda la planificación de la producción.”
Anu Järvinen, responsable de producción
Fredman Operations · Papeles para envases aptos para el contacto alimentario
El equipo de ventas ve la capacidad disponible con seis meses de antelación, y las solicitudes de cambios en la programación que antes requerían una hora o más se responden en segundos.
Preguntas frecuentes
¿Monitor ERP tiene una API para las órdenes de fabricación?
Sí. Monitor ERP API permite consultar Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations y ManufacturingOrderMaterials. Comandos como ManufacturingOrderOperations/Update y ReplanOperation escriben las fechas previstas en Monitor.
¿Se necesita una licencia adicional para escribir en Monitor a través de la API?
Sí. La lectura a través de la API es gratuita para todos los clientes de Monitor. Los comandos que escriben datos requieren Monitor ERP API, que Monitor comercializa. Su socio de Monitor o el equipo comercial de Monitor le facilitará un presupuesto.
¿Monitor ERP API admite webhooks?
No hay webhooks documentados. La integración consulta Common/EntityChangeLogs cada pocos minutos y recupera únicamente los registros modificados. En sentido contrario, los webhooks propios de SkyPlanner envían los cambios de programación en cuanto se producen.
¿Qué versión de Monitor necesitamos?
Para escribir el inicio y el fin previstos mediante ManufacturingOrderOperations/Update se necesita Monitor 24.5 o posterior. Las compilaciones anteriores de G5, a partir de la 2.40, utilizan ReplanOperation. Durante la definición del alcance confirmamos qué vía corresponde a su compilación.
¿Quién desarrolla la integración con Monitor ERP?
El equipo de SkyPlanner configura la integración bidireccional según su instalación de Monitor G5 durante la puesta en marcha y presta soporte tras la entrada en producción. Su socio de Monitor o sus propios desarrolladores también pueden desarrollar sobre la REST API documentada de SkyPlanner; basta con un token de API para empezar.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días admite hasta 20 estaciones de trabajo con importaciones desde Monitor en Excel o CSV, sin necesidad de tarjeta de crédito. Inicie la prueba o hable con el equipo comercial para definir el alcance de la integración.
