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

Oracle ha marcado el rumbo. A partir de 2026.1, las nuevas integraciones deben desarrollarse sobre los servicios web SuiteTalk REST con OAuth 2.0. Desde 2027.1, no se permiten nuevas integraciones con SOAP ni con Token-Based Authentication (TBA). Los endpoints SOAP se desactivan en 2028.2. Cualquier integración para la programación que se inicie hoy debe basarse en REST.

Autenticación

Para un sistema de programación que se comunique de servidor a servidor, utiliza OAuth 2.0 Client Credentials (máquina a máquina). La ruta de administración es Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setup. Sube un certificado público y vincúlalo a una entidad, un rol y el registro de integración. Cada registro de integración admite un máximo de cinco certificados activos.

Crea un rol específico para la integración: permisos de consulta para artículos, revisiones de BOM, rutas de fabricación y centros de trabajo; y permisos de edición para órdenes de fabricación, notificaciones de producción y salidas de materiales. La API REST de SkyPlanner (referencia de la API) utiliza JWT, por lo que el middleware almacena ambas credenciales.

Eventos: no hay un webhook estándar

La documentación de Oracle no describe ningún webhook nativo de salida. El patrón que funciona es un script SuiteScript User Event sobre Work Order (afterSubmit) que pone en cola una llamada saliente mediante N/task o un script Map/Reduce, y realiza la llamada con N/https. Nunca haga llamadas síncronas desde afterSubmit: se ejecutan durante el guardado del usuario, por lo que un endpoint lento retrasa el guardado o hace que falle.

Los eventos de usuario no cubren todas las vías de modificación. Las actualizaciones masivas y las importaciones CSV pueden omitirlos. Combine el script de eventos con una consulta periódica de conciliación en SuiteQL sobre lastmodifieddate para no pasar por alto ningún cambio. En sentido contrario, los webhooks de SkyPlanner activan la escritura de datos en NetSuite, que recibe las nuevas fechas en cuanto cambia el programa.

1. Carga inicial de datos maestros. Lee primero los centros de trabajo y, después, los artículos, las revisiones de BOM y las rutas de fabricación mediante SuiteQL. Las rutas de fabricación hacen referencia a los centros de trabajo, así que el orden importa. Durante la prueba, exporta esos mismos datos a CSV e impórtalos en SkyPlanner. La programación se valida antes de escribir código.

2. Sincronización de órdenes. Importa las órdenes de fabricación con estado Released e In Process. Decide desde el principio si también se incluirán las órdenes con estado Planned. Si las incluyes, trátalas como demanda provisional. Sincroniza los pedidos de compra abiertos en el mismo ciclo para que la programación compruebe cada tarea teniendo en cuenta tanto las existencias como los materiales pendientes de recibir, y no solo las existencias.

3. Escritura del programa en NetSuite. Cuando cambia el programa, un webhook de SkyPlanner envía las nuevas fechas de las operaciones al middleware. El middleware envía PATCH /services/rest/record/v1/manufacturingOperationTask/{id} (referencia de registros de Oracle) con startDate y endDate para cada operación modificada. Otro PATCH sobre la cabecera de workOrder establece Production Start y End Date. Escriba únicamente fechas y, si lo utiliza, un campo personalizado de secuencia. Nunca escriba cantidades ni datos de la BOM de vuelta en NetSuite. Para actualizar muchas operaciones en una sola transacción, un pequeño RESTlet guarda la lista completa de operaciones en una sola llamada. La API de registros sigue siendo la opción predeterminada.

4. Confirmaciones en planta. Los operarios registran su trabajo en SkyPlanner Mobile Confirmations. El middleware envía cada confirmación mediante las transformaciones de Work Order con POST /services/rest/record/v1/workOrder/{id}/!transform/workOrderCompletion, incluyendo startOperation, endOperation, la cantidad completada y el tiempo registrado en las líneas de operación. Las órdenes de fabricación sin WIP se cierran con !transform/assemblyBuild en su lugar. Work Order Completion a través de REST requiere la función Manufacturing Work In Process. La contabilización de inventario y costes sigue realizándose en NetSuite.

