Guía de integración de SAP S/4HANA para la programación de la producción con SkyPlanner APS

S/4HANA ofrece sus interfaces de integración mediante servicios OData publicados que figuran en SAP Business Accelerator Hub (api.sap.com). La integración para la programación utiliza servicios OData V2. Los IDocs y las BAPI siguen existiendo, pero esta guía utiliza las API OData publicadas.

Autenticación según la edición

• Instalaciones locales y Private Edition. Los servicios se activan en SAP Gateway con la transacción /IWFND/MAINT_SERVICE. El usuario de integración necesita los objetos de autorización correspondientes: por ejemplo, C_AFRU_AWK para las notificaciones, C_AFKO_AWK para las posiciones de movimientos de mercancías contabilizadas con ellas y M_PLAF_ORG para las órdenes previsionales.
• Public Edition. Los servicios solo se exponen mediante acuerdos de comunicación. Siguiendo la configuración de comunicación entrante de SAP, se crean un usuario de comunicación, un sistema de comunicación y un acuerdo de comunicación en la aplicación Communication Arrangements, a partir de un escenario de comunicación de SAP (SAP_COM_xxxx). El escenario define qué servicios se exponen y qué métodos de autenticación están disponibles:

– basada en tokens: flujos bearer de OAuth, SAML u OpenID Connect, con propagación de identidad a un usuario de negocio – certificado de cliente – autenticación básica con un usuario técnico de comunicación

SAP recomienda la autenticación mediante tokens o certificados.

Por su parte, SkyPlanner ofrece una API REST con autenticación JWT, documentada en Swagger/OpenAPI (referencia de la API). Así, el middleware gestiona la autenticación de SAP en un extremo y un JWT en el otro.

API para la programación de la producción

Servicio	Entidades y acciones utilizadas	Finalidad
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2; acciones ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Órdenes, operaciones, componentes, PRT, estado y envío de la programación a SAP
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Centros de trabajo, clases de capacidad, intervalos y turnos
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Rutas de fabricación estándar para planificar antes de crear las órdenes
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Estructura de producto multinivel
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiales (denominados Product en la API). SAP recomienda ahora la API Product (Version 2) para la mayoría de las entidades de producto
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Resultados de MRP Live antes de la conversión
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Existencias por centro y almacén para determinar la disponibilidad de materiales
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Pedidos de compra pendientes de materiales por recibir
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; acciones GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Notificaciones y movimientos de mercancías desde la planta

En la API de órdenes de producción, las operaciones se identifican mediante la combinación de OrderInternalBillOfOperations y OrderIntBillOfOperationsItem, no por el número de operación que ve el planificador. En la API de notificaciones, GetConfProposal identifica esa misma operación mediante OrderID y OrderOperation. Guarde las claves internas y el número de operación en SkyPlanner desde la primera carga.

Eventos

S/4HANA genera los eventos de negocio Production Order Created y Production Order Changed con ManufacturingOrder, ProductionOrder, ProductionOrderType y ProductionPlant en el contenido del mensaje. Este solo incluye claves, por lo que la integración vuelve a leer la orden y sus operaciones. El evento Changed se dispara con cada cambio en la orden; aplique un mecanismo de debounce para agrupar los eventos consecutivos. En sentido contrario, los webhooks de SkyPlanner envían notificaciones en tiempo real cuando cambia la programación o el estado de una tarea.

Primeros pasos con archivos

Para la prueba, exporte las órdenes de producción y los centros de trabajo de los informes de listas de S/4HANA a Excel o CSV e impórtelos en SkyPlanner. Así podrá validar la programación antes de modificar Gateway o los acuerdos de comunicación.

1. Carga de datos maestros. Cargue los materiales, las BOM, los centros de trabajo con sus intervalos de capacidad y turnos, y las rutas de fabricación. Decida en este punto qué sistema gestionará los turnos. Un reparto que funciona: el calendario de fábrica permanece en S/4HANA, mientras que los patrones detallados de turnos, las ausencias y las horas extra se gestionan en SkyPlanner, donde los planificadores los modifican a diario.

