Guía de integración de Epicor Kinetic para programar la producción con SkyPlanner APS

Epicor afirma: «All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.» (Todos los servicios de Kinetic, incluidos los objetos de negocio, procesos, informes, BAQs y Epicor Functions, son accesibles a través de endpoints REST). Una integración para la programación de la producción se basa en cuatro tecnologías de Epicor:

1. Kinetic REST API v2 (OData v4). Los objetos de negocio se exponen como servicios con el nombre Erp.BO.<Name>Svc. La ruta habitual es /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 sigue disponible, pero es una versión heredada: desarrolle la integración sobre v2. Compruebe los conjuntos de entidades y los métodos de su versión en REST Help, en /api/help/v2/.
2. Business Activity Queries (BAQ) mediante REST. Cada BAQ se expone en /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Es una vía práctica para extraer datos de planificación combinando JobHead, JobOper, JobMtl, PartWhse y PORel en una sola llamada (ejemplo de la comunidad).
3. Epicor Functions (EFx). Funciones del lado del servidor que pueden invocarse en /api/v2/efx/{Company}/{Library}/{Function}. Epicor indica que «can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.» (pueden activarse desde distintos puntos de entrada, como BPM, servicios REST, programaciones y eventos de la aplicación).
4. Directivas BPM. Method Directives y Data Directives se activan cuando cambia una tarea u operación y pueden llamar a una función que envía datos al exterior.

Para trabajar con archivos, DMT gestiona las importaciones y las exportaciones BAQ permiten extraer los datos. Epicor también ofrece Epicor Automation Studio, que describe como «a low-code app for integration-led automations» (una aplicación de bajo código para automatizaciones basadas en integraciones). Evita el acceso directo a la base de datos: REST, las BAQs y las funciones operan de la misma manera en instalaciones locales y en Kinetic Cloud.

Epicor no documenta ninguna API genérica de webhooks de salida, por lo que los cambios de Kinetic llegan a SkyPlanner de una de estas dos formas:

• Por eventos. Una Data Directive de BPM sobre JobHead o JobOper llama a una Epicor Function, que envía la orden modificada a la API REST de SkyPlanner.
• Consultas periódicas programadas. Una BAQ filtrada por fecha de modificación se ejecuta cada pocos minutos o cada hora. Esta opción es más sencilla de mantener y de recuperar en caso de fallo.

En el sentido contrario, SkyPlanner envía los cambios de estado y de programación mediante sus webhooks. Tu middleware o un endpoint EFx los recibe y los escribe en Kinetic.

1. Carga inicial de datos maestros. Lea los artículos, grupos de recursos productivos, recursos productivos, capacidades, calendarios y empleados. Cree las estaciones de trabajo de SkyPlanner a partir de los recursos de Kinetic, y los grupos de estaciones a partir de los grupos de recursos. Pagine las lecturas de gran volumen con $top y $skip, o extraiga los datos en bloque mediante una BAQ.

2. Sincronización de órdenes. Envíe las órdenes liberadas y en firme con sus operaciones y materiales. Obtenga el árbol de la orden con GetDatasetForTree o una BAQ, no entidad por entidad. Mantenga en Kinetic las órdenes de MRP que aún no estén en firme hasta que se confirmen. Junto con la lectura de existencias, sincronice las entregas pendientes de los pedidos de compra y sus fechas de entrega previstas. SkyPlanner considera que el material pedido estará disponible en la fecha de entrega y actualiza las existencias cuando el pedido de compra se marca como Delivered. Así, la programación tiene en cuenta tanto las existencias como las compras pendientes de recepción.

3. Escritura de la programación en Kinetic. El webhook de SkyPlanner envía el inicio, el fin y la estación de trabajo previstos para cada operación a un endpoint de EFx (/api/v2/efx/{Company}/{Library}/{Function}). La función escribe los datos a través del motor de programación de Kinetic, el mismo objeto de negocio que utilizan la programación de Job Entry y los tableros de programación (ejemplo de la comunidad):

1. ScheduleEngine.GetNewParamsForJob crea el conjunto de datos que necesita el motor de programación para la orden.
2. La función establece el número de orden, las secuencias de ensamblaje y de operación y la fecha y hora de inicio previstas. Después llama a ScheduleEngine.MoveJobItem.
3. Cuando SkyPlanner ha asignado la operación a otro recurso productivo del grupo, ScheduleEngine.ChangeResource la traslada a ese recurso. Por sí solo, MoveJobItem mantiene el recurso predeterminado del grupo.
4. La función activa el bloqueo de la programación de la orden (JobHead.SchedLocked, la opción Lock de Job Entry), para que Global Scheduling conserve las fechas de SkyPlanner.

