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

La integración utiliza dos interfaces que Business Central ya incluye:

1. API v2.0 para los datos comerciales y de inventario. Expone items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers y employees. No incluye entidades de fabricación, por lo que los datos de producción se obtienen a través de la segunda interfaz.
2. Servicios web OData v4 para fabricación. Cualquier página de Business Central se puede publicar como servicio web OData v4 desde la página Web Services. Selecciona Page como tipo de objeto, el ID de la página y un nombre de servicio; después, selecciona Published. El endpoint queda operativo sin código AL ni extensiones que desplegar. La integración publica las páginas estándar de órdenes de producción lanzadas, Prod. Order Routing Lines, centros de trabajo, centros de máquina y rutas de fabricación, disponibles en /ODataV4/Company('{name}')/{ServiceName}.

Las páginas publicadas permiten leer y escribir datos. Microsoft indica: «If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,» (si una página editable se expone como servicio web, una llamada OData permite acceder a los datos de la tabla subyacente y modificarlos), con PATCH para las actualizaciones. Así se devuelven las fechas programadas a Business Central, a través de la misma página y con las mismas validaciones que utiliza el planificador.

No utilices SOAP. Microsoft ha declarado obsoletos los servicios web SOAP, y la publicación de páginas de la interfaz de Microsoft como SOAP se elimina en la oleada 2 de versiones de 2026 (v29).

Business Central admite suscripciones a webhooks mediante POST /api/v2.0/subscriptions para entidades de API v2.0 como items y salesOrders. Se aplican estas reglas:

• Crear una suscripción requiere un intercambio de validación: tu endpoint debe devolver el validationToken con 200 OK.
• Las suscripciones caducan a los tres días. Renuévalas con PATCH; se repetirá el intercambio de validación.
• Las notificaciones incluyen la ruta del recurso, changeType y tu clientState, no el registro completo. El registro se consulta después.
• Las notificaciones llegan con retraso: Business Central online espera 30 segundos tras el primer cambio. Si se modifican más de 1.000 registros en ese intervalo, se envía una única notificación de tipo collection.
• Máximo de 200 suscripciones a webhooks por entorno online.

Las órdenes de producción, las líneas de ruta de fabricación y los pedidos de compra se consultan cada pocos minutos en las páginas publicadas y en purchaseOrders. Al filtrar solo los pedidos y las órdenes abiertos y paginar los resultados, el número de solicitudes se mantiene muy por debajo de los límites de Business Central.

SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la escritura de datos en Business Central se basa en eventos.

1. Carga inicial de datos maestros. Obtén de las páginas publicadas las rutas de fabricación y las listas de materiales de producción (BOM) con estado Certified, así como los centros de trabajo y de máquina. Obtén los artículos y las unidades de medida de API v2.0. Define con criterio la correspondencia de cada centro de trabajo o de máquina con una estación de trabajo de SkyPlanner: decide si un centro de trabajo con tres centros de máquina se convierte en un grupo de estaciones de trabajo o en tres estaciones de trabajo.

2. Sincronización de órdenes. Lee de las páginas publicadas las órdenes de producción con estado Released (y Firm Planned, si las programas), junto con sus líneas de ruta y componentes, y de API v2.0 las líneas abiertas de pedidos de compra. SkyPlanner considera que el material pedido estará 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.

Nunca programes órdenes de producción con estado Planned: Microsoft indica que Business Central «deletes them the next time you run planning.» (las elimina la próxima vez que se ejecuta la planificación). Planning Worksheet sigue proponiendo el aprovisionamiento, y SkyPlanner programa las órdenes en firme según la capacidad real.

3. Escritura de la programación en Business Central. La página estándar Prod. Order Routing se publica como servicio web OData v4. Por cada operación que el motor haya programado o desplazado, SkyPlanner envía un PATCH a la línea de ruta correspondiente con el ETag If-Match. Establece Starting Date-Time y Ending Date-Time, además de Type y No. si la operación se ha trasladado a una máquina alternativa.