2. Sincronización de órdenes. Suscríbase a Production Order Created/Changed o, si no se han configurado eventos de negocio, consulte periódicamente A_ProductionOrder_2 por la marca de tiempo de modificación. Filtre por centro, tipo de orden y estado. Envíe las órdenes al crearlas para que SkyPlanner pueda planificar con antelación y libérelas en S/4HANA (ReleaseOrder o ReleaseOperation) una vez que SkyPlanner las haya programado.

3. Envío de la programación a SAP. Cuando un webhook de SkyPlanner notifica un cambio en la programación, la integración llama a ScheduleProductionOrderOperation en API_PRODUCTION_ORDER_2_SRV para cada operación modificada. Envía:

• ManufacturingOrder, OrderInternalBillOfOperations y OrderIntBillOfOperationsItem como claves
• OpSchedulingMode con el valor F (hacia adelante), con la fecha y hora de inicio de SkyPlanner en OpSchedldStartDate y OpSchedldStartTime
• OpSchedulingStatus con el valor DISP (despacho) y el campo obligatorio OpSchedulingStrategy con el valor M
• el ETag en if-match

Todas las operaciones de una orden se incluyen en un único conjunto de cambios, siguiendo la secuencia de SkyPlanner, para que S/4HANA asigne la programación completa de la orden en una sola llamada. Nunca se utiliza el modo K: conserva las fechas originales de las operaciones e ignora las fechas enviadas.

SkyPlanner calcula la duración de las operaciones a partir de los mismos valores estándar de las rutas de fabricación y las mismas fórmulas de capacidad de los centros de trabajo que utiliza S/4HANA. Por eso, la fecha de fin que S/4HANA calcula a partir del inicio asignado coincide con la programación de SkyPlanner. Tras cada conjunto de cambios, la integración vuelve a leer las operaciones y señala cualquier fecha que difiera, de modo que el planificador la vea antes del siguiente turno.

4. Notificaciones desde la planta. Cada registro de tiempo de Mobile Confirmations o Production Timer se convierte en una notificación de S/4HANA. El webhook de SkyPlanner desencadena el envío de un ProdnOrdConf2 con la cantidad buena, el rechazo y los tiempos de actividad. La integración llama primero a GetConfProposal para que S/4HANA proponga cantidades, actividades, fechas y datos de personal. GetGdsMvtProposal propone los movimientos de mercancías.

Material pendiente de recepción. Los pedidos de compra pendientes forman parte de la sincronización de entrada. SkyPlanner considera que el material pedido estará disponible en la fecha de entrega prevista del pedido de compra. Los trabajos que esperan componentes comprados se programan para el día en que llega el material; no quedan bloqueados por las existencias actuales.

S/4HANA sigue siendo el sistema de referencia para las recepciones: al contabilizar una entrada de mercancías, aumentan las existencias y disminuye la cantidad pendiente de la posición del pedido de compra. La siguiente sincronización actualiza las existencias en SkyPlanner y marca como Delivered los pedidos recibidos en su totalidad; tras una recepción parcial, la cantidad pendiente restante se mantiene como entrada prevista en la fecha de su reparto. La gestión de pedidos de compra de SkyPlanner se describe en la documentación de SkyPlanner.

5. Reglas de responsabilidad sobre los datos. S/4HANA gestiona las cantidades, la BOM, la ruta de fabricación, el cálculo de costes y el estado. SkyPlanner gestiona la secuencia, la asignación a estaciones de trabajo y las fechas de las operaciones. Nunca permita que ambos escriban en el mismo campo. Si los planificadores siguen moviendo operaciones en Capacity Scheduling Board, decida qué cambio prevalece. O bien la siguiente sincronización de órdenes incorpora ese cambio a SkyPlanner, o bien ese centro de trabajo queda fuera del alcance de SkyPlanner.

