Integraciones / ERP / SAP Business ByDesign
Guía de integración de SAP Business ByDesign para programar la producción con SkyPlanner APS
Esta guía de integración de SAP Business ByDesign explica a partners y equipos de TI cómo conectar ByDesign con SkyPlanner APS. La integración entre SkyPlanner y ByDesign es bidireccional y utiliza los servicios web publicados por SAP:
- Se importan las órdenes de producción liberadas con sus operaciones, Production Models, Bills of Material y Bills of Operations, equipos y recursos de mano de obra, materiales, existencias y pedidos de compra.
- Se devuelven a ByDesign el inicio planificado de cada orden de producción y el recurso principal de cada operación.
- Las cantidades confirmadas, las mermas y las tareas finalizadas se pueden registrar en los lotes de producción.
- 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 con su tenant de ByDesign a través de la REST API y ofrece soporte tras la entrada en producción. Esta guía está dirigida a partners y desarrolladores que quieran participar o crear sus propias soluciones sobre la REST API documentada de SkyPlanner (referencia de la API).
Interfaces de integración de SAP ByDesign
ByDesign publica los servicios web SOAP A2X disponibles para cada versión en la lista de API de servicios web. Estos son los servicios que utiliza una integración para la programación de la producción:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER devuelve las fechas de inicio y fin solicitadas, más tempranas y más tardías; los recursos con la duración planificada y realizada; la prioridad; y los estados de ejecución y programación. MAINTAIN_BUNDLE_V2 actualiza EarliestStartPeriod o LatestEndPeriod, así como MainResourceID de la operación (ayuda de SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle crea o actualiza tareas de producción: cantidad confirmada, mermas e indicador de confirmación finalizada por punto de notificación; finalización de la tarea con el empleado que la realiza y el tiempo de ejecución; y utilización de recursos (ayuda de SAP).
- Servicios de consulta. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (también por recurso), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks y Determine Availability of Products.
- OData. Servicios OData personalizados para objetos de negocio, además de OData para fuentes de datos e informes analíticos. Sobre la elección de los objetos de negocio que se exponen, SAP afirma: «companies are fully empowered to decide which business objects» (las empresas tienen plena capacidad para decidir qué objetos de negocio) (escenarios de integración de SAP).
Utilice los servicios Query u OData para las lecturas y los dos servicios Manage para todas las escrituras.
Autenticación y licencias
En ByDesign, cree un sistema de comunicación para SkyPlanner y un acuerdo de comunicación para los servicios que vaya a utilizar. Cada acuerdo tiene su propio usuario técnico. La guía de seguridad de SAP especifica la autenticación de la integración de aplicaciones mediante «user ID plus password, and the X.509 client certificate» (ID de usuario más contraseña y el certificado de cliente indicado) (Guía de seguridad). Para OData se puede configurar OAuth 2.0. El WSDL de cada servicio se descarga desde el acuerdo de comunicación o desde Service Explorer.
En SkyPlanner, cada llamada incluye un token de API en la cabecera Authorization-Token. El token se crea en SkyPlanner, en Settings > API. Basta con un token de API para empezar a desarrollar.
Eventos y consultas periódicas
SkyPlanner envía webhooks cada vez que cambia la programación, de modo que los cambios se escriben en ByDesign a medida que se modifica el plan.
Para detectar cambios en ByDesign, consulte periódicamente los servicios Query. Lea las órdenes de producción liberadas y los lotes de producción cada pocos minutos, y los materiales, las existencias y los pedidos de compra con menor frecuencia. Los resultados se paginan mediante QueryHitsMaximumNumberValue y LastReturnedObjectID; SAP documenta el tamaño de página predeterminado en su página de servicios web.
Correspondencia de datos
| Objeto de ByDesign (interfaz) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
| Materiales (Query Materials) | Productos y materiales | ByDesign → SkyPlanner | Carga inicial y después consultas periódicas |
| Production Bill of Material (Query Production Bill of Materials) | Estructura del producto, materiales por producto | ByDesign → SkyPlanner | Carga inicial y, después, cuando haya cambios |
| Production Bill of Operations: operaciones y actividades Setup, Produce y Tear down (Query Production Bill of Operations) | Etapas del proceso con sus duraciones y tiempos de preparación y desmontaje | ByDesign → SkyPlanner | Carga inicial y después cuando haya cambios |
| Production Model (Query Production Model) | Ruta de fabricación del producto por centro | ByDesign → SkyPlanner | Carga inicial y después cuando haya cambios |
| Equipos y grupos de recursos (Read Equipment Resources) | Estaciones de trabajo, grupos de estaciones de trabajo, herramientas | ByDesign → SkyPlanner | Carga inicial y, después, solo ocasionalmente |
| Recursos de mano de obra, horarios de trabajo (Query Labour Resource) | Personal y turnos | ByDesign → SkyPlanner | A diario, o con turnos propios en SkyPlanner |
| Órdenes de producción liberadas y operaciones (Query Production Orders, READ_PROD_ORDER) | Órdenes y tareas con fechas de entrega y necesidades de materiales | ByDesign → SkyPlanner | Consultas cada pocos minutos |
| Lotes de producción y tareas (Query Production Lots) | Avance de las tareas | ByDesign → SkyPlanner | Consultas cada pocos minutos |
| Existencias identificadas, disponibilidad de productos (Query Identified Stocks, Determine Availability of Products) | Niveles de existencias | ByDesign → SkyPlanner | Consultas cada hora o al ejecutar la programación |
| Pedidos de compra (Query Purchase Orders) | Pedidos de compra, material pendiente de recepción por fecha de entrega | ByDesign → SkyPlanner | Consultas cada hora o al ejecutar la programación |
| EarliestStartPeriod, MainResourceID de la operación (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Inicio planificado, estación de trabajo asignada | SkyPlanner → ByDesign | Al cambiar la programación, mediante un webhook de SkyPlanner |
| Cantidad confirmada, mermas, finalización de la tarea (Manage Production Lots, MaintainBundle) | Registros de tiempo y confirmaciones de los operarios | SkyPlanner → ByDesign | Por confirmación o por turno, si se elige esta opción |
| No está en ByDesign | Matriz de tiempos de preparación, necesidades de varios operarios, máquinas y personal alternativos | Se mantiene en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lea los materiales, Production Models, Bills of Material y Bills of Operations, equipos y recursos de mano de obra. Defina con criterio la correspondencia de los recursos: un grupo de recursos con cuatro máquinas se convierte en un grupo de estaciones de trabajo o en cuatro estaciones de trabajo. Los equipos que son herramientas se convierten en herramientas de disponibilidad limitada en SkyPlanner.
2. Sincronización de órdenes de producción. Lea las órdenes de producción liberadas con sus operaciones y materiales, junto con 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. Las propuestas de producción permanecen en ByDesign Supply Planning hasta que se convierten en órdenes de producción.
3. Escritura de la programación en ByDesign. Cuando el motor sitúa o mueve una orden en la programación, un webhook de SkyPlanner activa MAINTAIN_BUNDLE_V2 en Manage Production Orders. Esta llamada establece EarliestStartPeriod y MainResourceID de la operación que SkyPlanner ha elegido.
4. Confirmaciones en planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations o Production Timer, y los registros de tiempo mantienen actualizada la programación. Usted decide si los datos reales se devuelven a ByDesign. En caso afirmativo, MaintainBundle de Manage Production Lots registra la cantidad confirmada, las mermas y la tarea finalizada con el empleado que la ha realizado. En caso contrario, las confirmaciones se introducen en ByDesign como hasta ahora.
5. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjelas por escrito antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Materiales, Production Models, cantidades, estado de órdenes y lotes | ByDesign |
| Secuencia de operaciones, horas de inicio y fin, asignación de recursos | SkyPlanner |
| Matriz de tiempos de cambio, necesidades de herramientas y operarios, recursos alternativos | SkyPlanner |
| Turnos y días no laborables | Un sistema, elegido durante la definición del alcance |
| Confirmaciones, movimientos de mercancías, cálculo de costes | ByDesign, con datos introducidos allí o enviados desde los registros de tiempo de SkyPlanner |
Elija un único sistema para escribir las fechas de las órdenes. No ejecute Load Leveling sobre los recursos que programa SkyPlanner y compruebe que la ejecución de planificación no desplace las órdenes liberadas que gestiona SkyPlanner.
Fases habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, valide la programación durante la prueba gratuita de 30 días con recursos, Bills of Operations y órdenes de producción abiertas exportados de ByDesign en CSV o Excel.
- Mapeo. Defina la tabla de correspondencias, las reglas sobre qué sistema controla cada dato, las frecuencias de sincronización y si las confirmaciones se devuelven a ByDesign.
- Acceso a ByDesign. Cree el sistema de comunicación y los acuerdos de comunicación, y descargue los WSDL. Haga primero las pruebas en su tenant de pruebas de ByDesign.
- Carga inicial. Materiales, Production Models, Bills of Material y Bills of Operations, recursos y horarios de trabajo.
- Sincronización de órdenes y pedidos de compra. Consultas periódicas con paginación, filtros y reintentos.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación y cambio, herramientas, número de operarios por tarea y máquinas o personal alternativos.
- Escritura de la programación en ByDesign. Llamadas a MAINTAIN_BUNDLE_V2 desde los webhooks de SkyPlanner, más las confirmaciones de lotes si se elige esta opción.
- Pruebas en paralelo. Utilice SkyPlanner en paralelo con el plan actual, compare las fechas y corrija los datos maestros.
- Entrada en producción. Active la escritura de datos en ByDesign cuando los datos coincidan.
Qué tener en cuenta al integrar SAP ByDesign
- Una fecha por llamada. «The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.» (EarliestStartPeriod y LatestEndPeriod no se pueden actualizar a la vez). Utilice la fecha de inicio como referencia para la escritura de datos en ByDesign.
- Sin bloqueos. Los servicios A2X no mantienen el estado, por lo que, según SAP, no se pueden aplicar bloqueos transaccionales ni lógicos. Vuelva a leer la orden antes de cada escritura y gestione los conflictos.
- La finalización es definitiva. «Confirmation Finished Indicator cannot be unchecked once it is set.» (El indicador Confirmation Finished Indicator no se puede desmarcar una vez activado). Registre la finalización solo cuando el operario cierre la tarea.
- Recursos principales y adicionales. La programación de ByDesign tiene en cuenta los recursos principales. Modele los operarios y las herramientas de los recursos adicionales como recursos productivos con capacidad limitada en SkyPlanner, para que la programación compruebe su disponibilidad.
- Preparación y desmontaje. En Bills of Operations, la preparación y el desmontaje se registran como actividades. Traslade los tiempos de cambio de formato que dependen de la secuencia a la matriz de tiempos de preparación.
Quién configura la integración con SAP ByDesign y presta soporte
- El equipo de SkyPlanner la configura durante la puesta en marcha y presta soporte tras la entrada en producción, para los servicios web y las consultas OData acordados. Cada empresa utiliza ByDesign de forma distinta, y esa experiencia se aplica aquí.
- Su partner de SAP ByDesign puede participar. El partner conoce su tenant, la definición del alcance y sus extensiones, y puede configurar los acuerdos de comunicación junto con el equipo de SkyPlanner.
- Sus propios desarrolladores pueden ampliar la integración mediante la REST API de SkyPlanner, con un token de API en la cabecera
Authorization-Token. El equipo de SkyPlanner les ayuda cuando lo necesitan. Consulte la documentación de integración de SkyPlanner.
SkyPlanner está disponible desde 199 € al mes, con 5 estaciones de trabajo incluidas y facturación mensual. El presupuesto de la integración se presenta por adelantado junto con el de su plan, según sus procesos y necesidades. Consulte los precios, la programación de la producción con SAP ByDesign respetando la capacidad real de máquinas y personal, la página de SAP Business ByDesign y la sección de integraciones con ERP. Otros sistemas SAP cuentan con sus propias guías: SAP Business One y SAP S/4HANA.
Opiniones de fabricantes sobre SkyPlanner
2 hde ahorro cada semana
“Con SkyPlanner hemos pasado de planificar la producción en hojas de cálculo 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 nueva cola de trabajo llega a la línea en segundos.
+90%de eficiencia en la producción
“La eficiencia en la producción ha aumentado un 90%.”
Abdul Rucyinga, director 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.
100%de cumplimiento de plazos de entrega desde 2021
“SkyPlanner nos permite ver la capacidad disponible y hace que la planificación sea predecible.”
Dan Berglund, COO/CFO
Opes Corporation · Fabricación de productos químicos y alimentarios
El cumplimiento de plazos de entrega se ha mantenido en el 100% durante todo el tiempo que llevan utilizando SkyPlanner, desde 2021.
Menosparadas por falta de materiales
“El valor que nos aporta SkyPlanner es que funciona en el día a día, especialmente a la hora de fijar fechas de entrega.”
Tommi Männistö, responsable de planificación de la producción
Eskomatic · Mecanizado por encargo
La programación automática de la carga de trabajo permite fijar fechas de entrega más precisas, y las paradas de producción por falta de materiales se han reducido drásticamente.
Preguntas frecuentes
¿Qué API de SAP ByDesign utiliza SkyPlanner?
Los servicios web A2X publicados por SAP. Para la lectura se utilizan los servicios Query, como Query Production Orders y Query Purchase Orders, o servicios OData personalizados. Para la escritura se utilizan Manage Production Orders y Manage Production Lots.
¿Qué datos escribe SkyPlanner en ByDesign?
EarliestStartPeriod y el MainResourceID de la operación en cada orden de producción. Si así lo decide, también se registran en el lote de producción las cantidades confirmadas, las cantidades de desecho y las tareas finalizadas.
¿ByDesign envía eventos a SkyPlanner?
SkyPlanner consulta los servicios Query de ByDesign cada pocos minutos para obtener las órdenes y los lotes. El propio SkyPlanner envía webhooks con cada cambio en la programación, que activan la escritura de datos en ByDesign.
¿Cómo se autentica SkyPlanner en ByDesign?
Mediante un sistema de comunicación y un acuerdo de comunicación con un usuario técnico, tal como describe la guía de seguridad de SAP. La API de SkyPlanner utiliza un token de API en la cabecera Authorization-Token.
¿Se envían las propuestas de producción a SkyPlanner?
SkyPlanner programa las órdenes de producción liberadas. Las propuestas permanecen en ByDesign Supply Planning hasta que se convierten en órdenes de producción.
¿Quién desarrolla la integración?
El equipo de SkyPlanner la configura durante la puesta en marcha y presta soporte tras la entrada en producción. Su partner de SAP ByDesign o sus propios desarrolladores también pueden ampliarla mediante la REST API de SkyPlanner con un token de API.
