Integraciones / ERP / Visma L7
Guía de integración de Visma L7 con APS para la programación de la producción
Esta guía de integración de Visma L7 explica a los socios y equipos de TI cómo conectar Visma L7 con SkyPlanner APS. SkyPlanner se integra con Visma L7 de forma bidireccional a través de Visma L7 REST API:
- Se importan números de trabajo (työnumero), fases de trabajo (työnvaihe), recursos productivos, estructuras de producto, componentes, materiales, existencias, líneas de venta y líneas de compra.
- Mediante
PUT /manufphases/, se devuelven a cada ficha de trabajo el recurso productivo, la fecha de inicio, la prioridad, la persona asignada y las horas desglosadas por día. - La capacidad del calendario de recursos productivos se mantiene sincronizada mediante
POST /resourceupdates/. - Los eventos de producción registrados en las colas de trabajo de L7 se recuperan mediante
GET /manufevents/. - Los webhooks de SkyPlanner envían los cambios en la programación en cuanto se producen.
Durante la puesta en marcha, el equipo de SkyPlanner adapta la integración a su configuración de L7 y sigue prestando soporte tras la entrada en producción. Los socios y desarrolladores también pueden crear sus propias integraciones con la REST API documentada de SkyPlanner (referencia de la API).
La REST API de Visma L7
La API se denomina Visma L7 – REST API y está documentada con OpenAPI 3.0.3, con un historial de cambios (documentación). Se ejecuta en Visma LTR.
- La ruta base es
/ltrws/REST/L7en su propio servidor LTR, ya sea en sus instalaciones o en el servicio de alojamiento de aplicaciones de Visma. - Licencias. Cada endpoint requiere su propia licencia. Para escribir la programación mediante
PUT /manufphases/se necesita la licencia L7RMFPP; para actualizar la capacidad, L7RMCAP. Los endpoints de lectura tienen sus propias licencias. - Paginación. Las listas se paginan con
pageSizeyrecAfter, y se filtran conqueryKey1,queryKey2yqueryString.
Autenticación
Cada llamada a L7 incluye dos tokens:
- hash selecciona la base de datos y la empresa.
- token identifica al usuario de la API.
El administrador de LTR crea el usuario de la API en Visma LTR, lo vincula a la empresa de L7, le asigna perfiles y genera su token (primeros pasos). Utilice un usuario exclusivo para la integración, con solo los permisos que esta necesite.
En SkyPlanner, la autenticación de la REST API se realiza con un token de API enviado en la cabecera Authorization-Token. Puede crearlo en Settings > API. El tutorial de integración explica paso a paso las primeras llamadas.
Detección de cambios: modifiedAfter
La L7 REST API no dispone de webhooks. Los cambios se leen mediante consultas periódicas:
- Active el registro de cambios (DBLOG) en el mantenimiento de archivos de L7 (Tiedostohuolto) para las tablas que lee la integración, como las de fichas de trabajo y componentes.
- Llame a los endpoints de lectura con
modifiedAfterfijado en el momento de la última ejecución. Los registros eliminados se devuelven marcados como tales, de modo que los trabajos cancelados desaparecen de la programación. - Realice las consultas cada pocos minutos. SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la escritura de datos en L7 se activa por eventos.
Mapeo de datos
| Objeto de Visma L7 (endpoint) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
Tuote (GET /products/) | Productos y materiales | L7 → SkyPlanner | Carga inicial y, después, con cada cambio |
Componentes de un número de trabajo (GET /manufcomponents/) | Subproductos | L7 → SkyPlanner | Consultas periódicas con modifiedAfter |
Necesidades de material (GET /manufmaterials/) | Necesidades de material por tarea | L7 → SkyPlanner | Consultas periódicas con modifiedAfter |
Árbol de recursos productivos (KRYH) con número de máquinas (GET /manufresources/) | Estaciones de trabajo y grupos de estaciones de trabajo | L7 → SkyPlanner | Carga inicial; después, rara vez |
Ficha de trabajo (TSUUNR) por fase (GET /manufphases/) | Tareas (etapas del proceso) por estación de trabajo | L7 → SkyPlanner | Consultas cada pocos minutos |
Existencias (GET /stockbalances/) | Existencias | L7 → SkyPlanner | Consultas periódicas |
Líneas de compra (GET /purchaserows/) | Pedidos de compra con fechas de entrega | L7 → SkyPlanner | Consultas periódicas |
Pedidos y líneas de venta (GET /salesorders/, GET /salesrows/) | Fechas de entrega, prioridad del cliente | L7 → SkyPlanner | Consultas periódicas |
Eventos de producción (GET /manufevents/) | Avance por tarea | L7 → SkyPlanner | Consultas periódicas |
Campos resource, startDate, priority, person, schedulingDays de la ficha de trabajo (PUT /manufphases/) | Estación de trabajo, inicio, secuencia y horas diarias previstos | SkyPlanner → L7 | Cuando cambia el programa de producción, mediante un webhook de SkyPlanner |
Capacidad del calendario de recursos productivos (POST /resourceupdates/) | Capacidad por turno | SkyPlanner → L7 | Cuando cambian los turnos |
| Reglas de programación definidas en SkyPlanner | Estaciones de trabajo permitidas, matriz de tiempos de preparación, herramientas, personal | Se mantienen en SkyPlanner | Se configuran durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lea el árbol de recursos productivos y asocie cada máquina a su propia estación de trabajo en SkyPlanner. Si un recurso productivo de L7 incluye varias máquinas, cree una estación de trabajo por máquina y un grupo de estaciones de trabajo para ese recurso. Lea los productos y sus estructuras, incluidas las fases de trabajo.
2. Sincronización de números de trabajo. Lea las fichas de trabajo abiertas con GET /manufphases/ y manténgalas actualizadas con modifiedAfter. Lea los componentes y las necesidades de material de cada número de trabajo, así como las existencias y las líneas de compra, para que cada fase espere a la fecha de entrega de su línea de compra.
3. Escritura de la programación en L7. SkyPlanner llama a PUT /manufphases/ por cada fase que el motor haya programado o movido. El cuerpo de la petición incluye una entrada workSheet por ficha de trabajo con:
number, la ficha de trabajo, yresource, el recurso productivo elegidostartDateypriority, para que las colas de trabajo de L7 muestren la secuencia de SkyPlannerperson, cuando se ha previsto un operario concretoschedulingDays, las horas previstas para cada fecha
L7 conserva sin cambios la prioridad establecida por un sistema externo (fuente), por lo que se mantiene la secuencia en las colas de trabajo.
4. Sincronización de capacidad. Cuando cambian los turnos, los días festivos o las horas extra en SkyPlanner, POST /resourceupdates/ escribe la nueva capacidad en el calendario de recursos productivos de L7. Así, las vistas de carga de L7 reflejan el plan.
5. Avance en planta. Los operarios siguen registrando su actividad en las colas de trabajo de L7 y en Visma LTR, y SkyPlanner lee los eventos con GET /manufevents/. También pueden confirmar el trabajo en SkyPlanner Mobile Confirmations. Autopilot reprograma a partir de cualquiera de las dos fuentes y la siguiente escritura en L7 incluye los nuevos horarios.
6. Responsabilidad sobre los datos y reglas para resolver conflictos. Déjelas por escrito antes de la entrada en producción:
| Datos | Sistema responsable |
|---|---|
| Productos, estructuras, fases de trabajo, cantidades, estado del número de trabajo | Visma L7 |
| Secuencia de fases, fechas de inicio, horas diarias, elección del recurso productivo | SkyPlanner |
| Estaciones de trabajo permitidas, matriz de tiempos de preparación, herramientas, personal | SkyPlanner |
| Turnos y ausencias | SkyPlanner, con escritura en el calendario de recursos productivos de L7 |
| Eventos de producción y movimientos de existencias | Colas de trabajo de Visma L7 y LTR |
La principal fuente de conflictos es la propia planificación de L7. El cálculo de necesidades y la planificación detallada pueden volver a programar las fases no bloqueadas. Ejecútelos solo para los materiales y las reservas, y no reprograme las fases que gestiona SkyPlanner.
Pasos habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, la prueba gratuita de 30 días permite trabajar con sus propios datos, exportados a Excel con los números de trabajo, las fases y los recursos productivos.
- Definición del alcance. Fije la tabla de correspondencias, las reglas de responsabilidad sobre los datos y el intervalo de consulta.
- Acceso y licencias. Obtenga las licencias de los endpoints REST incluidos en el alcance. El administrador de LTR crea el usuario de la API, el hash y el token, preferiblemente primero en una empresa de pruebas.
- Registro de cambios. Active DBLOG para las tablas que vaya a leer.
- Carga inicial. Recursos productivos, productos, estructuras y fases de trabajo.
- Sincronización de números de trabajo. Consultas periódicas con modifiedAfter, eliminaciones y paginación.
- Configuración de restricciones en SkyPlanner. Estaciones de trabajo permitidas, matriz de tiempos de preparación, herramientas y personal.
- Escritura en L7. Pruebas de
PUT /manufphases/yPOST /resourceupdates/en la empresa de pruebas. - Ejecución en paralelo y entrada en producción. Compare los resultados con el plan actual, corrija los datos maestros y, después, active la escritura en L7 en el entorno de producción.
Qué prever al integrar Visma L7
- Licencias por endpoint. Identifique todos los endpoints desde el principio y obtenga sus licencias antes de realizar las pruebas.
- Número de máquinas. En L7, un recurso productivo con varias máquinas reparte el trabajo entre ellas (fuente). Divídalo en estaciones de trabajo en SkyPlanner y, al devolver los datos, envíe el recurso que espera L7.
- Horas por día. L7 guarda la programación como horas por fecha. SkyPlanner envía
schedulingDayscuya suma corresponde a la duración de la fase. - Calendario de fábrica. Manténgalo completo: los huecos hacen que las fases se programen en fechas pasadas (fuente).
- Órdenes para stock.
mainNumber,subNumber,rowNumberynewQuantitysolo se utilizan para modificar la cantidad de una orden para stock. Omítalos cuando se trate de trabajos para clientes. - El próximo ERP. Visma ha dejado de desarrollar nuevas funcionalidades para L7 y el uso del producto finalizará a finales de 2028 (aviso de Visma). Mantenga las reglas de programación en SkyPlanner, no en los campos de L7, para conservarlas cuando cambie de ERP.
Integración con Visma L7: quién la configura y ofrece soporte
El trabajo incluye establecer las correspondencias con sus recursos productivos, fases de trabajo y configuración de L7. También abarca las reglas de programación que mantiene en SkyPlanner: estaciones de trabajo permitidas, matriz de tiempos de preparación, herramientas y personal.
- El equipo de SkyPlanner configura la integración durante la puesta en marcha y ofrece soporte tras la entrada en producción. Cada planta utiliza L7 de forma distinta, y ese conocimiento se aplica en esta configuración.
- Su partner de Visma puede participar. Conoce su configuración de L7 y LTR y puede encargarse del usuario de la API, las licencias y la empresa de pruebas. SkyPlanner proporciona la REST API, la documentación de Swagger/OpenAPI y los webhooks.
- Tus propios desarrolladores pueden ampliar la integración utilizando la misma REST API documentada y un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner ofrece ayuda cuando hace falta.
Cuando sustituyas L7, podrás conectar la misma configuración de SkyPlanner al nuevo ERP. Consulta las páginas de Business Central, Visma Net, Lemonsoft, Monitor ERP y Odoo.
SkyPlanner está disponible desde 199 € al mes, con 5 estaciones de trabajo incluidas y facturación mensual. Recibirás de antemano un presupuesto de la integración adaptado a tus procesos y necesidades, junto con el de tu plan, para que conozcas el coste total antes de empezar.
Compara las funciones de planificación de L7 en ¿Permite Visma L7 programar la producción respetando la capacidad real de las máquinas y del personal? Encontrarás una visión general en la página de Visma L7 y otros sistemas en la sección de integraciones con ERP.
Opiniones de fabricantes sobre SkyPlanner
Más de 1.000 órdenes de trabajo programadas automáticamente
«Ahora tenemos un control distinto de la producción, y nuestro conocimiento de la capacidad está a un nivel completamente diferente».
Hannu Ryynänen, director general
Mamec · Mezcladores industriales, bombas y fabricación por contrato de alta tecnología
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.
98%de cumplimiento de plazos de entrega, frente a cerca del 50% anterior
«SkyPlanner desempeña un papel decisivo para mantener nuestro nivel de cumplimiento de los plazos de entrega».
Hannu Lahtinen, director general
KJH-Comp · Fabricación de componentes de chapa y fabricación por contrato
El cumplimiento de plazos de entrega pasó de alrededor del 50% a alcanzar el 98%, y ahora la programación requiere un supervisor en lugar de dos.
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 permite ahorrar 2 horas de trabajo cada semana, y las nuevas colas de trabajo llegan 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 elaborar una programación optimizada de tres meses para todas las estaciones de trabajo lleva menos de 30 minutos.
Preguntas frecuentes
¿Dispone Visma L7 de una API para los datos de producción?
Sí. La REST API de Visma L7 en Visma LTR permite acceder a fases de trabajo, recursos productivos, piezas, materiales, eventos de producción, productos, existencias, líneas de venta y líneas de compra. Cada endpoint requiere una licencia independiente, y el administrador de LTR crea el usuario de la API y los tokens.
¿Cómo se devuelve la programación a Visma L7?
Mediante PUT /manufphases/, que actualiza el recurso productivo, la fecha de inicio, la prioridad, la persona y las horas planificadas por fecha de cada ficha de trabajo. POST /resourceupdates/ guarda la capacidad del calendario de los recursos productivos. L7 conserva la prioridad externa, por lo que las colas de trabajo siguen el orden de SkyPlanner.
¿Admite Visma L7 webhooks?
No hay webhooks documentados. Activa el registro de cambios para las tablas incluidas en el alcance y realiza consultas periódicas con modifiedAfter. Los webhooks de SkyPlanner envían los cambios de programación en cuanto se producen.
¿Qué software de programación de la producción se integra con Visma L7?
SkyPlanner APS se integra de forma bidireccional con Visma L7 mediante la REST API de L7, y Visma incluye a Skycode con SkyPlanner en su página de integraciones de L7. El equipo de SkyPlanner configura la integración durante la puesta en marcha.
¿Quién desarrolla la integración con Visma L7?
Durante la puesta en marcha, el equipo de SkyPlanner adapta la integración bidireccional a tu configuración de L7 y ofrece soporte tras la entrada en producción. Tu partner de Visma o tus propios desarrolladores también pueden desarrollar sobre 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 e importar datos de L7 en Excel o CSV, sin necesidad de tarjeta de crédito. Inicia la prueba o contacta con ventas para definir el alcance de la integración.
