Integraciones / ERP / MRPeasy
Guía de integración de MRPeasy para la programación de la producción con SkyPlanner APS
Esta guía de integración de MRPeasy explica a consultores y equipos de TI cómo conectar MRPeasy con SkyPlanner APS. SkyPlanner se integra con MRPeasy en ambos sentidos mediante la REST API de MRPeasy:
- Se importan órdenes de fabricación, rutas de fabricación, BOM, grupos de estaciones de trabajo, estaciones de trabajo, artículos, existencias y pedidos de compra.
- Las fechas previstas y el avance se envían de vuelta a cada Manufacturing Order.
- Los webhooks de SkyPlanner envían los cambios de programación en cuanto se producen.
SkyPlanner ya se ha integrado con MRPeasy en proyectos de clientes. Durante la puesta en marcha, el equipo de SkyPlanner adapta la integración a tu configuración de MRPeasy y ofrece soporte tras la entrada en producción. Esta guía está dirigida a consultores y desarrolladores que quieran participar o desarrollar por su cuenta sobre la REST API documentada de SkyPlanner (referencia de la API).
La REST API de MRPeasy: v1 y v2
MRPeasy es un único producto en la nube, sin versiones de instalación local, por lo que todos los clientes utilizan la misma API. Existen dos versiones:
- REST API v1 (OpenAPI 1.0, servidor
https://api.mrpeasy.com/rest/v1) es la API en producción. Incluye/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitse informes de producción como/report/production/operations. - REST API v2 (OpenAPI 2.0.0, servidor
https://api.mrpeasy.com/rest/v2) se encuentra en una fase inicial de desarrollo. Añade/workstation-groupsconwork_hoursyholidays,/workstationsconproductivityeidle,/inventory,/stock-movementy PATCH. Las órdenes de fabricación siguen en v1.
Ten en cuenta las diferencias de nomenclatura. Un Workstation group en la interfaz de MRPeasy corresponde a work-center-types en v1 (type_id). Una Workstation corresponde a work-centers (center_id). Las operaciones de la ruta de fabricación apuntan a un grupo mediante type_id, no a una máquina.
La API se incluye en el plan Unlimited de MRPeasy para cuentas de pago. MRPeasy también indica: «Our Support Department cannot help you using the API.» (Nuestro departamento de soporte no puede ayudarte a utilizar la API). Por eso, alguien debe hacerse cargo de la integración: SkyPlanner, tu consultor de MRPeasy o tu desarrollador. El equipo de SkyPlanner asume precisamente ese trabajo durante la puesta en marcha.
Autenticación y límites
MRPeasy utiliza autenticación HTTP Basic: Authorization: Basic base64(api-key:api-secret). La clave y el secreto se crean en Settings → Integration → API access. Al borrar la clave, se desactiva la API.
Los límites condicionan el diseño de la sincronización:
- Solo se admite una solicitud a la vez por cliente: las solicitudes se procesan de forma secuencial.
- Como máximo, 100 solicitudes cada 10 segundos. Si se supera ese límite, la API devuelve el código 429.
- Las listas devuelven 100 registros por defecto y hasta 1.000 con la cabecera
Range. La cabeceraContent-Rangede la respuesta indica el total.
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.
Eventos y consultas periódicas
La página de precios de MRPeasy incluye «API, webhooks (for paid accounts)» (API y webhooks para cuentas de pago), pero las especificaciones de v1 y v2 no documentan eventos de webhook para las órdenes de fabricación. Por tanto, la integración consulta MRPeasy de forma incremental:
- Órdenes de fabricación filtradas por los estados Not scheduled (15), Scheduled (20), In progress (30) y Paused (35).
- Pedidos de compra e inventario a intervalos programados o antes de cada ejecución de la programación.
- Datos maestros cuando cambian o cada noche.
Las consultas secuenciales y filtradas se mantienen muy por debajo del límite de 100 solicitudes por cada 10 segundos. En sentido contrario, los webhooks de SkyPlanner envían los cambios de programación en cuanto se producen, por lo que el envío de datos de vuelta se basa en eventos.
Correspondencia de datos
| Objeto de MRPeasy (endpoint) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Productos y materiales | MRPeasy → SkyPlanner | Carga inicial y después cada noche |
BOM con componentes (/boms) | Estructura del producto, subproductos y materiales por producto | MRPeasy → SkyPlanner | Carga inicial y después cuando haya cambios |
Operaciones de la ruta de fabricación (/routings): type_id, fixed_time, variable_time, variable_quantity | Etapas del proceso con duraciones, tiempos de preparación y tamaño de lote | MRPeasy → SkyPlanner | Carga inicial y después cuando haya cambios |
Workstation group (/work-center-types; v2 /workstation-groups) | Grupos de estaciones de trabajo y turnos | MRPeasy → SkyPlanner | Carga inicial y rara vez después |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Estaciones de trabajo, eficiencias y ausencias | MRPeasy → SkyPlanner | Carga inicial; actualización diaria de los tiempos de inactividad |
Manufacturing Order con operaciones y due_date (/manufacturing-orders) | Órdenes y tareas | MRPeasy → SkyPlanner | Consultas cada pocos minutos |
Inventory, Stock lots (/stock/inventory, /lots) | Saldos de existencias | MRPeasy → SkyPlanner | Cada hora o en cada ejecución de la programación |
Purchase Order (/purchase-orders) | Material pendiente de recibir con fecha de entrega prevista | MRPeasy → SkyPlanner | Cada hora o en cada ejecución de la programación |
Campos due_date y custom_<id> de Manufacturing Order (PUT /manufacturing-orders/{id}) | Inicio previsto, fin previsto y avance | SkyPlanner → MRPeasy | Cuando cambia la programación, mediante un webhook de SkyPlanner |
| No disponible en MRPeasy | Matriz de tiempos de preparación, herramientas como recursos de capacidad limitada, número de operarios y estaciones de trabajo alternativas | Se mantiene en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Obtén los artículos, las unidades, las BOM y las rutas de fabricación de v1, y los grupos de estaciones de trabajo y las estaciones de trabajo de v1 o v2. Obtén los calendarios de /workstation-groups en v2 (work_hours, holidays) o configura los turnos directamente en SkyPlanner. Asocia cada grupo de tipo Active processing a un grupo de estaciones de trabajo de SkyPlanner e incluye en él sus estaciones de trabajo.
2. Sincronización de órdenes y pedidos. Lee las órdenes de fabricación abiertas con sus operaciones, además de los pedidos de compra abiertos y el inventario. 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. En cada reprogramación se comprueban tanto las existencias como las compras pendientes de recibir.
3. Envío de la programación de vuelta. PUT /manufacturing-orders/{id} admite code, quantity, due_date y assigned_id, además de campos personalizados como custom_<id>. Cuando así se acuerda, SkyPlanner escribe el fin previsto en due_date, y el inicio previsto, el fin previsto y el avance en campos personalizados de MRPeasy. Así, los equipos de ventas y compras ven la programación real en MRPeasy. La secuencia detallada de operaciones y la estación de trabajo de cada operación se mantienen en SkyPlanner, que es la vista desde la que se asigna el trabajo en planta.
4. Órdenes creadas fuera de MRPeasy. Si en algún momento se crean órdenes mediante la API, POST /manufacturing-orders admite no_scheduling y no_bookings. Utilízalos para que MRPeasy no reserve estaciones de trabajo que ya programa SkyPlanner.
5. Confirmaciones en planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations, Production Timer o Quick Log Mode, y esos registros de tiempo mantienen la programación al día. Elige un único canal de registro. Utilizar Internet-kiosk de MRPeasy y SkyPlanner en paralelo para las mismas operaciones genera dos versiones de la realidad.
6. 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, rutas de fabricación, cantidades, existencias y aprovisionamiento | MRPeasy |
| Secuencia de operaciones, horas de inicio y fin, y asignación de estaciones de trabajo | SkyPlanner |
| Matriz de tiempos de preparación, herramientas, número de operarios y recursos alternativos | SkyPlanner |
| Turnos y ausencias | Un único sistema, elegido durante la definición del alcance |
| Avance de la orden y trabajo registrado | SkyPlanner, con un resumen en Manufacturing Order |
Flujo de ingeniería bajo pedido. En un proyecto de MRPeasy ya entregado, cada proyecto de cliente se convierte en un producto principal y entre uno y tres productos semielaborados. Cada uno tiene su propia BOM y ruta de fabricación en MRPeasy, y la orden de fabricación existe en ambos sistemas. Mantenga un identificador compartido y estable en cada orden para que las actualizaciones nunca generen duplicados.
Pasos habituales del proyecto
La implantación suele completarse en cuestión de semanas desde el inicio de la incorporación. Antes, puede realizar la prueba gratuita de 30 días con sus propios datos, con cualquier plan de MRPeasy. Exporte a CSV los artículos, las BOM, las rutas de fabricación, las estaciones de trabajo y las órdenes de fabricación abiertas desde las vistas de lista de MRPeasy, impórtelos y valide la programación.
El proyecto incluye los siguientes pasos:
- Comprobación del plan. Confirme que el plan de MRPeasy incluye la API y cree la clave de API y el secreto.
- Correspondencias. Defina la tabla de correspondencias, las reglas que determinan qué sistema gestiona cada dato, los campos personalizados para devolver datos y el canal de registro del trabajo.
- Carga inicial. Artículos, unidades, BOM, rutas de fabricación, grupos de estaciones de trabajo, estaciones de trabajo y calendarios.
- Sincronización de órdenes y pedidos de compra. Consulta periódica incremental por estado, con gestión de respuestas 429.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación y cambio, herramientas, número de operarios y estaciones de trabajo alternativas.
- Escritura de datos en MRPeasy. Fechas de entrega y campos personalizados de cada Manufacturing Order.
- Pruebas en paralelo. Utilice SkyPlanner en paralelo con el Production schedule actual, compare las fechas y corrija los datos maestros.
- Puesta en marcha. Active la escritura de datos en MRPeasy cuando los datos coincidan.
Qué tener en cuenta al integrar MRPeasy
- Los campos de tiempo varían según la interfaz. Los campos Setup time, Cycle time y Capacity de la interfaz de usuario corresponden a
fixed_time,variable_timeyvariable_quantityen la API. Un valor de Capacity superior a 1 indica un procesamiento por lotes, como el de un horno. Represéntelo como una tarea por lotes, no como un ciclo más largo. - Grupos de tipo Passive processing. Los grupos de secado y enfriamiento funcionan 24/7 sin límites de capacidad. Represéntelos como tiempos de espera, no como estaciones de trabajo con capacidad limitada.
- La v1 no incluye calendarios.
work-centerssolo devuelvecenter_id,type_id,codeytitle. Utilice la v2 o gestione los turnos en SkyPlanner. - Tiempo de inactividad. El tiempo de inactividad de las estaciones de trabajo recoge los periodos de mantenimiento y las paradas. Sincronícelo; de lo contrario, SkyPlanner programará trabajo en máquinas paradas.
- Las rutas de fabricación hacen referencia a grupos. MRPeasy elige la máquina con mayor disponibilidad. En SkyPlanner, las estaciones de trabajo del grupo se convierten en alternativas reales entre las que el motor elige.
Integración con MRPeasy: quién la configura y ofrece soporte
El trabajo incluye definir las correspondencias de sus rutas de fabricación, grupos de estaciones de trabajo y flujo de órdenes, así como las restricciones que MRPeasy no recoge: matriz de tiempos de preparación y cambio, herramientas, número de operarios y recursos alternativos.
- El equipo de SkyPlanner configura la integración durante la incorporación y ofrece soporte tras la puesta en marcha. Cada planta utiliza MRPeasy de forma distinta, y ese conocimiento se aplica aquí. Como el soporte de MRPeasy no cubre el trabajo con la API, es importante que un solo equipo se responsabilice de la integración.
- Su consultor de MRPeasy o su socio de integración puede desarrollarla. En un proyecto de MRPeasy ya entregado, un socio de integración conectó ambos sistemas mediante sus respectivas REST APIs. SkyPlanner proporciona la REST API, documentación Swagger/OpenAPI y webhooks.
- Sus propios desarrolladores pueden crear la integración con un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner presta ayuda cuando hace falta. La documentación del producto, que incluye los pedidos de compra y la API de productos y materiales, está 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 el plan, para que conozca el coste total antes de empezar. Consulte los precios, las funciones y la comparación con el programador propio de MRPeasy en programación de la producción en MRPeasy con límites reales de capacidad de máquinas y personal. Encontrará una visión general en la página de MRPeasy y 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 la línea recibe una nueva cola de trabajo en segundos.
+90%de eficiencia en la producción
“La eficiencia en la producción ha aumentado un 90%.”
Abdul Rucyinga, responsable de TI
Laboratory & Allied · Fabricación farmacéutica
La eficiencia en la 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.
6 mesesde capacidad disponible a la vista del equipo comercial
“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 con alimentos
El equipo comercial 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
¿MRPeasy tiene una API y qué plan necesito?
Sí. MRPeasy ofrece una REST API —v1 en producción y v2 en desarrollo— en el plan Unlimited para cuentas de pago. La autenticación utiliza HTTP Basic con una clave de API y un secreto que se obtienen en Settings → Integration → API access.
¿Puede SkyPlanner escribir la programación en MRPeasy?
Sí. SkyPlanner actualiza cada Manufacturing Order mediante PUT /manufacturing-orders/{id}, escribiendo la fecha de entrega y los campos personalizados de inicio previsto, fin previsto y avance. La secuencia detallada de operaciones se mantiene en SkyPlanner, donde los operarios trabajan desde su propia cola.
¿MRPeasy envía los cambios en tiempo real?
Las especificaciones de la API no documentan eventos webhook para las órdenes de fabricación, por lo que SkyPlanner consulta las órdenes abiertas por estado cada pocos minutos. Los webhooks propios de SkyPlanner envían los cambios en la programación en cuanto se producen.
¿Quién desarrolla la integración con MRPeasy?
El equipo de SkyPlanner configura la integración bidireccional durante la incorporación y ofrece soporte tras la puesta en marcha. Su consultor de MRPeasy, un socio de integración o sus propios desarrolladores también pueden desarrollarla a partir de la REST API documentada de SkyPlanner.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días permite utilizar hasta 20 estaciones de trabajo con importaciones CSV de MRPeasy, con cualquier plan de MRPeasy y sin necesidad de tarjeta de crédito. Inicie la prueba o hable con el equipo comercial para definir el alcance de la integración.