5. Idempotencia y reintentos. Cada notificación de producción lleva el ID del registro de tiempo de SkyPlanner como ID externo de NetSuite. Los ID externos son únicos por tipo de registro, de modo que un webhook reenviado se rechaza como duplicado en lugar de contabilizar dos veces las cantidades y los costes. Las escrituras pasan por una cola. Si una llamada falla por un límite de concurrencia, un registro bloqueado o un certificado caducado, se reintenta y queda registrada. El equipo de SkyPlanner que da soporte a la integración puede ver cualquier fallo que persista.

6. Reglas sobre qué sistema controla cada dato. NetSuite determina qué se fabrica: artículo, cantidad, BOM, ruta de fabricación y ubicación. SkyPlanner determina cuándo y dónde: secuencia de operaciones, estación de trabajo, inicio y fin. Las fechas modificadas en NetSuite se sobrescriben en la siguiente escritura de retorno, así que bloquea Production Start/End Date mediante una personalización del formulario o un flujo de trabajo.

• Órdenes de fabricación sin ruta. Una orden de fabricación sin Manufacturing Routing no tiene operaciones que programar. Oracle indica lo mismo sobre su propio sistema de programación de la producción, que tiene en cuenta la capacidad real: «Work orders not associated with a NetSuite routing should not be scheduled.» (No deben programarse órdenes de fabricación que no estén asociadas a una ruta de fabricación de NetSuite). Localízalas con SuiteQL antes de la entrada en producción.
• Los centros de trabajo tienen pocos datos. Un centro de trabajo de NetSuite es un Group con dos campos de cantidad, Machine Resources y Labor Resources (ambos con valor predeterminado 0), y un Work Calendar, normalmente «Default Work Calendar». Carga los centros de trabajo una vez y, después, mantén en SkyPlanner las estaciones de trabajo individuales, los turnos de cada persona, las herramientas, la matriz de tiempos de preparación y las estaciones de trabajo alternativas.
• Calidad de los datos de Setup Time y Run Rate. La programación a capacidad infinita de NetSuite utiliza estos campos, pero, al no tener en cuenta la capacidad, los valores incorrectos pasan inadvertidos. Una programación de la producción que respeta la capacidad real de las máquinas y del personal los pone de manifiesto desde el primer día.
• Con WIP o sin WIP. Con Manufacturing WIP, la producción se contabiliza mediante Work Order Issue, Work Order Completion y Work Order Close. Sin WIP, se utiliza un Assembly Build. La integración registra las notificaciones de producción de los artículos WIP y los ensamblajes del resto, por lo que el modelo de cada artículo forma parte del mapeo.
• Advanced Manufacturing en la misma cuenta. Si la cuenta también utiliza Advanced Manufacturing SuiteApp, sus registros de Manufacturing Work Bench deben coincidir exactamente con la ruta de fabricación: secuencia de operaciones, nombre de la operación y centro de trabajo. Decide qué sistema fija las fechas de las operaciones. Dos sistemas de programación sobre las mismas órdenes de fabricación generan dos planes que compiten entre sí.
• Límites de concurrencia. Los servicios web y las llamadas a RESTlet comparten un único límite de concurrencia de la cuenta, determinado por el nivel de servicio más 10 por cada licencia SuiteCloud Plus. Las consultas periódicas en paralelo, registro a registro, lo alcanzan rápidamente. Utiliza SuiteQL con paginación para las lecturas y pon las escrituras en cola.
• La actualización del entorno de pruebas borra la configuración M2M. Las asociaciones de OAuth 2.0 Client Credentials se eliminan al actualizar el entorno de pruebas y no se copian entre cuentas. Un certificado caducado o revocado detiene la sincronización hasta que se crea una nueva asociación. Configura alertas para los fallos de autenticación.