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

Prepare ya la transición. Odoo ha previsto la retirada de XML-RPC y JSON-RPC en Odoo 22 (otoño de 2028) y Odoo Online 21.1 (invierno de 2027). Desarrolle sobre JSON-2 para 19.0 y encapsule el acceso por RPC en un único adaptador para las bases de datos más antiguas, de modo que la actualización solo requiera un cambio. La retirada no afecta a los controladores personalizados con @route(type='jsonrpc').

Autenticación

Crea un usuario exclusivo para la integración, con permisos de lectura en Manufacturing e Inventory y de escritura en las órdenes de fabricación. Genera su clave en Preferences > Account Security > New API Key. En 19.0, las claves duran como máximo tres meses, por lo que el middleware debe gestionar su rotación y generar una alerta ante fallos de autenticación. Sin estas medidas, una clave caducada detiene la sincronización sin que nadie lo advierta. Por parte de SkyPlanner, la API REST utiliza JWT, de modo que el middleware almacena ambas credenciales.

Cada llamada JSON-2 se ejecuta en su propia transacción SQL, por lo que una escritura repartida entre varias llamadas no es atómica. Realiza las escrituras por orden de fabricación y registra cada resultado.

Eventos

Odoo envía los cambios mediante reglas de automatización. Una regla sobre mrp.production o mrp.workorder con el activador «On create and edit» y la acción «Send Webhook Notification» envía un POST con los campos seleccionados a una URL. Cree la regla en Studio o, en modo desarrollador, desde el formulario Automation Rules. Combínela con consultas periódicas mediante search_read sobre write_date para detectar importaciones y cualquier cambio que la regla no haya recogido. En sentido contrario, los webhooks de SkyPlanner envían los cambios de programación y estado en cuanto se producen.

Los nombres de los campos varían entre versiones. En 19.0, cada base de datos muestra sus modelos, campos y métodos en /doc; en versiones anteriores, llame a fields_get. Defina las correspondencias a partir de esa información, no de memoria.

« POST /json/2/mrp.workorder/write Authorization: bearer <api-key> {"ids": [4711], "vals": {"date_start": "2026-11-03 06:00:00", "date_finished": "2026-11-03 09:30:00", "workcenter_id": 7}} «

JSON-2 recibe cada argumento del método por su nombre, además de ids y context, por lo que el argumento de write(vals) se envía bajo la clave vals. En las versiones de 16.0 a 18.0, la misma llamada se ejecuta como execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) mediante XML-RPC o JSON-RPC, y en 16.0 las claves son date_planned_start y date_planned_finished. Las fechas y horas se envían en UTC. Siga estas reglas para escribir los datos correctamente:

• Envía ambas fechas en la misma llamada.
• Añada workcenter_id solo cuando el motor haya elegido una máquina alternativa.
• Escribe solo en los campos de programación, nunca en las cantidades ni en las listas de materiales.

Al escribir las fechas, se desplaza la reserva del centro de trabajo en Odoo, por lo que sus vistas de planificación muestran el programa de SkyPlanner.

De la planta a Odoo. Los operarios registran el trabajo en SkyPlanner Mobile Confirmations. Para cada confirmación, la integración llama a create en mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create con vals_list). Rellena workorder_id, workcenter_id, date_start, date_end y un loss_id de tipo Productive, y el tiempo de mano de obra y los costes se contabilizan en Odoo.

Cuando termina una operación, la integración establece la cantidad producida y llama a button_finish en la orden de fabricación. La última orden de fabricación deja la orden de producción lista para button_mark_done. Cada confirmación se registra una sola vez, y el identificador de su registro en Odoo se guarda junto al registro de tiempo de SkyPlanner, de modo que un reintento del webhook nunca crea un segundo Time Log.

En las plantas que utilizan la aplicación Shop Floor de Enterprise, el flujo se invierte: SkyPlanner lee el estado de la orden de fabricación y qty_produced, y Autopilot reprograma automáticamente cuando cambia la producción.

Responsabilidad sobre los datos. Deja las reglas por escrito antes de la entrada en producción:

Los planificadores deben dejar de pulsar Plan y Unplan en Odoo para las órdenes de producción que programa SkyPlanner. De lo contrario, Odoo reserva sus propias franjas y sobrescribe las fechas de SkyPlanner.

