Integraciones / ERP / Acumatica Cloud ERP
Guía de integración de Acumatica para la programación de la producción con SkyPlanner APS
Esta guía de integración de Acumatica explica a partners y equipos de TI cómo conectar Acumatica Cloud ERP (Manufacturing Edition) con SkyPlanner APS. La integración entre SkyPlanner y Acumatica es bidireccional:
- SkyPlanner recibe las órdenes de producción con sus operaciones, centros de trabajo, máquinas, herramientas, turnos, artículos de inventario y pedidos de compra.
- Las fechas de inicio y fin planificadas se escriben en las operaciones de la orden de producción y la orden se marca como firme.
- Los registros de tiempo de los operarios se devuelven como registros de mano de obra y movimientos.
- 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 adapta la integración a la configuración de Acumatica y ofrece soporte tras la entrada en producción. Esta guía está dirigida a partners y desarrolladores que quieran participar o desarrollar sus propias soluciones con la REST API documentada de SkyPlanner (referencia de la API).
Interfaces de integración de Acumatica
La integración utiliza las interfaces que Acumatica ya incluye. No se instala nada en la instancia.
- REST API basada en contratos. Los endpoints tienen versiones que se corresponden con las de Acumatica. El endpoint Manufacturing (por ejemplo, 26.200.001 para 2026 R2) expone
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryyMaterialEntry. El endpoint Default abarcaStockItem,PurchaseOrderySalesOrder. Las URL siguen el formato{instance}/entity/{Endpoint}/{version}/{Entity}. - Acciones en el mismo endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryyReleaseMaterialEntryejecutan la misma lógica que los botones de las pantallas. - OData. Cualquier Generic Inquiry (SM208000) se puede exponer mediante OData. La forma más rápida de realizar una lectura masiva es usar una Generic Inquiry de operaciones de producción abiertas con sus fechas.
- Notificaciones push (SM302000). Se basan en una Generic Inquiry o en una consulta predefinida y envían las filas insertadas y eliminadas a la URL que configure.
- Escenarios de importación y exportación con proveedores de datos CSV y Excel para cargas masivas.
Las entidades y acciones figuran en Web Service Endpoints (SM207000) y en el repositorio del cliente REST de Acumatica.
Autenticación y límites
Acumatica utiliza OAuth 2.0 y OpenID Connect mediante aplicaciones cliente registradas en Connected Applications (SM303010). Los flujos documentados son Authorization Code, Implicit, Resource Owner Password Credentials y Hybrid. Para una integración de servidor, registre un usuario exclusivo para la integración con roles que concedan los permisos mínimos necesarios y utilice Authorization Code con un token de actualización, o Resource Owner Password Credentials.
La licencia determina los límites: License Monitoring Console (SM604000) muestra el número permitido de solicitudes a la API por minuto y de usuarios de la API.
En SkyPlanner, la REST API se autentica con un token de API (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. El tutorial de integración explica paso a paso cómo realizar las primeras llamadas.
Mapeo de datos
| Objeto de Acumatica (endpoint / formulario) | Objeto de SkyPlanner | Dirección | Frecuencia |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Productos y materiales | Acumatica → SkyPlanner | Carga inicial y, después, solo los cambios |
BillOfMaterial (AM208000): materiales, operaciones | Estructura del producto, subproductos, materiales por producto | Acumatica → SkyPlanner | Carga inicial y, después, con cada cambio |
| Operaciones de la BOM: Setup, Run, Machine, Queue, Finish, Move Time | Fases del proceso con sus duraciones y tiempos de preparación y desmontaje | Acumatica → SkyPlanner | Carga inicial y, después, con cada cambio |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Estaciones de trabajo, grupos de estaciones de trabajo, eficiencias y estaciones de trabajo alternativas | Acumatica → SkyPlanner | Carga inicial; rara vez después |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Turnos y capacidad del personal | Acumatica → SkyPlanner | A diario, o gestión de los turnos en SkyPlanner |
Tool (AM205500) | Herramientas como recursos productivos de capacidad limitada | Acumatica → SkyPlanner | Carga inicial |
ProductionOrder con OrderOperationDetail (Planned, Released, In Process) | Órdenes y trabajos con fechas de entrega, prioridad de ejecución y necesidades de materiales | Acumatica → SkyPlanner | Notificación push o consulta cada pocos minutos |
Líneas de PurchaseOrder (Default) | Pedidos de compra con fecha de entrega prevista | Acumatica → SkyPlanner | Consulta cada hora o al ejecutar la programación |
| Cantidades de artículos por almacén | Existencias | Acumatica → SkyPlanner | Consulta cada hora o al ejecutar la programación |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Inicio y fin planificados y estación de trabajo por operación | SkyPlanner → Acumatica | Con cada cambio de programación, mediante un webhook de SkyPlanner |
Acción FirmProductionOrder | Impide que Acumatica APS modifique las fechas escritas | SkyPlanner → Acumatica | Después de cada escritura de datos en Acumatica |
LaborEntry, MoveEntry con acciones de liberación | Registros de tiempo, cantidades terminadas y confirmaciones de los operarios | SkyPlanner → Acumatica | Por confirmación o por turno |
| No disponible en Acumatica | Matriz de tiempos de preparación, operarios identificados por nombre y trabajos con varios operarios | Se gestiona en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lea primero los centros de trabajo, las máquinas, las herramientas, los turnos y los calendarios. Después, lea los artículos de inventario y las listas de materiales. Decida cómo representar un centro de trabajo con varias máquinas: como un grupo de estaciones de trabajo en el que cada máquina sea una estación, o como una sola estación de trabajo. El campo Basis for Capacity de Acumatica indica el criterio que utiliza la planta.
2. Sincronización de órdenes. Lea las órdenes de producción con sus operaciones desde la propia orden, no desde la BOM. Las operaciones se copian a la orden y los planificadores las modifican allí. Configure una suscripción de notificaciones push para una Generic Inquiry de órdenes y operaciones abiertas, o consúltela periódicamente. Lea también las líneas de pedidos de compra abiertos. 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.
3. Escritura de la programación en Acumatica. Para cada operación que el motor haya programado o desplazado, SkyPlanner escribe StartDate y EndDate en OrderOperationDetail, además del centro de trabajo si el trabajo se ha trasladado a uno alternativo. A continuación, llama a FirmProductionOrder. Acumatica: «When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.» (Al programar las órdenes de producción respetando la capacidad real de máquinas y personal, el sistema no reprograma las órdenes de producción fijadas). (fuente)
4. Confirmaciones en planta. Los operarios registran su trabajo con SkyPlanner Mobile Confirmations o Production Timer. Los registros de tiempo se convierten en documentos LaborEntry (tiempo y cantidad terminada por operación) o MoveEntry (solo cantidad), que se liberan con la acción correspondiente. Si en planta ya se registra el avance en Acumatica mediante Labor (AM301000) o Shop Floor Kiosk, los datos de avance fluyen en sentido contrario. Elija un solo canal, nunca ambos.
5. Responsabilidad sobre los datos y reglas para resolver conflictos. Deje estas reglas por escrito antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Artículos de inventario, listas de materiales, cantidades, estado de las órdenes y cálculo de costes | Acumatica |
| Secuencia de operaciones, horas de inicio y fin y asignación de estaciones de trabajo | SkyPlanner |
| Matriz de tiempos de preparación, herramientas, requisitos de operarios y alternativas | SkyPlanner |
| Turnos y ausencias | Un solo sistema, elegido durante la definición del alcance |
| Transacciones de mano de obra y movimientos | Acumatica, a partir de los registros de tiempo de SkyPlanner o mediante introducción de datos en planta |
La principal fuente de conflictos es el propio APS de Acumatica. Rough Cut Planning o APS Maintenance Process pueden recalcular las fechas de las órdenes que SkyPlanner ya ha programado. Al marcar como firme cada orden actualizada, se evita ese conflicto. Excluya también las órdenes programadas de las ejecuciones de APS.
Pasos habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, puede utilizar sus propios datos durante la prueba gratuita de 30 días. Exporte a Excel los centros de trabajo y las órdenes de producción abiertas con sus operaciones desde una Generic Inquiry, impórtelos y valide la programación.
- Correspondencia de datos. Defina la tabla de correspondencias, las reglas sobre qué sistema controla cada dato, las frecuencias de sincronización y el canal para registrar la mano de obra.
- Acceso. Registre la aplicación conectada, cree el usuario y los roles de integración y confirme la versión del endpoint en Web Service Endpoints. Empiece por un entorno de pruebas.
- Carga inicial. Centros de trabajo, máquinas, herramientas, turnos, artículos de inventario y listas de materiales.
- Sincronización de órdenes. Órdenes de producción, operaciones y pedidos de compra mediante notificaciones push o consultas periódicas.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación, operarios específicos, trabajos con varios operarios y alternativas.
- Escritura en Acumatica. Fechas de las operaciones, marcado de órdenes como firmes y registros de mano de obra o movimientos.
- Ejecución en paralelo. Compare las fechas de SkyPlanner con el plan actual y corrija los datos maestros.
- Puesta en producción. Active la escritura en Acumatica cuando los datos coincidan.
Qué tener en cuenta al integrar Acumatica
- Compruebe qué motor APS está activo. Classic y Optimized guardan sus configuraciones por separado y solo puede estar habilitado uno de ellos. Revise Enable/Disable Features (CS100000) antes de la primera escritura en Acumatica.
- Fije la versión del endpoint. La versión forma parte de la URL. Cada actualización del software añade una nueva versión, por lo que debe repetir las pruebas tras cada actualización.
- Actualización de operaciones. Algunos campos de las operaciones son de solo lectura a través de REST, y el estado de la orden también influye. Pruebe la secuencia de escritura en Acumatica con órdenes en estado Released e In Process en un entorno de pruebas.
- Unidades y campos de tiempo. El tiempo de ejecución se expresa por Run Units y el tiempo de máquina, por Machine Units. Los tiempos de cola y de traslado «affect the calculated schedule but do not occupy work center capacity.» (afectan a la programación calculada, pero no ocupan capacidad del centro de trabajo). Realice las conversiones con cuidado al importar.
- Disponibilidad de materiales. Classic APS exige que todos los materiales estén disponibles en su totalidad. SkyPlanner programa según las existencias y las fechas de llegada de los pedidos de compra. Acuerde qué criterio seguirán los planificadores.
- Límites de la API. El número de solicitudes por minuto depende de la licencia. Utilice lecturas incrementales y notificaciones push, no recargas completas.
Quién configura y mantiene la integración con Acumatica
- El equipo de SkyPlanner la configura durante la puesta en marcha y ofrece soporte tras la entrada en producción. Cada planta utiliza Acumatica de forma distinta, y esa experiencia se aplica en la configuración.
- Su partner de Acumatica puede participar. Conoce sus personalizaciones, Generic Inquiries y roles. SkyPlanner proporciona la REST API, la documentación Swagger/OpenAPI y los webhooks.
- Sus propios desarrolladores también pueden desarrollar la integración utilizando la misma REST API y un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner ayuda cuando es necesario. Laboratory & Allied eligió esta vía con SAP Business One: su equipo interno de TI desarrolló la integración en gran medida por su cuenta, con la ayuda de SkyPlanner.
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 sus procesos y necesidades, junto con su plan, para que conozca el coste total antes de empezar. Compare el APS de Acumatica con SkyPlanner en programación de la producción en Acumatica con capacidad real de máquinas y personal, consulte la visión general en la página de Acumatica y descubra otros sistemas en la sección de integraciones con ERP.
Opiniones de fabricantes sobre SkyPlanner
2 hahorradas cada semana
“Con SkyPlanner hemos pasado de planificar la producción en hojas 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 una 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, responsable de TI
Laboratory & Allied · Fabricación farmacéutica
La eficiencia en la producción ha aumentado un 90%, y generar un plan optimizado de tres meses para todas las estaciones de trabajo lleva menos de 30 minutos.
Miles (× 1.000)de órdenes de trabajo programadas automáticamente
“Ahora controlamos la producción de otra manera y conocemos nuestra capacidad a un nivel completamente distinto.”
Hannu Ryynänen, director general
Mamec · Mezcladores industriales, bombas y fabricación de alta tecnología por contrato
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.
99,2%de cumplimiento de plazos de entrega
“SkyPlanner nos ha dado visibilidad para identificar los cuellos de botella y ha aportado claridad a la gestión de la producción.”
Toni Tuori, responsable de producción
Piristeel · Sistemas de seguridad para cubiertas y evacuación de aguas pluviales
El cumplimiento de plazos de entrega ha alcanzado el 99,2% este año, y la programación ahorra hasta cuatro horas de trabajo al día.
Preguntas frecuentes
¿La API de Acumatica incluye órdenes de producción?
Sí. El endpoint Manufacturing de la REST API basada en contratos expone ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool y registros de mano de obra y movimientos, además de acciones como FirmProductionOrder.
¿Quién desarrolla la integración con Acumatica?
El equipo de SkyPlanner configura la integración bidireccional según su configuración de Acumatica durante la puesta en marcha y ofrece soporte tras la entrada en producción. Su partner de Acumatica o sus propios desarrolladores también pueden utilizar la REST API documentada de SkyPlanner para desarrollar la integración; basta con un token de API para empezar.
¿Necesitamos Acumatica APS para esta integración?
No. Acumatica ejecuta su propia programación de la producción con capacidad real de máquinas y personal desde el formulario Rough Cut Planning, y Classic APS planifica con capacidad infinita las órdenes cuya fecha de finalización supera los 120 días (fuente). SkyPlanner genera por sí mismo la programación detallada, respetando la capacidad disponible, a partir de las órdenes de producción, las operaciones, los centros de trabajo, las máquinas y las herramientas. Por tanto, la integración funciona tanto si APS está habilitado como si no; según Acumatica, APS «is subject to licensing» (está sujeto a licencia). Autopilot mantiene la programación actualizada y los operarios registran el trabajo con Mobile Confirmations.
¿Cómo evitamos que Acumatica APS sobrescriba las fechas de SkyPlanner?
SkyPlanner marca cada orden de producción como firme después de escribir las fechas de sus operaciones. La programación de Acumatica que respeta la capacidad disponible no reprograma las órdenes firmes.
¿Puede Acumatica enviar cambios en tiempo real?
Sí. Las notificaciones push (SM302000) de una Generic Inquiry envían las filas modificadas a una URL en cuanto se producen los cambios. Los webhooks de SkyPlanner envían los cambios de programación en sentido contrario.
¿Qué autenticación debe utilizar la integración?
OAuth 2.0 mediante un cliente registrado en Connected Applications (SM303010), con un usuario exclusivo para la integración y roles con los privilegios mínimos necesarios. El flujo para su instancia se confirma durante la definición del alcance.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días permite utilizar hasta 20 estaciones de trabajo e importar archivos Excel o CSV desde una Generic Inquiry de Acumatica, sin necesidad de tarjeta de crédito. Inicie la prueba o hable con el equipo comercial para definir el alcance de la integración.