PATCH ejecuta los desencadenadores de la página y de la tabla, por lo que Business Central valida los campos con su propia lógica, exactamente igual que cuando un planificador edita la página Prod. Order Routing. Los campos Starting Date-Time y Ending Date-Time de la línea de la orden de producción se actualizan en consecuencia. Business Central mantiene el control de las cantidades, el estado y los costes.

4. Confirmaciones en planta. Los operarios registran su trabajo con SkyPlanner Mobile Confirmations o Production Timer, y esos registros de tiempo mantienen actualizada la programación. La producción se puede seguir declarando en Business Central como hasta ahora, desde Production Journal u Output Journal.

Si quieres que la producción y el consumo se registren de forma totalmente automática, se añade una página API estándar de Business Central para registrar los movimientos de Output Journal. SkyPlanner registra entonces el tiempo de preparación, el tiempo de ejecución y la cantidad producida por operación. El registro actualiza Capacity Ledger Entries, y la producción de la última operación de la ruta incorpora el artículo al inventario.

Elige un único canal para registrar la producción. Si la registras tanto desde SkyPlanner como desde Production Journal de Business Central, se duplican los movimientos.

5. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjalas por escrito antes de la entrada en producción:

La principal fuente de conflictos son las acciones Refresh y Replan en las órdenes de producción. Microsoft indica: «If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.» (si utilizas la acción Refresh para recalcular las líneas de una orden de producción, Business Central elimina las líneas existentes y calcula otras nuevas). Replan también puede cambiar las necesidades de capacidad, y recalcular los componentes «deletes previous changes in the components.» (elimina los cambios previos en los componentes).

Trata una orden actualizada con Refresh como una nueva versión, vuelve a sincronizarla y deja que SkyPlanner la reprograme. Con Autopilot, SkyPlanner reprograma automáticamente cuando cambia la producción.

• Unidades en las rutas de fabricación. Setup Time se aplica por orden de producción y Run Time por artículo producido; cada uno tiene su propio Unit of Measure Code. Wait Time y Move Time no consumen capacidad del centro de trabajo. Si la unidad del centro de trabajo es Days, un día equivale a 24 horas, no a un turno de ocho horas. Convierte las unidades al importar; de lo contrario, todas las duraciones serán incorrectas.
• Calendarios desactualizados. Solo hay capacidad disponible después de ejecutar Calculate Work Center Calendar para el horizonte de planificación. Comprueba el campo Calendar Entries Available Until antes de la carga inicial.
• Capacidad de los centros de máquina oculta. Con Consolidated Calendar desactivado, solo se planifica la capacidad propia del centro de trabajo: «The machine center capacity is excluded.» (se excluye la capacidad del centro de máquina). Lee directamente la capacidad de los centros de máquina en lugar de confiar en los totales del centro de trabajo.
• Capacity y Efficiency. Business Central calcula la duración como Run Time / Efficiency / Capacity, y las entradas de calendario calculadas ya incluyen ambos factores. Aplica Efficiency a la eficiencia de la estación de trabajo de SkyPlanner una sola vez, no dos.
• Alternate Work Center es solo informativo. Según Microsoft, «isn’t automatically included in planning processes.» (no se incluye automáticamente en los procesos de planificación). Define explícitamente las alternativas como estaciones de trabajo alternativas en SkyPlanner.
• Límites de solicitudes. Los límites de la versión online se aplican por usuario, y una entidad de servicio cuenta como un usuario: 6.000 solicitudes OData en una ventana móvil de 5 minutos y 5 solicitudes simultáneas. El tamaño máximo de página es de 20.000 registros, cada $batch admite hasta 100 operaciones y las operaciones agotan el tiempo de espera a los 8 minutos. Si se supera el límite de solicitudes, se devuelve 429. Agrupa las solicitudes en lotes, pagina los resultados y consulta solo los cambios en lugar de realizar recargas completas.
• Licencias. Las funciones de fabricación solo están disponibles en la experiencia Premium. Los usuarios de Essentials no pueden iniciar sesión en una empresa configurada como Premium.