Integraciones / ERP / Senior ERP
Guía de integración de Senior ERP para programar la producción con SkyPlanner APS
Esta guía explica a los partners y equipos de TI cómo conectar Senior ERP de Senior Sistemas (Gestão Empresarial | ERP XT con Senior X) con SkyPlanner APS. SkyPlanner se integra de forma bidireccional con Senior ERP a través de las interfaces de Senior:
- SkyPlanner recibe las órdenes de producción (OP) con sus etapas, rutas (roteiros), recursos productivos y centros de recursos, SKU, estructuras de producto, existencias y pedidos de compra.
- El inicio y el fin previstos de cada etapa de la OP, junto con el recurso productivo elegido, se envían de vuelta a la OP.
- Si lo desea, los registros de tiempo de los operarios se envían de vuelta como apontamentos de produção.
- Senior X Events Hub avisa a SkyPlanner cuando cambia el estado de una etapa de la OP, y los webhooks de SkyPlanner envían los cambios de programación en cuanto se producen.
Durante la puesta en marcha, el equipo de SkyPlanner configura la integración según su instalación de Senior ERP y sigue prestando soporte tras la entrada en producción. Esta guía está dirigida a partners y desarrolladores que quieran participar o desarrollar por su cuenta con la REST API documentada de SkyPlanner (referencia de la API).
Interfaces de integración de Senior ERP
ERP XT es un sistema híbrido. La documentación de Senior indica que Gestão Empresarial XT «becomes a hybrid system: an on-premises (local) system with integration of cloud solutions» (se convierte en un sistema híbrido: un sistema local con soluciones en la nube integradas) (documentación de Senior, traducida). Un sistema de programación de la producción utiliza tres interfaces de Senior:
- Servicios web G5 (SOAP). Se ejecutan en su servidor de Senior y sus nombres corresponden al módulo (com.senior.g5.co.<module>…). Cada uno se publica en tres variantes WSDL: sapiens_Sync, sapiens_Async y sapiens_Scheduled. Entre los servicios de producción se encuentra com.senior.g5.co.mpr.pcp.ordemproducao, que «calls the same production order generation routine» (llama a la misma rutina de generación de órdenes de producción) que la pantalla del ERP (documentación de Senior, traducida). También hay servicios para productos (com.senior.g5.co.ger.cad.produto) y para notificar la producción.
- REST API de Senior X Platform en api.senior.com.br, para los dominios del ERP que Senior expone en Senior X, como productos y pedidos de venta (documentación de Senior).
- Webhooks de Events Hub. Se crean en Senior X, en Tecnologia > Customização > Events Hub > Webhooks. Manufacturing publica el evento erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus cuando cambia el estado de una etapa de la OP (documentación de Senior).
Autenticación y acceso
- Senior X Platform. La integración inicia sesión mediante POST a platform.senior.com.br en /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, con el usuario en formato user@tenant. La respuesta contiene un token de acceso Bearer y un token de actualización. Las claves de aplicación permiten iniciar sesión mediante loginWithKey (clave de acceso, secreto y tenant). Las llamadas REST incluyen la cabecera authorization y una cabecera client_id que identifica la aplicación que se conecta, registrada en el portal de API de Senior y vinculada a un rol en el ERP.
- Servicios web G5. Las llamadas incluyen los parámetros de usuario, contraseña y cifrado. Si se utiliza un token de Senior X, este sustituye a la contraseña (documentación de Senior).
- Permisos. Cree un usuario de Senior exclusivo para la integración, con acceso a los datos de PCP, ingeniería, existencias y compras que deba leer y escribir.
En SkyPlanner, la REST API se autentica con un token de API en la cabecera Authorization-Token (SkyPlanner Settings > API) y está documentada en Swagger/OpenAPI. El tutorial de integración explica paso a paso las primeras llamadas.
Eventos y consultas periódicas
Events Hub cubre lo que ocurre en planta: cuando cambia el estado de una etapa de la OP, el webhook llega a SkyPlanner y se actualiza la programación. Los demás datos se obtienen mediante consultas periódicas. Para detectar trabajo nuevo, las lecturas se filtran por OP firmes y liberadas y por cambios recientes. La frecuencia se establece para cada planta: desde cada pocos minutos para las OP hasta una vez por hora para las existencias.
SkyPlanner envía webhooks cuando cambia el estado o el programa de producción, por lo que el envío de datos de vuelta se activa por eventos.
Mapeo de datos
| Objeto de Senior ERP (interfaz) | Objeto de SkyPlanner | Sentido | Frecuencia |
|---|---|---|---|
| SKU: produto y derivação, unidades de medida (servicios web G5 o entidades de Senior X) | Productos y materiales | Senior → SkyPlanner | Carga inicial y, después, consultas periódicas |
| Estructura de producto (engenharia do SKU) | Estructura del producto, subproductos, materiales por producto | Senior → SkyPlanner | Carga inicial y, después, con cada cambio |
| Roteiro con estágios: secuencia y dependencia de la etapa anterior | Pasos del proceso en orden | Senior → SkyPlanner | Carga inicial y, después, con cada cambio |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Estaciones de trabajo, duraciones, tiempos de preparación y desmontaje, eficiencias | Senior → SkyPlanner | Carga inicial; después, con poca frecuencia |
| Centro de recurso | Grupos de estaciones de trabajo | Senior → SkyPlanner | Carga inicial; después, rara vez |
| Calendário: Feriados, calendario de producción por turno | Turnos y días no laborables | Senior → SkyPlanner | A diario, o con turnos propios en SkyPlanner |
| Ordens de produção (Firme, Liberada) con etapas y materiales | Órdenes y tareas con fechas de entrega y necesidades de materiales | Senior → SkyPlanner | Consultas cada pocos minutos |
| Estado de la etapa de la OP (Events Hub orderProductionStageChangeStatus) | Avance de la tarea | Senior → SkyPlanner | En tiempo real mediante webhook |
| Estoque por SKU | Saldos de existencias | Senior → SkyPlanner | Consultas cada hora o al ejecutar la programación |
| Ordens de compra con fechas de entrega | Pedidos de compra, entradas de material por fecha de entrega | Senior → SkyPlanner | Consulta cada hora o al ejecutar la programación |
| Etapa de la OP: inicio y fin previstos, recurso productivo | Inicio y fin previstos por tarea, estación de trabajo asignada | SkyPlanner → Senior | Al cambiar la programación, mediante un webhook de SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, fecha y hora de inicio y fin | Registros de tiempo y confirmaciones de los operarios | SkyPlanner → Senior | Por confirmación o por turno, si se elige esta opción |
| No disponible en Senior ERP | Matriz de tiempos de preparación, herramientas como recursos de capacidad limitada, tareas con varios operarios, máquinas y personal alternativos | Se mantiene en SkyPlanner | Se configura durante la puesta en marcha |
Patrones de integración
1. Carga inicial de datos maestros. Lea los SKU, las estructuras, los roteiros, los recursos, los centros de recurso y el calendario de producción. Defina con cuidado la correspondencia de los centros de recursos: un centro de recurso con cuatro máquinas se convierte en un grupo de estaciones de trabajo o en cuatro estaciones de trabajo. Convierta Fator de carga en eficiencia de la estación de trabajo de SkyPlanner o en turnos, pero no en ambos.
2. Sincronización de OP. Lea las OP en los estados Firme y Liberada con sus etapas y materiales, así como los pedidos de compra abiertos. El MRP aún puede modificar o eliminar las OP en estado Planejada, así que prográmelas solo si desea una visión anticipada. SkyPlanner considera que el material pedido está disponible en la fecha de entrega del pedido de compra y actualiza las existencias cuando este se marca como Delivered.
3. Envío de la programación al ERP. Cuando el motor sitúa o mueve una etapa, un webhook de SkyPlanner activa la escritura en el ERP. Se establecen el inicio y el fin previstos de cada etapa de la OP y el recurso productivo elegido: los mismos campos que el planificador edita en Programação de produção. Durante la definición del alcance, el equipo de SkyPlanner acuerda con usted y su partner de Senior el servicio web concreto que se utilizará.
4. Confirmaciones en planta. Los operarios registran su trabajo con SkyPlanner Mobile Confirmations o Production Timer, y los registros de tiempo mantienen actualizada la programación. Usted decide si los tiempos reales se envían de vuelta a Senior. Si elige esta opción, cada confirmación se convierte en un apontamento de produção de la etapa de la OP, con la cantidad producida, el rechazo y las horas de inicio y fin. Senior solo acepta notificaciones de producción en OP con estado Liberada o Andamento. Si notifica la producción a través de Fábrica ao Vivo, SkyPlanner obtiene el avance mediante Events Hub en lugar de ese procedimiento.
5. Responsabilidad sobre los datos y resolución de conflictos. Documente las reglas antes de la puesta en marcha:
| Datos | Sistema responsable |
|---|---|
| SKU, estructuras, roteiros, cantidades y estado de las OP | Senior ERP |
| Secuencia de etapas, horas de inicio y fin, asignación de recursos productivos | SkyPlanner |
| Matriz de tiempos de preparación, requisitos de herramientas y operarios, recursos productivos alternativos | SkyPlanner |
| Calendario de producción y turnos | Un solo sistema, elegido durante la definición del alcance |
| Notificaciones de producción, movimientos de existencias, cálculo de costes | Senior ERP, con datos introducidos allí o enviados desde los registros de tiempo de SkyPlanner |
Elija un único sistema para escribir las fechas de las etapas. Si los planificadores siguen secuenciando las mismas OP en Programação de produção o en el diagrama de Gantt, acuerde qué OP gestionará SkyPlanner.
Pasos habituales del proyecto
La implantación suele completarse en unas semanas desde el inicio de la puesta en marcha. Antes, valide la programación durante la prueba gratuita de 30 días con recursos productivos, roteiros y OP abiertas exportados de Senior en CSV o Excel.
- Mapeo. Defina la tabla de correspondencias, las reglas sobre qué sistema controla cada dato, las frecuencias de sincronización y si los apontamentos se enviarán de vuelta al ERP.
- Acceso a Senior. Cree el usuario de integración, registre la aplicación en el portal de API de Senior y habilite los servicios web G5 y el webhook de Events Hub. Realice primero las pruebas en una base de datos de homologación.
- Carga inicial. SKU, estructuras, roteiros, recursos, centros de recurso y calendario.
- Sincronización de OP y pedidos de compra. Consultas periódicas con filtros y reintentos, junto con el webhook de estado de las etapas.
- Configuración de restricciones en SkyPlanner. Matriz de tiempos de preparación, herramientas, número de operarios por tarea y máquinas o personal alternativos.
- Envío de la programación al ERP. Fechas y recursos productivos de las etapas a partir de los webhooks de SkyPlanner, además de los apontamentos si se elige esta opción.
- Pruebas en paralelo. Ejecute SkyPlanner en paralelo con el plan actual, compare las fechas y corrija los datos maestros.
- Puesta en marcha. Active el envío de datos de vuelta al ERP cuando los datos coincidan.
Qué prever al integrar Senior ERP
- Cuatro tiempos por recurso productivo. Recurso contiene los tiempos de proceso, preparación, carga y descarga, y traslado. Los tiempos de carga y traslado pueden corresponder a manipulación, no a tiempo de máquina. Defina la correspondencia de cada tiempo para cada recurso productivo; de lo contrario, todas las duraciones serán incorrectas.
- Un único tiempo de preparación por recurso productivo. Tempo setup de Senior contiene un solo valor. Durante la puesta en marcha, cree la matriz de tiempos de preparación en SkyPlanner a partir de sus cambios reales de fabricación.
- Variantes. En Senior, un SKU es un producto más una derivação, y los roteiros pueden ser distintos para cada variante. Incluya el código de derivação en las claves de producto de SkyPlanner.
- Estados de las OP. Solo las OP en estado Liberada o Andamento aceptan notificaciones de producción. Mantenga los cambios de estado en Senior y deje que SkyPlanner los siga a través de Events Hub.
- Despliegue híbrido. Los servicios web G5 se ejecutan en su servidor de Senior y Events Hub se ejecuta en Senior X. Prevea el acceso de red para ambos.
- Formato numérico. Los servicios web de Senior rechazan los números con separadores de miles y requieren una coma decimal. Envíe los números en ese formato.
Quién configura la integración con Senior ERP y ofrece soporte
- El equipo de SkyPlanner configura la integración durante la puesta en marcha y ofrece soporte tras la entrada en producción, para los servicios web, las API de Senior X y los webhooks de Events Hub acordados. Cada planta utiliza Senior ERP de forma distinta, y es aquí donde se aplica ese conocimiento.
- Tu partner de Senior puede participar. Conoce tu configuración, tus personalizaciones y tus licencias, y puede configurar el usuario de integración, el registro en el portal de API y los servicios web junto con el equipo de SkyPlanner.
- Tus propios desarrolladores pueden ampliar la integración mediante la REST API de SkyPlanner con un token de API. Basta con un token de API para empezar, y el equipo de SkyPlanner presta ayuda cuando es necesario. Encontrarás la documentación en Documentación de integración 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 junto con tu plan, según tus procesos y necesidades. Consulta los precios, la programación de la producción con Senior ERP respetando la capacidad real de máquinas y personal, la página de Senior ERP y la sección de integraciones con ERP.
Opiniones de fabricantes sobre SkyPlanner
2 hde ahorro 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 un plan optimizado de tres meses para todas las estaciones de trabajo lleva menos de 30 minutos.
Más de 1.000órdenes de trabajo programadas automáticamente
“Ahora controlamos la producción de otra manera, y nuestro conocimiento de la capacidad está a un nivel completamente distinto.”
Hannu Ryynänen, director general
Mamec · Mezcladoras 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.
Menosparadas por falta de materiales
“El valor que nos aporta SkyPlanner es que funciona en el día a día, sobre todo para fijar fechas de entrega.”
Tommi Männistö, responsable de planificación de la producción
Eskomatic · Mecanizado por encargo
La programación automática de la carga de trabajo permite fijar fechas de entrega más precisas, y las paradas de producción por falta de materiales se han reducido considerablemente.
Preguntas frecuentes
¿Dispone Senior ERP de una API para órdenes de producción?
Sí. El servicio web G5 com.senior.g5.co.mpr.pcp.ordemproducao genera OP con la misma rutina que se utiliza en la pantalla del ERP, y otros servicios G5 cubren los productos y el registro de la producción. Senior X Platform añade REST APIs con autenticación mediante token Bearer y webhooks de Events Hub.
¿Admite Senior ERP webhooks?
Sí. Senior X Events Hub envía webhooks, entre ellos orderProductionStageChangeStatus cuando cambia el estado de una etapa de una OP. SkyPlanner lo utiliza para seguir el avance en planta en tiempo real, y sus propios webhooks envían los cambios de la programación de vuelta al ERP.
¿Cómo se guardan las fechas planificadas en Senior ERP?
SkyPlanner establece el inicio y el fin planificados de cada etapa de una OP y el recurso productivo elegido para ella: los mismos campos que el planificador edita en Programação de produção. Cada vez que cambia la programación, un webhook de SkyPlanner activa la escritura de los datos en Senior. Para ello utiliza la vía que el equipo de SkyPlanner establece para tu instalación de Senior al definir el alcance durante la puesta en marcha.
¿Funciona la integración con Senior X y ERP XT?
Sí. ERP XT se ejecuta en tu servidor y utiliza servicios en la nube de Senior X. La integración utiliza los servicios web G5 en el servidor y las API de Senior X y Events Hub en la nube.
¿Podemos probar SkyPlanner antes de desarrollar la integración?
Sí. La prueba gratuita de 30 días admite hasta 20 estaciones de trabajo con importaciones desde Senior en formato CSV o Excel, sin necesidad de tarjeta de crédito. Inicia la prueba o habla con el equipo comercial para definir el alcance de la integración.