• El envío de la programación se hace mediante una llamada a una acción con un ETag. La forma documentada de programar una operación es ScheduleProductionOrderOperation, no un PATCH sobre A_ProductionOrderOperation_2. El modo F programa hacia adelante desde una fecha de inicio y B hacia atrás desde una fecha de fin, mientras que K y S conservan las fechas existentes e ignoran las que se envían. El ETag de if-match se construye a partir de LastChangeDateTime de la orden (YYYYMMDDHHMMSS), por lo que cualquier cambio en ella lo deja obsoleto. Implemente una lectura previa a la escritura y una cola de reintentos.
• La capacidad no está en la cabecera del centro de trabajo. La capacidad disponible se obtiene de la clase de capacidad (001 máquina, 002 mano de obra), del calendario de fábrica y de los intervalos y turnos que prevalecen sobre él. Las fórmulas de capacidad convierten los valores estándar de la ruta de fabricación en necesidades de preparación, procesamiento y desmontaje. Lea A_WorkCenterCapacityInterval_2 y las entidades de turnos, y acuerde cómo se convertirán las fórmulas en duraciones en SkyPlanner.
• Hay que depurar los valores estándar. Las rutas de fabricación mantenidas para el cálculo de costes suelen contener tiempos de preparación promediados o preparaciones imputadas a una categoría de capacidad incorrecta.
• Las reglas de notificación son estrictas. SAP recomienda llamadas por lotes para los registros masivos. Cada conjunto de cambios se procesa por completo o no se procesa: un solo parte de tiempos incorrecto bloquea el resto del conjunto. Las anulaciones de un lote deben ejecutarse en orden inverso de ConfirmationCount. No se pueden mezclar tipos de notificación en una misma orden, contabilizar movimientos de mercancías sin una notificación ni notificar operaciones cuyos puntos de activación requieran un cuadro de diálogo.
• Compruebe si PP/DS está activo. PP/DS integrado requiere la actividad de Customizing Activate Advanced Planning and Scheduling y SAP HANA integrated liveCache. SAP lo vende como producto independiente: SAP S/4HANA Manufacturing for planning and scheduling. Si está activo, decida qué sistema programa cada material: los materiales marcados para planificación avanzada corresponden a PP/DS. SAP también indica lo siguiente sobre la API de órdenes previsionales: «Automatic integration to PP/DS is not enabled from this API.» (La integración automática no está habilitada desde esta API).
• Unidades de medida. Las cantidades de las operaciones, las cantidades base de las rutas de fabricación y las unidades de notificación pueden diferir. Haga la conversión explícitamente utilizando la unidad de la operación, no la unidad base del material.
• Diferencias entre ediciones. SAP Learning muestra cómo Manage Work Center Capacity, Capacity Scheduling Table y Capacity Scheduling Board sustituyen a la tabla de planificación clásica CM21/CM22. Public Edition solo ofrece API a través de escenarios de comunicación, y las versiones de los servicios disponibles pueden diferir de las de una instalación local. La API de rutas de fabricación no permite eliminar rutas ni actualizar asignaciones de materiales. Durante la definición del alcance, el equipo de SkyPlanner fija las versiones de los servicios para el sistema de cada cliente basándose en la entrada de API Business Accelerator Hub correspondiente a esa versión.
• Restricciones que no recogen las rutas de fabricación. Gestione en SkyPlanner los cambios de formato dependientes de la secuencia, los conflictos de herramientas y las operaciones con varios operarios, no en los valores estándar de las rutas de fabricación. La matriz de tiempos de preparación recoge los tiempos de cambio de formato para cada par de productos. Las herramientas de los PRT de la orden son recursos limitados que solo pueden utilizarse en una estación de trabajo a la vez, y una operación puede requerir varias personas simultáneamente.