Agrupar estas llamadas en una Epicor Function mantiene la escritura atómica por orden y permite añadir validaciones propias. Si la planta prefiere no utilizar una función personalizada, puede ejecutar la misma secuencia con llamadas REST directas a Erp.BO.ScheduleEngineSvc. Nunca escriba directamente en ResourceTimeUsed ni en los campos de fecha de JobOper: eso omite el motor y deja desajustadas las asignaciones de los tableros.

4. Notificaciones de producción en planta. Los operarios registran su trabajo en SkyPlanner con Mobile Confirmations, Production Timer o Quick Log Mode. Cada registro de tiempo cerrado se convierte en un registro de mano de obra en Kinetic a través de Erp.BO.LaborSvc: StartActivity y EndActivityByEmp para la actividad en tiempo real, o Labors con Update para los registros a posteriori. Si su planta exige aprobación, incluya submitForApproval en el flujo y en el ámbito de acceso.

5. Reglas de responsabilidad sobre los datos y resolución de conflictos. Déjalas por escrito antes de la entrada en producción:

Las tareas que programa SkyPlanner llevan un bloqueo de programación para que Global Scheduling no modifique sus fechas. Mantén la programación de Kinetic para los recursos productivos que SkyPlanner no planifique.

La implantación suele completarse en cuestión de semanas desde el inicio de la puesta en marcha. Un proyecto de Kinetic incluye:

1. Una prueba de 30 días con exportaciones de tareas, operaciones y recursos productivos en CSV o Excel, antes de iniciar cualquier desarrollo.
2. La clave de API, el ámbito de acceso, un usuario exclusivo para la integración y las BAQs que esta consulta.
3. La correspondencia entre los datos maestros —capacidades, grupos de recursos productivos, recursos productivos, calendarios y empleados— y los puestos de trabajo, grupos, turnos y personal de SkyPlanner.
4. La carga inicial de artículos, métodos de fabricación (BOM y operaciones) y recursos productivos.
5. Sincronización de órdenes de producción y pedidos de compra (fechas de entrega previstas de PORel), además de las existencias de PartWhse.
6. Escritura en Kinetic de las fechas previstas de las operaciones mediante ScheduleEngineSvc (MoveJobItem, ChangeResource) en una Epicor Function, con el bloqueo de la orden activado.
7. Envío de las notificaciones de producción en planta como registros de mano de obra mediante LaborSvc.
8. Pruebas en paralelo con el programa actual de Kinetic y, después, la entrada en producción.

No hay dos plantas que utilicen Kinetic de la misma manera. Las rutas de fabricación basadas en capacidades, los calendarios de los grupos de recursos productivos, el diseño de las BAQs, las directivas BPM y los métodos para devolver datos a Kinetic, específicos de cada versión, varían de una planta a otra. Configurarlos bien marca la diferencia entre un programa en el que los planificadores confían y otro que tienen que rehacer.

1. El equipo de SkyPlanner la configura durante la puesta en marcha y ofrece soporte tras la entrada en producción. El equipo establece la correspondencia de tus recursos productivos, tareas y entregas de pedidos de compra, y configura las lecturas de BAQ, los disparadores BPM y la función que devuelve los datos a Kinetic. Conecta la API REST y los webhooks de SkyPlanner con Kinetic REST v2. El soporte continúa cuando cambian tus BAQs, BPMs o la versión de Kinetic.
2. Tu partner de Epicor. Los partners que ya desarrollan BAQs, BPMs y Epicor Functions pueden trabajar con la misma API REST documentada de SkyPlanner, que permite leer y escribir órdenes, productos, materiales, fases de proceso y registros de tiempo.
3. Tus propios desarrolladores. Los equipos internos con experiencia en Kinetic REST pueden desarrollar la integración directamente, o en Automation Studio si lo utilizas. Basta con una clave de API de SkyPlanner para empezar (tutorial de integración), y el equipo de SkyPlanner presta ayuda cuando es necesario. La documentación del producto es pública y está disponible en la documentación de SkyPlanner.

Este mismo patrón de API y webhooks ya funciona en producción con otros ERP, por ejemplo en UTU. En Laboratory & Allied, el equipo interno de TI desarrolló la integración con SAP Business One en gran medida por su cuenta, con la ayuda de SkyPlanner.

Todas las opciones empiezan igual: utiliza primero la prueba gratuita de 30 días con importaciones CSV, valida el programa y después desarrolla la integración. El precio parte de 199 € al mes con 5 puestos de trabajo, facturación mensual y cancelación en cualquier momento. La integración se presupuesta de antemano según tus procesos y necesidades, junto con tu plan, para que conozcas el coste total antes de empezar.