Antes de sumergirnos en los registros temporales, tenemos que hablar un poco de la estructura de datos de Skyplanner y de c\u00f3mo funcionan las cosas bajo el cap\u00f3. Todo esto entrar\u00e1 en juego m\u00e1s adelante. <\/p>\n\n
Si has integrado tus datos de pedidos\/\u00f3rdenes de trabajo\/trabajos en Skyplanner, lo m\u00e1s probable es que hayas utilizado al menos estos API-endpoints:<\/p>\n\n
\n
phaser-pedidos<\/li>\n\n\n\n
phaser-orden-filas<\/li>\n\n\n\n
phaser-jobs<\/li>\n<\/ul>\n\n
Efectivamente, los datos insertados en estos puntos finales se representan en la interfaz de usuario de Skyplanner de la siguiente manera:<\/p>\n
\nFig. 1.<\/strong> Pedido (phaser-pedidos)<\/figcaption><\/figure>\n<\/div>\nFig. 2.<\/strong> Elementos de pedido (phaser-order-rows (rojo)), Pasos de proceso (phaser-jobs (verde))<\/figcaption><\/figure>\n\n
Despu\u00e9s de insertar tus pedidos en Skyplanner, querr\u00e1s exportarlos<\/strong> (esto puede hacerse a trav\u00e9s de la interfaz de usuario o del punto final \/phaser-orders\/export-endpoint) al m\u00f3dulo de Programaci\u00f3n de la Producci\u00f3n:<\/p>\n\nFig. 3.<\/strong> Exportar a trav\u00e9s de la IU<\/figcaption><\/figure>\n\nFig. 4.<\/strong> Pedido exportado en Programaci\u00f3n de la Producci\u00f3n<\/figcaption><\/figure>\n\n
Al exportar pedidos, Skyplanner copia efectivamente los datos del pedido de una tabla de la base de datos a otra. As\u00ed que si cambias algo, por ejemplo, a trav\u00e9s del punto final \/phaser-orders, tienes que exportar los datos de nuevo para actualizarlos en la Programaci\u00f3n de la producci\u00f3n. Esto tambi\u00e9n significa que, para acceder a los pedidos que ves en la ventana de Programaci\u00f3n de la producci\u00f3n, \u00a1tienes que utilizar diferentes puntos finales de la API! <\/p>\n\n
Los puntos finales \u00abmodificados\u00bb son as\u00ed:<\/p>\n\n
Es importante que lo sepas, porque cuando utilices el punto final \/timelogs para registrar tus eventos de producci\u00f3n, etc. , \u00a1tienes que utilizar las entidades relacionadas que se encuentran en los puntos finales de Programaci\u00f3n de la Producci\u00f3n!<\/strong><\/p>\n\n
Por ejemplo, necesitas el production_planning_job_id <\/strong>(para reiterar: production_planning_jobs son las entidades a las que se accede desde el -endpoint \/jobs) para POSTAR un nuevo registro de tiempo:<\/p>\n\nFig. 5.<\/strong> Solicitud POST de registro de tiempo<\/figcaption><\/figure>\n\n
Puedes encontrar el production_planning_job_id que necesitas en el -endpoint \/phaser-jobs:<\/p>\n\nFig. 6.<\/strong> Petici\u00f3n GET de trabajo Phaser (rojo es phaser_job_id, NO LO UTILICES EN LOS CRONOGRAMAs<\/strong>)<\/figcaption><\/figure>\n\n
O desde el punto final \/job:<\/p>\n\nFig. 7.<\/strong> \/trabajo Solicitud GET<\/figcaption><\/figure>\n\n
Crear registros cronol\u00f3gicos utilizando la REST-API<\/h4>\n\n
Hacer registros de tiempo en Skyplanner a trav\u00e9s de la API utiliza las mismas reglas y sistemas que en la IU. As\u00ed que puede ser beneficioso que te familiarices con el funcionamiento del sistema en la IU antes de intentar utilizarlo a trav\u00e9s de la API. <\/p>\n\n
Conceptos b\u00e1sicos del registro cronol\u00f3gico<\/h5>\n\n
Skyplanner tiene cuatro tipos de eventos de registro de tiempo:<\/p>\n\n
\n
inicio_de_turno<\/li>\n\n\n\n
en pausa<\/li>\n\n\n\n
contin\u00faa<\/li>\n\n\n\n
shift_end<\/li>\n<\/ul>\n\n
El evento Shift_begin se env\u00eda cuando el trabajo se inicia por primera vez. \u00a1Nunca env\u00edes m\u00e1s de un evento shift_begin por cada trabajo!<\/strong><\/p>\n\n
El evento Pausado pausa el trabajo.<\/p>\n\n
El evento continuado reanuda un trabajo pausado.<\/p>\n\n
Shift_end completa el trabajo. \u00a1Nunca env\u00edes m\u00e1s de un evento shift_end por cada trabajo!<\/strong><\/p>\n\n
Datos necesarios para los registros cronol\u00f3gicos:<\/p>\n\n
\n
persona_id\n
\n
Se puede encontrar desde el punto final \/people<\/li>\n\n\n\n
\u00a1No es lo mismo que user_id!<\/li>\n<\/ul>\n<\/li>\n\n\n\n
id_puesto_trabajo_planificado\n
\n
El puesto de trabajo en el que se realiza el trabajo<\/li>\n\n\n\n
Se puede encontrar desde el \/workstations-endpoint<\/li>\n<\/ul>\n<\/li>\n\n\n\n
fecha_hora\n
\n
El momento en que se realiza el evento<\/li>\n\n\n\n
Para especificar qu\u00e9 registro de tiempo de Skyplanner est\u00e1 vinculado al registro de tiempo de cualquier sistema externo que est\u00e9s utilizando, puedes utilizar el campo external_id <\/strong>. Entonces puedes, por ejemplo, hacer peticiones GET utilizando este id para encontrar un registro de tiempo espec\u00edfico de Skyplanner. <\/p>\n\nFig. 8.<\/strong> External_id en los registros de tiempo<\/figcaption><\/figure>\n\n
Empezar a trabajar<\/h4>\n\n
Puedes iniciar trabajos enviando una solicitud POST como \u00e9sta a la API:<\/p>\n\nFig. 9.<\/strong> Registro de tiempo de inicio de turno<\/figcaption><\/figure>\n\n
Al configurar los datos POST para los registros de tiempo, establece workshift_id <\/strong>como 0 y timelog_finalized <\/strong>como true<\/strong><\/p>\n\n
Pausar un trabajo<\/h4>\n\n
Pausa los trabajos enviando una petici\u00f3n POST como \u00e9sta:<\/p>\n\nFig. 10.<\/strong> Registro de tiempo en pausa<\/figcaption><\/figure>\n\n
En los registros de tiempo de tipo pausa puedes establecer la cantidad <\/strong>y la cantidad_defectuosa<\/strong>. Ten en cuenta tambi\u00e9n el tipo de <\/strong>registro de tiempo y la fecha\/hora<\/strong>. <\/p>\n\n
Continuar un trabajo<\/h4>\n\n
As\u00ed es como se contin\u00faa un registro de tiempo en pausa:<\/p>\n\nFig. 11.<\/strong> Continuaci\u00f3n del registro cronol\u00f3gico<\/figcaption><\/figure>\n\n
Ten en cuenta que si intentas continuar un trabajo que ha finalizado por un evento shift_end, obtendr\u00e1s un error.<\/p>\n\n
Terminar un trabajo<\/h4>\n\n
As\u00ed es como se termina un trabajo mediante un registro de tiempo shift_end:<\/p>\n\nFig. 12.<\/strong> Registro de tiempo de fin de turno<\/figcaption><\/figure>\n\n
En shift_end-events puedes dar los valores amount <\/strong>y faulty_amount <\/strong>igual que en paused-events. Ten en cuenta que si intentas hacer un evento shift_end a un trabajo que no se est\u00e1 ejecutando, obtendr\u00e1s un error. <\/p>\n\n
Actualizar registros cronol\u00f3gicos<\/h4>\n\n
Puedes actualizar los datos del registro de tiempo enviando solicitudes PUT al punto final \/timelogs, de esta forma:<\/p>\n\nFig. 13.<\/strong> Editar registros de tiempo<\/figcaption><\/figure>\n\n
Ten en cuenta que debes tener configurados los datos de beginTimelog <\/strong>y endTimelog <\/strong>para poder realizar una actualizaci\u00f3n. Los registros de tiempo en Skyplanner se almacenan as\u00ed: cada registro de tiempo \u00abcompleto\u00bb (que tiene un inicio y un final (por ejemplo, inicio_turno\/continuado y pausado\/final_turno) tiene una entidad separada para el inicio y el final. <\/p>\n\n
Se emparejan por el valor begin_id <\/strong>que se encuentra en el endlog. En el ejemplo anterior, beginTimelog tiene el valor id 1 y, por tanto, endTimelog tiene el valor begin_id <\/strong>1. <\/p>\n\n
Tambi\u00e9n debes dar los valores person_id <\/strong>y endTimelog <\/strong>cada vez que hagas una petici\u00f3n de actualizaci\u00f3n, aunque no los est\u00e9s cambiando.<\/p>\n\n
Formas alternativas de hacer registros cronol\u00f3gicos<\/h4>\n\n
Aqu\u00ed tienes algunas formas alternativas de acceder a tus trabajos utilizando la API.<\/p>\n\n
Tronco lleno<\/h5>\n\n
Si quieres enviar los registros de tiempo inicial y final en una sola petici\u00f3n, puedes utilizar el -punto \/timelogs\/log-full<\/strong>, as\u00ed<\/p>\n\nFig. 14.<\/strong> Solicitud de registro<\/figcaption><\/figure>\n\n
Observa c\u00f3mo se env\u00edan aqu\u00ed las cantidades: el primer valor \u00abcantidad\u00bb indica la cantidad defectuosa<\/strong> y el segundo la cantidad<\/strong>. Esta petici\u00f3n crea las entidades beginlog y endlog en una sola petici\u00f3n. <\/p>\n\n
Registro r\u00e1pido<\/h5>\n\n
\u00abQuicklogging\u00bb a un trabajo lo completa en una sola petici\u00f3n, establece la cantidad completada de productos para que coincida con el valor establecido en el elemento del pedido. El Quicklogging se realiza utilizando el -endpoint \/timelogs\/quick-log<\/strong>: <\/p>\n\nFig. 15.<\/strong> Quicklogging<\/figcaption><\/figure>\n\n
Ten en cuenta que aqu\u00ed s\u00f3lo necesitas dar el production_planning_job_id<\/strong>, planned_workstation_id <\/strong>y person_id<\/strong>. Los valores de tiempo e importe se rellenan autom\u00e1ticamente. Ten en cuenta tambi\u00e9n que los trabajos quicklogged siempre se completan con el evento shift_end-event, \u00a1as\u00ed que no es posible ning\u00fan otro registro despu\u00e9s del quicklog! <\/p>\n\n
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-25-1024x714.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-26-1024x715.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-27-1024x596.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-28-1024x597.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-29.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-30.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-31.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-32-1024x438.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-33.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-34.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-35.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-36.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-37.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-38.png\")
![\"\"](\"https:\/\/skyplanner.ai\/wp-content\/uploads\/2025\/03\/image-39.png\")