Integraciones / ERP / Exact
Guía de integración de Exact Online para la programación de la producción con SkyPlanner APS
Esta guía de integración de Exact Online explica a los partners de Exact y a los equipos de TI cómo conectar Exact Online Manufacturing con SkyPlanner APS. La integración entre SkyPlanner y Exact Online es bidireccional:
- Las órdenes de fabricación, las etapas de las rutas de fabricación, los planes de materiales, los centros de trabajo, las operaciones y las listas de materiales se importan a través de la REST API de Exact Online.
- Se importan los artículos, los niveles de existencias, los pedidos de compra y los pedidos de venta, con webhooks de Exact Online para notificar los cambios.
- Las fechas de inicio y fin planificadas se devuelven a cada etapa de la ruta de fabricación y a la orden de fabricación.
- Los registros de tiempo de los operarios se contabilizan como transacciones de tiempo, y las cantidades terminadas, como recepciones de órdenes de fabricación.
El equipo de SkyPlanner configura la integración según tu entorno de Exact Online durante la puesta en marcha y ofrece soporte tras la entrada en producción. Esta guía está dirigida a partners y desarrolladores que quieran participar o desarrollar por su cuenta sobre la REST API documentada de SkyPlanner (referencia de la API). Al final se incluye una breve sección sobre Exact Globe+.
La REST API de Exact Online para fabricación
Exact Online permite acceder a sus datos mediante una única REST API, con los recursos agrupados por servicio. La ruta base es /api/v1/{division}/<service>/<resource>, donde la división corresponde a la empresa en Exact Online. La referencia de la REST API enumera estos recursos del servicio de fabricación para la programación:
| Recurso | Contenido | Métodos |
|---|---|---|
manufacturing/ShopOrders | Número de orden de fabricación, artículo, PlannedQuantity, PlannedStartDate, PlannedDate, estado, indicador de liberación | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Etapa de la ruta de fabricación por orden de fabricación: operación, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Líneas de materiales por orden de fabricación | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Código, tipo, área de producción, valor de capacidad, tarifas | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operaciones y centro de trabajo en el que se ejecuta cada una, tiempos de preparación y ejecución | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versiones de la lista de materiales, componentes y ruta de fabricación | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Horas registradas por orden de fabricación y etapa de la ruta de fabricación | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Cantidades terminadas recibidas de una orden de fabricación | GET, POST |
manufacturing/MaterialIssues | Material entregado a una orden de fabricación | GET, POST |
manufacturing/ShopOrderPriorities | Modo de prioridad por orden de fabricación | GET, PUT |
Recursos de los demás servicios:
| Recurso | Contenido |
|---|---|
logistics/Items | Maestro de artículos |
inventory/ItemWarehouses | Existencias por artículo y almacén |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Pedidos de compra abiertos y fechas de recepción |
salesorder/SalesOrders, SalesOrderLines | Demanda de los clientes y fechas de entrega |
Autenticación y acceso
Exact Online utiliza OAuth 2.0 con el flujo de código de autorización y tokens de actualización. Exact indica: «Before you can start integration with Exact Online, you must first register your app in the App Store.» (Antes de iniciar la integración con Exact Online, debes registrar tu aplicación en App Store). (Ayuda de Exact Online) Para registrar aplicaciones se necesita una suscripción a Exact Online Developer (Exact App Store).
- La integración se registra como una aplicación con una URI de redirección.
- Un usuario de Exact Online con acceso a fabricación, inventario y compras otorga su consentimiento una sola vez.
- Cada solicitud envía
Authorization: Bearer <access_token>y la división en la ruta. - Los tokens de acceso se renuevan con el token de actualización. Exact limita la frecuencia con la que se puede solicitar un nuevo token, así que guarda el token en caché hasta que caduque.
Exact también limita las llamadas por minuto y por día para cada aplicación y empresa, y pide que se realicen de forma secuencial, no en paralelo. Los límites vigentes se recogen en el artículo de Exact sobre los límites de la API. La integración está diseñada para respetarlos: lecturas filtradas con $filter y $select, y Sync API para cambios masivos.
En SkyPlanner, la REST API se autentica con un token de API en la cabecera Authorization-Token (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. El tutorial de integración explica paso a paso las primeras llamadas.
Webhooks y consultas periódicas
Los webhooks de Exact Online envían una solicitud POST a tu URL de callback cuando cambia un tema al que te has suscrito; la solicitud va firmada con un hash HMAC SHA256 (webhooks). Entre los temas figuran Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders y SalesOrderLines. Estos envían a SkyPlanner los cambios en existencias, compras y demanda en cuanto se producen.
Las órdenes de fabricación y las etapas de sus rutas se leen a intervalos programados. Filtra ShopOrders y ShopOrderRoutingStepPlans por Modified y utiliza Sync API para las lecturas masivas (restricciones de la API).
SkyPlanner envía sus propios webhooks cuando cambia la programación, por lo que la escritura de datos de vuelta a Exact Online se activa mediante eventos.
Correspondencia de datos
| Recurso de Exact Online | Objeto de SkyPlanner | Dirección | Frecuencia |
|---|---|---|---|
Items | Productos y materiales | Exact Online → SkyPlanner | Carga inicial y después mediante webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Estructura del producto, subproductos, materiales por producto | Exact Online → SkyPlanner | Cuando hay cambios |
Workcenters, OperationResources | Estaciones de trabajo y grupos de estaciones de trabajo | Exact Online → SkyPlanner | Carga inicial |
Operations, BillOfMaterialRoutings | Etapas del proceso con tiempos de preparación y ejecución | Exact Online → SkyPlanner | Cuando hay cambios |
ShopOrders | Órdenes con cantidad y fecha de entrega | Exact Online → SkyPlanner | Cada pocos minutos |
ShopOrderRoutingStepPlans | Tareas con secuencia, centro de trabajo y horas de preparación y ejecución | Exact Online → SkyPlanner | Cada pocos minutos |
ShopOrderMaterialPlans | Materiales por tarea | Exact Online → SkyPlanner | Cada pocos minutos |
ItemWarehouses, StockPosition | Saldos de existencias | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Pedidos de compra con fecha de entrega prevista | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Fechas de entrega al cliente y prioridad | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Inicio, fin y estación de trabajo previstos para cada operación | SkyPlanner → Exact Online | Con cada cambio, mediante webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Inicio y fin de la orden | SkyPlanner → Exact Online | Con cada cambio, mediante webhook |
TimeTransactions (POST) | Registros de tiempo y confirmaciones de los operarios | SkyPlanner → Exact Online | Por confirmación o por turno |
ShopOrderReceipts (POST) | Cantidad terminada en la última operación | SkyPlanner → Exact Online | Por confirmación |
| No se almacena en Exact Online | Matriz de tiempos de preparación, herramientas como recursos de capacidad limitada, operarios por tarea, estaciones de trabajo alternativas y turnos | Se gestiona en SkyPlanner | Puesta en marcha |
Esquemas de integración
1. Carga inicial de datos maestros. Lee Workcenters, Operations y OperationResources y, después, los artículos y las versiones de las BOM con sus rutas de fabricación. Un centro de trabajo con tres máquinas se convierte en tres estaciones de trabajo o en un grupo de estaciones de trabajo. Los turnos, las ausencias y las horas extra se configuran en SkyPlanner, ya que cada centro de trabajo de Exact tiene un único valor de capacidad.
2. Sincronización de órdenes. Lee los registros abiertos de ShopOrders con sus ShopOrderRoutingStepPlans y ShopOrderMaterialPlans, además de las existencias y las líneas de los pedidos de compra. La programación comprueba tanto las existencias como las compras pendientes de recibir. MRP sigue generando propuestas de órdenes y pedidos en Exact Online, y SkyPlanner programa las órdenes de fabricación que creas.
3. Escritura de la programación en Exact Online. Por cada operación de la ruta de fabricación que el motor haya programado o movido, SkyPlanner envía un PUT a ShopOrderRoutingStepPlans con PlannedStartDate, PlannedEndDate y Workcenter. Los campos PlannedStartDate y PlannedDate de la orden de fabricación se ajustan a la primera y la última operación. Exact Online sigue gestionando las cantidades, los planes de materiales y el cálculo de costes.
4. Confirmaciones en planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations o Production Timer, y estos registros de tiempo mantienen actualizada la programación. Las horas registradas se envían como TimeTransactions, asociadas a la orden de fabricación y a la operación de la ruta, ya sean de preparación o de ejecución. La confirmación final genera un registro de ShopOrderReceipts con la cantidad terminada. Si tu planta ya registra los tiempos en Shop Floor Control, elige un único canal de registro.
5. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjalas por escrito antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Artículos, BOM, cantidades de las órdenes de fabricación, planes de materiales y costes | Exact Online |
| Secuencia de operaciones de la ruta de fabricación, horas de inicio y fin y asignación del centro de trabajo | SkyPlanner |
| Matriz de tiempos de preparación, herramientas, operarios por tarea, recursos productivos alternativos y turnos | SkyPlanner |
| Registros de tiempo y entradas de producto terminado | Exact Online, con datos de SkyPlanner |
La principal fuente de conflictos son los cambios manuales de fechas. Si los planificadores siguen cambiando las fechas de las órdenes de fabricación en Exact Online, habrá dos sistemas gestionándolas. Deja que SkyPlanner gestione las fechas de las operaciones de la ruta de fabricación. Con Autopilot, SkyPlanner reprograma automáticamente cuando hay cambios en la producción.
Pasos habituales del proyecto
La implementación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, valida la programación durante la prueba gratuita de 30 días con una exportación en CSV o Excel de las órdenes de fabricación abiertas y las operaciones de sus rutas. Después, el proyecto sigue estos pasos:
- Definición del alcance. Confirma la edición, las divisiones, las frecuencias de sincronización, el canal de registro de tiempos y el registro de entradas de producto terminado.
- Aplicación y consentimiento. Registra la aplicación; después, un usuario de Exact Online otorga el consentimiento OAuth para cada división.
- Carga inicial. Centros de trabajo, operaciones, artículos, versiones de las BOM y rutas de fabricación.
- Sincronización de órdenes. Órdenes de fabricación, planes de operaciones y planes de materiales a intervalos programados; existencias y compras mediante webhook.
- Configuración de restricciones en SkyPlanner. Turnos, matriz de tiempos de preparación, herramientas, número de operarios por tarea y máquinas o personal alternativos.
- Escritura de la programación en Exact Online. Envío de las fechas previstas de las operaciones de la ruta de fabricación a Exact Online y, después, de los registros de tiempo y las entradas de producto terminado.
- Pruebas en paralelo y entrada en producción. Compara las fechas con el plan actual, corrige los datos maestros y, después, activa la escritura en Exact Online.
Qué debes prever al integrar Exact Online
- Tiempos de las operaciones de la ruta de fabricación.
PlannedSetupHoursyPlannedRunHoursproceden de la ruta de fabricación de la BOM. Contrástalos primero con los tiempos reales de ejecución. - Agrupación de centros de trabajo. Exact almacena un único valor de capacidad por centro de trabajo. Decide si cada centro se convierte en una estación de trabajo, en varias o en un grupo.
- Calendarios. Los turnos, los festivos y las ausencias se gestionan en SkyPlanner. Configúralos antes de generar la primera programación.
- Límite de llamadas. Exact limita las llamadas por aplicación y empresa y requiere que se realicen de forma secuencial. Usa webhooks cuando existan temas disponibles,
$filtersobreModifiedy Sync API para las lecturas masivas. - Varias divisiones. Cada división de Exact Online es una empresa con su propia ruta y su propio consentimiento. Asocia cada planta a su división.
- Órdenes de fabricación liberadas. Acuerda en qué estados puede SkyPlanner cambiar las fechas: en órdenes abiertas y liberadas, o solo en órdenes abiertas.
- Un único responsable de las fechas. Deja de modificar manualmente las fechas en Exact Online cuando SkyPlanner pase a gestionar las fechas de las operaciones de la ruta de fabricación.
Exact Globe+
Exact Globe+ es el ERP de Exact que se comercializa e implementa a través de los partners de Exact Globe+. Exact afirma que «koppelt eenvoudig en snel met andere systemen» (se conecta de forma sencilla y rápida con otros sistemas) (Exact Globe+). SkyPlanner programa las órdenes de producción de Exact Globe+ del mismo modo: recibe órdenes de producción, rutas de fabricación, recursos productivos y existencias, y devuelve las fechas previstas y las horas registradas. Durante la definición del alcance, tu partner de Exact Globe+ y el equipo de SkyPlanner acuerdan la interfaz y los objetos en los que se escribirán los datos.
Integración con Exact Online: quién la configura y da soporte
- El equipo de SkyPlanner la configura durante la puesta en marcha y ofrece soporte tras la entrada en producción.
- Tu partner de Exact puede participar. Conoce tus ediciones, divisiones y configuración de fabricación.
- Tus propios desarrolladores pueden ampliarla mediante la REST API documentada de SkyPlanner. Basta con un token de API para empezar, y el equipo de SkyPlanner presta ayuda cuando hace falta.
Una vez establecida la conexión, el motor Arcturus programa a partir de las órdenes de fabricación actualizadas de Exact Online, y cada operación de la ruta recibe sus fechas previstas. SkyPlanner está disponible desde 199 € al mes, con 5 estaciones de trabajo incluidas y facturación mensual. La integración se presupuesta de antemano según tus procesos y necesidades, junto con tu plan, para que conozcas el coste total antes de empezar. Consulta los precios, las funciones y la comparativa con la planificación propia de Exact Online en programación de la producción en Exact Online respetando la capacidad real de máquinas y personal. Encontrarás una visión general en la página de Exact Online y otros ERP en la sección de integraciones con ERP.
Opiniones de fabricantes sobre SkyPlanner
Menos paradas por falta de materiales
“El valor que nos aporta SkyPlanner es que funciona en el día a día, especialmente para 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.
1.000 y más órdenes de trabajo programadas automáticamente
“Ahora controlamos la producción de otra manera, y nuestro conocimiento de la capacidad está a un nivel completamente distinto.”
Hannu Ryynänen, director general
Mamec · Mezcladores industriales, bombas y fabricación de alta tecnología por encargo
Miles de órdenes de trabajo se programan automáticamente, y toda la organización dispone de una visión de la producción en tiempo real.
Preguntas frecuentes
¿La API de Exact Online incluye órdenes de fabricación y operaciones de las rutas de fabricación?
Sí. El servicio de fabricación incluye ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations y recursos de listas de materiales (BOM), todos con acceso de lectura y escritura. Los tiempos se registran a través de TimeTransactions y las cantidades terminadas, a través de ShopOrderReceipts.
¿Cómo se actualizan las fechas planificadas en Exact Online?
SkyPlanner envía una solicitud PUT a ShopOrderRoutingStepPlans con PlannedStartDate, PlannedEndDate y Workcenter para cada operación que programa o desplaza. Los campos PlannedStartDate y PlannedDate de la orden de fabricación se actualizan en consonancia.
¿Quién desarrolla la integración con Exact Online?
El equipo de SkyPlanner configura la integración bidireccional según tu configuración de Exact Online durante la puesta en marcha y ofrece soporte tras la entrada en producción. Tu partner de Exact puede participar. Tus propios desarrolladores también pueden crear la integración con la REST API documentada de SkyPlanner; basta con un token de API para empezar.
¿Puede Exact Online enviar cambios en tiempo real?
Los webhooks de Exact Online envían los cambios en artículos, existencias, pedidos de compra y pedidos de venta. Las órdenes de fabricación y las operaciones de las rutas de fabricación se consultan a intervalos cortos mediante solicitudes filtradas. En sentido contrario, los webhooks de SkyPlanner envían los cambios en la programación en cuanto se producen.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días admite hasta 20 estaciones de trabajo y permite importar tus órdenes de fabricación desde CSV o Excel, sin necesidad de tarjeta de crédito. Empieza la prueba o habla con ventas para definir el alcance de la integración.