Integraciones / ERP / Lemonsoft
Guía de integración de Lemonsoft para programar la producción con SkyPlanner APS
Esta guía de integración de Lemonsoft explica a los partners y equipos de TI cómo conectar Lemonsoft ERP con SkyPlanner APS. SkyPlanner se integra con Lemonsoft en ambos sentidos a través de la REST API de Lemonsoft:
- Se importan los números de trabajo (työnumero), las fases de trabajo (työvaihe), las máquinas, las estructuras de producto, los materiales y los turnos planificados.
- Las horas de inicio y fin planificadas y la máquina elegida se devuelven a las fases de trabajo.
- Las confirmaciones de los operarios se devuelven como registros de finalización.
- Los webhooks de SkyPlanner envían los cambios de la programación en cuanto se producen.
Kaskea Group utiliza SkyPlanner con una integración bidireccional con Lemonsoft. Durante la puesta en marcha, el equipo de SkyPlanner configura la integración para adaptarla a tu entorno de Lemonsoft y ofrece soporte una vez que entra en producción. Los partners y desarrolladores también pueden crear sus propias integraciones mediante la REST API documentada de SkyPlanner (referencia de la API).
REST API de Lemonsoft
La API de integración de Lemonsoft es LemonRest, documentada con Swagger 2.0, versión v1. La compilación «LemonRest 2026.10 release-2026.10.2» enumera 422 rutas. (Swagger)
- La URL base depende del entorno. La encontrarás en la gestión de usuarios, dentro de la gestión de entornos y las direcciones de servicio, en el campo Rest API. En la plataforma Azure de Lemonsoft, la base es
https://rest.lemon.fi. - Disponibilidad. Para los clientes del servicio de plataforma de Lemonsoft (Alustapalvelu), las REST API vienen preinstaladas y solo requieren permisos de usuario. (fuente)
- Entorno de pruebas. El cliente final lo solicita a Lemonsoft Service Desk.
La API independiente de control horario Kellokortti no es necesaria para la programación de la producción.
Autenticación
LemonRest utiliza una sesión:
POST /api/auth/logincon UserName, Password, Database y ApiKey devuelve unsession_id.- Envíalo en la cabecera
Session-Iden cada llamada. - Renueva la sesión con
POST /api/auth/renew.GET /api/auth/alivepermite comprobar su estado.
POST /api/auth/login/token acepta un Token en lugar del nombre de usuario y la contraseña. Crea un usuario dedicado a la integración con una clave de API y solo los permisos que necesite la integración. (fuente)
En SkyPlanner, la REST API se autentica mediante un token de API (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. El tutorial de integración te guía por las primeras llamadas.
Detección de cambios: consultas incrementales
LemonRest no tiene endpoints de webhooks ni de suscripciones. Los cambios se leen mediante una consulta incremental:
GET /api/production/main_ws/changed?updated_after=...devuelve las tareas modificadas desde la última ejecución.- Añade
optimization=true. Se incorporó en la versión 2026.6.3 para eliminar la dependencia del registro de eventos y acelerar la consulta. (notas de la versión) GET /api/log/deletion_eventsdetecta las tareas eliminadas para que el trabajo cancelado deje de figurar en el programa de producción.
Consulta los cambios cada pocos minutos. SkyPlanner envía webhooks cuando cambia el estado o el programa de producción, por lo que el envío de datos a Lemonsoft se activa por eventos.
Mapeo de datos
| Objeto de Lemonsoft (endpoint) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
Tuote, product_code (/api/products) | Productos y materiales | Lemonsoft → SkyPlanner | Carga inicial y, después, con cada cambio |
Tuoterakenne con filas de Työvaiheet (/api/products/structure, all_levels) | Estructura de producto, subproductos y etapas del proceso con tiempos de preparación | Lemonsoft → SkyPlanner | Carga inicial y, después, con cada cambio |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Estaciones de trabajo y grupos de estaciones de trabajo | Lemonsoft → SkyPlanner | Carga inicial y, después, en contadas ocasiones |
Työnumero como ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Órdenes con fechas de entrega y prioridad | Lemonsoft → SkyPlanner | Consultas incrementales cada pocos minutos |
Työvaihe como ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Tareas (etapas del proceso) por estación de trabajo | Lemonsoft → SkyPlanner | Consultas incrementales cada pocos minutos |
Necesidades de componentes (main_ws/{worknumber}/materials) | Necesidades de materiales por tarea | Lemonsoft → SkyPlanner | Con cada tarea |
Turnos planificados (/api/persons/plannedshifts) | Turnos y personal | Lemonsoft → SkyPlanner | A diario, o gestión de turnos en SkyPlanner |
Pedido de venta asociado a un número de trabajo (/api/orders/work/{work_number}) | Información del cliente y de la prioridad | Lemonsoft → SkyPlanner | Con cada tarea |
Campos start_time, end_time y machine_id de Työvaihe (PUT /api/production/workstage) | Inicio, fin y estación de trabajo planificados | SkyPlanner → Lemonsoft | Al cambiar el programa de producción, mediante un webhook de SkyPlanner |
Registro de finalización (POST main_ws/sub_ws/completion_entry) | Confirmaciones: cantidad terminada y rechazada, horas y persona | SkyPlanner → Lemonsoft | Con cada confirmación |
| Reglas de programación definidas en SkyPlanner | Estaciones de trabajo permitidas por tarea, matriz de tiempos de preparación y herramientas | Se mantienen en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lee las máquinas y sus grupos, las estructuras de producto con sus fases de trabajo y las fases de trabajo estándar. Asocia cada máquina concreta a una estación de trabajo de SkyPlanner. Utiliza las máquinas padre (Isäkone) solo para agrupar, ya que suman la capacidad de sus máquinas hijas.
2. Sincronización de números de trabajo. Lee los números de trabajo abiertos con sus fases desde /api/production/workstage o main_ws/sub_ws, filtrando por estado y con paginación. Después, mantenlos actualizados mediante main_ws/changed. Mapea work_amount_left, no work_amount, porque Lemonsoft programa en función de la cantidad pendiente. Los pedidos de compra alimentan la programación de SkyPlanner basada en materiales, por lo que cada fase espera hasta la fecha de entrega del pedido de compra.
3. Envío del programa de producción a Lemonsoft. Por cada fase que el motor haya programado o desplazado, SkyPlanner envía PUT /api/production/workstage con la tarea y sus sub_workstages. Cada fase incluye start_time y end_time, además de machine_id cuando se haya trasladado a una máquina alternativa.
4. Confirmaciones en planta. Los operarios confirman el trabajo con SkyPlanner Mobile Confirmations o Production Timer. Cada confirmación se envía a completion_entry con sub_workstage_id, person_number, done_amount, hours, failed_amount y job_done. Incluye material_consumptions cuando la fase consuma material; Lemonsoft contabilizará una finalización normal de producción (valmistuskirjaus).
5. Reglas de responsabilidad sobre los datos y resolución de conflictos. Documéntalas antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Productos, estructuras, fases de trabajo, cantidades y estado de las tareas | Lemonsoft |
| Secuencia de fases, horas de inicio y fin y elección de máquina | SkyPlanner |
| Estaciones de trabajo permitidas por tarea, matriz de tiempos de preparación y herramientas | SkyPlanner |
| Turnos y ausencias | Un único sistema, elegido durante la definición del alcance |
| Registros de finalización y movimientos de existencias | Lemonsoft, a partir de las confirmaciones de SkyPlanner |
Las principales fuentes de conflicto son la programación automática de Lemonsoft y la acción de actualizar: ambas reprograman las fases no bloqueadas. Mantén AUTOTIMING en 0 mientras SkyPlanner sea responsable del programa de producción. Si lo mantienes activado, aplica el bloqueo de programación a cada número de trabajo actualizado; así quedarán fijadas todas sus fases. Koneiden kapasiteetin lukitus por sí solo no basta, porque la programación automática desplaza las tareas no bloqueadas fuera de un día bloqueado. (fuente)
Pasos habituales del proyecto
La implantación suele completarse en cuestión de semanas desde el inicio de la puesta en marcha. Antes, la prueba gratuita de 30 días utiliza tus propios datos, exportados a Excel con los números de trabajo, las fases y las máquinas.
- Definición del alcance. Establece la tabla de mapeo, las reglas de responsabilidad sobre los datos y el intervalo de consulta.
- Acceso. El cliente final solicita un entorno de pruebas a Lemonsoft Service Desk y crea el usuario de integración y la clave de API.
- Carga inicial. Máquinas, grupos, estructuras de producto y fases de trabajo.
- Sincronización de números de trabajo. Consultas incrementales, eventos de eliminación y renovación de la sesión.
- Configuración de restricciones en SkyPlanner. Estaciones de trabajo permitidas para cada tarea, matriz de tiempos de preparación y herramientas.
- Escritura de datos en Lemonsoft. Horarios de las fases y registros de finalización, probados en el entorno de pruebas.
- Funcionamiento en paralelo y puesta en marcha. Compara los resultados con el Gantt actual, corrige los datos maestros y, después, activa la escritura de datos en el entorno de producción.
Qué tener en cuenta al integrar Lemonsoft
- Una máquina por fase. Cada fase de Lemonsoft tiene asignada una máquina. Durante la implantación, las máquinas aptas para cada producto se determinan a partir de una lista o de las propiedades del producto. SkyPlanner elige después entre esas alternativas.
- Capacidad diaria. La capacidad fija se expresa como una cantidad diaria y las desviaciones no tienen una hora asociada. Modela los turnos reales en SkyPlanner o lee los turnos planificados.
- Cantidad pendiente. Mapea
work_amount_left. Los ajustes STARTJOB_AUTOTIMENOW y JOBDONE_AUTOTIMENOW también desplazan la carga del propio Lemonsoft. - Las sesiones caducan. Renueva la sesión antes de las sincronizaciones largas y gestiona los casos en que se fuerce un nuevo inicio de sesión.
- Reglas de confirmación. Valida cada confirmación según el estado de la fase antes de enviarla y espacia las llamadas cuando se produzcan ráfagas.
- Dos clientes. LemonOnline y la versión para Windows comparten una base de datos, por lo que la integración sirve para ambos.
- Estructuras de gran tamaño. Utiliza
/api/async/product/structurecon/api/async/status/{jobId}para las importaciones de gran volumen.
Integración con Lemonsoft: quién la configura y ofrece soporte
El trabajo incluye el mapeo de tus máquinas, fases de trabajo y configuración de Lemonsoft. También abarca las reglas de programación que mantienes en SkyPlanner: estaciones de trabajo permitidas para cada tarea, matriz de tiempos de preparación y herramientas.
- El equipo de SkyPlanner la configura durante la implantación y ofrece soporte tras la puesta en marcha. Cada planta utiliza Lemonsoft de forma distinta, y es aquí donde se aplica ese conocimiento.
- Tu partner de Lemonsoft puede participar. Conoce tu configuración y puede encargarse del usuario de la API, los permisos y el entorno de pruebas. SkyPlanner proporciona la REST API, la documentación Swagger/OpenAPI y los webhooks.
- Tus propios desarrolladores pueden ampliar la integración utilizando la misma REST API documentada con un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner ayuda cuando es necesario.
Una vez establecida la conexión, el motor Arcturus programa la producción a partir de los números de trabajo actualizados de Lemonsoft, y los horarios planificados se guardan en las fases de trabajo. 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 las funciones de planificación del propio Lemonsoft en Programación de la producción con Lemonsoft respetando la capacidad real de máquinas y personal. Encontrará una visión general en la página de Lemonsoft y otros sistemas en la sección de integraciones con ERP.
Opiniones de fabricantes sobre SkyPlanner
Lemonsoftintegración bidireccional con SkyPlanner
Kaskea Group
Fabricación por contrato: mecanizado CNC, estructuras de acero y montaje
La producción se planifica en SkyPlanner, con una integración bidireccional con Lemonsoft.
Menosparadas por falta de materiales
“El valor que nos aporta SkyPlanner es que es una herramienta 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 contrato
La programación automática de la carga permite fijar fechas de entrega más precisas, y las paradas de producción por falta de materiales se han reducido considerablemente.
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 de la producción ha aumentado un 90%.”
Abdul Rucyinga, responsable de TI
Laboratory & Allied · Fabricación farmacéutica
La eficiencia de la producción ha aumentado un 90%, y se tarda menos de 30 minutos en generar un plan optimizado de tres meses para todas las estaciones de trabajo.
Preguntas frecuentes
¿Dispone Lemonsoft de una API para los datos de producción?
Sí. LemonRest da acceso a las tareas de producción y las fases de trabajo, las máquinas, las estructuras de producto, los materiales, los turnos y el registro de finalizaciones. Viene preinstalado para los clientes de Alustapalvelu y requiere una clave de API y permisos de usuario.
¿Admite Lemonsoft webhooks?
LemonRest no incluye endpoints de webhooks en su documentación. Los cambios se leen mediante la consulta incremental main_ws/changed y los eventos de eliminación, que se consultan cada pocos minutos. Los webhooks del propio SkyPlanner envían los cambios de programación en cuanto se producen.
¿Cómo se guardan en Lemonsoft los horarios planificados?
Mediante PUT /api/production/workstage, que actualiza una tarea y sus fases de trabajo con la hora de inicio, la hora de fin y la máquina. Mantenga desactivada la programación automática de Lemonsoft mientras SkyPlanner gestione el programa, o active el bloqueo de programación en cada número de trabajo actualizado, para que se conserven los horarios fijados por SkyPlanner.
¿Se pueden registrar en Lemonsoft las confirmaciones de los operarios realizadas en SkyPlanner?
Sí. Cada confirmación se envía como un registro de finalización con la cantidad completada y rechazada, las horas y la persona. Esta función se utiliza a diario en proyectos de clientes.
¿Quién desarrolla la integración con Lemonsoft?
El equipo de SkyPlanner configura la integración bidireccional para su entorno de Lemonsoft durante la implantación y ofrece soporte tras la puesta en marcha. Su partner de Lemonsoft o sus propios desarrolladores también pueden crear la integración mediante la REST API documentada de SkyPlanner; basta con un token de API para empezar.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días permite utilizar hasta 20 estaciones de trabajo con importaciones desde Lemonsoft en Excel o CSV, sin necesidad de tarjeta de crédito. Inicie la prueba o hable con ventas para definir el alcance de la integración.
