Guía de integración de JobBOSS² para programar la producción con SkyPlanner APS

ECI publica sus API de fabricación, con especificaciones OpenAPI, en el sitio de documentación de las API de fabricación de ECI. Dos de ellas son relevantes para la programación:

1. JobBOSS² API (v1). Utiliza REST y JSON y es específica de JobBOSS². Permite leer y escribir pedidos, Order Line Items, Order Routings, Estimates, Routings, materiales, Job Requirements, Work Centers, Company Calendar, Employees, pedidos de compra, Time Tickets y Time Ticket Details. ECI indica que «is currently only supported for JobBOSS² hosted (Cloud) customers.» (actualmente solo es compatible con clientes de JobBOSS² alojado en la nube).
2. ECI ERP API (v2.1). Una REST API independiente del producto, para Deacom, M1 y JobBOSS². En JobBOSS² abarca tareas, operaciones y materiales de las tareas, piezas, operaciones de las piezas, centros de trabajo, líneas de pedidos de compra y líneas de partes de horas. ECI señala que «the actual ERP database could be a cloud hosted ERP or on premises install,» (la base de datos del ERP puede estar alojada en la nube o en una instalación local), por lo que esta es la vía para integrar JobBOSS² instalado en local.

Ambas API siguen las mismas convenciones: expresiones de filtrado como lastModDate[gte]=, un parámetro fields=, sort= y paginación con take y skip, donde el valor predeterminado de take es 200. «All dates submitted to the API are assumed to be in UTC.» (Se considera que todas las fechas enviadas a la API están en UTC).

ECI establece la misma norma para ambas: «All APIs must be activated by ECI before use.» (ECI debe activar todas las API antes de su uso). Solicítelo a su responsable de cuenta de ECI con antelación.

Ninguna de las dos API de ECI documenta webhooks. Los datos de JobBOSS² se obtienen mediante consultas periódicas: filtre Order Line Items, Order Routings y las líneas de pedidos de compra por lastModDate desde la última ejecución y pagine con take y skip. La frecuencia se ajusta a cada taller, desde cada pocos minutos para las tareas hasta cada hora para las existencias.

SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la escritura de datos en JobBOSS² se activa mediante eventos.

1. Carga inicial de datos maestros. Lea Estimates, Routings, materiales, Work Centers, Company Calendar y Employees. Defina con cuidado las correspondencias de los centros de trabajo: un centro con cuatro tornos se convierte en un grupo de estaciones de trabajo o en cuatro estaciones de trabajo, para que SkyPlanner secuencie el trabajo de cada máquina.

2. Sincronización de tareas. Lea los Order Line Items abiertos con sus Order Routings, Job Requirements y líneas de pedidos de compra abiertas. 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. Excluya las tareas en espera y las cerradas.

3. Envío de la programación a JobBOSS². Cuando el motor asigna o mueve un paso, un webhook de SkyPlanner activa una solicitud PATCH a /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Esta establece estimatedStartDate y estimatedEndDate en UTC, así como workCenter y employeeCode cuando SkyPlanner ha reasignado el paso a otra máquina o persona. Las fechas se guardan en los pasos de las tareas que ya muestran Whiteboard, Planning Board y Scheduling Advisor.

4. Confirmaciones en planta. Los operarios registran su trabajo con SkyPlanner Mobile Confirmations o Production Timer, y los registros de tiempo mantienen la programación al día. Usted decide si los tiempos reales se envían a JobBOSS². Si elige hacerlo, cada confirmación se convierte en un Time Ticket Detail con el tiempo de preparación, el tiempo de ciclo y las piezas. En caso contrario, la captura de datos sigue realizándose en JobBOSS² y SkyPlanner lee el avance desde Order Routings.

5. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjelas por escrito antes de la entrada en producción:

Elija un único sistema para escribir las fechas de los pasos de las tareas. SkyPlanner sustituye la reprogramación en Whiteboard para las tareas que programa: los planificadores mueven el trabajo en SkyPlanner y las fechas se transfieren a JobBOSS².

• Alojamiento externo o instalación local. JobBOSS² API da servicio a los clientes con alojamiento externo. Las instalaciones locales utilizan ERP API, cuya lista de recursos es distinta. Decida qué vía usar en el paso 1.
• Siempre en UTC. La API lee y escribe en UTC. Convierta las horas a la zona horaria de la planta; de lo contrario, un inicio a las 7:00 quedará registrado a una hora incorrecta.
• Máquinas detrás de los centros de trabajo. Un centro de trabajo puede ser una máquina, un grupo, una célula o personas. El número de máquinas y el tamaño del equipo de cada operación de la ruta de fabricación indican a SkyPlanner cuántos recursos productivos necesita esa operación.
• Servicios externos. Las operaciones que tienen un proveedor en lugar de un centro de trabajo representan lead time, no capacidad propia. Modélelas como operaciones que solo requieren tiempo.
• Operaciones solapadas y sin supervisión. Las operaciones de la ruta de fabricación pueden marcarse para solaparse o ejecutarse sin supervisión. Transfiera ambos indicadores para planificar correctamente el trabajo sin presencia de operarios.
• Unidades de tiempo. Los tiempos de preparación y de ciclo tienen sus propias unidades, y el tiempo de cola es tiempo de espera, no de máquina. Convierta las unidades al importar; de lo contrario, todas las duraciones serán incorrectas.
• Paginación. Las páginas contienen 200 registros por defecto. Aplique paginación en todas las lecturas.