Guía de integración de Katana para programar la producción con SkyPlanner APS

Katana es un único producto en la nube con arquitectura multiinquilino, por lo que todos los clientes utilizan la misma API. Es una REST API, versión v1, disponible en https://api.katanamrp.com/v1, con una especificación OpenAPI 3.0 en https://api.katanamrp.com/v1/openapi.json. La documentación está en Katana Developer Hub.

Endpoints necesarios para la programación:

• Datos maestros: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Órdenes: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Secuencia: /manufacturing_order_rerank.
• Suministro y demanda: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

No existe un endpoint /resources. Los recursos productivos aparecen como resource_id y resource_name en las líneas de operación del producto y de las órdenes de fabricación.

Registra un webhook mediante POST /webhooks, con una URL HTTPS y los eventos que necesites. (fuente) Estos son los eventos útiles para la programación:

• manufacturing_order.created, .updated, .deleted, .in_progress, .blocked, .done
• manufacturing_order_operation_row.created, .updated, .in_progress, .paused, .completed
• current_inventory.material_updated, .material_out_of_stock
• purchase_order.* y purchase_order_row.*, incluido received
• product.*, product_recipe_row.* y sales_order.*

Los mensajes contienen pocos datos: el tipo de recurso, la acción y un href. El receptor obtiene el objeto completo a través de ese href. Cada envío incluye una cabecera x-sha2-signature (HMAC SHA-256) para su verificación. Tu endpoint debe responder con un código 20X en un plazo de 10 segundos. Katana realiza tres reintentos: a los 30 segundos, a los 2 minutos y a los 15 minutos.

1. Carga inicial de datos maestros. Recorre las páginas de productos, materiales, variantes, líneas de fórmula y líneas de operación del producto, regulando las solicitudes para no superar el límite. Crea las estaciones de trabajo de SkyPlanner a partir de los distintos recursos productivos presentes en las líneas de operación y conserva una correspondencia de claves 1:1. Configura en SkyPlanner los turnos, los permisos y las horas extra de cada estación de trabajo, ya que Katana no dispone de un calendario de recursos productivos.

2. Sincronización de órdenes. Suscríbete a los eventos de órdenes de fabricación, líneas de operación, inventario y pedidos de compra. Con cada evento, obtén el objeto a través de su href y actualiza la tarea. SkyPlanner considera que el material pedido estará disponible en la fecha de entrega del pedido de compra y actualiza las existencias cuando se recibe el pedido. Una conciliación nocturna con filtros por fecha de actualización detecta los eventos que se hayan pasado por alto.

3. Escritura de la programación en Katana. Dos llamadas trasladan el plan a Katana:

• POST /manufacturing_order_rerank «moves one or more manufacturing orders to an exact place in the production schedule» (mueve una o varias órdenes de fabricación a una posición exacta de la programación de la producción). Admite hasta 250 órdenes de fabricación abiertas por solicitud, que se colocan al principio, al final, o antes o después de una orden de fabricación determinada. (fuente)
• PATCH /manufacturing_orders/{id} establece production_deadline_date. Katana solo lo acepta si el cálculo automático de fechas límite está desactivado para esa ubicación de fábrica. (fuente)

La reordenación no solo afecta a la lista. En Katana, «higher-priority MOs reserve required materials and subassemblies first» (las órdenes de fabricación de mayor prioridad reservan primero los materiales y subconjuntos necesarios), por lo que la secuencia de SkyPlanner también determina a qué orden de fabricación se asignan las existencias en Katana.

4. Confirmaciones en planta. Los operarios registran el trabajo con SkyPlanner Mobile Confirmations, Production Timer o Quick Log Mode. SkyPlanner escribe el estado y el tiempo real empleado en la línea de operación de la orden de fabricación. Si una planta opta por seguir utilizando Katana Shop Floor App, SkyPlanner lee los eventos de las líneas de operación. Elige un único canal de registro por planta.

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

• El modo de fechas límite borra las fechas. «Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.» (Al activar el modo automático, todas las fechas límite manuales se sobrescriben y no pueden recuperarse). Decida el modo una sola vez, al inicio del proyecto.
• No hay calendario de recursos productivos. No deduzca los turnos a partir del único valor de Weekly throughput. Configúrelos para cada estación de trabajo en SkyPlanner.
• Los recursos productivos solo figuran en las filas de operaciones. Mantenga los nombres de los recursos productivos en Katana sin cambios, ya que son la clave que los vincula con las estaciones de trabajo de SkyPlanner.
• Unidades de tiempo. planned_time_parameter se expresa en segundos: por unidad en las operaciones por unidad, y como total en los tipos process, setup y fixed. Establezca correctamente la correspondencia del tipo; de lo contrario, las duraciones serán incorrectas por un factor igual a la cantidad.
• Grupos de fabricación bajo pedido. Al reordenar, las órdenes de fabricación (MO) vinculadas al mismo pedido de venta se mantienen juntas, por lo que debe secuenciarlas como un grupo.
• Ha cambiado el comportamiento de reordenación. Desde el 7 de octubre de 2026, los endpoints de reordenación colocan las órdenes exactamente en la posición solicitada. Las integraciones desarrolladas para el comportamiento anterior deben probarse de nuevo. (fuente)