Guía de integración de Sylob ERP para la programación de la producción con SkyPlanner APS

Sylob documenta dos REST API públicas: «L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \»webservices\») qui autorise la lecture et l’écriture de données.» (El ERP Sylob expone dos tipos de API REST públicas, también llamadas servicios web, que permiten leer y escribir datos). (Base de conocimientos de Forterro)

1. API REST Système d’information (lectura). Ejecuta una consulta guardada (requête), creada en la actividad «Interroger le système d’information». La URL de llamada de cada consulta se obtiene en «Autres actions» > «Afficher le web service» y tiene el formato /rest/query/{identifiantQuery}/resultat. Los parámetros definen el límite de resultados, el formato numérico, las variables de la consulta y la estructura de los resultados. Los resultados se devuelven en XML por defecto, o en JSON si se utiliza la cabecera Accept: application/json. Esta API está incluida en el ERP.
2. API REST Action (lectura y escritura). Ejecuta una acción definida en la actividad «Gérer les actions web service», el catálogo de acciones de Sylob. Expone dos operaciones: GET /rest/v2/action/{code}/describe devuelve el esquema de datos de una acción y POST /rest/v2/action/{code}/execute la ejecuta con un cuerpo JSON. Entre los tipos de acciones se incluyen:

– Modification de données: modifica uno o varios campos de un registro mediante el mecanismo de edición rápida de Sylob. Describe enumera los campos editables. – Message EDI: crea, modifica o elimina registros mediante un mensaje EDI. – Scénario de saisie: ejecuta un escenario de entrada de datos, pregunta por pregunta. El ejemplo que ofrece Sylob es «Déclarer un début ou une fin», que declara el inicio o el fin de una operación (Sylob_Action_006). – Publicación, carga y descarga de documentos.

1. Mensajes EDI. El motor EDI de Sylob gestiona las exportaciones e importaciones. El mensaje estándar Sylob_Recup_Decl_Pro recupera las declaraciones de producción. (Forterro)
2. Archivos y ETL. Sylob ERP Cloud ofrece «Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.» (Integración de archivos mediante SFTP para facilitar la migración de las integraciones existentes). (Sylob) Los resultados de las consultas también se pueden exportar a Excel, una vía rápida para probar SkyPlanner.

La base de conocimientos pública de Sylob no documenta ninguna suscripción a webhooks salientes. Los cambios llegan a SkyPlanner mediante la ejecución periódica de consultas guardadas que filtran las OF abiertas y los cambios recientes, con la frecuencia que definas.

Sylob protege el ERP frente a una carga excesiva de consultas. Desde la versión 2025.Q2, el parámetro de empresa «Protection des API» activa la limitación de llamadas por usuario y la paginación de resultados voluminosos. Sylob anuncia su aplicación sistemática a partir de la versión 2026.Q2. Las respuestas incluyen cabeceras RateLimit y, si una llamada supera la cuota, devuelve HTTP 429 Too Many Requests con un valor Retry-After. (Forterro) Diseña la sincronización teniendo esto en cuenta: consultas incrementales, paginación y espera antes de reintentar tras un 429.

En sentido contrario, SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la escritura de datos en Sylob se activa por eventos.

1. Carga inicial de datos maestros. Crea una consulta guardada por objeto (artículos, listas de materiales, rutas de fabricación, centros de trabajo y empleados) y léelas a través de la API Système d’information, o realiza una carga única a partir de una exportación de Excel. Define con cuidado la correspondencia entre centros de trabajo. Un centre de charge de Sylob es un grupo de recursos, por lo que un centro con tres máquinas suele convertirse en un grupo de tres estaciones de trabajo en SkyPlanner.

2. Sincronización de órdenes. Lee las OF firmes con sus operaciones, además de 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. Así, la programación comprueba tanto las existencias como las compras pendientes de recibir.

Programa las OF firmes, no las propuestas del CBN. Las propuestas cambian con el siguiente cálculo de necesidades netas.

3. Escritura de la programación en Sylob. Por cada operación que el motor haya colocado o movido, la integración llama a una acción Modification de données sobre la operación de la OF (Opération d’ordre de fabrication) con el inicio previsto, el fin previsto y el centro de trabajo. La acción utiliza la lógica de edición rápida del propio Sylob, igual que cuando un planificador edita la operación. Describe devuelve los campos editables, lo que permite a la integración validar los datos que va a enviar antes de la primera llamada. Si un usuario está editando un registro, se devuelve un fallo previsto; reintenta la escritura con el siguiente cambio.

4. Declaraciones de producción en planta. Los operarios registran su trabajo con SkyPlanner Mobile Confirmations o Production Timer. El inicio y el fin se envían de vuelta mediante el escenario «Déclarer un début ou une fin». Los registros de tiempo y las cantidades se convierten en declaraciones de producción de la misma operación de la OF: tiempo de preparación, tiempo de ejecución, cantidad fabricada, rechazos y operación finalizada. Si tu planta ya realiza las declaraciones a través de Sylob Apps o de terminales de planta, mantén un único canal para evitar registros duplicados.

5. Reglas de responsabilidad sobre los datos y resolución de conflictos. Documéntalas antes de la entrada en producción:

SkyPlanner no necesita CADPLAN ni las actividades de planificación de Sylob que tienen en cuenta la capacidad disponible. Deja que SkyPlanner gestione las fechas de las operaciones: si dos planificadores escriben las mismas fechas, se sobrescriben mutuamente. Una vez que SkyPlanner las gestiona, Autopilot reprograma automáticamente ante cada cambio significativo y las nuevas fechas se envían a Sylob.

• Licencia de Action API. La lectura mediante consultas guardadas está incluida. Para escribir a través del catálogo de acciones se necesita el módulo «Webservice» de Sylob o una licencia de API en MyForterro. Coordínalo con tu contacto de Sylob antes de la fase de envío de datos a Sylob.
• Las consultas son tu contrato. La lectura depende de las consultas guardadas. Asígnales nombres claros, pasa los filtros como atributos variables en tiempo de ejecución y versiona las consultas junto con la integración.
• Grupos de centros de trabajo. Un centro de trabajo de Sylob puede contener varias máquinas. Decide para cada centro si SkyPlanner lo tratará como un grupo de estaciones de trabajo o como máquinas individuales.
• Programación hacia atrás y cálculos de carga. Sylob programa hacia atrás a partir de las fechas de necesidad, y un cálculo de carga programado puede replanificar las OF retrasadas. Acuerda qué actividad, si procede, seguirá escribiendo las fechas de las operaciones cuando SkyPlanner pase a gestionarlas.
• Unidades de los tiempos de preparación y ejecución. Antes de importar, comprueba las unidades y si la preparación se aplica por OF o por pieza. Unas unidades incorrectas distorsionan todas las duraciones.
• Calendarios. Los patrones semanales y las excepciones de los centros de trabajo deben cubrir todo el horizonte de programación; de lo contrario, la capacidad desaparece del plan.
• Límites de llamadas. Sylob limita las llamadas por usuario y pagina los resultados de gran tamaño. Las consultas periódicas incrementales se mantienen muy por debajo de la cuota.
• CORS y navegadores. Las llamadas entre servidores evitan las restricciones de CORS. Los clientes de navegador necesitan que los orígenes permitidos estén configurados en Sylob.