• Campos de fecha que han cambiado de nombre. Hasta 16.0, date_planned_start y date_planned_finished contenían las fechas previstas, y date_start/date_finished, las reales. Desde 17.0, date_start y date_finished son las fechas previstas. Si se copia la correspondencia de campos de un proyecto de 16.0, en 17+ se leen las fechas reales como previstas sin que se genere ningún aviso.
• Las fechas de las órdenes de fabricación son reservas. En 19.0, date_start y date_finished de mrp.workorder se calculan a partir de un registro de resource.calendar.leaves (leave_id) en el calendario del centro de trabajo. Al escribir las fechas en la orden de fabricación, se actualiza esa reserva. Nunca escriba directamente en la tabla de ausencias.
• Las órdenes de fabricación iniciadas bloquean la acción Unplan. Odoo impide desplanificar una orden de producción cuando aparece «Some work orders have already started» (algunas órdenes de fabricación ya se han iniciado). Al actualizar los datos en Odoo, omita las órdenes de fabricación en estado progress o done y mueva solo las que no hayan empezado.
• Las duraciones varían. Las operaciones configuradas como Computed toman su duración de las últimas órdenes de fabricación (10 por defecto), ajustada según Time Efficiency. Configúralas como Fixed para la prueba o acepta que los datos de entrada varíen. Las operaciones se definen en cada lista de materiales, sin un maestro compartido de rutas de fabricación, por lo que hay que depurar cada lista por separado.
• Calendarios incorrectos. Cada centro de trabajo necesita un calendario de horarios laborales. El planificador de Odoo busca huecos hasta 700 días en el futuro y después se detiene con el mensaje «Impossible to plan the workorder» (no se puede programar la orden de fabricación). Corrige los calendarios antes de la primera carga.
• Unidades de medida. mrp.bom.line tiene su propio product_uom_id, que puede diferir de la unidad de inventario del producto. Convierta las unidades antes de comprobar la disponibilidad de materiales.

Escribir los datos en Odoo es lo que permite aprovechar la integración en el trabajo diario. Una vez que funciona este envío de datos a Odoo:

• Las órdenes de fabricación de Odoo tienen fechas reales de programación. El motor Arcturus AI secuencia todas las órdenes de producción abiertas en segundos. Las fechas y estaciones de trabajo que elige se escriben en mrp.workorder, donde las muestran las vistas de planificación de Odoo.
• Nadie reprograma a mano. Autopilot reprograma automáticamente cuando cambia la producción, y el webhook envía las nuevas fechas a Odoo.
• La planta cierra el ciclo. Los operarios registran el trabajo desde el móvil o la tableta con Mobile Confirmations, Production Timer y Quick Log Mode, y los Time Logs se envían a Odoo para la gestión de existencias y el cálculo de costes. La programación y la ejecución se gestionan en una sola herramienta, tanto en Community como en Enterprise.
• La programación respeta restricciones que Odoo no contempla. Una matriz de tiempos de preparación define los tiempos de cambio según la secuencia para cada par de productos. Las herramientas son recursos productivos de capacidad limitada compartidos entre máquinas, y una tarea puede requerir varios operarios a la vez. El motor recurre a máquinas o personal alternativos cuando la opción principal no está disponible. Las fechas que se actualizan en mrp.workorder respetan todas estas restricciones.
• La llegada de materiales marca el programa. Las existencias disponibles y los pedidos de compra abiertos de Odoo alimentan la programación en función de los materiales. Los componentes pedidos se consideran disponibles en la fecha de entrega del pedido de compra, y las existencias se actualizan cuando este se marca como Delivered. Para cada tarea se comprueba qué hay en el almacén y qué está en camino.

Puedes evaluar el programa antes de empezar a trabajar en la integración. Inicia la prueba gratuita de 30 días con exportaciones CSV y visualiza tus propias órdenes de fabricación de Odoo en el Gantt, con hasta 20 puestos de trabajo y sin tarjeta de crédito. El precio parte de 199 € al mes con 5 puestos de trabajo incluidos, facturación mensual y cancelación en cualquier momento. La integración se presupuesta de antemano según tus procesos y necesidades, junto con tu plan, para que conozcas el coste total antes de empezar. Consulta las funcionalidades y los clientes, o reserva una demo.