Guía de integración de Visma Net para la programación de la producción con SkyPlanner APS

• Visma Net ERP API. API REST con una especificación OpenAPI que sigue titulándose «Visma.net ERP API v1», con rutas v1 y v2. La URL base es https://api.finance.visma.net. Desde el 1 de febrero de 2026 se limita el tráfico del antiguo dominio integration.visma.net, que está en proceso de cierre (aviso).
• SalesOrder service v3 en https://salesorder.visma.net. Los endpoints v1 y v2 de pedidos de venta han llegado al final de su vida útil.
• Webhooks a través de Visma Developer Portal.
• Background API. La cabecera erp-api-background pone en cola las llamadas de larga duración, devuelve un código 202 con un ID de tarea y te avisa cuando el resultado está listo.
• Escenarios de importación y exportación en Visma Net, con proveedores de datos CSV, Excel o SQL, para cargas puntuales de datos maestros.

La API no tiene endpoints para órdenes de producción, rutas de fabricación ni centros de trabajo, porque esos objetos no existen en Visma Net. Los datos para la programación se obtienen de los artículos, kits, pedidos y existencias:

• GET /v1/inventory: artículos de inventario y artículos no inventariables, incluidos el indicador de kit y la clase de artículo
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: líneas de componentes por revisión
• GET /v1/kitassembly: ensamblajes existentes, que se pueden filtrar por tipo y estado
• SalesOrder service v3: demanda con las fechas solicitadas y las líneas de pedido
• GET /v1/inventorysummary/{inventoryNumber}: existencias físicas y disponibles por almacén
• GET /v1/purchaseorder y GET /v2/PurchaseReceipt: material pendiente de recibir y recepciones

Todos los endpoints de listado admiten lastModifiedDateTime con lastModifiedDateTimeCondition, además de pageNumber y pageSize, por lo que cada sincronización puede ser incremental.

Los webhooks de Visma Developer Portal cubren los eventos relevantes para la programación:

• Inventory Item Created, Updated y Changed
• Purchase Order Changed y Status Changed
• Sales Order Changed y Status Changed, que están pasando al publicador SalesOrderService

No hay eventos para Kit assembly ni Kit specifications. SkyPlanner los consulta periódicamente con filtros lastModifiedDateTime. Las existencias se consultan al ejecutar la programación. En sentido contrario, SkyPlanner envía webhooks cuando cambia el estado o la programación.

1. Carga inicial de datos maestros. Lee los artículos de inventario, las clases de artículo y la última revisión de Kit specification de cada kit. Asocia cada línea de componentes con un material de SkyPlanner. Después, crea los datos que Visma Net no contiene: estaciones de trabajo, turnos, etapas del proceso con tiempos de preparación y ejecución, la matriz de tiempos de preparación y los requisitos de herramientas. Impórtalos en formato CSV o Excel. Esta es la parte que más trabajo supone en el proyecto.

2. Sincronización de pedidos. Elige un modelo de demanda:

• Basado en pedidos de venta. Las líneas abiertas de pedidos de venta de artículos kit se convierten en pedidos de SkyPlanner, con la fecha solicitada como fecha de entrega.
• Basado en ensamblajes. Los Kit assemblies creados en Visma Net con estado On hold se convierten en tareas de SkyPlanner.

Los pedidos de compra abiertos se importan con sus fechas. 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. Al programar, se comprueban tanto las existencias como las compras pendientes de recibir, utilizando también el resumen de inventario.

3. Envío de la programación a Visma Net. En una configuración basada en pedidos de venta, SkyPlanner crea un Kit assembly de tipo Production por cada tarea programada. Define el artículo kit, la revisión, el almacén, la cantidad y los componentes, y vincula el ensamblaje con la línea del pedido de venta. La fecha del ensamblaje es la fecha de finalización prevista. Cuando Autopilot desplaza la tarea, una llamada PUT actualiza la fecha antes de la liberación.

Kit assembly tiene un único campo Date, por lo que los tiempos de cada operación se conservan en SkyPlanner y Visma Net recibe la fecha relevante para ventas e inventario.

4. Confirmaciones en planta. Los operarios registran el trabajo con Mobile Confirmations o Production Timer, y esos registros de tiempo mantienen la programación al día. Cuando se termina la última etapa, SkyPlanner ejecuta la acción de liberación del Kit assembly. La liberación contabiliza la producción obtenida y el consumo de componentes; después se genera el lote de asientos del libro mayor. Las horas se agrupan en Employee time cards semanales o, si el trabajo se organiza por proyectos, en transacciones de proyecto.

5. Reglas de responsabilidad sobre los datos y resolución de conflictos. Documéntalas antes de la puesta en marcha:

Cada cambio en una Kit specification genera una nueva revisión. Vuelve a leer la última revisión y actualiza la correspondencia de datos, ya que solo se puede fabricar con la revisión más reciente. Los cambios manuales en los componentes de un montaje siguen siendo válidos en Visma Net, por lo que SkyPlanner vuelve a leer el montaje antes de liberarlo.

• No hay rutas de fabricación que importar. Todas las operaciones y los tiempos de preparación y ejecución se definen inicialmente en SkyPlanner. Prevé el trabajo necesario y asigna un responsable.
• Advanced logistics. Kit assembly requiere el grupo Advanced logistics. Con Standard logistics, registra la producción mediante Inventory receipt e Inventory issue.
• Revisiones bloqueadas. Una revisión de Kit specification que ya se ha utilizado no se puede editar, y solo se puede fabricar con la más reciente.
• Unidades de medida. Cada Kit assembly tiene su propia unidad de medida. Al importar, asegúrate de que coincida con las cantidades de SkyPlanner.
• Consultas periódicas sin eventos. Los kits no tienen webhooks. Consulta los cambios incrementales mediante lastModifiedDateTime, en lugar de hacer recargas completas, para no superar el límite de solicitudes por hora.
• Endpoints actuales. Desarrolla la integración únicamente sobre api.finance.visma.net y SalesOrder service v3.
• Aprobación del tenant. Las credenciales de cliente no funcionan hasta que el administrador del tenant aprueba la aplicación. Programa este paso con antelación.
• Partes de horas semanales. Los partes de horas requieren Advanced financials y se gestionan por semanas. Agrupa las horas de los operarios por semana o regístralas como transacciones de proyecto.