Guía de integración de Comarch ERP XL para programar la producción con SkyPlanner APS

Comarch enumera tres formas de comunicarse con ERP XL: «DCOM, direct database connection (SQL Client), REST API» (DCOM, conexión directa a la base de datos mediante SQL Client y REST API) (Comarch, traducido). Para un sistema de programación de la producción, dos de ellas cubren las funciones necesarias:

1. XL API (CDN_API.DLL). «These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.» (Estas funciones se agrupan en la biblioteca CDN_API.DLL, que se instala junto con todo el sistema Comarch ERP XL.) (Ayuda de Comarch, traducida) Un programa externo inicia sesión con XLLogin, llama a funciones que comparten esa sesión y la cierra con XLLogout. Cada estructura incluye un campo Wersja que selecciona la versión del conjunto de parámetros correspondiente a tu versión de ERP XL.
2. ERP XL Web REST API. Comarch ERP XL Web 2026.0 expone microservicios REST: «Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.» (Cada microservicio RestAPI ofrece su propia documentación interactiva en el endpoint /swagger.) (Ayuda de Comarch, traducida)

La conexión directa mediante SQL Client permite leer datos maestros y órdenes de la base de datos de ERP XL, según lo acordado con tu equipo de TI y tu partner de Comarch.

Funciones de XL API para producción

Comarch documenta estas funciones de producción (XL128):

En la documentación consultada, Comarch ERP XL no publica webhooks de salida. El propio APS de Comarch obtiene los datos cuando el planificador pulsa «Aktualizuj dane z ERP» (Actualizar datos del ERP) (Ayuda de Comarch APS).

Por tanto, los datos de ERP XL se obtienen mediante consultas periódicas. Para detectar nuevos trabajos, las lecturas se filtran por órdenes de producción abiertas y cambios recientes. La frecuencia se define para cada planta: desde cada pocos minutos para las órdenes de producción hasta cada hora para las existencias.

SkyPlanner envía webhooks cuando cambia el estado o la programación, por lo que la devolución de datos al ERP se activa por eventos.

1. Carga inicial de datos maestros. Lee los artículos, las tecnologías, los centros de trabajo, los recursos productivos y los calendarios. Define cómo se representará cada centro de trabajo en SkyPlanner: un centro con cuatro máquinas se convierte en un grupo de estaciones de trabajo o en cuatro estaciones de trabajo. Las herramientas incluidas en los recursos de ERP XL pasan a ser herramientas con disponibilidad limitada en SkyPlanner, y los empleados pasan a ser personal con turnos.

2. Sincronización de órdenes y pedidos. Lee las órdenes de producción con sus operaciones y materiales, así como los 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 el pedido se marca como Delivered.

3. Escritura de la programación en el ERP. Cuando el motor programa o mueve una operación, un webhook de SkyPlanner activa el servicio de escritura en el ERP. Este llama a XLDodajTerminDoProcesuProd con los valores TerminOd y TerminDo de la operación, de modo que cada operación ZP incorpora el inicio y el fin previstos por SkyPlanner.

4. Notificaciones de planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations o Production Timer, y esos registros de tiempo mantienen actualizada la programación. Tú decides si los tiempos reales se envían al ERP. En caso afirmativo, el servicio añade las ejecuciones mediante XLDodajRealizacjeOperacjiProd, y los documentos RW y PW siguen las reglas de tu ERP XL. Si utilizas Comarch MES en algunas estaciones, mantén una sola fuente de notificación por operación.

5. Reglas de responsabilidad sobre los datos y resolución de conflictos. Déjalas por escrito antes de la entrada en producción:

Elige un único sistema para escribir las fechas de las operaciones. Si la replanificación automática de ERP XL o Comarch APS sigue escribiendo fechas en las mismas órdenes de producción, desactiva esa función para las órdenes que programa SkyPlanner.

• Capacidad introducida manualmente. En ERP XL, la capacidad de un centro de trabajo es un valor definido por el usuario con un % de carga permitido. SkyPlanner, en cambio, calcula la capacidad a partir de los turnos y los recursos productivos reales. Configure los turnos con cuidado y prescinda del porcentaje.
• Recursos con capacidad ilimitada. ERP XL no comprueba la ocupación de los recursos marcados con capacidad ilimitada. Decida para cada uno si se convertirá en una estación de trabajo con capacidad limitada en SkyPlanner.
• Órdenes liberadas. ERP XL excluye de la replanificación las operaciones liberadas a producción, salvo que esté marcada la opción «Przesuń na zwolnionych». Acuerde cómo se aplicarán las fechas de SkyPlanner a las órdenes liberadas y utilice Running Time Lock para bloquear la programación de las próximas horas de trabajo.
• Versiones de las estructuras. Las estructuras de XL API incluyen un campo Wersja. Ajústelo a su versión de ERP XL y repita las pruebas después de cada actualización anual.
• Unidades y tiempos en Polonia. Los tiempos de las operaciones y las unidades del calendario deben convertirse con exactitud al importar; de lo contrario, todas las duraciones serán incorrectas.